NegotiableQuote

Contains details about a negotiable quote.

Fields

Field Name
Description
available_payment_methods - [AvailablePaymentMethod]
An array of payment methods that can be applied to the negotiable quote.
billing_address - NegotiableQuoteBillingAddress
The billing address applied to the negotiable quote.
buyer - NegotiableQuoteUser!
The first and last name of the buyer.
comments - [NegotiableQuoteComment]
A list of comments made by the buyer and seller.
created_at - String
Timestamp indicating when the negotiable quote was created.
email - String
The email address of the company user.
history - [NegotiableQuoteHistoryEntry]
A list of status and price changes for the negotiable quote.
is_virtual - Boolean!
Indicates whether the negotiable quote contains only virtual products.
items - [CartItemInterface]
The list of items in the negotiable quote.
name - String!
The title assigned to the negotiable quote.
prices - CartPrices
A set of subtotals and totals applied to the negotiable quote.
selected_payment_method - SelectedPaymentMethod
The payment method that was applied to the negotiable quote.
shipping_addresses - [NegotiableQuoteShippingAddress]!
A list of shipping addresses applied to the negotiable quote.
status - NegotiableQuoteStatus!
The status of the negotiable quote.
total_quantity - Float!
The total number of items in the negotiable quote.
uid - ID!
The unique ID of a `NegotiableQuote` object.
updated_at - String
Timestamp indicating when the negotiable quote was updated.

Example

{
  "available_payment_methods": [AvailablePaymentMethod],
  "billing_address": NegotiableQuoteBillingAddress,
  "buyer": NegotiableQuoteUser,
  "comments": [NegotiableQuoteComment],
  "created_at": "xyz789",
  "email": "abc123",
  "history": [NegotiableQuoteHistoryEntry],
  "is_virtual": false,
  "items": [CartItemInterface],
  "name": "abc123",
  "prices": CartPrices,
  "selected_payment_method": SelectedPaymentMethod,
  "shipping_addresses": [NegotiableQuoteShippingAddress],
  "status": "SUBMITTED",
  "total_quantity": 987.65,
  "uid": 4,
  "updated_at": "xyz789"
}

NegotiableQuoteAddressCountry

Defines the company's country.

Fields

Field Name
Description
code - String!
The address country code.
label - String!
The display name of the region.

Example

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

NegotiableQuoteAddressInput

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

Input Fields

Input Field
Description
city - String!
The city specified for the billing or shipping address.
company - String
The company name.
country_code - String!
The country code and label for the billing or shipping address.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The ZIP or postal code of the billing or shipping address.
region - String
A string that defines the state or province of the billing or shipping address.
region_id - Int
An integer that defines the state or province of the billing or shipping address.
save_in_address_book - Boolean
Determines whether to save the address in the customer's address book. The default value is true.
street - [String]!
An array containing the street for the billing or shipping address.
telephone - String
The telephone number for the billing or shipping address.

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country_code": "xyz789",
  "firstname": "xyz789",
  "lastname": "abc123",
  "postcode": "abc123",
  "region": "xyz789",
  "region_id": 123,
  "save_in_address_book": false,
  "street": ["xyz789"],
  "telephone": "abc123"
}

NegotiableQuoteAddressInterface

Fields

Field Name
Description
city - String!
The company's city or town.
company - String
The company name associated with the shipping/billing address.
country - NegotiableQuoteAddressCountry!
The company's country.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The company's ZIP or postal code.
region - NegotiableQuoteAddressRegion
An object containing the region name, region code, and region ID.
street - [String]!
An array of strings that define the street number and name.
telephone - String
The customer's telephone number.

Possible Types

NegotiableQuoteAddressInterface Types
NegotiableQuoteShippingAddress
NegotiableQuoteBillingAddress

Example

