Types

AcceptNegotiableQuoteTemplateInput

Specifies the quote template id to accept quote template.

Input Fields

Input Field
Description
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{"template_id": 4}

AddBundleProductsToCartInput

Defines the bundle products to add to the cart.

Input Fields

Input Field
Description
cart_id - String!
The ID of the cart.
cart_items - [BundleProductCartItemInput]!
An array of bundle products to add.

Example

{
  "cart_id": "xyz789",
  "cart_items": [BundleProductCartItemInput]
}

AddBundleProductsToCartOutput

Contains details about the cart after adding bundle products.

Fields

Field Name
Description
cart - Cart!
The cart after adding products.

Example

{"cart": Cart}

AddConfigurableProductsToCartInput

Defines the configurable products to add to the cart.

Input Fields

Input Field
Description
cart_id - String!
The ID of the cart.
cart_items - [ConfigurableProductCartItemInput]!
An array of configurable products to add.

Example

{
  "cart_id": "abc123",
  "cart_items": [ConfigurableProductCartItemInput]
}

AddConfigurableProductsToCartOutput

Contains details about the cart after adding configurable products.

Fields

Field Name
Description
cart - Cart!
The cart after adding products.

Example

{"cart": Cart}

AddDownloadableProductsToCartInput

Input Fields

Input Field
Description
cart_id - String!
The ID of the cart.
cart_items - [DownloadableProductCartItemInput]!
An array of downloadable products to add.

Example

{
  "cart_id": "xyz789",
  "cart_items": [DownloadableProductCartItemInput]
}

AddDownloadableProductsToCartOutput

Contains details about the cart after adding downloadable products.

Fields

Field Name
Description
cart - Cart!
The cart after adding products.

Example

{"cart": Cart}

AddGiftRegistryRegistrantInput

Defines a new registrant.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair.
email - String!
The email address of the registrant.
firstname - String!
The first name of the registrant.
lastname - String!
The last name of the registrant.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "email": "xyz789",
  "firstname": "xyz789",
  "lastname": "abc123"
}

AddGiftRegistryRegistrantsOutput

Contains the results of a request to add registrants.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after adding registrants.

Example

{"gift_registry": GiftRegistry}

AddProductsToCartOutput

Contains details about the cart after adding products to it.

Fields

Field Name
Description
cart - Cart!
The cart after products have been added.
user_errors - [Error]!
Contains errors encountered while adding an item to the cart.

Example

{
  "cart": Cart,
  "user_errors": [Error]
}

AddProductsToCompareListInput

Contains products to add to an existing compare list.

Input Fields

Input Field
Description
products - [ID]!
An array of product IDs to add to the compare list.
uid - ID!
The unique identifier of the compare list to modify.

Example

{"products": [4], "uid": 4}

AddProductsToNewCartOutput

Contains details about the cart after adding products to it.

Fields

Field Name
Description
cart - Cart
The cart after products have been added.
user_errors - [CartUserInputError]
Contains errors encountered while adding an item to the cart.

Example

{
  "cart": Cart,
  "user_errors": [CartUserInputError]
}

AddProductsToRequisitionListOutput

Output of the request to add products to a requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The requisition list after adding products.

Example

{"requisition_list": RequisitionList}

AddProductsToWishlistOutput

Contains the customer's wish list and any errors encountered.

Fields

Field Name
Description
user_errors - [WishListUserInputError]!
An array of errors encountered while adding products to a wish list.
wishlist - Wishlist!
Contains the wish list with all items that were successfully added.

Example

{
  "user_errors": [WishListUserInputError],
  "wishlist": Wishlist
}

AddPurchaseOrderCommentInput

Contains the comment to be added to a purchase order.

Input Fields

Input Field
Description
comment - String!
Comment text.
purchase_order_uid - ID!
The unique ID of a purchase order.

Example

{
  "comment": "abc123",
  "purchase_order_uid": 4
}

AddPurchaseOrderCommentOutput

Contains the successfully added comment.

Fields

Field Name
Description
comment - PurchaseOrderComment!
The purchase order comment.

Example

{"comment": PurchaseOrderComment}

AddPurchaseOrderItemsToCartInput

Defines the purchase order and cart to act on.

Input Fields

Input Field
Description
cart_id - String!
The ID to assign to the cart.
purchase_order_uid - ID!
Purchase order unique ID.
replace_existing_cart_items - Boolean!
Replace existing cart or merge items.

Example

{
  "cart_id": "xyz789",
  "purchase_order_uid": 4,
  "replace_existing_cart_items": false
}

AddRequisitionListItemToCartUserError

Contains details about why an attempt to add items to the requistion list failed.

Fields

Field Name
Description
message - String!
A description of the error.
type - AddRequisitionListItemToCartUserErrorType!
The type of error that occurred.

Example

{
  "message": "abc123",
  "type": "OUT_OF_STOCK"
}

AddRequisitionListItemToCartUserErrorType

Values

Enum Value
Description
OUT_OF_STOCK
UNAVAILABLE_SKU
OPTIONS_UPDATED
LOW_QUANTITY

Example

""OUT_OF_STOCK""

AddRequisitionListItemsToCartOutput

Output of the request to add items in a requisition list to the cart.

Fields

Field Name
Description
add_requisition_list_items_to_cart_user_errors - [AddRequisitionListItemToCartUserError]!
Details about why the attempt to add items to the requistion list was not successful.
cart - Cart
The cart after adding requisition list items.
status - Boolean!
Indicates whether the attempt to add items to the requisition list was successful.

Example

{
  "add_requisition_list_items_to_cart_user_errors": [
    AddRequisitionListItemToCartUserError
  ],
  "cart": Cart,
  "status": false
}

AddReturnCommentInput

Defines a return comment.

Input Fields

Input Field
Description
comment_text - String!
The text added to the return request.
return_uid - ID!
The unique ID for a `Return` object.

Example

{
  "comment_text": "xyz789",
  "return_uid": "4"
}

AddReturnCommentOutput

Contains details about the return request.

Fields

Field Name
Description
return - Return
The modified return.

Example

{"return": Return}

AddReturnTrackingInput

Defines tracking information to be added to the return.

Input Fields

Input Field
Description
carrier_uid - ID!
The unique ID for a `ReturnShippingCarrier` object.
return_uid - ID!
The unique ID for a `Returns` object.
tracking_number - String!
The shipping tracking number for this return request.

Example

{
  "carrier_uid": 4,
  "return_uid": 4,
  "tracking_number": "xyz789"
}

AddReturnTrackingOutput

Contains the response after adding tracking information.

Fields

Field Name
Description
return - Return
Details about the modified return.
return_shipping_tracking - ReturnShippingTracking
Details about shipping for a return.

Example

{
  "return": Return,
  "return_shipping_tracking": ReturnShippingTracking
}

AddSimpleProductsToCartInput

Defines the simple and group products to add to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
cart_items - [SimpleProductCartItemInput]!
An array of simple and group items to add.

Example

{
  "cart_id": "abc123",
  "cart_items": [SimpleProductCartItemInput]
}

AddSimpleProductsToCartOutput

Contains details about the cart after adding simple or group products.

Fields

Field Name
Description
cart - Cart!
The cart after adding products.

Example

{"cart": Cart}

AddVirtualProductsToCartInput

Defines the virtual products to add to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
cart_items - [VirtualProductCartItemInput]!
An array of virtual products to add.

Example

{
  "cart_id": "xyz789",
  "cart_items": [VirtualProductCartItemInput]
}

AddVirtualProductsToCartOutput

Contains details about the cart after adding virtual products.

Fields

Field Name
Description
cart - Cart!
The cart after adding products.

Example

{"cart": Cart}

AddWishlistItemsToCartOutput

Contains the resultant wish list and any error information.

Fields

Field Name
Description
add_wishlist_items_to_cart_user_errors - [WishlistCartUserInputError]!
An array of errors encountered while adding products to the customer's cart.
status - Boolean!
Indicates whether the attempt to add items to the customer's cart was successful.
wishlist - Wishlist!
Contains the wish list with all items that were successfully added.

Example

{
  "add_wishlist_items_to_cart_user_errors": [
    WishlistCartUserInputError
  ],
  "status": true,
  "wishlist": Wishlist
}

Aggregation

Contains information for each filterable option (such as price, category UID, and custom attributes).

Fields

Field Name
Description
attribute_code - String!
Attribute code of the aggregation group.
count - Int
The number of options in the aggregation group.
label - String
The aggregation display name.
options - [AggregationOption]
Array of options for the aggregation.
position - Int
The relative position of the attribute in a layered navigation block.

Example

{
  "attribute_code": "xyz789",
  "count": 987,
  "label": "abc123",
  "options": [AggregationOption],
  "position": 987
}

AggregationOption

An implementation of AggregationOptionInterface.

Fields

Field Name
Description
count - Int
The number of items that match the aggregation option.
label - String
The display label for an aggregation option.
value - String!
The internal ID that represents the value of the option.

Example

{
  "count": 987,
  "label": "abc123",
  "value": "xyz789"
}

AggregationOptionInterface

Defines aggregation option fields.

Fields

Field Name
Description
count - Int
The number of items that match the aggregation option.
label - String
The display label for an aggregation option.
value - String!
The internal ID that represents the value of the option.

Possible Types

AggregationOptionInterface Types
AggregationOption

Example

{
  "count": 987,
  "label": "xyz789",
  "value": "xyz789"
}

AggregationsCategoryFilterInput

Filter category aggregations in layered navigation.

Input Fields

Input Field
Description
includeDirectChildrenOnly - Boolean
Indicates whether to include only direct subcategories or all children categories at all levels.

Example

{"includeDirectChildrenOnly": false}

AggregationsFilterInput

An input object that specifies the filters used in product aggregations.

Input Fields

Input Field
Description
category - AggregationsCategoryFilterInput
Filter category aggregations in layered navigation.

Example

{"category": AggregationsCategoryFilterInput}

ApplePayConfig

Fields

