OrderItem

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.
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_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": false,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "product": ProductInterface,
  "product_name": "xyz789",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "product_type": "abc123",
  "product_url_key": "abc123",
  "quantity_canceled": 987.65,
  "quantity_invoiced": 123.45,
  "quantity_ordered": 987.65,
  "quantity_refunded": 987.65,
  "quantity_returned": 987.65,
  "quantity_shipped": 987.65,
  "selected_options": [OrderItemOption],
  "status": "abc123"
}

OrderItemInterface

Order item details.

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.
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_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.

Possible Types

Example

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

OrderItemOption

Represents order item options like selected or entered.

Fields

Field Name
Description
label - String!
The name of the option.
value - String!
The value of the option.

Example

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

OrderPaymentMethod

Contains details about the payment method used to pay for the order.

Fields

Field Name
Description
additional_data - [KeyValue]
Additional data per payment method type.
name - String!
The label that describes the payment method.
type - String!
The payment method code that indicates how the order was paid for.

Example

{
  "additional_data": [KeyValue],
  "name": "abc123",
  "type": "abc123"
}

OrderShipment

Contains order shipment details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments added to the shipment.
id - ID!
The unique ID for a `OrderShipment` object.
items - [ShipmentItemInterface]
An array of items included in the shipment.
number - String!
The sequential credit shipment number.
tracking - [ShipmentTracking]
An array of shipment tracking details.

Example

{
  "comments": [SalesCommentItem],
  "id": 4,
  "items": [ShipmentItemInterface],
  "number": "xyz789",
  "tracking": [ShipmentTracking]
}

OrderTokenInput

Input to retrieve an order based on token.

Input Fields

Input Field
Description
token - String!
Order token.

Example

{"token": "abc123"}

OrderTotal

Contains details about the sales total amounts used to calculate the final price.

Fields

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

Example

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

PayflowExpressInput

Contains required input for Payflow Express Checkout payments.

Input Fields

Input Field
Description
payer_id - String!
The unique ID of the PayPal user.
token - String!
The token returned by the createPaypalExpressToken mutation.

Example

{
  "payer_id": "xyz789",
  "token": "xyz789"
}

PayflowLinkInput

A set of relative URLs that PayPal uses in response to various actions during the authorization process. Adobe Commerce prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Payflow Link and Payments Advanced payment methods.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
error_url - String!
The relative URL of the transaction error page that PayPal redirects to upon payment error. If the full URL to this page is https://www.example.com/paypal/action/error.html, the relative URL is paypal/action/error.html.
return_url - String!
The relative URL of the order confirmation page that PayPal redirects to when the payment is successful and additional confirmation is not needed. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.

Example

{
  "cancel_url": "abc123",
  "error_url": "xyz789",
  "return_url": "xyz789"
}

PayflowLinkMode

Indicates the mode for payment. Applies to the Payflow Link and Payments Advanced payment methods.

Values

Enum Value
Description
TEST
LIVE

Example

""TEST""

PayflowLinkToken

Contains information used to generate PayPal iframe for transaction. Applies to Payflow Link and Payments Advanced payment methods.

Fields

Field Name
Description
mode - PayflowLinkMode
The mode for the Payflow transaction.
paypal_url - String
The PayPal URL used for requesting a Payflow form.
secure_token - String
The secure token generated by PayPal.
secure_token_id - String
The secure token ID generated by PayPal.

Example

{
  "mode": "TEST",
  "paypal_url": "abc123",
  "secure_token": "xyz789",
  "secure_token_id": "abc123"
}

PayflowLinkTokenInput

Contains information required to fetch payment token information for the Payflow Link and Payments Advanced payment methods.

Input Fields

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

Example

{"cart_id": "abc123"}

PayflowProInput

Contains input for the Payflow Pro and Payments Pro payment methods.

Input Fields

Input Field
Description
cc_details - CreditCardDetailsInput!
Required input for credit card related information.
is_active_payment_token_enabler - Boolean
Indicates whether details about the shopper's credit/debit card should be tokenized for later usage. Required only if Vault is enabled for the PayPal Payflow Pro payment integration.

Example

{
  "cc_details": CreditCardDetailsInput,
  "is_active_payment_token_enabler": false
}

PayflowProResponseInput

Input required to complete payment. Applies to Payflow Pro and Payments Pro payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.
paypal_payload - String!
The payload returned from PayPal.

Example

{
  "cart_id": "xyz789",
  "paypal_payload": "xyz789"
}

PayflowProResponseOutput

Fields

Field Name
Description
cart - Cart!
The cart with the updated selected payment method.

Example

{"cart": Cart}

PayflowProTokenInput

Contains input required to fetch payment token information for the Payflow Pro and Payments Pro payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.
urls - PayflowProUrlInput!
A set of relative URLs that PayPal uses for callback.

Example

{
  "cart_id": "xyz789",
  "urls": PayflowProUrlInput
}

PayflowProUrlInput

Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for the Payflow Pro and Payment Pro payment methods.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
error_url - String!
The relative URL of the transaction error page that PayPal redirects to upon payment error. If the full URL to this page is https://www.example.com/paypal/action/error.html, the relative URL is paypal/action/error.html.
return_url - String!
The relative URL of the final confirmation page that PayPal redirects to upon payment success. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.

Example

{
  "cancel_url": "abc123",
  "error_url": "abc123",
  "return_url": "abc123"
}

PaymentConfigItem

Contains payment fields that are common to all types of payment methods.

Fields

Field Name
Description
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
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

Possible Types

Example

{
  "code": "abc123",
  "is_visible": false,
  "payment_intent": "xyz789",
  "sdk_params": [SDKParams],
  "sort_order": "xyz789",
  "title": "xyz789"
}

PaymentConfigOutput

Retrieves the payment configuration for a given location

Fields

Field Name
Description
apple_pay - ApplePayConfig
ApplePay payment method configuration
google_pay - GooglePayConfig
GooglePay payment method configuration
hosted_fields - HostedFieldsConfig
Hosted fields payment method configuration
smart_buttons - SmartButtonsConfig
Smart Buttons payment method configuration

Example

{
  "apple_pay": ApplePayConfig,
  "google_pay": GooglePayConfig,
  "hosted_fields": HostedFieldsConfig,
  "smart_buttons": SmartButtonsConfig
}

PaymentLocation

Defines the origin location for that payment request

Values

Enum Value
Description
PRODUCT_DETAIL
MINICART
CART
CHECKOUT
ADMIN

Example

""PRODUCT_DETAIL""

PaymentMethodInput

Defines the payment method.

Input Fields

Input Field
Description
braintree - BraintreeInput
braintree_ach_direct_debit - BraintreeInput
braintree_ach_direct_debit_vault - BraintreeVaultInput
braintree_applepay_vault - BraintreeVaultInput
braintree_cc_vault - BraintreeCcVaultInput
braintree_googlepay_vault - BraintreeVaultInput
braintree_paypal - BraintreeInput
braintree_paypal_vault - BraintreeVaultInput
code - String!
The internal name for the payment method.
hosted_pro - HostedProInput
Required input for PayPal Hosted pro payments.
payflow_express - PayflowExpressInput
Required input for Payflow Express Checkout payments.
payflow_link - PayflowLinkInput
Required input for PayPal Payflow Link and Payments Advanced payments.
payflowpro - PayflowProInput
Required input for PayPal Payflow Pro and Payment Pro payments.
payflowpro_cc_vault - VaultTokenInput
Required input for PayPal Payflow Pro vault payments.
payment_services_paypal_apple_pay - ApplePayMethodInput
Required input for Apple Pay button
payment_services_paypal_google_pay - GooglePayMethodInput
Required input for Google Pay button
payment_services_paypal_hosted_fields - HostedFieldsInput
Required input for Hosted Fields
payment_services_paypal_smart_buttons - SmartButtonMethodInput
Required input for Smart buttons
payment_services_paypal_vault - VaultMethodInput
Required input for vault
paypal_express - PaypalExpressInput
Required input for Express Checkout and Payments Standard payments.
purchase_order_number - String
The purchase order number. Optional for most payment methods.

Example

{
  "braintree": BraintreeInput,
  "braintree_ach_direct_debit": BraintreeInput,
  "braintree_ach_direct_debit_vault": BraintreeVaultInput,
  "braintree_applepay_vault": BraintreeVaultInput,
  "braintree_cc_vault": BraintreeCcVaultInput,
  "braintree_googlepay_vault": BraintreeVaultInput,
  "braintree_paypal": BraintreeInput,
  "braintree_paypal_vault": BraintreeVaultInput,
  "code": "xyz789",
  "hosted_pro": HostedProInput,
  "payflow_express": PayflowExpressInput,
  "payflow_link": PayflowLinkInput,
  "payflowpro": PayflowProInput,
  "payflowpro_cc_vault": VaultTokenInput,
  "payment_services_paypal_apple_pay": ApplePayMethodInput,
  "payment_services_paypal_google_pay": GooglePayMethodInput,
  "payment_services_paypal_hosted_fields": HostedFieldsInput,
  "payment_services_paypal_smart_buttons": SmartButtonMethodInput,
  "payment_services_paypal_vault": VaultMethodInput,
  "paypal_express": PaypalExpressInput,
  "purchase_order_number": "abc123"
}

PaymentOrderOutput

Contains the payment order details

Fields

Field Name
Description
id - String
PayPal order ID
mp_order_id - String
The order ID generated by Payment Services
payment_source_details - PaymentSourceDetails
Details about the card used on the order
status - String
The status of the payment order

Example

{
  "id": "xyz789",
  "mp_order_id": "xyz789",
  "payment_source_details": PaymentSourceDetails,
  "status": "xyz789"
}

PaymentSDKParamsItem

Fields

Field Name
Description
code - String
The payment method code used in the order
params - [SDKParams]
The payment SDK parameters

Example

{
  "code": "abc123",
  "params": [SDKParams]
}

PaymentSourceDetails

Fields

Field Name
Description
card - Card
Details about the card used on the order

Example

{"card": Card}

PaymentToken

The stored payment method available to the customer.

Fields

Field Name
Description
details - String
A description of the stored account details.
payment_method_code - String!
The payment method code associated with the token.
public_hash - String!
The public hash of the token.
type - PaymentTokenTypeEnum!
Specifies the payment token type.

Example

{
  "details": "abc123",
  "payment_method_code": "xyz789",
  "public_hash": "xyz789",
  "type": "card"
}

PaymentTokenTypeEnum

The list of available payment token types.

Values

Enum Value
Description
card
phpcs:ignore Magento2.GraphQL.ValidArgumentName
account
phpcs:ignore Magento2.GraphQL.ValidArgumentName

Example

""card""

PaypalExpressInput

Contains required input for Express Checkout and Payments Standard payments.

Input Fields

Input Field
Description
payer_id - String!
The unique ID of the PayPal user.
token - String!
The token returned by the `createPaypalExpressToken` mutation.

Example

{
  "payer_id": "xyz789",
  "token": "abc123"
}

PaypalExpressTokenInput

Defines the attributes required to receive a payment token for Express Checkout and Payments Standard payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.
code - String!
The payment method code.
express_button - Boolean
Indicates whether the buyer selected the quick checkout button. The default value is false.
urls - PaypalExpressUrlsInput!
A set of relative URLs that PayPal uses in response to various actions during the authorization process.
use_paypal_credit - Boolean
Indicates whether the buyer clicked the PayPal credit button. The default value is false.