{
  "city": "xyz789",
  "company": "abc123",
  "country": NegotiableQuoteAddressCountry,
  "firstname": "abc123",
  "lastname": "xyz789",
  "postcode": "xyz789",
  "region": NegotiableQuoteAddressRegion,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

NegotiableQuoteAddressRegion

Defines the company's state or province.

Fields

Field Name
Description
code - String
The address region code.
label - String
The display name of the region.
region_id - Int
The unique ID for a pre-defined region.

Example

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

NegotiableQuoteBillingAddress

Fields

Field Name
Description
city - String!
The company's city or town.
company - String
The company name associated with the shipping/billing address.
country - NegotiableQuoteAddressCountry!
The company's country.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The company's ZIP or postal code.
region - NegotiableQuoteAddressRegion
An object containing the region name, region code, and region ID.
street - [String]!
An array of strings that define the street number and name.
telephone - String
The customer's telephone number.

Example

{
  "city": "abc123",
  "company": "abc123",
  "country": NegotiableQuoteAddressCountry,
  "firstname": "abc123",
  "lastname": "xyz789",
  "postcode": "xyz789",
  "region": NegotiableQuoteAddressRegion,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

NegotiableQuoteBillingAddressInput

Defines the billing address.

Input Fields

Input Field
Description
address - NegotiableQuoteAddressInput
Defines a billing address.
customer_address_uid - ID
The unique ID of a `CustomerAddress` object.
same_as_shipping - Boolean
Indicates whether to set the billing address to be the same as the existing shipping address on the negotiable quote.
use_for_shipping - Boolean
Indicates whether to set the shipping address to be the same as this billing address.

Example

{
  "address": NegotiableQuoteAddressInput,
  "customer_address_uid": "4",
  "same_as_shipping": true,
  "use_for_shipping": true
}

NegotiableQuoteComment

Contains a single plain text comment from either the buyer or seller.

Fields

Field Name
Description
author - NegotiableQuoteUser!
The first and last name of the commenter.
created_at - String!
Timestamp indicating when the comment was created.
creator_type - NegotiableQuoteCommentCreatorType!
Indicates whether a buyer or seller commented.
text - String!
The plain text comment.
uid - ID!
The unique ID of a `NegotiableQuoteComment` object.

Example

{
  "author": NegotiableQuoteUser,
  "created_at": "abc123",
  "creator_type": "BUYER",
  "text": "xyz789",
  "uid": 4
}

NegotiableQuoteCommentCreatorType

Values

Enum Value
Description
BUYER
SELLER

Example

""BUYER""

NegotiableQuoteCommentInput

Contains the commend provided by the buyer.

Input Fields

Input Field
Description
comment - String!
The comment provided by the buyer.

Example

{"comment": "xyz789"}

NegotiableQuoteCustomLogChange

Contains custom log entries added by third-party extensions.

Fields

Field Name
Description
new_value - String!
The new entry content.
old_value - String
The previous entry in the custom log.
title - String!
The title of the custom log entry.

Example

{
  "new_value": "xyz789",
  "old_value": "xyz789",
  "title": "xyz789"
}

NegotiableQuoteFilterInput

Defines a filter to limit the negotiable quotes to return.

Input Fields

Input Field
Description
ids - FilterEqualTypeInput
Filter by the ID of one or more negotiable quotes.
name - FilterMatchTypeInput
Filter by the negotiable quote name.

Example

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

NegotiableQuoteHistoryChanges

Contains a list of changes to a negotiable quote.

Fields

Field Name
Description
comment_added - NegotiableQuoteHistoryCommentChange
The comment provided with a change in the negotiable quote history.
custom_changes - NegotiableQuoteCustomLogChange
Lists log entries added by third-party extensions.
expiration - NegotiableQuoteHistoryExpirationChange
The expiration date of the negotiable quote before and after a change in the quote history.
products_removed - NegotiableQuoteHistoryProductsRemovedChange
Lists products that were removed as a result of a change in the quote history.
statuses - NegotiableQuoteHistoryStatusesChange
The status before and after a change in the negotiable quote history.
total - NegotiableQuoteHistoryTotalChange
The total amount of the negotiable quote before and after a change in the quote history.

Example

{
  "comment_added": NegotiableQuoteHistoryCommentChange,
  "custom_changes": NegotiableQuoteCustomLogChange,
  "expiration": NegotiableQuoteHistoryExpirationChange,
  "products_removed": NegotiableQuoteHistoryProductsRemovedChange,
  "statuses": NegotiableQuoteHistoryStatusesChange,
  "total": NegotiableQuoteHistoryTotalChange
}

NegotiableQuoteHistoryCommentChange

Contains a comment submitted by a seller or buyer.

Fields

Field Name
Description
comment - String!
A plain text comment submitted by a seller or buyer.

Example

{"comment": "xyz789"}

NegotiableQuoteHistoryEntry

Contains details about a change for a negotiable quote.

Fields

Field Name
Description
author - NegotiableQuoteUser!
The person who made a change in the status of the negotiable quote.
change_type - NegotiableQuoteHistoryEntryChangeType!
An enum that describes the why the entry in the negotiable quote history changed status.
changes - NegotiableQuoteHistoryChanges
The set of changes in the negotiable quote.
created_at - String
Timestamp indicating when the negotiable quote entry was created.
uid - ID!
The unique ID of a `NegotiableQuoteHistoryEntry` object.

Example

{
  "author": NegotiableQuoteUser,
  "change_type": "CREATED",
  "changes": NegotiableQuoteHistoryChanges,
  "created_at": "xyz789",
  "uid": 4
}

NegotiableQuoteHistoryEntryChangeType

Values

Enum Value
Description
CREATED
UPDATED
CLOSED
UPDATED_BY_SYSTEM

Example

""CREATED""

NegotiableQuoteHistoryExpirationChange

Contains a new expiration date and the previous date.

Fields

Field Name
Description
new_expiration - String
The expiration date after the change. The value will be 'null' if not set.
old_expiration - String
The previous expiration date. The value will be 'null' if not previously set.

Example

{
  "new_expiration": "abc123",
  "old_expiration": "xyz789"
}

NegotiableQuoteHistoryProductsRemovedChange

Contains lists of products that have been removed from the catalog and negotiable quote.

Fields

Field Name
Description
products_removed_from_catalog - [ID]
A list of product IDs the seller removed from the catalog.
products_removed_from_quote - [ProductInterface]
A list of products removed from the negotiable quote by either the buyer or the seller.

Example

{
  "products_removed_from_catalog": ["4"],
  "products_removed_from_quote": [ProductInterface]
}

NegotiableQuoteHistoryStatusChange

Lists a new status change applied to a negotiable quote and the previous status.

Fields

Field Name
Description
new_status - NegotiableQuoteStatus!
The updated status.
old_status - NegotiableQuoteStatus
The previous status. The value will be null for the first history entry in a negotiable quote.

Example

{"new_status": "SUBMITTED", "old_status": "SUBMITTED"}

NegotiableQuoteHistoryStatusesChange

Contains a list of status changes that occurred for the negotiable quote.

Fields

Field Name
Description
changes - [NegotiableQuoteHistoryStatusChange]!
A list of status changes.

Example

{"changes": [NegotiableQuoteHistoryStatusChange]}

NegotiableQuoteHistoryTotalChange

Contains a new price and the previous price.

Fields

Field Name
Description
new_price - Money
The total price as a result of the change.
old_price - Money
The previous total price on the negotiable quote.

Example

{
  "new_price": Money,
  "old_price": Money
}

NegotiableQuoteInvalidStateError

An error indicating that an operation was attempted on a negotiable quote in an invalid state.

Fields

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

Example

{"message": "xyz789"}

NegotiableQuoteItemQuantityInput

Specifies the updated quantity of an item.

Input Fields

Input Field
Description
quantity - Float!
The new quantity of the negotiable quote item.
quote_item_uid - ID!
The unique ID of a `CartItemInterface` object.

Example

{"quantity": 987.65, "quote_item_uid": 4}

NegotiableQuotePaymentMethodInput

Defines the payment method to be applied to the negotiable quote.

Input Fields

Input Field
Description
code - String!
Payment method code
purchase_order_number - String
The purchase order number. Optional for most payment methods.

Example

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

Contains a reference document link for a negotiable quote template.

Fields

Field Name
Description
document_identifier - String
The identifier of the reference document.
document_name - String!
The title of the reference document.
link_id - ID!
The unique ID of a reference document link.
reference_document_url - String!
The URL of the reference document.

Example

{
  "document_identifier": "xyz789",
  "document_name": "xyz789",
  "link_id": 4,
  "reference_document_url": "xyz789"
}

NegotiableQuoteShippingAddress

Fields

Field Name
Description
available_shipping_methods - [AvailableShippingMethod]
An array of shipping methods available to the buyer.
city - String!
The company's city or town.
company - String
The company name associated with the shipping/billing address.
country - NegotiableQuoteAddressCountry!
The company's country.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The company's ZIP or postal code.
region - NegotiableQuoteAddressRegion
An object containing the region name, region code, and region ID.
selected_shipping_method - SelectedShippingMethod
The selected shipping method.
street - [String]!
An array of strings that define the street number and name.
telephone - String
The customer's telephone number.

Example

{
  "available_shipping_methods": [AvailableShippingMethod],
  "city": "abc123",
  "company": "xyz789",
  "country": NegotiableQuoteAddressCountry,
  "firstname": "xyz789",
  "lastname": "abc123",
  "postcode": "abc123",
  "region": NegotiableQuoteAddressRegion,
  "selected_shipping_method": SelectedShippingMethod,
  "street": ["xyz789"],
  "telephone": "abc123"
}

NegotiableQuoteShippingAddressInput

Defines shipping addresses for the negotiable quote.

Input Fields

Input Field
Description
address - NegotiableQuoteAddressInput
A shipping address.
customer_address_uid - ID
An ID from the company user's address book that uniquely identifies the address to be used for shipping.
customer_notes - String
Text provided by the company user.

Example

{
  "address": NegotiableQuoteAddressInput,
  "customer_address_uid": "4",
  "customer_notes": "abc123"
}

NegotiableQuoteSortInput

Defines the field to use to sort a list of negotiable quotes.

Input Fields

Input Field
Description
sort_direction - SortEnum!
Whether to return results in ascending or descending order.
sort_field - NegotiableQuoteSortableField!
The specified sort field.

Example

{"sort_direction": "ASC", "sort_field": "QUOTE_NAME"}

NegotiableQuoteSortableField

Values

Enum Value
Description
QUOTE_NAME
Sorts negotiable quotes by name.
CREATED_AT
Sorts negotiable quotes by the dates they were created.
UPDATED_AT
Sorts negotiable quotes by the dates they were last modified.

Example

""QUOTE_NAME""

NegotiableQuoteStatus

Values

Enum Value
Description
SUBMITTED
PENDING
UPDATED
OPEN
ORDERED
CLOSED
DECLINED
EXPIRED
DRAFT

Example

""SUBMITTED""

NegotiableQuoteTemplate

Contains details about a negotiable quote template.

Fields

Field Name
Description
buyer - NegotiableQuoteUser!
The first and last name of the buyer.
comments - [NegotiableQuoteComment]
A list of comments made by the buyer and seller.
expiration_date - String!
The expiration period of the negotiable quote template.
history - [NegotiableQuoteHistoryEntry]
A list of status and price changes for the negotiable quote template.
is_min_max_qty_used - Boolean!
Indicates whether the minimum and maximum quantity settings are used.
is_virtual - Boolean!
Indicates whether the negotiable quote template contains only virtual products.
items - [CartItemInterface]
The list of items in the negotiable quote template.
max_order_commitment - Int!
Commitment for maximum orders
min_order_commitment - Int!
Commitment for minimum orders
name - String!
The title assigned to the negotiable quote template.
notifications - [QuoteTemplateNotificationMessage]
A list of notifications for the negotiable quote template.
prices - CartPrices
A set of subtotals and totals applied to the negotiable quote template.
reference_document_links - [NegotiableQuoteReferenceDocumentLink]
A list of reference document links for the negotiable quote template.
shipping_addresses - [NegotiableQuoteShippingAddress]!
A list of shipping addresses applied to the negotiable quote template.
status - String!
The status of the negotiable quote template.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.
total_quantity - Float!
The total number of items in the negotiable quote template.

Example

{
  "buyer": NegotiableQuoteUser,
  "comments": [NegotiableQuoteComment],
  "expiration_date": "abc123",
  "history": [NegotiableQuoteHistoryEntry],
  "is_min_max_qty_used": false,
  "is_virtual": false,
  "items": [CartItemInterface],
  "max_order_commitment": 123,
  "min_order_commitment": 987,
  "name": "abc123",
  "notifications": [QuoteTemplateNotificationMessage],
  "prices": CartPrices,
  "reference_document_links": [
    NegotiableQuoteReferenceDocumentLink
  ],
  "shipping_addresses": [NegotiableQuoteShippingAddress],
  "status": "abc123",
  "template_id": 4,
  "total_quantity": 987.65
}

NegotiableQuoteTemplateFilterInput

Defines a filter to limit the negotiable quotes to return.

Input Fields

Input Field
Description
state - FilterEqualTypeInput
Filter by state of one or more negotiable quote templates.
status - FilterEqualTypeInput
Filter by status of one or more negotiable quote templates.

Example

{
  "state": FilterEqualTypeInput,
  "status": FilterEqualTypeInput
}

NegotiableQuoteTemplateGridItem

Contains data for a negotiable quote template in a grid.

Fields

Field Name
Description
activated_at - String!
The date and time the negotiable quote template was activated.
company_name - String!
Company name the quote template is assigned to
expiration_date - String!
The expiration period of the negotiable quote template.
is_min_max_qty_used - Boolean!
Indicates whether the minimum and maximum quantity settings are used.
last_shared_at - String!
The date and time the negotiable quote template was last shared.
max_order_commitment - Int!
Commitment for maximum orders
min_negotiated_grand_total - Float!
The minimum negotiated grand total of the negotiable quote template.
min_order_commitment - Int!
Commitment for minimum orders
name - String!
The title assigned to the negotiable quote template.
orders_placed - Int!
The number of orders placed for the negotiable quote template.
sales_rep_name - String!
The first and last name of the sales representative.
state - String!
State of the negotiable quote template.
status - String!
The status of the negotiable quote template.
submitted_by - String!
The first and last name of the buyer.
template_id - ID!
The unique ID of a `NegotiableQuoteTemplate` object.

Example

{
  "activated_at": "abc123",
  "company_name": "abc123",
  "expiration_date": "abc123",
  "is_min_max_qty_used": false,
  "last_shared_at": "xyz789",
  "max_order_commitment": 987,
  "min_negotiated_grand_total": 123.45,
  "min_order_commitment": 987,
  "name": "xyz789",
  "orders_placed": 123,
  "sales_rep_name": "abc123",
  "state": "abc123",
  "status": "abc123",
  "submitted_by": "xyz789",
  "template_id": 4
}

NegotiableQuoteTemplateItemQuantityInput

Specifies the updated quantity of an item.

Input Fields

Input Field
Description
item_id - ID!
The unique ID of a `CartItemInterface` object.
max_qty - Float
The new max quantity of the negotiable quote template item. Only used if is_min_max_qty_used is true on the template.
min_qty - Float
The new min quantity of the negotiable quote template item. Only used if is_min_max_qty_used is true on the template.
quantity - Float!
The new quantity of the negotiable quote item.

Example

{"item_id": 4, "max_qty": 987.65, "min_qty": 987.65, "quantity": 987.65}

NegotiableQuoteTemplateReferenceDocumentLinkInput

Defines the reference document link to add to a negotiable quote template.

Input Fields

Input Field
Description
document_identifier - String
The identifier of the reference document.
document_name - String!
The title of the reference document.
link_id - ID
The unique ID of a `NegotiableQuoteReferenceDocumentLink` object.
reference_document_url - String!
The URL of the reference document.

Example

{
  "document_identifier": "abc123",
  "document_name": "abc123",
  "link_id": 4,
  "reference_document_url": "xyz789"
}

NegotiableQuoteTemplateShippingAddressInput

Defines shipping addresses for the negotiable quote template.

Input Fields

Input Field
Description
address - NegotiableQuoteAddressInput
A shipping address.
customer_address_uid - ID
An ID from the company user's address book that uniquely identifies the address to be used for shipping.
customer_notes - String
Text provided by the company user.

Example

{
  "address": NegotiableQuoteAddressInput,
  "customer_address_uid": 4,
  "customer_notes": "abc123"
}

NegotiableQuoteTemplateSortInput

Defines the field to use to sort a list of negotiable quotes.

Input Fields

Input Field
Description
sort_direction - SortEnum!
Whether to return results in ascending or descending order.
sort_field - NegotiableQuoteTemplateSortableField!
The specified sort field.

Example

{"sort_direction": "ASC", "sort_field": "TEMPLATE_ID"}

NegotiableQuoteTemplateSortableField

Values

Enum Value
Description
TEMPLATE_ID
Sorts negotiable quote templates by template id.
LAST_SHARED_AT
Sorts negotiable quote templates by the date they were last shared.

Example

""TEMPLATE_ID""

NegotiableQuoteTemplatesOutput

Contains a list of negotiable templates that match the specified filter.

Fields

Field Name
Description
items - [NegotiableQuoteTemplateGridItem]!
A list of negotiable quote templates
page_info - SearchResultPageInfo!
Contains pagination metadata
sort_fields - SortFields
Contains the default sort field and all available sort fields.
total_count - Int!
The number of negotiable quote templates returned

Example

{
  "items": [NegotiableQuoteTemplateGridItem],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "total_count": 123
}

NegotiableQuoteUidNonFatalResultInterface

Fields

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

Possible Types

NegotiableQuoteUidNonFatalResultInterface Types
NegotiableQuoteUidOperationSuccess

Example

{"quote_uid": 4}

NegotiableQuoteUidOperationSuccess

Contains details about a successful operation on a negotiable quote.

Fields

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

Example

{"quote_uid": 4}

NegotiableQuoteUser

A limited view of a Buyer or Seller in the negotiable quote process.

Fields

Field Name
Description
firstname - String!
The first name of the buyer or seller making a change.
lastname - String!
The buyer's or seller's last name.

Example

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

NegotiableQuotesOutput

Contains a list of negotiable that match the specified filter.

Fields

Field Name
Description
items - [NegotiableQuote]!
A list of negotiable quotes
page_info - SearchResultPageInfo!
Contains pagination metadata
sort_fields - SortFields
Contains the default sort field and all available sort fields.
total_count - Int!
The number of negotiable quotes returned

Example

{
  "items": [NegotiableQuote],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "total_count": 987
}

NoSuchEntityUidError

Contains an error message when an invalid UID was specified.

Fields

Field Name
Description
message - String!
The returned error message.
uid - ID!
The specified invalid unique ID of an object.

Example

{"message": "abc123", "uid": 4}

OpenNegotiableQuoteTemplateInput

Specifies the quote template id to open quote template.

Input Fields

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

Example

{"template_id": 4}

Order

Contains the order ID.

Fields

Field Name
Description
order_id - String
(Deprecated: Use `order_number` instead.)
order_number - String!
The unique ID for an `Order` object.

Example

{
  "order_id": "xyz789",
  "order_number": "xyz789"
}

OrderActionType

The list of available order actions.

Values

Enum Value
Description
REORDER
CANCEL
RETURN

Example

""REORDER""

OrderAddress

Contains detailed information about an order's billing and shipping addresses.

Fields

Field Name
Description
city - String!
The city or town.
company - String
The customer's company.
country_code - CountryCodeEnum
The customer's country.
custom_attributesV2 - [AttributeValueInterface]!
Custom attributes assigned to the customer address.
fax - String
The fax number.
firstname - String!
The first name of the person associated with the shipping/billing address.
lastname - String!
The family name of the person associated with the shipping/billing address.
middlename - String
The middle name of the person associated with the shipping/billing address.
postcode - String
The customer's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - String
The state or province name.
region_id - ID
The unique ID for a `Region` object of a pre-defined region.
street - [String]!
An array of strings that define the street number and name.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number.
vat_id - String
The customer's Value-added tax (VAT) number (for corporate customers).

Example

{
  "city": "xyz789",
  "company": "abc123",
  "country_code": "AF",
  "custom_attributesV2": [AttributeValueInterface],
  "fax": "xyz789",
  "firstname": "abc123",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "abc123",
  "prefix": "xyz789",
  "region": "xyz789",
  "region_id": 4,
  "street": ["xyz789"],
  "suffix": "xyz789",
  "telephone": "abc123",
  "vat_id": "abc123"
}

OrderCustomerInfo

Fields

Field Name
Description
firstname - String!
First name of the customer
lastname - String
Last name of the customer
middlename - String
Middle name of the customer
prefix - String
Prefix of the customer
suffix - String
Suffix of the customer

Example

{
  "firstname": "xyz789",
  "lastname": "abc123",
  "middlename": "xyz789",
  "prefix": "xyz789",
  "suffix": "abc123"
}

OrderInformationInput

Input to retrieve an order based on details.

Input Fields

Input Field
Description
email - String!
Order billing address email.
lastname - String!
Order billing address lastname.
number - String!
Order number.

Example

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

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.
prices - OrderItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface
The ProductInterface object, which contains details about the base product
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_return_requested - Float
The requested return quantity of the item.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

{
  "discounts": [Discount],
  "eligible_for_return": true,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "4",
  "prices": OrderItemPrices,
  "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": 123.45,
  "quantity_return_requested": 123.45,
  "quantity_returned": 987.65,
  "quantity_shipped": 123.45,
  "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.
prices - OrderItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface
The ProductInterface object, which contains details about the base product
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_return_requested - Float
The requested return quantity of the item.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Possible Types

Example

{
  "discounts": [Discount],
  "eligible_for_return": false,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "4",
  "prices": OrderItemPrices,
  "product": ProductInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "product_type": "abc123",
  "product_url_key": "abc123",
  "quantity_canceled": 123.45,
  "quantity_invoiced": 123.45,
  "quantity_ordered": 987.65,
  "quantity_refunded": 987.65,
  "quantity_return_requested": 987.65,
  "quantity_returned": 987.65,
  "quantity_shipped": 123.45,
  "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": "abc123"
}

OrderItemPrices

Fields

Field Name
Description
discounts - [Discount]
An array of discounts to be applied to the cart item.
fixed_product_taxes - [FixedProductTax]!
original_price - Money
The original price of the item.
original_price_including_tax - Money
The original price of the item including tax.
original_row_total - Money!
The value of the original price multiplied by the quantity of the item.
original_row_total_including_tax - Money!
The value of the original price multiplied by the quantity of the item including tax.
price - Money!
The price of the item before any discounts were applied. The price that might include tax, depending on the configured display settings for cart.
price_including_tax - Money!
The price of the item before any discounts were applied. The price that might include tax, depending on the configured display settings for cart.
row_total - Money!
The value of the price multiplied by the quantity of the item.
row_total_including_tax - Money!
The value of `row_total` plus the tax applied to the item.
total_item_discount - Money!
The total of all discounts applied to the item.

Example

{
  "discounts": [Discount],
  "fixed_product_taxes": [FixedProductTax],
  "original_price": Money,
  "original_price_including_tax": Money,
  "original_row_total": Money,
  "original_row_total_including_tax": Money,
  "price": Money,
  "price_including_tax": Money,
  "row_total": Money,
  "row_total_including_tax": Money,
  "total_item_discount": Money
}

OrderPaymentMethod

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

Fields

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": "xyz789"
}

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": "xyz789"}

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.
gift_options - GiftOptionsPrices
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. (Deprecated: Use subtotal_excl_tax field instead)
subtotal_excl_tax - Money!
The subtotal of the order, excluding taxes.
subtotal_incl_tax - Money!
The subtotal of the order, including taxes.
taxes - [TaxItem]
The order tax details.
total_giftcard - Money
The gift card balance applied to the order.
total_reward_points - Money
The total reward points applied to the order.
total_shipping - Money!
The shipping amount for the order.
total_store_credit - Money
The total store credit applied to the order.
total_tax - Money!
The amount of tax applied to the order.

Example

{
  "base_grand_total": Money,
  "discounts": [Discount],
  "gift_options": GiftOptionsPrices,
  "grand_total": Money,
  "shipping_handling": ShippingHandling,
  "subtotal": Money,
  "subtotal_excl_tax": Money,
  "subtotal_incl_tax": Money,
  "taxes": [TaxItem],
  "total_giftcard": Money,
  "total_reward_points": Money,
  "total_shipping": Money,
  "total_store_credit": Money,
  "total_tax": Money
}

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": "xyz789",
  "error_url": "xyz789",
  "return_url": "abc123"
}

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": "xyz789",
  "secure_token": "abc123",
  "secure_token_id": "xyz789"
}

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": "abc123",
  "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": "abc123",
  "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": "xyz789"
}

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": "abc123",
  "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": "abc123",
  "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": "xyz789"
}

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": "abc123",
  "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": "xyz789",
  "params": [SDKParams]
}