Field Name
Description
button_styles - ButtonStyles
The styles for the ApplePay Smart Button configuration
code - String
The payment method code as defined in the payment gateway
is_visible - Boolean
Indicates whether the payment method is displayed
payment_intent - String
Defines the payment intent (Authorize or Capture
payment_source - String
The payment source for the payment method
sdk_params - [SDKParams]
The PayPal parameters required to load the JS SDK
sort_order - String
The relative order the payment method is displayed on the checkout page
title - String
The name displayed for the payment method

Example

{
  "button_styles": ButtonStyles,
  "code": "xyz789",
  "is_visible": true,
  "payment_intent": "abc123",
  "payment_source": "xyz789",
  "sdk_params": [SDKParams],
  "sort_order": "abc123",
  "title": "xyz789"
}

ApplePayMethodInput

Apple Pay inputs

Input Fields

Input Field
Description
payment_source - String
The payment source for the payment method
payments_order_id - String
The payment services order ID
paypal_order_id - String
PayPal order ID

Example

{
  "payment_source": "abc123",
  "payments_order_id": "xyz789",
  "paypal_order_id": "abc123"
}

AppliedCoupon

Contains the applied coupon code.

Fields

Field Name
Description
code - String!
The coupon code the shopper applied to the card.

Example

{"code": "xyz789"}

AppliedGiftCard

Contains an applied gift card with applied and remaining balance.

Fields

Field Name
Description
applied_balance - Money
The amount applied to the current cart.
code - String
The gift card account code.
current_balance - Money
The remaining balance on the gift card.
expiration_date - String
The expiration date of the gift card.

Example

{
  "applied_balance": Money,
  "code": "abc123",
  "current_balance": Money,
  "expiration_date": "abc123"
}

AppliedStoreCredit

Contains the applied and current balances.

Fields

Field Name
Description
applied_balance - Money
The applied store credit balance to the current cart.
current_balance - Money
The current balance remaining on store credit.
enabled - Boolean
Indicates whether store credits are enabled. If the feature is disabled, then the current balance will not be returned.

Example

{
  "applied_balance": Money,
  "current_balance": Money,
  "enabled": true
}

ApplyCouponToCartInput

Specifies the coupon code to apply to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
coupon_code - String!
A valid coupon code.

Example

{
  "cart_id": "abc123",
  "coupon_code": "abc123"
}

ApplyCouponToCartOutput

Contains details about the cart after applying a coupon.

Fields

Field Name
Description
cart - Cart!
The cart after applying a coupon.

Example

{"cart": Cart}

ApplyCouponsStrategy

The strategy to apply coupons to the cart.

Values

Enum Value
Description
APPEND
Append new coupons keeping the coupons that have been applied before.
REPLACE
Remove all the coupons from the cart and apply only new provided coupons.

Example

""APPEND""

ApplyCouponsToCartInput

Apply coupons to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
coupon_codes - [String]!
An array of valid coupon codes.
type - ApplyCouponsStrategy
`replace` to replace the existing coupon(s) or `append` to add the coupon to the coupon(s) list.

Example

{
  "cart_id": "xyz789",
  "coupon_codes": ["xyz789"],
  "type": "APPEND"
}

ApplyGiftCardToCartInput

Defines the input required to run the applyGiftCardToCart mutation.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.
gift_card_code - String!
The gift card code to be applied to the cart.

Example

{
  "cart_id": "abc123",
  "gift_card_code": "abc123"
}

ApplyGiftCardToCartOutput

Defines the possible output for the applyGiftCardToCart mutation.

Fields

Field Name
Description
cart - Cart!
Describes the contents of the specified shopping cart.

Example

{"cart": Cart}

ApplyGiftCardToOrder

Contains applied gift cards with gift card code and amount.

Fields

Field Name
Description
applied_balance - Money!
The gift card amount applied to the current order.
code - String!
The gift card account code.

Example

{
  "applied_balance": Money,
  "code": "abc123"
}

ApplyRewardPointsToCartOutput

Contains the customer cart.

Fields

Field Name
Description
cart - Cart!
The customer cart after reward points are applied.

Example

{"cart": Cart}

ApplyStoreCreditToCartInput

Defines the input required to run the applyStoreCreditToCart mutation.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.

Example

{"cart_id": "xyz789"}

ApplyStoreCreditToCartOutput

Defines the possible output for the applyStoreCreditToCart mutation.

Fields

Field Name
Description
cart - Cart!
The contents of the specified shopping cart.

Example

{"cart": Cart}

AreaInput

AreaInput defines the parameters which will be used for filter by specified location.

Input Fields

Input Field
Description
radius - Int!
The radius for the search in KM.
search_term - String!
The country code where search must be performed. Required parameter together with region, city or postcode.

Example

{"radius": 987, "search_term": "xyz789"}

AssignCompareListToCustomerOutput

Contains the results of the request to assign a compare list.

Fields

Field Name
Description
compare_list - CompareList
The contents of the customer's compare list.
result - Boolean!
Indicates whether the compare list was successfully assigned to the customer.

Example

{"compare_list": CompareList, "result": true}

Attribute

Contains details about the attribute, including the code and type.

Fields

Field Name
Description
attribute_code - String
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
attribute_options - [AttributeOption]
Attribute options list.
attribute_type - String
The data type of the attribute.
entity_type - String
The type of entity that defines the attribute.
input_type - String
The frontend input type of the attribute.
storefront_properties - StorefrontProperties
Details about the storefront properties configured for the attribute.

Example

{
  "attribute_code": "xyz789",
  "attribute_options": [AttributeOption],
  "attribute_type": "abc123",
  "entity_type": "xyz789",
  "input_type": "abc123",
  "storefront_properties": StorefrontProperties
}

AttributeEntityTypeEnum

List of all entity types. Populated by the modules introducing EAV entities.

Values

Enum Value
Description
CATALOG_PRODUCT
CATALOG_CATEGORY
CUSTOMER
CUSTOMER_ADDRESS
RMA_ITEM

Example

""CATALOG_PRODUCT""

AttributeFilterInput

An input object that specifies the filters used for attributes.

Input Fields

Input Field
Description
is_comparable - Boolean
Whether a product or category attribute can be compared against another or not.
is_filterable - Boolean
Whether a product or category attribute can be filtered or not.
is_filterable_in_search - Boolean
Whether a product or category attribute can be filtered in search or not.
is_html_allowed_on_front - Boolean
Whether a product or category attribute can use HTML on front or not.
is_searchable - Boolean
Whether a product or category attribute can be searched or not.
is_used_for_customer_segment - Boolean
Whether a customer or customer address attribute is used for customer segment or not.
is_used_for_price_rules - Boolean
Whether a product or category attribute can be used for price rules or not.
is_used_for_promo_rules - Boolean
Whether a product or category attribute is used for promo rules or not.
is_visible_in_advanced_search - Boolean
Whether a product or category attribute is visible in advanced search or not.
is_visible_on_front - Boolean
Whether a product or category attribute is visible on front or not.
is_wysiwyg_enabled - Boolean
Whether a product or category attribute has WYSIWYG enabled or not.
used_in_product_listing - Boolean
Whether a product or category attribute is used in product listing or not.

Example

{
  "is_comparable": false,
  "is_filterable": false,
  "is_filterable_in_search": false,
  "is_html_allowed_on_front": true,
  "is_searchable": true,
  "is_used_for_customer_segment": false,
  "is_used_for_price_rules": true,
  "is_used_for_promo_rules": true,
  "is_visible_in_advanced_search": false,
  "is_visible_on_front": false,
  "is_wysiwyg_enabled": false,
  "used_in_product_listing": false
}

AttributeFrontendInputEnum

EAV attribute frontend input types.

Values

Enum Value
Description
BOOLEAN
DATE
DATETIME
FILE
GALLERY
HIDDEN
IMAGE
MEDIA_IMAGE
MULTILINE
MULTISELECT
PRICE
SELECT
TEXT
TEXTAREA
WEIGHT
UNDEFINED

Example

""BOOLEAN""

AttributeInput

Defines the attribute characteristics to search for the attribute_code and entity_type to search.

Input Fields

Input Field
Description
attribute_code - String
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
entity_type - String
The type of entity that defines the attribute.

Example

{
  "attribute_code": "xyz789",
  "entity_type": "xyz789"
}

AttributeInputSelectedOption

Specifies selected option for a select or multiselect attribute value.

Input Fields

Input Field
Description
value - String!
The attribute option value.

Example

{"value": "xyz789"}

AttributeMetadata

Base EAV implementation of CustomAttributeMetadataInterface.

Fields

Field Name
Description
code - ID!
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
default_value - String
Default attribute value.
entity_type - AttributeEntityTypeEnum!
The type of entity that defines the attribute.
frontend_class - String
The frontend class of the attribute.
frontend_input - AttributeFrontendInputEnum
The frontend input type of the attribute.
is_required - Boolean!
Whether the attribute value is required.
is_unique - Boolean!
Whether the attribute value must be unique.
label - String
The label assigned to the attribute.
options - [CustomAttributeOptionInterface]!
Attribute options.

Example

{
  "code": "4",
  "default_value": "xyz789",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "xyz789",
  "frontend_input": "BOOLEAN",
  "is_required": true,
  "is_unique": true,
  "label": "abc123",
  "options": [CustomAttributeOptionInterface]
}

AttributeMetadataError

Attribute metadata retrieval error.

Fields

Field Name
Description
message - String!
Attribute metadata retrieval error message.
type - AttributeMetadataErrorType!
Attribute metadata retrieval error type.

Example

{
  "message": "xyz789",
  "type": "ENTITY_NOT_FOUND"
}

AttributeMetadataErrorType

Attribute metadata retrieval error types.

Values

Enum Value
Description
ENTITY_NOT_FOUND
The requested entity was not found.
ATTRIBUTE_NOT_FOUND
The requested attribute was not found.
FILTER_NOT_FOUND
The filter cannot be applied as it does not belong to the entity
UNDEFINED
Not categorized error, see the error message.

Example

""ENTITY_NOT_FOUND""

AttributeOption

Defines an attribute option.

Fields

Field Name
Description
label - String
The label assigned to the attribute option.
value - String
The attribute option value.

Example

{
  "label": "abc123",
  "value": "abc123"
}

AttributeOptionMetadata

Base EAV implementation of CustomAttributeOptionInterface.

Fields

Field Name
Description
is_default - Boolean!
Is the option value default.
label - String!
The label assigned to the attribute option.
value - String!
The attribute option value.

Example

{
  "is_default": false,
  "label": "abc123",
  "value": "xyz789"
}

AttributeSelectedOption

Fields

Field Name
Description
label - String!
The attribute selected option label.
value - String!
The attribute selected option value.

Example

{
  "label": "abc123",
  "value": "abc123"
}

AttributeSelectedOptionInterface

Fields

Field Name
Description
label - String!
The attribute selected option label.
value - String!
The attribute selected option value.

Possible Types

AttributeSelectedOptionInterface Types
AttributeSelectedOption

Example

{
  "label": "xyz789",
  "value": "xyz789"
}

AttributeSelectedOptions

Fields

Field Name
Description
code - ID!
The attribute code.
selected_options - [AttributeSelectedOptionInterface]!

Example

{
  "code": 4,
  "selected_options": [AttributeSelectedOptionInterface]
}

AttributeValue

Fields

Field Name
Description
code - ID!
The attribute code.
value - String!
The attribute value.

Example

{"code": 4, "value": "abc123"}

AttributeValueInput

Specifies the value for attribute.

Input Fields

Input Field
Description
attribute_code - String!
The code of the attribute.
selected_options - [AttributeInputSelectedOption]
An array containing selected options for a select or multiselect attribute.
value - String
The value assigned to the attribute.

Example

{
  "attribute_code": "xyz789",
  "selected_options": [AttributeInputSelectedOption],
  "value": "abc123"
}

AttributeValueInterface

Fields

Field Name
Description
code - ID!
The attribute code.

Possible Types

Example

{"code": "4"}

AttributesFormOutput

Metadata of EAV attributes associated to form

Fields

Field Name
Description
errors - [AttributeMetadataError]!
Errors of retrieving certain attributes metadata.
items - [CustomAttributeMetadataInterface]!
Requested attributes metadata.

Example

{
  "errors": [AttributeMetadataError],
  "items": [CustomAttributeMetadataInterface]
}

AttributesMetadataOutput

Metadata of EAV attributes.

Fields

Field Name
Description
errors - [AttributeMetadataError]!
Errors of retrieving certain attributes metadata.
items - [CustomAttributeMetadataInterface]!
Requested attributes metadata.

Example

{
  "errors": [AttributeMetadataError],
  "items": [CustomAttributeMetadataInterface]
}

AvailableCurrency

Defines the code and symbol of a currency that can be used for purchase orders.

Fields

Field Name
Description
code - CurrencyEnum!
3-letter currency code, for example USD.
symbol - String!
Currency symbol, for example $.

Example

{"code": "AFN", "symbol": "abc123"}

AvailablePaymentMethod

Describes a payment method that the shopper can use to pay for the order.

Fields

Field Name
Description
code - String!
The payment method code.
is_deferred - Boolean!
If the payment method is an online integration
title - String!
The payment method title.

Example

{
  "code": "xyz789",
  "is_deferred": false,
  "title": "abc123"
}

AvailableShippingMethod

Contains details about the possible shipping methods and carriers.

Fields

Field Name
Description
amount - Money!
The cost of shipping using this shipping method.
available - Boolean!
Indicates whether this shipping method can be applied to the cart.
base_amount - Money
(Deprecated: The field should not be used on the storefront.)
carrier_code - String!
A string that identifies a commercial carrier or an offline shipping method.
carrier_title - String!
The label for the carrier code.
error_message - String
Describes an error condition.
method_code - String
A shipping method code associated with a carrier. The value could be null if no method is available.
method_title - String
The label for the shipping method code. The value could be null if no method is available.
price_excl_tax - Money!
The cost of shipping using this shipping method, excluding tax.
price_incl_tax - Money!
The cost of shipping using this shipping method, including tax.

Example

{
  "amount": Money,
  "available": false,
  "base_amount": Money,
  "carrier_code": "xyz789",
  "carrier_title": "xyz789",
  "error_message": "xyz789",
  "method_code": "xyz789",
  "method_title": "xyz789",
  "price_excl_tax": Money,
  "price_incl_tax": Money
}

BatchMutationStatus

Values

Enum Value
Description
SUCCESS
FAILURE
MIXED_RESULTS

Example

""SUCCESS""

BillingAddressInput

Defines the billing address.

Input Fields

Input Field
Description
address - CartAddressInput
Defines a billing address.
customer_address_id - Int
An ID from the customer's address book that uniquely identifies the address to be used for billing.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address to be used for billing.
same_as_shipping - Boolean
Indicates whether to set the billing address to be the same as the existing shipping address on the cart.
use_for_shipping - Boolean
Indicates whether to set the shipping address to be the same as this billing address.

Example

{
  "address": CartAddressInput,
  "customer_address_id": 987,
  "customer_address_uid": 4,
  "same_as_shipping": false,
  "use_for_shipping": true
}

BillingAddressPaymentSourceInput

The billing address information

Input Fields

Input Field
Description
address_line_1 - String
The first line of the address
address_line_2 - String
The second line of the address
city - String
The city of the address
country_code - String!
The country of the address
postal_code - String
The postal code of the address
region - String
The region of the address

Example

{
  "address_line_1": "abc123",
  "address_line_2": "xyz789",
  "city": "abc123",
  "country_code": "abc123",
  "postal_code": "abc123",
  "region": "abc123"
}

BillingCartAddress

Contains details about the billing address.

Fields

Field Name
Description
city - String!
The city specified for the billing or shipping address.
company - String
The company specified for the billing or shipping address.
country - CartAddressCountry!
An object containing the country label and code.
custom_attributes - [AttributeValueInterface]!
The custom attribute values of the billing or shipping address.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
customer_notes - String
(Deprecated: The field is used only in shipping address.)
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
id - Int
Id of the customer address. (Deprecated: Use `customer_address_uid` instead.)
lastname - String!
The last name of the customer or guest.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The ZIP or postal code of the billing or shipping address.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - CartAddressRegion
An object containing the region label and code.
street - [String]!
An array containing the street for the billing or shipping address.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number for the billing or shipping address.
uid - ID!
The unique id of the customer cart address.
vat_id - String
The VAT company number for billing or shipping address.

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country": CartAddressCountry,
  "custom_attributes": [AttributeValueInterface],
  "customer_address_uid": 4,
  "customer_notes": "xyz789",
  "fax": "xyz789",
  "firstname": "xyz789",
  "id": 987,
  "lastname": "xyz789",
  "middlename": "xyz789",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": CartAddressRegion,
  "street": ["abc123"],
  "suffix": "xyz789",
  "telephone": "abc123",
  "uid": "4",
  "vat_id": "xyz789"
}

Boolean

The Boolean scalar type represents true or false.

Example

true

BraintreeCcVaultInput

Input Fields

Input Field
Description
device_data - String
public_hash - String!

Example

{
  "device_data": "xyz789",
  "public_hash": "xyz789"
}

BraintreeInput

Input Fields

Input Field
Description
device_data - String
Contains a fingerprint provided by Braintree JS SDK and should be sent with sale transaction details to the Braintree payment gateway.
is_active_payment_token_enabler - Boolean!
States whether the payment details (Credit/Debit Card, PayPal Account) entered by a customer should be tokenized for later usage. Required only if Vault is enabled for the relevant Braintree payment integration.
payment_method_nonce - String!
The one-time payment token generated by Braintree payment gateway based on payment details (Card, PayPal). Required field to make sale transaction.

Example

{
  "device_data": "xyz789",
  "is_active_payment_token_enabler": true,
  "payment_method_nonce": "abc123"
}

BraintreeVaultInput

Input Fields

Input Field
Description
device_data - String
public_hash - String!

Example

{
  "device_data": "abc123",
  "public_hash": "xyz789"
}

Contains details about an individual category that comprises a breadcrumb.

Fields

Field Name
Description
category_id - Int
The ID of the category. (Deprecated: Use `category_uid` instead.)
category_level - Int
The category level.
category_name - String
The display name of the category.
category_uid - ID!
The unique ID for a `Breadcrumb` object.
category_url_key - String
The URL key of the category.
category_url_path - String
The URL path of the category.

Example

{
  "category_id": 987,
  "category_level": 123,
  "category_name": "xyz789",
  "category_uid": 4,
  "category_url_key": "abc123",
  "category_url_path": "xyz789"
}

BundleCartItem

An implementation for bundle product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
bundle_options - [SelectedBundleOption]!
An array containing the bundle options the shopper selected.
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
gift_message - GiftMessage
The entered gift message for the cart item
gift_wrapping - GiftWrapping
The selected gift wrapping for the cart item.
id - String!
(Deprecated: Use `uid` instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
not_available_message - String
Message to display when the product is not available with this selected option.
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "available_gift_wrapping": [GiftWrapping],
  "bundle_options": [SelectedBundleOption],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "xyz789",
  "is_available": true,
  "max_qty": 123.45,
  "min_qty": 987.65,
  "not_available_message": "xyz789",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "uid": "4"
}

