CustomOperatorInput

Input Fields

Input Field
Description
type - CustomOperatorType
value - [String]

Example

{
  "type": "UNKNOWN_CUSTOMOPERATOR_TYPE",
  "value": ["abc123"]
}

CustomOperatorType

Values

Enum Value
Description
UNKNOWN_CUSTOMOPERATOR_TYPE
CUSTOM

Example

""UNKNOWN_CUSTOMOPERATOR_TYPE""

Customer

Defines the customer name, addresses, and other details.

Fields

Field Name
Description
addresses - [CustomerAddress]
An array containing the customer's shipping and billing addresses.
addressesV2 - CustomerAddresses
An array containing the customer's shipping and billing addresses.
allow_remote_shopping_assistance - Boolean!
Indicates whether the customer has enabled remote shopping assistance.
companies - UserCompaniesOutput!
An object that contains a list of companies user is assigned to.
compare_list - CompareList
The contents of the customer's compare list.
confirmation_status - ConfirmationStatusEnum!
The customer's confirmation status.
created_at - String
Timestamp indicating when the account was created.
custom_attributes - [AttributeValueInterface]
Customer's custom attributes.
date_of_birth - String
The customer's date of birth.
default_billing - String
The ID assigned to the billing address.
default_shipping - String
The ID assigned to the shipping address.
email - String
The customer's email address. Required.
firstname - String
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
gift_registries - [GiftRegistry]
Details about all of the customer's gift registries.
gift_registry - GiftRegistry
Details about a specific gift registry.
group - CustomerGroupStorefront
Customer group assigned to the customer
id - ID!
The unique ID assigned to the customer. (Deprecated: `id` is not needed as part of `Customer`, because on the server side, it can be identified based on the customer token used for authentication. There is no need to know customer ID on the client side.)
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
job_title - String
The job title of a company user.
lastname - String
The customer's family name.
middlename - String
The customer's middle name.
orders - CustomerOrders
prefix - String
An honorific, such as Dr., Mr., or Mrs.
purchase_order - PurchaseOrder
Purchase order details.
purchase_order_approval_rule - PurchaseOrderApprovalRule
Details about a single purchase order approval rule.
purchase_order_approval_rule_metadata - PurchaseOrderApprovalRuleMetadata
Purchase order approval rule metadata that can be used for rule edit form rendering.
purchase_order_approval_rules - PurchaseOrderApprovalRules
A list of purchase order approval rules visible to the customer.
purchase_orders - PurchaseOrders
A list of purchase orders visible to the customer.
purchase_orders_enabled - Boolean!
Indicates whether purchase order functionality is enabled for the current customer. Global and company-level settings are factored into the result.
quote_enabled - Boolean!
Indicates whether negotiable quote functionality is enabled for the current customer. Global and company-level settings are factored into the result.
requisition_lists - RequisitionLists
An object that contains the customer's requisition lists.
return - Return
Details about the specified return request from the unique ID for a `Return` object.
returns - Returns
Information about the customer's return requests.
reward_points - RewardPoints
Customer reward points details.
role - CompanyRole
The role name and permissions assigned to the company user.
segments - [CustomerSegmentStorefront]
Customer segments associated with the current customer
status - CompanyUserStatusEnum
Indicates whether the company user is ACTIVE or INACTIVE.
store_credit - CustomerStoreCredit
Store credit information applied for the logged in customer.
structure_id - ID!
ID of the company structure
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Value-added tax (VAT) number (for corporate customers).
team - CompanyTeam
The team the company user is assigned to.
telephone - String
The phone number of the company user.
wishlist_v2 - Wishlist
Retrieve the wish list identified by the unique ID for a `Wishlist` object.
wishlists - [Wishlist]!
An array of wishlists. In Magento Open Source, customers are limited to one wish list. The number of wish lists is configurable for Adobe Commerce.

Example

{
  "addresses": [CustomerAddress],
  "addressesV2": CustomerAddresses,
  "allow_remote_shopping_assistance": false,
  "companies": UserCompaniesOutput,
  "compare_list": CompareList,
  "confirmation_status": "ACCOUNT_CONFIRMED",
  "created_at": "xyz789",
  "custom_attributes": [AttributeValueInterface],
  "date_of_birth": "xyz789",
  "default_billing": "xyz789",
  "default_shipping": "xyz789",
  "email": "xyz789",
  "firstname": "xyz789",
  "gender": 987,
  "gift_registries": [GiftRegistry],
  "gift_registry": GiftRegistry,
  "group": CustomerGroupStorefront,
  "id": "4",
  "is_subscribed": true,
  "job_title": "abc123",
  "lastname": "abc123",
  "middlename": "xyz789",
  "orders": CustomerOrders,
  "prefix": "xyz789",
  "purchase_order": PurchaseOrder,
  "purchase_order_approval_rule": PurchaseOrderApprovalRule,
  "purchase_order_approval_rule_metadata": PurchaseOrderApprovalRuleMetadata,
  "purchase_order_approval_rules": PurchaseOrderApprovalRules,
  "purchase_orders": PurchaseOrders,
  "purchase_orders_enabled": false,
  "quote_enabled": true,
  "requisition_lists": RequisitionLists,
  "return": Return,
  "returns": Returns,
  "reward_points": RewardPoints,
  "role": CompanyRole,
  "segments": [CustomerSegmentStorefront],
  "status": "ACTIVE",
  "store_credit": CustomerStoreCredit,
  "structure_id": 4,
  "suffix": "abc123",
  "taxvat": "abc123",
  "team": CompanyTeam,
  "telephone": "xyz789",
  "wishlist_v2": Wishlist,
  "wishlists": [Wishlist]
}

CustomerAddress

Contains detailed information about a customer's billing or shipping address.

Fields

Field Name
Description
city - String
The customer's 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.
default_billing - Boolean
Indicates whether the address is the customer's default billing address.
default_shipping - Boolean
Indicates whether the address is the customer's default shipping address.
extension_attributes - [CustomerAddressAttribute]
Contains any extension attributes for the address.
fax - String
The customer's fax number.
firstname - String
The first name of the person associated with the shipping/billing address.
id - Int
The ID of a `CustomerAddress` object. (Deprecated: Use `uid` instead.)
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 - CustomerAddressRegion
An object containing the region name, region code, and region ID.
region_id - Int
The unique ID for 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 customer's telephone number.
uid - ID
The unique ID for a `CustomerAddress` object.
vat_id - String
The customer's Value-added tax (VAT) number (for corporate customers).

Example

{
  "city": "abc123",
  "company": "abc123",
  "country_code": "AF",
  "custom_attributesV2": [AttributeValueInterface],
  "default_billing": true,
  "default_shipping": true,
  "extension_attributes": [CustomerAddressAttribute],
  "fax": "abc123",
  "firstname": "abc123",
  "id": 987,
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "abc123",
  "prefix": "xyz789",
  "region": CustomerAddressRegion,
  "region_id": 123,
  "street": ["xyz789"],
  "suffix": "abc123",
  "telephone": "abc123",
  "uid": 4,
  "vat_id": "xyz789"
}

CustomerAddressAttribute

Specifies the attribute code and value of a customer address attribute.

Fields

Field Name
Description
attribute_code - String
The name assigned to the customer address attribute.
value - String
The value assigned to the customer address attribute.

Example

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

CustomerAddressInput

Contains details about a billing or shipping address.

Input Fields

Input Field
Description
city - String
The customer's city or town.
company - String
The customer's company.
country_code - CountryCodeEnum
The two-letter code representing the customer's country.
custom_attributesV2 - [AttributeValueInput]
Custom attributes assigned to the customer address.
default_billing - Boolean
Indicates whether the address is the default billing address.
default_shipping - Boolean
Indicates whether the address is the default shipping address.
fax - String
The customer's fax number.
firstname - String
The first name of the person associated with the billing/shipping address.
lastname - String
The family name of the person associated with the billing/shipping address.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The customer's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - CustomerAddressRegionInput
An object containing the region name, region code, and region ID.
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 customer's telephone number.
vat_id - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "city": "abc123",
  "company": "xyz789",
  "country_code": "AF",
  "custom_attributesV2": [AttributeValueInput],
  "default_billing": true,
  "default_shipping": true,
  "fax": "xyz789",
  "firstname": "xyz789",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "abc123",
  "prefix": "xyz789",
  "region": CustomerAddressRegionInput,
  "street": ["xyz789"],
  "suffix": "xyz789",
  "telephone": "abc123",
  "vat_id": "xyz789"
}

CustomerAddressRegion

Defines the customer's state or province.

Fields

Field Name
Description
region - String
The state or province name.
region_code - String
The address region code.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "region": "xyz789",
  "region_code": "xyz789",
  "region_id": 987
}

CustomerAddressRegionInput

Defines the customer's state or province.

Input Fields

Input Field
Description
region - String
The state or province name.
region_code - String
The address region code.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "region": "xyz789",
  "region_code": "xyz789",
  "region_id": 123
}

CustomerAddresses

Fields

Field Name
Description
items - [CustomerAddress]
An array containing the customer's shipping and billing addresses.
page_info - SearchResultPageInfo
Contains pagination metadata.
total_count - Int
The total count of customer addresses.

Example

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

CustomerAttributeMetadata

Customer 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": "xyz789",
  "frontend_input": "BOOLEAN",
  "input_filter": "NONE",
  "is_required": false,
  "is_unique": true,
  "label": "xyz789",
  "multiline_count": 987,
  "options": [CustomAttributeOptionInterface],
  "sort_order": 123,
  "validate_rules": [ValidationRule]
}

CustomerCreateInput

An input object for creating a customer.

Input Fields

Input Field
Description
allow_remote_shopping_assistance - Boolean
Indicates whether the customer has enabled remote shopping assistance.
custom_attributes - [AttributeValueInput]
The customer's custom attributes.
date_of_birth - String
The customer's date of birth.
email - String!
The customer's email address.
firstname - String!
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
lastname - String!
The customer's family name.
middlename - String
The customer's middle name.
password - String
The customer's password.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "allow_remote_shopping_assistance": false,
  "custom_attributes": [AttributeValueInput],
  "date_of_birth": "abc123",
  "email": "abc123",
  "firstname": "xyz789",
  "gender": 987,
  "is_subscribed": false,
  "lastname": "abc123",
  "middlename": "abc123",
  "password": "xyz789",
  "prefix": "abc123",
  "suffix": "abc123",
  "taxvat": "xyz789"
}

CustomerDownloadableProduct

Contains details about a single downloadable product.

Fields

Field Name
Description
date - String
The date and time the purchase was made.
download_url - String
The fully qualified URL to the download file.
order_increment_id - String
The unique ID assigned to the item.
remaining_downloads - String
The remaining number of times the customer can download the product.
status - String
Indicates when the product becomes available for download. Options are `Pending` and `Invoiced`.

Example

{
  "date": "abc123",
  "download_url": "abc123",
  "order_increment_id": "abc123",
  "remaining_downloads": "xyz789",
  "status": "abc123"
}

CustomerDownloadableProducts

Contains a list of downloadable products.

Fields

Field Name
Description
items - [CustomerDownloadableProduct]
An array of purchased downloadable items.

Example

{"items": [CustomerDownloadableProduct]}

CustomerGroupStorefront

Data of customer group.

Fields

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

Example

{"uid": "4"}

CustomerOrder

Contains details about each of the customer's orders.