PaymentSourceDetails

Fields

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

Example

{"card": Card}

PaymentSourceInput

The payment source information

Input Fields

Input Field
Description
card - CardPaymentSourceInput!
The card payment source information

Example

{"card": CardPaymentSourceInput}

PaymentSourceOutput

The payment source information

Fields

Field Name
Description
card - CardPaymentSourceOutput!
The card payment source information

Example

{"card": CardPaymentSourceOutput}

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": "abc123",
  "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": "xyz789"
}

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": "abc123",
  "express_button": false,
  "urls": PaypalExpressUrlsInput,
  "use_paypal_credit": true
}

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": "xyz789"
}

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": "xyz789",
  "start": "abc123"
}

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": "abc123",
  "pending_url": "xyz789",
  "return_url": "abc123",
  "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": "xyz789",
  "contact_name": "abc123",
  "country_id": "xyz789",
  "description": "abc123",
  "email": "xyz789",
  "fax": "abc123",
  "latitude": 987.65,
  "longitude": 123.45,
  "name": "xyz789",
  "phone": "abc123",
  "pickup_location_code": "xyz789",
  "postcode": "xyz789",
  "region": "xyz789",
  "region_id": 123,
  "street": "abc123"
}

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": "xyz789"}

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": "abc123"}

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": 987.65,
  "main_final_price": 123.45,
  "main_price": 123.45
}