BundleCreditMemoItem

Defines bundle product options for CreditMemoItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to a bundle product that is part of a credit memo.
discounts - [Discount]
Details about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for a `CreditMemoItemInterface` object.
order_item - OrderItemInterface
The order item the credit memo is applied to.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product, including selected options.
product_sku - String!
The SKU of the base product.
quantity_refunded - Float
The number of refunded items.

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "discounts": [Discount],
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_refunded": 123.45
}

BundleInvoiceItem

Defines bundle product options for InvoiceItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to an invoiced bundle product.
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for an `InvoiceItemInterface` object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "discounts": [Discount],
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_invoiced": 123.45
}

BundleItem

Defines an individual item within a bundle product.

Fields

Field Name
Description
option_id - Int
An ID assigned to each type of item in a bundle product. (Deprecated: Use `uid` instead)
options - [BundleItemOption]
An array of additional options for this bundle item.
position - Int
A number indicating the sequence order of this item compared to the other bundle items.
price_range - PriceRange!
The range of prices for the product
required - Boolean
Indicates whether the item must be included in the bundle.
sku - String
The SKU of the bundle product.
title - String
The display name of the item.
type - String
The input type that the customer uses to select the item. Examples include radio button and checkbox.
uid - ID
The unique ID for a `BundleItem` object.

Example

{
  "option_id": 123,
  "options": [BundleItemOption],
  "position": 123,
  "price_range": PriceRange,
  "required": true,
  "sku": "xyz789",
  "title": "xyz789",
  "type": "xyz789",
  "uid": "4"
}

BundleItemOption

Defines the characteristics that comprise a specific bundle item and its options.

Fields

Field Name
Description
can_change_quantity - Boolean
Indicates whether the customer can change the number of items for this option.
id - Int
The ID assigned to the bundled item option. (Deprecated: Use `uid` instead)
is_default - Boolean
Indicates whether this option is the default option.
label - String
The text that identifies the bundled item option.
position - Int
When a bundle item contains multiple options, the relative position of this option compared to the other options.
price - Float
The price of the selected option.
price_type - PriceTypeEnum
One of FIXED, PERCENT, or DYNAMIC.
product - ProductInterface
Contains details about this product option.
qty - Float
Indicates the quantity of this specific bundle item. (Deprecated: Use `quantity` instead.)
quantity - Float
The quantity of this specific bundle item.
uid - ID!
The unique ID for a `BundleItemOption` object.

Example

{
  "can_change_quantity": true,
  "id": 987,
  "is_default": true,
  "label": "xyz789",
  "position": 123,
  "price": 987.65,
  "price_type": "FIXED",
  "product": ProductInterface,
  "qty": 987.65,
  "quantity": 987.65,
  "uid": "4"
}

BundleOptionInput

Defines the input for a bundle option.

Input Fields

Input Field
Description
id - Int!
The ID of the option.
quantity - Float!
The number of the selected item to add to the cart.
value - [String]!
An array with the chosen value of the option.

Example

{
  "id": 987,
  "quantity": 123.45,
  "value": ["abc123"]
}

BundleOrderItem

Defines bundle product options for OrderItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to the bundle product.
discounts - [Discount]
The final discount information for the product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an `OrderItemInterface` object.
parent_sku - String
The SKU of parent product.
prices - OrderItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface
The ProductInterface object, which contains details about the base product
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_return_requested - Float
The requested return quantity of the item.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "discounts": [Discount],
  "eligible_for_return": false,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "parent_sku": "xyz789",
  "prices": OrderItemPrices,
  "product": ProductInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "product_type": "abc123",
  "product_url_key": "xyz789",
  "quantity_canceled": 987.65,
  "quantity_invoiced": 123.45,
  "quantity_ordered": 123.45,
  "quantity_refunded": 123.45,
  "quantity_return_requested": 987.65,
  "quantity_returned": 123.45,
  "quantity_shipped": 123.45,
  "selected_options": [OrderItemOption],
  "status": "abc123"
}

BundleProduct

Defines basic features of a bundle product and contains multiple BundleItems.

Fields

Field Name
Description
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
dynamic_price - Boolean
Indicates whether the bundle product has a dynamic price.
dynamic_sku - Boolean
Indicates whether the bundle product has a dynamic SKU.
dynamic_weight - Boolean
Indicates whether the bundle product has a dynamically calculated weight.
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
items - [BundleItem]
An array containing information about individual bundle items.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_details - PriceDetails
The price details of the main product
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
price_view - PriceViewEnum
One of PRICE_RANGE or AS_LOW_AS.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
quantity - Float
Amount of available stock
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
ship_bundle_items - ShipBundleItemsEnum
Indicates whether to ship bundle items together or individually.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "color": 987,
  "country_of_manufacture": "xyz789",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "dynamic_price": false,
  "dynamic_sku": true,
  "dynamic_weight": true,
  "gift_message_available": true,
  "gift_wrapping_available": true,
  "gift_wrapping_price": Money,
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "items": [BundleItem],
  "manufacturer": 987,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "min_sale_qty": 123.45,
  "name": "xyz789",
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "price": ProductPrices,
  "price_details": PriceDetails,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "price_view": "PRICE_RANGE",
  "product_links": [ProductLinksInterface],
  "quantity": 987.65,
  "rating_summary": 987.65,
  "redirect_code": 123,
  "related_products": [ProductInterface],
  "relative_url": "xyz789",
  "review_count": 987,
  "reviews": ProductReviews,
  "ship_bundle_items": "TOGETHER",
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "staged": false,
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "xyz789",
  "uid": "4",
  "updated_at": "abc123",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "xyz789",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "websites": [Website],
  "weight": 987.65
}

BundleProductCartItemInput

Defines a single bundle product.

Input Fields

Input Field
Description
bundle_options - [BundleOptionInput]!
A mandatory array of options for the bundle product, including each chosen option and specified quantity.
customizable_options - [CustomizableOptionInput]
The ID and value of the option.
data - CartItemInput!
The quantity and SKU of the bundle product.

Example

{
  "bundle_options": [BundleOptionInput],
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput
}

BundleRequisitionListItem

Contains details about bundle products added to a requisition list.

Fields

Field Name
Description
bundle_options - [SelectedBundleOption]!
An array of selected options for a bundle product.
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The quantity of the product added to the requisition list.
uid - ID!
The unique ID of an item in a requisition list.

Example

{
  "bundle_options": [SelectedBundleOption],
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 987.65,
  "uid": "4"
}

BundleShipmentItem

Defines bundle product options for ShipmentItemInterface.

Fields

Field Name
Description
bundle_options - [ItemSelectedBundleOption]
A list of bundle options that are assigned to a shipped product.
id - ID!
The unique ID for a `ShipmentItemInterface` object.
order_item - OrderItemInterface
The order item associated with the shipment item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product.
product_sku - String!
The SKU of the base product.
quantity_shipped - Float!
The number of shipped items.

Example

{
  "bundle_options": [ItemSelectedBundleOption],
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "quantity_shipped": 987.65
}

BundleWishlistItem

Defines bundle product options for WishlistItemInterface.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
bundle_options - [SelectedBundleOption]
An array containing information about the selected bundle items.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "abc123",
  "bundle_options": [SelectedBundleOption],
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": 4,
  "product": ProductInterface,
  "quantity": 987.65
}

ButtonStyles

Fields

Field Name
Description
color - String
The button color
height - Int
The button height in pixels
label - String
The button label
layout - String
The button layout
shape - String
The button shape
tagline - Boolean
Indicates whether the tagline is displayed
use_default_height - Boolean
Defines if the button uses default height. If the value is false, the value of height is used

Example

{
  "color": "xyz789",
  "height": 123,
  "label": "xyz789",
  "layout": "xyz789",
  "shape": "abc123",
  "tagline": false,
  "use_default_height": false
}

CancelNegotiableQuoteTemplateInput

Specifies the quote template id of the quote template to cancel

Input Fields

Input Field
Description
cancellation_comment - String
A comment to provide reason of cancellation.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "cancellation_comment": "xyz789",
  "template_id": "4"
}

CancelOrderError

Fields

Field Name
Description
code - CancelOrderErrorCode!
An error code that is specific to cancel order.
message - String!
A localized error message.

Example

{
  "code": "ORDER_CANCELLATION_DISABLED",
  "message": "abc123"
}

CancelOrderErrorCode

Values

Enum Value
Description
ORDER_CANCELLATION_DISABLED
UNDEFINED
UNAUTHORISED
ORDER_NOT_FOUND
PARTIAL_ORDER_ITEM_SHIPPED
INVALID_ORDER_STATUS

Example

""ORDER_CANCELLATION_DISABLED""

CancelOrderInput

Defines the order to cancel.

Input Fields

Input Field
Description
order_id - ID!
The unique ID of an `Order` type.
reason - String!
Cancellation reason.

Example

{"order_id": 4, "reason": "xyz789"}

CancelOrderOutput

Contains the updated customer order and error message if any.

Fields

Field Name
Description
error - String
Error encountered while cancelling the order.
errorV2 - CancelOrderError
order - CustomerOrder
Updated customer order.

Example

{
  "error": "abc123",
  "errorV2": CancelOrderError,
  "order": CustomerOrder
}

CancellationReason

Fields

Field Name
Description
description - String!

Example

{"description": "xyz789"}

Card

Fields

Field Name
Description
bin_details - CardBin
Card bin details
card_expiry_month - String
Expiration month of the card
card_expiry_year - String
Expiration year of the card
last_digits - String
Last four digits of the card
name - String
Name on the card

Example

{
  "bin_details": CardBin,
  "card_expiry_month": "xyz789",
  "card_expiry_year": "abc123",
  "last_digits": "xyz789",
  "name": "xyz789"
}

CardBin

Fields

Field Name
Description
bin - String
Card bin number

Example

{"bin": "xyz789"}

CardPaymentSourceInput

The card payment source information

Input Fields

Input Field
Description
billing_address - BillingAddressPaymentSourceInput!
The billing address of the card
name - String
The name on the cardholder

Example

{
  "billing_address": BillingAddressPaymentSourceInput,
  "name": "abc123"
}

CardPaymentSourceOutput

The card payment source information

Fields

Field Name
Description
brand - String
The brand of the card
expiry - String
The expiry of the card
last_digits - String
The last digits of the card

Example

{
  "brand": "abc123",
  "expiry": "abc123",
  "last_digits": "abc123"
}

Cart

Contains the contents and other details about a guest or customer cart.

Fields

Field Name
Description
applied_coupon - AppliedCoupon
(Deprecated: Use `applied_coupons` instead.)
applied_coupons - [AppliedCoupon]
An array of `AppliedCoupon` objects. Each object contains the `code` text attribute, which specifies the coupon code.
applied_gift_cards - [AppliedGiftCard]
An array of gift card items applied to the cart.
applied_reward_points - RewardPointsAmount
The amount of reward points applied to the cart.
applied_store_credit - AppliedStoreCredit
Store credit information applied to the cart.
available_gift_wrappings - [GiftWrapping]!
The list of available gift wrapping options for the cart.
available_payment_methods - [AvailablePaymentMethod]
An array of available payment methods.
billing_address - BillingCartAddress
The billing address assigned to the cart.
email - String
The email address of the guest or customer.
gift_message - GiftMessage
The entered gift message for the cart
gift_receipt_included - Boolean!
Indicates whether the shopper requested gift receipt for the cart.
gift_wrapping - GiftWrapping
The selected gift wrapping for the cart.
id - ID!
The unique ID for a `Cart` object.
is_virtual - Boolean!
Indicates whether the cart contains only virtual products.
items - [CartItemInterface]
An array of products that have been added to the cart. (Deprecated: Use `itemsV2` instead.)
itemsV2 - CartItems
prices - CartPrices
Pricing details for the quote.
printed_card_included - Boolean!
Indicates whether the shopper requested a printed card for the cart.
rules - [CartRuleStorefront]
Provides applied cart rules in the current active cart
selected_payment_method - SelectedPaymentMethod
Indicates which payment method was applied to the cart.
shipping_addresses - [ShippingCartAddress]!
An array of shipping addresses assigned to the cart.
total_quantity - Float!
The total number of items in the cart.

Example

{
  "applied_coupon": AppliedCoupon,
  "applied_coupons": [AppliedCoupon],
  "applied_gift_cards": [AppliedGiftCard],
  "applied_reward_points": RewardPointsAmount,
  "applied_store_credit": AppliedStoreCredit,
  "available_gift_wrappings": [GiftWrapping],
  "available_payment_methods": [AvailablePaymentMethod],
  "billing_address": BillingCartAddress,
  "email": "xyz789",
  "gift_message": GiftMessage,
  "gift_receipt_included": true,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "is_virtual": false,
  "items": [CartItemInterface],
  "itemsV2": CartItems,
  "prices": CartPrices,
  "printed_card_included": false,
  "rules": [CartRuleStorefront],
  "selected_payment_method": SelectedPaymentMethod,
  "shipping_addresses": [ShippingCartAddress],
  "total_quantity": 123.45
}

CartAddressCountry

Contains details the country in a billing or shipping address.

Fields

Field Name
Description
code - String!
The country code.
label - String!
The display label for the country.

Example

{
  "code": "abc123",
  "label": "abc123"
}

CartAddressInput

Defines the billing or shipping address to be applied to the cart.

Input Fields

Input Field
Description
city - String!
The city specified for the billing or shipping address.
company - String
The company specified for the billing or shipping address.
country_code - String!
The country code and label for the billing or shipping address.
custom_attributes - [AttributeValueInput]
The custom attribute values of the billing or shipping address.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
lastname - String!
The last name of the customer or guest.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The ZIP or postal code of the billing or shipping address.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - String
A string that defines the state or province of the billing or shipping address.
region_id - Int
An integer that defines the state or province of the billing or shipping address.
save_in_address_book - Boolean
Determines whether to save the address in the customer's address book. The default value is true.
street - [String]!
An array containing the street for the billing or shipping address.
suffix - String
A value such as Sr., Jr., or III.
telephone - String!
The telephone number for the billing or shipping address.
vat_id - String
The VAT company number for billing or shipping address.

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country_code": "abc123",
  "custom_attributes": [AttributeValueInput],
  "fax": "abc123",
  "firstname": "abc123",
  "lastname": "abc123",
  "middlename": "xyz789",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": "xyz789",
  "region_id": 123,
  "save_in_address_book": false,
  "street": ["xyz789"],
  "suffix": "abc123",
  "telephone": "abc123",
  "vat_id": "abc123"
}