Example

{
  "cart_id": "abc123",
  "code": "xyz789",
  "express_button": false,
  "urls": PaypalExpressUrlsInput,
  "use_paypal_credit": false
}

PaypalExpressTokenOutput

Contains the token returned by PayPal and a set of URLs that allow the buyer to authorize payment and adjust checkout details. Applies to Express Checkout and Payments Standard payment methods.

Fields

Field Name
Description
paypal_urls - PaypalExpressUrlList
A set of URLs that allow the buyer to authorize payment and adjust checkout details.
token - String
The token returned by PayPal.

Example

{
  "paypal_urls": PaypalExpressUrlList,
  "token": "abc123"
}

PaypalExpressUrlList

Contains a set of URLs that allow the buyer to authorize payment and adjust checkout details for Express Checkout and Payments Standard transactions.

Fields

Field Name
Description
edit - String
The PayPal URL that allows the buyer to edit their checkout details.
start - String
The URL to the PayPal login page.

Example

{
  "edit": "abc123",
  "start": "xyz789"
}

PaypalExpressUrlsInput

Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Express Checkout and Payments Standard payment methods.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
pending_url - String
The relative URL of the page that PayPal redirects to when the payment has been put on hold for additional review. This condition mostly applies to ACH transactions, and is not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success_pending.html, the relative URL is paypal/action/success_pending.html.
return_url - String!
The relative URL of the final confirmation page that PayPal redirects to upon payment success. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.
success_url - String
The relative URL of the order confirmation page that PayPal redirects to when the payment is successful and additional confirmation is not needed. Not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success.html, the relative URL is paypal/action/success.html.

Example

{
  "cancel_url": "xyz789",
  "pending_url": "xyz789",
  "return_url": "xyz789",
  "success_url": "abc123"
}

PhysicalProductInterface

Contains attributes specific to tangible products.

Fields

Field Name
Description
weight - Float
The weight of the item, in units defined by the store.

Possible Types

Example

{"weight": 123.45}

PickupLocation

Defines Pickup Location information.

Fields

Field Name
Description
city - String
contact_name - String
country_id - String
description - String
email - String
fax - String
latitude - Float
longitude - Float
name - String
phone - String
pickup_location_code - String
postcode - String
region - String
region_id - Int
street - String

Example

{
  "city": "abc123",
  "contact_name": "abc123",
  "country_id": "abc123",
  "description": "xyz789",
  "email": "abc123",
  "fax": "abc123",
  "latitude": 123.45,
  "longitude": 987.65,
  "name": "abc123",
  "phone": "abc123",
  "pickup_location_code": "xyz789",
  "postcode": "xyz789",
  "region": "xyz789",
  "region_id": 123,
  "street": "xyz789"
}

PickupLocationFilterInput

PickupLocationFilterInput defines the list of attributes and filters for the search.

Input Fields

Input Field
Description
city - FilterTypeInput
Filter by city.
country_id - FilterTypeInput
Filter by country.
name - FilterTypeInput
Filter by pickup location name.
pickup_location_code - FilterTypeInput
Filter by pickup location code.
postcode - FilterTypeInput
Filter by postcode.
region - FilterTypeInput
Filter by region.
region_id - FilterTypeInput
Filter by region id.
street - FilterTypeInput
Filter by street.

Example

{
  "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

Input Field
Description
city - SortEnum
City where pickup location is placed.
contact_name - SortEnum
Name of the contact person.
country_id - SortEnum
Id of the country in two letters.
description - SortEnum
Description of the pickup location.
distance - SortEnum
Distance to the address, requested by distance filter. Applicable only with distance filter. If distance sort order is present, all other sort orders will be ignored.
email - SortEnum
Contact email of the pickup location.
fax - SortEnum
Contact fax of the pickup location.
latitude - SortEnum
Geographic latitude where pickup location is placed.
longitude - SortEnum
Geographic longitude where pickup location is placed.
name - SortEnum
The pickup location name. Customer use this to identify the pickup location.
phone - SortEnum
Contact phone number of the pickup location.
pickup_location_code - SortEnum
A code assigned to pickup location to identify the source.
postcode - SortEnum
Postcode where pickup location is placed.
region - SortEnum
Name of the region.
region_id - SortEnum
Id of the region.
street - SortEnum
Street where pickup location is placed.

Example

{
  "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

Field Name
Description
items - [PickupLocation]
An array of pickup locations that match the specific search request.
page_info - SearchResultPageInfo
An object that includes the page_info and currentPage values specified in the query.
total_count - Int
The number of products returned.

Example

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

PlaceNegotiableQuoteOrderInput

Specifies the negotiable quote to convert to an order.

Input Fields

Input Field
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"quote_uid": 4}

PlaceNegotiableQuoteOrderOutput

An output object that returns the generated order.

Fields

Field Name
Description
order - Order!
Contains the generated order number.

Example

{"order": Order}

PlaceOrderError

An error encountered while placing an order.

Fields

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

Example

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

PlaceOrderErrorCodes

Values

Enum Value
Description
CART_NOT_FOUND
CART_NOT_ACTIVE
GUEST_EMAIL_MISSING
UNABLE_TO_PLACE_ORDER
UNDEFINED

Example

""CART_NOT_FOUND""

PlaceOrderForPurchaseOrderInput

Specifies the purchase order to convert to an order.

Input Fields

Input Field
Description
purchase_order_uid - ID!
The unique ID of a purchase order.

Example

{"purchase_order_uid": 4}

PlaceOrderForPurchaseOrderOutput

Contains the results of the request to place an order.

Fields

Field Name
Description
order - CustomerOrder!
Placed order.

Example

{"order": CustomerOrder}

PlaceOrderInput

Specifies the quote to be converted to an order.

Input Fields

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

Example

{"cart_id": "abc123"}

PlaceOrderOutput

Contains the results of the request to place an order.

Fields

Field Name
Description
errors - [PlaceOrderError]!
An array of place order errors.
order - Order
The ID of the order. (Deprecated: Use `orderV2` instead.)
orderV2 - CustomerOrder
Full order information.

Example

{
  "errors": [PlaceOrderError],
  "order": Order,
  "orderV2": CustomerOrder
}

PlacePurchaseOrderInput

Specifies the quote to be converted to a purchase order.

Input Fields

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

Example

{"cart_id": "xyz789"}

PlacePurchaseOrderOutput

Contains the results of the request to place a purchase order.

Fields

Field Name
Description
purchase_order - PurchaseOrder!
Placed purchase order.

Example

{"purchase_order": PurchaseOrder}

Price

Deprecated. Use ProductPrice instead. Defines the price of a product as well as any tax-related adjustments.

Fields

Field Name
Description
adjustments - [PriceAdjustment]
An array that provides information about tax, weee, or weee_tax adjustments. (Deprecated: Use `ProductPrice` instead.)
amount - Money
The price of a product plus a three-letter currency code. (Deprecated: Use `ProductPrice` instead.)

Example

{
  "adjustments": [PriceAdjustment],
  "amount": Money
}

PriceAdjustment

Deprecated. Taxes will be included or excluded in the price. Defines the amount of money to apply as an adjustment, the type of adjustment to apply, and whether the item is included or excluded from the adjustment.

Fields

Field Name
Description
amount - Money
The amount of the price adjustment and its currency code.
code - PriceAdjustmentCodesEnum
Indicates whether the adjustment involves tax, weee, or weee_tax. (Deprecated: `PriceAdjustment` is deprecated.)
description - PriceAdjustmentDescriptionEnum
Indicates whether the entity described by the code attribute is included or excluded from the adjustment. (Deprecated: `PriceAdjustment` is deprecated.)

Example

{
  "amount": Money,
  "code": "TAX",
  "description": "INCLUDED"
}

PriceAdjustmentCodesEnum

PriceAdjustment.code is deprecated.

Values

Enum Value
Description
TAX
(Deprecated: `PriceAdjustmentCodesEnum` is deprecated. Tax is included or excluded in the price. Tax is not shown separately in Catalog.)
WEEE
(Deprecated: WEEE code is deprecated. Use `fixed_product_taxes.label` instead.)
WEEE_TAX
(Deprecated: Use `fixed_product_taxes` instead. Tax is included or excluded in price. The tax is not shown separtely in Catalog.)

Example

""TAX""

PriceAdjustmentDescriptionEnum

PriceAdjustmentDescriptionEnum is deprecated. States whether a price adjustment is included or excluded.

Values

Enum Value
Description
INCLUDED
EXCLUDED

Example

""INCLUDED""

PriceDetails

Can be used to retrieve the main price details in case of bundle product

Fields

Field Name
Description
discount_percentage - Float
The percentage of discount applied to the main product price
main_final_price - Float
The final price after applying the discount to the main product
main_price - Float
The regular price of the main product

Example

{
  "discount_percentage": 123.45,
  "main_final_price": 123.45,
  "main_price": 987.65
}

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

Field Name
Description
maximum_price - ProductPrice
The highest possible price for the product.
minimum_price - ProductPrice!
The lowest possible price for the product.

Example

{
  "maximum_price": ProductPrice,
  "minimum_price": ProductPrice
}

PriceTypeEnum

Defines the price type.

Values

Enum Value
Description
FIXED
PERCENT
DYNAMIC

Example

""FIXED""

PriceViewEnum

Defines whether a bundle product's price is displayed as the lowest possible value or as a range.

Values

Enum Value
Description
PRICE_RANGE
AS_LOW_AS

Example

""PRICE_RANGE""

ProductAttribute

Contains a product attribute code and value.

Fields

Field Name
Description
code - String!
The unique identifier for a product attribute code.
value - String!
The display value of the attribute.

Example

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

ProductAttributeFilterInput

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_id - FilterEqualTypeInput
Deprecated: use `category_uid` to filter product by category ID.
category_uid - FilterEqualTypeInput
Filter product by the unique ID for a `CategoryInterface` object.
category_url_path - FilterEqualTypeInput
Filter product by category URL path.
description - FilterMatchTypeInput
Attribute label: Description
name - FilterMatchTypeInput
Attribute label: Product Name
price - FilterRangeTypeInput
Attribute label: Price
short_description - FilterMatchTypeInput
Attribute label: Short Description
sku - FilterEqualTypeInput
Attribute label: SKU
url_key - FilterEqualTypeInput
The part of the URL that identifies the product

Example

{
  "category_id": FilterEqualTypeInput,
  "category_uid": FilterEqualTypeInput,
  "category_url_path": FilterEqualTypeInput,
  "description": FilterMatchTypeInput,
  "name": FilterMatchTypeInput,
  "price": FilterRangeTypeInput,
  "short_description": FilterMatchTypeInput,
  "sku": FilterEqualTypeInput,
  "url_key": FilterEqualTypeInput
}

ProductAttributeSortInput

Specifies the attribute to use for sorting search results and indicates whether the results are sorted in ascending or descending order. It's possible to sort products using searchable attributes with enabled 'Use in Filter Options' option

Input Fields

Input Field
Description
name - SortEnum
Attribute label: Product Name
position - SortEnum
Sort by the position assigned to each product.
price - SortEnum
Attribute label: Price
relevance - SortEnum
Sort by the search relevance score (default).

Example

{"name": "ASC", "position": "ASC", "price": "ASC", "relevance": "ASC"}

ProductCustomAttributes

Product custom attributes

Fields

Field Name
Description
errors - [AttributeMetadataError]!
Errors when retrieving custom attributes metadata.
items - [AttributeValueInterface]!
Requested custom attributes

Example

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

ProductDiscount

Contains the discount applied to a product price.

Fields

Field Name
Description
amount_off - Float
The actual value of the discount.
percent_off - Float
The discount expressed a percentage.

Example

{"amount_off": 123.45, "percent_off": 987.65}

ProductFilterInput

ProductFilterInput is deprecated, use @ProductAttributeFilterInput instead. ProductFilterInput 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_id - FilterTypeInput
The category ID the product belongs to.
country_of_manufacture - FilterTypeInput
The product's country of origin.
created_at - FilterTypeInput
The timestamp indicating when the product was created.
custom_layout - FilterTypeInput
The name of a custom layout.
custom_layout_update - FilterTypeInput
XML code that is applied as a layout update to the product page.
description - FilterTypeInput
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - FilterTypeInput
Indicates whether a gift message is available.
has_options - FilterTypeInput
Indicates whether additional attributes have been created for the product.
image - FilterTypeInput
The relative path to the main image on the product page.
image_label - FilterTypeInput
The label assigned to a product image.
is_returnable - FilterTypeInput
Indicates whether the product can be returned.
manufacturer - FilterTypeInput
A number representing the product's manufacturer.
max_price - FilterTypeInput
The numeric maximal price of the product. Do not include the currency code.
meta_description - FilterTypeInput
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - FilterTypeInput
A comma-separated list of keywords that are visible only to search engines.
meta_title - FilterTypeInput
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_price - FilterTypeInput
The numeric minimal price of the product. Do not include the currency code.
name - FilterTypeInput
The product name. Customers use this name to identify the product.
news_from_date - FilterTypeInput
The beginning date for new product listings, and determines if the product is featured as a new product.
news_to_date - FilterTypeInput
The end date for new product listings.
options_container - FilterTypeInput
If the product has multiple options, determines where they appear on the product page.
or - ProductFilterInput
The keyword required to perform a logical OR comparison.
price - FilterTypeInput
The price of an item.
required_options - FilterTypeInput
Indicates whether the product has required options.
short_description - FilterTypeInput
A short description of the product. Its use depends on the theme.
sku - FilterTypeInput
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - FilterTypeInput
The relative path to the small image, which is used on catalog pages.
small_image_label - FilterTypeInput
The label assigned to a product's small image.
special_from_date - FilterTypeInput
The beginning date that a product has a special price.
special_price - FilterTypeInput
The discounted price of the product. Do not include the currency code.
special_to_date - FilterTypeInput
The end date that a product has a special price.
swatch_image - FilterTypeInput
The file name of a swatch image.
thumbnail - FilterTypeInput
The relative path to the product's thumbnail image.
thumbnail_label - FilterTypeInput
The label assigned to a product's thumbnail image.
tier_price - FilterTypeInput
The price when tier pricing is in effect and the items purchased threshold has been reached.
updated_at - FilterTypeInput
The timestamp indicating when the product was updated.
url_key - FilterTypeInput
The part of the URL that identifies the product
url_path - FilterTypeInput
weight - FilterTypeInput
The weight of the item, in units defined by the store.

Example

{
  "category_id": FilterTypeInput,
  "country_of_manufacture": FilterTypeInput,
  "created_at": FilterTypeInput,
  "custom_layout": FilterTypeInput,
  "custom_layout_update": FilterTypeInput,
  "description": FilterTypeInput,
  "gift_message_available": FilterTypeInput,
  "has_options": FilterTypeInput,
  "image": FilterTypeInput,
  "image_label": FilterTypeInput,
  "is_returnable": FilterTypeInput,
  "manufacturer": FilterTypeInput,
  "max_price": FilterTypeInput,
  "meta_description": FilterTypeInput,
  "meta_keyword": FilterTypeInput,
  "meta_title": FilterTypeInput,
  "min_price": FilterTypeInput,
  "name": FilterTypeInput,
  "news_from_date": FilterTypeInput,
  "news_to_date": FilterTypeInput,
  "options_container": FilterTypeInput,
  "or": ProductFilterInput,
  "price": FilterTypeInput,
  "required_options": FilterTypeInput,
  "short_description": FilterTypeInput,
  "sku": FilterTypeInput,
  "small_image": FilterTypeInput,
  "small_image_label": FilterTypeInput,
  "special_from_date": FilterTypeInput,
  "special_price": FilterTypeInput,
  "special_to_date": FilterTypeInput,
  "swatch_image": FilterTypeInput,
  "thumbnail": FilterTypeInput,
  "thumbnail_label": FilterTypeInput,
  "tier_price": FilterTypeInput,
  "updated_at": FilterTypeInput,
  "url_key": FilterTypeInput,
  "url_path": FilterTypeInput,
  "weight": FilterTypeInput
}

ProductImage

Contains product image information, including the image URL and label.

Fields

Field Name
Description
disabled - Boolean
Indicates whether the image is hidden from view.
label - String
The label of the product image or video.
position - Int
The media item's position after it has been sorted.
url - String
The URL of the product image or video.

Example

{
  "disabled": true,
  "label": "xyz789",
  "position": 123,
  "url": "xyz789"
}

ProductInfoInput

Product Information used for Pickup Locations search.

Input Fields

Input Field
Description
sku - String!
Product SKU.

Example

{"sku": "abc123"}

ProductInterface

Contains fields that are common to all types of products.

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.
gift_message_available - String
Indicates whether a gift message is available.
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.)
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.
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_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.
rating_summary - Float!
The average of all the ratings given to the product.
related_products - [ProductInterface]
An array of related products.
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_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.)