Fields

Field Name
Description
applied_coupons - [AppliedCoupon]!
Coupons applied to the order.
applied_gift_cards - [ApplyGiftCardToOrder]
An array of gift cards applied to the order.
available_actions - [OrderActionType]!
List of available order actions.
billing_address - OrderAddress
The billing address for the order.
carrier - String
The shipping carrier for the order delivery.
comments - [SalesCommentItem]
Comments about the order.
credit_memos - [CreditMemo]
A list of credit memos.
custom_attributes - [CustomAttribute]
The custom attributes for the order
customer_info - OrderCustomerInfo!
Returns customer information from order.
email - String
Order customer email.
gift_message - GiftMessage
The entered gift message for the order
gift_receipt_included - Boolean!
Indicates whether the customer requested a gift receipt for the order.
gift_wrapping - GiftWrapping
The selected gift wrapping for the order.
id - ID!
The unique ID for a `CustomerOrder` object.
invoices - [Invoice]!
A list of invoices for the order.
is_virtual - Boolean!
`TRUE` if the order is virtual
items - [OrderItemInterface]
An array containing the items purchased in this order.
items_eligible_for_return - [OrderItemInterface]
A list of order items eligible to be in a return request.
negotiable_quote - NegotiableQuote
The negotiable quote associated with this order.
number - String!
The order number.
order_date - String!
The date the order was placed.
order_status_change_date - String!
The date the order status was last updated.
payment_methods - [OrderPaymentMethod]
Payment details for the order.
printed_card_included - Boolean!
Indicates whether the customer requested a printed card for the order.
returns - Returns
Return requests associated with this order.
shipments - [OrderShipment]
A list of shipments for the order.
shipping_address - OrderAddress
The shipping address for the order.
shipping_method - String
The delivery method for the order.
status - String!
The current status of the order.
token - String!
The token that can be used to retrieve the order using order query.
total - OrderTotal
Details about the calculated totals for this order.

Example

{
  "applied_coupons": [AppliedCoupon],
  "applied_gift_cards": [ApplyGiftCardToOrder],
  "available_actions": ["REORDER"],
  "billing_address": OrderAddress,
  "carrier": "xyz789",
  "comments": [SalesCommentItem],
  "credit_memos": [CreditMemo],
  "custom_attributes": [CustomAttribute],
  "customer_info": OrderCustomerInfo,
  "email": "xyz789",
  "gift_message": GiftMessage,
  "gift_receipt_included": false,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "invoices": [Invoice],
  "is_virtual": true,
  "items": [OrderItemInterface],
  "items_eligible_for_return": [OrderItemInterface],
  "negotiable_quote": NegotiableQuote,
  "number": "abc123",
  "order_date": "xyz789",
  "order_status_change_date": "abc123",
  "payment_methods": [OrderPaymentMethod],
  "printed_card_included": false,
  "returns": Returns,
  "shipments": [OrderShipment],
  "shipping_address": OrderAddress,
  "shipping_method": "xyz789",
  "status": "abc123",
  "token": "xyz789",
  "total": OrderTotal
}

CustomerOrderSortInput

CustomerOrderSortInput specifies the field to use for sorting search results and indicates whether the results are sorted in ascending or descending order.

Input Fields

Input Field
Description
sort_direction - SortEnum!
This enumeration indicates whether to return results in ascending or descending order
sort_field - CustomerOrderSortableField!
Specifies the field to use for sorting

Example

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

CustomerOrderSortableField

Specifies the field to use for sorting

Values

Enum Value
Description
NUMBER
Sorts customer orders by number
CREATED_AT
Sorts customer orders by created_at field

Example

""NUMBER""

CustomerOrders

The collection of orders that match the conditions defined in the filter.

Fields

Field Name
Description
date_of_first_order - String
Date of the first order placed in the store
items - [CustomerOrder]!
An array of customer orders.
page_info - SearchResultPageInfo
Contains pagination metadata.
total_count - Int
The total count of customer orders.

Example

{
  "date_of_first_order": "xyz789",
  "items": [CustomerOrder],
  "page_info": SearchResultPageInfo,
  "total_count": 987
}

CustomerOrdersFilterInput

Identifies the filter to use for filtering orders.

Input Fields

Input Field
Description
grand_total - FilterRangeTypeInput
Filters by order base grand total value.
number - FilterStringTypeInput
Filters by order number.
order_date - FilterRangeTypeInput
Filters by order created_at time.
status - FilterEqualTypeInput
Filters by order status.

Example

{
  "grand_total": FilterRangeTypeInput,
  "number": FilterStringTypeInput,
  "order_date": FilterRangeTypeInput,
  "status": FilterEqualTypeInput
}

CustomerOutput

Contains details about a newly-created or updated customer.

Fields

Field Name
Description
customer - Customer!
Customer details after creating or updating a customer.

Example

{"customer": Customer}

CustomerPaymentTokens

Contains payment tokens stored in the customer's vault.

Fields

Field Name
Description
items - [PaymentToken]!
An array of payment tokens.

Example

{"items": [PaymentToken]}

CustomerSegmentStorefront

Customer segment details

Fields

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

Example

{"uid": "4"}

CustomerStoreCredit

Contains store credit information with balance and history.

Fields

Field Name
Description
balance_history - CustomerStoreCreditHistory
Contains the customer's store credit balance history. If the history or store credit feature is disabled, then a null value will be returned.
current_balance - Money
The current balance of store credit.
enabled - Boolean
Indicates whether store credits are enabled. If the feature is disabled, then the balance will not be returned.

Example

{
  "balance_history": CustomerStoreCreditHistory,
  "current_balance": Money,
  "enabled": false
}

CustomerStoreCreditHistory

Lists changes to the amount of store credit available to the customer.

Fields

Field Name
Description
items - [CustomerStoreCreditHistoryItem]
An array containing information about changes to the store credit available to the customer.
page_info - SearchResultPageInfo
Metadata for pagination rendering.
total_count - Int
The number of items returned.

Example

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

CustomerStoreCreditHistoryItem

Contains store credit history information.

Fields

Field Name
Description
action - String
The action that was made on the store credit.
actual_balance - Money
The store credit available to the customer as a result of this action.
balance_change - Money
The amount added to or subtracted from the store credit as a result of this action.
date_time_changed - String
The date and time when the store credit change was made.

Example

{
  "action": "xyz789",
  "actual_balance": Money,
  "balance_change": Money,
  "date_time_changed": "abc123"
}

CustomerToken

Contains a customer authorization token.

Fields

Field Name
Description
token - String
The customer authorization token.

Example

{"token": "abc123"}

CustomerUpdateInput

An input object for updating a customer.

Input Fields

Input Field
Description
allow_remote_shopping_assistance - Boolean
Indicates whether the customer has enabled remote shopping assistance.
custom_attributes - [AttributeValueInput]
The customer's custom attributes.
date_of_birth - String
The customer's date of birth.
firstname - String
The customer's first name.
gender - Int
The customer's gender (Male - 1, Female - 2).
is_subscribed - Boolean
Indicates whether the customer is subscribed to the company's newsletter.
lastname - String
The customer's family name.
middlename - String
The customer's middle name.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
suffix - String
A value such as Sr., Jr., or III.
taxvat - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "allow_remote_shopping_assistance": true,
  "custom_attributes": [AttributeValueInput],
  "date_of_birth": "abc123",
  "firstname": "abc123",
  "gender": 123,
  "is_subscribed": true,
  "lastname": "xyz789",
  "middlename": "xyz789",
  "prefix": "abc123",
  "suffix": "xyz789",
  "taxvat": "xyz789"
}

CustomizableAreaOption

Contains information about a text area that is defined as part of a customizable option.

Fields

Field Name
Description
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - CustomizableAreaValue
An object that defines a text area.

Example

{
  "product_sku": "xyz789",
  "required": false,
  "sort_order": 123,
  "title": "xyz789",
  "uid": "4",
  "value": CustomizableAreaValue
}

CustomizableAreaValue

Defines the price and sku of a product whose page contains a customized text area.

Fields

Field Name
Description
max_characters - Int
The maximum number of characters that can be entered for this customizable option.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
uid - ID!
The unique ID for a `CustomizableAreaValue` object.

Example

{
  "max_characters": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "uid": "4"
}

CustomizableCheckboxOption

Contains information about a set of checkbox values that are defined as part of a customizable option.

Fields

Field Name
Description
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - [CustomizableCheckboxValue]
An array that defines a set of checkbox values.

Example

{
  "required": false,
  "sort_order": 123,
  "title": "abc123",
  "uid": "4",
  "value": [CustomizableCheckboxValue]
}

CustomizableCheckboxValue

Defines the price and sku of a product whose page contains a customized set of checkbox values.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the checkbox value is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableCheckboxValue` object.

Example

{
  "option_type_id": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 123,
  "title": "abc123",
  "uid": "4"
}

CustomizableDateOption

Contains information about a date picker that is defined as part of a customizable option.

Fields

Field Name
Description
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - CustomizableDateValue
An object that defines a date field in a customizable option.

Example

{
  "product_sku": "xyz789",
  "required": true,
  "sort_order": 987,
  "title": "abc123",
  "uid": "4",
  "value": CustomizableDateValue
}

CustomizableDateTypeEnum

Defines the customizable date type.

Values

Enum Value
Description
DATE
DATE_TIME
TIME

Example

""DATE""

CustomizableDateValue

Defines the price and sku of a product whose page contains a customized date picker.

Fields

Field Name
Description
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
type - CustomizableDateTypeEnum
DATE, DATE_TIME or TIME
uid - ID!
The unique ID for a `CustomizableDateValue` object.

Example

{
  "price": 123.45,
  "price_type": "FIXED",
  "sku": "abc123",
  "type": "DATE",
  "uid": "4"
}

CustomizableDropDownOption

Contains information about a drop down menu that is defined as part of a customizable option.

Fields

Field Name
Description
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - [CustomizableDropDownValue]
An array that defines the set of options for a drop down menu.

Example

{
  "required": true,
  "sort_order": 123,
  "title": "abc123",
  "uid": 4,
  "value": [CustomizableDropDownValue]
}

CustomizableDropDownValue

Defines the price and sku of a product whose page contains a customized drop down menu.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableDropDownValue` object.

Example

{
  "option_type_id": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 123,
  "title": "abc123",
  "uid": "4"
}

CustomizableFieldOption

Contains information about a text field that is defined as part of a customizable option.

Fields

Field Name
Description
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - CustomizableFieldValue
An object that defines a text field.

Example

{
  "product_sku": "xyz789",
  "required": true,
  "sort_order": 987,
  "title": "xyz789",
  "uid": "4",
  "value": CustomizableFieldValue
}

CustomizableFieldValue

Defines the price and sku of a product whose page contains a customized text field.

Fields

Field Name
Description
max_characters - Int
The maximum number of characters that can be entered for this customizable option.
price - Float
The price of the custom value.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
uid - ID!
The unique ID for a `CustomizableFieldValue` object.

Example

{
  "max_characters": 123,
  "price": 123.45,
  "price_type": "FIXED",
  "sku": "xyz789",
  "uid": 4
}

CustomizableFileOption

Contains information about a file picker that is defined as part of a customizable option.

Fields

Field Name
Description
product_sku - String
The Stock Keeping Unit of the base product.
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - CustomizableFileValue
An object that defines a file value.

Example