CartAddressInterface

Fields

Field Name
Description
city - String!
The city specified for the billing or shipping address.
company - String
The company specified for the billing or shipping address.
country - CartAddressCountry!
An object containing the country label and code.
custom_attributes - [AttributeValueInterface]!
The custom attribute values of the billing or shipping address.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
id - Int
Id of the customer address. (Deprecated: Use `customer_address_uid` instead.)
lastname - String!
The last name of the customer or guest.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The ZIP or postal code of the billing or shipping address.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - CartAddressRegion
An object containing the region label and code.
street - [String]!
An array containing the street for the billing or shipping address.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number for the billing or shipping address.
uid - ID!
The unique id of the customer cart address.
vat_id - String
The VAT company number for billing or shipping address.

Possible Types

CartAddressInterface Types
ShippingCartAddress
BillingCartAddress

Example

{
  "city": "xyz789",
  "company": "abc123",
  "country": CartAddressCountry,
  "custom_attributes": [AttributeValueInterface],
  "customer_address_uid": 4,
  "fax": "xyz789",
  "firstname": "abc123",
  "id": 123,
  "lastname": "xyz789",
  "middlename": "abc123",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": CartAddressRegion,
  "street": ["abc123"],
  "suffix": "abc123",
  "telephone": "abc123",
  "uid": "4",
  "vat_id": "abc123"
}

CartAddressRegion

Contains details about the region in a billing or shipping address.

Fields

Field Name
Description
code - String
The state or province code.
label - String
The display label for the region.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "code": "abc123",
  "label": "xyz789",
  "region_id": 987
}

CartDiscount

Contains information about discounts applied to the cart.

Fields

Field Name
Description
amount - Money!
The amount of the discount applied to the item.
label - [String]!
The description of the discount.

Example

{
  "amount": Money,
  "label": ["xyz789"]
}

CartDiscountType

Values

Enum Value
Description
ITEM
SHIPPING

Example

""ITEM""

CartItemError

Fields

Field Name
Description
code - CartItemErrorType!
An error code that describes the error encountered
message - String!
A localized error message

Example

{"code": "UNDEFINED", "message": "xyz789"}

CartItemErrorType

Values

Enum Value
Description
UNDEFINED
ITEM_QTY
ITEM_INCREMENTS

Example

""UNDEFINED""

CartItemInput

Defines an item to be added to the cart.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of entered options for the base product, such as personalization text.
parent_sku - String
For a child product, the SKU of its parent product.
quantity - Float!
The amount or number of an item to add.
selected_options - [ID]
The selected options for the base product, such as color or size, using the unique ID for an object such as `CustomizableRadioOption`, `CustomizableDropDownOption`, or `ConfigurableProductOptionsValues`.
sku - String!
The SKU of the product.

Example

{
  "entered_options": [EnteredOptionInput],
  "parent_sku": "abc123",
  "quantity": 987.65,
  "selected_options": ["4"],
  "sku": "xyz789"
}

CartItemInterface

An interface for products in a cart.

Fields

Field Name
Description
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use `uid` instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
not_available_message - String
Message to display when the product is not available with this selected option.
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Possible Types

Example

{
  "discount": [Discount],
  "errors": [CartItemError],
  "id": "abc123",
  "is_available": true,
  "max_qty": 987.65,
  "min_qty": 987.65,
  "not_available_message": "abc123",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "uid": "4"
}

CartItemPrices

Contains details about the price of the item, including taxes and discounts.

Fields

Field Name
Description
catalog_discount - ProductDiscount
The price discount for the unit price of the item represents the difference between its regular price and final price.
discounts - [Discount]
An array of discounts to be applied to the cart item.
fixed_product_taxes - [FixedProductTax]
An array of FPTs applied to the cart item.
original_item_price - Money!
The value of the original unit price for the item, including discounts.
original_row_total - Money!
The value of the original price multiplied by the quantity of the item.
price - Money!
The price of the item before any discounts were applied. The price that might include tax, depending on the configured display settings for cart.
price_including_tax - Money!
The price of the item before any discounts were applied. The price that might include tax, depending on the configured display settings for cart.
row_catalog_discount - ProductDiscount
The price discount multiplied by the item quantity represents the total difference between the regular price and the final price for the entire quote item.
row_total - Money!
The value of the price multiplied by the quantity of the item.
row_total_including_tax - Money!
The value of `row_total` plus the tax applied to the item.
total_item_discount - Money
The total of all discounts applied to the item.

Example

{
  "catalog_discount": ProductDiscount,
  "discounts": [Discount],
  "fixed_product_taxes": [FixedProductTax],
  "original_item_price": Money,
  "original_row_total": Money,
  "price": Money,
  "price_including_tax": Money,
  "row_catalog_discount": ProductDiscount,
  "row_total": Money,
  "row_total_including_tax": Money,
  "total_item_discount": Money
}

CartItemQuantity

Deprecated: The ShippingCartAddress.cart_items field now returns CartItemInterface.

Fields

Field Name
Description
cart_item_id - Int!
(Deprecated: The `ShippingCartAddress.cart_items` field now returns `CartItemInterface`.)
quantity - Float!
(Deprecated: The `ShippingCartAddress.cart_items` field now returns `CartItemInterface`.)

Example

{"cart_item_id": 987, "quantity": 987.65}

CartItemSelectedOptionValuePrice

Contains details about the price of a selected customizable value.

Fields

Field Name
Description
type - PriceTypeEnum!
Indicates whether the price type is fixed, percent, or dynamic.
units - String!
A string that describes the unit of the value.
value - Float!
A price value.

Example

{
  "type": "FIXED",
  "units": "abc123",
  "value": 123.45
}

CartItemUpdateInput

A single item to be updated.

Input Fields

Input Field
Description
cart_item_id - Int
Deprecated. Use `cart_item_uid` instead.
cart_item_uid - ID
The unique ID for a `CartItemInterface` object.
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
gift_message - GiftMessageInput
Gift message details for the cart item
gift_wrapping_id - ID
The unique ID for a `GiftWrapping` object to be used for the cart item.
quantity - Float
The new quantity of the item.

Example

{
  "cart_item_id": 123,
  "cart_item_uid": 4,
  "customizable_options": [CustomizableOptionInput],
  "gift_message": GiftMessageInput,
  "gift_wrapping_id": 4,
  "quantity": 987.65
}

CartItems

Fields

Field Name
Description
items - [CartItemInterface]!
An array of products that have been added to the cart.
page_info - SearchResultPageInfo
Metadata for pagination rendering.
total_count - Int!
The number of returned cart items.

Example

{
  "items": [CartItemInterface],
  "page_info": SearchResultPageInfo,
  "total_count": 123
}

CartPrices

Contains details about the final price of items in the cart, including discount and tax information.

Fields

Field Name
Description
applied_taxes - [CartTaxItem]
An array containing the names and amounts of taxes applied to each item in the cart.
discount - CartDiscount
(Deprecated: Use discounts instead.)
discounts - [Discount]
An array containing cart rule discounts, store credit and gift cards applied to the cart.
gift_options - GiftOptionsPrices
The list of prices for the selected gift options.
grand_total - Money
The total, including discounts, taxes, shipping, and other fees.
grand_total_excluding_tax - Money
The total of the cart, including discounts, shipping, and other fees without tax.
subtotal_excluding_tax - Money
The subtotal without any applied taxes.
subtotal_including_tax - Money
The subtotal including any applied taxes.
subtotal_with_discount_excluding_tax - Money
The subtotal with any discounts applied, but not taxes.

Example

{
  "applied_taxes": [CartTaxItem],
  "discount": CartDiscount,
  "discounts": [Discount],
  "gift_options": GiftOptionsPrices,
  "grand_total": Money,
  "grand_total_excluding_tax": Money,
  "subtotal_excluding_tax": Money,
  "subtotal_including_tax": Money,
  "subtotal_with_discount_excluding_tax": Money
}

CartRuleStorefront

Fields

Field Name
Description
uid - ID!
The unique ID for a `CartRule` object.

Example

{"uid": "4"}

CartTaxItem

Contains tax information about an item in the cart.

Fields

Field Name
Description
amount - Money!
The amount of tax applied to the item.
label - String!
The description of the tax.

Example

{
  "amount": Money,
  "label": "abc123"
}

CartUserInputError

Fields

Field Name
Description
code - CartUserInputErrorType!
A cart-specific error code.
message - String!
A localized error message.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "xyz789"
}

CartUserInputErrorType

Values

Enum Value
Description
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
COULD_NOT_FIND_CART_ITEM
REQUIRED_PARAMETER_MISSING
INVALID_PARAMETER_VALUE
UNDEFINED
PERMISSION_DENIED

Example

""PRODUCT_NOT_FOUND""

CatalogAttributeApplyToEnum

Values

Enum Value
Description
SIMPLE
VIRTUAL
BUNDLE
DOWNLOADABLE
CONFIGURABLE
GROUPED
CATEGORY

Example

""SIMPLE""

CatalogAttributeMetadata

Swatch attribute metadata.

Fields

Field Name
Description
apply_to - [CatalogAttributeApplyToEnum]
To which catalog types an attribute can be applied.
code - ID!
The unique identifier for an attribute code. This value should be in lowercase letters without spaces.
default_value - String
Default attribute value.
entity_type - AttributeEntityTypeEnum!
The type of entity that defines the attribute.
frontend_class - String
The frontend class of the attribute.
frontend_input - AttributeFrontendInputEnum
The frontend input type of the attribute.
is_comparable - Boolean
Whether a product or category attribute can be compared against another or not.
is_filterable - Boolean
Whether a product or category attribute can be filtered or not.
is_filterable_in_search - Boolean
Whether a product or category attribute can be filtered in search or not.
is_html_allowed_on_front - Boolean
Whether a product or category attribute can use HTML on front or not.
is_required - Boolean!
Whether the attribute value is required.
is_searchable - Boolean
Whether a product or category attribute can be searched or not.
is_unique - Boolean!
Whether the attribute value must be unique.
is_used_for_price_rules - Boolean
Whether a product or category attribute can be used for price rules or not.
is_used_for_promo_rules - Boolean
Whether a product or category attribute is used for promo rules or not.
is_visible_in_advanced_search - Boolean
Whether a product or category attribute is visible in advanced search or not.
is_visible_on_front - Boolean
Whether a product or category attribute is visible on front or not.
is_wysiwyg_enabled - Boolean
Whether a product or category attribute has WYSIWYG enabled or not.
label - String
The label assigned to the attribute.
options - [CustomAttributeOptionInterface]!
Attribute options.
swatch_input_type - SwatchInputTypeEnum
Input type of the swatch attribute option.
update_product_preview_image - Boolean
Whether update product preview image or not.
use_product_image_for_swatch - Boolean
Whether use product image for swatch or not.
used_in_product_listing - Boolean
Whether a product or category attribute is used in product listing or not.

Example

{
  "apply_to": ["SIMPLE"],
  "code": 4,
  "default_value": "xyz789",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "abc123",
  "frontend_input": "BOOLEAN",
  "is_comparable": true,
  "is_filterable": true,
  "is_filterable_in_search": false,
  "is_html_allowed_on_front": true,
  "is_required": true,
  "is_searchable": false,
  "is_unique": false,
  "is_used_for_price_rules": true,
  "is_used_for_promo_rules": true,
  "is_visible_in_advanced_search": false,
  "is_visible_on_front": false,
  "is_wysiwyg_enabled": false,
  "label": "abc123",
  "options": [CustomAttributeOptionInterface],
  "swatch_input_type": "BOOLEAN",
  "update_product_preview_image": false,
  "use_product_image_for_swatch": true,
  "used_in_product_listing": false
}

CategoryFilterInput

Defines the filters to be used in the search. A filter contains at least one attribute, a comparison operator, and the value that is being searched for.

Input Fields

Input Field
Description
category_uid - FilterEqualTypeInput
Filter by the unique category ID for a `CategoryInterface` object.
ids - FilterEqualTypeInput
Deprecated: use 'category_uid' to filter uniquely identifiers of categories.
name - FilterMatchTypeInput
Filter by the display name of the category.
parent_category_uid - FilterEqualTypeInput
Filter by the unique parent category ID for a `CategoryInterface` object.
parent_id - FilterEqualTypeInput
Filter by the unique parent category ID for a `CategoryInterface` object.
url_key - FilterEqualTypeInput
Filter by the part of the URL that identifies the category.
url_path - FilterEqualTypeInput
Filter by the URL path for the category.

Example

{
  "category_uid": FilterEqualTypeInput,
  "ids": FilterEqualTypeInput,
  "name": FilterMatchTypeInput,
  "parent_category_uid": FilterEqualTypeInput,
  "parent_id": FilterEqualTypeInput,
  "url_key": FilterEqualTypeInput,
  "url_path": FilterEqualTypeInput
}

CategoryInterface

Contains the full set of attributes that can be returned in a category search.

Fields

Field Name
Description
automatic_sorting - String
available_sort_by - [String]
breadcrumbs - [Breadcrumb]
An array of breadcrumb items.
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Categories' is enabled.
children_count - String
cms_block - CmsBlock
Contains a category CMS block.
created_at - String
The timestamp indicating when the category was created. (Deprecated: The field should not be used on the storefront.)
custom_layout_update_file - String
default_sort_by - String
The attribute to use for sorting.
description - String
An optional description of the category.
display_mode - String
filter_price_range - Float
id - Int
An ID that uniquely identifies the category. (Deprecated: Use `uid` instead.)
image - String
include_in_menu - Int
is_anchor - Int
landing_page - Int
level - Int
The depth of the category within the tree.
meta_description - String
meta_keywords - String
meta_title - String
name - String
The display name of the category.
path - String
The full category path.
path_in_store - String
The category path within the store.
position - Int
The position of the category relative to other categories at the same level in tree.
product_count - Int
The number of products in the category that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.
products - CategoryProducts
The list of products assigned to the category.
staged - Boolean!
Indicates whether the category is staged for a future campaign.
uid - ID!
The unique ID for a `CategoryInterface` object.
updated_at - String
The timestamp indicating when the category was updated. (Deprecated: The field should not be used on the storefront.)
url_key - String
The URL key assigned to the category.
url_path - String
The URL path assigned to the category.
url_suffix - String
The part of the category URL that is appended after the url key