Possible Types

Example

{
  "attribute_set_id": 123,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "color": 987,
  "country_of_manufacture": "xyz789",
  "created_at": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": "abc123",
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 987,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options_container": "xyz789",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "rating_summary": 987.65,
  "related_products": [ProductInterface],
  "review_count": 987,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 987.65,
  "special_to_date": "abc123",
  "staged": false,
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type_id": "abc123",
  "uid": "4",
  "updated_at": "abc123",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "websites": [Website]
}

An implementation of ProductLinksInterface.

Fields

Field Name
Description
link_type - String
One of related, associated, upsell, or crosssell.
linked_product_sku - String
The SKU of the linked product.
linked_product_type - String
The type of linked product (simple, virtual, bundle, downloadable, grouped, configurable).
position - Int
The position within the list of product links.
sku - String
The identifier of the linked product.

Example

{
  "link_type": "xyz789",
  "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

Field Name
Description
link_type - String
One of related, associated, upsell, or crosssell.
linked_product_sku - String
The SKU of the linked product.
linked_product_type - String
The type of linked product (simple, virtual, bundle, downloadable, grouped, configurable).
position - Int
The position within the list of product links.
sku - String
The identifier of the linked product.

Possible Types

ProductLinksInterface Types
ProductLinks

Example

{
  "link_type": "abc123",
  "linked_product_sku": "xyz789",
  "linked_product_type": "abc123",
  "position": 987,
  "sku": "abc123"
}

ProductMediaGalleryEntriesContent

Contains an image in base64 format and basic information about the image.

Fields

Field Name
Description
base64_encoded_data - String
The image in base64 format.
name - String
The file name of the image.
type - String
The MIME type of the file, such as image/png.

Example

{
  "base64_encoded_data": "xyz789",
  "name": "abc123",
  "type": "abc123"
}

ProductMediaGalleryEntriesVideoContent

Contains a link to a video file and basic information about the video.

Fields

Field Name
Description
media_type - String
Must be external-video.
video_description - String
A description of the video.
video_metadata - String
Optional data about the video.
video_provider - String
Describes the video source.
video_title - String
The title of the video.
video_url - String
The URL to the video.

Example

{
  "media_type": "xyz789",
  "video_description": "abc123",
  "video_metadata": "xyz789",
  "video_provider": "abc123",
  "video_title": "xyz789",
  "video_url": "abc123"
}

ProductPrice

Represents a product price.

Fields

Field Name
Description
discount - ProductDiscount
The price discount. Represents the difference between the regular and final price.
final_price - Money!
The final price of the product after applying discounts.
fixed_product_taxes - [FixedProductTax]
An array of the multiple Fixed Product Taxes that can be applied to a product price.
regular_price - Money!
The regular price of the product.

Example

{
  "discount": ProductDiscount,
  "final_price": Money,
  "fixed_product_taxes": [FixedProductTax],
  "regular_price": Money
}

ProductPrices

Deprecated. Use PriceRange instead. Contains the regular price of an item, as well as its minimum and maximum prices. Only composite products, which include bundle, configurable, and grouped products, can contain a minimum and maximum price.

Fields

Field Name
Description
maximalPrice - Price
The highest possible final price for all the options defined within a composite product. If you are specifying a price range, this would be the `to` value. (Deprecated: Use `PriceRange.maximum_price` instead.)
minimalPrice - Price
The lowest possible final price for all the options defined within a composite product. If you are specifying a price range, this would be the `from` value. (Deprecated: Use `PriceRange.minimum_price` instead.)
regularPrice - Price
The base price of a product. (Deprecated: Use `regular_price` from `PriceRange.minimum_price` or `PriceRange.maximum_price` instead.)

Example

{
  "maximalPrice": Price,
  "minimalPrice": Price,
  "regularPrice": Price
}

ProductReview

Contains details of a product review.

Fields

Field Name
Description
average_rating - Float!
The average of all ratings for this product.
created_at - String!
The date the review was created.
nickname - String!
The customer's nickname. Defaults to the customer name, if logged in.
product - ProductInterface!
The reviewed product.
ratings_breakdown - [ProductReviewRating]!
An array of ratings by rating category, such as quality, price, and value.
summary - String!
The summary (title) of the review.
text - String!
The review text.

Example

{
  "average_rating": 123.45,
  "created_at": "xyz789",
  "nickname": "abc123",
  "product": ProductInterface,
  "ratings_breakdown": [ProductReviewRating],
  "summary": "xyz789",
  "text": "abc123"
}

ProductReviewRating

Contains data about a single aspect of a product review.

Fields

Field Name
Description
name - String!
The label assigned to an aspect of a product that is being rated, such as quality or price.
value - String!
The rating value given by customer. By default, possible values range from 1 to 5.

Example

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

ProductReviewRatingInput

Contains the reviewer's rating for a single aspect of a review.

Input Fields

Input Field
Description
id - String!
An encoded rating ID.
value_id - String!
An encoded rating value ID.

Example

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

ProductReviewRatingMetadata

Contains details about a single aspect of a product review.

Fields

Field Name
Description
id - String!
An encoded rating ID.
name - String!
The label assigned to an aspect of a product that is being rated, such as quality or price.
values - [ProductReviewRatingValueMetadata]!
List of product review ratings sorted by position.

Example

{
  "id": "xyz789",
  "name": "xyz789",
  "values": [ProductReviewRatingValueMetadata]
}

ProductReviewRatingValueMetadata

Contains details about a single value in a product review.

Fields

Field Name
Description
value - String!
A ratings scale, such as the number of stars awarded.
value_id - String!
An encoded rating value ID.

Example

{
  "value": "abc123",
  "value_id": "xyz789"
}

ProductReviewRatingsMetadata

Contains an array of metadata about each aspect of a product review.

Fields

Field Name
Description
items - [ProductReviewRatingMetadata]!
An array of product reviews sorted by position.

Example

{"items": [ProductReviewRatingMetadata]}

ProductReviews

Contains an array of product reviews.

Fields

Field Name
Description
items - [ProductReview]!
An array of product reviews.
page_info - SearchResultPageInfo!
Metadata for pagination rendering.

Example

{
  "items": [ProductReview],
  "page_info": SearchResultPageInfo
}

ProductStockStatus

This enumeration states whether a product stock status is in stock or out of stock

Values

Enum Value
Description
IN_STOCK
OUT_OF_STOCK

Example

""IN_STOCK""

ProductTierPrices

Deprecated. Use TierPrice instead. Defines a tier price, which is a quantity discount offered to a specific customer group.

Fields

Field Name
Description
customer_group_id - String
The ID of the customer group. (Deprecated: Not relevant for the storefront.)
percentage_value - Float
The percentage discount of the item. (Deprecated: Use `TierPrice.discount` instead.)
qty - Float
The number of items that must be purchased to qualify for tier pricing. (Deprecated: Use `TierPrice.quantity` instead.)
value - Float
The price of the fixed price item. (Deprecated: Use `TierPrice.final_price` instead.)
website_id - Float
The ID assigned to the website. (Deprecated: Not relevant for the storefront.)

Example

{
  "customer_group_id": "xyz789",
  "percentage_value": 123.45,
  "qty": 987.65,
  "value": 987.65,
  "website_id": 987.65
}

ProductVideo

Contains information about a product video.

Fields

Field Name
Description
disabled - Boolean
Indicates whether the image is hidden from view.
label - String
The label of the product image or video.
position - Int
The media item's position after it has been sorted.
url - String
The URL of the product image or video.
video_content - ProductMediaGalleryEntriesVideoContent
Contains a `ProductMediaGalleryEntriesVideoContent` object.

Example

{
  "disabled": true,
  "label": "xyz789",
  "position": 987,
  "url": "abc123",
  "video_content": ProductMediaGalleryEntriesVideoContent
}

Products

Contains the results of a products query.

Fields

Field Name
Description
aggregations - [Aggregation]
A bucket that contains the attribute code and label for each filterable option.
filters - [LayerFilter]
Layered navigation filters array. (Deprecated: Use `aggregations` instead.)
items - [ProductInterface]
An array of products that match the specified search criteria.
page_info - SearchResultPageInfo
An object that includes the page_info and currentPage values specified in the query.
sort_fields - SortFields
An object that includes the default sort field and all available sort fields.
suggestions - [SearchSuggestion]
An array of search suggestions for case when search query have no results.
total_count - Int
The number of products that are marked as visible. By default, in complex products, parent products are visible, but their child products are not.

Example

{
  "aggregations": [Aggregation],
  "filters": [LayerFilter],
  "items": [ProductInterface],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "suggestions": [SearchSuggestion],
  "total_count": 987
}

PurchaseOrder

Contains details about a purchase order.

Fields

Field Name
Description
approval_flow - [PurchaseOrderRuleApprovalFlow]!
The approval flows for each applied rules.
available_actions - [PurchaseOrderAction]!
Purchase order actions available to the customer. Can be used to display action buttons on the client.
comments - [PurchaseOrderComment]!
The set of comments applied to the purchase order.
created_at - String!
The date the purchase order was created.
created_by - Customer
The company user who created the purchase order.
history_log - [PurchaseOrderHistoryItem]!
The log of the events related to the purchase order.
number - String!
The purchase order number.
order - CustomerOrder
The reference to the order placed based on the purchase order.
quote - Cart
The quote related to the purchase order.
status - PurchaseOrderStatus!
The current status of the purchase order.
uid - ID!
A unique identifier for the purchase order.
updated_at - String!
The date the purchase order was last updated.

Example

{
  "approval_flow": [PurchaseOrderRuleApprovalFlow],
  "available_actions": ["REJECT"],
  "comments": [PurchaseOrderComment],
  "created_at": "abc123",
  "created_by": Customer,
  "history_log": [PurchaseOrderHistoryItem],
  "number": "abc123",
  "order": CustomerOrder,
  "quote": Cart,
  "status": "PENDING",
  "uid": "4",
  "updated_at": "abc123"
}

PurchaseOrderAction

Values

Enum Value
Description
REJECT
CANCEL
VALIDATE
APPROVE
PLACE_ORDER

Example

""REJECT""

PurchaseOrderActionError

Contains details about a failed action.

Fields

Field Name
Description
message - String!
The returned error message.
type - PurchaseOrderErrorType!
The error type.

Example

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

PurchaseOrderApprovalFlowEvent

Contains details about a single event in the approval flow of the purchase order.

Fields

Field Name
Description
message - String
A formatted message.
name - String
The approver name.
role - String
The approver role.
status - PurchaseOrderApprovalFlowItemStatus
The status related to the event.
updated_at - String
The date and time the event was updated.

Example

{
  "message": "abc123",
  "name": "abc123",
  "role": "xyz789",
  "status": "PENDING",
  "updated_at": "abc123"
}

PurchaseOrderApprovalFlowItemStatus

Values

Enum Value
Description
PENDING
APPROVED
REJECTED

Example

""PENDING""

PurchaseOrderApprovalRule

Contains details about a purchase order approval rule.

Fields

Field Name
Description
applies_to_roles - [CompanyRole]!
The name of the user(s) affected by the the purchase order approval rule.
approver_roles - [CompanyRole]!
The name of the user who needs to approve purchase orders that trigger the approval rule.
condition - PurchaseOrderApprovalRuleConditionInterface
Condition which triggers the approval rule.
created_at - String!
The date the purchase order rule was created.
created_by - String!
The name of the user who created the purchase order approval rule.
description - String
Description of the purchase order approval rule.
name - String!
The name of the purchase order approval rule.
status - PurchaseOrderApprovalRuleStatus!
The status of the purchase order approval rule.
uid - ID!
The unique identifier for the purchase order approval rule.
updated_at - String!
The date the purchase order rule was last updated.

Example

{
  "applies_to_roles": [CompanyRole],
  "approver_roles": [CompanyRole],
  "condition": PurchaseOrderApprovalRuleConditionInterface,
  "created_at": "xyz789",
  "created_by": "xyz789",
  "description": "xyz789",
  "name": "xyz789",
  "status": "ENABLED",
  "uid": 4,
  "updated_at": "xyz789"
}

PurchaseOrderApprovalRuleConditionAmount

Contains approval rule condition details, including the amount to be evaluated.

Fields

Field Name
Description
amount - Money!
The amount to be be used for evaluation of the approval rule condition.
attribute - PurchaseOrderApprovalRuleType
The type of purchase order approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator
The operator to be used for evaluating the approval rule condition.

Example

{
  "amount": Money,
  "attribute": "GRAND_TOTAL",
  "operator": "MORE_THAN"
}

PurchaseOrderApprovalRuleConditionInterface

Purchase order rule condition details.

Fields

Field Name
Description
attribute - PurchaseOrderApprovalRuleType
The type of purchase order approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator
The operator to be used for evaluating the approval rule condition.

Possible Types

Example

{"attribute": "GRAND_TOTAL", "operator": "MORE_THAN"}

PurchaseOrderApprovalRuleConditionOperator

Values

Enum Value
Description
MORE_THAN
LESS_THAN
MORE_THAN_OR_EQUAL_TO
LESS_THAN_OR_EQUAL_TO

Example

""MORE_THAN""

PurchaseOrderApprovalRuleConditionQuantity

Contains approval rule condition details, including the quantity to be evaluated.

Fields

Field Name
Description
attribute - PurchaseOrderApprovalRuleType
The type of purchase order approval rule.
operator - PurchaseOrderApprovalRuleConditionOperator
The operator to be used for evaluating the approval rule condition.
quantity - Int
The quantity to be used for evaluation of the approval rule condition.

Example

{"attribute": "GRAND_TOTAL", "operator": "MORE_THAN", "quantity": 123}

PurchaseOrderApprovalRuleInput

Defines a new purchase order approval rule.

Input Fields

Input Field
Description
applies_to - [ID]!
A list of company user role IDs to which this purchase order approval rule should be applied. When an empty array is provided, the rule is applied to all user roles in the system, including those created in the future.
approvers - [ID]!
A list of B2B user roles that can approve this purchase order approval rule.
condition - CreatePurchaseOrderApprovalRuleConditionInput!
The condition of the purchase order approval rule.
description - String
A summary of the purpose of the purchase order approval rule.
name - String!
The purchase order approval rule name.
status - PurchaseOrderApprovalRuleStatus!
The status of the purchase order approval rule.

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

Field Name
Description
available_applies_to - [CompanyRole]!
A list of B2B user roles that the rule can be applied to.
available_condition_currencies - [AvailableCurrency]!
A list of currencies that can be used to create approval rules based on amounts, for example shipping cost rules.
available_requires_approval_from - [CompanyRole]!
A list of B2B user roles that can be specified as approvers for the approval rules.

Example

{
  "available_applies_to": [CompanyRole],
  "available_condition_currencies": [AvailableCurrency],
  "available_requires_approval_from": [CompanyRole]
}

PurchaseOrderApprovalRuleStatus

Values

Enum Value
Description
ENABLED
DISABLED

Example

""ENABLED""

PurchaseOrderApprovalRuleType

Values

Enum Value
Description
GRAND_TOTAL
SHIPPING_INCL_TAX
NUMBER_OF_SKUS

Example

""GRAND_TOTAL""

PurchaseOrderApprovalRules

Contains the approval rules that the customer can see.

Fields

Field Name
Description
items - [PurchaseOrderApprovalRule]!
A list of purchase order approval rules visible to the customer.
page_info - SearchResultPageInfo
Result pagination details.
total_count - Int
The total number of purchase order approval rules visible to the customer.

Example

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

PurchaseOrderComment

Contains details about a comment.

Fields

Field Name
Description
author - Customer
The user who left the comment.
created_at - String!
The date and time when the comment was created.
text - String!
The text of the comment.
uid - ID!
A unique identifier of the comment.

Example

{
  "author": Customer,
  "created_at": "xyz789",
  "text": "abc123",
  "uid": 4
}

PurchaseOrderErrorType

Values

Enum Value
Description
NOT_FOUND
OPERATION_NOT_APPLICABLE
COULD_NOT_SAVE
NOT_VALID_DATA
UNDEFINED

Example

""NOT_FOUND""

PurchaseOrderHistoryItem

Contains details about a status change.

Fields

Field Name
Description
activity - String!
The activity type of the event.
created_at - String!
The date and time when the event happened.
message - String!
The message representation of the event.
uid - ID!
A unique identifier of the purchase order history item.

Example

{
  "activity": "abc123",
  "created_at": "xyz789",
  "message": "xyz789",
  "uid": "4"
}

PurchaseOrderRuleApprovalFlow

Contains details about approval roles applied to the purchase order and status changes.

Fields

Field Name
Description
events - [PurchaseOrderApprovalFlowEvent]!
The approval flow event related to the rule.
rule_name - String!
The name of the applied rule.

Example

{
  "events": [PurchaseOrderApprovalFlowEvent],
  "rule_name": "abc123"
}

PurchaseOrderStatus

Values

Enum Value
Description
PENDING
APPROVAL_REQUIRED
APPROVED
ORDER_IN_PROGRESS
ORDER_PLACED
ORDER_FAILED
REJECTED
CANCELED
APPROVED_PENDING_PAYMENT

Example

""PENDING""

PurchaseOrders

Contains a list of purchase orders.

Fields

Field Name
Description
items - [PurchaseOrder]!
Purchase orders matching the search criteria.
page_info - SearchResultPageInfo
Page information of search result's current page.
total_count - Int
Total number of purchase orders found matching the search criteria.

Example

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

PurchaseOrdersActionInput

Defines which purchase orders to act on.

Input Fields

Input Field
Description
purchase_order_uids - [ID]!
An array of purchase order UIDs.

Example

{"purchase_order_uids": ["4"]}

PurchaseOrdersActionOutput

Returns a list of updated purchase orders and any error messages.

Fields

Field Name
Description
errors - [PurchaseOrderActionError]!
An array of error messages encountered while performing the operation.
purchase_orders - [PurchaseOrder]!
A list of purchase orders.

Example

{
  "errors": [PurchaseOrderActionError],
  "purchase_orders": [PurchaseOrder]
}

PurchaseOrdersFilterInput

Defines the criteria to use to filter the list of purchase orders.

Input Fields

Input Field
Description
company_purchase_orders - Boolean
Include only purchase orders made by subordinate company users.
created_date - FilterRangeTypeInput
Filter by the creation date of the purchase order.
require_my_approval - Boolean
Include only purchase orders that are waiting for the customer’s approval.
status - PurchaseOrderStatus
Filter by the status of the purchase order.

Example

{
  "company_purchase_orders": true,
  "created_date": FilterRangeTypeInput,
  "require_my_approval": false,
  "status": "PENDING"
}

QuoteItemsSortInput

Specifies the field to use for sorting quote items

Input Fields

Input Field
Description
field - SortQuoteItemsEnum!
Specifies the quote items field to sort by
order - SortEnum!
Specifies the order of quote items' sorting

Example

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

QuoteTemplateLineItemNoteInput

Sets quote item note.

Input Fields

Input Field
Description
item_id - ID!
The unique ID of a `CartLineItem` object.
note - String
The note text to be added.
templateId - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "item_id": "4",
  "note": "xyz789",
  "templateId": "4"
}

