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": true,
"companies": UserCompaniesOutput,
"company_hierarchy": [CompanyHierarchy],
"compare_list": CompareList,
"confirmation_status": "ACCOUNT_CONFIRMED",
"created_at": "abc123",
"custom_attributes": [AttributeValueInterface],
"date_of_birth": "xyz789",
"default_billing": "abc123",
"default_shipping": "abc123",
"email": "xyz789",
"firstname": "xyz789",
"gender": 987,
"gift_registries": [GiftRegistry],
"gift_registry": GiftRegistry,
"group": CustomerGroupStorefront,
"id": 4,
"is_subscribed": false,
"job_title": "xyz789",
"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": false,
"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": "abc123",
"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": true,
"default_shipping": true,
"extension_attributes": [CustomerAddressAttribute],
"fax": "abc123",
"firstname": "xyz789",
"id": 987,
"lastname": "abc123",
"middlename": "abc123",
"postcode": "abc123",
"prefix": "xyz789",
"region": CustomerAddressRegion,
"region_id": 987,
"street": ["abc123"],
"suffix": "abc123",
"telephone": "abc123",
"uid": 4,
"vat_id": "abc123"
}
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": "xyz789",
"country_code": "AF",
"custom_attributesV2": [AttributeValueInput],
"default_billing": false,
"default_shipping": false,
"fax": "xyz789",
"firstname": "xyz789",
"lastname": "abc123",
"middlename": "abc123",
"postcode": "xyz789",
"prefix": "xyz789",
"region": CustomerAddressRegionInput,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "xyz789",
"vat_id": "abc123"
}
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": "xyz789",
"region_id": 987
}
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": true,
"is_unique": false,
"label": "abc123",
"multiline_count": 987,
"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": false,
"custom_attributes": [AttributeValueInput],
"date_of_birth": "abc123",
"email": "abc123",
"firstname": "xyz789",
"gender": 123,
"is_subscribed": false,
"lastname": "xyz789",
"middlename": "xyz789",
"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": "abc123",
"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": 987,
"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": 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": "xyz789",
"payment_methods": [OrderPaymentMethod],
"printed_card_included": true,
"returns": Returns,
"shipments": [OrderShipment],
"shipping_address": OrderAddress,
"shipping_method": "abc123",
"status": "xyz789",
"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
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": "abc123",
"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": true
}
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": "abc123",
"actual_balance": Money,
"balance_change": Money,
"date_time_changed": "xyz789"
}
CustomerToken
Contains a customer authorization token.
Fields
token - StringExample
{"token": "xyz789"}
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": false,
"custom_attributes": [AttributeValueInput],
"date_of_birth": "abc123",
"firstname": "xyz789",
"gender": 123,
"is_subscribed": true,
"lastname": "xyz789",
"middlename": "xyz789",
"prefix": "xyz789",
"suffix": "xyz789",
"taxvat": "abc123"
}
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": 123,
"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": 123.45,
"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": false,
"sort_order": 123,
"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": true,
"sort_order": 123,
"title": "xyz789",
"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": 987.65,
"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
required - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - [CustomizableDropDownValue]Example
{
"required": false,
"sort_order": 987,
"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": 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
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!CustomizableOptionInterface object.value - CustomizableFieldValueExample
{
"product_sku": "xyz789",
"required": true,
"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": 123,
"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": true,
"sort_order": 987,
"title": "abc123",
"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": "abc123",
"image_size_x": 987,
"image_size_y": 987,
"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": true,
"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": "abc123"
}
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": "abc123",
"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": 123,
"price": 123.45,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 987,
"title": "abc123",
"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": false}
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": false}
DeleteCompareListOutput
Contains the results of the request to delete a compare list.
Fields
result - Boolean!Example
{"result": true}
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": "abc123", "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": false}
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": true,
"label": "xyz789",
"type": "abc123",
"value": 123.45
}
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": true,
"is_salable": false,
"links": [DownloadableProductLinks],
"max_qty": 987.65,
"min_qty": 123.45,
"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": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"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": 123.45
}
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": 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": "xyz789",
"product_type": "xyz789",
"product_url_key": "abc123",
"quantity_canceled": 987.65,
"quantity_invoiced": 987.65,
"quantity_ordered": 123.45,
"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": "abc123",
"links_purchased_separately": 123,
"links_title": "xyz789",
"manufacturer": 123,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "xyz789",
"meta_keyword": "xyz789",
"meta_title": "abc123",
"min_sale_qty": 123.45,
"name": "abc123",
"new_from_date": "xyz789",
"new_to_date": "abc123",
"only_x_left_in_stock": 123.45,
"options": [CustomizableOptionInterface],
"options_container": "xyz789",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 987.65,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "xyz789",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "abc123",
"stock_status": "IN_STOCK",
"swatch_image": "xyz789",
"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": 987.65,
"sample_url": "xyz789",
"sort_order": 123,
"title": "xyz789",
"uid": "4"
}
DownloadableProductLinksInput
Contains the link ID for the downloadable product.
Input Fields
link_id - Int!Example
{"link_id": 987}
DownloadableProductSamples
Defines characteristics of a downloadable product.
Fields
sample_url - Stringsort_order - Inttitle - StringExample
{
"sample_url": "abc123",
"sort_order": 123,
"title": "abc123"
}
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": 987.65,
"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": "xyz789",
"customizable_options": [SelectedCustomizableOption],
"description": "xyz789",
"id": 4,
"links_v2": [DownloadableProductLinks],
"product": ProductInterface,
"quantity": 987.65,
"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": "abc123"
}
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": "xyz789"}
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": "abc123"}
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": "abc123"
}
ExchangeRate
Lists the exchange rate.
Fields
currency_to - Stringrate - FloatExample
{"currency_to": "abc123", "rate": 987.65}
FastlaneConfig
Fields
code - Stringis_visible - Booleanpayment_intent - Stringpayment_source - Stringsdk_params - [SDKParams]sort_order - Stringthree_ds_mode - ThreeDSModetitle - StringExample
{
"code": "abc123",
"is_visible": true,
"payment_intent": "xyz789",
"payment_source": "xyz789",
"sdk_params": [SDKParams],
"sort_order": "abc123",
"three_ds_mode": "OFF",
"title": "xyz789"
}
FastlaneMethodInput
Fastlane Payment inputs
Input Fields
payment_source - Stringpaypal_fastlane_token - StringExample
{
"payment_source": "xyz789",
"paypal_fastlane_token": "xyz789"
}
Field
Values
UNKNOWN_FIELDCATEGORYPRICEPRODUCTOUT_OF_STOCKLOW_STOCKTYPEVISIBILITYExample
""UNKNOWN_FIELD""
FilterEqualTypeInput
Defines a filter that matches the input exactly.
Input Fields
eq - String5.in - [String]["4", "5", "6"].Example
{
"eq": "abc123",
"in": ["abc123"]
}
FilterMatchTypeEnum
Values
FULLPARTIALExample
""FULL""
FilterMatchTypeInput
Defines a filter that performs a fuzzy search.
Input Fields
match - String24-MB01.match_type - FilterMatchTypeEnumExample
{"match": "abc123", "match_type": "FULL"}
FilterRangeTypeInput
Defines a filter that matches a range of values, such as prices or dates.
Input Fields
from - Stringto - StringExample
{
"from": "xyz789",
"to": "abc123"
}
FilterRuleInput
Input Fields
Example
{
"name": "xyz789",
"type": "UNKNOWN_FILTER_RULE_TYPE",
"conditions": [ConditionInput]
}
FilterRuleType
Values
UNKNOWN_FILTER_RULE_TYPEINCLUSIONEXCLUSIONExample
""UNKNOWN_FILTER_RULE_TYPE""
FilterStringTypeInput
Defines a filter for an input string.
Input Fields
eq - Stringin - [String]match - StringExample
{
"eq": "xyz789",
"in": ["xyz789"],
"match": "xyz789"
}
FilterTypeInput
Defines the comparison operators that can be used in a filter.
Input Fields
eq - Stringfrom - Stringto field.gt - Stringgteq - Stringin - [String]like - Stringlt - Stringlteq - Stringmoreq - Stringneq - Stringnin - [String]notnull - Stringnull - Stringto - Stringfrom field.Example
{
"eq": "xyz789",
"from": "xyz789",
"gt": "abc123",
"gteq": "abc123",
"in": ["xyz789"],
"like": "xyz789",
"lt": "xyz789",
"lteq": "abc123",
"moreq": "xyz789",
"neq": "abc123",
"nin": ["abc123"],
"notnull": "xyz789",
"null": "abc123",
"to": "abc123"
}
FilterableInSearchAttribute
Contains product attributes that can be used for filtering in a productSearch query
Fields
attribute - String!frontendInput - Stringlabel - Stringnumeric - BooleanExample
{
"attribute": "abc123",
"frontendInput": "xyz789",
"label": "abc123",
"numeric": false
}
FixedProductTax
A single FPT that can be applied to a product price.
Fields
amount - Moneylabel - StringExample
{
"amount": Money,
"label": "abc123"
}
FixedProductTaxDisplaySettings
Lists display settings for the Fixed Product Tax.
Values
INCLUDE_FPT_WITHOUT_DETAILSProductPrice.fixed_product_taxes values. This value corresponds to 'Including FPT only'.INCLUDE_FPT_WITH_DETAILSProductPrice.fixed_product_taxes separately. This value corresponds to 'Including FPT and FPT description'.EXCLUDE_FPT_AND_INCLUDE_WITH_DETAILSProductPrice.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_DETAILSProductPrice.fixed_product_taxes are not displayed. This value corresponds to 'Excluding FPT'.FPT_DISABLEDProductPrice.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
customer_email - String!Example
{"customer_email": "abc123"}
GenerateCustomerTokenAsAdminOutput
Contains the generated customer token.
Fields
customer_token - String!Example
{"customer_token": "abc123"}
GenerateNegotiableQuoteFromTemplateInput
Specifies the template id, from which to generate quote from.
Input Fields
template_id - ID!NegotiableQuoteTemplate object.Example
{"template_id": "4"}
GenerateNegotiableQuoteFromTemplateOutput
Contains the generated negotiable quote id.
Fields
negotiable_quote_uid - ID!NegotiableQuote object.Example
{"negotiable_quote_uid": 4}
GetPaymentSDKOutput
Gets the payment SDK URLs and values
Fields
sdkParams - [PaymentSDKParamsItem]Example
{"sdkParams": [PaymentSDKParamsItem]}
GiftCardAccount
Contains details about the gift card account.
Fields
balance - Moneycode - Stringexpiration_date - StringExample
{
"balance": Money,
"code": "abc123",
"expiration_date": "abc123"
}
GiftCardAccountInput
Contains the gift card code.
Input Fields
gift_card_code - String!Example
{"gift_card_code": "xyz789"}
GiftCardAmounts
Contains the value of a gift card, the website that generated the card, and related information.
Fields
attribute_id - Intuid - ID!GiftCardAmounts object.value - Floatwebsite_id - Intwebsite_value - FloatExample
{
"attribute_id": 987,
"uid": "4",
"value": 987.65,
"website_id": 123,
"website_value": 123.45
}
GiftCardCartItem
Contains details about a gift card that has been added to a cart.
Fields
amount - Money!available_gift_wrapping - [GiftWrapping]!backorder_message - Stringcustom_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 - Floatmessage - Stringmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!recipient_email - Stringrecipient_name - String!sender_email - Stringsender_name - String!uid - ID!CartItemInterface object.Example
{
"amount": Money,
"available_gift_wrapping": [GiftWrapping],
"backorder_message": "xyz789",
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"is_available": false,
"is_salable": false,
"max_qty": 987.65,
"message": "abc123",
"min_qty": 987.65,
"not_available_message": "abc123",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 987.65,
"recipient_email": "xyz789",
"recipient_name": "xyz789",
"sender_email": "xyz789",
"sender_name": "abc123",
"uid": "4"
}
GiftCardCreditMemoItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]gift_card - GiftCardItemid - ID!CreditMemoItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"gift_card": GiftCardItem,
"id": "4",
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_refunded": 123.45
}
GiftCardInvoiceItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]gift_card - GiftCardItemid - ID!InvoiceItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_invoiced - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"gift_card": GiftCardItem,
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_invoiced": 123.45
}
GiftCardItem
Contains details about a gift card.
Fields
message - Stringrecipient_email - Stringrecipient_name - Stringsender_email - Stringsender_name - StringExample
{
"message": "xyz789",
"recipient_email": "xyz789",
"recipient_name": "xyz789",
"sender_email": "abc123",
"sender_name": "xyz789"
}
GiftCardOptions
Contains details about the sender, recipient, and amount of a gift card.
Fields
amount - Moneycustom_giftcard_amount - Moneymessage - Stringrecipient_email - Stringrecipient_name - Stringsender_email - Stringsender_name - StringExample
{
"amount": Money,
"custom_giftcard_amount": Money,
"message": "xyz789",
"recipient_email": "xyz789",
"recipient_name": "xyz789",
"sender_email": "xyz789",
"sender_name": "abc123"
}
GiftCardOrderItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_card - GiftCardItemgift_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],
"eligible_for_return": false,
"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": "abc123",
"product_type": "abc123",
"product_url_key": "xyz789",
"quantity_canceled": 987.65,
"quantity_invoiced": 987.65,
"quantity_ordered": 123.45,
"quantity_refunded": 987.65,
"quantity_return_requested": 987.65,
"quantity_returned": 987.65,
"quantity_shipped": 987.65,
"selected_options": [OrderItemOption],
"status": "xyz789"
}
GiftCardProduct
Defines properties of a gift card.
Fields
allow_message - Booleanallow_open_amount - Booleancanonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_card_options - [CustomizableOptionInterface]!gift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneygiftcard_amounts - [GiftCardAmounts]giftcard_type - GiftCardTypeEnumimage - ProductImageis_redeemable - Booleanis_returnable - Stringlifetime - Intmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]message_max_length - Intmeta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatopen_amount_max - Floatopen_amount_min - 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 - Stringweight - FloatExample
{
"allow_message": true,
"allow_open_amount": false,
"canonical_url": "abc123",
"categories": [CategoryInterface],
"country_of_manufacture": "abc123",
"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": true,
"is_returnable": "abc123",
"lifetime": 987,
"manufacturer": 123,
"max_sale_qty": 987.65,
"media_gallery": [MediaGalleryInterface],
"message_max_length": 987,
"meta_description": "xyz789",
"meta_keyword": "xyz789",
"meta_title": "xyz789",
"min_sale_qty": 123.45,
"name": "xyz789",
"new_from_date": "xyz789",
"new_to_date": "xyz789",
"only_x_left_in_stock": 987.65,
"open_amount_max": 987.65,
"open_amount_min": 123.45,
"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": "abc123",
"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
customizable_options - [SelectedCustomizableOption]!gift_card_options - GiftCardOptions!product - ProductInterface!quantity - Float!sku - String!uid - ID!Example
{
"customizable_options": [SelectedCustomizableOption],
"gift_card_options": GiftCardOptions,
"product": ProductInterface,
"quantity": 987.65,
"sku": "abc123",
"uid": "4"
}
GiftCardShipmentItem
Fields
gift_card - GiftCardItemid - ID!ShipmentItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_shipped - Float!Example
{
"gift_card": GiftCardItem,
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_shipped": 123.45
}
GiftCardTypeEnum
Specifies the gift card type.
Values
VIRTUALPHYSICALCOMBINEDExample
""VIRTUAL""
GiftCardWishlistItem
A single gift card added to a wish list.
Fields
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringgift_card_options - GiftCardOptions!id - ID!WishlistItemInterface object.product - ProductInterface!quantity - Float!Example
{
"added_at": "xyz789",
"customizable_options": [SelectedCustomizableOption],
"description": "abc123",
"gift_card_options": GiftCardOptions,
"id": 4,
"product": ProductInterface,
"quantity": 123.45
}
GiftMessage
Contains the text of a gift message, its sender, and recipient
Fields
from - String!message - String!to - String!Example
{
"from": "xyz789",
"message": "abc123",
"to": "xyz789"
}
GiftMessageInput
Defines a gift message.
Input Fields
from - String!message - String!to - String!Example
{
"from": "abc123",
"message": "abc123",
"to": "abc123"
}
GiftOptionsPrices
Contains prices for gift wrapping options.
Fields
gift_wrapping_for_items - Moneygift_wrapping_for_items_incl_tax - Moneygift_wrapping_for_order - Moneygift_wrapping_for_order_incl_tax - Moneyprinted_card - Moneyprinted_card_incl_tax - MoneyExample
{
"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
created_at - String!dynamic_attributes - [GiftRegistryDynamicAttribute]event_name - String!items - [GiftRegistryItemInterface]message - String!owner_name - String!privacy_settings - GiftRegistryPrivacySettings!registrants - [GiftRegistryRegistrant]shipping_address - CustomerAddressstatus - GiftRegistryStatus!type - GiftRegistryTypeuid - ID!Example
{
"created_at": "abc123",
"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
code - ID!label - String!value - String!Example
{
"code": 4,
"group": "EVENT_INFORMATION",
"label": "xyz789",
"value": "abc123"
}
GiftRegistryDynamicAttributeGroup
Defines the group type of a gift registry dynamic attribute.
Values
EVENT_INFORMATIONPRIVACY_SETTINGSREGISTRANTGENERAL_INFORMATIONDETAILED_INFORMATIONSHIPPING_ADDRESSExample
""EVENT_INFORMATION""
GiftRegistryDynamicAttributeInput
Defines a dynamic attribute.
Input Fields
code - ID!value - String!Example
{
"code": "4",
"value": "xyz789"
}
GiftRegistryDynamicAttributeInterface
Fields
code - ID!label - String!value - String!Possible Types
Example
{
"code": "4",
"label": "xyz789",
"value": "xyz789"
}
GiftRegistryDynamicAttributeMetadata
Fields
attribute_group - String!code - ID!input_type - String!is_required - Boolean!label - String!sort_order - IntExample
{
"attribute_group": "abc123",
"code": 4,
"input_type": "xyz789",
"is_required": false,
"label": "xyz789",
"sort_order": 987
}
GiftRegistryDynamicAttributeMetadataInterface
Fields
attribute_group - String!code - ID!input_type - String!is_required - Boolean!label - String!sort_order - IntPossible Types
Example
{
"attribute_group": "abc123",
"code": "4",
"input_type": "abc123",
"is_required": true,
"label": "xyz789",
"sort_order": 123
}
GiftRegistryItem
Fields
created_at - String!note - Stringproduct - ProductInterface!quantity - Float!quantity_fulfilled - Float!uid - ID!Example
{
"created_at": "xyz789",
"note": "abc123",
"product": ProductInterface,
"quantity": 987.65,
"quantity_fulfilled": 123.45,
"uid": "4"
}
GiftRegistryItemInterface
Fields
created_at - String!note - Stringproduct - ProductInterface!quantity - Float!quantity_fulfilled - Float!uid - ID!Possible Types
Example
{
"created_at": "xyz789",
"note": "xyz789",
"product": ProductInterface,
"quantity": 123.45,
"quantity_fulfilled": 123.45,
"uid": 4
}
GiftRegistryItemUserErrorInterface
Contains the status and any errors that encountered with the customer's gift register item.
Fields
status - Boolean!user_errors - [GiftRegistryItemsUserError]!Possible Types
Example
{
"status": true,
"user_errors": [GiftRegistryItemsUserError]
}
GiftRegistryItemsUserError
Contains details about an error that occurred when processing a gift registry item.
Fields
gift_registry_item_uid - IDgift_registry_uid - IDGiftRegistry object containing an error.message - String!product_uid - IDExample
{
"code": "OUT_OF_STOCK",
"gift_registry_item_uid": 4,
"gift_registry_uid": 4,
"message": "abc123",
"product_uid": 4
}
GiftRegistryItemsUserErrorType
Defines the error type.
Values
OUT_OF_STOCKNOT_FOUNDUNDEFINEDExample
""OUT_OF_STOCK""
GiftRegistryOutputInterface
Contains the customer's gift registry.
Fields
gift_registry - GiftRegistryPossible Types
Example
{"gift_registry": GiftRegistry}
GiftRegistryPrivacySettings
Defines the privacy setting of the gift registry.
Values
PRIVATEPUBLICExample
""PRIVATE""
GiftRegistryRegistrant
Contains details about a registrant.
Fields
dynamic_attributes - [GiftRegistryRegistrantDynamicAttribute]email - String!firstname - String!lastname - String!uid - ID!Example
{
"dynamic_attributes": [
GiftRegistryRegistrantDynamicAttribute
],
"email": "xyz789",
"firstname": "abc123",
"lastname": "abc123",
"uid": "4"
}
GiftRegistryRegistrantDynamicAttribute
Fields
code - ID!label - String!value - String!Example
{
"code": 4,
"label": "abc123",
"value": "abc123"
}
GiftRegistrySearchResult
Contains the results of a gift registry search.
Fields
event_date - Stringevent_title - String!gift_registry_uid - ID!location - Stringname - String!type - StringExample
{
"event_date": "abc123",
"event_title": "xyz789",
"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
address_data - CustomerAddressInputaddress_id - IDcustomer_address_uid - IDExample
{
"address_data": CustomerAddressInput,
"address_id": 4,
"customer_address_uid": "4"
}
GiftRegistryStatus
Defines the status of the gift registry.
Values
ACTIVEINACTIVEExample
""ACTIVE""
GiftRegistryType
Contains details about a gift registry type.
Fields
dynamic_attributes_metadata - [GiftRegistryDynamicAttributeMetadataInterface]label - String!uid - ID!Example
{
"dynamic_attributes_metadata": [
GiftRegistryDynamicAttributeMetadataInterface
],
"label": "abc123",
"uid": 4
}
GiftWrapping
Contains details about the selected or available gift wrapping options.
Fields
design - String!image - GiftWrappingImageprice - Money!uid - ID!GiftWrapping object.Example
{
"design": "abc123",
"image": GiftWrappingImage,
"price": Money,
"uid": 4
}
GiftWrappingImage
Points to an image associated with a gift wrapping option.
Fields
label - String!url - String!Example
{
"label": "xyz789",
"url": "xyz789"
}
GooglePayButtonStyles
Fields
color - Stringheight - Inttype - StringExample
{
"color": "xyz789",
"height": 123,
"type": "abc123"
}
GooglePayConfig
Fields
button_styles - GooglePayButtonStylescode - Stringis_visible - Booleanpayment_intent - Stringpayment_source - Stringsdk_params - [SDKParams]sort_order - Stringthree_ds_mode - ThreeDSModetitle - StringExample
{
"button_styles": GooglePayButtonStyles,
"code": "xyz789",
"is_visible": true,
"payment_intent": "xyz789",
"payment_source": "abc123",
"sdk_params": [SDKParams],
"sort_order": "abc123",
"three_ds_mode": "OFF",
"title": "abc123"
}
GooglePayMethodInput
Google Pay inputs
Input Fields
payment_source - Stringpayments_order_id - Stringpaypal_order_id - StringExample
{
"payment_source": "xyz789",
"payments_order_id": "xyz789",
"paypal_order_id": "xyz789"
}
GroupedProduct
Defines a grouped product, which consists of simple standalone products that are presented as a group.
Fields
canonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringitems - [GroupedProductItem]manufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]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 - Stringweight - FloatExample
{
"canonical_url": "xyz789",
"categories": [CategoryInterface],
"country_of_manufacture": "xyz789",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": false,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "xyz789",
"items": [GroupedProductItem],
"manufacturer": 123,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "abc123",
"meta_keyword": "abc123",
"meta_title": "abc123",
"min_sale_qty": 123.45,
"name": "xyz789",
"new_from_date": "xyz789",
"new_to_date": "abc123",
"only_x_left_in_stock": 123.45,
"options_container": "abc123",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "abc123",
"stock_status": "IN_STOCK",
"swatch_image": "xyz789",
"thumbnail": ProductImage,
"uid": "4",
"upsell_products": [ProductInterface],
"url_key": "xyz789",
"weight": 123.45
}
GroupedProductItem
Contains information about an individual grouped product item.
Fields
position - Intproduct - ProductInterface!qty - FloatExample
{
"position": 987,
"product": ProductInterface,
"qty": 987.65
}
GroupedProductWishlistItem
A grouped product wish list item.
Fields
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!WishlistItemInterface object.product - ProductInterface!quantity - Float!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
Example
{
"reason": "xyz789",
"token": "xyz789"
}
GuestOrderInformationInput
Input to retrieve an order based on details.
Input Fields
email - String!lastname - String!number - String!Example
{
"email": "xyz789",
"lastname": "xyz789",
"number": "xyz789"
}
Highlight
An object that provides highlighted text for matched words
Fields
attribute - String!matched_words - [String]!value - String!Example
{
"attribute": "xyz789",
"matched_words": ["abc123"],
"value": "xyz789"
}
HistoryItemNoteData
Item note data that is added to the negotiable quote history object.
Fields
created_at - String!creator_name - String!creator_type - String!item_id - Int!note - String!product_name - String!Example
{
"created_at": "xyz789",
"creator_name": "xyz789",
"creator_type": "abc123",
"item_id": 123,
"note": "abc123",
"product_name": "abc123"
}
HostedFieldsConfig
Fields
cc_vault_code - Stringcode - Stringis_vault_enabled - Booleanis_visible - Booleanpayment_intent - Stringpayment_source - Stringrequires_card_details - Booleansdk_params - [SDKParams]sort_order - Stringthree_ds_mode - ThreeDSModetitle - StringExample
{
"cc_vault_code": "abc123",
"code": "xyz789",
"is_vault_enabled": false,
"is_visible": false,
"payment_intent": "xyz789",
"payment_source": "abc123",
"requires_card_details": true,
"sdk_params": [SDKParams],
"sort_order": "xyz789",
"three_ds_mode": "OFF",
"title": "xyz789"
}
HostedFieldsInput
Hosted Fields payment inputs
Input Fields
cardBin - StringcardExpiryMonth - StringcardExpiryYear - StringcardLast4 - StringholderName - Stringis_active_payment_token_enabler - Booleanpayment_source - Stringpayments_order_id - Stringpaypal_order_id - StringExample
{
"cardBin": "xyz789",
"cardExpiryMonth": "abc123",
"cardExpiryYear": "xyz789",
"cardLast4": "abc123",
"holderName": "xyz789",
"is_active_payment_token_enabler": false,
"payment_source": "xyz789",
"payments_order_id": "abc123",
"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
thumbnail - Stringvalue - StringExample
{
"thumbnail": "xyz789",
"value": "xyz789"
}
ImportSharedRequisitionListOutput
Result of importing a shared requisition list.
Fields
requisition_list - RequisitionListuser_errors - [ShareRequisitionListUserError]!Example
{
"requisition_list": RequisitionList,
"user_errors": [ShareRequisitionListUserError]
}
InputFilterEnum
List of templates/filters applied to customer attribute input.
Values
NONEDATETRIMSTRIPTAGSESCAPEHTMLExample
""NONE""
InsufficientStockError
Fields
code - CartUserInputErrorType!message - String!quantity - FloatExample
{
"code": "PRODUCT_NOT_FOUND",
"message": "xyz789",
"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
123
InternalError
Contains an error message when an internal error occurred.
Fields
message - String!Example
{"message": "abc123"}
Invoice
Contains invoice details.
Fields
comments - [SalesCommentItem]custom_attributes - [CustomAttribute]id - ID!Invoice object.items - [InvoiceItemInterface]number - String!total - InvoiceTotalExample
{
"comments": [SalesCommentItem],
"custom_attributes": [CustomAttribute],
"id": "4",
"items": [InvoiceItemInterface],
"number": "abc123",
"total": InvoiceTotal
}
InvoiceCustomAttributesInput
Defines an invoice custom attributes.
Input Fields
custom_attributes - [CustomAttributeInput]invoice_id - String!Example
{
"custom_attributes": [CustomAttributeInput],
"invoice_id": "xyz789"
}
InvoiceItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!InvoiceItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_invoiced - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_invoiced": 987.65
}
InvoiceItemCustomAttributesInput
Defines an invoice item custom attributes.
Input Fields
custom_attributes - [CustomAttributeInput]invoice_id - String!invoice_item_id - String!Example
{
"custom_attributes": [CustomAttributeInput],
"invoice_id": "xyz789",
"invoice_item_id": "xyz789"
}
InvoiceItemInterface
Contains detailes about invoiced items.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!InvoiceItemInterface object.order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_invoiced - FloatPossible Types
Example
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_invoiced": 123.45
}
InvoiceOutput
Contains details about the invoice after adding custom attributes to it.
Fields
invoice - Invoice!Example
{"invoice": Invoice}
InvoiceTotal
Contains price details from an invoice.
Fields
base_grand_total - Money!discounts - [Discount]grand_total - Money!shipping_handling - ShippingHandlingsubtotal - Money!taxes - [TaxItem]total_shipping - Money!total_tax - Money!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
is_email_available - Boolean!Example
{"is_email_available": false}
IsCompanyEmailAvailableOutput
Contains the response of a company email validation query.
Fields
is_email_available - Boolean!Example
{"is_email_available": true}
IsCompanyRoleNameAvailableOutput
Contains the response of a role name validation query.
Fields
is_role_name_available - Boolean!Example
{"is_role_name_available": false}
IsCompanyUserEmailAvailableOutput
Contains the response of a company user email validation query.
Fields
is_email_available - Boolean!Example
{"is_email_available": false}
IsEmailAvailableOutput
Contains the result of the isEmailAvailable query.
Fields
is_email_available - BooleanExample
{"is_email_available": true}
IsOperatorInput
Input Fields
Example
{"type": "UNKNOWN_ISOPERATOR_TYPE", "value": true}
IsOperatorType
Values
UNKNOWN_ISOPERATOR_TYPEISExample
""UNKNOWN_ISOPERATOR_TYPE""
IsProductAlertSubscriptionResult
Fields
Example
{"isSubscribed": false, "message": "xyz789"}
ItemNote
The note object for quote line item.
Fields
created_at - Stringcreator_id - Intcreator_name - Stringcreator_type - Intnegotiable_quote_item_uid - IDCartItemInterface object.note - Stringnote_uid - IDItemNote object.Example
{
"created_at": "abc123",
"creator_id": 123,
"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
label - String!uid - ID!ItemSelectedBundleOption object.values - [ItemSelectedBundleOptionValue]Example
{
"label": "abc123",
"uid": 4,
"values": [ItemSelectedBundleOptionValue]
}
ItemSelectedBundleOptionValue
A list of values for the selected bundle product.
Fields
price - Money!product_name - String!product_sku - String!quantity - Float!uid - ID!ItemSelectedBundleOptionValue object.Example
{
"price": Money,
"product_name": "abc123",
"product_sku": "xyz789",
"quantity": 987.65,
"uid": 4
}
JSON
A JSON scalar
Example
{}
KeyValue
Contains a key-value pair.
Fields
name - Stringvalue - StringExample
{
"name": "xyz789",
"value": "xyz789"
}
LineItemNoteInput
Sets quote item note.
Input Fields
note - Stringquote_item_uid - ID!CartLineItem object.quote_uid - ID!NegotiableQuote object.Example
{
"note": "abc123",
"quote_item_uid": "4",
"quote_uid": 4
}
MediaGalleryInterface
Contains basic information about a product image or video.
Fields
disabled - Booleanlabel - Stringposition - Inturl - StringPossible Types
Example
{
"disabled": true,
"label": "xyz789",
"position": 987,
"url": "abc123"
}
MediaResourceType
Enumeration of media resource types
Values
NEGOTIABLE_QUOTE_ATTACHMENTCUSTOMER_ATTRIBUTE_FILECUSTOMER_ATTRIBUTE_IMAGECUSTOMER_ATTRIBUTE_ADDRESS_FILECUSTOMER_ATTRIBUTE_ADDRESS_IMAGEExample
""NEGOTIABLE_QUOTE_ATTACHMENT""
MessageStyleLogo
Fields
type - StringExample
{"type": "abc123"}
MessageStyles
Fields
Example
{
"layout": "xyz789",
"logo": MessageStyleLogo
}
Money
Defines a monetary value, including a numeric value and a currency code.
Fields
currency - CurrencyEnumvalue - FloatExample
{"currency": "AFN", "value": 123.45}
MoveCartItemsToGiftRegistryOutput
Contains the customer's gift registry and any errors encountered.
Fields
gift_registry - GiftRegistrystatus - Boolean!user_errors - [GiftRegistryItemsUserError]!Example
{
"gift_registry": GiftRegistry,
"status": true,
"user_errors": [GiftRegistryItemsUserError]
}
MoveItemsBetweenRequisitionListsInput
An input object that defines the items in a requisition list to be moved.
Input Fields
requisitionListItemUids - [ID]!Example
{"requisitionListItemUids": ["4"]}
MoveItemsBetweenRequisitionListsOutput
Output of the request to move items to another requisition list.
Fields
destination_requisition_list - RequisitionListsource_requisition_list - RequisitionListExample
{
"destination_requisition_list": RequisitionList,
"source_requisition_list": RequisitionList
}
MoveLineItemToRequisitionListInput
Move Line Item to Requisition List.
Input Fields
quote_item_uid - ID!CartLineItem object.quote_uid - ID!NegotiableQuote object.requisition_list_uid - ID!Example
{
"quote_item_uid": "4",
"quote_uid": 4,
"requisition_list_uid": 4
}
MoveLineItemToRequisitionListOutput
Contains the updated negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
MoveProductsBetweenWishlistsOutput
Contains the source and target wish lists after moving products.
Fields
destination_wishlist - Wishlist!source_wishlist - Wishlist!user_errors - [WishListUserInputError]!Example
{
"destination_wishlist": Wishlist,
"source_wishlist": Wishlist,
"user_errors": [WishListUserInputError]
}
NegotiableQuote
Contains details about a negotiable quote.
Fields
available_payment_methods - [AvailablePaymentMethod]billing_address - NegotiableQuoteBillingAddressbuyer - NegotiableQuoteUser!comments - [NegotiableQuoteComment]created_at - Stringcustom_attributes - [CustomAttribute]email - Stringexpiration_date - String!history - [NegotiableQuoteHistoryEntry]is_virtual - Boolean!items - [CartItemInterface]name - String!order - CustomerOrderprices - CartPricessales_rep_name - String!selected_payment_method - SelectedPaymentMethodshipping_addresses - [NegotiableQuoteShippingAddress]!status - NegotiableQuoteStatus!template_id - IDNegotiableQuoteTemplate object.template_name - Stringtotal_quantity - Float!uid - ID!NegotiableQuote object.updated_at - StringExample
{
"available_payment_methods": [AvailablePaymentMethod],
"billing_address": NegotiableQuoteBillingAddress,
"buyer": NegotiableQuoteUser,
"comments": [NegotiableQuoteComment],
"created_at": "xyz789",
"custom_attributes": [CustomAttribute],
"email": "xyz789",
"expiration_date": "abc123",
"history": [NegotiableQuoteHistoryEntry],
"is_virtual": false,
"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": "xyz789",
"total_quantity": 987.65,
"uid": "4",
"updated_at": "abc123"
}
NegotiableQuoteAddressCountry
Defines the company's country.
Fields
code - String!label - String!Example
{
"code": "abc123",
"label": "abc123"
}
NegotiableQuoteAddressInput
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": "abc123",
"company": "abc123",
"country_code": "xyz789",
"custom_attributes": [AttributeValueInput],
"fax": "abc123",
"firstname": "abc123",
"lastname": "xyz789",
"middlename": "xyz789",
"postcode": "abc123",
"prefix": "abc123",
"region": "xyz789",
"region_id": 987,
"save_in_address_book": true,
"street": ["abc123"],
"suffix": "abc123",
"telephone": "xyz789",
"vat_id": "abc123"
}
NegotiableQuoteAddressInterface
Fields
city - String!company - Stringcountry - NegotiableQuoteAddressCountry!custom_attributes - [AttributeValueInterface]customer_address_uid - IDfax - Stringfirstname - String!lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - NegotiableQuoteAddressRegionstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringPossible Types
Example
{
"city": "xyz789",
"company": "xyz789",
"country": NegotiableQuoteAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": 4,
"fax": "xyz789",
"firstname": "xyz789",
"lastname": "abc123",
"middlename": "xyz789",
"postcode": "abc123",
"prefix": "xyz789",
"region": NegotiableQuoteAddressRegion,
"street": ["abc123"],
"suffix": "xyz789",
"telephone": "abc123",
"uid": 4,
"vat_id": "xyz789"
}
NegotiableQuoteAddressRegion
Defines the company's state or province.
Fields
code - Stringlabel - Stringregion_id - IntExample
{
"code": "xyz789",
"label": "abc123",
"region_id": 987
}
NegotiableQuoteBillingAddress
Fields
city - String!company - Stringcountry - NegotiableQuoteAddressCountry!custom_attributes - [AttributeValueInterface]customer_address_uid - IDfax - Stringfirstname - String!lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - NegotiableQuoteAddressRegionstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringExample
{
"city": "xyz789",
"company": "xyz789",
"country": NegotiableQuoteAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": 4,
"fax": "abc123",
"firstname": "abc123",
"lastname": "xyz789",
"middlename": "xyz789",
"postcode": "abc123",
"prefix": "abc123",
"region": NegotiableQuoteAddressRegion,
"street": ["abc123"],
"suffix": "xyz789",
"telephone": "xyz789",
"uid": 4,
"vat_id": "xyz789"
}
NegotiableQuoteBillingAddressInput
Defines the billing address.
Input Fields
address - NegotiableQuoteAddressInputcustomer_address_uid - IDCustomerAddress object.same_as_shipping - Booleanuse_for_shipping - BooleanExample
{
"address": NegotiableQuoteAddressInput,
"customer_address_uid": "4",
"same_as_shipping": false,
"use_for_shipping": true
}
NegotiableQuoteComment
Contains a single plain text comment from either the buyer or seller.
Fields
attachments - [NegotiableQuoteCommentAttachment]!author - NegotiableQuoteUser!created_at - String!creator_type - NegotiableQuoteCommentCreatorType!text - String!uid - ID!NegotiableQuoteComment object.Example
{
"attachments": [NegotiableQuoteCommentAttachment],
"author": NegotiableQuoteUser,
"created_at": "abc123",
"creator_type": "BUYER",
"text": "abc123",
"uid": 4
}
NegotiableQuoteCommentAttachment
Negotiable quote comment file attachment.
Fields
name - String!url - String!Example
{
"name": "abc123",
"url": "xyz789"
}
NegotiableQuoteCommentAttachmentInput
Negotiable quote comment file attachment.
Input Fields
key - String!Example
{"key": "abc123"}
NegotiableQuoteCommentCreatorType
Values
BUYERSELLERExample
""BUYER""
NegotiableQuoteCommentInput
Contains the commend provided by the buyer.
Input Fields
attachments - [NegotiableQuoteCommentAttachmentInput]comment - String!Example
{
"attachments": [NegotiableQuoteCommentAttachmentInput],
"comment": "abc123"
}
NegotiableQuoteCustomLogChange
Contains custom log entries added by third-party extensions.
Fields
new_value - String!old_value - Stringtitle - String!Example
{
"new_value": "xyz789",
"old_value": "abc123",
"title": "abc123"
}
NegotiableQuoteFilterInput
Defines a filter to limit the negotiable quotes to return.
Input Fields
ids - FilterEqualTypeInputname - FilterMatchTypeInputExample
{
"ids": FilterEqualTypeInput,
"name": FilterMatchTypeInput
}
NegotiableQuoteHistoryChanges
Contains a list of changes to a negotiable quote.
Fields
comment_added - NegotiableQuoteHistoryCommentChangecustom_changes - NegotiableQuoteCustomLogChangeexpiration - NegotiableQuoteHistoryExpirationChangeproducts_removed - NegotiableQuoteHistoryProductsRemovedChangestatuses - NegotiableQuoteHistoryStatusesChangeExample
{
"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
comment - String!Example
{"comment": "abc123"}
NegotiableQuoteHistoryEntry
Contains details about a change for a negotiable quote.
Fields
author - NegotiableQuoteUser!change_type - NegotiableQuoteHistoryEntryChangeType!changes - NegotiableQuoteHistoryChangescreated_at - Stringitem_note - HistoryItemNoteDatauid - ID!NegotiableQuoteHistoryEntry object.Example
{
"author": NegotiableQuoteUser,
"change_type": "CREATED",
"changes": NegotiableQuoteHistoryChanges,
"created_at": "xyz789",
"item_note": HistoryItemNoteData,
"uid": 4
}
NegotiableQuoteHistoryEntryChangeType
Values
CREATEDUPDATEDCLOSEDUPDATED_BY_SYSTEMExample
""CREATED""
NegotiableQuoteHistoryExpirationChange
Contains a new expiration date and the previous date.
Fields
new_expiration - Stringold_expiration - StringExample
{
"new_expiration": "abc123",
"old_expiration": "xyz789"
}
NegotiableQuoteHistoryProductsRemovedChange
Contains lists of products that have been removed from the catalog and negotiable quote.
Fields
products_removed_from_catalog - [ID]products_removed_from_quote - [ProductInterface]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
new_status - NegotiableQuoteStatus!old_status - NegotiableQuoteStatusExample
{"new_status": "SUBMITTED", "old_status": "SUBMITTED"}
NegotiableQuoteHistoryStatusesChange
Contains a list of status changes that occurred for the negotiable quote.
Fields
changes - [NegotiableQuoteHistoryStatusChange]!Example
{"changes": [NegotiableQuoteHistoryStatusChange]}
NegotiableQuoteHistoryTotalChange
Contains a new price and the previous price.
Fields
new_price - Moneyold_price - MoneyExample
{
"new_price": Money,
"old_price": Money
}
NegotiableQuoteInvalidStateError
An error indicating that an operation was attempted on a negotiable quote in an invalid state.
Fields
message - String!Example
{"message": "abc123"}
NegotiableQuoteItemQuantityInput
Specifies the updated quantity of an item.
Input Fields
quantity - Float!quote_item_uid - ID!CartItemInterface object.Example
{"quantity": 123.45, "quote_item_uid": 4}
NegotiableQuotePaymentMethodInput
Defines the payment method to be applied to the negotiable quote.
Input Fields
code - String!purchase_order_number - StringExample
{
"code": "abc123",
"purchase_order_number": "xyz789"
}
NegotiableQuoteReferenceDocumentLink
Contains a reference document link for a negotiable quote template.
Fields
document_identifier - Stringdocument_name - String!link_id - ID!reference_document_url - String!Example
{
"document_identifier": "xyz789",
"document_name": "xyz789",
"link_id": "4",
"reference_document_url": "xyz789"
}
NegotiableQuoteShippingAddress
Fields
available_shipping_methods - [AvailableShippingMethod]city - String!company - Stringcountry - NegotiableQuoteAddressCountry!custom_attributes - [AttributeValueInterface]customer_address_uid - IDfax - Stringfirstname - String!lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - NegotiableQuoteAddressRegionselected_shipping_method - SelectedShippingMethodstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringExample
{
"available_shipping_methods": [AvailableShippingMethod],
"city": "abc123",
"company": "xyz789",
"country": NegotiableQuoteAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": "4",
"fax": "abc123",
"firstname": "abc123",
"lastname": "xyz789",
"middlename": "xyz789",
"postcode": "xyz789",
"prefix": "abc123",
"region": NegotiableQuoteAddressRegion,
"selected_shipping_method": SelectedShippingMethod,
"street": ["xyz789"],
"suffix": "xyz789",
"telephone": "xyz789",
"uid": 4,
"vat_id": "abc123"
}
NegotiableQuoteShippingAddressInput
Defines shipping addresses for the negotiable quote.
Input Fields
address - NegotiableQuoteAddressInputcustomer_address_uid - IDcustomer_notes - StringExample
{
"address": NegotiableQuoteAddressInput,
"customer_address_uid": "4",
"customer_notes": "xyz789"
}
NegotiableQuoteSortInput
Defines the field to use to sort a list of negotiable quotes.
Input Fields
sort_direction - SortEnum!sort_field - NegotiableQuoteSortableField!Example
{"sort_direction": "ASC", "sort_field": "QUOTE_NAME"}
NegotiableQuoteSortableField
Values
QUOTE_NAMECREATED_ATUPDATED_ATExample
""QUOTE_NAME""
NegotiableQuoteStatus
Values
SUBMITTEDPENDINGUPDATEDOPENORDEREDCLOSEDDECLINEDEXPIREDDRAFTExample
""SUBMITTED""
NegotiableQuoteTemplate
Contains details about a negotiable quote template.
Fields
buyer - NegotiableQuoteUser!comments - [NegotiableQuoteComment]created_at - String!expiration_date - String!history - [NegotiableQuoteHistoryEntry]historyV2 - [NegotiableQuoteTemplateHistoryEntry]is_min_max_qty_used - Boolean!is_virtual - Boolean!items - [CartItemInterface]max_order_commitment - Int!min_order_commitment - Int!name - String!notifications - [QuoteTemplateNotificationMessage]prices - CartPricesreference_document_links - [NegotiableQuoteReferenceDocumentLink]sales_rep_name - String!shipping_addresses - [NegotiableQuoteShippingAddress]!status - String!template_id - ID!NegotiableQuoteTemplate object.total_quantity - Float!uid - ID!NegotiableQuoteTemplate object.updated_at - String!Example
{
"buyer": NegotiableQuoteUser,
"comments": [NegotiableQuoteComment],
"created_at": "xyz789",
"expiration_date": "abc123",
"history": [NegotiableQuoteHistoryEntry],
"historyV2": [NegotiableQuoteTemplateHistoryEntry],
"is_min_max_qty_used": true,
"is_virtual": true,
"items": [CartItemInterface],
"max_order_commitment": 987,
"min_order_commitment": 987,
"name": "abc123",
"notifications": [QuoteTemplateNotificationMessage],
"prices": CartPrices,
"reference_document_links": [
NegotiableQuoteReferenceDocumentLink
],
"sales_rep_name": "xyz789",
"shipping_addresses": [NegotiableQuoteShippingAddress],
"status": "xyz789",
"template_id": "4",
"total_quantity": 987.65,
"uid": 4,
"updated_at": "abc123"
}
NegotiableQuoteTemplateFilterInput
Defines a filter to limit the negotiable quotes to return.
Input Fields
state - FilterEqualTypeInputstatus - FilterEqualTypeInputExample
{
"state": FilterEqualTypeInput,
"status": FilterEqualTypeInput
}
NegotiableQuoteTemplateGridItem
Contains data for a negotiable quote template in a grid.
Fields
activated_at - String!company_name - String!created_at - String!expiration_date - String!is_min_max_qty_used - Boolean!last_ordered_at - String!last_shared_at - String!max_order_commitment - Int!min_negotiated_grand_total - Float!min_order_commitment - Int!name - String!orders_placed - Int!prices - CartPricessales_rep_name - String!state - String!status - String!submitted_by - String!template_id - ID!NegotiableQuoteTemplate object.uid - ID!NegotiableQuoteTemplate object.updated_at - String!Example
{
"activated_at": "abc123",
"company_name": "abc123",
"created_at": "abc123",
"expiration_date": "abc123",
"is_min_max_qty_used": false,
"last_ordered_at": "abc123",
"last_shared_at": "xyz789",
"max_order_commitment": 987,
"min_negotiated_grand_total": 987.65,
"min_order_commitment": 123,
"name": "abc123",
"orders_placed": 987,
"prices": CartPrices,
"sales_rep_name": "abc123",
"state": "abc123",
"status": "xyz789",
"submitted_by": "xyz789",
"template_id": 4,
"uid": 4,
"updated_at": "xyz789"
}
NegotiableQuoteTemplateHistoryChanges
Contains a list of changes to a negotiable quote template.
Fields
comment_added - NegotiableQuoteHistoryCommentChangecustom_changes - NegotiableQuoteCustomLogChangeexpiration - NegotiableQuoteHistoryExpirationChangeproducts_removed - NegotiableQuoteHistoryProductsRemovedChangestatuses - NegotiableQuoteTemplateHistoryStatusesChangeExample
{
"comment_added": NegotiableQuoteHistoryCommentChange,
"custom_changes": NegotiableQuoteCustomLogChange,
"expiration": NegotiableQuoteHistoryExpirationChange,
"products_removed": NegotiableQuoteHistoryProductsRemovedChange,
"statuses": NegotiableQuoteTemplateHistoryStatusesChange,
"total": NegotiableQuoteHistoryTotalChange
}