PriceRange

Contains the price range for a product. If the product has a single price, the minimum and maximum price will be the same.

Fields

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": "xyz789",
  "value": "abc123"
}

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
activity - FilterEqualTypeInput
Attribute label: Activity
category_gear - FilterEqualTypeInput
Attribute label: Category Gear
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.
climate - FilterEqualTypeInput
Attribute label: Climate
collar - FilterEqualTypeInput
Attribute label: Collar
color - FilterEqualTypeInput
Attribute label: Color
description - FilterMatchTypeInput
Attribute label: Description
eco_collection - FilterEqualTypeInput
Attribute label: Eco Collection
erin_recommends - FilterEqualTypeInput
Attribute label: Erin Recommends
features_bags - FilterEqualTypeInput
Attribute label: Features
format - FilterEqualTypeInput
Attribute label: Format
gender - FilterEqualTypeInput
Attribute label: Gender
material - FilterEqualTypeInput
Attribute label: Material
name - FilterMatchTypeInput
Attribute label: Product Name
new - FilterEqualTypeInput
Attribute label: New
pattern - FilterEqualTypeInput
Attribute label: Pattern
performance_fabric - FilterEqualTypeInput
Attribute label: Performance Fabric
price - FilterRangeTypeInput
Attribute label: Price
purpose - FilterEqualTypeInput
Attribute label: Purpose
sale - FilterEqualTypeInput
Attribute label: Sale
short_description - FilterMatchTypeInput
Attribute label: Short Description
size - FilterEqualTypeInput
Attribute label: Size
sku - FilterEqualTypeInput
Attribute label: SKU
sleeve - FilterEqualTypeInput
Attribute label: Sleeve
strap_bags - FilterEqualTypeInput
Attribute label: Strap/Handle
style_bags - FilterEqualTypeInput
Attribute label: Style Bags
style_bottom - FilterEqualTypeInput
Attribute label: Style Bottom
style_general - FilterEqualTypeInput
Attribute label: Style General
url_key - FilterEqualTypeInput
The part of the URL that identifies the product