QuoteTemplateNotificationMessage

Contains a notification message for a negotiable quote template.

Fields

Field Name
Description
message - String!
The notification message.
type - String!
The type of notification message.

Example

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

ReCaptchaConfigurationV3

Contains reCAPTCHA V3-Invisible configuration details.

Fields

Field Name
Description
badge_position - String!
The position of the invisible reCAPTCHA badge on each page.
failure_message - String!
The message that appears to the user if validation fails.
forms - [ReCaptchaFormEnum]!
A list of forms on the storefront that have been configured to use reCAPTCHA V3.
is_enabled - Boolean!
Return whether recaptcha is enabled or not
language_code - String
A two-character code that specifies the language that is used for Google reCAPTCHA text and messaging.
minimum_score - Float!
The minimum score that identifies a user interaction as a potential risk.
website_key - String!
The website key generated when the Google reCAPTCHA account was registered.

Example

{
  "badge_position": "xyz789",
  "failure_message": "abc123",
  "forms": ["PLACE_ORDER"],
  "is_enabled": true,
  "language_code": "xyz789",
  "minimum_score": 987.65,
  "website_key": "xyz789"
}

ReCaptchaFormEnum

Values

Enum Value
Description
PLACE_ORDER
CONTACT
CUSTOMER_LOGIN
CUSTOMER_FORGOT_PASSWORD
CUSTOMER_CREATE
CUSTOMER_EDIT
NEWSLETTER
PRODUCT_REVIEW
SENDFRIEND
BRAINTREE

