Types
CancelNegotiableQuoteTemplateInput
Specifies the quote template id of the quote template to cancel
Input Fields
cancellation_comment - Stringtemplate_id - ID!NegotiableQuoteTemplate object.Example
{
"cancellation_comment": "xyz789",
"template_id": 4
}
CancelOrderError
Fields
code - CancelOrderErrorCode!message - String!Example
{
"code": "ORDER_CANCELLATION_DISABLED",
"message": "xyz789"
}
CancelOrderErrorCode
Values
ORDER_CANCELLATION_DISABLEDUNDEFINEDUNAUTHORISEDORDER_NOT_FOUNDPARTIAL_ORDER_ITEM_SHIPPEDINVALID_ORDER_STATUSExample
""ORDER_CANCELLATION_DISABLED""
CancelOrderInput
Defines the order to cancel.
Input Fields
order_id - ID!Order type.reason - String!Example
{
"order_id": "4",
"reason": "abc123"
}
CancelOrderOutput
Contains the updated customer order and error message if any.
Fields
error - StringerrorV2 - CancelOrderErrororder - CustomerOrderExample
{
"error": "abc123",
"errorV2": CancelOrderError,
"order": CustomerOrder
}
CancellationReason
Fields
description - String!Example
{"description": "abc123"}
Card
Fields
bin_details - CardBincard_expiry_month - Stringcard_expiry_year - Stringlast_digits - Stringname - StringExample
{
"bin_details": CardBin,
"card_expiry_month": "abc123",
"card_expiry_year": "abc123",
"last_digits": "xyz789",
"name": "xyz789"
}
CardBin
Fields
bin - StringExample
{"bin": "abc123"}
CardPaymentSourceInput
The card payment source information
Input Fields
billing_address - BillingAddressPaymentSourceInput!name - StringExample
{
"billing_address": BillingAddressPaymentSourceInput,
"name": "xyz789"
}
CardPaymentSourceOutput
The card payment source information
Fields
brand - Stringexpiry - Stringlast_digits - StringExample
{
"brand": "abc123",
"expiry": "abc123",
"last_digits": "abc123"
}
Cart
Contains the contents and other details about a guest or customer cart.
Fields
applied_coupons - [AppliedCoupon]AppliedCoupon objects. Each object contains the code text attribute, which specifies the coupon code.applied_gift_cards - [AppliedGiftCard]applied_reward_points - RewardPointsAmountapplied_store_credit - AppliedStoreCreditavailable_gift_wrappings - [GiftWrapping]!available_payment_methods - [AvailablePaymentMethod]billing_address - BillingCartAddresscustom_attributes - [CustomAttribute]email - Stringgift_message - GiftMessagegift_receipt_included - Boolean!gift_wrapping - GiftWrappingid - ID!Cart object.is_virtual - Boolean!itemsV2 - CartItemsprices - CartPricesprinted_card_included - Boolean!rules - [CartRuleStorefront]selected_payment_method - SelectedPaymentMethodshipping_addresses - [ShippingCartAddress]!total_quantity - Float!Example
{
"applied_coupons": [AppliedCoupon],
"applied_gift_cards": [AppliedGiftCard],
"applied_reward_points": RewardPointsAmount,
"applied_store_credit": AppliedStoreCredit,
"available_gift_wrappings": [GiftWrapping],
"available_payment_methods": [AvailablePaymentMethod],
"billing_address": BillingCartAddress,
"custom_attributes": [CustomAttribute],
"email": "xyz789",
"gift_message": GiftMessage,
"gift_receipt_included": true,
"gift_wrapping": GiftWrapping,
"id": 4,
"is_virtual": true,
"itemsV2": CartItems,
"prices": CartPrices,
"printed_card_included": false,
"rules": [CartRuleStorefront],
"selected_payment_method": SelectedPaymentMethod,
"shipping_addresses": [ShippingCartAddress],
"total_quantity": 987.65
}
CartAddressCountry
Contains details the country in a billing or shipping address.
Fields
code - String!label - String!Example
{
"code": "xyz789",
"label": "abc123"
}
CartAddressInput
Defines the billing or shipping address to be applied to the cart.
Input Fields
city - String!company - Stringcountry_code - String!custom_attributes - [AttributeValueInput]fax - Stringfirstname - String!lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - Stringregion_id - Intsave_in_address_book - Booleanstreet - [String]!suffix - Stringtelephone - Stringvat_id - StringExample
{
"city": "xyz789",
"company": "xyz789",
"country_code": "xyz789",
"custom_attributes": [AttributeValueInput],
"fax": "xyz789",
"firstname": "xyz789",
"lastname": "xyz789",
"middlename": "xyz789",
"postcode": "abc123",
"prefix": "abc123",
"region": "xyz789",
"region_id": 123,
"save_in_address_book": true,
"street": ["xyz789"],
"suffix": "xyz789",
"telephone": "abc123",
"vat_id": "xyz789"
}
CartAddressInterface
Fields
city - String!company - Stringcountry - CartAddressCountry!custom_attributes - [AttributeValueInterface]!customer_address_uid - IDfax - Stringfirstname - String!id - Intcustomer_address_uid instead.)lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - CartAddressRegionstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringPossible Types
Example
{
"city": "xyz789",
"company": "abc123",
"country": CartAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": 4,
"fax": "xyz789",
"firstname": "abc123",
"id": 123,
"lastname": "xyz789",
"middlename": "xyz789",
"postcode": "xyz789",
"prefix": "xyz789",
"region": CartAddressRegion,
"street": ["abc123"],
"suffix": "abc123",
"telephone": "xyz789",
"uid": "4",
"vat_id": "xyz789"
}
CartAddressRegion
Contains details about the region in a billing or shipping address.
Fields
code - Stringlabel - Stringregion_id - IntExample
{
"code": "xyz789",
"label": "abc123",
"region_id": 123
}
CartCustomAttributesInput
Defines a cart custom attributes.
Input Fields
cart_id - String!custom_attributes - [CustomAttributeInput]Example
{
"cart_id": "xyz789",
"custom_attributes": [CustomAttributeInput]
}
CartDiscountType
Values
ITEMSHIPPINGExample
""ITEM""
CartItemCustomAttributesInput
Defines a cart item custom attributes.
Input Fields
cart_id - String!cart_item_id - String!custom_attributes - [CustomAttributeInput]Example
{
"cart_id": "xyz789",
"cart_item_id": "abc123",
"custom_attributes": [CustomAttributeInput]
}
CartItemError
Fields
code - CartItemErrorType!message - String!Example
{"code": "UNDEFINED", "message": "abc123"}
CartItemErrorType
Values
UNDEFINEDITEM_QTYITEM_INCREMENTSExample
""UNDEFINED""
CartItemInput
Defines an item to be added to the cart.
Input Fields
entered_options - [EnteredOptionInput]parent_sku - Stringquantity - Float!selected_options - [ID]CustomizableRadioOption, CustomizableDropDownOption, or ConfigurableProductOptionsValues.sku - String!Example
{
"entered_options": [EnteredOptionInput],
"parent_sku": "abc123",
"quantity": 987.65,
"selected_options": [4],
"sku": "xyz789"
}
CartItemInterface
An interface for products in a cart.
Fields
backorder_message - Stringcustom_attributes - [CustomAttribute]discount - [Discount]errors - [CartItemError]is_available - Boolean!is_salable instead. It indicates whether the line can be purchased, including backorder configuration.)is_salable - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!CartItemInterface object.Possible Types
Example
{
"backorder_message": "abc123",
"custom_attributes": [CustomAttribute],
"discount": [Discount],
"errors": [CartItemError],
"is_available": true,
"is_salable": true,
"max_qty": 123.45,
"min_qty": 987.65,
"not_available_message": "xyz789",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 987.65,
"uid": "4"
}
CartItemPrices
Contains details about the price of the item, including taxes and discounts.
Fields
catalog_discount - ProductDiscountdiscounts - [Discount]fixed_product_taxes - [FixedProductTax]original_item_price - Money!original_row_total - Money!price - Money!price_including_tax - Money!row_catalog_discount - ProductDiscountrow_total - Money!row_total_including_tax - Money!row_total plus the tax applied to the item.total_item_discount - MoneyExample
{
"catalog_discount": ProductDiscount,
"discounts": [Discount],
"fixed_product_taxes": [FixedProductTax],
"original_item_price": Money,
"original_row_total": Money,
"price": Money,
"price_including_tax": Money,
"row_catalog_discount": ProductDiscount,
"row_total": Money,
"row_total_including_tax": Money,
"total_item_discount": Money
}
CartItemSelectedOptionValuePrice
Contains details about the price of a selected customizable value.
Fields
type - PriceTypeEnum!units - String!value - Float!Example
{
"type": "FIXED",
"units": "xyz789",
"value": 987.65
}
CartItemUpdateInput
A single item to be updated.
Input Fields
cart_item_uid - IDCartItemInterface object.customizable_options - [CustomizableOptionInput]gift_message - GiftMessageInputgift_wrapping_id - IDGiftWrapping object to be used for the cart item.quantity - FloatExample
{
"cart_item_uid": 4,
"customizable_options": [CustomizableOptionInput],
"gift_message": GiftMessageInput,
"gift_wrapping_id": "4",
"quantity": 123.45
}
CartItems
Fields
items - [CartItemInterface]!page_info - SearchResultPageInfototal_count - Int!Example
{
"items": [CartItemInterface],
"page_info": SearchResultPageInfo,
"total_count": 987
}
CartPrices
Contains details about the final price of items in the cart, including discount and tax information.
Fields
applied_taxes - [CartTaxItem]discounts - [Discount]gift_options - GiftOptionsPricesgrand_total - Moneygrand_total_excluding_tax - Moneysubtotal_excluding_tax - Moneysubtotal_including_tax - Moneysubtotal_with_discount_excluding_tax - MoneyExample
{
"applied_taxes": [CartTaxItem],
"discounts": [Discount],
"gift_options": GiftOptionsPrices,
"grand_total": Money,
"grand_total_excluding_tax": Money,
"subtotal_excluding_tax": Money,
"subtotal_including_tax": Money,
"subtotal_with_discount_excluding_tax": Money
}
CartRuleStorefront
Fields
uid - ID!CartRule object.Example
{"uid": 4}
CartTaxItem
Contains tax information about an item in the cart.
Fields
amount - Money!label - String!Example
{
"amount": Money,
"label": "xyz789"
}
CartUserInputError
Fields
code - CartUserInputErrorType!message - String!Example
{
"code": "PRODUCT_NOT_FOUND",
"message": "xyz789"
}
CartUserInputErrorType
Values
PRODUCT_NOT_FOUNDNOT_SALABLEINSUFFICIENT_STOCKCOULD_NOT_FIND_CART_ITEMREQUIRED_PARAMETER_MISSINGINVALID_PARAMETER_VALUEUNDEFINEDPERMISSION_DENIEDExample
""PRODUCT_NOT_FOUND""
CatalogAttributeApplyToEnum
Values
SIMPLEVIRTUALBUNDLEDOWNLOADABLECONFIGURABLEGROUPEDCATEGORYExample
""SIMPLE""
CatalogAttributeMetadata
Swatch attribute metadata.
Fields
apply_to - [CatalogAttributeApplyToEnum]code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnumis_comparable - Booleanis_filterable - Booleanis_filterable_in_search - Booleanis_html_allowed_on_front - Booleanis_required - Boolean!is_searchable - Booleanis_unique - Boolean!is_used_for_price_rules - Booleanis_used_for_promo_rules - Booleanis_visible_in_advanced_search - Booleanis_visible_on_front - Booleanis_wysiwyg_enabled - Booleanlabel - Stringoptions - [CustomAttributeOptionInterface]!swatch_input_type - SwatchInputTypeEnumupdate_product_preview_image - Booleanuse_product_image_for_swatch - Booleanused_in_product_listing - BooleanExample
{
"apply_to": ["SIMPLE"],
"code": 4,
"default_value": "xyz789",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "xyz789",
"frontend_input": "BOOLEAN",
"is_comparable": false,
"is_filterable": true,
"is_filterable_in_search": false,
"is_html_allowed_on_front": false,
"is_required": false,
"is_searchable": true,
"is_unique": false,
"is_used_for_price_rules": false,
"is_used_for_promo_rules": true,
"is_visible_in_advanced_search": false,
"is_visible_on_front": false,
"is_wysiwyg_enabled": false,
"label": "abc123",
"options": [CustomAttributeOptionInterface],
"swatch_input_type": "BOOLEAN",
"update_product_preview_image": false,
"use_product_image_for_swatch": true,
"used_in_product_listing": true
}
CategoryBucket
New category bucket for federation
Fields
Example
{
"count": 123,
"id": 4,
"path": "xyz789",
"title": "abc123"
}
CategoryBucketInterface
Fields
id - ID!Possible Types
Example
{"id": "4"}
CategoryInterface
Contains the full set of attributes that can be returned in a category search.
Fields
available_sort_by - [String]breadcrumbs - [Breadcrumb]canonical_url - Stringchildren_count - Stringcustom_layout_update_file - Stringdefault_sort_by - Stringdescription - Stringdisplay_mode - Stringfilter_price_range - Floatimage - Stringinclude_in_menu - Intis_anchor - Intlanding_page - Intlevel - Intmeta_description - Stringmeta_keywords - Stringmeta_title - Stringname - Stringpath - Stringpath_in_store - Stringposition - Intproduct_count - Intuid - ID!CategoryInterface object.url_key - Stringurl_path - StringPossible Types
Example
{
"available_sort_by": ["abc123"],
"breadcrumbs": [Breadcrumb],
"canonical_url": "xyz789",
"children_count": "xyz789",
"custom_layout_update_file": "xyz789",
"default_sort_by": "xyz789",
"description": "xyz789",
"display_mode": "abc123",
"filter_price_range": 987.65,
"image": "abc123",
"include_in_menu": 123,
"is_anchor": 987,
"landing_page": 987,
"level": 987,
"meta_description": "xyz789",
"meta_keywords": "xyz789",
"meta_title": "xyz789",
"name": "xyz789",
"path": "abc123",
"path_in_store": "abc123",
"position": 123,
"product_count": 987,
"uid": "4",
"url_key": "xyz789",
"url_path": "xyz789"
}
CategoryTree
Contains the hierarchy of categories.
Fields
available_sort_by - [String]breadcrumbs - [Breadcrumb]canonical_url - Stringchildren_count - Stringcustom_layout_update_file - Stringdefault_sort_by - Stringdescription - Stringdisplay_mode - Stringfilter_price_range - Floatimage - Stringinclude_in_menu - Intis_anchor - Intlanding_page - Intlevel - Intmeta_description - Stringmeta_keywords - Stringmeta_title - Stringname - Stringpath - Stringpath_in_store - Stringposition - Intproduct_count - Intuid - ID!CategoryInterface object.url_key - Stringurl_path - StringExample
{
"available_sort_by": ["abc123"],
"breadcrumbs": [Breadcrumb],
"canonical_url": "abc123",
"children_count": "xyz789",
"custom_layout_update_file": "abc123",
"default_sort_by": "abc123",
"description": "abc123",
"display_mode": "abc123",
"filter_price_range": 123.45,
"image": "abc123",
"include_in_menu": 123,
"is_anchor": 123,
"landing_page": 123,
"level": 987,
"meta_description": "xyz789",
"meta_keywords": "xyz789",
"meta_title": "xyz789",
"name": "xyz789",
"path": "abc123",
"path_in_store": "abc123",
"position": 987,
"product_count": 987,
"uid": 4,
"url_key": "xyz789",
"url_path": "abc123"
}
CategoryView
Represents a category. Contains information about a category, including the category ID, the category name, the category path, the category URL key, the category URL path, and the category roles.
Fields
availableSortBy - [String]name, position or size.children - [String!]123, 456 or 789.defaultSortBy - Stringname, position or size.id - ID!123, 456 or 789. (Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)level - Intname - StringElectronics, Clothing or Books.parentId - String!123, 456 or 789.position - Int1, 2, 3 or 10.path - String/electronics/laptops, /clothing/shirts or /books/fiction. (Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)roles - [String!]!show_on_plp, show_in_pdp or show_in_search.urlKey - Stringelectronics, clothing or books.urlPath - String/electronics/laptops, /clothing/shirts or /books/fiction.count - Int!title - String!Example
{
"availableSortBy": ["xyz789"],
"children": ["xyz789"],
"defaultSortBy": "abc123",
"id": "4",
"level": 123,
"name": "xyz789",
"parentId": "xyz789",
"position": 123,
"path": "abc123",
"roles": ["abc123"],
"urlKey": "xyz789",
"urlPath": "abc123",
"count": 123,
"title": "xyz789"
}
CategoryViewInterface
Base interface defining essential category fields shared across all category views.
Fields
availableSortBy - [String]defaultSortBy - Stringid - ID!123, 456 or 789. (Deprecated: 'CategoryView' is deprecated for use as a Bucket in 'productSearch' facet (to be removed after Sep 1, 2024). Use 'CategoryBucket' instead.)level - Intname - StringElectronics, Clothing or Books.path - String/electronics/laptops, /clothing/shirts or /books/fiction.roles - [String]show_on_plp, show_in_pdp or show_in_search.urlKey - Stringelectronics, clothing or books.urlPath - String/electronics/laptops, /clothing/shirts or /books/fiction.Possible Types
Example
{
"availableSortBy": ["abc123"],
"defaultSortBy": "xyz789",
"id": "4",
"level": 123,
"name": "abc123",
"path": "abc123",
"roles": ["xyz789"],
"urlKey": "abc123",
"urlPath": "abc123"
}
CheckoutAgreement
Defines details about an individual checkout agreement.
Fields
agreement_id - Int!checkbox_text - String!content - String!content_height - Stringis_html - Boolean!content text is in HTML format.mode - CheckoutAgreementMode!name - String!Example
{
"agreement_id": 987,
"checkbox_text": "abc123",
"content": "xyz789",
"content_height": "abc123",
"is_html": true,
"mode": "AUTO",
"name": "xyz789"
}
CheckoutAgreementMode
Indicates how agreements are accepted.
Values
AUTOMANUALExample
""AUTO""
CheckoutUserInputError
An error encountered while adding an item to the cart.
Fields
code - CheckoutUserInputErrorCodes!message - String!path - [String]!Example
{
"code": "REORDER_NOT_AVAILABLE",
"message": "xyz789",
"path": ["xyz789"]
}
CheckoutUserInputErrorCodes
Values
REORDER_NOT_AVAILABLEPRODUCT_NOT_FOUNDNOT_SALABLEINSUFFICIENT_STOCKUNDEFINEDExample
""REORDER_NOT_AVAILABLE""
ClearCustomerCartOutput
Output of the request to clear the customer cart.
Fields
cart - Cartstatus - Boolean!Example
{"cart": Cart, "status": false}
CloseNegotiableQuoteError
Types
Example
NegotiableQuoteInvalidStateError
CloseNegotiableQuoteOperationFailure
Contains details about a failed close operation on a negotiable quote.
Fields
errors - [CloseNegotiableQuoteError]!quote_uid - ID!NegotiableQuote object.Example
{
"errors": [NegotiableQuoteInvalidStateError],
"quote_uid": 4
}
CloseNegotiableQuoteOperationResult
Types
Example
NegotiableQuoteUidOperationSuccess
CloseNegotiableQuotesInput
Defines the negotiable quotes to mark as closed.
Input Fields
quote_uids - [ID]!NegotiableQuote objects.Example
{"quote_uids": [4]}
CloseNegotiableQuotesOutput
Contains the closed negotiable quotes and other negotiable quotes the company user can view.
Fields
negotiable_quotes - NegotiableQuotesOutputoperation_results - [CloseNegotiableQuoteOperationResult]!result_status - BatchMutationStatus!Example
{
"negotiable_quotes": NegotiableQuotesOutput,
"operation_results": [
NegotiableQuoteUidOperationSuccess
],
"result_status": "SUCCESS"
}
ColorSwatchData
Fields
value - StringExample
{"value": "xyz789"}
CommerceOptimizerContext
Commerce Optimizer entities
Fields
priceBookId - ID!Example
{"priceBookId": "4"}
CompaniesSortFieldEnum
The fields available for sorting the customer companies.
Values
NAMEExample
""NAME""
CompaniesSortInput
Specifies which field to sort on, and whether to return the results in ascending or descending order.
Input Fields
field - CompaniesSortFieldEnum!order - SortEnum!Example
{"field": "NAME", "order": "ASC"}
Company
Contains the output schema for a company.
Fields
acl_resources - [CompanyAclResource]available_payment_methods - [AvailablePaymentMethod]available_shipping_methods - [CompanyAvailableShippingMethod]company_admin - Customercredit - CompanyCredit!credit_history - CompanyCreditHistory!custom_attributes - [CustomAttribute]email - Stringid - ID!Company object.legal_address - CompanyLegalAddresslegal_name - Stringname - Stringpayment_methods - [String]reseller_id - Stringrole - CompanyRoleCompanyRole object.roles - CompanyRoles!sales_representative - CompanySalesRepresentativestatus - CompanyStatusEnumstructure - CompanyStructureteam - CompanyTeamCompanyTeam object.user - CustomerCustomer object.users - CompanyUsersvat_tax_id - StringExample
{
"acl_resources": [CompanyAclResource],
"available_payment_methods": [AvailablePaymentMethod],
"available_shipping_methods": [
CompanyAvailableShippingMethod
],
"company_admin": Customer,
"credit": CompanyCredit,
"credit_history": CompanyCreditHistory,
"custom_attributes": [CustomAttribute],
"email": "xyz789",
"id": "4",
"legal_address": CompanyLegalAddress,
"legal_name": "xyz789",
"name": "abc123",
"payment_methods": ["abc123"],
"reseller_id": "abc123",
"role": CompanyRole,
"roles": CompanyRoles,
"sales_representative": CompanySalesRepresentative,
"status": "PENDING",
"structure": CompanyStructure,
"team": CompanyTeam,
"user": Customer,
"users": CompanyUsers,
"vat_tax_id": "abc123"
}
CompanyAclResource
Contains details about the access control list settings of a resource.
Fields
children - [CompanyAclResource]id - ID!CompanyAclResource object.sort_order - Inttext - StringExample
{
"children": [CompanyAclResource],
"id": 4,
"sort_order": 987,
"text": "abc123"
}
CompanyAdminInput
Defines the input schema for creating a company administrator.
Input Fields
custom_attributes - [AttributeValueInput]email - String!firstname - String!gender - Intjob_title - Stringlastname - String!telephone - StringExample
{
"custom_attributes": [AttributeValueInput],
"email": "abc123",
"firstname": "abc123",
"gender": 123,
"job_title": "abc123",
"lastname": "xyz789",
"telephone": "abc123"
}
CompanyAvailableShippingMethod
Describes a carrier-level shipping option available to the company.
Fields
Example
{
"code": "abc123",
"title": "abc123"
}
CompanyBasicInfo
The minimal required information to identify and display the company.
Fields
id - ID!Company object.is_admin - Boolean!legal_name - Stringname - Stringstatus - CompanyStatusEnumExample
{
"id": 4,
"is_admin": false,
"legal_name": "abc123",
"name": "xyz789",
"status": "PENDING"
}
CompanyCreateInput
Defines the input schema for creating a new company.
Input Fields
company_admin - CompanyAdminInput!company_email - String!company_name - String!legal_address - CompanyLegalAddressCreateInput!legal_name - Stringreseller_id - Stringvat_tax_id - StringExample
{
"company_admin": CompanyAdminInput,
"company_email": "xyz789",
"company_name": "abc123",
"legal_address": CompanyLegalAddressCreateInput,
"legal_name": "abc123",
"reseller_id": "abc123",
"vat_tax_id": "abc123"
}
CompanyCredit
Contains company credit balances and limits.
Fields
available_credit - Money!credit_limit - Money!exceed_limit - Boolean!outstanding_balance - Money!Example
{
"available_credit": Money,
"credit_limit": Money,
"exceed_limit": false,
"outstanding_balance": Money
}
CompanyCreditHistory
Contains details about prior company credit operations.
Fields
items - [CompanyCreditOperation]!page_info - SearchResultPageInfo!total_count - IntExample
{
"items": [CompanyCreditOperation],
"page_info": SearchResultPageInfo,
"total_count": 123
}
CompanyCreditHistoryFilterInput
Defines a filter for narrowing the results of a credit history search.
Input Fields
custom_reference_number - Stringoperation_type - CompanyCreditOperationTypeupdated_by - StringExample
{
"custom_reference_number": "xyz789",
"operation_type": "ALLOCATION",
"updated_by": "xyz789"
}
CompanyCreditOperation
Contains details about a single company credit operation.
Fields
amount - Moneybalance - CompanyCredit!custom_reference_number - Stringdate - String!type - CompanyCreditOperationType!updated_by - CompanyCreditOperationUser!Example
{
"amount": Money,
"balance": CompanyCredit,
"custom_reference_number": "xyz789",
"date": "abc123",
"type": "ALLOCATION",
"updated_by": CompanyCreditOperationUser
}
CompanyCreditOperationType
Values
ALLOCATIONUPDATEPURCHASEREIMBURSEMENTREFUNDREVERTExample
""ALLOCATION""
CompanyCreditOperationUser
Defines the administrator or company user that submitted a company credit operation.
Fields
name - String!Example
{"name": "abc123", "type": "CUSTOMER"}
CompanyCreditOperationUserType
Values
CUSTOMERADMINExample
""CUSTOMER""
CompanyHierarchy
Defines a parent company and its direct child companies.
Fields
children - [CompanyBasicInfo]!parent - CompanyBasicInfoExample
{
"children": [CompanyBasicInfo],
"parent": CompanyBasicInfo
}
CompanyInvitationInput
Defines the input schema for accepting the company invitation.
Input Fields
code - String!role_id - IDuser - CompanyInvitationUserInput!Example
{
"code": "xyz789",
"role_id": 4,
"user": CompanyInvitationUserInput
}
CompanyInvitationOutput
The result of accepting the company invitation.
Fields
success - BooleanExample
{"success": false}
CompanyInvitationUserInput
Company user attributes in the invitation.
Input Fields
company_id - ID!customer_id - ID!job_title - Stringstatus - CompanyUserStatusEnumtelephone - StringExample
{
"company_id": "4",
"customer_id": "4",
"job_title": "abc123",
"status": "ACTIVE",
"telephone": "abc123"
}
CompanyLegalAddress
Contains details about the address where the company is registered to conduct business.
Fields
city - Stringcountry_code - CountryCodeEnumpostcode - Stringregion - CustomerAddressRegionstreet - [String]telephone - StringExample
{
"city": "xyz789",
"country_code": "AF",
"postcode": "xyz789",
"region": CustomerAddressRegion,
"street": ["xyz789"],
"telephone": "xyz789"
}
CompanyLegalAddressCreateInput
Defines the input schema for defining a company's legal address.
Input Fields
city - String!country_id - CountryCodeEnum!countries query to get this value.postcode - String!region - CustomerAddressRegionInput!street - [String]!telephone - String!Example
{
"city": "abc123",
"country_id": "AF",
"postcode": "abc123",
"region": CustomerAddressRegionInput,
"street": ["xyz789"],
"telephone": "xyz789"
}
CompanyLegalAddressUpdateInput
Defines the input schema for updating a company's legal address.
Input Fields
city - Stringcountry_id - CountryCodeEnumCountry object.postcode - Stringregion - CustomerAddressRegionInputstreet - [String]telephone - StringExample
{
"city": "abc123",
"country_id": "AF",
"postcode": "xyz789",
"region": CustomerAddressRegionInput,
"street": ["xyz789"],
"telephone": "abc123"
}
CompanyRole
Contails details about a single role.
Fields
id - ID!CompanyRole object.name - Stringpermissions - [CompanyAclResource]users_count - IntExample
{
"id": "4",
"name": "abc123",
"permissions": [CompanyAclResource],
"users_count": 123
}
CompanyRoleCreateInput
Defines the input schema for creating a company role.
Input Fields
name - String!permissions - [String]Example
{
"name": "xyz789",
"permissions": ["abc123"]
}
CompanyRoleUpdateInput
Defines the input schema for updating a company role.
Input Fields
id - ID!CompanyRole object.name - Stringpermissions - [String]Example
{
"id": "4",
"name": "xyz789",
"permissions": ["xyz789"]
}
CompanyRoles
Contains an array of roles.
Fields
items - [CompanyRole]!page_info - SearchResultPageInfototal_count - Int!Example
{
"items": [CompanyRole],
"page_info": SearchResultPageInfo,
"total_count": 987
}
CompanySalesRepresentative
Contains details about a company sales representative.
Fields
email - Stringfirstname - Stringlastname - StringExample
{
"email": "abc123",
"firstname": "xyz789",
"lastname": "abc123"
}
CompanyStatusEnum
Defines the list of company status values.
Values
PENDINGAPPROVEDREJECTEDBLOCKEDExample
""PENDING""
CompanyStructure
Contains an array of the individual nodes that comprise the company structure.
Fields
items - [CompanyStructureItem]Example
{"items": [CompanyStructureItem]}
CompanyStructureEntity
Types
Example
CompanyTeam
CompanyStructureItem
Defines an individual node in the company structure.
Fields
entity - CompanyStructureEntityCompanyTeam and Customer objects.id - ID!CompanyStructureItem object.parent_id - IDExample
{
"entity": CompanyTeam,
"id": "4",
"parent_id": "4"
}
CompanyStructureUpdateInput
Defines the input schema for updating the company structure.
Input Fields
parent_tree_id - ID!tree_id - ID!Example
{
"parent_tree_id": "4",
"tree_id": "4"
}
CompanyTeam
Describes a company team.
Fields
description - Stringid - IDCompanyTeam object.name - Stringstructure_id - ID!Example
{
"description": "xyz789",
"id": "4",
"name": "abc123",
"structure_id": "4"
}
CompanyTeamCreateInput
Defines the input schema for creating a company team.
Input Fields
description - Stringname - String!target_id - IDExample
{
"description": "abc123",
"name": "xyz789",
"target_id": 4
}
CompanyTeamUpdateInput
Defines the input schema for updating a company team.
Input Fields
description - Stringid - ID!CompanyTeam object to update.name - StringExample
{
"description": "abc123",
"id": 4,
"name": "abc123"
}
CompanyUpdateInput
Defines the input schema for updating a company.
Input Fields
company_email - Stringcompany_name - Stringlegal_address - CompanyLegalAddressUpdateInputlegal_name - Stringreseller_id - Stringvat_tax_id - StringExample
{
"company_email": "abc123",
"company_name": "abc123",
"legal_address": CompanyLegalAddressUpdateInput,
"legal_name": "xyz789",
"reseller_id": "abc123",
"vat_tax_id": "xyz789"
}
CompanyUserCreateInput
Defines the input schema for creating a company user.
Input Fields
email - String!firstname - String!job_title - String!lastname - String!role_id - ID!CompanyRole object.status - CompanyUserStatusEnum!target_id - IDtelephone - String!Example
{
"email": "abc123",
"firstname": "xyz789",
"job_title": "xyz789",
"lastname": "xyz789",
"role_id": "4",
"status": "ACTIVE",
"target_id": "4",
"telephone": "xyz789"
}
CompanyUserStatusEnum
Defines the list of company user status values.
Values
ACTIVEINACTIVEExample
""ACTIVE""
CompanyUserUpdateInput
Defines the input schema for updating a company user.
Input Fields
email - Stringfirstname - Stringid - ID!Customer object.job_title - Stringlastname - Stringrole_id - IDCompanyRole object.status - CompanyUserStatusEnumtelephone - StringExample
{
"email": "xyz789",
"firstname": "xyz789",
"id": "4",
"job_title": "abc123",
"lastname": "abc123",
"role_id": "4",
"status": "ACTIVE",
"telephone": "xyz789"
}
CompanyUsers
Contains details about company users.
Fields
items - [Customer]!CompanyUser objects that match the specified filter criteria.page_info - SearchResultPageInfototal_count - Int!Example
{
"items": [Customer],
"page_info": SearchResultPageInfo,
"total_count": 987
}
CompanyUsersFilterInput
Defines the filter for returning a list of company users.
Input Fields
status - CompanyUserStatusEnumExample
{"status": "ACTIVE"}
ComparableAttribute
Contains an attribute code that is used for product comparisons.
Fields
code - String!label - String!Example
{
"code": "abc123",
"label": "abc123"
}
ComparableItem
Defines an object used to iterate through items for product comparisons.
Fields
attributes - [ProductAttribute]!product - ProductInterface!uid - ID!Example
{
"attributes": [ProductAttribute],
"product": ProductInterface,
"uid": "4"
}
CompareList
Contains iterable information such as the array of items, the count, and attributes that represent the compare list.
Fields
attributes - [ComparableAttribute]item_count - Int!items - [ComparableItem]uid - ID!Example
{
"attributes": [ComparableAttribute],
"item_count": 123,
"items": [ComparableItem],
"uid": "4"
}
CompleteOrderInput
Update the quote and complete the order
Input Fields
Example
{
"cartId": "abc123",
"id": "abc123"
}
ComplexProductView
Represents all product types, except simple products. Complex product prices are returned as a price range, because price values can vary based on selected options.
Fields
addToCartAllowed - BooleaninStock - BooleanlowStock - Booleanattributes - [ProductViewAttribute]description - Stringid - ID!images - [ProductViewImage]image, small_image or swatch.videos - [ProductViewVideo]lastModifiedAt - DateTimemetaDescription - StringmetaKeyword - StringmetaTitle - Stringname - StringinputOptions - [ProductViewInputOption]options - [ProductViewOption]priceRange - ProductViewPriceRangeshortDescription - Stringsku - StringexternalId - Stringurl - StringurlKey - Stringlinks - [ProductViewLink]queryType - Stringvisibility - StringExample
{
"addToCartAllowed": false,
"inStock": false,
"lowStock": false,
"attributes": [ProductViewAttribute],
"description": "xyz789",
"id": "4",
"images": [ProductViewImage],
"videos": [ProductViewVideo],
"lastModifiedAt": "2007-12-03T10:15:30Z",
"metaDescription": "xyz789",
"metaKeyword": "abc123",
"metaTitle": "xyz789",
"name": "abc123",
"inputOptions": [ProductViewInputOption],
"options": [ProductViewOption],
"priceRange": ProductViewPriceRange,
"shortDescription": "abc123",
"sku": "abc123",
"externalId": "xyz789",
"url": "xyz789",
"urlKey": "abc123",
"links": [ProductViewLink],
"queryType": "abc123",
"visibility": "abc123"
}
ComplexTextValue
Fields
html - String!Example
{"html": "abc123"}
ConditionInput
Input Fields
Example
{
"field": "UNKNOWN_FIELD",
"operator": OperatorInput,
"enabled": false
}
ConfigurableAttributeOption
Contains details about a configurable product attribute option.
Fields
code - Stringlabel - Stringuid - ID!ConfigurableAttributeOption object.value_index - IntExample
{
"code": "abc123",
"label": "abc123",
"uid": "4",
"value_index": 123
}
ConfigurableCartItem
An implementation for configurable product cart items.
Fields
available_gift_wrapping - [GiftWrapping]!backorder_message - Stringconfigurable_options - [SelectedConfigurableOption]!configured_variant - ProductInterface!custom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]gift_message - GiftMessagegift_wrapping - GiftWrappingis_available - Boolean!is_salable instead. It indicates whether the line can be purchased, including backorder configuration.)is_salable - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!CartItemInterface object.Example
{
"available_gift_wrapping": [GiftWrapping],
"backorder_message": "abc123",
"configurable_options": [SelectedConfigurableOption],
"configured_variant": ProductInterface,
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"is_available": false,
"is_salable": false,
"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,
"uid": "4"
}
ConfigurableOptionAvailableForSelection
Describes configurable options that have been selected and can be selected as a result of the previous selections.
Fields
attribute_code - String!option_value_uids - [ID]!Example
{
"attribute_code": "abc123",
"option_value_uids": ["4"]
}
ConfigurableOrderItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!OrderItemInterface object.parent_sku - Stringprices - OrderItemPricesproduct - ProductInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!product_type - Stringproduct_url_key - Stringquantity_canceled - Floatquantity_invoiced - Floatquantity_ordered - Floatquantity_refunded - Floatquantity_return_requested - Floatquantity_returned - Floatquantity_shipped - Floatselected_options - [OrderItemOption]status - StringExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"eligible_for_return": false,
"entered_options": [OrderItemOption],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": "4",
"parent_sku": "xyz789",
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"product_type": "xyz789",
"product_url_key": "abc123",
"quantity_canceled": 123.45,
"quantity_invoiced": 987.65,
"quantity_ordered": 987.65,
"quantity_refunded": 123.45,
"quantity_return_requested": 123.45,
"quantity_returned": 987.65,
"quantity_shipped": 987.65,
"selected_options": [OrderItemOption],
"status": "abc123"
}
ConfigurableProduct
Defines basic features of a configurable product and its simple product variants.
Fields
canonical_url - Stringcategories - [CategoryInterface]configurable_options - [ConfigurableProductOptions]configurable_product_options_selection - ConfigurableProductOptionsSelectioncountry_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions - [CustomizableOptionInterface]options_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]TierPrice objects.product_links - [ProductLinksInterface]ProductLinks objects.quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!ProductInterface object.upsell_products - [ProductInterface]url_key - Stringvariants - [ConfigurableVariant]weight - FloatExample
{
"canonical_url": "xyz789",
"categories": [CategoryInterface],
"configurable_options": [ConfigurableProductOptions],
"configurable_product_options_selection": ConfigurableProductOptionsSelection,
"country_of_manufacture": "abc123",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": false,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"manufacturer": 123,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "xyz789",
"meta_keyword": "abc123",
"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": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "abc123",
"stock_status": "IN_STOCK",
"swatch_image": "abc123",
"thumbnail": ProductImage,
"uid": "4",
"upsell_products": [ProductInterface],
"url_key": "abc123",
"variants": [ConfigurableVariant],
"weight": 123.45
}
ConfigurableProductOption
Contains details about configurable product options.
Fields
attribute_code - String!label - String!uid - ID!values - [ConfigurableProductOptionValue]Example
{
"attribute_code": "xyz789",
"label": "xyz789",
"uid": 4,
"values": [ConfigurableProductOptionValue]
}
ConfigurableProductOptionValue
Defines a value for a configurable product option.
Fields
is_available - Boolean!is_use_default - Boolean!label - String!swatch - SwatchDataInterfaceuid - ID!Example
{
"is_available": true,
"is_use_default": true,
"label": "abc123",
"swatch": SwatchDataInterface,
"uid": 4
}
ConfigurableProductOptions
Defines configurable attributes for the specified product.
Fields
attribute_code - Stringattribute_uid - ID!Attribute object.label - Stringposition - Intuid - ID!ConfigurableProductOptions object.use_default - Booleanvalues - [ConfigurableProductOptionsValues]value_index codes assigned to the configurable product.Example
{
"attribute_code": "abc123",
"attribute_uid": 4,
"label": "abc123",
"position": 123,
"uid": "4",
"use_default": true,
"values": [ConfigurableProductOptionsValues]
}
ConfigurableProductOptionsSelection
Contains metadata corresponding to the selected configurable options.
Fields
configurable_options - [ConfigurableProductOption]media_gallery - [MediaGalleryInterface]options_available_for_selection - [ConfigurableOptionAvailableForSelection]variant - SimpleProductExample
{
"configurable_options": [ConfigurableProductOption],
"media_gallery": [MediaGalleryInterface],
"options_available_for_selection": [
ConfigurableOptionAvailableForSelection
],
"variant": SimpleProduct
}
ConfigurableProductOptionsValues
Contains the index number assigned to a configurable product option.
Fields
default_label - Stringlabel - Stringstore_label - Stringswatch_data - SwatchDataInterfaceuid - IDConfigurableProductOptionsValues object.use_default_value - BooleanExample
{
"default_label": "xyz789",
"label": "xyz789",
"store_label": "abc123",
"swatch_data": SwatchDataInterface,
"uid": "4",
"use_default_value": false
}
ConfigurableRequisitionListItem
Contains details about configurable products added to a requisition list.
Fields
configurable_options - [SelectedConfigurableOption]customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!sku - String!uid - ID!Example
{
"configurable_options": [SelectedConfigurableOption],
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 987.65,
"sku": "abc123",
"uid": 4
}
ConfigurableVariant
Contains all the simple product variants of a configurable product.
Fields
attributes - [ConfigurableAttributeOption]product - SimpleProductExample
{
"attributes": [ConfigurableAttributeOption],
"product": SimpleProduct
}
ConfigurableWishlistItem
A configurable product wish list item.
Fields
added_at - String!configurable_options - [SelectedConfigurableOption]configured_variant - ProductInterfacecustomizable_options - [SelectedCustomizableOption]!description - Stringid - ID!WishlistItemInterface object.product - ProductInterface!quantity - Float!Example
{
"added_at": "xyz789",
"configurable_options": [SelectedConfigurableOption],
"configured_variant": ProductInterface,
"customizable_options": [SelectedCustomizableOption],
"description": "abc123",
"id": "4",
"product": ProductInterface,
"quantity": 123.45
}
ConfirmCancelOrderInput
Input Fields
confirmation_key - String!order_id - ID!Order type.Example
{
"confirmation_key": "abc123",
"order_id": "4"
}
ConfirmEmailInput
Contains details about a customer email address to confirm.
Input Fields
confirmation_key - String!email - String!Example
{
"confirmation_key": "abc123",
"email": "abc123"
}
ConfirmReturnInput
Input Fields
confirmation_key - String!order_id - ID!Order type.Example
{
"confirmation_key": "abc123",
"order_id": "4"
}
ConfirmationStatusEnum
List of account confirmation statuses.
Values
ACCOUNT_CONFIRMEDACCOUNT_CONFIRMATION_NOT_REQUIREDExample
""ACCOUNT_CONFIRMED""
ContactUsInput
Input Fields
comment - String!email - String!name - String!telephone - StringExample
{
"comment": "xyz789",
"email": "xyz789",
"name": "xyz789",
"telephone": "xyz789"
}
ContactUsOutput
Contains the status of the request.
Fields
status - Boolean!Example
{"status": true}
CopyItemsBetweenRequisitionListsInput
An input object that defines the items in a requisition list to be copied.
Input Fields
requisitionListItemUids - [ID]!Example
{"requisitionListItemUids": [4]}
CopyItemsFromRequisitionListsOutput
Output of the request to copy items to the destination requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
CopyProductsBetweenWishlistsOutput
Contains the source and target wish lists after copying products.
Fields
destination_wishlist - Wishlist!source_wishlist - Wishlist!user_errors - [WishListUserInputError]!Example
{
"destination_wishlist": Wishlist,
"source_wishlist": Wishlist,
"user_errors": [WishListUserInputError]
}
Country
Fields
available_regions - [Region]full_name_english - Stringfull_name_locale - Stringid - StringCountry object.three_letter_abbreviation - Stringtwo_letter_abbreviation - StringExample
{
"available_regions": [Region],
"full_name_english": "abc123",
"full_name_locale": "xyz789",
"id": "abc123",
"three_letter_abbreviation": "xyz789",
"two_letter_abbreviation": "xyz789"
}
CountryCodeEnum
The list of country codes.
Values
AFAXALDZASADAOAIAQAGARAMAWAUATAZBSBHBDBBBYBEBZBJBMBTBOBABWBVBRIOVGBNBGBFBIKHCMCACVKYCFTDCLCNCXCCCOKMCGCDCKCRCIHRCUCYCZDKDJDMDOECEGSVGQEREESZETFKFOFJFIFRGFPFTFGAGMGEDEGHGIGRGLGDGPGUGTGGGNGWGYHTHMHNHKHUISINIDIRIQIEIMILITJMJPJEJOKZKEKIKWKGLALVLBLSLRLYLILTLUMOMKMGMWMYMVMLMTMHMQMRMUYTMXFMMDMCMNMEMSMAMZMMNANRNPNLANNCNZNINENGNUNFMPKPNOOMPKPWPSPAPGPYPEPHPNPLPTQARERORURWWSSMSTSASNRSSCSLSGSKSISBSOZAGSKRESLKBLSHKNLCMFPMVCSDSRSJSECHSYTWTJTZTHTLTGTKTOTTTNTRTMTCTVUGUAAEGBUSUYUMVIUZVUVAVEVNWFEHYEZMZWExample
""AF""
CreateCompanyOutput
Contains the response to the request to create a company.
Fields
company - Company!Example
{"company": Company}
CreateCompanyRoleOutput
Contains the response to the request to create a company role.
Fields
role - CompanyRole!Example
{"role": CompanyRole}
CreateCompanyTeamOutput
Contains the response to the request to create a company team.
Fields
team - CompanyTeam!Example
{"team": CompanyTeam}
CreateCompanyUserOutput
Contains the response to the request to create a company user.
Fields
user - Customer!Example
{"user": Customer}
CreateCompareListInput
Contains an array of product IDs to use for creating a compare list.
Input Fields
products - [ID]Example
{"products": [4]}
CreateGiftRegistryInput
Defines a new gift registry.
Input Fields
dynamic_attributes - [GiftRegistryDynamicAttributeInput]event_name - String!gift_registry_type_uid - ID!message - String!privacy_settings - GiftRegistryPrivacySettings!registrants - [AddGiftRegistryRegistrantInput]!shipping_address - GiftRegistryShippingAddressInputstatus - GiftRegistryStatus!Example
{
"dynamic_attributes": [
GiftRegistryDynamicAttributeInput
],
"event_name": "xyz789",
"gift_registry_type_uid": "4",
"message": "xyz789",
"privacy_settings": "PRIVATE",
"registrants": [AddGiftRegistryRegistrantInput],
"shipping_address": GiftRegistryShippingAddressInput,
"status": "ACTIVE"
}
CreateGiftRegistryOutput
Contains the results of a request to create a gift registry.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
CreateGuestCartInput
Input Fields
cart_uid - IDExample
{"cart_uid": 4}
CreateGuestCartOutput
Fields
cart - CartExample
{"cart": Cart}
CreatePaymentOrderInput
Contains payment order details that are used while processing the payment order
Input Fields
cartId - String!location - PaymentLocation!methodCode - String!paymentSource - String!vaultIntent - BooleanExample
{
"cartId": "xyz789",
"location": "PRODUCT_DETAIL",
"methodCode": "abc123",
"paymentSource": "abc123",
"vaultIntent": true
}
CreatePaymentOrderOutput
Contains payment order details that are used while processing the payment order
Fields
amount - Floatcurrency_code - Stringid - Stringmp_order_id - Stringstatus - StringExample
{
"amount": 123.45,
"currency_code": "abc123",
"id": "xyz789",
"mp_order_id": "xyz789",
"status": "abc123"
}
CreatePurchaseOrderApprovalRuleConditionAmountInput
Specifies the amount and currency to evaluate.
Input Fields
currency - CurrencyEnum!value - Float!Example
{"currency": "AFN", "value": 123.45}
CreatePurchaseOrderApprovalRuleConditionInput
Defines a set of conditions that apply to a rule.
Input Fields
attribute - PurchaseOrderApprovalRuleType!operator - PurchaseOrderApprovalRuleConditionOperator!quantity - IntExample
{
"amount": CreatePurchaseOrderApprovalRuleConditionAmountInput,
"attribute": "GRAND_TOTAL",
"operator": "MORE_THAN",
"quantity": 123
}
CreateRequisitionListInput
An input object that identifies and describes a new requisition list.
Input Fields
description - Stringname - String!Example
{
"description": "abc123",
"name": "xyz789"
}
CreateRequisitionListOutput
Output of the request to create a requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
CreateVaultCardPaymentTokenInput
Describe the variables needed to create a vault payment token
Input Fields
card_description - Stringsetup_token_id - String!Example
{
"card_description": "xyz789",
"setup_token_id": "abc123"
}
CreateVaultCardPaymentTokenOutput
The vault token id and information about the payment source
Fields
payment_source - PaymentSourceOutput!vault_token_id - String!Example
{
"payment_source": PaymentSourceOutput,
"vault_token_id": "xyz789"
}
CreateVaultCardSetupTokenInput
Describe the variables needed to create a vault card setup token
Input Fields
setup_token - VaultSetupTokenInput!three_ds_mode - ThreeDSModeExample
{
"setup_token": VaultSetupTokenInput,
"three_ds_mode": "OFF"
}
CreateVaultCardSetupTokenOutput
The setup token id information
Fields
setup_token - String!Example
{"setup_token": "abc123"}
CreateWishlistInput
Defines the name and visibility of a new wish list.
Input Fields
name - String!visibility - WishlistVisibilityEnum!Example
{"name": "xyz789", "visibility": "PUBLIC"}
CreateWishlistOutput
Contains the wish list.
Fields
wishlist - Wishlist!Example
{"wishlist": Wishlist}
CreditMemo
Contains credit memo details.
Fields
comments - [SalesCommentItem]custom_attributes - [CustomAttribute]id - ID!CreditMemo object.items - [CreditMemoItemInterface]number - String!total - CreditMemoTotalExample
{
"comments": [SalesCommentItem],
"custom_attributes": [CustomAttribute],
"id": 4,
"items": [CreditMemoItemInterface],
"number": "xyz789",
"total": CreditMemoTotal
}
CreditMemoCustomAttributesInput
Defines a credit memo item's custom attributes.
Input Fields
credit_memo_id - String!custom_attributes - [CustomAttributeInput]Example
{
"credit_memo_id": "abc123",
"custom_attributes": [CustomAttributeInput]
}
CreditMemoItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!CreditMemoItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": "4",
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "xyz789",
"quantity_refunded": 987.65
}
CreditMemoItemCustomAttributesInput
Defines a credit memo's custom attributes.
Input Fields
credit_memo_id - String!credit_memo_item_id - String!custom_attributes - [CustomAttributeInput]Example
{
"credit_memo_id": "abc123",
"credit_memo_item_id": "abc123",
"custom_attributes": [CustomAttributeInput]
}
CreditMemoItemInterface
Credit memo item details.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!CreditMemoItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatPossible Types
Example
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_refunded": 987.65
}
CreditMemoOutput
Contains details about the credit memo after adding custom attributes to it.
Fields
credit_memo - CreditMemo!Example
{"credit_memo": CreditMemo}
CreditMemoTotal
Contains credit memo price details.
Fields
adjustment - Money!base_grand_total - Money!discounts - [Discount]grand_total - Money!shipping_handling - ShippingHandlingsubtotal - Money!taxes - [TaxItem]total_shipping - Money!total_tax - Money!Example
{
"adjustment": Money,
"base_grand_total": Money,
"discounts": [Discount],
"grand_total": Money,
"shipping_handling": ShippingHandling,
"subtotal": Money,
"taxes": [TaxItem],
"total_shipping": Money,
"total_tax": Money
}
Currency
Fields
available_currency_codes - [String]base_currency_code - Stringbase_currency_symbol - Stringdefault_display_currency_code - Stringdefault_display_currency_symbol - Stringexchange_rates - [ExchangeRate]Example
{
"available_currency_codes": ["abc123"],
"base_currency_code": "xyz789",
"base_currency_symbol": "abc123",
"default_display_currency_code": "abc123",
"default_display_currency_symbol": "abc123",
"exchange_rates": [ExchangeRate]
}
CurrencyEnum
The list of available currency codes.
Values
AFNALLAZNDZDAOAARSAMDAWGAUDBSDBHDBDTBBDBYNBZDBMDBTNBOBBAMBWPBRLGBPBNDBGNBUKBIFKHRCADCVECZKKYDGQECLPCNYCOPKMFCDFCRCHRKCUPDKKDJFDOPXCDEGPSVCERNEEKETBEURFKPFJDGMDGEKGELGHSGIPGTQGNFGYDHTGHNLHKDHUFISKINRIDRIRRIQDILSJMDJPYJODKZTKESKWDKGSLAKLVLLBPLSLLRDLYDLTLMOPMKDMGAMWKMYRMVRLSMMROMURMXNMDLMNTMADMZNMMKNADNPRANGNZDNICNGNKPWNOKOMRPKRPABPGKPYGPENPHPPLNQARRHDRONRUBRWFSHPSTDSARRSDSCRSLLSGDSKKSBDSOSZARKRWLKRSDGSRDSZLSEKCHFSYPTWDTJSTZSTHBTOPTTDTNDTMMUSDUGXUAHAEDUYUUZSVUVVEBVEFVNDCHECHWXOFWSTYERZMKZWDTRYAZMROLTRLXPFExample
""AFN""
CurrentProductInput
Attributes of the product currently being viewed on PDP
Input Fields
sku - Stringprice - FloatExample
{"sku": "abc123", "price": 123.45}
CustomAttribute
Specifies the custom attribute code and value.
Fields
attribute_code - Stringvalue - StringExample
{
"attribute_code": "abc123",
"value": "abc123"
}
CustomAttributeInput
Defines a custom attribute.
Input Fields
Example
{
"attribute_code": "xyz789",
"value": "xyz789"
}
CustomAttributeMetadataInterface
An interface containing fields that define the EAV attribute.
Fields
code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnumis_required - Boolean!is_unique - Boolean!label - Stringoptions - [CustomAttributeOptionInterface]!Possible Types
Example
{
"code": "4",
"default_value": "abc123",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "xyz789",
"frontend_input": "BOOLEAN",
"is_required": true,
"is_unique": false,
"label": "abc123",
"options": [CustomAttributeOptionInterface]
}
CustomAttributeOptionInterface
Fields
is_default - Boolean!label - String!value - String!Possible Types
Example
{
"is_default": false,
"label": "abc123",
"value": "xyz789"
}
CustomConfigKeyValue
A simple key value object.
Fields
Example
{
"key": "abc123",
"value": "abc123"
}
CustomOperatorInput
Input Fields
Example
{
"type": "UNKNOWN_CUSTOMOPERATOR_TYPE",
"value": ["abc123"]
}
CustomOperatorType
Values
UNKNOWN_CUSTOMOPERATOR_TYPECUSTOMExample
""UNKNOWN_CUSTOMOPERATOR_TYPE""
Customer
Defines the customer name, addresses, and other details.
Fields
addresses - [CustomerAddress]addressesV2 - CustomerAddressesadmin_assistance_actions - AdminAssistanceActions!allow_remote_shopping_assistance - Boolean!companies - UserCompaniesOutput!company_hierarchy - [CompanyHierarchy]compare_list - CompareListconfirmation_status - ConfirmationStatusEnum!created_at - Stringcustom_attributes - [AttributeValueInterface]date_of_birth - Stringdefault_billing - Stringdefault_shipping - Stringemail - Stringfirstname - Stringgender - Intgift_registries - [GiftRegistry]gift_registry - GiftRegistrygroup - CustomerGroupStorefrontid - ID!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 - Booleanjob_title - Stringlastname - Stringmiddlename - Stringorders - CustomerOrdersprefix - Stringpurchase_order - PurchaseOrderpurchase_order_approval_rule - PurchaseOrderApprovalRulepurchase_order_approval_rule_metadata - PurchaseOrderApprovalRuleMetadatapurchase_order_approval_rules - PurchaseOrderApprovalRulespurchase_orders - PurchaseOrderspurchase_orders_enabled - Boolean!quote_enabled - Boolean!requisition_lists - RequisitionListsreturn - ReturnReturn object.returns - Returnsreward_points - RewardPointsrole - CompanyRolesegments - [CustomerSegmentStorefront]status - CompanyUserStatusEnumstore_credit - CustomerStoreCreditstructure_id - ID!suffix - Stringtaxvat - Stringteam - CompanyTeamtelephone - Stringwishlist_v2 - WishlistWishlist object.wishlists - [Wishlist]!Example
{
"addresses": [CustomerAddress],
"addressesV2": CustomerAddresses,
"admin_assistance_actions": AdminAssistanceActions,
"allow_remote_shopping_assistance": false,
"companies": UserCompaniesOutput,
"company_hierarchy": [CompanyHierarchy],
"compare_list": CompareList,
"confirmation_status": "ACCOUNT_CONFIRMED",
"created_at": "abc123",
"custom_attributes": [AttributeValueInterface],
"date_of_birth": "abc123",
"default_billing": "xyz789",
"default_shipping": "xyz789",
"email": "abc123",
"firstname": "abc123",
"gender": 987,
"gift_registries": [GiftRegistry],
"gift_registry": GiftRegistry,
"group": CustomerGroupStorefront,
"id": 4,
"is_subscribed": true,
"job_title": "abc123",
"lastname": "xyz789",
"middlename": "abc123",
"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": "xyz789",
"taxvat": "abc123",
"team": CompanyTeam,
"telephone": "xyz789",
"wishlist_v2": Wishlist,
"wishlists": [Wishlist]
}
CustomerAddress
Contains detailed information about a customer's billing or shipping address.
Fields
city - Stringcompany - Stringcountry_code - CountryCodeEnumcustom_attributesV2 - [AttributeValueInterface]!default_billing - Booleandefault_shipping - Booleanextension_attributes - [CustomerAddressAttribute]fax - Stringfirstname - Stringid - IntCustomerAddress object. (Deprecated: Use uid instead.)lastname - Stringmiddlename - Stringpostcode - Stringprefix - Stringregion - CustomerAddressRegionregion_id - Intstreet - [String]suffix - Stringtelephone - Stringuid - IDCustomerAddress object.vat_id - StringExample
{
"city": "xyz789",
"company": "xyz789",
"country_code": "AF",
"custom_attributesV2": [AttributeValueInterface],
"default_billing": false,
"default_shipping": true,
"extension_attributes": [CustomerAddressAttribute],
"fax": "abc123",
"firstname": "xyz789",
"id": 123,
"lastname": "xyz789",
"middlename": "abc123",
"postcode": "xyz789",
"prefix": "xyz789",
"region": CustomerAddressRegion,
"region_id": 987,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "xyz789",
"uid": "4",
"vat_id": "xyz789"
}
CustomerAddressAttribute
Specifies the attribute code and value of a customer address attribute.
Fields
attribute_code - Stringvalue - StringExample
{
"attribute_code": "xyz789",
"value": "xyz789"
}
CustomerAddressInput
Contains details about a billing or shipping address.
Input Fields
city - Stringcompany - Stringcountry_code - CountryCodeEnumcustom_attributesV2 - [AttributeValueInput]default_billing - Booleandefault_shipping - Booleanfax - Stringfirstname - Stringlastname - Stringmiddlename - Stringpostcode - Stringprefix - Stringregion - CustomerAddressRegionInputstreet - [String]suffix - Stringtelephone - Stringvat_id - StringExample
{
"city": "xyz789",
"company": "abc123",
"country_code": "AF",
"custom_attributesV2": [AttributeValueInput],
"default_billing": false,
"default_shipping": true,
"fax": "xyz789",
"firstname": "xyz789",
"lastname": "xyz789",
"middlename": "abc123",
"postcode": "xyz789",
"prefix": "xyz789",
"region": CustomerAddressRegionInput,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "abc123",
"vat_id": "xyz789"
}
CustomerAddressRegion
Defines the customer's state or province.
Fields
region - Stringregion_code - Stringregion_id - IntExample
{
"region": "xyz789",
"region_code": "abc123",
"region_id": 987
}
CustomerAddressRegionInput
Defines the customer's state or province.
Input Fields
region - Stringregion_code - Stringregion_id - IntExample
{
"region": "xyz789",
"region_code": "abc123",
"region_id": 123
}
CustomerAddresses
Fields
items - [CustomerAddress]page_info - SearchResultPageInfototal_count - IntExample
{
"items": [CustomerAddress],
"page_info": SearchResultPageInfo,
"total_count": 123
}
CustomerAttributeMetadata
Customer attribute metadata.
Fields
code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnuminput_filter - InputFilterEnumis_required - Boolean!is_unique - Boolean!label - Stringmultiline_count - Intoptions - [CustomAttributeOptionInterface]!sort_order - Intvalidate_rules - [ValidationRule]Example
{
"code": 4,
"default_value": "xyz789",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "abc123",
"frontend_input": "BOOLEAN",
"input_filter": "NONE",
"is_required": false,
"is_unique": true,
"label": "xyz789",
"multiline_count": 123,
"options": [CustomAttributeOptionInterface],
"sort_order": 987,
"validate_rules": [ValidationRule]
}
CustomerCreateInput
An input object for creating a customer.
Input Fields
allow_remote_shopping_assistance - Booleancustom_attributes - [AttributeValueInput]date_of_birth - Stringemail - String!firstname - String!gender - Intis_subscribed - Booleanlastname - String!middlename - Stringpassword - Stringprefix - Stringsuffix - Stringtaxvat - StringExample
{
"allow_remote_shopping_assistance": true,
"custom_attributes": [AttributeValueInput],
"date_of_birth": "xyz789",
"email": "abc123",
"firstname": "xyz789",
"gender": 123,
"is_subscribed": false,
"lastname": "abc123",
"middlename": "abc123",
"password": "abc123",
"prefix": "xyz789",
"suffix": "abc123",
"taxvat": "abc123"
}
CustomerDownloadableProduct
Contains details about a single downloadable product.
Fields
date - Stringdownload_url - Stringorder_increment_id - Stringremaining_downloads - Stringstatus - StringPending and Invoiced.Example
{
"date": "xyz789",
"download_url": "abc123",
"order_increment_id": "abc123",
"remaining_downloads": "xyz789",
"status": "xyz789"
}
CustomerDownloadableProducts
Contains a list of downloadable products.
Fields
items - [CustomerDownloadableProduct]Example
{"items": [CustomerDownloadableProduct]}
CustomerGroupStorefront
Data of customer group.
Fields
uid - ID!CustomerGroup object.Example
{"uid": "4"}
CustomerOrder
Contains details about each of the customer's orders.
Fields
admin_assisted_order - Intapplied_coupons - [AppliedCoupon]!applied_gift_cards - [ApplyGiftCardToOrder]available_actions - [OrderActionType]!billing_address - OrderAddresscarrier - Stringcomments - [SalesCommentItem]credit_memos - [CreditMemo]custom_attributes - [CustomAttribute]customer_info - OrderCustomerInfo!email - Stringgift_message - GiftMessagegift_receipt_included - Boolean!gift_wrapping - GiftWrappingid - ID!CustomerOrder object.invoices - [Invoice]!is_virtual - Boolean!TRUE if the order is virtualitems - [OrderItemInterface]items_eligible_for_return - [OrderItemInterface]negotiable_quote - NegotiableQuotenumber - String!order_date - String!order_status_change_date - String!payment_methods - [OrderPaymentMethod]printed_card_included - Boolean!returns - Returnsshipments - [OrderShipment]shipping_address - OrderAddressshipping_method - Stringstatus - String!token - String!total - OrderTotalExample
{
"admin_assisted_order": 123,
"applied_coupons": [AppliedCoupon],
"applied_gift_cards": [ApplyGiftCardToOrder],
"available_actions": ["REORDER"],
"billing_address": OrderAddress,
"carrier": "abc123",
"comments": [SalesCommentItem],
"credit_memos": [CreditMemo],
"custom_attributes": [CustomAttribute],
"customer_info": OrderCustomerInfo,
"email": "abc123",
"gift_message": GiftMessage,
"gift_receipt_included": true,
"gift_wrapping": GiftWrapping,
"id": 4,
"invoices": [Invoice],
"is_virtual": false,
"items": [OrderItemInterface],
"items_eligible_for_return": [OrderItemInterface],
"negotiable_quote": NegotiableQuote,
"number": "abc123",
"order_date": "abc123",
"order_status_change_date": "abc123",
"payment_methods": [OrderPaymentMethod],
"printed_card_included": false,
"returns": Returns,
"shipments": [OrderShipment],
"shipping_address": OrderAddress,
"shipping_method": "abc123",
"status": "abc123",
"token": "abc123",
"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
sort_direction - SortEnum!sort_field - CustomerOrderSortableField!Example
{"sort_direction": "ASC", "sort_field": "NUMBER"}
CustomerOrderSortableField
Specifies the field to use for sorting
Values
NUMBERCREATED_ATExample
""NUMBER""
CustomerOrders
The collection of orders that match the conditions defined in the filter.
Fields
date_of_first_order - Stringitems - [CustomerOrder]!page_info - SearchResultPageInfototal_count - IntExample
{
"date_of_first_order": "xyz789",
"items": [CustomerOrder],
"page_info": SearchResultPageInfo,
"total_count": 123
}
CustomerOrdersFilterInput
Identifies the filter to use for filtering orders.
Input Fields
grand_total - FilterRangeTypeInputnumber - FilterStringTypeInputorder_date - FilterRangeTypeInputstatus - FilterEqualTypeInputExample
{
"grand_total": FilterRangeTypeInput,
"number": FilterStringTypeInput,
"order_date": FilterRangeTypeInput,
"status": FilterEqualTypeInput
}
CustomerOutput
Contains details about a newly-created or updated customer.
Fields
customer - Customer!Example
{"customer": Customer}
CustomerPaymentTokens
Contains payment tokens stored in the customer's vault.
Fields
items - [PaymentToken]!Example
{"items": [PaymentToken]}
CustomerSegmentStorefront
Customer segment details
Fields
uid - ID!CustomerSegment object.Example
{"uid": 4}
CustomerStoreCredit
Contains store credit information with balance and history.
Fields
balance_history - CustomerStoreCreditHistorycurrent_balance - Moneyenabled - BooleanExample
{
"balance_history": CustomerStoreCreditHistory,
"current_balance": Money,
"enabled": false
}
CustomerStoreCreditHistory
Lists changes to the amount of store credit available to the customer.
Fields
items - [CustomerStoreCreditHistoryItem]page_info - SearchResultPageInfototal_count - IntExample
{
"items": [CustomerStoreCreditHistoryItem],
"page_info": SearchResultPageInfo,
"total_count": 987
}
CustomerStoreCreditHistoryItem
Contains store credit history information.
Fields
action - Stringactual_balance - Moneybalance_change - Moneydate_time_changed - StringExample
{
"action": "xyz789",
"actual_balance": Money,
"balance_change": Money,
"date_time_changed": "xyz789"
}
CustomerToken
Contains a customer authorization token.
Fields
token - StringExample
{"token": "abc123"}
CustomerUpdateInput
An input object for updating a customer.
Input Fields
allow_remote_shopping_assistance - Booleancustom_attributes - [AttributeValueInput]date_of_birth - Stringfirstname - Stringgender - Intis_subscribed - Booleanlastname - Stringmiddlename - Stringprefix - Stringsuffix - Stringtaxvat - StringExample
{
"allow_remote_shopping_assistance": true,
"custom_attributes": [AttributeValueInput],
"date_of_birth": "xyz789",
"firstname": "abc123",
"gender": 123,
"is_subscribed": true,
"lastname": "xyz789",
"middlename": "xyz789",
"prefix": "abc123",
"suffix": "abc123",
"taxvat": "xyz789"
}
CustomizableAreaOption
Contains information about a text area that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - CustomizableAreaValueExample
{
"product_sku": "xyz789",
"required": false,
"sort_order": 987,
"title": "abc123",
"uid": "4",
"value": CustomizableAreaValue
}
CustomizableAreaValue
Defines the price and sku of a product whose page contains a customized text area.
Fields
max_characters - Intprice - Floatprice_type - PriceTypeEnumsku - Stringuid - ID!CustomizableAreaValue object.Example
{
"max_characters": 123,
"price": 987.65,
"price_type": "FIXED",
"sku": "xyz789",
"uid": 4
}
CustomizableCheckboxOption
Contains information about a set of checkbox values that are defined as part of a customizable option.
Fields
required - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - [CustomizableCheckboxValue]Example
{
"required": true,
"sort_order": 987,
"title": "xyz789",
"uid": "4",
"value": [CustomizableCheckboxValue]
}
CustomizableCheckboxValue
Defines the price and sku of a product whose page contains a customized set of checkbox values.
Fields
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!CustomizableCheckboxValue object.Example
{
"option_type_id": 123,
"price": 123.45,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 987,
"title": "abc123",
"uid": 4
}
CustomizableDateOption
Contains information about a date picker that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - CustomizableDateValueExample
{
"product_sku": "xyz789",
"required": false,
"sort_order": 123,
"title": "abc123",
"uid": "4",
"value": CustomizableDateValue
}
CustomizableDateTypeEnum
Defines the customizable date type.
Values
DATEDATE_TIMETIMEExample
""DATE""
CustomizableDateValue
Defines the price and sku of a product whose page contains a customized date picker.
Fields
price - Floatprice_type - PriceTypeEnumsku - Stringtype - CustomizableDateTypeEnumuid - ID!CustomizableDateValue object.Example
{
"price": 123.45,
"price_type": "FIXED",
"sku": "xyz789",
"type": "DATE",
"uid": 4
}
CustomizableDropDownOption
Contains information about a drop down menu that is defined as part of a customizable option.
Fields
required - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - [CustomizableDropDownValue]Example
{
"required": false,
"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
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!CustomizableDropDownValue object.Example
{
"option_type_id": 123,
"price": 123.45,
"price_type": "FIXED",
"sku": "xyz789",
"sort_order": 123,
"title": "xyz789",
"uid": "4"
}
CustomizableFieldOption
Contains information about a text field that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - CustomizableFieldValueExample
{
"product_sku": "abc123",
"required": false,
"sort_order": 123,
"title": "abc123",
"uid": 4,
"value": CustomizableFieldValue
}
CustomizableFieldValue
Defines the price and sku of a product whose page contains a customized text field.
Fields
max_characters - Intprice - Floatprice_type - PriceTypeEnumsku - Stringuid - ID!CustomizableFieldValue object.Example
{
"max_characters": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "xyz789",
"uid": 4
}
CustomizableFileOption
Contains information about a file picker that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - CustomizableFileValueExample
{
"product_sku": "xyz789",
"required": false,
"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
file_extension - Stringimage_size_x - Intimage_size_y - Intprice - Floatprice_type - PriceTypeEnumsku - Stringuid - ID!CustomizableFileValue object.Example
{
"file_extension": "xyz789",
"image_size_x": 123,
"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
required - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - [CustomizableMultipleValue]Example
{
"required": false,
"sort_order": 123,
"title": "abc123",
"uid": "4",
"value": [CustomizableMultipleValue]
}
CustomizableMultipleValue
Defines the price and sku of a product whose page contains a customized multiselect.
Fields
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!CustomizableMultipleValue object.Example
{
"option_type_id": 987,
"price": 123.45,
"price_type": "FIXED",
"sku": "xyz789",
"sort_order": 987,
"title": "abc123",
"uid": 4
}
CustomizableOptionInput
Defines a customizable option.
Input Fields
uid - IDCartItemInterface object.value_string - String!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
required - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.Possible Types
Example
{
"required": true,
"sort_order": 123,
"title": "abc123",
"uid": 4
}
CustomizableProductInterface
Contains information about customizable product options.
Fields
options - [CustomizableOptionInterface]Possible Types
Example
{"options": [CustomizableOptionInterface]}
CustomizableRadioOption
Contains information about a set of radio buttons that are defined as part of a customizable option.
Fields
required - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - [CustomizableRadioValue]Example
{
"required": false,
"sort_order": 987,
"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
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!CustomizableRadioValue object.Example
{
"option_type_id": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 987,
"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
success - Boolean!Example
{"success": true}
DeleteCompanyTeamOutput
Contains the status of the request to delete a company team.
Fields
success - Boolean!Example
{"success": true}
DeleteCompanyUserOutput
Contains the response to the request to delete the company user.
Fields
success - Boolean!Example
{"success": true}
DeleteCompareListOutput
Contains the results of the request to delete a compare list.
Fields
result - Boolean!Example
{"result": false}
DeleteNegotiableQuoteError
Types
Example
NegotiableQuoteInvalidStateError
DeleteNegotiableQuoteOperationFailure
Contains details about a failed delete operation on a negotiable quote.
Fields
errors - [DeleteNegotiableQuoteError]!quote_uid - ID!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
template_id - ID!NegotiableQuoteTemplate object.Example
{"template_id": "4"}
DeleteNegotiableQuotesInput
Input Fields
quote_uids - [ID]!NegotiableQuote objects to delete.Example
{"quote_uids": [4]}
DeleteNegotiableQuotesOutput
Contains a list of undeleted negotiable quotes the company user can view.
Fields
negotiable_quotes - NegotiableQuotesOutputoperation_results - [DeleteNegotiableQuoteOperationResult]!result_status - BatchMutationStatus!Example
{
"negotiable_quotes": NegotiableQuotesOutput,
"operation_results": [
NegotiableQuoteUidOperationSuccess
],
"result_status": "SUCCESS"
}
DeletePaymentTokenOutput
Indicates whether the request succeeded and returns the remaining customer payment tokens.
Fields
customerPaymentTokens - CustomerPaymentTokensresult - Boolean!Example
{
"customerPaymentTokens": CustomerPaymentTokens,
"result": false
}
DeletePurchaseOrderApprovalRuleError
Contains details about an error that occurred when deleting an approval rule .
Fields
Example
{"message": "xyz789", "type": "UNDEFINED"}
DeletePurchaseOrderApprovalRuleErrorType
Values
UNDEFINEDNOT_FOUNDExample
""UNDEFINED""
DeletePurchaseOrderApprovalRuleInput
Specifies the IDs of the approval rules to delete.
Input Fields
approval_rule_uids - [ID]!Example
{"approval_rule_uids": [4]}
DeletePurchaseOrderApprovalRuleOutput
Contains any errors encountered while attempting to delete approval rules.
Fields
Example
{"errors": [DeletePurchaseOrderApprovalRuleError]}
DeleteRequisitionListItemsOutput
Output of the request to remove items from the requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
DeleteRequisitionListOutput
Indicates whether the request to delete the requisition list was successful.
Fields
requisition_lists - RequisitionListsstatus - Boolean!Example
{"requisition_lists": RequisitionLists, "status": true}
DeleteWishlistOutput
Contains the status of the request to delete a wish list and an array of the customer's remaining wish lists.
Fields
status - Boolean!wishlists - [Wishlist]!Example
{"status": true, "wishlists": [Wishlist]}
Discount
Specifies the discount type and value for quote line item.
Fields
amount - Money!applied_to - CartDiscountType!coupon - AppliedCouponis_discounting_locked - Booleanlabel - String!type - Stringvalue - FloatExample
{
"amount": Money,
"applied_to": "ITEM",
"coupon": AppliedCoupon,
"is_discounting_locked": false,
"label": "xyz789",
"type": "xyz789",
"value": 987.65
}
DownloadableCartItem
An implementation for downloadable product cart items.
Fields
backorder_message - Stringcustom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]is_available - Boolean!is_salable instead. It indicates whether the line can be purchased, including backorder configuration.)is_salable - Boolean!links - [DownloadableProductLinks]max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!samples - [DownloadableProductSamples]uid - ID!CartItemInterface object.Example
{
"backorder_message": "xyz789",
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"is_available": false,
"is_salable": true,
"links": [DownloadableProductLinks],
"max_qty": 123.45,
"min_qty": 987.65,
"not_available_message": "xyz789",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 123.45,
"samples": [DownloadableProductSamples],
"uid": "4"
}
DownloadableCreditMemoItem
Defines downloadable product options for CreditMemoItemInterface.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]downloadable_links - [DownloadableItemsLinks]id - ID!CreditMemoItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"downloadable_links": [DownloadableItemsLinks],
"id": "4",
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "xyz789",
"quantity_refunded": 987.65
}
DownloadableInvoiceItem
Defines downloadable product options for InvoiceItemInterface.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]downloadable_links - [DownloadableItemsLinks]id - ID!InvoiceItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_invoiced - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"downloadable_links": [DownloadableItemsLinks],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "xyz789",
"quantity_invoiced": 987.65
}
DownloadableItemsLinks
Defines characteristics of the links for downloadable product.
Fields
sort_order - Inttitle - Stringuid - ID!DownloadableItemsLinks object.Example
{
"sort_order": 987,
"title": "abc123",
"uid": "4"
}
DownloadableOrderItem
Defines downloadable product options for OrderItemInterface.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]downloadable_links - [DownloadableItemsLinks]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!OrderItemInterface object.prices - OrderItemPricesproduct - ProductInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!product_type - Stringproduct_url_key - Stringquantity_canceled - Floatquantity_invoiced - Floatquantity_ordered - Floatquantity_refunded - Floatquantity_return_requested - Floatquantity_returned - Floatquantity_shipped - Floatselected_options - [OrderItemOption]status - StringExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"downloadable_links": [DownloadableItemsLinks],
"eligible_for_return": false,
"entered_options": [OrderItemOption],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": 4,
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "xyz789",
"product_type": "xyz789",
"product_url_key": "xyz789",
"quantity_canceled": 123.45,
"quantity_invoiced": 987.65,
"quantity_ordered": 987.65,
"quantity_refunded": 123.45,
"quantity_return_requested": 987.65,
"quantity_returned": 123.45,
"quantity_shipped": 123.45,
"selected_options": [OrderItemOption],
"status": "abc123"
}
DownloadableProduct
Defines a product that the shopper downloads.
Fields
canonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuedownloadable_product_links - [DownloadableProductLinks]downloadable_product_samples - [DownloadableProductSamples]gift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringlinks_purchased_separately - Intlinks_title - Stringmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions - [CustomizableOptionInterface]options_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]TierPrice objects.product_links - [ProductLinksInterface]ProductLinks objects.quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!ProductInterface object.upsell_products - [ProductInterface]url_key - StringExample
{
"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": false,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "xyz789",
"links_purchased_separately": 123,
"links_title": "xyz789",
"manufacturer": 987,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "xyz789",
"meta_keyword": "abc123",
"meta_title": "xyz789",
"min_sale_qty": 987.65,
"name": "abc123",
"new_from_date": "abc123",
"new_to_date": "xyz789",
"only_x_left_in_stock": 987.65,
"options": [CustomizableOptionInterface],
"options_container": "abc123",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "abc123",
"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
customizable_options - [CustomizableOptionInput]data - CartItemInput!downloadable_product_links - [DownloadableProductLinksInput]Example
{
"customizable_options": [CustomizableOptionInput],
"data": CartItemInput,
"downloadable_product_links": [
DownloadableProductLinksInput
]
}
DownloadableProductLinks
Defines characteristics of a downloadable product.
Fields
price - Floatsample_url - Stringsort_order - Inttitle - Stringuid - ID!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
link_id - Int!Example
{"link_id": 123}
DownloadableProductSamples
Defines characteristics of a downloadable product.
Fields
sample_url - Stringsort_order - Inttitle - StringExample
{
"sample_url": "xyz789",
"sort_order": 123,
"title": "xyz789"
}
DownloadableRequisitionListItem
Contains details about downloadable products added to a requisition list.
Fields
customizable_options - [SelectedCustomizableOption]!links - [DownloadableProductLinks]product - ProductInterface!quantity - Float!samples - [DownloadableProductSamples]sku - String!uid - ID!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
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!WishlistItemInterface object.links_v2 - [DownloadableProductLinks]product - ProductInterface!quantity - Float!samples - [DownloadableProductSamples]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
duplicated_quote_uid - ID!quote_uid - ID!Example
{
"duplicated_quote_uid": "4",
"quote_uid": 4
}
DuplicateNegotiableQuoteOutput
Contains the newly created negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
EnteredCustomAttributeInput
Contains details about a custom text attribute that the buyer entered.
Input Fields
attribute_code - String!value - String!Example
{
"attribute_code": "xyz789",
"value": "xyz789"
}
EnteredOptionInput
Defines a customer-entered option.
Input Fields
uid - ID!CustomizableOptionInterface object, such as a CustomizableFieldOption, CustomizableFileOption, or CustomizableAreaOption object.value - String!Example
{"uid": 4, "value": "abc123"}
Error
An error encountered while adding an item to the the cart.
Fields
code - CartUserInputErrorType!message - String!Possible Types
Example
{
"code": "PRODUCT_NOT_FOUND",
"message": "abc123"
}
ErrorInterface
Fields
message - String!Possible Types
Example
{"message": "xyz789"}
EstimateAddressInput
Contains details about an address.
Input Fields
country_code - CountryCodeEnum!postcode - Stringregion - CustomerAddressRegionInputExample
{
"country_code": "AF",
"postcode": "xyz789",
"region": CustomerAddressRegionInput
}
EstimateTotalsInput
Input Fields
address - EstimateAddressInput!cart_id - String!shipping_method - ShippingMethodInputExample
{
"address": EstimateAddressInput,
"cart_id": "xyz789",
"shipping_method": ShippingMethodInput
}
EstimateTotalsOutput
Estimate totals output.
Fields
cart - CartExample
{"cart": Cart}
ExchangeExternalCustomerTokenInput
Contains details about external customer.
Input Fields
customer - CustomerCreateInput!Example
{"customer": CustomerCreateInput}
ExchangeExternalCustomerTokenOutput
Contains customer token for external customer.
Fields
customer - Customer!token - String!Example
{
"customer": Customer,
"token": "xyz789"
}
ExchangeRate
Lists the exchange rate.
Fields
currency_to - Stringrate - FloatExample
{"currency_to": "xyz789", "rate": 123.45}