Module: types

Type Definitions

Cart

Type:
  • Object
Properties:
Name Type Description
id String

The cart id.
customerInfo module:type.CustomerInformation

The information about the cart owner.
items Array.<module:type.CartItem>

The cart items.
shippingAddress module:type.OrderAddress

The address to ship to.
billingAddress module:type.OrderAddress

The address to bill to.
shippingMethods Array.<module:type.ShippingMethod>

All the possible shipping methods for the cart.
paymentMethods Array.<module:type.PaymentMethod>

All the possible payment methods for the cart.
selectedShippingMethodId String

The currently selected shipping method for the cart.
payments Array.<module:type.Payment>

All the current payments on the cart (i.e. credit card, gift card etc).
subtotal Number

The subtotal before shipping, discounts, and tax.
shipping Number

The shipping cost.
discounts Number

The total of all the discounts applied to the cart.
tax Number

The total tax of the cart.
total Number

The total cost of all the items in the cart after discounts, shipping, tax.
Source:

CartItem

Type:
  • Object
Properties:
Name Type Description
id String

The cart id.
productId String

The id of the product.
productName String

The name of the product.
quantity module:types.PositiveInteger

The number of this product that is in the cart.
baseItemPrice Number

The price of one of this product before discounts
baseLinePrice Number

The price of all of this product before discounts (usually baseItemPrice multiplied by quantity)
itemPrice Number

The price of one of these items after discounts
linePrice Number

The price of all of this product after discounts (usually baseItemPrice multiplied by quantity)
Source:

Category

Type:
  • Object
Properties:
Name Type Description
id String

The category id.
name String

The category description.
description String

The category name.
thumbnailImage module:types.Image

The category thumbnail image.
backgroundImage module:types.Image

The category background image.
categories Array.<module:types.Category>

The subcategories.
Source:

CategoryList

Type:
  • Object
Properties:
Name Type Description
data Array.<module:types.Category>
count Number
total Number
Source:

CountryCode

Type:
  • String
Source:

Customer

Type:
  • Object
Properties:
Name Type Description
id String

The customer's id.
firstName String

The customer's first name.
lastName String

The customer's last name.
email String

The customer's email address.
Source:

CustomerInformation

Type:
  • Object
Properties:
Name Type Description
id String

The customer id.
email module:types/email

The customer's email.
Source:

Email

Type:
  • String
Source:

Filter

Type:
  • Object
Properties:
Name Type Description
propertyId String

The property id of the filter (e.g. color or size).
label String

The filters text used for labels (e.g. the filter color might have an label attribute of "Color").
values Array.<module:types.FilterValue>

The filter values.
Source:

FilterValue

Type:
  • Object
Properties:
Name Type Description
The module:types.Integer

filter value hit count (e.g. 10).
The String

filter value label text (e.g. 'Red').
The String

filter value's value (e.g. 'red').
Source:

Image

Type:
  • Object
Properties:
Name Type Description
alt String

The image alt text.
description String

The image description.
src String

The image src.
title String

The image title.
Source:

ImageSet

Type:
  • Object
Properties:
Name Type Description
images Array.<module:types.Image>

The images.
variationProperties Array.<module:types.VariationProperty>

The variation properties that apply to the images.
sizeType String

The images size type (ex. 'small', 'medium', 'large', 'swatch').
Source:

Integer

Type:
  • Number
Source:

Latitude

Type:
  • Number
Source:
Type:
  • Object
Properties:
Name Type Description
href module:types.URL

The link's url.
text String

The link's text.
title String

The link's title.
Source:

Longitude

Type:
  • Number
Source:

OrderAddress

Type:
  • Object
Properties:
Name Type Description
id String

The id of the order address.
titleCode String

The title code of the customer (i.e. 'mr', 'ms').
firstName String

The first name of the customer.
lastName String

The last name of the customer
phone module:types.PhoneNumber

The customer's phone number.
addressLine String

The street name, street number, and suite/unit.
addressLine String

The additional addressing information (i.e. company name, "Attn:").
countryCode module:types.CountryCode

The country code.
stateCode String

The state code.
city String

The city name.
postalCode module:types.PostalCode

The postal code.
Source:

Payment

Type:
  • Object
Properties:
Name Type Description
id String

The payment id.
amount Number

The payment amount.
methodId String

The payment method id.
details module:type.PaymentDetails

The customer's payment details for the specified payment method.
Source:

PaymentDetails

Details of the payment method (i.e details of a Credit Card, Paypal, GiftCard etc)

Type:
  • Object
Properties:
Name Type Description
type String

The type of this payment method (i.e. Visa, Mastercard).
holderName String

The name of the account holder.
number String

The card/account number or code (i.e. credit card number, gift card code)
maskedNumber String

The card/account number or code masked.
username String