Example

""PLACE_ORDER""

Region

Fields

Field Name
Description
code - String
The two-letter code for the region, such as TX for Texas.
id - Int
The unique ID for a `Region` object.
name - String
The name of the region, such as Texas.

Example

{
  "code": "xyz789",
  "id": 987,
  "name": "abc123"
}

RemoveCouponFromCartInput

Specifies the cart from which to remove a coupon.

Input Fields

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

Example

{"cart_id": "xyz789"}

RemoveCouponFromCartOutput

Contains details about the cart after removing a coupon.

Fields

Field Name
Description
cart - Cart
The cart after removing a coupon.

Example

{"cart": Cart}

RemoveCouponsFromCartInput

Remove coupons from the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
coupon_codes - [String]!
An array of coupon codes to be removed from the quote. If coupon_codes is empty all coupons will be removed from the quote.

Example

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

RemoveGiftCardFromCartInput

Defines the input required to run the removeGiftCardFromCart 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 removed to the cart.

Example

{
  "cart_id": "xyz789",
  "gift_card_code": "xyz789"
}

RemoveGiftCardFromCartOutput

Defines the possible output for the removeGiftCardFromCart mutation.

Fields

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

Example

{"cart": Cart}

RemoveGiftRegistryItemsOutput

Contains the results of a request to remove an item from a gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after removing items.

Example

{"gift_registry": GiftRegistry}

RemoveGiftRegistryOutput

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

Fields

Field Name
Description
success - Boolean!
Indicates whether the gift registry was successfully deleted.

Example

{"success": true}

RemoveGiftRegistryRegistrantsOutput

Contains the results of a request to delete a registrant.

Fields

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

Example

{"gift_registry": GiftRegistry}

RemoveItemFromCartInput

Specifies which items to remove from the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
cart_item_id - Int
Deprecated. Use `cart_item_uid` instead.
cart_item_uid - ID
Required field. The unique ID for a `CartItemInterface` object.

Example

{
  "cart_id": "abc123",
  "cart_item_id": 123,
  "cart_item_uid": 4
}

RemoveItemFromCartOutput

Contains details about the cart after removing an item.

Fields

Field Name
Description
cart - Cart!
The cart after removing an item.

Example

{"cart": Cart}

RemoveNegotiableQuoteItemsInput

Defines the items to remove from the specified negotiable quote.

Input Fields

Input Field
Description
quote_item_uids - [ID]!
An array of IDs indicating which items to remove from the negotiable quote.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "quote_item_uids": ["4"],
  "quote_uid": "4"
}

RemoveNegotiableQuoteItemsOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after removing items.

Example

{"quote": NegotiableQuote}

RemoveNegotiableQuoteTemplateItemsInput

Defines the items to remove from the specified negotiable quote.

Input Fields

Input Field
Description
item_uids - [ID]!
An array of IDs indicating which items to remove from the negotiable quote.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "item_uids": ["4"],
  "template_id": "4"
}

RemoveProductsFromCompareListInput

Defines which products to remove from a compare list.

Input Fields

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

Example

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

RemoveProductsFromWishlistOutput

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

Fields

Field Name
Description
user_errors - [WishListUserInputError]!
An array of errors encountered while deleting products from a wish list.
wishlist - Wishlist!
Contains the wish list with after items were successfully deleted.

Example

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

RemoveReturnTrackingInput

Defines the tracking information to delete.

Input Fields

Input Field
Description
return_shipping_tracking_uid - ID!
The unique ID for a `ReturnShippingTracking` object.

Example

{"return_shipping_tracking_uid": 4}

RemoveReturnTrackingOutput

Contains the response after deleting tracking information.

Fields

Field Name
Description
return - Return
Contains details about the modified return.

Example

{"return": Return}

RemoveRewardPointsFromCartOutput

Contains the customer cart.

Fields

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

Example

{"cart": Cart}

RemoveStoreCreditFromCartInput

Defines the input required to run the removeStoreCreditFromCart mutation.

Input Fields

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

Example

{"cart_id": "xyz789"}

RemoveStoreCreditFromCartOutput

Defines the possible output for the removeStoreCreditFromCart mutation.

Fields

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

Example

{"cart": Cart}

RenameNegotiableQuoteInput

Sets new name for a negotiable quote.

Input Fields

Input Field
Description
quote_comment - String
The reason for the quote name change specified by the buyer.
quote_name - String!
The new quote name the buyer specified to the negotiable quote request.
quote_uid - ID!
The cart ID of the buyer requesting a new negotiable quote.

Example

{
  "quote_comment": "xyz789",
  "quote_name": "xyz789",
  "quote_uid": 4
}

RenameNegotiableQuoteOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after updating the name.

Example

{"quote": NegotiableQuote}

ReorderItemsOutput

Contains the cart and any errors after adding products.

Fields

Field Name
Description
cart - Cart!
Detailed information about the customer's cart.
userInputErrors - [CheckoutUserInputError]!
An array of reordering errors.

Example

{
  "cart": Cart,
  "userInputErrors": [CheckoutUserInputError]
}

RequestNegotiableQuoteInput

Defines properties of a negotiable quote request.

Input Fields

Input Field
Description
cart_id - ID!
The cart ID of the buyer requesting a new negotiable quote.
comment - NegotiableQuoteCommentInput!
Comments the buyer entered to describe the request.
is_draft - Boolean
Flag indicating if quote is draft or not.
quote_name - String!
The name the buyer assigned to the negotiable quote request.

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

Field Name
Description
quote - NegotiableQuote
Details about the negotiable quote.

Example

{"quote": NegotiableQuote}

RequestNegotiableQuoteTemplateInput

Defines properties of a negotiable quote template request.

Input Fields

Input Field
Description
cart_id - ID!
The cart ID of the quote to create the new negotiable quote template from.

Example

{"cart_id": 4}

RequestReturnInput

Contains information needed to start a return request.

Input Fields

Input Field
Description
comment_text - String
Text the buyer entered that describes the reason for the refund request.
contact_email - String
The email address the buyer enters to receive notifications about the status of the return.
items - [RequestReturnItemInput]!
An array of items to be returned.
order_uid - ID!
The unique ID for a `Order` object.

Example

{
  "comment_text": "abc123",
  "contact_email": "xyz789",
  "items": [RequestReturnItemInput],
  "order_uid": 4
}

RequestReturnItemInput

Contains details about an item to be returned.

Input Fields

Input Field
Description
entered_custom_attributes - [EnteredCustomAttributeInput]
Details about a custom attribute that was entered.
order_item_uid - ID!
The unique ID for a `OrderItemInterface` object.
quantity_to_return - Float!
The quantity of the item to be returned.
selected_custom_attributes - [SelectedCustomAttributeInput]
An array of selected custom option IDs associated with the item to be returned. For example, the IDs for the selected color and size of a configurable product.

Example

{
  "entered_custom_attributes": [
    EnteredCustomAttributeInput
  ],
  "order_item_uid": "4",
  "quantity_to_return": 123.45,
  "selected_custom_attributes": [
    SelectedCustomAttributeInput
  ]
}

RequestReturnOutput

Contains the response to a return request.

Fields

Field Name
Description
return - Return
Details about a single return request.
returns - Returns
An array of return requests.