Possible Types

CategoryInterface Types
CategoryTree

Example

{
  "automatic_sorting": "abc123",
  "available_sort_by": ["xyz789"],
  "breadcrumbs": [Breadcrumb],
  "canonical_url": "xyz789",
  "children_count": "xyz789",
  "cms_block": CmsBlock,
  "created_at": "xyz789",
  "custom_layout_update_file": "abc123",
  "default_sort_by": "abc123",
  "description": "xyz789",
  "display_mode": "xyz789",
  "filter_price_range": 987.65,
  "id": 123,
  "image": "abc123",
  "include_in_menu": 123,
  "is_anchor": 987,
  "landing_page": 987,
  "level": 987,
  "meta_description": "abc123",
  "meta_keywords": "abc123",
  "meta_title": "xyz789",
  "name": "xyz789",
  "path": "abc123",
  "path_in_store": "abc123",
  "position": 987,
  "product_count": 123,
  "products": CategoryProducts,
  "staged": false,
  "uid": "4",
  "updated_at": "xyz789",
  "url_key": "xyz789",
  "url_path": "abc123",
  "url_suffix": "xyz789"
}

CategoryProducts

Contains details about the products assigned to a category.

Fields

Field Name
Description
items - [ProductInterface]
An array of products that are assigned to the category.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int
The number of products in the category that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.

Example

{
  "items": [ProductInterface],
  "page_info": SearchResultPageInfo,
  "total_count": 123
}

CategoryResult

Contains a collection of CategoryTree objects and pagination information.

Fields

Field Name
Description
items - [CategoryTree]
A list of categories that match the filter criteria.
page_info - SearchResultPageInfo
An object that includes the `page_info` and `currentPage` values specified in the query.
total_count - Int
The total number of categories that match the criteria.

Example

{
  "items": [CategoryTree],
  "page_info": SearchResultPageInfo,
  "total_count": 987
}

CategoryTree

Contains the hierarchy of categories.

Fields

Field Name
Description
automatic_sorting - String
available_sort_by - [String]
breadcrumbs - [Breadcrumb]
An array of breadcrumb items.
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Categories' is enabled.
children - [CategoryTree]
A tree of child categories.
children_count - String
cms_block - CmsBlock
Contains a category CMS block.
created_at - String
The timestamp indicating when the category was created. (Deprecated: The field should not be used on the storefront.)
custom_layout_update_file - String
default_sort_by - String
The attribute to use for sorting.
description - String
An optional description of the category.
display_mode - String
filter_price_range - Float
id - Int
An ID that uniquely identifies the category. (Deprecated: Use `uid` instead.)
image - String
include_in_menu - Int
is_anchor - Int
landing_page - Int
level - Int
The depth of the category within the tree.
meta_description - String
meta_keywords - String
meta_title - String
name - String
The display name of the category.
path - String
The full category path.
path_in_store - String
The category path within the store.
position - Int
The position of the category relative to other categories at the same level in tree.
product_count - Int
The number of products in the category that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.
products - CategoryProducts
The list of products assigned to the category.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
staged - Boolean!
Indicates whether the category is staged for a future campaign.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
uid - ID!
The unique ID for a `CategoryInterface` object.
updated_at - String
The timestamp indicating when the category was updated. (Deprecated: The field should not be used on the storefront.)
url_key - String
The URL key assigned to the category.
url_path - String
The URL path assigned to the category.
url_suffix - String
The part of the category URL that is appended after the url key

Example

{
  "automatic_sorting": "xyz789",
  "available_sort_by": ["abc123"],
  "breadcrumbs": [Breadcrumb],
  "canonical_url": "abc123",
  "children": [CategoryTree],
  "children_count": "abc123",
  "cms_block": CmsBlock,
  "created_at": "abc123",
  "custom_layout_update_file": "xyz789",
  "default_sort_by": "xyz789",
  "description": "xyz789",
  "display_mode": "abc123",
  "filter_price_range": 123.45,
  "id": 987,
  "image": "xyz789",
  "include_in_menu": 123,
  "is_anchor": 987,
  "landing_page": 123,
  "level": 987,
  "meta_description": "abc123",
  "meta_keywords": "abc123",
  "meta_title": "abc123",
  "name": "xyz789",
  "path": "abc123",
  "path_in_store": "abc123",
  "position": 987,
  "product_count": 987,
  "products": CategoryProducts,
  "redirect_code": 987,
  "relative_url": "xyz789",
  "staged": false,
  "type": "CMS_PAGE",
  "uid": "4",
  "updated_at": "xyz789",
  "url_key": "xyz789",
  "url_path": "xyz789",
  "url_suffix": "xyz789"
}

CheckoutAgreement

Defines details about an individual checkout agreement.

Fields

Field Name
Description
agreement_id - Int!
The ID for a checkout agreement.
checkbox_text - String!
The checkbox text for the checkout agreement.
content - String!
Required. The text of the agreement.
content_height - String
The height of the text box where the Terms and Conditions statement appears during checkout.
is_html - Boolean!
Indicates whether the `content` text is in HTML format.
mode - CheckoutAgreementMode!
Indicates whether agreements are accepted automatically or manually.
name - String!
The name given to the condition.

Example

{
  "agreement_id": 123,
  "checkbox_text": "xyz789",
  "content": "xyz789",
  "content_height": "abc123",
  "is_html": false,
  "mode": "AUTO",
  "name": "xyz789"
}

CheckoutAgreementMode

Indicates how agreements are accepted.

Values

Enum Value
Description
AUTO
Conditions are automatically accepted upon checkout.
MANUAL
Shoppers must manually accept the conditions to place an order.

Example

""AUTO""

CheckoutUserInputError

An error encountered while adding an item to the cart.

Fields

Field Name
Description
code - CheckoutUserInputErrorCodes!
An error code that is specific to Checkout.
message - String!
A localized error message.
path - [String]!
The path to the input field that caused an error. See the GraphQL specification about path errors for details: http://spec.graphql.org/draft/#sec-Errors

Example

{
  "code": "REORDER_NOT_AVAILABLE",
  "message": "xyz789",
  "path": ["abc123"]
}

CheckoutUserInputErrorCodes

Values

Enum Value
Description
REORDER_NOT_AVAILABLE
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED

Example

""REORDER_NOT_AVAILABLE""

ClearCartError

Contains details about errors encountered when a customer clear cart.

Fields

Field Name
Description
message - String!
A localized error message
type - ClearCartErrorType!
A cart-specific error type.

Example

{"message": "abc123", "type": "NOT_FOUND"}

ClearCartErrorType

Values

Enum Value
Description
NOT_FOUND
UNAUTHORISED
INACTIVE
UNDEFINED

Example

""NOT_FOUND""

ClearCartInput

Assigns a specific cart_id to the empty cart.

Input Fields

Input Field
Description
uid - ID!
The unique ID of a `Cart` object.

Example

{"uid": "4"}

ClearCartOutput

Output of the request to clear the customer cart.

Fields

Field Name
Description
cart - Cart
The cart after clear cart items.
errors - [ClearCartError]
An array of errors encountered while clearing the cart item

Example

{
  "cart": Cart,
  "errors": [ClearCartError]
}

ClearCustomerCartOutput

Output of the request to clear the customer cart.

Fields

Field Name
Description
cart - Cart
The cart after clearing items.
status - Boolean!
Indicates whether cart was cleared.

Example

{"cart": Cart, "status": false}

CloseNegotiableQuoteError

Types

Example

NegotiableQuoteInvalidStateError

CloseNegotiableQuoteOperationFailure

Contains details about a failed close operation on a negotiable quote.

Fields

Field Name
Description
errors - [CloseNegotiableQuoteError]!
An array of errors encountered while attempting close the negotiable quote.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "errors": [NegotiableQuoteInvalidStateError],
  "quote_uid": 4
}

CloseNegotiableQuoteOperationResult

Types

Example

NegotiableQuoteUidOperationSuccess

CloseNegotiableQuotesInput

Defines the negotiable quotes to mark as closed.

Input Fields

Input Field
Description
quote_uids - [ID]!
A list of unique IDs from `NegotiableQuote` objects.

Example

{"quote_uids": [4]}

CloseNegotiableQuotesOutput

Contains the closed negotiable quotes and other negotiable quotes the company user can view.

Fields

Field Name
Description
closed_quotes - [NegotiableQuote]
An array containing the negotiable quotes that were just closed. (Deprecated: Use `operation_results` instead.)
negotiable_quotes - NegotiableQuotesOutput
A list of negotiable quotes that can be viewed by the logged-in customer
operation_results - [CloseNegotiableQuoteOperationResult]!
An array of closed negotiable quote UIDs and details about any errors.
result_status - BatchMutationStatus!
The status of the request to close one or more negotiable quotes.

Example

{
  "closed_quotes": [NegotiableQuote],
  "negotiable_quotes": NegotiableQuotesOutput,
  "operation_results": [
    NegotiableQuoteUidOperationSuccess
  ],
  "result_status": "SUCCESS"
}

CmsBlock

Contains details about a specific CMS block.

Fields

Field Name
Description
content - String
The content of the CMS block in raw HTML.
identifier - String
The CMS block identifier.
title - String
The title assigned to the CMS block.

Example

{
  "content": "abc123",
  "identifier": "abc123",
  "title": "abc123"
}

CmsBlocks

Contains an array CMS block items.

Fields

Field Name
Description
items - [CmsBlock]
An array of CMS blocks.

Example

{"items": [CmsBlock]}

CmsPage

Contains details about a CMS page.

Fields

Field Name
Description
content - String
The content of the CMS page in raw HTML.
content_heading - String
The heading that displays at the top of the CMS page.
identifier - String
The ID of a CMS page.
meta_description - String
A brief description of the page for search results listings.
meta_keywords - String
A brief description of the page for search results listings.
meta_title - String
A page title that is indexed by search engines and appears in search results listings.
page_layout - String
The design layout of the page, indicating the number of columns and navigation features used on the page.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
title - String
The name that appears in the breadcrumb trail navigation and in the browser title bar and tab.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
url_key - String
The URL key of the CMS page, which is often based on the `content_heading`.

Example

{
  "content": "xyz789",
  "content_heading": "xyz789",
  "identifier": "abc123",
  "meta_description": "abc123",
  "meta_keywords": "abc123",
  "meta_title": "xyz789",
  "page_layout": "xyz789",
  "redirect_code": 987,
  "relative_url": "abc123",
  "title": "abc123",
  "type": "CMS_PAGE",
  "url_key": "xyz789"
}

ColorSwatchData

Fields

Field Name
Description
value - String
The value can be represented as color (HEX code), image link, or text.

Example

{"value": "xyz789"}

CompaniesSortFieldEnum

The fields available for sorting the customer companies.

Values

Enum Value
Description
NAME
The name of the company.

Example

""NAME""

CompaniesSortInput

Specifies which field to sort on, and whether to return the results in ascending or descending order.

Input Fields

Input Field
Description
field - CompaniesSortFieldEnum!
The field for sorting the results.
order - SortEnum!
Indicates whether to return results in ascending or descending order.

Example

{"field": "NAME", "order": "ASC"}

Company

Contains the output schema for a company.

Fields

Field Name
Description
acl_resources - [CompanyAclResource]
The list of all resources defined within the company.
company_admin - Customer
An object containing information about the company administrator.
credit - CompanyCredit!
Company credit balances and limits.
credit_history - CompanyCreditHistory!
Details about the history of company credit operations.
email - String
The email address of the company contact.
id - ID!
The unique ID of a `Company` object.
legal_address - CompanyLegalAddress
The address where the company is registered to conduct business.
legal_name - String
The full legal name of the company.
name - String
The name of the company.
payment_methods - [String]
The list of payment methods available to a company.
reseller_id - String
The resale number that is assigned to the company for tax reporting purposes.
role - CompanyRole
A company role filtered by the unique ID of a `CompanyRole` object.
roles - CompanyRoles!
An object that contains a list of company roles.
sales_representative - CompanySalesRepresentative
An object containing information about the company sales representative.
structure - CompanyStructure
The company structure of teams and customers in depth-first order.
team - CompanyTeam
The company team data filtered by the unique ID for a `CompanyTeam` object.
user - Customer
A company user filtered by the unique ID of a `Customer` object.
users - CompanyUsers
An object that contains a list of company users based on activity status.
vat_tax_id - String
The value-added tax number that is assigned to the company by some jurisdictions for tax reporting purposes.

Example

{
  "acl_resources": [CompanyAclResource],
  "company_admin": Customer,
  "credit": CompanyCredit,
  "credit_history": CompanyCreditHistory,
  "email": "xyz789",
  "id": "4",
  "legal_address": CompanyLegalAddress,
  "legal_name": "xyz789",
  "name": "abc123",
  "payment_methods": ["xyz789"],
  "reseller_id": "abc123",
  "role": CompanyRole,
  "roles": CompanyRoles,
  "sales_representative": CompanySalesRepresentative,
  "structure": CompanyStructure,
  "team": CompanyTeam,
  "user": Customer,
  "users": CompanyUsers,
  "vat_tax_id": "xyz789"
}

CompanyAclResource

Contains details about the access control list settings of a resource.

Fields

Field Name
Description
children - [CompanyAclResource]
An array of sub-resources.
id - ID!
The unique ID for a `CompanyAclResource` object.
sort_order - Int
The sort order of an ACL resource.
text - String
The label assigned to the ACL resource.

Example

{
  "children": [CompanyAclResource],
  "id": 4,
  "sort_order": 123,
  "text": "abc123"
}

CompanyAdminInput

Defines the input schema for creating a company administrator.

Input Fields

Input Field
Description
custom_attributes - [AttributeValueInput]
The company administrator's custom attributes.
email - String!
The email address of the company administrator.
firstname - String!
The company administrator's first name.
gender - Int
The company administrator's gender (Male - 1, Female - 2, Not Specified - 3).
job_title - String
The job title of the company administrator.
lastname - String!
The company administrator's last name.
telephone - String
The phone number of the company administrator.

Example

{
  "custom_attributes": [AttributeValueInput],
  "email": "abc123",
  "firstname": "xyz789",
  "gender": 987,
  "job_title": "abc123",
  "lastname": "xyz789",
  "telephone": "xyz789"
}

CompanyBasicInfo

The minimal required information to identify and display the company.

Fields

Field Name
Description
id - ID!
The unique ID of a `Company` object.
legal_name - String
The full legal name of the company.
name - String
The name of the company.
status - CompanyStatusEnum
The current status of the company.

Example

{
  "id": 4,
  "legal_name": "xyz789",
  "name": "abc123",
  "status": "PENDING"
}

CompanyCreateInput

Defines the input schema for creating a new company.

Input Fields

Input Field
Description
company_admin - CompanyAdminInput!
Defines the company administrator.
company_email - String!
The email address of the company contact.
company_name - String!
The name of the company to create.
legal_address - CompanyLegalAddressCreateInput!
Defines legal address data of the company.
legal_name - String
The full legal name of the company.
reseller_id - String
The resale number that is assigned to the company for tax reporting purposes.
vat_tax_id - String
The value-added tax number that is assigned to the company by some jurisdictions for tax reporting purposes.

Example

{
  "company_admin": CompanyAdminInput,
  "company_email": "abc123",
  "company_name": "xyz789",
  "legal_address": CompanyLegalAddressCreateInput,
  "legal_name": "xyz789",
  "reseller_id": "abc123",
  "vat_tax_id": "abc123"
}

CompanyCredit

Contains company credit balances and limits.

Fields

Field Name
Description
available_credit - Money!
The sum of the credit limit and the outstanding balance. If the company has exceeded the credit limit, the amount is as a negative value.
credit_limit - Money!
The amount of credit extended to the company.
outstanding_balance - Money!
The amount reimbursed, less the total due from all orders placed using the Payment on Account payment method. The amount can be a positive or negative value.

Example

{
  "available_credit": Money,
  "credit_limit": Money,
  "outstanding_balance": Money
}

CompanyCreditHistory

Contains details about prior company credit operations.

Fields

Field Name
Description
items - [CompanyCreditOperation]!
An array of company credit operations.
page_info - SearchResultPageInfo!
Metadata for pagination rendering.
total_count - Int
The number of the company credit operations matching the specified filter.

Example

{
  "items": [CompanyCreditOperation],
  "page_info": SearchResultPageInfo,
  "total_count": 987
}

CompanyCreditHistoryFilterInput

Defines a filter for narrowing the results of a credit history search.

Input Fields

Input Field
Description
custom_reference_number - String
The purchase order number associated with the company credit operation.
operation_type - CompanyCreditOperationType
The type of the company credit operation.
updated_by - String
The name of the person submitting the company credit operation.

Example

{
  "custom_reference_number": "xyz789",
  "operation_type": "ALLOCATION",
  "updated_by": "xyz789"
}

CompanyCreditOperation

Contains details about a single company credit operation.

Fields

Field Name
Description
amount - Money
The amount of the company credit operation.
balance - CompanyCredit!
The credit balance as a result of the operation.
custom_reference_number - String
The purchase order number associated with the company credit operation.
date - String!
The date the operation occurred.
type - CompanyCreditOperationType!
The type of the company credit operation.
updated_by - CompanyCreditOperationUser!
The company user that submitted the company credit operation.

Example

{
  "amount": Money,
  "balance": CompanyCredit,
  "custom_reference_number": "xyz789",
  "date": "xyz789",
  "type": "ALLOCATION",
  "updated_by": CompanyCreditOperationUser
}

CompanyCreditOperationType

Values

Enum Value
Description
ALLOCATION
UPDATE
PURCHASE
REIMBURSEMENT
REFUND
REVERT

Example

""ALLOCATION""

CompanyCreditOperationUser

Defines the administrator or company user that submitted a company credit operation.

Fields

Field Name
Description
name - String!
The name of the company user submitting the company credit operation.
type - CompanyCreditOperationUserType!
The type of the company user submitting the company credit operation.

Example

{"name": "abc123", "type": "CUSTOMER"}

CompanyCreditOperationUserType

Values

Enum Value
Description
CUSTOMER
ADMIN

Example

""CUSTOMER""

CompanyInvitationInput

Defines the input schema for accepting the company invitation.

Input Fields

Input Field
Description
code - String!
The invitation code.
role_id - ID
The company role id.
user - CompanyInvitationUserInput!
Company user attributes in the invitation.

Example

{
  "code": "xyz789",
  "role_id": 4,
  "user": CompanyInvitationUserInput
}

CompanyInvitationOutput

The result of accepting the company invitation.

Fields

Field Name
Description
success - Boolean
Indicates whether the customer was added to the company successfully.

Example

{"success": false}

CompanyInvitationUserInput

Company user attributes in the invitation.

Input Fields

Input Field
Description
company_id - ID!
The company unique identifier.
customer_id - ID!
The customer unique identifier.
job_title - String
The job title of a company user.
status - CompanyUserStatusEnum
Indicates whether the company user is ACTIVE or INACTIVE.
telephone - String
The phone number of the company user.

Example

{
  "company_id": "4",
  "customer_id": 4,
  "job_title": "xyz789",
  "status": "ACTIVE",
  "telephone": "xyz789"
}

CompanyLegalAddress

Contains details about the address where the company is registered to conduct business.

Fields

Field Name
Description
city - String
The city where the company is registered to conduct business.
country_code - CountryCodeEnum
The country code of the company's legal address.
postcode - String
The company's postal code.
region - CustomerAddressRegion
An object containing region data for the company.
street - [String]
An array of strings that define the company's street address.
telephone - String
The company's phone number.

Example

{
  "city": "abc123",
  "country_code": "AF",
  "postcode": "abc123",
  "region": CustomerAddressRegion,
  "street": ["abc123"],
  "telephone": "abc123"
}

CompanyLegalAddressCreateInput

Defines the input schema for defining a company's legal address.

Input Fields

Input Field
Description
city - String!
The city where the company is registered to conduct business.
country_id - CountryCodeEnum!
The company's country ID. Use the `countries` query to get this value.
postcode - String!
The postal code of the company.
region - CustomerAddressRegionInput!
An object containing the region name and/or region ID where the company is registered to conduct business.
street - [String]!
An array of strings that define the street address where the company is registered to conduct business.
telephone - String!
The primary phone number of the company.

Example

{
  "city": "abc123",
  "country_id": "AF",
  "postcode": "abc123",
  "region": CustomerAddressRegionInput,
  "street": ["xyz789"],
  "telephone": "abc123"
}

CompanyLegalAddressUpdateInput

Defines the input schema for updating a company's legal address.

Input Fields

Input Field
Description
city - String
The city where the company is registered to conduct business.
country_id - CountryCodeEnum
The unique ID for a `Country` object.
postcode - String
The postal code of the company.
region - CustomerAddressRegionInput
An object containing the region name and/or region ID where the company is registered to conduct business.
street - [String]
An array of strings that define the street address where the company is registered to conduct business.
telephone - String
The primary phone number of the company.

Example

{
  "city": "xyz789",
  "country_id": "AF",
  "postcode": "abc123",
  "region": CustomerAddressRegionInput,
  "street": ["xyz789"],
  "telephone": "abc123"
}

CompanyRole

Contails details about a single role.

Fields

Field Name
Description
id - ID!
The unique ID for a `CompanyRole` object.
name - String
The name assigned to the role.
permissions - [CompanyAclResource]
A list of permission resources defined for a role.
users_count - Int
The total number of users assigned the specified role.

Example

{
  "id": "4",
  "name": "abc123",
  "permissions": [CompanyAclResource],
  "users_count": 123
}

CompanyRoleCreateInput

Defines the input schema for creating a company role.

Input Fields

Input Field
Description
name - String!
The name of the role to create.
permissions - [String]!
A list of resources the role can access.

Example

{
  "name": "xyz789",
  "permissions": ["abc123"]
}

CompanyRoleUpdateInput

Defines the input schema for updating a company role.

Input Fields

Input Field
Description
id - ID!
The unique ID for a `CompanyRole` object.
name - String
The name of the role to update.
permissions - [String]
A list of resources the role can access.

Example

{
  "id": 4,
  "name": "xyz789",
  "permissions": ["abc123"]
}

CompanyRoles

Contains an array of roles.

Fields

Field Name
Description
items - [CompanyRole]!
A list of company roles that match the specified filter criteria.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int!
The total number of objects matching the specified filter.

Example

{
  "items": [CompanyRole],
  "page_info": SearchResultPageInfo,
  "total_count": 987
}

CompanySalesRepresentative

Contains details about a company sales representative.

Fields

Field Name
Description
email - String
The email address of the company sales representative.
firstname - String
The company sales representative's first name.
lastname - String
The company sales representative's last name.

Example

{
  "email": "abc123",
  "firstname": "xyz789",
  "lastname": "abc123"
}

CompanyStatusEnum

Defines the list of company status values.

Values

Enum Value
Description
PENDING
Company is pending approval.
APPROVED
Company is approved.
REJECTED
Company is rejected.
BLOCKED
Company is blocked.

Example

""PENDING""

CompanyStructure

Contains an array of the individual nodes that comprise the company structure.

Fields

Field Name
Description
items - [CompanyStructureItem]
An array of elements in a company structure.

Example

{"items": [CompanyStructureItem]}

CompanyStructureEntity

Types

Union Types
CompanyTeam
Customer

Example

CompanyTeam

CompanyStructureItem

Defines an individual node in the company structure.

Fields

Field Name
Description
entity - CompanyStructureEntity
A union of `CompanyTeam` and `Customer` objects.
id - ID!
The unique ID for a `CompanyStructureItem` object.
parent_id - ID
The ID of the parent item in the company hierarchy.

Example

{
  "entity": CompanyTeam,
  "id": "4",
  "parent_id": "4"
}

CompanyStructureUpdateInput

Defines the input schema for updating the company structure.

Input Fields

Input Field
Description
parent_tree_id - ID!
The ID of a company that will be the new parent.
tree_id - ID!
The ID of the company team that is being moved to another parent.

Example

{
  "parent_tree_id": "4",
  "tree_id": "4"
}

CompanyTeam

Describes a company team.

Fields

Field Name
Description
description - String
An optional description of the team.
id - ID
The unique ID for a `CompanyTeam` object.
name - String
The display name of the team.
structure_id - ID!
ID of the company structure

Example

{
  "description": "abc123",
  "id": "4",
  "name": "xyz789",
  "structure_id": "4"
}

CompanyTeamCreateInput

Defines the input schema for creating a company team.

Input Fields

Input Field
Description
description - String
An optional description of the team.
name - String!
The display name of the team.
target_id - ID
The ID of a node within a company's structure. This ID will be the parent of the created team.

Example

{
  "description": "abc123",
  "name": "xyz789",
  "target_id": "4"
}

CompanyTeamUpdateInput

Defines the input schema for updating a company team.

Input Fields

Input Field
Description
description - String
An optional description of the team.
id - ID!
The unique ID of the `CompanyTeam` object to update.
name - String
The display name of the team.

Example

{
  "description": "abc123",
  "id": "4",
  "name": "abc123"
}

CompanyUpdateInput

Defines the input schema for updating a company.

Input Fields

Input Field
Description
company_email - String
The email address of the company contact.
company_name - String
The name of the company to update.
legal_address - CompanyLegalAddressUpdateInput
The legal address data of the company.
legal_name - String
The full legal name of the company.
reseller_id - String
The resale number that is assigned to the company for tax reporting purposes.
vat_tax_id - String
The value-added tax number that is assigned to the company by some jurisdictions for tax reporting purposes.

Example

{
  "company_email": "xyz789",
  "company_name": "abc123",
  "legal_address": CompanyLegalAddressUpdateInput,
  "legal_name": "xyz789",
  "reseller_id": "xyz789",
  "vat_tax_id": "abc123"
}

CompanyUserCreateInput

Defines the input schema for creating a company user.

Input Fields

Input Field
Description
email - String!
The company user's email address
firstname - String!
The company user's first name.
job_title - String!
The company user's job title or function.
lastname - String!
The company user's last name.
role_id - ID!
The unique ID for a `CompanyRole` object.
status - CompanyUserStatusEnum!
Indicates whether the company user is ACTIVE or INACTIVE.
target_id - ID
The ID of a node within a company's structure. This ID will be the parent of the created company user.
telephone - String!
The company user's phone number.

Example

{
  "email": "xyz789",
  "firstname": "xyz789",
  "job_title": "abc123",
  "lastname": "abc123",
  "role_id": "4",
  "status": "ACTIVE",
  "target_id": 4,
  "telephone": "xyz789"
}

CompanyUserStatusEnum

Defines the list of company user status values.

Values

Enum Value
Description
ACTIVE
Only active users.
INACTIVE
Only inactive users.

Example

""ACTIVE""

CompanyUserUpdateInput

Defines the input schema for updating a company user.

Input Fields

Input Field
Description
email - String
The company user's email address.
firstname - String
The company user's first name.
id - ID!
The unique ID of a `Customer` object.
job_title - String
The company user's job title or function.
lastname - String
The company user's last name.
role_id - ID
The unique ID for a `CompanyRole` object.
status - CompanyUserStatusEnum
Indicates whether the company user is ACTIVE or INACTIVE.
telephone - String
The company user's phone number.

Example

{
  "email": "abc123",
  "firstname": "abc123",
  "id": 4,
  "job_title": "abc123",
  "lastname": "abc123",
  "role_id": "4",
  "status": "ACTIVE",
  "telephone": "xyz789"
}

CompanyUsers

Contains details about company users.

Fields

Field Name
Description
items - [Customer]!
An array of `CompanyUser` objects that match the specified filter criteria.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int!
The number of objects returned.

Example

{
  "items": [Customer],
  "page_info": SearchResultPageInfo,
  "total_count": 123
}

CompanyUsersFilterInput

Defines the filter for returning a list of company users.

Input Fields

Input Field
Description
status - CompanyUserStatusEnum
The activity status to filter on.

Example

{"status": "ACTIVE"}

ComparableAttribute

Contains an attribute code that is used for product comparisons.

Fields

Field Name
Description
code - String!
An attribute code that is enabled for product comparisons.
label - String!
The label of the attribute code.

Example

{
  "code": "xyz789",
  "label": "abc123"
}

ComparableItem

Defines an object used to iterate through items for product comparisons.

Fields

Field Name
Description
attributes - [ProductAttribute]!
An array of product attributes that can be used to compare products.
product - ProductInterface!
Details about a product in a compare list.
uid - ID!
The unique ID of an item in a compare list.

Example

{
  "attributes": [ProductAttribute],
  "product": ProductInterface,
  "uid": 4
}

CompareList

Contains iterable information such as the array of items, the count, and attributes that represent the compare list.

Fields