The card/account username (i.e. Paypal username)
expiryMonth module:types.PositiveInteger

The month the card/account expires in number form.
expiryYear module:types.PositiveInteger

The year the card/account expires.
ccv String

The credit card ccv number (card security code)
Source:

PaymentMethod

Type:
  • Object
Properties:
Name Type Description
id String

The payment method id.
name String

The payment method name.
types Array.Object

The different types of the particular payment method. (i.e. a Credit Card payment method can have types Visa and Mastercard)
Source:

PhoneNumber

Type:
  • String
Source:

PositiveInteger

Type:
  • Number
Source:

Product

Type:
  • Object
Properties:
Name Type Description
id String

The product id.
name String

The product name.
imageSets Array.<module:types.ImageSet>

The products image-sets.
description String

The products description.
categoryId String

The products main category id.
brand String

The products brand name.
minimumOrderQuantity module:types.Integer

The products minimum order quantity.
stepQuantity module:types.Integer

The products step qquantity.
upc String

The products universal product code.
unit module:types.Integer

e.g. 'each', 'ea', 'pair', etc
price Number

The default price.
prices Object

map of price type label and value. e.g. {'Regular': 99.99, 'Sale': 69.99}
variations Array.<module:types.Variation>

The different variations of this product.
variationProperties Array.<module:types.VariationProperty>

All the variations different properties.
variationValues Object

Property values of the product.
Source:

ProductList

Type:
  • Object
Properties:
Name Type Description
count. Number
data. Array.<module:types.Product>
total. Number
Source:

ProductSearch

Type:
  • Object
Properties:
Name Type Description
count module:types.Integer

The the number of products returned.
filters Array.<module:types.Filter>

The available search filters.
products Array.<module:types.ProductSearchResult>

The search results.
query String

The search query.
selectedFilters Object

The selected filters applied to the results as a propertyId and value map.
selectedSortingOption module:types.ProductSearchSortOption

The selected sorting option. NOTE: Only single sorting is supported.
sortingOptions Array.<module:types.ProductSearchSortOption>

The available sorting options.
start module:types.Integer

The search start index.
total module:types.Integer

The search hit count.
Source:

ProductSearchRequest

Type:
  • Object
Properties:
Name Type Description
count module:types.Integer

The the number products to return.
filters Object

The search result filters.
query String

The search query.
start module:types.Integer

The starting position.
sort String

The sorting method.
Source:

ProductSearchSortOption

Type:
  • Object
Properties:
Name Type Description
id String

The unique sort identifier.
label String

The sort label.
Source:

ProductSummary

Type:
  • Object
Properties:
Name Type Description
available Boolean

Is the product is available for order?
productId String

The product id.
productName String

The product name.
price Number

The product price.
rating Number

The product rating.
defaultImage module:types.Image

The product main image.
variationProperties Array.<module:types.VariationProperty>

The product variations.
Source:

ShippingMethod

Type:
  • Object
Properties:
Name Type Description
id String

The shipping method id.
name String

The shipping method name.
cost Number

The cost of shipping.
Source:

Store

Type:
  • Object
Properties:
Name Type Description
address String

The store address.
alternativeAddress String

A secondary store address.
city String

The city the store is located in.
country String

The country the store is located in.
description String

The store description.
features String

The various features of a store.
email String

The store email.
id String

The store unique identifier.
name String

The store name.
phone String

The store phone number.
postalCode String

The store postal code.
hours String

The store hours.
image String

The store logo.
Source:

StoreSearchRequest

Type:
  • Object
Properties:
Name Type Description
count module:types.Integer

The the number stores to return. Default is 20.
start module:types.Integer

The zero-based index page number. Default is 0.
latlon Object

The geo coordinates of the location to search for stores.

Properties
Name Type Description
latitude module:types.Latitude
Longitude module:types.Longitude
Source:

StoreSearchResult

Type:
  • Object
Properties:
Name Type Description
count module:types.Integer

The number of stores returned.
start module:types.Integer

A zero based index page number.
total module:types.Integer

The total number of search hits.
stores Array.<module:types.Store>

List of stores returned.
Source:

URL

Type:
  • String
Source:

Variation

Type:
  • Object
Properties:
Name Type Description
id String

The variation id (NOTE: In some cases this value may have to be generated).
price Number

The product price.
orderable Boolean

The search hit count.
values Object

The variation values.
Source:

VariationProperty

Represents things like "color", "size", "width", etc.

Type:
  • Object
Properties:
Name Type Description
id String

The variation property id.
label String

The variation property label.
values Array.<module:types.VariationPropertyValue>

The variation property id.
Source:

VariationPropertyValue

Represents values for properties (e.g. size property would have the individual sizes).

Type:
  • Object
Properties:
Name Type Description
name String
value String
mainImage Image
swatchImage Image
Source: