NegotiableQuoteTemplateHistoryEntry
Contains details about a change for a negotiable quote template.
Fields
author - NegotiableQuoteUser!change_type - NegotiableQuoteHistoryEntryChangeType!changes - NegotiableQuoteTemplateHistoryChangescreated_at - String!uid - ID!Example
{
"author": NegotiableQuoteUser,
"change_type": "CREATED",
"changes": NegotiableQuoteTemplateHistoryChanges,
"created_at": "abc123",
"uid": "4"
}
NegotiableQuoteTemplateHistoryStatusChange
Lists a new status change applied to a negotiable quote template and the previous status.
Fields
new_status - String!old_status - StringExample
{
"new_status": "xyz789",
"old_status": "xyz789"
}
NegotiableQuoteTemplateHistoryStatusesChange
Contains a list of status changes that occurred for the negotiable quote template.
Fields
Example
{"changes": [NegotiableQuoteTemplateHistoryStatusChange]}
NegotiableQuoteTemplateItemQuantityInput
Specifies the updated quantity of an item.
Input Fields
item_id - ID!max_qty - Floatmin_qty - Floatquantity - Float!Example
{
"item_id": "4",
"max_qty": 987.65,
"min_qty": 987.65,
"quantity": 123.45
}
NegotiableQuoteTemplateReferenceDocumentLinkInput
Defines the reference document link to add to a negotiable quote template.
Input Fields
document_identifier - Stringdocument_name - String!link_id - IDreference_document_url - String!Example
{
"document_identifier": "abc123",
"document_name": "xyz789",
"link_id": 4,
"reference_document_url": "abc123"
}
NegotiableQuoteTemplateShippingAddressInput
Defines shipping addresses for the negotiable quote template.
Input Fields
address - NegotiableQuoteAddressInputcustomer_address_uid - IDcustomer_notes - StringExample
{
"address": NegotiableQuoteAddressInput,
"customer_address_uid": 4,
"customer_notes": "abc123"
}
NegotiableQuoteTemplateSortInput
Defines the field to use to sort a list of negotiable quotes.
Input Fields
sort_direction - SortEnum!sort_field - NegotiableQuoteTemplateSortableField!Example
{"sort_direction": "ASC", "sort_field": "TEMPLATE_ID"}
NegotiableQuoteTemplateSortableField
Values
TEMPLATE_IDLAST_SHARED_ATExample
""TEMPLATE_ID""
NegotiableQuoteTemplatesOutput
Contains a list of negotiable templates that match the specified filter.
Fields
page_info - SearchResultPageInfo!sort_fields - SortFieldstotal_count - Int!Example
{
"items": [NegotiableQuoteTemplateGridItem],
"page_info": SearchResultPageInfo,
"sort_fields": SortFields,
"total_count": 987
}
NegotiableQuoteUidNonFatalResultInterface
Fields
quote_uid - ID!Possible Types
Example
{"quote_uid": "4"}
NegotiableQuoteUidOperationSuccess
Contains details about a successful operation on a negotiable quote.
Fields
quote_uid - ID!Example
{"quote_uid": 4}
NegotiableQuoteUser
A limited view of a Buyer or Seller in the negotiable quote process.
Fields
firstname - String!lastname - String!Example
{
"firstname": "xyz789",
"lastname": "xyz789"
}
NegotiableQuotesOutput
Contains a list of negotiable that match the specified filter.
Fields
items - [NegotiableQuote]!page_info - SearchResultPageInfo!sort_fields - SortFieldstotal_count - Int!Example
{
"items": [NegotiableQuote],
"page_info": SearchResultPageInfo,
"sort_fields": SortFields,
"total_count": 987
}
NoSuchEntityUidError
Contains an error message when an invalid UID was specified.
Fields
message - String!uid - ID!Example
{
"message": "xyz789",
"uid": "4"
}
NumericOperatorInput
Input Fields
type - NumericOperatorTypeExample
{"type": "UNKNOWN_NUMERIC_OPERATOR"}
NumericOperatorType
Values
UNKNOWN_NUMERIC_OPERATORGREATER_THAN_CURRENTLESS_THAN_CURRENTExample
""UNKNOWN_NUMERIC_OPERATOR""
OopePaymentMethodConfig
Fields
backend_integration_url - String!custom_config - [CustomConfigKeyValue]!Example
{
"backend_integration_url": "abc123",
"custom_config": [CustomConfigKeyValue]
}
OpenNegotiableQuoteTemplateInput
Specifies the quote template id to open quote template.
Input Fields
template_id - ID!Example
{"template_id": "4"}
OperatorInput
Input Fields
rangeOperator - RangeOperatorInputcustomOperator - CustomOperatorInputisOperator - IsOperatorInputnumericOperator - NumericOperatorInputstringOperator - StringOperatorInputExample
{
"rangeOperator": RangeOperatorInput,
"customOperator": CustomOperatorInput,
"isOperator": IsOperatorInput,
"numericOperator": NumericOperatorInput,
"stringOperator": StringOperatorInput
}
Order
Contains the order ID.
Fields
order_number - String!Example
{"order_number": "abc123"}
OrderActionType
The list of available order actions.
Values
REORDERCANCELRETURNExample
""REORDER""
OrderAddress
Contains detailed information about an order's billing and shipping addresses.
Fields
city - String!company - Stringcountry_code - CountryCodeEnumcustom_attributesV2 - [AttributeValueInterface]!fax - Stringfirstname - String!lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - Stringregion_id - IDstreet - [String]!suffix - Stringtelephone - Stringvat_id - StringExample
{
"city": "abc123",
"company": "xyz789",
"country_code": "AF",
"custom_attributesV2": [AttributeValueInterface],
"fax": "abc123",
"firstname": "abc123",
"lastname": "abc123",
"middlename": "abc123",
"postcode": "xyz789",
"prefix": "abc123",
"region": "xyz789",
"region_id": "4",
"street": ["abc123"],
"suffix": "abc123",
"telephone": "abc123",
"vat_id": "abc123"
}
OrderCustomerInfo
Fields
firstname - String!lastname - Stringmiddlename - Stringprefix - Stringsuffix - StringExample
{
"firstname": "abc123",
"lastname": "abc123",
"middlename": "xyz789",
"prefix": "abc123",
"suffix": "abc123"
}
OrderItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!prices - OrderItemPricesproduct - ProductInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!product_type - Stringproduct_url_key - Stringquantity_canceled - Floatquantity_invoiced - Floatquantity_ordered - Floatquantity_refunded - Floatquantity_return_requested - Floatquantity_returned - Floatquantity_shipped - Floatselected_options - [OrderItemOption]status - StringExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"eligible_for_return": true,
"entered_options": [OrderItemOption],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": 4,
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"product_type": "abc123",
"product_url_key": "abc123",
"quantity_canceled": 987.65,
"quantity_invoiced": 123.45,
"quantity_ordered": 987.65,
"quantity_refunded": 987.65,
"quantity_return_requested": 987.65,
"quantity_returned": 123.45,
"quantity_shipped": 123.45,
"selected_options": [OrderItemOption],
"status": "xyz789"
}
OrderItemInterface
Order item details.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!prices - OrderItemPricesproduct - ProductInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!product_type - Stringproduct_url_key - Stringquantity_canceled - Floatquantity_invoiced - Floatquantity_ordered - Floatquantity_refunded - Floatquantity_return_requested - Floatquantity_returned - Floatquantity_shipped - Floatselected_options - [OrderItemOption]status - StringPossible Types
Example
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"eligible_for_return": false,
"entered_options": [OrderItemOption],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": 4,
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"product_type": "xyz789",
"product_url_key": "xyz789",
"quantity_canceled": 987.65,
"quantity_invoiced": 123.45,
"quantity_ordered": 987.65,
"quantity_refunded": 123.45,
"quantity_return_requested": 123.45,
"quantity_returned": 987.65,
"quantity_shipped": 123.45,
"selected_options": [OrderItemOption],
"status": "xyz789"
}
OrderItemOption
Represents order item options like selected or entered.
Fields
label - String!value - String!Example
{
"label": "xyz789",
"value": "abc123"
}
OrderItemPrices
Fields
discounts - [Discount]fixed_product_taxes - [FixedProductTax]!original_price - Moneyoriginal_price_including_tax - Moneyoriginal_row_total - Money!original_row_total_including_tax - Money!price - Money!price_including_tax - Money!row_total - Money!row_total_including_tax - Money!total_item_discount - Money!Example
{
"discounts": [Discount],
"fixed_product_taxes": [FixedProductTax],
"original_price": Money,
"original_price_including_tax": Money,
"original_row_total": Money,
"original_row_total_including_tax": Money,
"price": Money,
"price_including_tax": Money,
"row_total": Money,
"row_total_including_tax": Money,
"total_item_discount": Money
}
OrderPaymentMethod
Contains details about the payment method used to pay for the order.
Fields
additional_data - [KeyValue]name - String!type - String!Example
{
"additional_data": [KeyValue],
"name": "abc123",
"type": "xyz789"
}
OrderShipment
Contains order shipment details.
Fields
comments - [SalesCommentItem]id - ID!items - [ShipmentItemInterface]number - String!tracking - [ShipmentTracking]Example
{
"comments": [SalesCommentItem],
"id": 4,
"items": [ShipmentItemInterface],
"number": "abc123",
"tracking": [ShipmentTracking]
}
OrderTokenInput
Input to retrieve an order based on token.
Input Fields
token - String!Example
{"token": "abc123"}
OrderTotal
Contains details about the sales total amounts used to calculate the final price.
Fields
base_grand_total - Money!discounts - [Discount]gift_options - GiftOptionsPricesgrand_total - Money!grand_total_excl_tax - Money!shipping_handling - ShippingHandlingsubtotal_excl_tax - Money!subtotal_incl_tax - Money!taxes - [TaxItem]total_giftcard - Moneytotal_reward_points - Moneytotal_shipping - Money!total_store_credit - Moneytotal_tax - Money!Example
{
"base_grand_total": Money,
"discounts": [Discount],
"gift_options": GiftOptionsPrices,
"grand_total": Money,
"grand_total_excl_tax": Money,
"shipping_handling": ShippingHandling,
"subtotal_excl_tax": Money,
"subtotal_incl_tax": Money,
"taxes": [TaxItem],
"total_giftcard": Money,
"total_reward_points": Money,
"total_shipping": Money,
"total_store_credit": Money,
"total_tax": Money
}
PageInfo
Provides pagination information for navigating through paginated result sets.
Fields
currentPage - Int!pageSize - Int!totalPages - Int!Example
{"currentPage": 987, "pageSize": 987, "totalPages": 123}
PageType
Type of page on which recommendations are requested
Values
CMSCartCategoryCheckoutPageBuilderProductExample
""CMS""
PaymentAttributeInput
Defines the payment attribute.
Input Fields
key - String!value - String!Example
{
"key": "xyz789",
"value": "abc123"
}
PaymentConfigItem
Contains payment fields that are common to all types of payment methods.
Fields
code - Stringis_visible - Booleanpayment_intent - Stringsdk_params - [SDKParams]sort_order - Stringtitle - StringPossible Types
Example
{
"code": "abc123",
"is_visible": true,
"payment_intent": "xyz789",
"sdk_params": [SDKParams],
"sort_order": "xyz789",
"title": "abc123"
}
PaymentConfigOutput
Retrieves the payment configuration for a given location
Fields
apple_pay - ApplePayConfigfastlane - FastlaneConfiggoogle_pay - GooglePayConfighosted_fields - HostedFieldsConfigsmart_buttons - SmartButtonsConfigExample
{
"apple_pay": ApplePayConfig,
"fastlane": FastlaneConfig,
"google_pay": GooglePayConfig,
"hosted_fields": HostedFieldsConfig,
"smart_buttons": SmartButtonsConfig
}
PaymentLocation
Defines the origin location for that payment request
Values
PRODUCT_DETAILMINICARTCARTCHECKOUTADMINExample
""PRODUCT_DETAIL""
PaymentMethodInput
Defines the payment method.
Input Fields
additional_data - [PaymentAttributeInput]code - String!payment_services_paypal_apple_pay - ApplePayMethodInputpayment_services_paypal_fastlane - FastlaneMethodInputpayment_services_paypal_google_pay - GooglePayMethodInputpayment_services_paypal_hosted_fields - HostedFieldsInputpayment_services_paypal_smart_buttons - SmartButtonMethodInputpayment_services_paypal_vault - VaultMethodInputpurchase_order_number - StringExample
{
"additional_data": [PaymentAttributeInput],
"code": "xyz789",
"payment_services_paypal_apple_pay": ApplePayMethodInput,
"payment_services_paypal_fastlane": FastlaneMethodInput,
"payment_services_paypal_google_pay": GooglePayMethodInput,
"payment_services_paypal_hosted_fields": HostedFieldsInput,
"payment_services_paypal_smart_buttons": SmartButtonMethodInput,
"payment_services_paypal_vault": VaultMethodInput,
"purchase_order_number": "xyz789"
}
PaymentOrderOutput
Contains the payment order details
Fields
id - Stringmp_order_id - Stringpayment_source_details - PaymentSourceDetailsstatus - StringExample
{
"id": "abc123",
"mp_order_id": "abc123",
"payment_source_details": PaymentSourceDetails,
"status": "abc123"
}
PaymentSDKParamsItem
Fields
code - Stringparams - [SDKParams]Example
{
"code": "xyz789",
"params": [SDKParams]
}
PaymentSourceDetails
Fields
card - CardExample
{"card": Card}
PaymentSourceInput
The payment source information
Input Fields
card - CardPaymentSourceInput!Example
{"card": CardPaymentSourceInput}
PaymentSourceOutput
The payment source information
Fields
card - CardPaymentSourceOutput!Example
{"card": CardPaymentSourceOutput}
PaymentToken
The stored payment method available to the customer.
Fields
details - Stringpayment_method_code - String!public_hash - String!type - PaymentTokenTypeEnum!Example
{
"details": "abc123",
"payment_method_code": "xyz789",
"public_hash": "xyz789",
"type": "card"
}
PaymentTokenTypeEnum
The list of available payment token types.
Values
cardaccountExample
""card""
PhysicalProductInterface
Contains attributes specific to tangible products.
Fields
weight - FloatPossible Types
Example
{"weight": 987.65}
PickupLocation
Defines Pickup Location information.
Fields
city - Stringcontact_name - Stringcountry_id - Stringdescription - Stringemail - Stringfax - Stringlatitude - Floatlongitude - Floatname - Stringphone - Stringpickup_location_code - Stringpostcode - Stringregion - Stringregion_id - Intstreet - StringExample
{
"city": "xyz789",
"contact_name": "xyz789",
"country_id": "abc123",
"description": "xyz789",
"email": "xyz789",
"fax": "xyz789",
"latitude": 123.45,
"longitude": 123.45,
"name": "xyz789",
"phone": "xyz789",
"pickup_location_code": "abc123",
"postcode": "xyz789",
"region": "abc123",
"region_id": 987,
"street": "xyz789"
}
PickupLocationFilterInput
PickupLocationFilterInput defines the list of attributes and filters for the search.
Input Fields
city - FilterTypeInputcountry_id - FilterTypeInputname - FilterTypeInputpickup_location_code - FilterTypeInputpostcode - FilterTypeInputregion - FilterTypeInputregion_id - FilterTypeInputstreet - FilterTypeInputExample
{
"city": FilterTypeInput,
"country_id": FilterTypeInput,
"name": FilterTypeInput,
"pickup_location_code": FilterTypeInput,
"postcode": FilterTypeInput,
"region": FilterTypeInput,
"region_id": FilterTypeInput,
"street": FilterTypeInput
}
PickupLocationSortInput
PickupLocationSortInput specifies attribute to use for sorting search results and indicates whether the results are sorted in ascending or descending order.
Input Fields
city - SortEnumcontact_name - SortEnumcountry_id - SortEnumdescription - SortEnumdistance - SortEnumemail - SortEnumfax - SortEnumlatitude - SortEnumlongitude - SortEnumname - SortEnumphone - SortEnumpickup_location_code - SortEnumpostcode - SortEnumregion - SortEnumregion_id - SortEnumstreet - SortEnumExample
{
"city": "ASC",
"contact_name": "ASC",
"country_id": "ASC",
"description": "ASC",
"distance": "ASC",
"email": "ASC",
"fax": "ASC",
"latitude": "ASC",
"longitude": "ASC",
"name": "ASC",
"phone": "ASC",
"pickup_location_code": "ASC",
"postcode": "ASC",
"region": "ASC",
"region_id": "ASC",
"street": "ASC"
}
PickupLocations
Top level object returned in a pickup locations search.
Fields
items - [PickupLocation]page_info - SearchResultPageInfototal_count - IntExample
{
"items": [PickupLocation],
"page_info": SearchResultPageInfo,
"total_count": 987
}
PlaceNegotiableQuoteOrderInput
Specifies the negotiable quote to convert to an order.
Input Fields
quote_uid - ID!Example
{"quote_uid": 4}
PlaceNegotiableQuoteOrderOutput
An output object that returns the generated order.
Fields
order - Order!Example
{"order": Order}
PlaceNegotiableQuoteOrderOutputV2
An output object that returns the generated order.
Fields
errors - [PlaceOrderError]order - CustomerOrderExample
{
"errors": [PlaceOrderError],
"order": CustomerOrder
}
PlaceOrderError
An error encountered while placing an order.
Fields
code - PlaceOrderErrorCodes!message - String!Example
{
"code": "CART_NOT_FOUND",
"message": "abc123"
}
PlaceOrderErrorCodes
Values
CART_NOT_FOUNDCART_NOT_ACTIVEGUEST_EMAIL_MISSINGUNABLE_TO_PLACE_ORDERUNDEFINEDExample
""CART_NOT_FOUND""
PlaceOrderForPurchaseOrderInput
Specifies the purchase order to convert to an order.
Input Fields
purchase_order_uid - ID!Example
{"purchase_order_uid": 4}
PlaceOrderForPurchaseOrderOutput
Contains the results of the request to place an order.
Fields
order - CustomerOrder!Example
{"order": CustomerOrder}
PlaceOrderInput
Specifies the quote to be converted to an order.
Input Fields
cart_id - String!Example
{"cart_id": "xyz789"}
PlaceOrderOutput
Contains the results of the request to place an order.
Fields
errors - [PlaceOrderError]!orderV2 - CustomerOrderExample
{
"errors": [PlaceOrderError],
"orderV2": CustomerOrder
}
PlacePurchaseOrderInput
Specifies the quote to be converted to a purchase order.
Input Fields
cart_id - String!Example
{"cart_id": "xyz789"}
PlacePurchaseOrderOutput
Contains the results of the request to place a purchase order.
Fields
purchase_order - PurchaseOrder!Example
{"purchase_order": PurchaseOrder}
Price
Defines the price of a simple product or a part of a price range for a complex product. It can include a list of price adjustments.
Fields
adjustments - [PriceAdjustment]amount - ProductViewMoneyExample
{
"adjustments": [PriceAdjustment],
"amount": ProductViewMoney
}
PriceAdjustment
Specifies the amount and type of price adjustment.
Fields
amount - Floatcode - StringExample
{"amount": 987.65, "code": "abc123"}
PriceDetails
Can be used to retrieve the main price details in case of bundle product
Fields
discount_percentage - Floatmain_final_price - Floatmain_price - FloatExample
{
"discount_percentage": 123.45,
"main_final_price": 123.45,
"main_price": 123.45
}
PriceRange
Contains the price range for a product. If the product has a single price, the minimum and maximum price will be the same.
Fields
maximum_price - ProductPriceminimum_price - ProductPrice!Example
{
"maximum_price": ProductPrice,
"minimum_price": ProductPrice
}
PriceTypeEnum
Defines the price type.
Values
FIXEDPERCENTDYNAMICExample
""FIXED""
PriceViewEnum
Defines whether a bundle product's price is displayed as the lowest possible value or as a range.
Values
PRICE_RANGEAS_LOW_ASExample
""PRICE_RANGE""
ProductAlertPriceInput
Input Fields
sku - String!Example
{"sku": "abc123"}
ProductAlertStockInput
Input Fields
sku - String!Example
{"sku": "abc123"}
ProductAlertSubscriptionResult
Fields
Example
{"message": "xyz789", "success": false}
ProductAttribute
Contains a product attribute code and value.
Fields
code - String!value - String!Example
{
"code": "xyz789",
"value": "abc123"
}
ProductAttributeFile
Fields
attribute_type - Stringcode - ID!url - String!value - String!Example
{
"attribute_type": "abc123",
"code": 4,
"url": "abc123",
"value": "abc123"
}
ProductCustomAttributes
Product custom attributes
Fields
errors - [AttributeMetadataError]!items - [AttributeValueInterface]!Example
{
"errors": [AttributeMetadataError],
"items": [AttributeValueInterface]
}
ProductDiscount
Contains the discount applied to a product price.
Fields
amount_off - Floatpercent_off - FloatExample
{"amount_off": 123.45, "percent_off": 123.45}
ProductImage
Contains product image information, including the image URL and label.
Fields
disabled - Booleanlabel - Stringposition - Inturl - StringExample
{
"disabled": true,
"label": "xyz789",
"position": 123,
"url": "abc123"
}
ProductImageThumbnail
Values
ITSELFPARENTExample
""ITSELF""
ProductInfoInput
Product Information used for Pickup Locations search.
Input Fields
sku - String!Example
{"sku": "abc123"}
ProductInterface
Contains fields that are common to all types of products.
Fields
canonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]product_links - [ProductLinksInterface]quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!upsell_products - [ProductInterface]url_key - StringPossible Types
Example
{
"canonical_url": "abc123",
"categories": [CategoryInterface],
"country_of_manufacture": "abc123",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": false,
"gift_wrapping_available": true,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"manufacturer": 123,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "xyz789",
"meta_keyword": "xyz789",
"meta_title": "xyz789",
"min_sale_qty": 987.65,
"name": "abc123",
"new_from_date": "abc123",
"new_to_date": "xyz789",
"only_x_left_in_stock": 123.45,
"options_container": "abc123",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 123.45,
"special_to_date": "xyz789",
"stock_status": "IN_STOCK",
"swatch_image": "abc123",
"thumbnail": ProductImage,
"uid": 4,
"upsell_products": [ProductInterface],
"url_key": "abc123"
}
ProductLinks
An implementation of ProductLinksInterface.
Fields
link_type - Stringlinked_product_sku - Stringlinked_product_type - Stringposition - Intsku - StringExample
{
"link_type": "abc123",
"linked_product_sku": "xyz789",
"linked_product_type": "xyz789",
"position": 123,
"sku": "xyz789"
}
ProductLinksInterface
Contains information about linked products, including the link type and product type of each item.
Fields
link_type - Stringlinked_product_sku - Stringlinked_product_type - Stringposition - Intsku - StringPossible Types
Example
{
"link_type": "xyz789",
"linked_product_sku": "xyz789",
"linked_product_type": "abc123",
"position": 123,
"sku": "xyz789"
}
ProductMediaGalleryEntriesAssetImage
Contains basic information about the image asset.
Fields
asset_id - Stringmedia_type - Stringmedia_url - StringExample
{
"asset_id": "xyz789",
"media_type": "xyz789",
"media_url": "xyz789"
}
ProductMediaGalleryEntriesAssetVideo
Contains basic information about the video asset.
Fields
media_type - Stringvideo_asset_id - Stringvideo_media_url - StringExample
{
"media_type": "xyz789",
"video_asset_id": "xyz789",
"video_media_url": "xyz789"
}
ProductMediaGalleryEntriesVideoContent
Contains a link to a video file and basic information about the video.
Fields
media_type - Stringvideo_description - Stringvideo_metadata - Stringvideo_provider - Stringvideo_title - Stringvideo_url - StringExample
{
"media_type": "xyz789",
"video_description": "xyz789",
"video_metadata": "xyz789",
"video_provider": "xyz789",
"video_title": "abc123",
"video_url": "abc123"
}
ProductPrice
Represents a product price.
Fields
discount - ProductDiscountfinal_price - Money!fixed_product_taxes - [FixedProductTax]regular_price - Money!Example
{
"discount": ProductDiscount,
"final_price": Money,
"fixed_product_taxes": [FixedProductTax],
"regular_price": Money
}
ProductSearchItem
A single product returned by the query
Fields
applied_query_rule - AppliedQueryRulehighlights - [Highlight]productView - ProductViewExample
{
"applied_query_rule": AppliedQueryRule,
"highlights": [Highlight],
"productView": ProductView
}
ProductSearchResponse
Contains the output of a productSearch query
Fields
facets - [Aggregation]items - [ProductSearchItem]page_info - SearchResultPageInforelated_terms - [String]suggestions - [String]total_count - Intwarnings - [ProductSearchWarning]Example
{
"facets": [Aggregation],
"items": [ProductSearchItem],
"page_info": SearchResultPageInfo,
"related_terms": ["abc123"],
"suggestions": ["abc123"],
"total_count": 123,
"warnings": [ProductSearchWarning]
}
ProductSearchSortInput
The product attribute to sort on
Input Fields
attribute - String!direction - SortEnum!Example
{"attribute": "abc123", "direction": "ASC"}
ProductSearchWarning
Structured warning with code and message for easier client handling
Fields
code - String!message - String!Example
{
"code": "abc123",
"message": "xyz789"
}
ProductStockStatus
This enumeration states whether a product stock status is in stock or out of stock
Values
IN_STOCKOUT_OF_STOCKExample
""IN_STOCK""
ProductVideo
Contains information about a product video.
Fields
disabled - Booleanlabel - Stringposition - Inturl - Stringvideo_content - ProductMediaGalleryEntriesVideoContentExample
{
"disabled": true,
"label": "abc123",
"position": 123,
"url": "abc123",
"video_content": ProductMediaGalleryEntriesVideoContent
}
ProductView
Defines the product fields available to the SimpleProductView and ComplexProductView types.
Fields
addToCartAllowed - BooleaninStock - BooleanlowStock - Booleanattributes - [ProductViewAttribute]description - Stringid - ID!images - [ProductViewImage]videos - [ProductViewVideo]lastModifiedAt - DateTimemetaDescription - StringmetaKeyword - StringmetaTitle - Stringname - StringshortDescription - StringinputOptions - [ProductViewInputOption]sku - StringexternalId - Stringurl - StringurlKey - Stringlinks - [ProductViewLink]categories - [CategoryProductView!]queryType - Stringvisibility - StringPossible Types
Example
{
"addToCartAllowed": false,
"inStock": false,
"lowStock": true,
"attributes": [ProductViewAttribute],
"description": "abc123",
"id": "4",
"images": [ProductViewImage],
"videos": [ProductViewVideo],
"lastModifiedAt": "2007-12-03T10:15:30Z",
"metaDescription": "xyz789",
"metaKeyword": "abc123",
"metaTitle": "abc123",
"name": "xyz789",
"shortDescription": "abc123",
"inputOptions": [ProductViewInputOption],
"sku": "abc123",
"externalId": "xyz789",
"url": "xyz789",
"urlKey": "xyz789",
"links": [ProductViewLink],
"categories": [CategoryProductView],
"queryType": "xyz789",
"visibility": "abc123"
}
ProductViewAttribute
A container for customer-defined attributes that are displayed the storefront.
Fields
label - Stringname - String!roles - [String]value - JSONExample
{
"label": "abc123",
"name": "abc123",
"roles": ["abc123"],
"value": {}
}
ProductViewCurrency
The list of supported currency codes.
Values
AEDAFNALLAMDANGAOAARSAUDAWGAZMAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBUKBWPBYNBZDCADCDFCHECHFCHWCLPCNYCOPCRCCUPCVECZKDJFDKKDOPDZDEEKEGPERNETBEURFJDFKPGBPGEKGELGHSGIPGMDGNFGQEGTQGYDHKDHNLHRKHTGHUFIDRILSINRIQDIRRISKJMDJODJPYKESKGSKHRKMFKPWKRWKWDKYDKZTLAKLBPLKRLRDLSLLSMLTLLVLLYDMADMDLMGAMKDMMKMNTMOPMROMURMVRMWKMXNMYRMZNNADNGNNICNOKNPRNZDOMRPABPENPGKPHPPKRPLNPYGQARRHDROLRONRSDRUBRWFSARSBDSCRSDGSEKSGDSHPSKKSLLSOSSRDSTDSVCSYPSZLTHBTJSTMMTNDTOPTRLTRYTTDTWDTZSUAHUGXUSDUYUUZSVEBVEFVNDVUVWSTXCDXOFXPFYERZARZMKZWDNONEExample
""AED""
ProductViewImage
Contains details about a product image.
Fields
label - Stringroles - [String]url - String!Example
{
"label": "abc123",
"roles": ["abc123"],
"url": "xyz789"
}
ProductViewInputOption
Product options provide a way to configure products by making selections of particular option values. Selecting one or many options will point to a simple product.
Fields
id - IDtitle - Stringrequired - Booleantype - StringmarkupAmount - Floatsuffix - StringsortOrder - Intrange - ProductViewInputOptionRangeimageSize - ProductViewInputOptionImageSizefileExtensions - StringExample
{
"id": 4,
"title": "abc123",
"required": false,
"type": "abc123",
"markupAmount": 987.65,
"suffix": "xyz789",
"sortOrder": 987,
"range": ProductViewInputOptionRange,
"imageSize": ProductViewInputOptionImageSize,
"fileExtensions": "abc123"
}
ProductViewInputOptionImageSize
Dimensions of the image associated with the input option.
Fields
width - Intheight - IntExample
{"width": 123, "height": 123}
ProductViewInputOptionRange
Lists the value range associated with a ProductViewInputOption. For example, if the input option is a text field, the range represents the number of characters.
Fields
from - Floatto - FloatExample
{"from": 987.65, "to": 987.65}
ProductViewLink
The product link type. Contains details about product links for related products and cross selling. For example, related, up_sell or cross_sell
Fields
product - ProductView!linkTypes - [String!]!Example
{
"product": ProductView,
"linkTypes": ["xyz789"]
}
ProductViewMoney
Defines a monetary value, including a numeric value and a currency code.
Fields
currency - ProductViewCurrencyvalue - FloatExample
{"currency": "AED", "value": 987.65}
ProductViewOption
Product options provide a way to configure products by making selections of particular option values. Selecting one or many options will point to a simple product.
Fields
id - IDmulti - Booleanrequired - Booleantitle - Stringvalues - [ProductViewOptionValue!]Example
{
"id": "4",
"multi": true,
"required": false,
"title": "xyz789",
"values": [ProductViewOptionValue]
}
ProductViewOptionValue
Defines the product fields available to the ProductViewOptionValueProduct and ProductViewOptionValueConfiguration types.
Fields
id - IDtitle - StringinStock - BooleanPossible Types
Example
{
"id": "4",
"title": "xyz789",
"inStock": false
}
ProductViewOptionValueConfiguration
An implementation of ProductViewOptionValue for configuration values.
Fields
id - IDtitle - StringinStock - BooleanExample
{
"id": "4",
"title": "xyz789",
"inStock": false
}
ProductViewOptionValueProduct
An implementation of ProductViewOptionValue that adds details about a simple product.
Fields
id - IDisDefault - Booleanproduct - SimpleProductViewquantity - Floattitle - StringinStock - BooleanExample
{
"id": 4,
"isDefault": true,
"product": SimpleProductView,
"quantity": 123.45,
"title": "xyz789",
"inStock": true
}
ProductViewOptionValueSwatch
An implementation of ProductViewOptionValueSwatch for swatches.
Fields
id - IDtitle - Stringtype - SwatchTypevalue - StringinStock - BooleanExample
{
"id": "4",
"title": "xyz789",
"type": "TEXT",
"value": "abc123",
"inStock": true
}
ProductViewPrice
Base product price view. Contains the final price after discounts, the regular price, and the list of tier prices.
Fields
final - Priceregular - Pricetiers - [ProductViewTierPrice]roles - [String]Example
{
"final": Price,
"regular": Price,
"tiers": [ProductViewTierPrice],
"roles": ["xyz789"]
}
ProductViewPriceRange
The minimum and maximum price of a complex product.
Fields
maximum - ProductViewPriceminimum - ProductViewPriceExample
{
"maximum": ProductViewPrice,
"minimum": ProductViewPrice
}
ProductViewTierCondition
Types
Example
ProductViewTierRangeCondition
ProductViewTierExactMatchCondition
Minimum quantity (inclusive) required to activate this tier price. For example, a value of 10 means this tier applies when 10 or more items are purchased.
Fields
in - [Float]Example
{"in": [987.65]}
ProductViewTierPrice
The discounted price that applies when the quantity conditions in quantity are satisfied. Contains the monetary amount and any price adjustments applied to this tier.
Fields
tier - Pricequantity - [ProductViewTierCondition!]!Example
{
"tier": Price,
"quantity": [ProductViewTierRangeCondition]
}
ProductViewTierRangeCondition
Minimum quantity (inclusive) required to activate this tier price. For example, a value of 10 means this tier applies when 10 or more items are purchased. Maximum quantity (exclusive) required to activate this tier price. For example, a value of 20 means this tier applies when less than 20 items are purchased.
Fields
gte - Floatlt - FloatExample
{"gte": 123.45, "lt": 987.65}
ProductViewVariant
Represents a product variant.
Fields
selections - [String!]product - ProductViewExample
{
"selections": ["xyz789"],
"product": ProductView
}
ProductViewVariantResults
Represents the results of a product variant search.
Fields
variants - [ProductViewVariant]!cursor - StringExample
{
"variants": [ProductViewVariant],
"cursor": "abc123"
}
ProductViewVideo
Contains details about a product video. For example, a video of the product being used or a video of the product being assembled.
Fields
preview - ProductViewImageurl - String!description - Stringtitle - StringExample
{
"preview": ProductViewImage,
"url": "xyz789",
"description": "xyz789",
"title": "abc123"
}
PurchaseHistory
User purchase history
Input Fields
Example
{
"date": "2007-12-03T10:15:30Z",
"items": ["xyz789"]
}
PurchaseOrder
Contains details about a purchase order.
Fields
approval_flow - [PurchaseOrderRuleApprovalFlow]available_actions - [PurchaseOrderAction]!comments - [PurchaseOrderComment]!created_at - String!created_by - Customerhistory_log - [PurchaseOrderHistoryItem]!number - String!order - CustomerOrderquote - Cartstatus - PurchaseOrderStatus!uid - ID!updated_at - String!Example
{
"approval_flow": [PurchaseOrderRuleApprovalFlow],
"available_actions": ["REJECT"],
"comments": [PurchaseOrderComment],
"created_at": "abc123",
"created_by": Customer,
"history_log": [PurchaseOrderHistoryItem],
"number": "xyz789",
"order": CustomerOrder,
"quote": Cart,
"status": "PENDING",
"uid": "4",
"updated_at": "xyz789"
}
PurchaseOrderAction
Values
REJECTCANCELVALIDATEAPPROVEPLACE_ORDERExample
""REJECT""
PurchaseOrderActionError
Contains details about a failed action.
Fields
message - String!type - PurchaseOrderErrorType!Example
{"message": "abc123", "type": "NOT_FOUND"}
PurchaseOrderApprovalFlowEvent
Contains details about a single event in the approval flow of the purchase order.
Fields
message - Stringname - Stringrole - Stringstatus - PurchaseOrderApprovalFlowItemStatusupdated_at - StringExample
{
"message": "xyz789",
"name": "xyz789",
"role": "abc123",
"status": "PENDING",
"updated_at": "xyz789"
}
PurchaseOrderApprovalFlowItemStatus
Values
PENDINGAPPROVEDREJECTEDExample
""PENDING""
PurchaseOrderApprovalRule
Contains details about a purchase order approval rule.
Fields
applies_to_roles - [CompanyRole]!approver_roles - [CompanyRole]!condition - PurchaseOrderApprovalRuleConditionInterfacecreated_at - String!created_by - String!description - Stringname - String!status - PurchaseOrderApprovalRuleStatus!uid - ID!updated_at - String!Example
{
"applies_to_roles": [CompanyRole],
"approver_roles": [CompanyRole],
"condition": PurchaseOrderApprovalRuleConditionInterface,
"created_at": "abc123",
"created_by": "xyz789",
"description": "xyz789",
"name": "abc123",
"status": "ENABLED",
"uid": "4",
"updated_at": "xyz789"
}
PurchaseOrderApprovalRuleConditionAmount
Contains approval rule condition details, including the amount to be evaluated.
Fields
amount - Money!attribute - PurchaseOrderApprovalRuleTypeoperator - PurchaseOrderApprovalRuleConditionOperatorExample
{
"amount": Money,
"attribute": "GRAND_TOTAL",
"operator": "MORE_THAN"
}
PurchaseOrderApprovalRuleConditionInterface
Purchase order rule condition details.
Fields
attribute - PurchaseOrderApprovalRuleTypeoperator - PurchaseOrderApprovalRuleConditionOperatorPossible Types
Example
{"attribute": "GRAND_TOTAL", "operator": "MORE_THAN"}
PurchaseOrderApprovalRuleConditionOperator
Values
MORE_THANLESS_THANMORE_THAN_OR_EQUAL_TOLESS_THAN_OR_EQUAL_TOExample
""MORE_THAN""
PurchaseOrderApprovalRuleConditionQuantity
Contains approval rule condition details, including the quantity to be evaluated.
Fields
attribute - PurchaseOrderApprovalRuleTypeoperator - PurchaseOrderApprovalRuleConditionOperatorquantity - IntExample
{"attribute": "GRAND_TOTAL", "operator": "MORE_THAN", "quantity": 987}
PurchaseOrderApprovalRuleInput
Defines a new purchase order approval rule.
Input Fields
applies_to - [ID]!approvers - [ID]!condition - CreatePurchaseOrderApprovalRuleConditionInput!description - Stringname - String!status - PurchaseOrderApprovalRuleStatus!Example
{
"applies_to": ["4"],
"approvers": ["4"],
"condition": CreatePurchaseOrderApprovalRuleConditionInput,
"description": "abc123",
"name": "abc123",
"status": "ENABLED"
}
PurchaseOrderApprovalRuleMetadata
Contains metadata that can be used to render rule edit forms.
Fields
available_applies_to - [CompanyRole]!available_condition_currencies - [AvailableCurrency]!available_requires_approval_from - [CompanyRole]!Example
{
"available_applies_to": [CompanyRole],
"available_condition_currencies": [AvailableCurrency],
"available_requires_approval_from": [CompanyRole]
}
PurchaseOrderApprovalRuleStatus
Values
ENABLEDDISABLEDExample
""ENABLED""
PurchaseOrderApprovalRuleType
Values
GRAND_TOTALSHIPPING_INCL_TAXNUMBER_OF_SKUSExample
""GRAND_TOTAL""
PurchaseOrderApprovalRules
Contains the approval rules that the customer can see.
Fields
items - [PurchaseOrderApprovalRule]!page_info - SearchResultPageInfototal_count - IntExample
{
"items": [PurchaseOrderApprovalRule],
"page_info": SearchResultPageInfo,
"total_count": 987
}
PurchaseOrderComment
Contains details about a comment.
Fields
author - Customercreated_at - String!text - String!uid - ID!Example
{
"author": Customer,
"created_at": "abc123",
"text": "xyz789",
"uid": 4
}
PurchaseOrderErrorType
Values
NOT_FOUNDOPERATION_NOT_APPLICABLECOULD_NOT_SAVENOT_VALID_DATAUNDEFINEDExample
""NOT_FOUND""
PurchaseOrderHistoryItem
Contains details about a status change.
Fields
activity - String!created_at - String!message - String!uid - ID!Example
{
"activity": "abc123",
"created_at": "abc123",
"message": "abc123",
"uid": "4"
}
PurchaseOrderRuleApprovalFlow
Contains details about approval roles applied to the purchase order and status changes.
Fields
events - [PurchaseOrderApprovalFlowEvent]!rule_name - String!Example
{
"events": [PurchaseOrderApprovalFlowEvent],
"rule_name": "xyz789"
}
PurchaseOrderStatus
Values
PENDINGAPPROVAL_REQUIREDAPPROVEDORDER_IN_PROGRESSORDER_PLACEDORDER_FAILEDREJECTEDCANCELEDAPPROVED_PENDING_PAYMENTExample
""PENDING""
PurchaseOrders
Contains a list of purchase orders.
Fields
items - [PurchaseOrder]!page_info - SearchResultPageInfototal_count - IntExample
{
"items": [PurchaseOrder],
"page_info": SearchResultPageInfo,
"total_count": 987
}
PurchaseOrdersActionInput
Defines which purchase orders to act on.
Input Fields
purchase_order_uids - [ID]!Example
{"purchase_order_uids": ["4"]}
PurchaseOrdersActionOutput
Returns a list of updated purchase orders and any error messages.
Fields
errors - [PurchaseOrderActionError]!purchase_orders - [PurchaseOrder]!Example
{
"errors": [PurchaseOrderActionError],
"purchase_orders": [PurchaseOrder]
}
PurchaseOrdersFilterInput
Defines the criteria to use to filter the list of purchase orders.
Input Fields
company_purchase_orders - Booleancreated_date - FilterRangeTypeInputmy_approvals - Booleanrequire_my_approval - Booleanstatus - PurchaseOrderStatusExample
{
"company_purchase_orders": false,
"created_date": FilterRangeTypeInput,
"my_approvals": false,
"require_my_approval": false,
"status": "PENDING"
}
QueryContextInput
Input Fields
customerGroup - String!userViewHistory - [ViewHistoryInput!]Example
{
"customerGroup": "abc123",
"userViewHistory": [ViewHistoryInput]
}
QuoteItemsSortInput
Specifies the field to use for sorting quote items
Input Fields
field - SortQuoteItemsEnum!order - SortEnum!Example
{"field": "ITEM_ID", "order": "ASC"}
QuoteTemplateExpirationDateInput
Sets quote template expiration date.
Input Fields
expiration_date - String!template_id - ID!Example
{
"expiration_date": "abc123",
"template_id": "4"
}
QuoteTemplateLineItemNoteInput
Sets quote item note.
Input Fields
item_id - IDitem_uid - IDnote - StringtemplateId - ID!Example
{
"item_id": "4",
"item_uid": 4,
"note": "abc123",
"templateId": "4"
}
QuoteTemplateNotificationMessage
Contains a notification message for a negotiable quote template.
Fields
message - String!type - String!Example
{
"message": "xyz789",
"type": "xyz789"
}
RangeBucket
For use on numeric product fields
Fields
count - Int!from - Float!title - String!to - FloatExample
{
"count": 987,
"from": 123.45,
"title": "xyz789",
"to": 123.45
}
RangeOperatorInput
Input Fields
Example
{"type": "UNKNOWN_RANGE_TYPE", "value": RangeValueInput}
RangeType
Values
UNKNOWN_RANGE_TYPESTATICPERCENTAGEDYNAMICExample
""UNKNOWN_RANGE_TYPE""
RangeValueInput
Input Fields
Example
{"from": 987.65, "to": 987.65}
ReCaptchaConfigOutput
Fields
configurations - ReCaptchaConfigurationis_enabled - Boolean!Example
{
"configurations": ReCaptchaConfiguration,
"is_enabled": false
}
ReCaptchaConfiguration
Contains reCAPTCHA form configuration details.
Fields
badge_position - Stringlanguage_code - Stringminimum_score - Floatre_captcha_type - ReCaptchaTypeEmum!technical_failure_message - String!theme - String!validation_failure_message - String!website_key - String!Example
{
"badge_position": "xyz789",
"language_code": "abc123",
"minimum_score": 123.45,
"re_captcha_type": "INVISIBLE",
"technical_failure_message": "xyz789",
"theme": "abc123",
"validation_failure_message": "abc123",
"website_key": "xyz789"
}
ReCaptchaConfigurationV3
Contains reCAPTCHA V3-Invisible configuration details.
Fields
badge_position - String!failure_message - String!forms - [ReCaptchaFormEnum]!is_enabled - Boolean!language_code - Stringminimum_score - Float!theme - String!website_key - String!Example
{
"badge_position": "abc123",
"failure_message": "xyz789",
"forms": ["PLACE_ORDER"],
"is_enabled": false,
"language_code": "xyz789",
"minimum_score": 123.45,
"theme": "abc123",
"website_key": "xyz789"
}
ReCaptchaFormConfigItem
Contains reCAPTCHA configuration for a specific form type.
Fields
configurations - ReCaptchaConfigurationform_type - ReCaptchaFormEnum!is_enabled - Boolean!Example
{
"configurations": ReCaptchaConfiguration,
"form_type": "PLACE_ORDER",
"is_enabled": false
}
ReCaptchaFormEnum
Values
PLACE_ORDERCONTACTCUSTOMER_LOGINCUSTOMER_FORGOT_PASSWORDCUSTOMER_CREATECUSTOMER_EDITNEWSLETTERPRODUCT_REVIEWSENDFRIENDBRAINTREERESEND_CONFIRMATION_EMAILExample
""PLACE_ORDER""
ReCaptchaTypeEmum
Values
INVISIBLERECAPTCHARECAPTCHA_V3RECAPTCHA_ENTERPRISEExample
""INVISIBLE""
RecommendationUnit
Recommendation Unit containing product and other details
Fields
displayOrder - IntpageType - StringproductsView - [ProductView]storefrontLabel - StringtotalProducts - InttypeId - StringunitId - StringunitName - StringExample
{
"displayOrder": 987,
"pageType": "xyz789",
"productsView": [ProductView],
"storefrontLabel": "abc123",
"totalProducts": 987,
"typeId": "abc123",
"unitId": "xyz789",
"unitName": "xyz789"
}
Recommendations
Recommendations response
Fields
results - [RecommendationUnit]totalResults - IntExample
{"results": [RecommendationUnit], "totalResults": 123}
Region
Fields
code - Stringid - Intname - StringExample
{
"code": "xyz789",
"id": 123,
"name": "xyz789"
}
RemoveCouponFromCartInput
Specifies the cart from which to remove a coupon.
Input Fields
cart_id - String!Example
{"cart_id": "xyz789"}
RemoveCouponFromCartOutput
Contains details about the cart after removing a coupon.
Fields
cart - CartExample
{"cart": Cart}
RemoveCouponsFromCartInput
Remove coupons from the cart.
Input Fields
cart_id - String!coupon_codes - [String]!Example
{
"cart_id": "xyz789",
"coupon_codes": ["abc123"]
}
RemoveGiftCardFromCartInput
Defines the input required to run the removeGiftCardFromCart mutation.
Input Fields
cart_id - String!gift_card_code - String!Example
{
"cart_id": "xyz789",
"gift_card_code": "abc123"
}
RemoveGiftCardFromCartOutput
Defines the possible output for the removeGiftCardFromCart mutation.
Fields
cart - Cart!Example
{"cart": Cart}
RemoveGiftRegistryItemsOutput
Contains the results of a request to remove an item from a gift registry.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
RemoveGiftRegistryOutput
Contains the results of a request to delete a gift registry.
Fields
success - Boolean!Example
{"success": true}
RemoveGiftRegistryRegistrantsOutput
Contains the results of a request to delete a registrant.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
RemoveItemFromCartInput
Specifies which items to remove from the cart.
Input Fields
cart_id - String!cart_item_uid - IDExample
{"cart_id": "abc123", "cart_item_uid": 4}
RemoveItemFromCartOutput
Contains details about the cart after removing an item.
Fields
cart - Cart!Example
{"cart": Cart}
RemoveNegotiableQuoteItemsInput
Defines the items to remove from the specified negotiable quote.
Input Fields
quote_item_uids - [ID]!quote_uid - ID!Example
{"quote_item_uids": [4], "quote_uid": 4}
RemoveNegotiableQuoteItemsOutput
Contains the negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
RemoveNegotiableQuoteTemplateItemsInput
Defines the items to remove from the specified negotiable quote.
Input Fields
item_uids - [ID]!template_id - ID!Example
{"item_uids": [4], "template_id": 4}
RemoveProductsFromCompareListInput
Defines which products to remove from a compare list.
Input Fields
products - [ID]!uid - ID!Example
{"products": [4], "uid": "4"}
RemoveProductsFromWishlistOutput
Contains the customer's wish list and any errors encountered.
Fields
user_errors - [WishListUserInputError]!wishlist - Wishlist!Example
{
"user_errors": [WishListUserInputError],
"wishlist": Wishlist
}
RemoveReturnTrackingInput
Defines the tracking information to delete.
Input Fields
return_shipping_tracking_uid - ID!Example
{"return_shipping_tracking_uid": "4"}
RemoveReturnTrackingOutput
Contains the response after deleting tracking information.
Fields
return - ReturnExample
{"return": Return}
RemoveRewardPointsFromCartOutput
Contains the customer cart.
Fields
cart - Cart!Example
{"cart": Cart}
RemoveStoreCreditFromCartInput
Defines the input required to run the removeStoreCreditFromCart mutation.
Input Fields
cart_id - String!Example
{"cart_id": "xyz789"}
RemoveStoreCreditFromCartOutput
Defines the possible output for the removeStoreCreditFromCart mutation.
Fields
cart - Cart!Example
{"cart": Cart}
RenameNegotiableQuoteInput
Sets new name for a negotiable quote.
Input Fields
quote_comment - Stringquote_name - String!quote_uid - ID!Example
{
"quote_comment": "abc123",
"quote_name": "abc123",
"quote_uid": "4"
}
RenameNegotiableQuoteOutput
Contains the updated negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
ReorderItemsOutput
Contains the cart and any errors after adding products.
Fields
cart - Cart!userInputErrors - [CheckoutUserInputError]!Example
{
"cart": Cart,
"userInputErrors": [CheckoutUserInputError]
}
RequestGuestReturnInput
Contains information needed to start a return request.
Input Fields
comment_text - Stringcontact_email - Stringitems - [RequestReturnItemInput]!token - String!Example
{
"comment_text": "xyz789",
"contact_email": "xyz789",
"items": [RequestReturnItemInput],
"token": "abc123"
}
RequestNegotiableQuoteInput
Defines properties of a negotiable quote request.
Input Fields
cart_id - ID!comment - NegotiableQuoteCommentInput!is_draft - Booleanquote_name - String!Example
{
"cart_id": "4",
"comment": NegotiableQuoteCommentInput,
"is_draft": false,
"quote_name": "xyz789"
}
RequestNegotiableQuoteOutput
Contains the NegotiableQuote object generated when a buyer requests a negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
RequestNegotiableQuoteTemplateInput
Defines properties of a negotiable quote template request.
Input Fields
cart_id - ID!Example
{"cart_id": 4}
RequestReturnInput
Contains information needed to start a return request.
Input Fields
comment_text - Stringcontact_email - Stringitems - [RequestReturnItemInput]!order_uid - ID!Example
{
"comment_text": "xyz789",
"contact_email": "abc123",
"items": [RequestReturnItemInput],
"order_uid": "4"
}
RequestReturnItemInput
Contains details about an item to be returned.
Input Fields
entered_custom_attributes - [EnteredCustomAttributeInput]order_item_uid - ID!quantity_to_return - Float!selected_custom_attributes - [SelectedCustomAttributeInput]Example
{
"entered_custom_attributes": [
EnteredCustomAttributeInput
],
"order_item_uid": "4",
"quantity_to_return": 987.65,
"selected_custom_attributes": [
SelectedCustomAttributeInput
]
}
RequestReturnOutput
Contains the response to a return request.
Fields
return - Returnreturns - ReturnsExample
{
"return": Return,
"returns": Returns
}
RequisitionList
Defines the contents of a requisition list.
Fields
description - Stringitems - RequistionListItemsitems_count - Int!name - String!uid - ID!updated_at - StringExample
{
"description": "xyz789",
"items": RequistionListItems,
"items_count": 123,
"name": "abc123",
"uid": "4",
"updated_at": "abc123"
}
RequisitionListFilterInput
Defines requisition list filters.
Input Fields
name - FilterMatchTypeInputuids - FilterEqualTypeInputExample
{
"name": FilterMatchTypeInput,
"uids": FilterEqualTypeInput
}
RequisitionListItemInterface
The interface for requisition list items.
Fields
customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!sku - String!uid - ID!Possible Types
Example
{
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 987.65,
"sku": "xyz789",
"uid": 4
}
RequisitionListItemsInput
Defines the items to add.
Input Fields
entered_options - [EnteredOptionInput]parent_sku - Stringquantity - Floatselected_options - [String]sku - String!Example
{
"entered_options": [EnteredOptionInput],
"parent_sku": "xyz789",
"quantity": 123.45,
"selected_options": ["abc123"],
"sku": "xyz789"
}
RequisitionListSortInput
Defines the field to use to sort a list of requisition lists.
Input Fields
sort_direction - SortEnumsort_field - RequisitionListSortableField!Example
{"sort_direction": "ASC", "sort_field": "NAME"}
RequisitionListSortableField
Values
NAMEUPDATED_ATExample
""NAME""
RequisitionLists
Defines customer requisition lists.
Fields
items - [RequisitionList]page_info - SearchResultPageInfosort_fields - SortFieldstotal_count - IntExample
{
"items": [RequisitionList],
"page_info": SearchResultPageInfo,
"sort_fields": SortFields,
"total_count": 123
}
RequistionListItems
Contains an array of items added to a requisition list.
Fields
items - [RequisitionListItemInterface]!page_info - SearchResultPageInfototal_pages - Int!Example
{
"items": [RequisitionListItemInterface],
"page_info": SearchResultPageInfo,
"total_pages": 123
}
Return
Contains details about a return.
Fields
available_shipping_carriers - [ReturnShippingCarrier]comments - [ReturnComment]created_at - String!customer - ReturnCustomer!items - [ReturnItem]number - String!order - CustomerOrdershipping - ReturnShippingstatus - ReturnStatusuid - ID!Example
{
"available_shipping_carriers": [ReturnShippingCarrier],
"comments": [ReturnComment],
"created_at": "abc123",
"customer": ReturnCustomer,
"items": [ReturnItem],
"number": "abc123",
"order": CustomerOrder,
"shipping": ReturnShipping,
"status": "PENDING",
"uid": "4"
}
ReturnComment
Contains details about a return comment.
Fields
author_name - String!created_at - String!text - String!uid - ID!Example
{
"author_name": "xyz789",
"created_at": "xyz789",
"text": "abc123",
"uid": "4"
}
ReturnCustomer
The customer information for the return.
Fields
email - String!firstname - Stringlastname - StringExample
{
"email": "xyz789",
"firstname": "abc123",
"lastname": "abc123"
}
ReturnItem
Contains details about a product being returned.
Fields
custom_attributesV2 - [AttributeValueInterface]order_item - OrderItemInterface!quantity - Float!request_quantity - Float!status - ReturnItemStatus!uid - ID!Example
{
"custom_attributesV2": [AttributeValueInterface],
"order_item": OrderItemInterface,
"quantity": 987.65,
"request_quantity": 987.65,
"status": "PENDING",
"uid": "4"
}
ReturnItemAttributeMetadata
Return Item attribute metadata.
Fields
code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnuminput_filter - InputFilterEnumis_required - Boolean!is_unique - Boolean!label - Stringmultiline_count - Intoptions - [CustomAttributeOptionInterface]!sort_order - Intvalidate_rules - [ValidationRule]Example
{
"code": 4,
"default_value": "abc123",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "xyz789",
"frontend_input": "BOOLEAN",
"input_filter": "NONE",
"is_required": true,
"is_unique": false,
"label": "xyz789",
"multiline_count": 123,
"options": [CustomAttributeOptionInterface],
"sort_order": 123,
"validate_rules": [ValidationRule]
}
ReturnItemStatus
Values
PENDINGAUTHORIZEDRECEIVEDAPPROVEDREJECTEDDENIEDExample
""PENDING""
ReturnShipping
Contains details about the return shipping address.
Fields
address - ReturnShippingAddresstracking - [ReturnShippingTracking]Example
{
"address": ReturnShippingAddress,
"tracking": [ReturnShippingTracking]
}
ReturnShippingAddress
Contains details about the shipping address used for receiving returned items.
Fields
city - String!contact_name - Stringcountry - Country!postcode - String!region - Region!street - [String]!telephone - StringExample
{
"city": "xyz789",
"contact_name": "abc123",
"country": Country,
"postcode": "xyz789",
"region": Region,
"street": ["abc123"],
"telephone": "xyz789"
}
ReturnShippingCarrier
Contains details about the carrier on a return.
Fields
label - String!uid - ID!Example
{
"label": "abc123",
"uid": "4"
}
ReturnShippingTracking
Contains shipping and tracking details.
Fields
carrier - ReturnShippingCarrier!status - ReturnShippingTrackingStatustracking_number - String!uid - ID!Example
{
"carrier": ReturnShippingCarrier,
"status": ReturnShippingTrackingStatus,
"tracking_number": "abc123",
"uid": "4"
}
ReturnShippingTrackingStatus
Contains the status of a shipment.
Fields
text - String!Example
{"text": "abc123", "type": "INFORMATION"}
ReturnShippingTrackingStatusType
Values
INFORMATIONERRORExample
""INFORMATION""
ReturnStatus
Values
PENDINGUNCONFIRMEDAUTHORIZEDPARTIALLY_AUTHORIZEDRECEIVEDPARTIALLY_RECEIVEDAPPROVEDPARTIALLY_APPROVEDREJECTEDPARTIALLY_REJECTEDDENIEDPROCESSED_AND_CLOSEDCLOSEDExample
""PENDING""
Returns
Contains a list of customer return requests.
Fields
items - [Return]page_info - SearchResultPageInfototal_count - IntExample
{
"items": [Return],
"page_info": SearchResultPageInfo,
"total_count": 123
}
RevokeCustomerTokenOutput
Contains the result of a request to revoke a customer token.
Fields
result - Boolean!Example
{"result": true}
RewardPoints
Contains details about a customer's reward points.
Fields
balance - RewardPointsAmountbalance_history - [RewardPointsBalanceHistoryItem]exchange_rates - RewardPointsExchangeRatessubscription_status - RewardPointsSubscriptionStatusExample
{
"balance": RewardPointsAmount,
"balance_history": [RewardPointsBalanceHistoryItem],
"exchange_rates": RewardPointsExchangeRates,
"subscription_status": RewardPointsSubscriptionStatus
}
RewardPointsAmount
Fields
money - Money!points - Float!Example
{"money": Money, "points": 123.45}
RewardPointsBalanceHistoryItem
Contain details about the reward points transaction.
Fields
balance - RewardPointsAmountchange_reason - String!date - String!points_change - Float!Example
{
"balance": RewardPointsAmount,
"change_reason": "xyz789",
"date": "xyz789",
"points_change": 987.65
}
RewardPointsExchangeRates
Lists the reward points exchange rates. The values depend on the customer group.
Fields
earning - RewardPointsRateredemption - RewardPointsRateExample
{
"earning": RewardPointsRate,
"redemption": RewardPointsRate
}
RewardPointsRate
Contains details about customer's reward points rate.
Fields
currency_amount - Float!points - Float!Example
{"currency_amount": 123.45, "points": 987.65}
RewardPointsSubscriptionStatus
Indicates whether the customer subscribes to reward points emails.
Fields
balance_updates - RewardPointsSubscriptionStatusesEnum!points_expiration_notifications - RewardPointsSubscriptionStatusesEnum!Example
{
"balance_updates": "SUBSCRIBED",
"points_expiration_notifications": "SUBSCRIBED"
}
RewardPointsSubscriptionStatusesEnum
Values
SUBSCRIBEDNOT_SUBSCRIBEDExample
""SUBSCRIBED""
SDKParams
Defines the name and value of a SDK parameter
Fields
name - Stringvalue - StringExample
{
"name": "xyz789",
"value": "abc123"
}
SalesCommentItem
Contains details about a comment.
Fields
message - String!timestamp - String!Example
{
"message": "xyz789",
"timestamp": "xyz789"
}
ScalarBucket
For use on string and other scalar product fields
Fields
count - Int!id - ID!title - String!Example
{
"count": 123,
"id": "4",
"title": "abc123"
}
ScopeTypeEnum
This enumeration defines the scope type for customer orders.
Values
GLOBALWEBSITESTOREExample
""GLOBAL""
SearchCategoryResultPage
Represents a paginated result set of category search results.
Fields
items - [CategoryTreeView!]!totalCount - Int!pageInfo - PageInfo!Example
{
"items": [CategoryTreeView],
"totalCount": 987,
"pageInfo": PageInfo
}
SearchClauseInput
A product attribute to filter on
Input Fields
attribute - String!contains - Stringeq - Stringin - [String]range - SearchRangeInputstartsWith - StringExample
{
"attribute": "xyz789",
"contains": "xyz789",
"eq": "abc123",
"in": ["xyz789"],
"range": SearchRangeInput,
"startsWith": "abc123"
}
SearchRangeInput
A range of numeric values for use in a search
Input Fields
from - Floatto - FloatExample
{"from": 123.45, "to": 123.45}
SearchResultPageInfo
Provides navigation for the query response.
Fields
current_page - Intpage_size - Inttotal_pages - IntExample
{"current_page": 123, "page_size": 987, "total_pages": 987}
SelectedBundleOption
Contains details about a selected bundle option.
Fields
label - String!type - String!uid - ID!values - [SelectedBundleOptionValue]!Example
{
"label": "xyz789",
"type": "xyz789",
"uid": 4,
"values": [SelectedBundleOptionValue]
}
SelectedBundleOptionValue
Contains details about a value for a selected bundle option.
Fields
label - String!original_price - Money!priceV2 - Money!quantity - Float!uid - ID!Example
{
"label": "xyz789",
"original_price": Money,
"priceV2": Money,
"quantity": 123.45,
"uid": 4
}
SelectedConfigurableOption
Contains details about a selected configurable option.
Fields
configurable_product_option_uid - ID!configurable_product_option_value_uid - ID!option_label - String!value_label - String!Example
{
"configurable_product_option_uid": "4",
"configurable_product_option_value_uid": 4,
"option_label": "abc123",
"value_label": "abc123"
}
SelectedCustomAttributeInput
Contains details about an attribute the buyer selected.
Input Fields
attribute_code - String!value - String!Example
{
"attribute_code": "abc123",
"value": "xyz789"
}
SelectedCustomizableOption
Identifies a customized product that has been placed in a cart.
Fields
customizable_option_uid - ID!is_required - Boolean!label - String!sort_order - Int!type - String!values - [SelectedCustomizableOptionValue]!Example
{
"customizable_option_uid": "4",
"is_required": true,
"label": "xyz789",
"sort_order": 987,
"type": "abc123",
"values": [SelectedCustomizableOptionValue]
}
SelectedCustomizableOptionValue
Identifies the value of the selected customized option.
Fields
customizable_option_value_uid - ID!label - String!value - String!Example
{
"customizable_option_value_uid": 4,
"label": "abc123",
"price": CartItemSelectedOptionValuePrice,
"value": "abc123"
}
SelectedPaymentMethod
Describes the payment method selected by the shopper.
Fields
code - String!oope_payment_method_config - OopePaymentMethodConfigpurchase_order_number - Stringtitle - String!Example
{
"code": "xyz789",
"oope_payment_method_config": OopePaymentMethodConfig,
"purchase_order_number": "xyz789",
"title": "xyz789"
}
SelectedShippingMethod
Contains details about the selected shipping method and carrier.
Fields
additional_data - [ShippingAdditionalData]amount - Money!carrier_code - String!carrier_title - String!method_code - String!method_title - String!price_excl_tax - Money!price_incl_tax - Money!Example
{
"additional_data": [ShippingAdditionalData],
"amount": Money,
"carrier_code": "xyz789",
"carrier_title": "xyz789",
"method_code": "xyz789",
"method_title": "abc123",
"price_excl_tax": Money,
"price_incl_tax": Money
}
SendNegotiableQuoteForReviewInput
Specifies which negotiable quote to send for review.
Input Fields
comment - NegotiableQuoteCommentInputquote_uid - ID!Example
{
"comment": NegotiableQuoteCommentInput,
"quote_uid": "4"
}
SendNegotiableQuoteForReviewOutput
Contains the negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetBillingAddressOnCartInput
Sets the billing address.
Input Fields
billing_address - BillingAddressInput!cart_id - String!Example
{
"billing_address": BillingAddressInput,
"cart_id": "xyz789"
}
SetBillingAddressOnCartOutput
Contains details about the cart after setting the billing address.
Fields
cart - Cart!Example
{"cart": Cart}
SetCartAsInactiveOutput
Sets the cart as inactive
Fields
error - Stringsuccess - Boolean!Example
{"error": "abc123", "success": true}
SetCustomAttributesOnCompanyInput
Defines the company custom attributes.
Input Fields
custom_attributes - [CustomAttributeInput]id - ID!Example
{
"custom_attributes": [CustomAttributeInput],
"id": "4"
}
SetCustomAttributesOnCompanyOutput
Contains the company.
Fields
company - CompanyExample
{"company": Company}
SetCustomAttributesOnNegotiableQuoteInput
Defines the negotiable quote custom attributes.
Input Fields
custom_attributes - [CustomAttributeInput]quote_uid - ID!Example
{
"custom_attributes": [CustomAttributeInput],
"quote_uid": "4"
}
SetCustomAttributesOnNegotiableQuoteOutput
Contains the negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetGiftOptionsOnCartInput
Defines the gift options applied to the cart.
Input Fields
cart_id - String!gift_message - GiftMessageInputgift_receipt_included - Boolean!gift_wrapping_id - IDprinted_card_included - Boolean!Example
{
"cart_id": "xyz789",
"gift_message": GiftMessageInput,
"gift_receipt_included": true,
"gift_wrapping_id": 4,
"printed_card_included": true
}
SetGiftOptionsOnCartOutput
Contains the cart after gift options have been applied.
Fields
cart - Cart!Example
{"cart": Cart}
SetGuestEmailOnCartInput
Defines the guest email and cart.
Input Fields
cart_id - String!email - String!Example
{
"cart_id": "abc123",
"email": "abc123"
}
SetGuestEmailOnCartOutput
Contains details about the cart after setting the email of a guest.
Fields
cart - Cart!Example
{"cart": Cart}
SetLineItemNoteOutput
Contains the updated negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetNegotiableQuoteBillingAddressInput
Sets the billing address.
Input Fields
billing_address - NegotiableQuoteBillingAddressInput!quote_uid - ID!Example
{
"billing_address": NegotiableQuoteBillingAddressInput,
"quote_uid": "4"
}
SetNegotiableQuoteBillingAddressOutput
Contains the negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetNegotiableQuotePaymentMethodInput
Defines the payment method of the specified negotiable quote.
Input Fields
payment_method - NegotiableQuotePaymentMethodInput!quote_uid - ID!Example
{
"payment_method": NegotiableQuotePaymentMethodInput,
"quote_uid": "4"
}
SetNegotiableQuotePaymentMethodOutput
Contains details about the negotiable quote after setting the payment method.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetNegotiableQuoteShippingAddressInput
Defines the shipping address to assign to the negotiable quote.
Input Fields
quote_uid - ID!shipping_addresses - [NegotiableQuoteShippingAddressInput]Example
{
"quote_uid": 4,
"shipping_addresses": [
NegotiableQuoteShippingAddressInput
]
}
SetNegotiableQuoteShippingAddressOutput
Contains the negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetNegotiableQuoteShippingMethodsInput
Defines the shipping method to apply to the negotiable quote.
Input Fields
quote_uid - ID!shipping_methods - [ShippingMethodInput]!Example
{
"quote_uid": 4,
"shipping_methods": [ShippingMethodInput]
}
SetNegotiableQuoteShippingMethodsOutput
Contains the negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
SetNegotiableQuoteTemplateShippingAddressInput
Defines the shipping address to assign to the negotiable quote template.
Input Fields
shipping_address - NegotiableQuoteTemplateShippingAddressInput!template_id - ID!Example
{
"shipping_address": NegotiableQuoteTemplateShippingAddressInput,
"template_id": 4
}
SetPaymentMethodOnCartInput
Applies a payment method to the cart.
Input Fields
cart_id - String!payment_method - PaymentMethodInput!Example
{
"cart_id": "abc123",
"payment_method": PaymentMethodInput
}
SetPaymentMethodOnCartOutput
Contains details about the cart after setting the payment method.
Fields
cart - Cart!Example
{"cart": Cart}
SetShippingAddressesOnCartInput
Specifies an array of addresses to use for shipping.
Input Fields
cart_id - String!shipping_addresses - [ShippingAddressInput]!Example
{
"cart_id": "xyz789",
"shipping_addresses": [ShippingAddressInput]
}
SetShippingAddressesOnCartOutput
Contains details about the cart after setting the shipping addresses.
Fields
cart - Cart!Example
{"cart": Cart}
SetShippingMethodsOnCartInput
Applies one or shipping methods to the cart.
Input Fields
cart_id - String!shipping_methods - [ShippingMethodInput]!Example
{
"cart_id": "xyz789",
"shipping_methods": [ShippingMethodInput]
}
SetShippingMethodsOnCartOutput
Contains details about the cart after setting the shipping methods.
Fields
cart - Cart!Example
{"cart": Cart}
ShareGiftRegistryInviteeInput
Defines a gift registry invitee.
Input Fields
email - String!name - String!Example
{
"email": "abc123",
"name": "xyz789"
}
ShareGiftRegistryOutput
Contains the results of a request to share a gift registry.
Fields
is_shared - Boolean!Example
{"is_shared": false}
ShareGiftRegistrySenderInput
Defines the sender of an invitation to view a gift registry.
Input Fields
message - String!name - String!Example
{
"message": "abc123",
"name": "abc123"
}
ShipBundleItemsEnum
Defines whether bundle items must be shipped together.
Values
TOGETHERSEPARATELYExample
""TOGETHER""
ShipmentItem
Fields
id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_shipped - Float!Example
{
"id": "4",
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_shipped": 987.65
}
ShipmentItemInterface
Order shipment item details.
Fields
id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_shipped - Float!Possible Types
Example
{
"id": "4",
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_shipped": 987.65
}
ShipmentTracking
Contains order shipment tracking details.
Fields
carrier - String!number - Stringtitle - String!Example
{
"carrier": "xyz789",
"number": "xyz789",
"title": "abc123"
}
ShippingAdditionalData
A simple key value object.
Fields
Example
{
"key": "xyz789",
"value": "xyz789"
}
ShippingAddressInput
Defines a single shipping address.
Input Fields
address - CartAddressInputcustomer_address_id - Intcustomer_address_uid - IDcustomer_notes - Stringpickup_location_code - StringExample
{
"address": CartAddressInput,
"customer_address_id": 123,
"customer_address_uid": 4,
"customer_notes": "xyz789",
"pickup_location_code": "abc123"
}
ShippingCartAddress
Contains shipping addresses and methods.
Fields
available_shipping_methods - [AvailableShippingMethod]cart_items_v2 - [CartItemInterface]city - String!company - Stringcountry - CartAddressCountry!custom_attributes - [AttributeValueInterface]!customer_address_uid - IDcustomer_notes - Stringfax - Stringfirstname - String!id - Intlastname - String!middlename - Stringpickup_location_code - Stringpostcode - Stringprefix - Stringregion - CartAddressRegionsame_as_billing - Boolean!selected_shipping_method - SelectedShippingMethodstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringExample
{
"available_shipping_methods": [AvailableShippingMethod],
"cart_items_v2": [CartItemInterface],
"city": "xyz789",
"company": "abc123",
"country": CartAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": "4",
"customer_notes": "xyz789",
"fax": "abc123",
"firstname": "xyz789",
"id": 987,
"lastname": "xyz789",
"middlename": "xyz789",
"pickup_location_code": "abc123",
"postcode": "xyz789",
"prefix": "xyz789",
"region": CartAddressRegion,
"same_as_billing": false,
"selected_shipping_method": SelectedShippingMethod,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "xyz789",
"uid": "4",
"vat_id": "abc123"
}
ShippingDiscount
Defines an individual shipping discount. This discount can be applied to shipping.
Fields
amount - Money!Example
{"amount": Money}
ShippingHandling
Contains details about shipping and handling costs.
Fields
amount_excluding_tax - Moneyamount_including_tax - Moneydiscounts - [ShippingDiscount]taxes - [TaxItem]total_amount - Money!Example
{
"amount_excluding_tax": Money,
"amount_including_tax": Money,
"discounts": [ShippingDiscount],
"taxes": [TaxItem],
"total_amount": Money
}
ShippingMethodInput
Defines the shipping carrier and method.
Input Fields
carrier_code - String!method_code - String!Example
{
"carrier_code": "abc123",
"method_code": "abc123"
}
SimpleCartItem
An implementation for simple product cart items.
Fields
available_gift_wrapping - [GiftWrapping]!custom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]gift_message - GiftMessagegift_wrapping - GiftWrappingis_available - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!Example
{
"available_gift_wrapping": [GiftWrapping],
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"is_available": false,
"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": 123.45,
"uid": 4
}
SimpleProduct
Defines a simple product, which is tangible and is usually sold in single units or in fixed quantities.
Fields
canonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions - [CustomizableOptionInterface]options_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]product_links - [ProductLinksInterface]quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!upsell_products - [ProductInterface]url_key - Stringweight - FloatExample
{
"canonical_url": "abc123",
"categories": [CategoryInterface],
"country_of_manufacture": "abc123",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": false,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"manufacturer": 987,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "xyz789",
"meta_keyword": "abc123",
"meta_title": "xyz789",
"min_sale_qty": 987.65,
"name": "xyz789",
"new_from_date": "abc123",
"new_to_date": "xyz789",
"only_x_left_in_stock": 987.65,
"options": [CustomizableOptionInterface],
"options_container": "abc123",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 987.65,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "xyz789",
"stock_status": "IN_STOCK",
"swatch_image": "xyz789",
"thumbnail": ProductImage,
"uid": "4",
"upsell_products": [ProductInterface],
"url_key": "xyz789",
"weight": 123.45
}
SimpleProductView
Represents a single-SKU product without selectable variants. Because there are no variant combinations, pricing is returned as a single price (not a price range).
Fields
addToCartAllowed - BooleaninStock - BooleanlowStock - Booleanattributes - [ProductViewAttribute]description - Stringid - ID!images - [ProductViewImage]videos - [ProductViewVideo]inputOptions - [ProductViewInputOption]lastModifiedAt - DateTimemetaDescription - StringmetaKeyword - StringmetaTitle - Stringname - Stringprice - ProductViewPriceshortDescription - Stringsku - StringexternalId - Stringurl - StringurlKey - Stringlinks - [ProductViewLink]categories - [CategoryProductView!]queryType - Stringvisibility - StringExample
{
"addToCartAllowed": false,
"inStock": true,
"lowStock": false,
"attributes": [ProductViewAttribute],
"description": "abc123",
"id": 4,
"images": [ProductViewImage],
"videos": [ProductViewVideo],
"inputOptions": [ProductViewInputOption],
"lastModifiedAt": "2007-12-03T10:15:30Z",
"metaDescription": "abc123",
"metaKeyword": "xyz789",
"metaTitle": "xyz789",
"name": "abc123",
"price": ProductViewPrice,
"shortDescription": "abc123",
"sku": "abc123",
"externalId": "abc123",
"url": "xyz789",
"urlKey": "abc123",
"links": [ProductViewLink],
"categories": [CategoryProductView],
"queryType": "xyz789",
"visibility": "abc123"
}
SimpleRequisitionListItem
Contains details about simple products added to a requisition list.
Fields
customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!sku - String!uid - ID!Example
{
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 123.45,
"sku": "abc123",
"uid": 4
}
SimpleWishlistItem
Contains a simple product wish list item.
Fields
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!product - ProductInterface!quantity - Float!Example
{
"added_at": "xyz789",
"customizable_options": [SelectedCustomizableOption],
"description": "abc123",
"id": "4",
"product": ProductInterface,
"quantity": 123.45
}
SmartButtonMethodInput
Smart button payment inputs
Input Fields
payment_source - Stringpayments_order_id - Stringpaypal_order_id - StringExample
{
"payment_source": "xyz789",
"payments_order_id": "xyz789",
"paypal_order_id": "abc123"
}
SmartButtonsConfig
Fields
app_switch_when_available - Booleanbutton_styles - ButtonStylescode - Stringdisplay_message - Booleandisplay_venmo - Booleanis_visible - Booleanmessage_styles - MessageStylespayment_intent - Stringsdk_params - [SDKParams]sort_order - Stringtitle - StringExample
{
"app_switch_when_available": true,
"button_styles": ButtonStyles,
"code": "abc123",
"display_message": true,
"display_venmo": false,
"is_visible": true,
"message_styles": MessageStyles,
"payment_intent": "abc123",
"sdk_params": [SDKParams],
"sort_order": "abc123",
"title": "xyz789"
}
SortEnum
Indicates whether to return results in ascending or descending order.
Values
ASCDESCExample
""ASC""
SortField
Defines a possible sort field.
Fields
label - Stringvalue - StringExample
{
"label": "abc123",
"value": "xyz789"
}
SortFields
Contains a default value for sort fields and all available sort fields.
Fields
default - Stringoptions - [SortField]Example
{
"default": "abc123",
"options": [SortField]
}
SortQuoteItemsEnum
Specifies the field to use for sorting quote items
Values
ITEM_IDCREATED_ATUPDATED_ATPRODUCT_IDSKUNAMEDESCRIPTIONWEIGHTQTYPRICEBASE_PRICECUSTOM_PRICEDISCOUNT_PERCENTDISCOUNT_AMOUNTBASE_DISCOUNT_AMOUNTTAX_PERCENTTAX_AMOUNTBASE_TAX_AMOUNTROW_TOTALBASE_ROW_TOTALROW_TOTAL_WITH_DISCOUNTROW_WEIGHTPRODUCT_TYPEBASE_TAX_BEFORE_DISCOUNTTAX_BEFORE_DISCOUNTORIGINAL_CUSTOM_PRICEPRICE_INC_TAXBASE_PRICE_INC_TAXROW_TOTAL_INC_TAXBASE_ROW_TOTAL_INC_TAXDISCOUNT_TAX_COMPENSATION_AMOUNTBASE_DISCOUNT_TAX_COMPENSATION_AMOUNTFREE_SHIPPINGExample
""ITEM_ID""
SortableAttribute
Contains product attributes that be used for sorting in a productSearch query
Fields
attribute - String!frontendInput - Stringlabel - Stringnumeric - BooleanExample
{
"attribute": "abc123",
"frontendInput": "xyz789",
"label": "xyz789",
"numeric": false
}
StatsBucket
For retrieving statistics across multiple buckets
Fields
max - Float!min - Float!title - String!Example
{
"max": 987.65,
"min": 987.65,
"title": "abc123"
}