{
  "product_sku": "abc123",
  "required": true,
  "sort_order": 987,
  "title": "xyz789",
  "uid": 4,
  "value": CustomizableFileValue
}

CustomizableFileValue

Defines the price and sku of a product whose page contains a customized file picker.

Fields

Field Name
Description
file_extension - String
The file extension to accept.
image_size_x - Int
The maximum width of an image.
image_size_y - Int
The maximum height of an image.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
uid - ID!
The unique ID for a `CustomizableFileValue` object.

Example

{
  "file_extension": "xyz789",
  "image_size_x": 987,
  "image_size_y": 123,
  "price": 123.45,
  "price_type": "FIXED",
  "sku": "xyz789",
  "uid": 4
}

CustomizableMultipleOption

Contains information about a multiselect that is defined as part of a customizable option.

Fields

Field Name
Description
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - [CustomizableMultipleValue]
An array that defines the set of options for a multiselect.

Example

{
  "required": false,
  "sort_order": 123,
  "title": "xyz789",
  "uid": "4",
  "value": [CustomizableMultipleValue]
}

CustomizableMultipleValue

Defines the price and sku of a product whose page contains a customized multiselect.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableMultipleValue` object.

Example

{
  "option_type_id": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 987,
  "title": "abc123",
  "uid": 4
}

CustomizableOptionInput

Defines a customizable option.

Input Fields

Input Field
Description
uid - ID
The unique ID for a `CartItemInterface` object.
value_string - String!
The string value of the option.

Example

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

CustomizableOptionInterface

Contains basic information about a customizable option. It can be implemented by several types of configurable options.

Fields

Field Name
Description
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.

Possible Types

Example

{
  "required": true,
  "sort_order": 987,
  "title": "xyz789",
  "uid": "4"
}

CustomizableProductInterface

Contains information about customizable product options.

Fields

Field Name
Description
options - [CustomizableOptionInterface]
An array of options for a customizable product.

Possible Types

Example

{"options": [CustomizableOptionInterface]}

CustomizableRadioOption

Contains information about a set of radio buttons that are defined as part of a customizable option.

Fields

Field Name
Description
required - Boolean
Indicates whether the option is required.
sort_order - Int
The order in which the option is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableOptionInterface` object.
value - [CustomizableRadioValue]
An array that defines a set of radio buttons.

Example

{
  "required": true,
  "sort_order": 123,
  "title": "xyz789",
  "uid": "4",
  "value": [CustomizableRadioValue]
}

CustomizableRadioValue

Defines the price and sku of a product whose page contains a customized set of radio buttons.

Fields

Field Name
Description
option_type_id - Int
The ID assigned to the value.
price - Float
The price assigned to this option.
price_type - PriceTypeEnum
FIXED, PERCENT, or DYNAMIC.
sku - String
The Stock Keeping Unit for this option.
sort_order - Int
The order in which the radio button is displayed.
title - String
The display name for this option.
uid - ID!
The unique ID for a `CustomizableRadioValue` object.

Example

{
  "option_type_id": 987,
  "price": 987.65,
  "price_type": "FIXED",
  "sku": "abc123",
  "sort_order": 123,
  "title": "xyz789",
  "uid": 4
}

DateTime

A slightly refined version of RFC-3339 compliant DateTime Scalar

Example

"2007-12-03T10:15:30Z"

DeleteCompanyRoleOutput

Contains the response to the request to delete the company role.

Fields

Field Name
Description
success - Boolean!
SIndicates whether the company role has been deleted successfully.

Example

{"success": false}

DeleteCompanyTeamOutput

Contains the status of the request to delete a company team.

Fields

Field Name
Description
success - Boolean!
Indicates whether the delete operation succeeded.

Example

{"success": true}

DeleteCompanyUserOutput

Contains the response to the request to delete the company user.

Fields

Field Name
Description
success - Boolean!
Indicates whether the company user has been deactivated successfully.

Example

{"success": false}

DeleteCompareListOutput

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

Fields

Field Name
Description
result - Boolean!
Indicates whether the compare list was successfully deleted.

Example

{"result": true}

DeleteNegotiableQuoteError

Types

Example

NegotiableQuoteInvalidStateError

DeleteNegotiableQuoteOperationFailure

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

Fields

Field Name
Description
errors - [DeleteNegotiableQuoteError]!
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

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

DeleteNegotiableQuoteOperationResult

Types

Example

NegotiableQuoteUidOperationSuccess

DeleteNegotiableQuoteTemplateInput

Specifies the quote template id of the quote template to delete

Input Fields

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

Example

{"template_id": 4}

DeleteNegotiableQuotesInput

Input Fields

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

Example

{"quote_uids": ["4"]}

DeleteNegotiableQuotesOutput

Contains a list of undeleted negotiable quotes the company user can view.

Fields

Field Name
Description
negotiable_quotes - NegotiableQuotesOutput
A list of negotiable quotes that the customer can view
operation_results - [DeleteNegotiableQuoteOperationResult]!
An array of deleted negotiable quote UIDs and details about any errors.
result_status - BatchMutationStatus!
The status of the request to delete one or more negotiable quotes.

Example

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

DeletePaymentTokenOutput

Indicates whether the request succeeded and returns the remaining customer payment tokens.

Fields

Field Name
Description
customerPaymentTokens - CustomerPaymentTokens
A container for the customer's remaining payment tokens.
result - Boolean!
Indicates whether the request succeeded.

Example

{
  "customerPaymentTokens": CustomerPaymentTokens,
  "result": true
}

DeletePurchaseOrderApprovalRuleError

Contains details about an error that occurred when deleting an approval rule .

Fields

Field Name
Description
message - String
The text of the error message.
type - DeletePurchaseOrderApprovalRuleErrorType
The error type.

Example

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

DeletePurchaseOrderApprovalRuleErrorType

Values

Enum Value
Description
UNDEFINED
NOT_FOUND

Example

""UNDEFINED""

DeletePurchaseOrderApprovalRuleInput

Specifies the IDs of the approval rules to delete.

Input Fields

Input Field
Description
approval_rule_uids - [ID]!
An array of purchase order approval rule IDs.

Example

{"approval_rule_uids": ["4"]}

DeletePurchaseOrderApprovalRuleOutput

Contains any errors encountered while attempting to delete approval rules.

Fields

Field Name
Description
errors - [DeletePurchaseOrderApprovalRuleError]!
An array of error messages encountered while performing the operation.

Example

{"errors": [DeletePurchaseOrderApprovalRuleError]}

DeleteRequisitionListItemsOutput

Output of the request to remove items from the requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The requisition list after removing items.

Example

{"requisition_list": RequisitionList}

DeleteRequisitionListOutput

Indicates whether the request to delete the requisition list was successful.

Fields

Field Name
Description
requisition_lists - RequisitionLists
The customer's requisition lists after deleting a requisition list.
status - Boolean!
Indicates whether the request to delete the requisition list was successful.

Example

{"requisition_lists": RequisitionLists, "status": false}

DeleteWishlistOutput

Contains the status of the request to delete a wish list and an array of the customer's remaining wish lists.

Fields

Field Name
Description
status - Boolean!
Indicates whether the wish list was deleted.
wishlists - [Wishlist]!
A list of undeleted wish lists.

Example

{"status": false, "wishlists": [Wishlist]}

Discount

Specifies the discount type and value for quote line item.

Fields

Field Name
Description
amount - Money!
The amount of the discount.
applied_to - CartDiscountType!
The type of the entity the discount is applied to.
coupon - AppliedCoupon
The coupon related to the discount.
is_discounting_locked - Boolean
Is quote discounting locked for line item.
label - String!
A description of the discount.
type - String
Quote line item discount type. Values: 1 = PERCENTAGE_DISCOUNT; 2 = AMOUNT_DISCOUNT; 3 = PROPOSED_TOTAL.
value - Float
Quote line item discount value.

Example

{
  "amount": Money,
  "applied_to": "ITEM",
  "coupon": AppliedCoupon,
  "is_discounting_locked": true,
  "label": "abc123",
  "type": "xyz789",
  "value": 123.45
}

DownloadableCartItem

An implementation for downloadable product cart items.

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the cart item
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
links - [DownloadableProductLinks]
An array containing information about the links for the downloadable product added to the cart.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
not_available_message - String
Message to display when the product is not available with this selected option.
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this item in the cart.
samples - [DownloadableProductSamples]
An array containing information about samples of the selected downloadable product.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "custom_attributes": [CustomAttribute],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "is_available": true,
  "links": [DownloadableProductLinks],
  "max_qty": 123.45,
  "min_qty": 987.65,
  "not_available_message": "abc123",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "samples": [DownloadableProductSamples],
  "uid": 4
}

DownloadableCreditMemoItem

Defines downloadable product options for CreditMemoItemInterface.

Fields

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

Example

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

DownloadableInvoiceItem

Defines downloadable product options for InvoiceItemInterface.

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the invoice item
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
downloadable_links - [DownloadableItemsLinks]
A list of downloadable links that are invoiced from the downloadable product.
id - ID!
The unique ID for an `InvoiceItemInterface` object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Example

{
  "custom_attributes": [CustomAttribute],
  "discounts": [Discount],
  "downloadable_links": [DownloadableItemsLinks],
  "id": 4,
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_invoiced": 987.65
}

Defines characteristics of the links for downloadable product.

Fields

Field Name
Description
sort_order - Int
A number indicating the sort order.
title - String
The display name of the link.
uid - ID!
The unique ID for a `DownloadableItemsLinks` object.

Example

{
  "sort_order": 123,
  "title": "xyz789",
  "uid": "4"
}

DownloadableOrderItem

Defines downloadable product options for OrderItemInterface.

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the order item
discounts - [Discount]
The final discount information for the product.
downloadable_links - [DownloadableItemsLinks]
A list of downloadable links that are ordered from the downloadable 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 (Deprecated: Product information is part of a composable Catalog Service.)
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

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

DownloadableProduct

Defines a product that the shopper downloads.

Fields

Field Name
Description
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.
country_of_manufacture - String
The product's country of origin.
crosssell_products - [ProductInterface]
Crosssell Products
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
downloadable_product_links - [DownloadableProductLinks]
An array containing information about the links for this downloadable product.
downloadable_product_samples - [DownloadableProductSamples]
An array containing information about samples of this downloadable product.
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.
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
links_purchased_separately - Int
A value of 1 indicates that each link in the array must be purchased separately.
links_title - String
The heading above the list of downloadable products.
manufacturer - Int
A number representing the product's manufacturer.
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
quantity - Float
Quantity of available stock
related_products - [ProductInterface]
An array of products to be displayed in a Related Products block.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
uid - ID!
The unique ID for a `ProductInterface` object.
upsell_products - [ProductInterface]
Upsell Products
url_key - String
The part of the URL that identifies the product

Example

{
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "country_of_manufacture": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "downloadable_product_links": [
    DownloadableProductLinks
  ],
  "downloadable_product_samples": [
    DownloadableProductSamples
  ],
  "gift_message_available": true,
  "gift_wrapping_available": false,
  "gift_wrapping_price": Money,
  "image": ProductImage,
  "is_returnable": "abc123",
  "links_purchased_separately": 987,
  "links_title": "abc123",
  "manufacturer": 123,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "min_sale_qty": 987.65,
  "name": "abc123",
  "new_from_date": "abc123",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "quantity": 987.65,
  "related_products": [ProductInterface],
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "stock_status": "IN_STOCK",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "uid": 4,
  "upsell_products": [ProductInterface],
  "url_key": "xyz789"
}