Example

{
  "activity": FilterEqualTypeInput,
  "category_gear": FilterEqualTypeInput,
  "category_id": FilterEqualTypeInput,
  "category_uid": FilterEqualTypeInput,
  "category_url_path": FilterEqualTypeInput,
  "climate": FilterEqualTypeInput,
  "collar": FilterEqualTypeInput,
  "color": FilterEqualTypeInput,
  "description": FilterMatchTypeInput,
  "eco_collection": FilterEqualTypeInput,
  "erin_recommends": FilterEqualTypeInput,
  "features_bags": FilterEqualTypeInput,
  "format": FilterEqualTypeInput,
  "gender": FilterEqualTypeInput,
  "material": FilterEqualTypeInput,
  "name": FilterMatchTypeInput,
  "new": FilterEqualTypeInput,
  "pattern": FilterEqualTypeInput,
  "performance_fabric": FilterEqualTypeInput,
  "price": FilterRangeTypeInput,
  "purpose": FilterEqualTypeInput,
  "sale": FilterEqualTypeInput,
  "short_description": FilterMatchTypeInput,
  "size": FilterEqualTypeInput,
  "sku": FilterEqualTypeInput,
  "sleeve": FilterEqualTypeInput,
  "strap_bags": FilterEqualTypeInput,
  "style_bags": FilterEqualTypeInput,
  "style_bottom": FilterEqualTypeInput,
  "style_general": 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": 987.65, "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": false,
  "label": "abc123",
  "position": 987,
  "url": "abc123"
}