Field Name
Description
attributes - [ComparableAttribute]
An array of attributes that can be used for comparing products.
item_count - Int!
The number of items in the compare list.
items - [ComparableItem]
An array of products to compare.
uid - ID!
The unique ID assigned to the compare list.

Example

{
  "attributes": [ComparableAttribute],
  "item_count": 987,
  "items": [ComparableItem],
  "uid": 4
}

CompleteOrderInput

Update the quote and complete the order

Input Fields

Input Field
Description
cartId - String!
The customer cart ID
id - String!
PayPal order ID

Example

{
  "cartId": "abc123",
  "id": "xyz789"
}

ComplexTextValue

Fields

Field Name
Description
html - String!
Text that can contain HTML tags.

Example

{"html": "xyz789"}

ConfigurableAttributeOption

Contains details about a configurable product attribute option.

Fields

Field Name
Description
code - String
The ID assigned to the attribute.
label - String
A string that describes the configurable attribute option.
uid - ID!
The unique ID for a `ConfigurableAttributeOption` object.
value_index - Int
A unique index number assigned to the configurable product option.

Example

{
  "code": "xyz789",
  "label": "abc123",
  "uid": "4",
  "value_index": 123
}

ConfigurableCartItem

An implementation for configurable product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
configurable_options - [SelectedConfigurableOption]!
An array containing the configuranle options the shopper selected.
configured_variant - ProductInterface!
Product details of the cart item.
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
gift_message - GiftMessage
The entered gift message for the cart item
gift_wrapping - GiftWrapping
The selected gift wrapping for the cart item.
id - String!
(Deprecated: Use `uid` instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
not_available_message - String
Message to display when the product is not available with this selected option.
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "available_gift_wrapping": [GiftWrapping],
  "configurable_options": [SelectedConfigurableOption],
  "configured_variant": ProductInterface,
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "xyz789",
  "is_available": true,
  "max_qty": 123.45,
  "min_qty": 123.45,
  "not_available_message": "abc123",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "uid": "4"
}

ConfigurableOptionAvailableForSelection

Describes configurable options that have been selected and can be selected as a result of the previous selections.

Fields

Field Name
Description
attribute_code - String!
An attribute code that uniquely identifies a configurable option.
option_value_uids - [ID]!
An array of selectable option value IDs.

Example

{
  "attribute_code": "xyz789",
  "option_value_uids": ["4"]
}

ConfigurableOrderItem

Fields

Field Name
Description
discounts - [Discount]
The final discount information for the product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an `OrderItemInterface` object.
parent_sku - String
The SKU of parent product.
prices - OrderItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface
The ProductInterface object, which contains details about the base product
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_return_requested - Float
The requested return quantity of the item.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

{
  "discounts": [Discount],
  "eligible_for_return": true,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "4",
  "parent_sku": "abc123",
  "prices": OrderItemPrices,
  "product": ProductInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "product_type": "xyz789",
  "product_url_key": "abc123",
  "quantity_canceled": 987.65,
  "quantity_invoiced": 123.45,
  "quantity_ordered": 123.45,
  "quantity_refunded": 987.65,
  "quantity_return_requested": 987.65,
  "quantity_returned": 123.45,
  "quantity_shipped": 123.45,
  "selected_options": [OrderItemOption],
  "status": "abc123"
}

ConfigurableProduct

Defines basic features of a configurable product and its simple product variants.

Fields

Field Name
Description
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
configurable_options - [ConfigurableProductOptions]
An array of options for the configurable product.
configurable_product_options_selection - ConfigurableProductOptionsSelection
An array of media gallery items and other details about selected configurable product options as well as details about remaining selectable options.
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
quantity - Float
Amount of available stock
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
variants - [ConfigurableVariant]
An array of simple product variants.
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "color": 987,
  "configurable_options": [ConfigurableProductOptions],
  "configurable_product_options_selection": ConfigurableProductOptionsSelection,
  "country_of_manufacture": "xyz789",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": true,
  "gift_wrapping_available": true,
  "gift_wrapping_price": Money,
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 123,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "min_sale_qty": 987.65,
  "name": "abc123",
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "quantity": 987.65,
  "rating_summary": 987.65,
  "redirect_code": 123,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 987,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 123.45,
  "special_to_date": "xyz789",
  "staged": true,
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 987.65,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "xyz789",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "variants": [ConfigurableVariant],
  "websites": [Website],
  "weight": 987.65
}

ConfigurableProductCartItemInput

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
The ID and value of the option.
data - CartItemInput!
The quantity and SKU of the configurable product.
parent_sku - String
The SKU of the parent configurable product.
variant_sku - String

Example

{
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput,
  "parent_sku": "xyz789",
  "variant_sku": "xyz789"
}

ConfigurableProductOption

Contains details about configurable product options.

Fields

Field Name
Description
attribute_code - String!
An attribute code that uniquely identifies a configurable option.
label - String!
The display name of the option.
uid - ID!
The unique ID of the configurable option.
values - [ConfigurableProductOptionValue]
An array of values that are applicable for this option.

Example

{
  "attribute_code": "xyz789",
  "label": "xyz789",
  "uid": "4",
  "values": [ConfigurableProductOptionValue]
}

ConfigurableProductOptionValue

Defines a value for a configurable product option.

Fields

Field Name
Description
is_available - Boolean!
Indicates whether the product is available with this selected option.
is_use_default - Boolean!
Indicates whether the value is the default.
label - String!
The display name of the value.
swatch - SwatchDataInterface
The URL assigned to the thumbnail of the swatch image.
uid - ID!
The unique ID of the value.

Example

{
  "is_available": false,
  "is_use_default": true,
  "label": "xyz789",
  "swatch": SwatchDataInterface,
  "uid": "4"
}

ConfigurableProductOptions

Defines configurable attributes for the specified product.

Fields

Field Name
Description
attribute_code - String
A string that identifies the attribute.
attribute_id - String
The ID assigned to the attribute. (Deprecated: Use `attribute_uid` instead.)
attribute_id_v2 - Int
The ID assigned to the attribute. (Deprecated: Use `attribute_uid` instead.)
attribute_uid - ID!
The unique ID for an `Attribute` object.
id - Int
The configurable option ID number assigned by the system. (Deprecated: Use `uid` instead.)
label - String
A displayed string that describes the configurable product option.
position - Int
A number that indicates the order in which the attribute is displayed.
product_id - Int
This is the same as a product's `id` field. (Deprecated: `product_id` is not needed and can be obtained from its parent.)
uid - ID!
The unique ID for a `ConfigurableProductOptions` object.
use_default - Boolean
Indicates whether the option is the default.
values - [ConfigurableProductOptionsValues]
An array that defines the `value_index` codes assigned to the configurable product.

Example

{
  "attribute_code": "xyz789",
  "attribute_id": "abc123",
  "attribute_id_v2": 123,
  "attribute_uid": 4,
  "id": 123,
  "label": "abc123",
  "position": 987,
  "product_id": 123,
  "uid": 4,
  "use_default": true,
  "values": [ConfigurableProductOptionsValues]
}

ConfigurableProductOptionsSelection

Contains metadata corresponding to the selected configurable options.

Fields

Field Name
Description
configurable_options - [ConfigurableProductOption]
An array of all possible configurable options.
media_gallery - [MediaGalleryInterface]
Product images and videos corresponding to the specified configurable options selection.
options_available_for_selection - [ConfigurableOptionAvailableForSelection]
The configurable options available for further selection based on the current selection.
variant - SimpleProduct
A variant represented by the specified configurable options selection. The value is expected to be null until selections are made for each configurable option.

Example

{
  "configurable_options": [ConfigurableProductOption],
  "media_gallery": [MediaGalleryInterface],
  "options_available_for_selection": [
    ConfigurableOptionAvailableForSelection
  ],
  "variant": SimpleProduct
}

ConfigurableProductOptionsValues

Contains the index number assigned to a configurable product option.

Fields

Field Name
Description
default_label - String
The label of the product on the default store.
label - String
The label of the product.
store_label - String
The label of the product on the current store.
swatch_data - SwatchDataInterface
Swatch data for a configurable product option.
uid - ID
The unique ID for a `ConfigurableProductOptionsValues` object.
use_default_value - Boolean
Indicates whether to use the default_label.
value_index - Int
A unique index number assigned to the configurable product option. (Deprecated: Use `uid` instead.)

Example

{
  "default_label": "abc123",
  "label": "xyz789",
  "store_label": "xyz789",
  "swatch_data": SwatchDataInterface,
  "uid": "4",
  "use_default_value": false,
  "value_index": 987
}

ConfigurableRequisitionListItem

Contains details about configurable products added to a requisition list.

Fields

Field Name
Description
configurable_options - [SelectedConfigurableOption]
Selected configurable options for an item in the requisition list.
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The quantity of the product added to the requisition list.
uid - ID!
The unique ID of an item in a requisition list.

Example

{
  "configurable_options": [SelectedConfigurableOption],
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": "4"
}

ConfigurableVariant

Contains all the simple product variants of a configurable product.

Fields

Field Name
Description
attributes - [ConfigurableAttributeOption]
An array of configurable attribute options.
product - SimpleProduct
An array of linked simple products.

Example

{
  "attributes": [ConfigurableAttributeOption],
  "product": SimpleProduct
}

ConfigurableWishlistItem

A configurable product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
child_sku - String!
The SKU of the simple product corresponding to a set of selected configurable options. (Deprecated: Use `ConfigurableWishlistItem.configured_variant.sku` instead.)
configurable_options - [SelectedConfigurableOption]
An array of selected configurable options.
configured_variant - ProductInterface
Product details of the selected variant. The value is null if some options are not configured.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface
Product details of the wish list item.
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "abc123",
  "child_sku": "xyz789",
  "configurable_options": [SelectedConfigurableOption],
  "configured_variant": ProductInterface,
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

ConfirmCancelOrderInput

Input Fields

Input Field
Description
confirmation_key - String!
Confirmation Key to cancel the order.
order_id - ID!
The unique ID of an `Order` type.

Example

{
  "confirmation_key": "abc123",
  "order_id": 4
}

ConfirmEmailInput

Contains details about a customer email address to confirm.

Input Fields

Input Field
Description
confirmation_key - String!
The key to confirm the email address.
email - String!
The email address to be confirmed.

Example

{
  "confirmation_key": "abc123",
  "email": "xyz789"
}

ConfirmReturnInput

Input Fields

Input Field
Description
confirmation_key - String!
Confirmation Key to return order.
order_id - ID!
The unique ID of an `Order` type.

Example

{
  "confirmation_key": "xyz789",
  "order_id": 4
}

ConfirmationStatusEnum

List of account confirmation statuses.

Values

Enum Value
Description
ACCOUNT_CONFIRMED
Account confirmed
ACCOUNT_CONFIRMATION_NOT_REQUIRED
Account confirmation not required

Example

""ACCOUNT_CONFIRMED""

ContactUsInput

Input Fields

Input Field
Description
comment - String!
The shopper's comment to the merchant.
email - String!
The email address of the shopper.
name - String!
The full name of the shopper.
telephone - String
The shopper's telephone number.

Example

{
  "comment": "xyz789",
  "email": "abc123",
  "name": "abc123",
  "telephone": "abc123"
}

ContactUsOutput

Contains the status of the request.

Fields

Field Name
Description
status - Boolean!
Indicates whether the request was successful.

Example

{"status": false}

CopyItemsBetweenRequisitionListsInput

An input object that defines the items in a requisition list to be copied.

Input Fields

Input Field
Description
requisitionListItemUids - [ID]!
An array of IDs representing products copied from one requisition list to another.

Example

{"requisitionListItemUids": [4]}

CopyItemsFromRequisitionListsOutput

Output of the request to copy items to the destination requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The destination requisition list after the items were copied.

Example

{"requisition_list": RequisitionList}

CopyProductsBetweenWishlistsOutput

Contains the source and target wish lists after copying products.

Fields

Field Name
Description
destination_wishlist - Wishlist!
The destination wish list containing the copied products.
source_wishlist - Wishlist!
The wish list that the products were copied from.
user_errors - [WishListUserInputError]!
An array of errors encountered while copying products in a wish list.

Example

{
  "destination_wishlist": Wishlist,
  "source_wishlist": Wishlist,
  "user_errors": [WishListUserInputError]
}

Country

Fields

Field Name
Description
available_regions - [Region]
An array of regions within a particular country.
full_name_english - String
The name of the country in English.
full_name_locale - String
The name of the country in the current locale.
id - String
The unique ID for a `Country` object.
three_letter_abbreviation - String
The three-letter abbreviation of the country, such as USA.
two_letter_abbreviation - String
The two-letter abbreviation of the country, such as US.

Example

{
  "available_regions": [Region],
  "full_name_english": "abc123",
  "full_name_locale": "xyz789",
  "id": "xyz789",
  "three_letter_abbreviation": "abc123",
  "two_letter_abbreviation": "xyz789"
}

CountryCodeEnum

The list of country codes.

Values