Example

{
  "return": Return,
  "returns": Returns
}

RequisitionList

Defines the contents of a requisition list.

Fields

Field Name
Description
description - String
Optional text that describes the requisition list.
items - RequistionListItems
An array of products added to the requisition list.
items_count - Int!
The number of items in the list.
name - String!
The requisition list name.
uid - ID!
The unique requisition list ID.
updated_at - String
The time of the last modification of the requisition list.

Example

{
  "description": "abc123",
  "items": RequistionListItems,
  "items_count": 123,
  "name": "xyz789",
  "uid": 4,
  "updated_at": "abc123"
}

RequisitionListFilterInput

Defines requisition list filters.

Input Fields

Input Field
Description
name - FilterMatchTypeInput
Filter by the display name of the requisition list.
uids - FilterEqualTypeInput
Filter requisition lists by one or more requisition list IDs.

Example

{
  "name": FilterMatchTypeInput,
  "uids": FilterEqualTypeInput
}

RequisitionListItemInterface

The interface for requisition list items.

Fields

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

Possible Types

Example

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

RequisitionListItemsInput

Defines the items to add.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
Entered option IDs.
parent_sku - String
For configurable products, the SKU of the parent product.
quantity - Float
The quantity of the product to add.
selected_options - [String]
Selected option IDs.
sku - String!
The product SKU.

Example

{
  "entered_options": [EnteredOptionInput],
  "parent_sku": "xyz789",
  "quantity": 123.45,
  "selected_options": ["xyz789"],
  "sku": "xyz789"
}

RequisitionLists

Defines customer requisition lists.

Fields

Field Name
Description
items - [RequisitionList]
An array of requisition lists.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int
The number of returned requisition lists.

Example

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

RequistionListItems

Contains an array of items added to a requisition list.

Fields

Field Name
Description
items - [RequisitionListItemInterface]!
An array of items in the requisition list.
page_info - SearchResultPageInfo
Pagination metadata.
total_pages - Int!
The number of pages returned.

Example

{
  "items": [RequisitionListItemInterface],
  "page_info": SearchResultPageInfo,
  "total_pages": 123
}

Return

Contains details about a return.

Fields

Field Name
Description
available_shipping_carriers - [ReturnShippingCarrier]
A list of shipping carriers available for returns.
comments - [ReturnComment]
A list of comments posted for the return request.
created_at - String!
The date the return was requested.
customer - ReturnCustomer!
Data from the customer who created the return request.
items - [ReturnItem]
A list of items being returned.
number - String!
A human-readable return number.
order - CustomerOrder
The order associated with the return.
shipping - ReturnShipping
Shipping information for the return.
status - ReturnStatus
The status of the return request.
uid - ID!
The unique ID for a `Return` object.

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

Field Name
Description
author_name - String!
The name or author who posted the comment.
created_at - String!
The date and time the comment was posted.
text - String!
The contents of the comment.
uid - ID!
The unique ID for a `ReturnComment` object.

Example

{
  "author_name": "abc123",
  "created_at": "xyz789",
  "text": "abc123",
  "uid": 4
}

ReturnCustomAttribute

Contains details about a ReturnCustomerAttribute object.

Fields

Field Name
Description
label - String!
A description of the attribute.
uid - ID!
The unique ID for a `ReturnCustomAttribute` object.
value - String!
A JSON-encoded value of the attribute.

Example

{
  "label": "abc123",
  "uid": "4",
  "value": "xyz789"
}

ReturnCustomer

The customer information for the return.

Fields

Field Name
Description
email - String!
The email address of the customer.
firstname - String
The first name of the customer.
lastname - String
The last name of the customer.

Example

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

ReturnItem

Contains details about a product being returned.

Fields

Field Name
Description
custom_attributes - [ReturnCustomAttribute]
Return item custom attributes that are visible on the storefront. (Deprecated: Use custom_attributesV2 instead.)
custom_attributesV2 - [AttributeValueInterface]
Custom attributes that are visible on the storefront.
order_item - OrderItemInterface!
Provides access to the product being returned, including information about selected and entered options.
quantity - Float!
The quantity of the item the merchant authorized to be returned.
request_quantity - Float!
The quantity of the item requested to be returned.
status - ReturnItemStatus!
The return status of the item.
uid - ID!
The unique ID for a `ReturnItem` object.

Example

{
  "custom_attributes": [ReturnCustomAttribute],
  "custom_attributesV2": [AttributeValueInterface],
  "order_item": OrderItemInterface,
  "quantity": 987.65,
  "request_quantity": 987.65,
  "status": "PENDING",
  "uid": 4
}

ReturnItemAttributeMetadata

Return Item attribute metadata.

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.
input_filter - InputFilterEnum
The template used for the input of the attribute (e.g., 'date').
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.
multiline_count - Int
The number of lines of the attribute value.
options - [CustomAttributeOptionInterface]!
Attribute options.
sort_order - Int
The position of the attribute in the form.
validate_rules - [ValidationRule]
The validation rules of the attribute value.

Example

{
  "code": 4,
  "default_value": "abc123",
  "entity_type": "CATALOG_PRODUCT",
  "frontend_class": "abc123",
  "frontend_input": "BOOLEAN",
  "input_filter": "NONE",
  "is_required": false,
  "is_unique": true,
  "label": "abc123",
  "multiline_count": 123,
  "options": [CustomAttributeOptionInterface],
  "sort_order": 123,
  "validate_rules": [ValidationRule]
}

ReturnItemStatus

Values

Enum Value
Description
PENDING
AUTHORIZED
RECEIVED
APPROVED
REJECTED
DENIED

Example

""PENDING""

ReturnShipping

Contains details about the return shipping address.

Fields

Field Name
Description
address - ReturnShippingAddress
The merchant-defined return shipping address.
tracking - [ReturnShippingTracking]
The unique ID for a `ReturnShippingTracking` object. If a single UID is specified, the array contains a single tracking record. Otherwise, array contains all tracking information.

Example

{
  "address": ReturnShippingAddress,
  "tracking": [ReturnShippingTracking]
}

ReturnShippingAddress

Contains details about the shipping address used for receiving returned items.

Fields

Field Name
Description
city - String!
The city for product returns.
contact_name - String
The merchant's contact person.
country - Country!
An object that defines the country for product returns.
postcode - String!
The postal code for product returns.
region - Region!
An object that defines the state or province for product returns.
street - [String]!
The street address for product returns.
telephone - String
The telephone number for product returns.

Example

{
  "city": "xyz789",
  "contact_name": "xyz789",
  "country": Country,
  "postcode": "xyz789",
  "region": Region,
  "street": ["abc123"],
  "telephone": "xyz789"
}

ReturnShippingCarrier

Contains details about the carrier on a return.

Fields

Field Name
Description
label - String!
A description of the shipping carrier.
uid - ID!
The unique ID for a `ReturnShippingCarrier` object assigned to the shipping carrier.

Example

{"label": "xyz789", "uid": 4}

ReturnShippingTracking

Contains shipping and tracking details.

Fields

Field Name
Description
carrier - ReturnShippingCarrier!
Contains details of a shipping carrier.
status - ReturnShippingTrackingStatus
Details about the status of a shipment.
tracking_number - String!
A tracking number assigned by the carrier.
uid - ID!
The unique ID for a `ReturnShippingTracking` object assigned to the tracking item.

Example

{
  "carrier": ReturnShippingCarrier,
  "status": ReturnShippingTrackingStatus,
  "tracking_number": "xyz789",
  "uid": 4
}

ReturnShippingTrackingStatus

Contains the status of a shipment.

Fields

Field Name
Description
text - String!
Text that describes the status.
type - ReturnShippingTrackingStatusType!
Indicates whether the status type is informational or an error.

Example

{"text": "abc123", "type": "INFORMATION"}

ReturnShippingTrackingStatusType

Values

Enum Value
Description
INFORMATION
ERROR

Example

""INFORMATION""

ReturnStatus

Values

Enum Value
Description
PENDING
AUTHORIZED
PARTIALLY_AUTHORIZED
RECEIVED
PARTIALLY_RECEIVED
APPROVED
PARTIALLY_APPROVED
REJECTED
PARTIALLY_REJECTED
DENIED
PROCESSED_AND_CLOSED
CLOSED

Example

""PENDING""

Returns

Contains a list of customer return requests.

Fields

Field Name
Description
items - [Return]
A list of return requests.
page_info - SearchResultPageInfo
Pagination metadata.
total_count - Int
The total number of return requests.

Example

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

RevokeCustomerTokenOutput

Contains the result of a request to revoke a customer token.

Fields

Field Name
Description
result - Boolean!
The result of a request to revoke a customer token.

Example

{"result": true}

RewardPoints

Contains details about a customer's reward points.

Fields

Field Name
Description
balance - RewardPointsAmount
The current balance of reward points.
balance_history - [RewardPointsBalanceHistoryItem]
The balance history of reward points. If the ability for customers to view the balance history has been disabled in the Admin, this field will be set to null.
exchange_rates - RewardPointsExchangeRates
The current exchange rates for reward points.
subscription_status - RewardPointsSubscriptionStatus
The subscription status of emails related to reward points.

Example

{
  "balance": RewardPointsAmount,
  "balance_history": [RewardPointsBalanceHistoryItem],
  "exchange_rates": RewardPointsExchangeRates,
  "subscription_status": RewardPointsSubscriptionStatus
}

RewardPointsAmount

Fields

Field Name
Description
money - Money!
The reward points amount in store currency.
points - Float!
The reward points amount in points.

Example

{"money": Money, "points": 123.45}

RewardPointsBalanceHistoryItem

Contain details about the reward points transaction.

Fields

Field Name
Description
balance - RewardPointsAmount
The award points balance after the completion of the transaction.
change_reason - String!
The reason the balance changed.
date - String!
The date of the transaction.
points_change - Float!
The number of points added or deducted in the transaction.

Example

{
  "balance": RewardPointsAmount,
  "change_reason": "abc123",
  "date": "abc123",
  "points_change": 987.65
}

RewardPointsExchangeRates

Lists the reward points exchange rates. The values depend on the customer group.

Fields

Field Name
Description
earning - RewardPointsRate
How many points are earned for a given amount spent.
redemption - RewardPointsRate
How many points must be redeemed to get a given amount of currency discount at the checkout.

Example

{
  "earning": RewardPointsRate,
  "redemption": RewardPointsRate
}

RewardPointsRate

Contains details about customer's reward points rate.

Fields

Field Name
Description
currency_amount - Float!
The money value for the exchange rate. For earnings, this is the amount spent to earn the specified points. For redemption, this is the amount of money the number of points represents.
points - Float!
The number of points for an exchange rate. For earnings, this is the number of points earned. For redemption, this is the number of points needed for redemption.

Example

{"currency_amount": 123.45, "points": 987.65}

RewardPointsSubscriptionStatus

Indicates whether the customer subscribes to reward points emails.

Fields

Field Name
Description
balance_updates - RewardPointsSubscriptionStatusesEnum!
Indicates whether the customer subscribes to 'Reward points balance updates' emails.
points_expiration_notifications - RewardPointsSubscriptionStatusesEnum!
Indicates whether the customer subscribes to 'Reward points expiration notifications' emails.

Example