DownloadableProductCartItemInput

Defines a single downloadable product.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
The ID and value of the option.
data - CartItemInput!
The quantity and SKU of the downloadable product.
downloadable_product_links - [DownloadableProductLinksInput]
An array of objects containing the link_id of the downloadable product link.

Example

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

Defines characteristics of a downloadable product.

Fields

Field Name
Description
price - Float
The price of the downloadable product.
sample_url - String
The full URL to the downloadable sample.
sort_order - Int
A number indicating the sort order.
title - String
The display name of the link.
uid - ID!
The unique ID for a `DownloadableProductLinks` object.

Example

{
  "price": 123.45,
  "sample_url": "xyz789",
  "sort_order": 987,
  "title": "abc123",
  "uid": 4
}

DownloadableProductLinksInput

Contains the link ID for the downloadable product.

Input Fields

Input Field
Description
link_id - Int!
The unique ID of the downloadable product link.

Example

{"link_id": 123}

DownloadableProductSamples

Defines characteristics of a downloadable product.

Fields

Field Name
Description
sample_url - String
The full URL to the downloadable sample.
sort_order - Int
A number indicating the sort order.
title - String
The display name of the sample.

Example

{
  "sample_url": "abc123",
  "sort_order": 987,
  "title": "abc123"
}

DownloadableRequisitionListItem

Contains details about downloadable products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
links - [DownloadableProductLinks]
An array of links for downloadable products in the requisition list.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The quantity of the product added to the requisition list.
samples - [DownloadableProductSamples]
An array of links to downloadable product samples.
sku - String!
The product SKU.
uid - ID!
The unique ID of an item in a requisition list.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "links": [DownloadableProductLinks],
  "product": ProductInterface,
  "quantity": 123.45,
  "samples": [DownloadableProductSamples],
  "sku": "abc123",
  "uid": 4
}

DownloadableWishlistItem

A downloadable product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
links_v2 - [DownloadableProductLinks]
An array containing information about the selected links.
product - ProductInterface!
Product details of the wish list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.
samples - [DownloadableProductSamples]
An array containing information about the selected samples.

Example

{
  "added_at": "abc123",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": "4",
  "links_v2": [DownloadableProductLinks],
  "product": ProductInterface,
  "quantity": 123.45,
  "samples": [DownloadableProductSamples]
}

DuplicateNegotiableQuoteInput

Identifies a quote to be duplicated

Input Fields

Input Field
Description
duplicated_quote_uid - ID!
ID for the newly duplicated quote.
quote_uid - ID!
ID of the quote to be duplicated.

Example

{"duplicated_quote_uid": 4, "quote_uid": 4}

DuplicateNegotiableQuoteOutput

Contains the newly created negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
Negotiable Quote resulting from duplication operation.

Example

{"quote": NegotiableQuote}

EnteredCustomAttributeInput

Contains details about a custom text attribute that the buyer entered.

Input Fields

Input Field
Description
attribute_code - String!
A string that identifies the entered custom attribute.
value - String!
The text or other entered value.

Example

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

EnteredOptionInput

Defines a customer-entered option.

Input Fields

Input Field
Description
uid - ID!
The unique ID for a `CustomizableOptionInterface` object, such as a `CustomizableFieldOption`, `CustomizableFileOption`, or `CustomizableAreaOption` object.
value - String!
Text the customer entered.

Example

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

Error

An error encountered while adding an item to the the cart.

Fields

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

Possible Types

Example

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

ErrorInterface

Fields

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

Possible Types

Example

{"message": "xyz789"}

EstimateAddressInput

Contains details about an address.

Input Fields

Input Field
Description
country_code - CountryCodeEnum!
The two-letter code representing the customer's country.
postcode - String
The customer's ZIP or postal code.
region - CustomerAddressRegionInput
An object containing the region name, region code, and region ID.

Example

{
  "country_code": "AF",
  "postcode": "xyz789",
  "region": CustomerAddressRegionInput
}

EstimateTotalsInput

Input Fields

Input Field
Description
address - EstimateAddressInput!
Customer's address to estimate totals.
cart_id - String!
The unique ID of the cart to query.
shipping_method - ShippingMethodInput
Selected shipping method to estimate totals.

Example

{
  "address": EstimateAddressInput,
  "cart_id": "xyz789",
  "shipping_method": ShippingMethodInput
}

EstimateTotalsOutput

Estimate totals output.

Fields

Field Name
Description
cart - Cart
Cart after totals estimation

Example

{"cart": Cart}

ExchangeExternalCustomerTokenInput

Contains details about external customer.

Input Fields

Input Field
Description
customer - CustomerCreateInput!
An input object that defines the customer characteristics to update.

Example

{"customer": CustomerCreateInput}

ExchangeExternalCustomerTokenOutput

Contains customer token for external customer.

Fields

Field Name
Description
customer - Customer!
Return detailed information about a customer account.
token - String!
The customer authorization token.

Example

{
  "customer": Customer,
  "token": "abc123"
}

ExchangeRate

Lists the exchange rate.

Fields

Field Name
Description
currency_to - String
Specifies the store’s default currency to exchange to.
rate - Float
The exchange rate for the store’s default currency.

Example

{"currency_to": "xyz789", "rate": 987.65}

FastlaneConfig

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
payment_source - String
The payment source for the payment method
sdk_params - [SDKParams]
The PayPal parameters required to load the JS SDK
sort_order - String
The relative order the payment method is displayed on the checkout page
three_ds_mode - ThreeDSMode
3DS mode
title - String
The name displayed for the payment method

Example

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

FastlaneMethodInput

Fastlane Payment inputs

Input Fields

Input Field
Description
payment_source - String
The payment source for the payment method
paypal_fastlane_token - String
The single use token from Fastlane

Example

{
  "payment_source": "abc123",
  "paypal_fastlane_token": "abc123"
}

Field

Values

Enum Value
Description
UNKNOWN_FIELD
CATEGORY
PRICE
PRODUCT
OUT_OF_STOCK
LOW_STOCK
TYPE
VISIBILITY

Example

""UNKNOWN_FIELD""

FilterEqualTypeInput

Defines a filter that matches the input exactly.

Input Fields

Input Field
Description
eq - String
Use this attribute to exactly match the specified string. For example, to filter on a specific category ID, specify a value such as `5`.
in - [String]
Use this attribute to filter on an array of values. For example, to filter on category IDs 4, 5, and 6, specify a value of `["4", "5", "6"]`.

Example

{
  "eq": "abc123",
  "in": ["xyz789"]
}

FilterMatchTypeEnum

Values

Enum Value
Description
FULL
PARTIAL

Example

""FULL""

FilterMatchTypeInput

Defines a filter that performs a fuzzy search.

Input Fields

Input Field
Description
match - String
Use this attribute to fuzzy match the specified string. For example, to filter on a specific SKU, specify a value such as `24-MB01`.
match_type - FilterMatchTypeEnum
Filter match type for fine-tuned results. Possible values FULL or PARTIAL. If match_type is not provided, returned results will default to FULL match.

Example

{"match": "xyz789", "match_type": "FULL"}

FilterRangeTypeInput

Defines a filter that matches a range of values, such as prices or dates.

Input Fields

Input Field
Description
from - String
Use this attribute to specify the lowest possible value in the range.
to - String
Use this attribute to specify the highest possible value in the range.

Example

{
  "from": "abc123",
  "to": "abc123"
}

FilterRuleInput

Input Fields

Input Field
Description
name - String
type - FilterRuleType
conditions - [ConditionInput]

Example

{
  "name": "xyz789",
  "type": "UNKNOWN_FILTER_RULE_TYPE",
  "conditions": [ConditionInput]
}

FilterRuleType

Values

Enum Value
Description
UNKNOWN_FILTER_RULE_TYPE
INCLUSION
EXCLUSION

Example

""UNKNOWN_FILTER_RULE_TYPE""

FilterStringTypeInput

Defines a filter for an input string.

Input Fields

Input Field
Description
eq - String
Filters items that are exactly the same as the specified string.
in - [String]
Filters items that are exactly the same as entries specified in an array of strings.
match - String
Defines a filter that performs a fuzzy search using the specified string.

Example

{
  "eq": "abc123",
  "in": ["xyz789"],
  "match": "xyz789"
}

FilterTypeInput

Defines the comparison operators that can be used in a filter.

Input Fields

Input Field
Description
eq - String
Equals.
from - String
From. Must be used with the `to` field.
gt - String
Greater than.
gteq - String
Greater than or equal to.
in - [String]
In. The value can contain a set of comma-separated values.
like - String
Like. The specified value can contain % (percent signs) to allow matching of 0 or more characters.
lt - String
Less than.
lteq - String
Less than or equal to.
moreq - String
More than or equal to.
neq - String
Not equal to.
nin - [String]
Not in. The value can contain a set of comma-separated values.
notnull - String
Not null.
null - String
Is null.
to - String
To. Must be used with the `from` field.

Example

{
  "eq": "abc123",
  "from": "abc123",
  "gt": "xyz789",
  "gteq": "xyz789",
  "in": ["xyz789"],
  "like": "abc123",
  "lt": "xyz789",
  "lteq": "xyz789",
  "moreq": "xyz789",
  "neq": "abc123",
  "nin": ["xyz789"],
  "notnull": "abc123",
  "null": "abc123",
  "to": "abc123"
}

FilterableInSearchAttribute

Contains product attributes that can be used for filtering in a productSearch query

Fields

Field Name
Description
attribute - String!
The unique identifier for an attribute code. This value should be in lowercase letters and without spaces
frontendInput - String
Indicates how field rendered on storefront
label - String
The display name assigned to the attribute
numeric - Boolean
Indicates whether this attribute has a numeric value, such as a price or integer

Example

{
  "attribute": "abc123",
  "frontendInput": "abc123",
  "label": "abc123",
  "numeric": true
}

FixedProductTax

A single FPT that can be applied to a product price.

Fields

Field Name
Description
amount - Money
The amount of the Fixed Product Tax.
label - String
The display label assigned to the Fixed Product Tax.

Example

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

FixedProductTaxDisplaySettings

Lists display settings for the Fixed Product Tax.

Values

Enum Value
Description
INCLUDE_FPT_WITHOUT_DETAILS
The displayed price includes the FPT amount without displaying the `ProductPrice.fixed_product_taxes` values. This value corresponds to 'Including FPT only'.
INCLUDE_FPT_WITH_DETAILS
The displayed price includes the FPT amount while displaying the values of `ProductPrice.fixed_product_taxes` separately. This value corresponds to 'Including FPT and FPT description'.
EXCLUDE_FPT_AND_INCLUDE_WITH_DETAILS
The displayed price does not include the FPT amount. The values of `ProductPrice.fixed_product_taxes` and the price including the FPT are displayed separately. This value corresponds to 'Excluding FPT, Including FPT description and final price.'
EXCLUDE_FPT_WITHOUT_DETAILS
The displayed price does not include the FPT amount. The values from `ProductPrice.fixed_product_taxes` are not displayed. This value corresponds to 'Excluding FPT'.
FPT_DISABLED
The FPT feature is not enabled. You can omit `ProductPrice.fixed_product_taxes` from your query.

Example