ProductImageThumbnail

Values

Enum Value
Description
ITSELF
Use thumbnail of product as image.
PARENT
Use thumbnail of product's parent as image.

Example

""ITSELF""

ProductInfoInput

Product Information used for Pickup Locations search.

Input Fields

Input Field
Description
sku - String!
Product SKU.

Example

{"sku": "xyz789"}

ProductInterface

Contains fields that are common to all types of products.

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
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.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
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.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
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.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
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.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
quantity - Float
Amount of available stock
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.
rules - [CatalogRule]
Provides applied catalog rules in the current active cart
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
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
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
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

{
  "activity": "xyz789",
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "abc123",
  "collar": "xyz789",
  "color": 987,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "eco_collection": 987,
  "erin_recommends": 123,
  "features_bags": "abc123",
  "format": 123,
  "gender": "abc123",
  "gift_message_available": false,
  "gift_wrapping_available": false,
  "gift_wrapping_price": Money,
  "id": 123,
  "image": ProductImage,
  "is_returnable": "abc123",
  "manufacturer": 123,
  "material": "abc123",
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "xyz789",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "min_sale_qty": 987.65,
  "name": "abc123",
  "new": 987,
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options_container": "abc123",
  "pattern": "abc123",
  "performance_fabric": 987,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "quantity": 123.45,
  "rating_summary": 123.45,
  "related_products": [ProductInterface],
  "review_count": 123,
  "reviews": ProductReviews,
  "rules": [CatalogRule],
  "sale": 123,
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "abc123",
  "sleeve": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "staged": true,
  "stock_status": "IN_STOCK",
  "strap_bags": "xyz789",
  "style_bags": "abc123",
  "style_bottom": "abc123",
  "style_general": "abc123",
  "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": "xyz789",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "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": "abc123",
  "linked_product_sku": "xyz789",
  "linked_product_type": "xyz789",
  "position": 123,
  "sku": "xyz789"
}