{
  "balance_updates": "SUBSCRIBED",
  "points_expiration_notifications": "SUBSCRIBED"
}

RewardPointsSubscriptionStatusesEnum

Values

Enum Value
Description
SUBSCRIBED
NOT_SUBSCRIBED

Example

""SUBSCRIBED""

RoutableInterface

Routable entities serve as the model for a rendered page.

Fields

Field Name
Description
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.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.

Possible Types

Example

{
  "redirect_code": 123,
  "relative_url": "xyz789",
  "type": "CMS_PAGE"
}

RoutableUrl

Default implementation of RoutableInterface. This type is returned when the URL is not linked to an entity.

Fields

Field Name
Description
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.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.

Example

{
  "redirect_code": 987,
  "relative_url": "abc123",
  "type": "CMS_PAGE"
}

SDKParams

Defines the name and value of a SDK parameter

Fields

Field Name
Description
name - String
The name of the SDK parameter
value - String
The value of the SDK parameter

Example

{
  "name": "abc123",
  "value": "abc123"
}

SalesCommentItem

Contains details about a comment.

Fields

Field Name
Description
message - String!
The text of the message.
timestamp - String!
The timestamp of the comment.

Example

{
  "message": "abc123",
  "timestamp": "abc123"
}

ScopeTypeEnum

This enumeration defines the scope type for customer orders.

Values

Enum Value
Description
GLOBAL
WEBSITE
STORE

Example

""GLOBAL""

SearchResultPageInfo

Provides navigation for the query response.

Fields

Field Name
Description
current_page - Int
The specific page to return.
page_size - Int
The maximum number of items to return per page of results.
total_pages - Int
The total number of pages in the response.

Example

{"current_page": 987, "page_size": 987, "total_pages": 123}

SearchSuggestion

A string that contains search suggestion

Fields

Field Name
Description
search - String!
The search suggestion of existing product.

Example

{"search": "xyz789"}

SelectedBundleOption

Contains details about a selected bundle option.

Fields

Field Name
Description
id - Int!
(Deprecated: Use `uid` instead)
label - String!
The display name of the selected bundle product option.
type - String!
The type of selected bundle product option.
uid - ID!
The unique ID for a `SelectedBundleOption` object
values - [SelectedBundleOptionValue]!
An array of selected bundle option values.

Example

{
  "id": 987,
  "label": "abc123",
  "type": "abc123",
  "uid": "4",
  "values": [SelectedBundleOptionValue]
}

SelectedBundleOptionValue

Contains details about a value for a selected bundle option.

Fields

Field Name
Description
id - Int!
Use `uid` instead
label - String!
The display name of the value for the selected bundle product option.
price - Float!
The price of the value for the selected bundle product option.
quantity - Float!
The quantity of the value for the selected bundle product option.
uid - ID!
The unique ID for a `SelectedBundleOptionValue` object

Example

{
  "id": 987,
  "label": "xyz789",
  "price": 123.45,
  "quantity": 123.45,
  "uid": 4
}

SelectedConfigurableOption

Contains details about a selected configurable option.

Fields

Field Name
Description
configurable_product_option_uid - ID!
The unique ID for a `ConfigurableProductOptions` object.
configurable_product_option_value_uid - ID!
The unique ID for a `ConfigurableProductOptionsValues` object.
id - Int!
(Deprecated: Use `SelectedConfigurableOption.configurable_product_option_uid` instead.)
option_label - String!
The display text for the option.
value_id - Int!
(Deprecated: Use `SelectedConfigurableOption.configurable_product_option_value_uid` instead.)
value_label - String!
The display name of the selected configurable option.

Example

{
  "configurable_product_option_uid": "4",
  "configurable_product_option_value_uid": "4",
  "id": 987,
  "option_label": "abc123",
  "value_id": 123,
  "value_label": "abc123"
}

SelectedCustomAttributeInput

Contains details about an attribute the buyer selected.

Input Fields

Input Field
Description
attribute_code - String!
A string that identifies the selected attribute.
value - ID!
The unique ID for a `CustomAttribute` object of a selected custom attribute.

Example

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

SelectedCustomizableOption

Identifies a customized product that has been placed in a cart.

Fields

Field Name
Description
customizable_option_uid - ID!
The unique ID for a specific `CustomizableOptionInterface` object, such as a `CustomizableFieldOption`, `CustomizableFileOption`, or `CustomizableAreaOption` object.
id - Int!
(Deprecated: Use `SelectedCustomizableOption.customizable_option_uid` instead.)
is_required - Boolean!
Indicates whether the customizable option is required.
label - String!
The display name of the selected customizable option.
sort_order - Int!
A value indicating the order to display this option.
type - String!
The type of `CustomizableOptionInterface` object.
values - [SelectedCustomizableOptionValue]!
An array of selectable values.

Example

{
  "customizable_option_uid": 4,
  "id": 123,
  "is_required": true,
  "label": "abc123",
  "sort_order": 123,
  "type": "xyz789",
  "values": [SelectedCustomizableOptionValue]
}

SelectedCustomizableOptionValue

Identifies the value of the selected customized option.

Fields

Field Name
Description
customizable_option_value_uid - ID!
The unique ID for a value object that corresponds to the object represented by the `customizable_option_uid` attribute.
id - Int!
(Deprecated: Use `SelectedCustomizableOptionValue.customizable_option_value_uid` instead.)
label - String!
The display name of the selected value.
price - CartItemSelectedOptionValuePrice!
The price of the selected customizable value.
value - String!
The text identifying the selected value.

Example

{
  "customizable_option_value_uid": "4",
  "id": 987,
  "label": "xyz789",
  "price": CartItemSelectedOptionValuePrice,
  "value": "xyz789"
}

SelectedPaymentMethod

Describes the payment method the shopper selected.

Fields

Field Name
Description
code - String!
The payment method code.
purchase_order_number - String
The purchase order number.
title - String!
The payment method title.

Example

{
  "code": "xyz789",
  "purchase_order_number": "abc123",
  "title": "xyz789"
}

SelectedShippingMethod

Contains details about the selected shipping method and carrier.

Fields

Field Name
Description
amount - Money!
The cost of shipping using this shipping method.
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.
method_code - String!
A shipping method code associated with a carrier.
method_title - String!
The label for the method code.
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,
  "base_amount": Money,
  "carrier_code": "xyz789",
  "carrier_title": "xyz789",
  "method_code": "abc123",
  "method_title": "abc123",
  "price_excl_tax": Money,
  "price_incl_tax": Money
}

SendEmailToFriendInput

Defines the referenced product and the email sender and recipients.

Input Fields

Input Field
Description
product_id - Int!
The ID of the product that the sender is referencing.
recipients - [SendEmailToFriendRecipientInput]!
An array containing information about each recipient.
sender - SendEmailToFriendSenderInput!
Information about the customer and the content of the message.

Example

{
  "product_id": 987,
  "recipients": [SendEmailToFriendRecipientInput],
  "sender": SendEmailToFriendSenderInput
}

SendEmailToFriendOutput

Contains information about the sender and recipients.

Fields

Field Name
Description
recipients - [SendEmailToFriendRecipient]
An array containing information about each recipient.
sender - SendEmailToFriendSender
Information about the customer and the content of the message.

Example

{
  "recipients": [SendEmailToFriendRecipient],
  "sender": SendEmailToFriendSender
}

SendEmailToFriendRecipient

An output object that contains information about the recipient.

Fields

Field Name
Description
email - String!
The email address of the recipient.
name - String!
The name of the recipient.

Example

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

SendEmailToFriendRecipientInput

Contains details about a recipient.

Input Fields

Input Field
Description
email - String!
The email address of the recipient.
name - String!
The name of the recipient.

Example

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

SendEmailToFriendSender

An output object that contains information about the sender.

Fields

Field Name
Description
email - String!
The email address of the sender.
message - String!
The text of the message to be sent.
name - String!
The name of the sender.

Example

{
  "email": "xyz789",
  "message": "xyz789",
  "name": "xyz789"
}

SendEmailToFriendSenderInput

Contains details about the sender.

Input Fields

Input Field
Description
email - String!
The email address of the sender.
message - String!
The text of the message to be sent.
name - String!
The name of the sender.

Example

{
  "email": "abc123",
  "message": "xyz789",
  "name": "xyz789"
}

SendFriendConfiguration

Contains details about the configuration of the Email to a Friend feature.

Fields

Field Name
Description
enabled_for_customers - Boolean!
Indicates whether the Email to a Friend feature is enabled.
enabled_for_guests - Boolean!
Indicates whether the Email to a Friend feature is enabled for guests.

Example

{"enabled_for_customers": true, "enabled_for_guests": true}

SendNegotiableQuoteForReviewInput

Specifies which negotiable quote to send for review.

Input Fields

Input Field
Description
comment - NegotiableQuoteCommentInput
A comment for the seller to review.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"comment": NegotiableQuoteCommentInput, "quote_uid": 4}

SendNegotiableQuoteForReviewOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after sending for seller review.

Example

{"quote": NegotiableQuote}

SetBillingAddressOnCartInput

Sets the billing address.

Input Fields

Input Field
Description
billing_address - BillingAddressInput!
The billing address.
cart_id - String!
The unique ID of a `Cart` object.

Example

{
  "billing_address": BillingAddressInput,
  "cart_id": "abc123"
}

SetBillingAddressOnCartOutput

Contains details about the cart after setting the billing address.

Fields

Field Name
Description
cart - Cart!
The cart after setting the billing address.

Example

{"cart": Cart}

SetGiftOptionsOnCartInput

Defines the gift options applied to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.
gift_message - GiftMessageInput
Gift message details for the cart.
gift_receipt_included - Boolean!
Whether customer requested gift receipt for the cart.
gift_wrapping_id - ID
The unique ID for a `GiftWrapping` object to be used for the cart.
printed_card_included - Boolean!
Whether customer requested printed card for the cart.

Example

{
  "cart_id": "abc123",
  "gift_message": GiftMessageInput,
  "gift_receipt_included": false,
  "gift_wrapping_id": "4",
  "printed_card_included": true
}

SetGiftOptionsOnCartOutput

Contains the cart after gift options have been applied.

Fields

Field Name
Description
cart - Cart!
The modified cart object.

Example

{"cart": Cart}

SetGuestEmailOnCartInput

Defines the guest email and cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
email - String!
The email address of the guest.

Example

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

SetGuestEmailOnCartOutput

Contains details about the cart after setting the email of a guest.

Fields

Field Name
Description
cart - Cart!
The cart after setting the guest email.

Example

{"cart": Cart}

SetLineItemNoteOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after sending for seller review.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteBillingAddressInput

Sets the billing address.

Input Fields

Input Field
Description
billing_address - NegotiableQuoteBillingAddressInput!
The billing address to be added.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "billing_address": NegotiableQuoteBillingAddressInput,
  "quote_uid": 4
}

SetNegotiableQuoteBillingAddressOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after assigning a billing address.

Example

{"quote": NegotiableQuote}

SetNegotiableQuotePaymentMethodInput

Defines the payment method of the specified negotiable quote.

Input Fields

Input Field
Description
payment_method - NegotiableQuotePaymentMethodInput!
The payment method to be assigned to the negotiable quote.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "payment_method": NegotiableQuotePaymentMethodInput,
  "quote_uid": 4
}