""INCLUDE_FPT_WITHOUT_DETAILS""

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example

123.45

GenerateCustomerTokenAsAdminInput

Identifies which customer requires remote shopping assistance.

Input Fields

Input Field
Description
customer_email - String!
The email address of the customer requesting remote shopping assistance.

Example

{"customer_email": "abc123"}

GenerateCustomerTokenAsAdminOutput

Contains the generated customer token.

Fields

Field Name
Description
customer_token - String!
The generated customer token.

Example

{"customer_token": "xyz789"}

GenerateNegotiableQuoteFromTemplateInput

Specifies the template id, from which to generate quote from.

Input Fields

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

Example

{"template_id": 4}

GenerateNegotiableQuoteFromTemplateOutput

Contains the generated negotiable quote id.

Fields

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

Example

{"negotiable_quote_uid": "4"}

GetPaymentSDKOutput

Gets the payment SDK URLs and values

Fields

Field Name
Description
sdkParams - [PaymentSDKParamsItem]
The payment SDK parameters

Example

{"sdkParams": [PaymentSDKParamsItem]}

GiftCardAccount

Contains details about the gift card account.

Fields

Field Name
Description
balance - Money
The balance remaining on the gift card.
code - String
The gift card account code.
expiration_date - String
The expiration date of the gift card.

Example

{
  "balance": Money,
  "code": "xyz789",
  "expiration_date": "xyz789"
}

GiftCardAccountInput

Contains the gift card code.

Input Fields

Input Field
Description
gift_card_code - String!
The applied gift card code.

Example

{"gift_card_code": "xyz789"}

GiftCardAmounts

Contains the value of a gift card, the website that generated the card, and related information.

Fields

Field Name
Description
attribute_id - Int
An internal attribute ID.
uid - ID!
The unique ID for a `GiftCardAmounts` object.
value - Float
The value of the gift card.
website_id - Int
The ID of the website that generated the gift card.
website_value - Float
The value of the gift card.

Example

{
  "attribute_id": 987,
  "uid": 4,
  "value": 987.65,
  "website_id": 123,
  "website_value": 987.65
}

GiftCardCartItem

Contains details about a gift card that has been added to a cart.

Fields

Field Name
Description
amount - Money!
The amount and currency of the gift card.
available_gift_wrapping - [GiftWrapping]!
The list of available gift wrapping options for the cart item.
custom_attributes - [CustomAttribute]
The custom attributes for the cart item
customizable_options - [SelectedCustomizableOption]!
An array of customizations applied to the gift card.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
gift_message - GiftMessage
The entered gift message data for the gift card cart item
gift_wrapping - GiftWrapping
The selected gift wrapping option for the cart item.
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
message - String
The message from the sender to the recipient.
min_qty - Float
Line item min qty in quote template
not_available_message - String
Message to display when the product is not available with this selected option.
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this item in the cart.
recipient_email - String
The email address of the person receiving the gift card.
recipient_name - String!
The name of the person receiving the gift card.
sender_email - String
The email address of the sender.
sender_name - String!
The name of the sender.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "amount": Money,
  "available_gift_wrapping": [GiftWrapping],
  "custom_attributes": [CustomAttribute],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "is_available": true,
  "max_qty": 123.45,
  "message": "xyz789",
  "min_qty": 987.65,
  "not_available_message": "abc123",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "recipient_email": "xyz789",
  "recipient_name": "abc123",
  "sender_email": "xyz789",
  "sender_name": "xyz789",
  "uid": "4"
}

GiftCardCreditMemoItem

Fields

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

Example

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

GiftCardInvoiceItem

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the invoice item
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
gift_card - GiftCardItem
Selected gift card properties for an invoice item.
id - ID!
The unique ID for an `InvoiceItemInterface` object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Example

{
  "custom_attributes": [CustomAttribute],
  "discounts": [Discount],
  "gift_card": GiftCardItem,
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_invoiced": 123.45
}

GiftCardItem

Contains details about a gift card.

Fields

Field Name
Description
message - String
The message from the sender to the recipient.
recipient_email - String
The email address of the receiver of a virtual gift card.
recipient_name - String
The name of the receiver of a physical or virtual gift card.
sender_email - String
The email address of the sender of a virtual gift card.
sender_name - String
The name of the sender of a physical or virtual gift card.

Example

{
  "message": "abc123",
  "recipient_email": "abc123",
  "recipient_name": "xyz789",
  "sender_email": "abc123",
  "sender_name": "abc123"
}

GiftCardOptions

Contains details about the sender, recipient, and amount of a gift card.

Fields

Field Name
Description
amount - Money
The amount and currency of the gift card.
custom_giftcard_amount - Money
The custom amount and currency of the gift card.
message - String
A message to the recipient.
recipient_email - String
The email address of the person receiving the gift card.
recipient_name - String
The name of the person receiving the gift card.
sender_email - String
The email address of the person sending the gift card.
sender_name - String
The name of the person sending the gift card.

Example

{
  "amount": Money,
  "custom_giftcard_amount": Money,
  "message": "xyz789",
  "recipient_email": "xyz789",
  "recipient_name": "abc123",
  "sender_email": "xyz789",
  "sender_name": "xyz789"
}

GiftCardOrderItem

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the order item
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_card - GiftCardItem
Selected gift card properties for an order item.
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 (Deprecated: Product information is part of a composable Catalog Service.)
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

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

GiftCardProduct

Defines properties of a gift card.

Fields

Field Name
Description
allow_message - Boolean
Indicates whether the customer can provide a message to accompany the gift card.
allow_open_amount - Boolean
Indicates whether shoppers have the ability to set the value of the gift card.
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.
country_of_manufacture - String
The product's country of origin.
crosssell_products - [ProductInterface]
Crosssell Products
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_card_options - [CustomizableOptionInterface]!
An array of customizable gift card options.
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.
giftcard_amounts - [GiftCardAmounts]
An array that contains information about the values and ID of a gift card.
giftcard_type - GiftCardTypeEnum
An enumeration that specifies the type of gift card.
image - ProductImage
The relative path to the main image on the product page.
is_redeemable - Boolean
Indicates whether the customer can redeem the value on the card for cash.
is_returnable - String
Indicates whether the product can be returned.
lifetime - Int
The number of days after purchase until the gift card expires. A null value means there is no limit.
manufacturer - Int
A number representing the product's manufacturer.
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
message_max_length - Int
The maximum number of characters the gift message can contain.
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
open_amount_max - Float
The maximum acceptable value of an open amount gift card.
open_amount_min - Float
The minimum acceptable value of an open amount gift card.
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
quantity - Float
Quantity of available stock
related_products - [ProductInterface]
An array of products to be displayed in a Related Products block.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
uid - ID!
The unique ID for a `ProductInterface` object.
upsell_products - [ProductInterface]
Upsell Products
url_key - String
The part of the URL that identifies the product
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "allow_message": false,
  "allow_open_amount": true,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "country_of_manufacture": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_card_options": [CustomizableOptionInterface],
  "gift_message_available": false,
  "gift_wrapping_available": true,
  "gift_wrapping_price": Money,
  "giftcard_amounts": [GiftCardAmounts],
  "giftcard_type": "VIRTUAL",
  "image": ProductImage,
  "is_redeemable": false,
  "is_returnable": "xyz789",
  "lifetime": 123,
  "manufacturer": 987,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "message_max_length": 987,
  "meta_description": "xyz789",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "min_sale_qty": 123.45,
  "name": "abc123",
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 987.65,
  "open_amount_max": 987.65,
  "open_amount_min": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "quantity": 123.45,
  "related_products": [ProductInterface],
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_price": 123.45,
  "special_to_date": "xyz789",
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "uid": 4,
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "weight": 987.65
}

GiftCardRequisitionListItem

Contains details about gift cards added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
gift_card_options - GiftCardOptions!
An array that defines gift card properties.
product - ProductInterface!
Details about a requisition list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The amount added.
sku - String!
The product SKU.
uid - ID!
The unique ID for the requisition list item.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "gift_card_options": GiftCardOptions,
  "product": ProductInterface,
  "quantity": 123.45,
  "sku": "abc123",
  "uid": 4
}

GiftCardShipmentItem

Fields

Field Name
Description
gift_card - GiftCardItem
Selected gift card properties for a shipment item.
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

{
  "gift_card": GiftCardItem,
  "id": "4",
  "order_item": OrderItemInterface,
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "abc123",
  "quantity_shipped": 987.65
}

GiftCardTypeEnum

Specifies the gift card type.

Values

Enum Value
Description
VIRTUAL
PHYSICAL
COMBINED

Example

""VIRTUAL""

GiftCardWishlistItem

A single gift card added to a wish list.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
gift_card_options - GiftCardOptions!
Details about a gift card.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface!
Product details of the wish list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "abc123",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "gift_card_options": GiftCardOptions,
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

GiftMessage

Contains the text of a gift message, its sender, and recipient

Fields

Field Name
Description
from - String!
Sender name
message - String!
Gift message text
to - String!
Recipient name

Example

{
  "from": "xyz789",
  "message": "xyz789",
  "to": "xyz789"
}

GiftMessageInput

Defines a gift message.

Input Fields

Input Field
Description
from - String!
The name of the sender.
message - String!
The text of the gift message.
to - String!
The name of the recepient.

Example

{
  "from": "xyz789",
  "message": "abc123",
  "to": "abc123"
}

GiftOptionsPrices

Contains prices for gift wrapping options.

Fields

Field Name
Description
gift_wrapping_for_items - Money
Price of the gift wrapping for all individual order items.
gift_wrapping_for_items_incl_tax - Money
Price of the gift wrapping for all individual order items including tax.
gift_wrapping_for_order - Money
Price of the gift wrapping for the whole order.
gift_wrapping_for_order_incl_tax - Money
Price of the gift wrapping for the whole order including tax.
printed_card - Money
Price for the printed card.
printed_card_incl_tax - Money
Price for the printed card including tax.

Example

{
  "gift_wrapping_for_items": Money,
  "gift_wrapping_for_items_incl_tax": Money,
  "gift_wrapping_for_order": Money,
  "gift_wrapping_for_order_incl_tax": Money,
  "printed_card": Money,
  "printed_card_incl_tax": Money
}

GiftRegistry

Contains details about a gift registry.

Fields

Field Name
Description
created_at - String!
The date on which the gift registry was created. Only the registry owner can access this attribute.
dynamic_attributes - [GiftRegistryDynamicAttribute]
An array of attributes that define elements of the gift registry. Each attribute is specified as a code-value pair.
event_name - String!
The name of the event.
items - [GiftRegistryItemInterface]
An array of products added to the gift registry.
message - String!
The message text the customer entered to describe the event.
owner_name - String!
The customer who created the gift registry.
privacy_settings - GiftRegistryPrivacySettings!
An enum that states whether the gift registry is PRIVATE or PUBLIC. Only the registry owner can access this attribute.
registrants - [GiftRegistryRegistrant]
Contains details about each registrant for the event.
shipping_address - CustomerAddress
Contains the customer's shipping address. Only the registry owner can access this attribute.
status - GiftRegistryStatus!
An enum that states whether the gift registry is ACTIVE or INACTIVE. Only the registry owner can access this attribute.
type - GiftRegistryType
The type of gift registry.
uid - ID!
The unique ID assigned to the gift registry.

Example

{
  "created_at": "xyz789",
  "dynamic_attributes": [GiftRegistryDynamicAttribute],
  "event_name": "abc123",
  "items": [GiftRegistryItemInterface],
  "message": "xyz789",
  "owner_name": "abc123",
  "privacy_settings": "PRIVATE",
  "registrants": [GiftRegistryRegistrant],
  "shipping_address": CustomerAddress,
  "status": "ACTIVE",
  "type": GiftRegistryType,
  "uid": 4
}

GiftRegistryDynamicAttribute

Fields

Field Name
Description
code - ID!
The internal ID of the dynamic attribute.
group - GiftRegistryDynamicAttributeGroup!
Indicates which group the dynamic attribute is a member of.
label - String!
The display name of the dynamic attribute.
value - String!
A corresponding value for the code.

Example

{
  "code": 4,
  "group": "EVENT_INFORMATION",
  "label": "abc123",
  "value": "abc123"
}

GiftRegistryDynamicAttributeGroup

Defines the group type of a gift registry dynamic attribute.

Values

Enum Value
Description
EVENT_INFORMATION
PRIVACY_SETTINGS
REGISTRANT
GENERAL_INFORMATION
DETAILED_INFORMATION
SHIPPING_ADDRESS

Example

""EVENT_INFORMATION""

GiftRegistryDynamicAttributeInput

Defines a dynamic attribute.

Input Fields

Input Field
Description
code - ID!
A unique key for an additional attribute of the event.
value - String!
A string that describes a dynamic attribute.

Example

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

GiftRegistryDynamicAttributeInterface

Fields

Field Name
Description
code - ID!
The internal ID of the dynamic attribute.
label - String!
The display name of the dynamic attribute.
value - String!
A corresponding value for the code.

Possible Types

GiftRegistryDynamicAttributeInterface Types
GiftRegistryDynamicAttribute
GiftRegistryRegistrantDynamicAttribute

Example

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

GiftRegistryDynamicAttributeMetadata

Fields

Field Name
Description
attribute_group - String!
Indicates which group the dynamic attribute a member of.
code - ID!
The internal ID of the dynamic attribute.
input_type - String!
The selected input type for this dynamic attribute. The value can be one of several static or custom types.
is_required - Boolean!
Indicates whether the dynamic attribute is required.
label - String!
The display name of the dynamic attribute.
sort_order - Int
The order in which to display the dynamic attribute.

Example

{
  "attribute_group": "xyz789",
  "code": "4",
  "input_type": "abc123",
  "is_required": true,
  "label": "abc123",
  "sort_order": 123
}

GiftRegistryDynamicAttributeMetadataInterface

Fields

Field Name
Description
attribute_group - String!
Indicates which group the dynamic attribute a member of.
code - ID!
The internal ID of the dynamic attribute.
input_type - String!
The selected input type for this dynamic attribute. The value can be one of several static or custom types.
is_required - Boolean!
Indicates whether the dynamic attribute is required.
label - String!
The display name of the dynamic attribute.
sort_order - Int
The order in which to display the dynamic attribute.

Possible Types

GiftRegistryDynamicAttributeMetadataInterface Types
GiftRegistryDynamicAttributeMetadata

Example

{
  "attribute_group": "abc123",
  "code": "4",
  "input_type": "abc123",
  "is_required": true,
  "label": "abc123",
  "sort_order": 987
}

GiftRegistryItem

Fields

Field Name
Description
created_at - String!
The date the product was added to the gift registry.
note - String
A brief message about the gift registry item.
product - ProductInterface!
Details about the gift registry item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The requested quantity of the product.
quantity_fulfilled - Float!
The fulfilled quantity of the product.
uid - ID!
The unique ID of a gift registry item.

Example

{
  "created_at": "abc123",
  "note": "abc123",
  "product": ProductInterface,
  "quantity": 123.45,
  "quantity_fulfilled": 987.65,
  "uid": "4"
}

GiftRegistryItemInterface

Fields

Field Name
Description
created_at - String!
The date the product was added to the gift registry.
note - String
A brief message about the gift registry item.
product - ProductInterface!
Details about the gift registry item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The requested quantity of the product.
quantity_fulfilled - Float!
The fulfilled quantity of the product.
uid - ID!
The unique ID of a gift registry item.

Possible Types

GiftRegistryItemInterface Types
GiftRegistryItem

Example

{
  "created_at": "abc123",
  "note": "xyz789",
  "product": ProductInterface,
  "quantity": 987.65,
  "quantity_fulfilled": 987.65,
  "uid": "4"
}

GiftRegistryItemUserErrorInterface

Contains the status and any errors that encountered with the customer's gift register item.

Fields

Field Name
Description
status - Boolean!
Indicates whether the attempt to move the cart items to the gift registry was successful.
user_errors - [GiftRegistryItemsUserError]!
An array of errors encountered while moving items from the cart to the gift registry.

Possible Types

GiftRegistryItemUserErrorInterface Types
MoveCartItemsToGiftRegistryOutput

Example

{
  "status": true,
  "user_errors": [GiftRegistryItemsUserError]
}

GiftRegistryItemsUserError

Contains details about an error that occurred when processing a gift registry item.

Fields

Field Name
Description
code - GiftRegistryItemsUserErrorType!
An error code that describes the error encountered.
gift_registry_item_uid - ID
The unique ID of the gift registry item containing an error.
gift_registry_uid - ID
The unique ID of the `GiftRegistry` object containing an error.
message - String!
A localized error message.
product_uid - ID
The unique ID of the product containing an error.

Example

{
  "code": "OUT_OF_STOCK",
  "gift_registry_item_uid": 4,
  "gift_registry_uid": "4",
  "message": "abc123",
  "product_uid": "4"
}

GiftRegistryItemsUserErrorType

Defines the error type.

Values

Enum Value
Description
OUT_OF_STOCK
Used for handling out of stock products.
NOT_FOUND
Used for exceptions like EntityNotFound.
UNDEFINED
Used for other exceptions, such as database connection failures.

Example

""OUT_OF_STOCK""

GiftRegistryOutputInterface

Contains the customer's gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry.

Possible Types

GiftRegistryOutputInterface Types
MoveCartItemsToGiftRegistryOutput

Example

{"gift_registry": GiftRegistry}

GiftRegistryPrivacySettings

Defines the privacy setting of the gift registry.

Values

Enum Value
Description
PRIVATE
PUBLIC

Example

""PRIVATE""

GiftRegistryRegistrant

Contains details about a registrant.

Fields

Field Name
Description
dynamic_attributes - [GiftRegistryRegistrantDynamicAttribute]
An array of dynamic attributes assigned to the registrant.
email - String!
The email address of the registrant. Only the registry owner can access this attribute.
firstname - String!
The first name of the registrant.
lastname - String!
The last name of the registrant.
uid - ID!
The unique ID assigned to the registrant.

Example

{
  "dynamic_attributes": [
    GiftRegistryRegistrantDynamicAttribute
  ],
  "email": "xyz789",
  "firstname": "abc123",
  "lastname": "abc123",
  "uid": "4"
}

GiftRegistryRegistrantDynamicAttribute

Fields

Field Name
Description
code - ID!
The internal ID of the dynamic attribute.
label - String!
The display name of the dynamic attribute.
value - String!
A corresponding value for the code.

Example

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

GiftRegistrySearchResult

Contains the results of a gift registry search.

Fields

Field Name
Description
event_date - String
The date of the event.
event_title - String!
The title given to the event.
gift_registry_uid - ID!
The URL key of the gift registry.
location - String
The location of the event.
name - String!
The name of the gift registry owner.
type - String
The type of event being held.

Example

{
  "event_date": "xyz789",
  "event_title": "abc123",
  "gift_registry_uid": 4,
  "location": "abc123",
  "name": "abc123",
  "type": "xyz789"
}

GiftRegistryShippingAddressInput

Defines a shipping address for a gift registry. Specify either address_data or the address_id. If both are provided, validation will fail.

Input Fields

Input Field
Description
address_data - CustomerAddressInput
Defines the shipping address for this gift registry.
address_id - ID
The ID assigned to this customer address.
customer_address_uid - ID
The unique ID assigned to this customer address.

Example

{
  "address_data": CustomerAddressInput,
  "address_id": 4,
  "customer_address_uid": 4
}

GiftRegistryStatus

Defines the status of the gift registry.

Values

Enum Value
Description
ACTIVE
INACTIVE

Example

""ACTIVE""

GiftRegistryType

Contains details about a gift registry type.

Fields

Field Name
Description
dynamic_attributes_metadata - [GiftRegistryDynamicAttributeMetadataInterface]
An array of attributes that define elements of the gift registry. Each attribute is specified as a code-value pair.
label - String!
The label assigned to the gift registry type on the Admin.
uid - ID!
The unique ID assigned to the gift registry type.

Example

{
  "dynamic_attributes_metadata": [
    GiftRegistryDynamicAttributeMetadataInterface
  ],
  "label": "abc123",
  "uid": "4"
}

GiftWrapping

Contains details about the selected or available gift wrapping options.

Fields

Field Name
Description
design - String!
The name of the gift wrapping design.
image - GiftWrappingImage
The preview image for a gift wrapping option.
price - Money!
The gift wrapping price.
uid - ID!
The unique ID for a `GiftWrapping` object.

Example

{
  "design": "abc123",
  "image": GiftWrappingImage,
  "price": Money,
  "uid": 4
}

GiftWrappingImage

Points to an image associated with a gift wrapping option.

Fields

Field Name
Description
label - String!
The gift wrapping preview image label.
url - String!
The gift wrapping preview image URL.

Example

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

GooglePayButtonStyles

Fields

Field Name
Description
color - String
The button color
height - Int
The button height in pixels
type - String
The button type

Example

{
  "color": "abc123",
  "height": 987,
  "type": "xyz789"
}

GooglePayConfig

Fields

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

Example

{
  "button_styles": GooglePayButtonStyles,
  "code": "abc123",
  "is_visible": false,
  "payment_intent": "xyz789",
  "payment_source": "xyz789",
  "sdk_params": [SDKParams],
  "sort_order": "abc123",
  "three_ds_mode": "OFF",
  "title": "abc123"
}

GooglePayMethodInput

Google Pay inputs

Input Fields

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

Example

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

GroupedProduct

Defines a grouped product, which consists of simple standalone products that are presented as a group.

Fields

Field Name
Description
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.
country_of_manufacture - String
The product's country of origin.
crosssell_products - [ProductInterface]
Crosssell Products
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
items - [GroupedProductItem]
An array containing grouped product items.
manufacturer - Int
A number representing the product's manufacturer.
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options_container - String
If the product has multiple options, determines where they appear on the product page.
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
quantity - Float
Quantity of available stock
related_products - [ProductInterface]
An array of products to be displayed in a Related Products block.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
uid - ID!
The unique ID for a `ProductInterface` object.
upsell_products - [ProductInterface]
Upsell Products
url_key - String
The part of the URL that identifies the product
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "country_of_manufacture": "xyz789",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": true,
  "gift_wrapping_available": true,
  "gift_wrapping_price": Money,
  "image": ProductImage,
  "is_returnable": "abc123",
  "items": [GroupedProductItem],
  "manufacturer": 123,
  "max_sale_qty": 987.65,
  "media_gallery": [MediaGalleryInterface],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "abc123",
  "min_sale_qty": 987.65,
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options_container": "xyz789",
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "quantity": 123.45,
  "related_products": [ProductInterface],
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "uid": "4",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "weight": 987.65
}