ProductLinksInterface

Contains information about linked products, including the link type and product type of each item.

Fields

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": "abc123",
  "linked_product_type": "xyz789",
  "position": 123,
  "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": "abc123",
  "video_description": "abc123",
  "video_metadata": "xyz789",
  "video_provider": "xyz789",
  "video_title": "abc123",
  "video_url": "xyz789"
}

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": "xyz789",
  "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": "xyz789",
  "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": "abc123",
  "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": 123.45,
  "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": false,
  "label": "abc123",
  "position": 987,
  "url": "xyz789",
  "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": "xyz789",
  "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": "abc123", "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": "xyz789",
  "name": "xyz789",
  "role": "abc123",
  "status": "PENDING",
  "updated_at": "xyz789"
}

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": "abc123",
  "description": "xyz789",
  "name": "abc123",
  "status": "ENABLED",
  "uid": "4",
  "updated_at": "abc123"
}

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": 987}

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

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": 987
}

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": "abc123",
  "type": "xyz789"
}

ReCaptchaConfigOutput

Fields

Field Name
Description
configurations - ReCaptchaConfiguration
Configuration details for reCaptcha type
is_enabled - Boolean!
Indicates whether reCaptcha type is enabled

Example

{
  "configurations": ReCaptchaConfiguration,
  "is_enabled": true
}