SetNegotiableQuotePaymentMethodOutput

Contains details about the negotiable quote after setting the payment method.

Fields

Field Name
Description
quote - NegotiableQuote
The updated negotiable quote.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteShippingAddressInput

Defines the shipping address to assign to the negotiable quote.

Input Fields

Input Field
Description
customer_address_id - ID
The unique ID of a `CustomerAddress` object.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.
shipping_addresses - [NegotiableQuoteShippingAddressInput]
An array of shipping addresses to apply to the negotiable quote.

Example

{
  "customer_address_id": "4",
  "quote_uid": 4,
  "shipping_addresses": [
    NegotiableQuoteShippingAddressInput
  ]
}

SetNegotiableQuoteShippingAddressOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after assigning a shipping address.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteShippingMethodsInput

Defines the shipping method to apply to the negotiable quote.

Input Fields

Input Field
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.
shipping_methods - [ShippingMethodInput]!
An array of shipping methods to apply to the negotiable quote.

Example

{
  "quote_uid": 4,
  "shipping_methods": [ShippingMethodInput]
}

SetNegotiableQuoteShippingMethodsOutput

Contains the negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after applying shipping methods.

Example

{"quote": NegotiableQuote}

SetNegotiableQuoteTemplateShippingAddressInput

Defines the shipping address to assign to the negotiable quote template.

Input Fields

Input Field
Description
shipping_address - NegotiableQuoteTemplateShippingAddressInput!
A shipping adadress to apply to the negotiable quote template.
template_id - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "shipping_address": NegotiableQuoteTemplateShippingAddressInput,
  "template_id": "4"
}

SetPaymentMethodAndPlaceOrderInput

Applies a payment method to the quote.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
payment_method - PaymentMethodInput!
The payment method data to apply to the cart.

Example

{
  "cart_id": "abc123",
  "payment_method": PaymentMethodInput
}

SetPaymentMethodOnCartInput

Applies a payment method to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
payment_method - PaymentMethodInput!
The payment method data to apply to the cart.

Example

{
  "cart_id": "abc123",
  "payment_method": PaymentMethodInput
}

SetPaymentMethodOnCartOutput

Contains details about the cart after setting the payment method.

Fields

Field Name
Description
cart - Cart!
The cart after setting the payment method.

Example

{"cart": Cart}

SetShippingAddressesOnCartInput

Specifies an array of addresses to use for shipping.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
shipping_addresses - [ShippingAddressInput]!
An array of shipping addresses.

Example

{
  "cart_id": "abc123",
  "shipping_addresses": [ShippingAddressInput]
}

SetShippingAddressesOnCartOutput

Contains details about the cart after setting the shipping addresses.

Fields

Field Name
Description
cart - Cart!
The cart after setting the shipping addresses.

Example

{"cart": Cart}

SetShippingMethodsOnCartInput

Applies one or shipping methods to the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.
shipping_methods - [ShippingMethodInput]!
An array of shipping methods.

Example

{
  "cart_id": "xyz789",
  "shipping_methods": [ShippingMethodInput]
}

SetShippingMethodsOnCartOutput

Contains details about the cart after setting the shipping methods.

Fields

Field Name
Description
cart - Cart!
The cart after setting the shipping methods.

Example

{"cart": Cart}

ShareGiftRegistryInviteeInput

Defines a gift registry invitee.

Input Fields

Input Field
Description
email - String!
The email address of the gift registry invitee.
name - String!
The name of the gift registry invitee.

Example

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

ShareGiftRegistryOutput

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

Fields

Field Name
Description
is_shared - Boolean!
Indicates whether the gift registry was successfully shared.

Example

{"is_shared": true}

ShareGiftRegistrySenderInput

Defines the sender of an invitation to view a gift registry.

Input Fields

Input Field
Description
message - String!
A brief message from the sender.
name - String!
The sender of the gift registry invitation.

Example

{
  "message": "xyz789",
  "name": "xyz789"
}

ShipBundleItemsEnum

Defines whether bundle items must be shipped together.

Values

Enum Value
Description
TOGETHER
SEPARATELY

Example

""TOGETHER""

ShipmentItem

Fields

Field Name
Description
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

{
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_shipped": 123.45
}

ShipmentItemInterface

Order shipment item details.

Fields

Field Name
Description
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.

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

Field Name
Description
carrier - String!
The shipping carrier for the order delivery.
number - String
The tracking number of the order shipment.
title - String!
The shipment tracking title.

Example

{
  "carrier": "abc123",
  "number": "abc123",
  "title": "xyz789"
}

ShippingAddressInput

Defines a single shipping address.

Input Fields

Input Field
Description
address - CartAddressInput
Defines a shipping address.
customer_address_id - Int
An ID from the customer's address book that uniquely identifies the address to be used for shipping.
customer_notes - String
Text provided by the shopper.
pickup_location_code - String
The code of Pickup Location which will be used for In-Store Pickup.

Example

{
  "address": CartAddressInput,
  "customer_address_id": 123,
  "customer_notes": "xyz789",
  "pickup_location_code": "xyz789"
}

ShippingCartAddress

Contains shipping addresses and methods.

Fields

Field Name
Description
available_shipping_methods - [AvailableShippingMethod]
An array that lists the shipping methods that can be applied to the cart.
cart_items - [CartItemQuantity]
(Deprecated: Use `cart_items_v2` instead.)
cart_items_v2 - [CartItemInterface]
An array that lists the items in the cart.
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_notes - String
Text provided by the shopper.
fax - String
The customer's fax number.
firstname - String!
The first name of the customer or guest.
items_weight - Float
(Deprecated: This information should not be exposed on the frontend.)
lastname - String!
The last name of the customer or guest.
middlename - String
The middle name of the person associated with the billing/shipping address.
pickup_location_code - String
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.
selected_shipping_method - SelectedShippingMethod
An object that describes the selected shipping method.
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 - String!
The unique id of the customer address.
vat_id - String
The VAT company number for billing or shipping address.

Example

{
  "available_shipping_methods": [AvailableShippingMethod],
  "cart_items": [CartItemQuantity],
  "cart_items_v2": [CartItemInterface],
  "city": "abc123",
  "company": "xyz789",
  "country": CartAddressCountry,
  "custom_attributes": [AttributeValueInterface],
  "customer_notes": "xyz789",
  "fax": "abc123",
  "firstname": "xyz789",
  "items_weight": 123.45,
  "lastname": "xyz789",
  "middlename": "abc123",
  "pickup_location_code": "abc123",
  "postcode": "abc123",
  "prefix": "abc123",
  "region": CartAddressRegion,
  "selected_shipping_method": SelectedShippingMethod,
  "street": ["xyz789"],
  "suffix": "abc123",
  "telephone": "xyz789",
  "uid": "xyz789",
  "vat_id": "xyz789"
}

ShippingDiscount

Defines an individual shipping discount. This discount can be applied to shipping.

Fields

Field Name
Description
amount - Money!
The amount of the discount.

Example

{"amount": Money}

ShippingHandling

Contains details about shipping and handling costs.

Fields

Field Name
Description
amount_excluding_tax - Money
The shipping amount, excluding tax.
amount_including_tax - Money
The shipping amount, including tax.
discounts - [ShippingDiscount]
The applied discounts to the shipping.
taxes - [TaxItem]
Details about taxes applied for shipping.
total_amount - Money!
The total amount for shipping.

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

Input Field
Description
carrier_code - String!
A string that identifies a commercial carrier or an offline delivery method.
method_code - String!
A string that indicates which service a commercial carrier will use to ship items. For offline delivery methods, this value is similar to the label displayed on the checkout page.

Example

{
  "carrier_code": "abc123",
  "method_code": "xyz789"
}

SimpleCartItem

An implementation for simple product cart items.

Fields

Field Name
Description
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for 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
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],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "xyz789",
  "is_available": true,
  "max_qty": 987.65,
  "min_qty": 123.45,
  "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

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.
gift_message_available - String
Indicates whether a gift message is available.
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.)
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.
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.
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
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": 987,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "color": 123,
  "country_of_manufacture": "xyz789",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": "xyz789",
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 987,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 987,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": true,
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 987.65,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website],
  "weight": 123.45
}

SimpleProductCartItemInput

Defines a single product to add to the cart.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
data - CartItemInput!
An object containing the `sku`, `quantity`, and other relevant information about the product.

Example

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

SimpleRequisitionListItem

Contains details about simple products added to a requisition list.

Fields

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

Example

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

SimpleWishlistItem

Contains a simple product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
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",
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": "4",
  "product": ProductInterface,
  "quantity": 987.65
}

SmartButtonMethodInput

Smart button payment 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": "xyz789",
  "payments_order_id": "xyz789",
  "paypal_order_id": "xyz789"
}

SmartButtonsConfig

Fields

Field Name
Description
button_styles - ButtonStyles
The styles for the PayPal Smart Button configuration
code - String
The payment method code as defined in the payment gateway
display_message - Boolean
Indicates whether to display the PayPal Pay Later message
display_venmo - Boolean
Indicates whether to display Venmo
is_visible - Boolean
Indicates whether the payment method is displayed
message_styles - MessageStyles
Contains details about the styles for the PayPal Pay Later message
payment_intent - String
Defines the payment intent (Authorize or Capture
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",
  "display_message": true,
  "display_venmo": false,
  "is_visible": false,
  "message_styles": MessageStyles,
  "payment_intent": "abc123",
  "sdk_params": [SDKParams],
  "sort_order": "abc123",
  "title": "abc123"
}

SortEnum

Indicates whether to return results in ascending or descending order.

Values

Enum Value
Description
ASC
DESC

Example

""ASC""

SortField

Defines a possible sort field.

Fields

Field Name
Description
label - String
The label of the sort field.
value - String
The attribute code of the sort field.

Example

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

SortFields

Contains a default value for sort fields and all available sort fields.

Fields

Field Name
Description
default - String
The default sort field value.
options - [SortField]
An array of possible sort fields.

Example

{
  "default": "xyz789",
  "options": [SortField]
}

SortQuoteItemsEnum

Specifies the field to use for sorting quote items

Values

Enum Value
Description
ITEM_ID
CREATED_AT
UPDATED_AT
PRODUCT_ID
SKU
NAME
DESCRIPTION
WEIGHT
QTY
PRICE
BASE_PRICE
CUSTOM_PRICE
DISCOUNT_PERCENT
DISCOUNT_AMOUNT
BASE_DISCOUNT_AMOUNT
TAX_PERCENT
TAX_AMOUNT
BASE_TAX_AMOUNT
ROW_TOTAL
BASE_ROW_TOTAL
ROW_TOTAL_WITH_DISCOUNT
ROW_WEIGHT
PRODUCT_TYPE
BASE_TAX_BEFORE_DISCOUNT
TAX_BEFORE_DISCOUNT
ORIGINAL_CUSTOM_PRICE
PRICE_INC_TAX
BASE_PRICE_INC_TAX
ROW_TOTAL_INC_TAX
BASE_ROW_TOTAL_INC_TAX
DISCOUNT_TAX_COMPENSATION_AMOUNT
BASE_DISCOUNT_TAX_COMPENSATION_AMOUNT
FREE_SHIPPING

Example

""ITEM_ID""