GroupedProductItem

Contains information about an individual grouped product item.

Fields

Field Name
Description
position - Int
The relative position of this item compared to the other group items.
product - ProductInterface!
Details about this product option. (Deprecated: Product information is part of a composable Catalog Service.)
qty - Float
The quantity of this grouped product item.

Example

{
  "position": 987,
  "product": ProductInterface,
  "qty": 987.65
}

GroupedProductWishlistItem

A grouped product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a `WishlistItemInterface` object.
product - ProductInterface!
Product details of the wish list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "xyz789",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

GuestOrderCancelInput

Input to retrieve a guest order based on token.

Input Fields

Input Field
Description
reason - String!
Cancellation reason.
token - String!
Order token.

Example

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

GuestOrderInformationInput

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

Highlight

An object that provides highlighted text for matched words

Fields

Field Name
Description
attribute - String!
The product attribute that contains a match for the search phrase
matched_words - [String]!
An array of strings
value - String!
The matched text, enclosed within emphasis tags

Example

{
  "attribute": "abc123",
  "matched_words": ["abc123"],
  "value": "xyz789"
}

HistoryItemNoteData

Item note data that is added to the negotiable quote history object.

Fields

Field Name
Description
created_at - String!
Datetime of the note added.
creator_name - String!
Name of the creator.
creator_type - String!
Creator type: Buyer or Seller.
item_id - Int!
Id of the quote item for which the note has been added.
note - String!
The note added by the creator for the item
product_name - String!
Name of the quote item product for which note has been added.

Example

{
  "created_at": "xyz789",
  "creator_name": "abc123",
  "creator_type": "xyz789",
  "item_id": 987,
  "note": "abc123",
  "product_name": "xyz789"
}

HostedFieldsConfig

Fields

Field Name
Description
cc_vault_code - String
Vault payment method code
code - String
The payment method code as defined in the payment gateway
is_vault_enabled - Boolean
Card vault enabled
is_visible - Boolean
Indicates whether the payment method is displayed
payment_intent - String
Defines the payment intent (Authorize or Capture
payment_source - String
The payment source for the payment method
requires_card_details - Boolean
Card and bin details required
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
three_ds_mode - ThreeDSMode
3DS mode
title - String
The name displayed for the payment method

Example

{
  "cc_vault_code": "abc123",
  "code": "xyz789",
  "is_vault_enabled": false,
  "is_visible": true,
  "payment_intent": "abc123",
  "payment_source": "abc123",
  "requires_card_details": true,
  "sdk_params": [SDKParams],
  "sort_order": "xyz789",
  "three_ds_mode": "OFF",
  "title": "abc123"
}

HostedFieldsInput

Hosted Fields payment inputs

Input Fields

Input Field
Description
cardBin - String
Card bin number
cardExpiryMonth - String
Expiration month of the card
cardExpiryYear - String
Expiration year of the card
cardLast4 - String
Last four digits of the card
holderName - String
Name on the card
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 Payment Services payment integration.
payment_source - String
The payment source for the payment method
payments_order_id - String
The payment services order ID
paypal_order_id - String
PayPal order ID

Example

{
  "cardBin": "abc123",
  "cardExpiryMonth": "abc123",
  "cardExpiryYear": "xyz789",
  "cardLast4": "xyz789",
  "holderName": "xyz789",
  "is_active_payment_token_enabler": true,
  "payment_source": "abc123",
  "payments_order_id": "xyz789",
  "paypal_order_id": "xyz789"
}

ID

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Example

"4"

ImageSwatchData

Fields

Field Name
Description
thumbnail - String
The URL assigned to the thumbnail of the swatch image.
value - String
The value can be represented as color (HEX code), image link, or text.

Example

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

InputFilterEnum

List of templates/filters applied to customer attribute input.

Values

Enum Value
Description
NONE
There are no templates or filters to be applied.
DATE
Forces attribute input to follow the date format.
TRIM
Strip whitespace (or other characters) from the beginning and end of the input.
STRIPTAGS
Strip HTML Tags.
ESCAPEHTML
Escape HTML Entities.

Example

""NONE""

InsufficientStockError

Fields

Field Name
Description
code - CartUserInputErrorType!
A cart-specific error code.
message - String!
A localized error message.
quantity - Float
Amount of available stock

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "abc123",
  "quantity": 987.65
}

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

987

InternalError

Contains an error message when an internal error occurred.

Fields

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

Example

{"message": "abc123"}

Invoice

Contains invoice details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments on the invoice.
custom_attributes - [CustomAttribute]
The custom attributes for the invoice
id - ID!
The unique ID for a `Invoice` object.
items - [InvoiceItemInterface]
Invoiced product details.
number - String!
Sequential invoice number.
total - InvoiceTotal
Invoice total amount details.

Example

{
  "comments": [SalesCommentItem],
  "custom_attributes": [CustomAttribute],
  "id": 4,
  "items": [InvoiceItemInterface],
  "number": "xyz789",
  "total": InvoiceTotal
}

InvoiceCustomAttributesInput

Defines an invoice custom attributes.

Input Fields

Input Field
Description
custom_attributes - [CustomAttributeInput]
An array of custom attributes for invoice.
invoice_id - String!
The invoice ID.

Example

{
  "custom_attributes": [CustomAttributeInput],
  "invoice_id": "xyz789"
}

InvoiceItem

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the invoice item
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for an `InvoiceItemInterface` object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Example

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

InvoiceItemCustomAttributesInput

Defines an invoice item custom attributes.

Input Fields

Input Field
Description
custom_attributes - [CustomAttributeInput]
An array of custom attributes for invoice item.
invoice_id - String!
The invoice ID.
invoice_item_id - String!
The invoice item ID.

Example

{
  "custom_attributes": [CustomAttributeInput],
  "invoice_id": "xyz789",
  "invoice_item_id": "xyz789"
}

InvoiceItemInterface

Contains detailes about invoiced items.

Fields

Field Name
Description
custom_attributes - [CustomAttribute]
The custom attributes for the invoice item
discounts - [Discount]
Information about the final discount amount for the base product, including discounts on options.
id - ID!
The unique ID for an `InvoiceItemInterface` object.
order_item - OrderItemInterface
Details about an individual order item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product including selected options.
product_sku - String!
The SKU of the base product.
quantity_invoiced - Float
The number of invoiced items.

Possible Types

Example

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

InvoiceOutput

Contains details about the invoice after adding custom attributes to it.

Fields

Field Name
Description
invoice - Invoice!
The custom attributes to invoice have been added.

Example

{"invoice": Invoice}

InvoiceTotal

Contains price details from an invoice.

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 invoice.
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the invoice.
subtotal - Money!
The subtotal of the invoice, excluding shipping, discounts, and taxes.
taxes - [TaxItem]
The invoice tax details.
total_shipping - Money!
The shipping amount for the invoice.
total_tax - Money!
The amount of tax applied to the invoice.

Example

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

IsCompanyAdminEmailAvailableOutput

Contains the response of a company admin email validation query.

Fields

Field Name
Description
is_email_available - Boolean!
Indicates whether the specified email address can be used to create a company administrator.

Example

{"is_email_available": true}

IsCompanyEmailAvailableOutput

Contains the response of a company email validation query.

Fields

Field Name
Description
is_email_available - Boolean!
Indicates whether the specified email address can be used to create a company.

Example

{"is_email_available": true}

IsCompanyRoleNameAvailableOutput

Contains the response of a role name validation query.

Fields

Field Name
Description
is_role_name_available - Boolean!
Indicates whether the specified company role name is available.

Example

{"is_role_name_available": true}

IsCompanyUserEmailAvailableOutput

Contains the response of a company user email validation query.

Fields

Field Name
Description
is_email_available - Boolean!
Indicates whether the specified email address can be used to create a company user.

Example

{"is_email_available": true}

IsEmailAvailableOutput

Contains the result of the isEmailAvailable query.

Fields

Field Name
Description
is_email_available - Boolean
Indicates whether the specified email address can be used to create a customer.

Example

{"is_email_available": false}

IsOperatorInput

Input Fields

Input Field
Description
type - IsOperatorType
value - Boolean

Example

{"type": "UNKNOWN_ISOPERATOR_TYPE", "value": true}

IsOperatorType

Values

Enum Value
Description
UNKNOWN_ISOPERATOR_TYPE
IS

Example

""UNKNOWN_ISOPERATOR_TYPE""

IsProductAlertSubscriptionResult

Fields

Field Name
Description
isSubscribed - Boolean!
message - String

Example

{"isSubscribed": false, "message": "abc123"}

ItemNote

The note object for quote line item.

Fields

Field Name
Description
created_at - String
Timestamp that reflects note creation date.
creator_id - Int
ID of the user who submitted a note.
creator_name - String
Name of the creator.
creator_type - Int
Type of teh user who submitted a note.
negotiable_quote_item_uid - ID
The unique ID of a `CartItemInterface` object.
note - String
Note text.
note_uid - ID
The unique ID of a `ItemNote` object.

Example

{
  "created_at": "xyz789",
  "creator_id": 987,
  "creator_name": "abc123",
  "creator_type": 123,
  "negotiable_quote_item_uid": 4,
  "note": "abc123",
  "note_uid": 4
}

ItemSelectedBundleOption

A list of options of the selected bundle product.

Fields

Field Name
Description
label - String!
The label of the option.
uid - ID!
The unique ID for a `ItemSelectedBundleOption` object.
values - [ItemSelectedBundleOptionValue]
A list of products that represent the values of the parent option.

Example

{
  "label": "abc123",
  "uid": 4,
  "values": [ItemSelectedBundleOptionValue]
}

ItemSelectedBundleOptionValue

A list of values for the selected bundle product.

Fields

Field Name
Description
price - Money!
The price of the child bundle product.
product_name - String!
The name of the child bundle product.
product_sku - String!
The SKU of the child bundle product.
quantity - Float!
The number of this bundle product that were ordered.
uid - ID!
The unique ID for a `ItemSelectedBundleOptionValue` object.

Example

{
  "price": Money,
  "product_name": "abc123",
  "product_sku": "abc123",
  "quantity": 123.45,
  "uid": "4"
}

JSON

A JSON scalar

Example

{}

KeyValue

Contains a key-value pair.

Fields

Field Name
Description
name - String
The name part of the key/value pair.
value - String
The value part of the key/value pair.

Example

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

LineItemNoteInput

Sets quote item note.

Input Fields

Input Field
Description
note - String
The note text to be added.
quote_item_uid - ID!
The unique ID of a `CartLineItem` object.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{
  "note": "xyz789",
  "quote_item_uid": 4,
  "quote_uid": "4"
}

MediaGalleryInterface

Contains basic information about a product image or 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.

Possible Types

MediaGalleryInterface Types
AssetImage
AssetVideo
ProductImage
ProductVideo

Example

{
  "disabled": false,
  "label": "xyz789",
  "position": 123,
  "url": "abc123"
}

MediaResourceType

Enumeration of media resource types

Values

Enum Value
Description
NEGOTIABLE_QUOTE_ATTACHMENT
Negotiable quote comment file attachment
CUSTOMER_ATTRIBUTE_FILE
Customer file resource type
CUSTOMER_ATTRIBUTE_IMAGE
Customer image resource type
CUSTOMER_ATTRIBUTE_ADDRESS_FILE
Customer file resource type for customer address
CUSTOMER_ATTRIBUTE_ADDRESS_IMAGE
Customer image resource type for customer address