ReCaptchaConfiguration

Contains reCAPTCHA form configuration details.

Fields

Field Name
Description
badge_position - String
The position of the invisible reCAPTCHA badge on each page.
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.
re_captcha_type - ReCaptchaTypeEmum!
technical_failure_message - String!
The message that appears when reCaptcha fails.
theme - String!
Theme to be used to render reCaptcha.
validation_failure_message - String!
The message that appears to the user if validation fails.
website_key - String!
The website key generated when the Google reCAPTCHA account was registered.

Example

{
  "badge_position": "abc123",
  "language_code": "abc123",
  "minimum_score": 987.65,
  "re_captcha_type": "INVISIBLE",
  "technical_failure_message": "abc123",
  "theme": "abc123",
  "validation_failure_message": "xyz789",
  "website_key": "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.
theme - String!
Theme to be used to render reCaptcha.
website_key - String!
The website key generated when the Google reCAPTCHA account was registered.

Example

{
  "badge_position": "xyz789",
  "failure_message": "xyz789",
  "forms": ["PLACE_ORDER"],
  "is_enabled": false,
  "language_code": "xyz789",
  "minimum_score": 123.45,
  "theme": "xyz789",
  "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
RESEND_CONFIRMATION_EMAIL

Example

""PLACE_ORDER""

ReCaptchaTypeEmum

Values

Enum Value
Description
INVISIBLE
RECAPTCHA
RECAPTCHA_V3

Example

""INVISIBLE""

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": "abc123",
  "id": 123,
  "name": "xyz789"
}

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": "abc123"}

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": ["abc123"]
}

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": "abc123",
  "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": 987,
  "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": "abc123",
  "quote_name": "abc123",
  "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]
}

RequestGuestReturnInput

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.
token - String!
Order token.

Example

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

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": "abc123"
}

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": "xyz789",
  "contact_email": "abc123",
  "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": "xyz789",
  "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": 123.45,
  "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": 987.65,
  "selected_options": ["abc123"],
  "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": "xyz789",
  "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": "xyz789",
  "created_at": "abc123",
  "text": "xyz789",
  "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": "xyz789",
  "uid": 4,
  "value": "abc123"
}

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": "xyz789",
  "lastname": "xyz789"
}

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": 123.45,
  "request_quantity": 123.45,
  "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": true,
  "is_unique": true,
  "label": "xyz789",
  "multiline_count": 987,
  "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": "abc123",
  "contact_name": "xyz789",
  "country": Country,
  "postcode": "xyz789",
  "region": Region,
  "street": ["xyz789"],
  "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": "abc123", "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": "abc123",
  "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": "xyz789", "type": "INFORMATION"}

ReturnShippingTrackingStatusType

Values

Enum Value
Description
INFORMATION
ERROR

Example

""INFORMATION""

ReturnStatus

Values

Enum Value
Description
PENDING
UNCONFIRMED
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": 123
}

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": 987.65}

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": "xyz789",
  "points_change": 123.45
}

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": 987.65, "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": 987,
  "relative_url": "abc123",
  "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": 123,
  "relative_url": "xyz789",
  "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": "xyz789"
}

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": 987}

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": 123,
  "label": "xyz789",
  "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.
original_price - Money!
The original price of the value for the selected bundle product option.
price - Float!
The price of the value for the selected bundle product option. (Deprecated: Use priceV2 instead.)
priceV2 - Money!
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",
  "original_price": Money,
  "price": 987.65,
  "priceV2": Money,
  "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 - String!
The unique ID for a selected custom attribute value.

Example

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

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": 987,
  "is_required": false,
  "label": "xyz789",
  "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": 123,
  "label": "abc123",
  "price": CartItemSelectedOptionValuePrice,
  "value": "abc123"
}

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": "abc123",
  "carrier_title": "abc123",
  "method_code": "xyz789",
  "method_title": "xyz789",
  "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": 123,
  "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": "xyz789",
  "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": "abc123"
}

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": "abc123",
  "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": "xyz789",
  "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": false
}

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": "abc123",
  "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": "xyz789",
  "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": "xyz789",
  "name": "abc123"
}

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": "xyz789",
  "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": "xyz789",
  "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": "xyz789",
  "title": "xyz789"
}