Enum Value
Description
AF
Afghanistan
AX
Åland Islands
AL
Albania
DZ
Algeria
AS
American Samoa
AD
Andorra
AO
Angola
AI
Anguilla
AQ
Antarctica
AG
Antigua & Barbuda
AR
Argentina
AM
Armenia
AW
Aruba
AU
Australia
AT
Austria
AZ
Azerbaijan
BS
Bahamas
BH
Bahrain
BD
Bangladesh
BB
Barbados
BY
Belarus
BE
Belgium
BZ
Belize
BJ
Benin
BM
Bermuda
BT
Bhutan
BO
Bolivia
BA
Bosnia & Herzegovina
BW
Botswana
BV
Bouvet Island
BR
Brazil
IO
British Indian Ocean Territory
VG
British Virgin Islands
BN
Brunei
BG
Bulgaria
BF
Burkina Faso
BI
Burundi
KH
Cambodia
CM
Cameroon
CA
Canada
CV
Cape Verde
KY
Cayman Islands
CF
Central African Republic
TD
Chad
CL
Chile
CN
China
CX
Christmas Island
CC
Cocos (Keeling) Islands
CO
Colombia
KM
Comoros
CG
Congo-Brazzaville
CD
Congo-Kinshasa
CK
Cook Islands
CR
Costa Rica
CI
Côte d’Ivoire
HR
Croatia
CU
Cuba
CY
Cyprus
CZ
Czech Republic
DK
Denmark
DJ
Djibouti
DM
Dominica
DO
Dominican Republic
EC
Ecuador
EG
Egypt
SV
El Salvador
GQ
Equatorial Guinea
ER
Eritrea
EE
Estonia
SZ
Eswatini
ET
Ethiopia
FK
Falkland Islands
FO
Faroe Islands
FJ
Fiji
FI
Finland
FR
France
GF
French Guiana
PF
French Polynesia
TF
French Southern Territories
GA
Gabon
GM
Gambia
GE
Georgia
DE
Germany
GH
Ghana
GI
Gibraltar
GR
Greece
GL
Greenland
GD
Grenada
GP
Guadeloupe
GU
Guam
GT
Guatemala
GG
Guernsey
GN
Guinea
GW
Guinea-Bissau
GY
Guyana
HT
Haiti
HM
Heard & McDonald Islands
HN
Honduras
HK
Hong Kong SAR China
HU
Hungary
IS
Iceland
IN
India
ID
Indonesia
IR
Iran
IQ
Iraq
IE
Ireland
IM
Isle of Man
IL
Israel
IT
Italy
JM
Jamaica
JP
Japan
JE
Jersey
JO
Jordan
KZ
Kazakhstan
KE
Kenya
KI
Kiribati
KW
Kuwait
KG
Kyrgyzstan
LA
Laos
LV
Latvia
LB
Lebanon
LS
Lesotho
LR
Liberia
LY
Libya
LI
Liechtenstein
LT
Lithuania
LU
Luxembourg
MO
Macau SAR China
MK
Macedonia
MG
Madagascar
MW
Malawi
MY
Malaysia
MV
Maldives
ML
Mali
MT
Malta
MH
Marshall Islands
MQ
Martinique
MR
Mauritania
MU
Mauritius
YT
Mayotte
MX
Mexico
FM
Micronesia
MD
Moldova
MC
Monaco
MN
Mongolia
ME
Montenegro
MS
Montserrat
MA
Morocco
MZ
Mozambique
MM
Myanmar (Burma)
NA
Namibia
NR
Nauru
NP
Nepal
NL
Netherlands
AN
Netherlands Antilles
NC
New Caledonia
NZ
New Zealand
NI
Nicaragua
NE
Niger
NG
Nigeria
NU
Niue
NF
Norfolk Island
MP
Northern Mariana Islands
KP
North Korea
NO
Norway
OM
Oman
PK
Pakistan
PW
Palau
PS
Palestinian Territories
PA
Panama
PG
Papua New Guinea
PY
Paraguay
PE
Peru
PH
Philippines
PN
Pitcairn Islands
PL
Poland
PT
Portugal
QA
Qatar
RE
Réunion
RO
Romania
RU
Russia
RW
Rwanda
WS
Samoa
SM
San Marino
ST
São Tomé & Príncipe
SA
Saudi Arabia
SN
Senegal
RS
Serbia
SC
Seychelles
SL
Sierra Leone
SG
Singapore
SK
Slovakia
SI
Slovenia
SB
Solomon Islands
SO
Somalia
ZA
South Africa
GS
South Georgia & South Sandwich Islands
KR
South Korea
ES
Spain
LK
Sri Lanka
BL
St. Barthélemy
SH
St. Helena
KN
St. Kitts & Nevis
LC
St. Lucia
MF
St. Martin
PM
St. Pierre & Miquelon
VC
St. Vincent & Grenadines
SD
Sudan
SR
Suriname
SJ
Svalbard & Jan Mayen
SE
Sweden
CH
Switzerland
SY
Syria
TW
Taiwan
TJ
Tajikistan
TZ
Tanzania
TH
Thailand
TL
Timor-Leste
TG
Togo
TK
Tokelau
TO
Tonga
TT
Trinidad & Tobago
TN
Tunisia
TR
Turkey
TM
Turkmenistan
TC
Turks & Caicos Islands
TV
Tuvalu
UG
Uganda
UA
Ukraine
AE
United Arab Emirates
GB
United Kingdom
US
United States
UY
Uruguay
UM
U.S. Outlying Islands
VI
U.S. Virgin Islands
UZ
Uzbekistan
VU
Vanuatu
VA
Vatican City
VE
Venezuela
VN
Vietnam
WF
Wallis & Futuna
EH
Western Sahara
YE
Yemen
ZM
Zambia
ZW
Zimbabwe

Example

""AF""

CreateCompanyOutput

Contains the response to the request to create a company.

Fields

Field Name
Description
company - Company!
The new company instance.

Example

{"company": Company}

CreateCompanyRoleOutput

Contains the response to the request to create a company role.

Fields

Field Name
Description
role - CompanyRole!
The new company role instance.

Example

{"role": CompanyRole}

CreateCompanyTeamOutput

Contains the response to the request to create a company team.

Fields

Field Name
Description
team - CompanyTeam!
The new company team instance.

Example

{"team": CompanyTeam}

CreateCompanyUserOutput

Contains the response to the request to create a company user.

Fields

Field Name
Description
user - Customer!
The new company user instance.

Example

{"user": Customer}

CreateCompareListInput

Contains an array of product IDs to use for creating a compare list.

Input Fields

Input Field
Description
products - [ID]
An array of product IDs to add to the compare list.

Example

{"products": ["4"]}

CreateGiftRegistryInput

Defines a new gift registry.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair.
event_name - String!
The name of the event.
gift_registry_type_uid - ID!
The ID of the selected event type.
message - String!
A message describing the event.
privacy_settings - GiftRegistryPrivacySettings!
Indicates whether the registry is PRIVATE or PUBLIC.
registrants - [AddGiftRegistryRegistrantInput]!
The list of people who receive notifications about the registry.
shipping_address - GiftRegistryShippingAddressInput
The shipping address for all gift registry items.
status - GiftRegistryStatus!
Indicates whether the registry is ACTIVE or INACTIVE.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "event_name": "abc123",
  "gift_registry_type_uid": "4",
  "message": "xyz789",
  "privacy_settings": "PRIVATE",
  "registrants": [AddGiftRegistryRegistrantInput],
  "shipping_address": GiftRegistryShippingAddressInput,
  "status": "ACTIVE"
}

CreateGiftRegistryOutput

Contains the results of a request to create a gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The newly-created gift registry.

Example

{"gift_registry": GiftRegistry}

CreateGuestCartInput

Input Fields

Input Field
Description
cart_uid - ID
Optional client-generated ID

Example

{"cart_uid": 4}

CreateGuestCartOutput

Fields

Field Name
Description
cart - Cart
The newly created cart.

Example

{"cart": Cart}

CreatePayflowProTokenOutput

Contains the secure information used to authorize transaction. Applies to Payflow Pro and Payments Pro payment methods.

Fields

Field Name
Description
response_message - String!
The RESPMSG returned by PayPal. If the `result` is `0`, then `response_message` is `Approved`.
result - Int!
A non-zero value if any errors occurred.
result_code - Int!
The RESULT returned by PayPal. A value of `0` indicates the transaction was approved.
secure_token - String!
A secure token generated by PayPal.
secure_token_id - String!
A secure token ID generated by PayPal.

Example

{
  "response_message": "abc123",
  "result": 123,
  "result_code": 987,
  "secure_token": "xyz789",
  "secure_token_id": "abc123"
}

CreatePaymentOrderInput

Contains payment order details that are used while processing the payment order

Input Fields

Input Field
Description
cartId - String!
The customer cart ID
location - PaymentLocation!
Defines the origin location for that payment request
methodCode - String!
The code for the payment method used in the order
paymentSource - String!
The identifiable payment source for the payment method
vaultIntent - Boolean
Indicates whether the payment information should be vaulted

Example

{
  "cartId": "xyz789",
  "location": "PRODUCT_DETAIL",
  "methodCode": "xyz789",
  "paymentSource": "abc123",
  "vaultIntent": false
}

CreatePaymentOrderOutput

Contains payment order details that are used while processing the payment order

Fields

Field Name
Description
amount - Float
The amount of the payment order
currency_code - String
The currency of the payment order
id - String
PayPal order ID
mp_order_id - String
The order ID generated by Payment Services
status - String
The status of the payment order

Example

{
  "amount": 123.45,
  "currency_code": "abc123",
  "id": "xyz789",
  "mp_order_id": "abc123",
  "status": "abc123"
}

CreateProductReviewInput

Defines a new product review.

Input Fields

Input Field
Description
nickname - String!
The customer's nickname. Defaults to the customer name, if logged in.
ratings - [ProductReviewRatingInput]!
The ratings details by category. For example, Price: 5 stars, Quality: 4 stars, etc.
sku - String!
The SKU of the reviewed product.
summary - String!
The summary (title) of the review.
text - String!
The review text.

Example

{
  "nickname": "xyz789",
  "ratings": [ProductReviewRatingInput],
  "sku": "abc123",
  "summary": "xyz789",
  "text": "abc123"
}

CreateProductReviewOutput

Contains the completed product review.

Fields

Field Name
Description
review - ProductReview!
Product review details.

Example

{"review": ProductReview}

CreatePurchaseOrderApprovalRuleConditionAmountInput

Specifies the amount and currency to evaluate.

Input Fields

Input Field
Description
currency - CurrencyEnum!
Purchase order approval rule condition amount currency.
value - Float!
Purchase order approval rule condition amount value.

Example

{"currency": "AFN", "value": 987.65}

CreatePurchaseOrderApprovalRuleConditionInput

Defines a set of conditions that apply to a rule.

Input Fields

Input Field
Description
amount - CreatePurchaseOrderApprovalRuleConditionAmountInput
The amount to be compared in a purchase order approval rule. This field is mutually exclusive with condition quantity.
attribute - PurchaseOrderApprovalRuleType!
The type of approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator!
Defines how to evaluate an amount or quantity in a purchase order.
quantity - Int
The quantity to be compared in a purchase order approval rule. This field is mutually exclusive with condition amount.

Example

{
  "amount": CreatePurchaseOrderApprovalRuleConditionAmountInput,
  "attribute": "GRAND_TOTAL",
  "operator": "MORE_THAN",
  "quantity": 987
}

CreateRequisitionListInput

An input object that identifies and describes a new requisition list.

Input Fields

Input Field
Description
description - String
An optional description of the requisition list.
name - String!
The name assigned to the requisition list.

Example

{
  "description": "xyz789",
  "name": "abc123"
}

CreateRequisitionListOutput

Output of the request to create a requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The created requisition list.

Example

{"requisition_list": RequisitionList}

CreateVaultCardPaymentTokenInput

Describe the variables needed to create a vault payment token

Input Fields

Input Field
Description
card_description - String
Description of the vaulted card
setup_token_id - String!
The setup token obtained by the createVaultCardSetupToken endpoint

Example

{
  "card_description": "xyz789",
  "setup_token_id": "abc123"
}

CreateVaultCardPaymentTokenOutput

The vault token id and information about the payment source

Fields

Field Name
Description
payment_source - PaymentSourceOutput!
The payment source information
vault_token_id - String!
The vault payment token information

Example

{
  "payment_source": PaymentSourceOutput,
  "vault_token_id": "xyz789"
}

CreateVaultCardSetupTokenInput

Describe the variables needed to create a vault card setup token

Input Fields

Input Field
Description
setup_token - VaultSetupTokenInput!
The setup token information
three_ds_mode - ThreeDSMode
The 3DS mode

Example

{
  "setup_token": VaultSetupTokenInput,
  "three_ds_mode": "OFF"
}

CreateVaultCardSetupTokenOutput

The setup token id information

Fields

Field Name
Description
setup_token - String!
The setup token id

Example

{"setup_token": "abc123"}

CreateWishlistInput

Defines the name and visibility of a new wish list.

Input Fields

Input Field
Description
name - String!
The name of the new wish list.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{"name": "abc123", "visibility": "PUBLIC"}

CreateWishlistOutput

Contains the wish list.

Fields

Field Name
Description
wishlist - Wishlist!
The newly-created wish list

Example

{"wishlist": Wishlist}

CreditCardDetailsInput

Required fields for Payflow Pro and Payments Pro credit card payments.

Input Fields

Input Field
Description
cc_exp_month - Int!
The credit card expiration month.
cc_exp_year - Int!
The credit card expiration year.
cc_last_4 - Int!
The last 4 digits of the credit card.
cc_type - String!
The credit card type.

Example

{
  "cc_exp_month": 987,
  "cc_exp_year": 123,
  "cc_last_4": 123,
  "cc_type": "abc123"
}

CreditMemo

Contains credit memo details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments on the credit memo.
id - ID!
The unique ID for a `CreditMemo` object.
items - [CreditMemoItemInterface]
An array containing details about refunded items.
number - String!
The sequential credit memo number.
total - CreditMemoTotal
Details about the total refunded amount.

Example

{
  "comments": [SalesCommentItem],
  "id": 4,
  "items": [CreditMemoItemInterface],
  "number": "xyz789",
  "total": CreditMemoTotal
}

CreditMemoItem

Fields

Field Name
Description
discounts - [Discount]
Details about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for a `CreditMemoItemInterface` object.
order_item - OrderItemInterface
The order item the credit memo is applied to.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product, including selected options.
product_sku - String!
The SKU of the base product.
quantity_refunded - Float
The number of refunded items.

Example

{
  "discounts": [Discount],
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_refunded": 123.45
}

CreditMemoItemInterface

Credit memo item details.

Fields

Field Name
Description
discounts - [Discount]
Details about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for a `CreditMemoItemInterface` object.
order_item - OrderItemInterface
The order item the credit memo is applied to.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product, including selected options.
product_sku - String!
The SKU of the base product.
quantity_refunded - Float
The number of refunded items.

Possible Types

Example

{
  "discounts": [Discount],
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_refunded": 987.65
}

CreditMemoTotal

Contains credit memo price details.

Fields

Field Name
Description
adjustment - Money!
An adjustment manually applied to the order.
base_grand_total - Money!
The final base grand total amount in the base currency.
discounts - [Discount]
The applied discounts to the credit memo.
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the credit memo.
subtotal - Money!
The subtotal of the invoice, excluding shipping, discounts, and taxes.
taxes - [TaxItem]
The credit memo tax details.
total_shipping - Money!
The shipping amount for the credit memo.
total_tax - Money!
The amount of tax applied to the credit memo.

Example

{
  "adjustment": Money,
  "base_grand_total": Money,
  "discounts": [Discount],
  "grand_total": Money,
  "shipping_handling": ShippingHandling,
  "subtotal": Money,
  "taxes": [TaxItem],
  "total_shipping": Money,
  "total_tax": Money
}