Example

""NEGOTIABLE_QUOTE_ATTACHMENT""

Fields

Field Name
Description
type - String
The type of logo for the PayPal Pay Later messaging

Example

{"type": "xyz789"}

MessageStyles

Fields

Field Name
Description
layout - String
The message layout
logo - MessageStyleLogo
The message logo

Example

{
  "layout": "abc123",
  "logo": MessageStyleLogo
}

Money

Defines a monetary value, including a numeric value and a currency code.

Fields

Field Name
Description
currency - CurrencyEnum
A three-letter currency code, such as USD or EUR.
value - Float
A number expressing a monetary value.

Example

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

MoveCartItemsToGiftRegistryOutput

Contains the customer's gift registry and any errors encountered.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry.
status - Boolean!
Indicates whether the attempt to move the cart items to the gift registry was successful.
user_errors - [GiftRegistryItemsUserError]!
An array of errors encountered while moving items from the cart to the gift registry.

Example

{
  "gift_registry": GiftRegistry,
  "status": false,
  "user_errors": [GiftRegistryItemsUserError]
}

MoveItemsBetweenRequisitionListsInput

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

Input Fields

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

Example

{"requisitionListItemUids": ["4"]}

MoveItemsBetweenRequisitionListsOutput

Output of the request to move items to another requisition list.

Fields

Field Name
Description
destination_requisition_list - RequisitionList
The destination requisition list after moving items.
source_requisition_list - RequisitionList
The source requisition list after moving items.

Example

{
  "destination_requisition_list": RequisitionList,
  "source_requisition_list": RequisitionList
}

MoveLineItemToRequisitionListInput

Move Line Item to Requisition List.

Input Fields

Input Field
Description
quote_item_uid - ID!
The unique ID of a `CartLineItem` object.
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.
requisition_list_uid - ID!
The unique ID of a requisition list.

Example

{
  "quote_item_uid": 4,
  "quote_uid": 4,
  "requisition_list_uid": "4"
}

MoveLineItemToRequisitionListOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The negotiable quote after moving item to requisition list.

Example

{"quote": NegotiableQuote}

MoveProductsBetweenWishlistsOutput

Contains the source and target wish lists after moving products.

Fields

Field Name
Description
destination_wishlist - Wishlist!
The destination wish list after receiving products moved from the source wish list.
source_wishlist - Wishlist!
The source wish list after moving products from it.
user_errors - [WishListUserInputError]!
An array of errors encountered while moving products to a wish list.

Example

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

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.
custom_attributes - [CustomAttribute]
The custom attributes for the negotiable quote
email - String
The email address of the company user.
expiration_date - String!
The expiration period of the negotiable quote.
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.
order - CustomerOrder
The order created from the negotiable quote.
prices - CartPrices
A set of subtotals and totals applied to the negotiable quote.
sales_rep_name - String!
The first and last name of the sales representative.
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.
template_id - ID
The unique ID of a `NegotiableQuoteTemplate` object.
template_name - String
The title assigned to the negotiable quote template.
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",
  "custom_attributes": [CustomAttribute],
  "email": "abc123",
  "expiration_date": "xyz789",
  "history": [NegotiableQuoteHistoryEntry],
  "is_virtual": true,
  "items": [CartItemInterface],
  "name": "abc123",
  "order": CustomerOrder,
  "prices": CartPrices,
  "sales_rep_name": "xyz789",
  "selected_payment_method": SelectedPaymentMethod,
  "shipping_addresses": [NegotiableQuoteShippingAddress],
  "status": "SUBMITTED",
  "template_id": "4",
  "template_name": "abc123",
  "total_quantity": 987.65,
  "uid": "4",
  "updated_at": "abc123"
}

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": "xyz789",
  "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.
custom_attributes - [AttributeValueInput]
The custom attribute values of the billing or shipping negotiable quote address.
fax - String
The fax number of the customer.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The ZIP or postal code of the billing or shipping address.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - String
A string that defines the state or province of the billing or shipping address.
region_id - Int
An integer that defines the state or province of the billing or shipping address.
save_in_address_book - Boolean
Determines whether to save the address in the customer's address book. The default value is true.
street - [String]!
An array containing the street for the billing or shipping address.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number for the billing or shipping address.
vat_id - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country_code": "xyz789",
  "custom_attributes": [AttributeValueInput],
  "fax": "xyz789",
  "firstname": "abc123",
  "lastname": "xyz789",
  "middlename": "abc123",
  "postcode": "abc123",
  "prefix": "abc123",
  "region": "xyz789",
  "region_id": 123,
  "save_in_address_book": true,
  "street": ["abc123"],
  "suffix": "abc123",
  "telephone": "xyz789",
  "vat_id": "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.
custom_attributes - [AttributeValueInterface]
The custom attribute values of the billing or shipping negotiable quote address.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
fax - String
The fax number of the customer.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The company's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
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.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The customer's telephone number.
uid - ID!
The unique identifier of the negotiable quote address.
vat_id - String
The customer's Tax/VAT number (for corporate customers).

Possible Types

NegotiableQuoteAddressInterface Types
NegotiableQuoteBillingAddress
NegotiableQuoteShippingAddress

Example

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

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": "xyz789",
  "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.
custom_attributes - [AttributeValueInterface]
The custom attribute values of the billing or shipping negotiable quote address.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
fax - String
The fax number of the customer.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The company's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
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.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The customer's telephone number.
uid - ID!
The unique identifier of the negotiable quote address.
vat_id - String
The customer's Tax/VAT number (for corporate customers).

Example

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

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

NegotiableQuoteComment

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

Fields

Field Name
Description
attachments - [NegotiableQuoteCommentAttachment]!
Negotiable quote comment file attachments.
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

{
  "attachments": [NegotiableQuoteCommentAttachment],
  "author": NegotiableQuoteUser,
  "created_at": "xyz789",
  "creator_type": "BUYER",
  "text": "xyz789",
  "uid": "4"
}

NegotiableQuoteCommentAttachment

Negotiable quote comment file attachment.

Fields

Field Name
Description
name - String!
Negotiable quote comment attachment file name.
url - String!
Negotiable quote comment attachment file url.

Example

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

NegotiableQuoteCommentAttachmentInput

Negotiable quote comment file attachment.

Input Fields

Input Field
Description
key - String!
Negotiable quote comment attachment file key.

Example

{"key": "xyz789"}

NegotiableQuoteCommentCreatorType

Values

Enum Value
Description
BUYER
SELLER

Example

""BUYER""

NegotiableQuoteCommentInput

Contains the commend provided by the buyer.

Input Fields

Input Field
Description
attachments - [NegotiableQuoteCommentAttachmentInput]
Negotiable quote comment file attachments.
comment - String!
The comment provided by the buyer.

Example

{
  "attachments": [NegotiableQuoteCommentAttachmentInput],
  "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": "abc123"
}

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

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.
item_note - HistoryItemNoteData
Item note data that is added to the negotiable quote history object.
uid - ID!
The unique ID of a `NegotiableQuoteHistoryEntry` object.

Example

{
  "author": NegotiableQuoteUser,
  "change_type": "CREATED",
  "changes": NegotiableQuoteHistoryChanges,
  "created_at": "abc123",
  "item_note": HistoryItemNoteData,
  "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. (Deprecated: Product information is part of a composable Catalog Service.)

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

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": "abc123",
  "link_id": 4,
  "reference_document_url": "abc123"
}

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.
custom_attributes - [AttributeValueInterface]
The custom attribute values of the billing or shipping negotiable quote address.
customer_address_uid - ID
The unique ID from the customer's address book that uniquely identifies the address.
fax - String
The fax number of the customer.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
middlename - String
The middle name of the person associated with the billing/shipping address.
postcode - String
The company's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
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.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The customer's telephone number.
uid - ID!
The unique identifier of the negotiable quote address.
vat_id - String
The customer's Tax/VAT number (for corporate customers).

Example

{
  "available_shipping_methods": [AvailableShippingMethod],
  "city": "abc123",
  "company": "abc123",
  "country": NegotiableQuoteAddressCountry,
  "custom_attributes": [AttributeValueInterface],
  "customer_address_uid": "4",
  "fax": "xyz789",
  "firstname": "abc123",
  "lastname": "abc123",
  "middlename": "abc123",
  "postcode": "abc123",
  "prefix": "xyz789",
  "region": NegotiableQuoteAddressRegion,
  "selected_shipping_method": SelectedShippingMethod,
  "street": ["abc123"],
  "suffix": "abc123",
  "telephone": "xyz789",
  "uid": "4",
  "vat_id": "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.
created_at - String!
Timestamp indicating when the negotiable quote template was created.
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.
historyV2 - [NegotiableQuoteTemplateHistoryEntry]
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.
sales_rep_name - String!
The first and last name of the sales representative.
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.
uid - ID!
The unique ID of a `NegotiableQuoteTemplate` object.
updated_at - String!
Timestamp indicating when the negotiable quote template was updated.

Example

{
  "buyer": NegotiableQuoteUser,
  "comments": [NegotiableQuoteComment],
  "created_at": "xyz789",
  "expiration_date": "abc123",
  "history": [NegotiableQuoteHistoryEntry],
  "historyV2": [NegotiableQuoteTemplateHistoryEntry],
  "is_min_max_qty_used": false,
  "is_virtual": true,
  "items": [CartItemInterface],
  "max_order_commitment": 123,
  "min_order_commitment": 987,
  "name": "xyz789",
  "notifications": [QuoteTemplateNotificationMessage],
  "prices": CartPrices,
  "reference_document_links": [
    NegotiableQuoteReferenceDocumentLink
  ],
  "sales_rep_name": "xyz789",
  "shipping_addresses": [NegotiableQuoteShippingAddress],
  "status": "xyz789",
  "template_id": 4,
  "total_quantity": 123.45,
  "uid": "4",
  "updated_at": "abc123"
}

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
created_at - String!
Timestamp indicating when the negotiable quote template was created.
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_ordered_at - String!
Timestamp indicating when the last negotiable quote template order was placed.
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.
prices - CartPrices
A set of subtotals and totals applied to 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.
uid - ID!
The unique ID of a `NegotiableQuoteTemplate` object.
updated_at - String!
Timestamp indicating when the negotiable quote template was updated.

Example

{
  "activated_at": "xyz789",
  "company_name": "abc123",
  "created_at": "abc123",
  "expiration_date": "abc123",
  "is_min_max_qty_used": true,
  "last_ordered_at": "xyz789",
  "last_shared_at": "abc123",
  "max_order_commitment": 987,
  "min_negotiated_grand_total": 987.65,
  "min_order_commitment": 123,
  "name": "xyz789",
  "orders_placed": 123,
  "prices": CartPrices,
  "sales_rep_name": "xyz789",
  "state": "abc123",
  "status": "abc123",
  "submitted_by": "abc123",
  "template_id": 4,
  "uid": 4,
  "updated_at": "abc123"
}

NegotiableQuoteTemplateHistoryChanges

Contains a list of changes to a negotiable quote template.

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 - NegotiableQuoteTemplateHistoryStatusesChange
The status before and after a change in the negotiable quote template 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": NegotiableQuoteTemplateHistoryStatusesChange,
  "total": NegotiableQuoteHistoryTotalChange
}