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 - CustomerAddressesallow_remote_shopping_assistance - Boolean!companies - UserCompaniesOutput!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!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 - Returnreturns - Returnsreward_points - RewardPointsrole - CompanyRolesegments - [CustomerSegmentStorefront]status - CompanyUserStatusEnumstore_credit - CustomerStoreCreditstructure_id - ID!suffix - Stringtaxvat - Stringteam - CompanyTeamtelephone - Stringwishlist_v2 - Wishlistwishlists - [Wishlist]!Example
{
"addresses": [CustomerAddress],
"addressesV2": CustomerAddresses,
"allow_remote_shopping_assistance": false,
"companies": UserCompaniesOutput,
"compare_list": CompareList,
"confirmation_status": "ACCOUNT_CONFIRMED",
"created_at": "xyz789",
"custom_attributes": [AttributeValueInterface],
"date_of_birth": "xyz789",
"default_billing": "xyz789",
"default_shipping": "xyz789",
"email": "xyz789",
"firstname": "xyz789",
"gender": 987,
"gift_registries": [GiftRegistry],
"gift_registry": GiftRegistry,
"group": CustomerGroupStorefront,
"id": "4",
"is_subscribed": true,
"job_title": "abc123",
"lastname": "abc123",
"middlename": "xyz789",
"orders": CustomerOrders,
"prefix": "xyz789",
"purchase_order": PurchaseOrder,
"purchase_order_approval_rule": PurchaseOrderApprovalRule,
"purchase_order_approval_rule_metadata": PurchaseOrderApprovalRuleMetadata,
"purchase_order_approval_rules": PurchaseOrderApprovalRules,
"purchase_orders": PurchaseOrders,
"purchase_orders_enabled": false,
"quote_enabled": true,
"requisition_lists": RequisitionLists,
"return": Return,
"returns": Returns,
"reward_points": RewardPoints,
"role": CompanyRole,
"segments": [CustomerSegmentStorefront],
"status": "ACTIVE",
"store_credit": CustomerStoreCredit,
"structure_id": 4,
"suffix": "abc123",
"taxvat": "abc123",
"team": CompanyTeam,
"telephone": "xyz789",
"wishlist_v2": Wishlist,
"wishlists": [Wishlist]
}
CustomerAddress
Contains detailed information about a customer's billing or shipping address.
Fields
city - Stringcompany - Stringcountry_code - CountryCodeEnumcustom_attributesV2 - [AttributeValueInterface]!default_billing - Booleandefault_shipping - Booleanextension_attributes - [CustomerAddressAttribute]fax - Stringfirstname - Stringid - Intlastname - Stringmiddlename - Stringpostcode - Stringprefix - Stringregion - CustomerAddressRegionregion_id - Intstreet - [String]suffix - Stringtelephone - Stringuid - IDvat_id - StringExample
{
"city": "abc123",
"company": "abc123",
"country_code": "AF",
"custom_attributesV2": [AttributeValueInterface],
"default_billing": true,
"default_shipping": true,
"extension_attributes": [CustomerAddressAttribute],
"fax": "abc123",
"firstname": "abc123",
"id": 987,
"lastname": "abc123",
"middlename": "abc123",
"postcode": "abc123",
"prefix": "xyz789",
"region": CustomerAddressRegion,
"region_id": 123,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "abc123",
"uid": 4,
"vat_id": "xyz789"
}
CustomerAddressAttribute
Specifies the attribute code and value of a customer address attribute.
Fields
attribute_code - Stringvalue - StringExample
{
"attribute_code": "xyz789",
"value": "abc123"
}
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": "abc123",
"company": "xyz789",
"country_code": "AF",
"custom_attributesV2": [AttributeValueInput],
"default_billing": true,
"default_shipping": true,
"fax": "xyz789",
"firstname": "xyz789",
"lastname": "abc123",
"middlename": "abc123",
"postcode": "abc123",
"prefix": "xyz789",
"region": CustomerAddressRegionInput,
"street": ["xyz789"],
"suffix": "xyz789",
"telephone": "abc123",
"vat_id": "xyz789"
}
CustomerAddressRegion
Defines the customer's state or province.
Fields
region - Stringregion_code - Stringregion_id - IntExample
{
"region": "xyz789",
"region_code": "xyz789",
"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": 123
}
CustomerAddresses
Fields
items - [CustomerAddress]page_info - SearchResultPageInfototal_count - IntExample
{
"items": [CustomerAddress],
"page_info": SearchResultPageInfo,
"total_count": 987
}
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": "abc123",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "xyz789",
"frontend_input": "BOOLEAN",
"input_filter": "NONE",
"is_required": false,
"is_unique": true,
"label": "xyz789",
"multiline_count": 987,
"options": [CustomAttributeOptionInterface],
"sort_order": 123,
"validate_rules": [ValidationRule]
}
CustomerCreateInput
An input object for creating a customer.
Input Fields
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": 987,
"is_subscribed": false,
"lastname": "abc123",
"middlename": "abc123",
"password": "xyz789",
"prefix": "abc123",
"suffix": "abc123",
"taxvat": "xyz789"
}
CustomerDownloadableProduct
Contains details about a single downloadable product.
Fields
date - Stringdownload_url - Stringorder_increment_id - Stringremaining_downloads - Stringstatus - StringExample
{
"date": "abc123",
"download_url": "abc123",
"order_increment_id": "abc123",
"remaining_downloads": "xyz789",
"status": "abc123"
}
CustomerDownloadableProducts
Contains a list of downloadable products.
Fields
items - [CustomerDownloadableProduct]Example
{"items": [CustomerDownloadableProduct]}
CustomerGroupStorefront
Data of customer group.
Fields
uid - ID!Example
{"uid": "4"}
CustomerOrder
Contains details about each of the customer's orders.
Fields
applied_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!invoices - [Invoice]!is_virtual - Boolean!items - [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
{
"applied_coupons": [AppliedCoupon],
"applied_gift_cards": [ApplyGiftCardToOrder],
"available_actions": ["REORDER"],
"billing_address": OrderAddress,
"carrier": "xyz789",
"comments": [SalesCommentItem],
"credit_memos": [CreditMemo],
"custom_attributes": [CustomAttribute],
"customer_info": OrderCustomerInfo,
"email": "xyz789",
"gift_message": GiftMessage,
"gift_receipt_included": false,
"gift_wrapping": GiftWrapping,
"id": 4,
"invoices": [Invoice],
"is_virtual": true,
"items": [OrderItemInterface],
"items_eligible_for_return": [OrderItemInterface],
"negotiable_quote": NegotiableQuote,
"number": "abc123",
"order_date": "xyz789",
"order_status_change_date": "abc123",
"payment_methods": [OrderPaymentMethod],
"printed_card_included": false,
"returns": Returns,
"shipments": [OrderShipment],
"shipping_address": OrderAddress,
"shipping_method": "xyz789",
"status": "abc123",
"token": "xyz789",
"total": OrderTotal
}
CustomerOrderSortInput
CustomerOrderSortInput specifies the field to use for sorting search results and indicates whether the results are sorted in ascending or descending order.
Input Fields
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": 987
}
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!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": 123
}
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": "abc123"
}
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": "abc123",
"firstname": "abc123",
"gender": 123,
"is_subscribed": true,
"lastname": "xyz789",
"middlename": "xyz789",
"prefix": "abc123",
"suffix": "xyz789",
"taxvat": "xyz789"
}
CustomizableAreaOption
Contains information about a text area that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!value - CustomizableAreaValueExample
{
"product_sku": "xyz789",
"required": false,
"sort_order": 123,
"title": "xyz789",
"uid": "4",
"value": CustomizableAreaValue
}
CustomizableAreaValue
Defines the price and sku of a product whose page contains a customized text area.
Fields
max_characters - Intprice - Floatprice_type - PriceTypeEnumsku - Stringuid - ID!Example
{
"max_characters": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "abc123",
"uid": "4"
}
CustomizableCheckboxOption
Contains information about a set of checkbox values that are defined as part of a customizable option.
Fields
required - Booleansort_order - Inttitle - Stringuid - ID!value - [CustomizableCheckboxValue]Example
{
"required": false,
"sort_order": 123,
"title": "abc123",
"uid": "4",
"value": [CustomizableCheckboxValue]
}
CustomizableCheckboxValue
Defines the price and sku of a product whose page contains a customized set of checkbox values.
Fields
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!Example
{
"option_type_id": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 123,
"title": "abc123",
"uid": "4"
}
CustomizableDateOption
Contains information about a date picker that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!value - CustomizableDateValueExample
{
"product_sku": "xyz789",
"required": true,
"sort_order": 987,
"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!Example
{
"price": 123.45,
"price_type": "FIXED",
"sku": "abc123",
"type": "DATE",
"uid": "4"
}
CustomizableDropDownOption
Contains information about a drop down menu that is defined as part of a customizable option.
Fields
required - Booleansort_order - Inttitle - Stringuid - ID!value - [CustomizableDropDownValue]Example
{
"required": true,
"sort_order": 123,
"title": "abc123",
"uid": 4,
"value": [CustomizableDropDownValue]
}
CustomizableDropDownValue
Defines the price and sku of a product whose page contains a customized drop down menu.
Fields
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!Example
{
"option_type_id": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 123,
"title": "abc123",
"uid": "4"
}
CustomizableFieldOption
Contains information about a text field that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!value - CustomizableFieldValueExample
{
"product_sku": "xyz789",
"required": true,
"sort_order": 987,
"title": "xyz789",
"uid": "4",
"value": CustomizableFieldValue
}
CustomizableFieldValue
Defines the price and sku of a product whose page contains a customized text field.
Fields
max_characters - Intprice - Floatprice_type - PriceTypeEnumsku - Stringuid - ID!Example
{
"max_characters": 123,
"price": 123.45,
"price_type": "FIXED",
"sku": "xyz789",
"uid": 4
}
CustomizableFileOption
Contains information about a file picker that is defined as part of a customizable option.
Fields
product_sku - Stringrequired - Booleansort_order - Inttitle - Stringuid - ID!value - CustomizableFileValueExample
{
"product_sku": "abc123",
"required": true,
"sort_order": 987,
"title": "xyz789",
"uid": 4,
"value": CustomizableFileValue
}
CustomizableFileValue
Defines the price and sku of a product whose page contains a customized file picker.
Fields
file_extension - Stringimage_size_x - Intimage_size_y - Intprice - Floatprice_type - PriceTypeEnumsku - Stringuid - ID!Example
{
"file_extension": "xyz789",
"image_size_x": 987,
"image_size_y": 123,
"price": 123.45,
"price_type": "FIXED",
"sku": "xyz789",
"uid": 4
}
CustomizableMultipleOption
Contains information about a multiselect that is defined as part of a customizable option.
Fields
required - Booleansort_order - Inttitle - Stringuid - ID!value - [CustomizableMultipleValue]Example
{
"required": false,
"sort_order": 123,
"title": "xyz789",
"uid": "4",
"value": [CustomizableMultipleValue]
}
CustomizableMultipleValue
Defines the price and sku of a product whose page contains a customized multiselect.
Fields
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!Example
{
"option_type_id": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 987,
"title": "abc123",
"uid": 4
}
CustomizableOptionInput
Defines a customizable option.
Input Fields
uid - IDvalue_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!Possible Types
Example
{
"required": true,
"sort_order": 987,
"title": "xyz789",
"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!value - [CustomizableRadioValue]Example
{
"required": true,
"sort_order": 123,
"title": "xyz789",
"uid": "4",
"value": [CustomizableRadioValue]
}
CustomizableRadioValue
Defines the price and sku of a product whose page contains a customized set of radio buttons.
Fields
option_type_id - Intprice - Floatprice_type - PriceTypeEnumsku - Stringsort_order - Inttitle - Stringuid - ID!Example
{
"option_type_id": 987,
"price": 987.65,
"price_type": "FIXED",
"sku": "abc123",
"sort_order": 123,
"title": "xyz789",
"uid": 4
}
DateTime
A slightly refined version of RFC-3339 compliant DateTime Scalar
Example
"2007-12-03T10:15:30Z"
DeleteCompanyRoleOutput
Contains the response to the request to delete the company role.
Fields
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!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!Example
{"template_id": 4}
DeleteNegotiableQuotesInput
Input Fields
quote_uids - [ID]!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": true
}
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": false, "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": "abc123",
"type": "xyz789",
"value": 123.45
}
DownloadableCartItem
An implementation for downloadable product cart items.
Fields
custom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]is_available - 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!Example
{
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"is_available": true,
"links": [DownloadableProductLinks],
"max_qty": 123.45,
"min_qty": 987.65,
"not_available_message": "abc123",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 987.65,
"samples": [DownloadableProductSamples],
"uid": 4
}
DownloadableCreditMemoItem
Defines downloadable product options for CreditMemoItemInterface.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]downloadable_links - [DownloadableItemsLinks]id - ID!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": "xyz789",
"quantity_refunded": 987.65
}
DownloadableInvoiceItem
Defines downloadable product options for InvoiceItemInterface.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]downloadable_links - [DownloadableItemsLinks]id - ID!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": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_invoiced": 987.65
}
DownloadableItemsLinks
Defines characteristics of the links for downloadable product.
Fields
sort_order - Inttitle - Stringuid - ID!Example
{
"sort_order": 123,
"title": "xyz789",
"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!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": "abc123",
"product_type": "xyz789",
"product_url_key": "xyz789",
"quantity_canceled": 987.65,
"quantity_invoiced": 123.45,
"quantity_ordered": 987.65,
"quantity_refunded": 987.65,
"quantity_return_requested": 987.65,
"quantity_returned": 123.45,
"quantity_shipped": 123.45,
"selected_options": [OrderItemOption],
"status": "xyz789"
}
DownloadableProduct
Defines a product that the shopper downloads.
Fields
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]product_links - [ProductLinksInterface]quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!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": true,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"links_purchased_separately": 987,
"links_title": "abc123",
"manufacturer": 123,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "abc123",
"meta_keyword": "xyz789",
"meta_title": "abc123",
"min_sale_qty": 987.65,
"name": "abc123",
"new_from_date": "abc123",
"new_to_date": "xyz789",
"only_x_left_in_stock": 123.45,
"options": [CustomizableOptionInterface],
"options_container": "abc123",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 987.65,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "xyz789",
"stock_status": "IN_STOCK",
"swatch_image": "abc123",
"thumbnail": ProductImage,
"uid": 4,
"upsell_products": [ProductInterface],
"url_key": "xyz789"
}
DownloadableProductCartItemInput
Defines a single downloadable product.
Input Fields
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!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": "abc123",
"sort_order": 987,
"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": 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!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": "abc123",
"value": "xyz789"
}
EnteredOptionInput
Defines a customer-entered option.
Input Fields
uid - ID!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": "abc123"
}
ExchangeRate
Lists the exchange rate.
Fields
currency_to - Stringrate - FloatExample
{"currency_to": "xyz789", "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": "xyz789",
"three_ds_mode": "OFF",
"title": "xyz789"
}
FastlaneMethodInput
Fastlane Payment inputs
Input Fields
payment_source - Stringpaypal_fastlane_token - StringExample
{
"payment_source": "abc123",
"paypal_fastlane_token": "abc123"
}
Field
Values
UNKNOWN_FIELDCATEGORYPRICEPRODUCTOUT_OF_STOCKLOW_STOCKTYPEVISIBILITYExample
""UNKNOWN_FIELD""
FilterEqualTypeInput
Defines a filter that matches the input exactly.
Input Fields
eq - Stringin - [String]Example
{
"eq": "abc123",
"in": ["xyz789"]
}
FilterMatchTypeEnum
Values
FULLPARTIALExample
""FULL""
FilterMatchTypeInput
Defines a filter that performs a fuzzy search.
Input Fields
match - Stringmatch_type - FilterMatchTypeEnumExample
{"match": "xyz789", "match_type": "FULL"}
FilterRangeTypeInput
Defines a filter that matches a range of values, such as prices or dates.
Input Fields
from - Stringto - StringExample
{
"from": "abc123",
"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": "abc123",
"in": ["xyz789"],
"match": "xyz789"
}
FilterTypeInput
Defines the comparison operators that can be used in a filter.
Input Fields
eq - Stringfrom - Stringgt - Stringgteq - Stringin - [String]like - Stringlt - Stringlteq - Stringmoreq - Stringneq - Stringnin - [String]notnull - Stringnull - Stringto - StringExample
{
"eq": "abc123",
"from": "abc123",
"gt": "xyz789",
"gteq": "xyz789",
"in": ["xyz789"],
"like": "abc123",
"lt": "xyz789",
"lteq": "xyz789",
"moreq": "xyz789",
"neq": "abc123",
"nin": ["xyz789"],
"notnull": "abc123",
"null": "abc123",
"to": "abc123"
}
FilterableInSearchAttribute
Contains product attributes that can be used for filtering in a productSearch query
Fields
attribute - String!frontendInput - Stringlabel - Stringnumeric - BooleanExample
{
"attribute": "abc123",
"frontendInput": "abc123",
"label": "abc123",
"numeric": true
}
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_DETAILSINCLUDE_FPT_WITH_DETAILSEXCLUDE_FPT_AND_INCLUDE_WITH_DETAILSEXCLUDE_FPT_WITHOUT_DETAILSFPT_DISABLEDExample
""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": "xyz789"}
GenerateNegotiableQuoteFromTemplateInput
Specifies the template id, from which to generate quote from.
Input Fields
template_id - ID!Example
{"template_id": 4}
GenerateNegotiableQuoteFromTemplateOutput
Contains the generated negotiable quote id.
Fields
negotiable_quote_uid - ID!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": "xyz789",
"expiration_date": "xyz789"
}
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!value - Floatwebsite_id - Intwebsite_value - FloatExample
{
"attribute_id": 987,
"uid": 4,
"value": 987.65,
"website_id": 123,
"website_value": 987.65
}
GiftCardCartItem
Contains details about a gift card that has been added to a cart.
Fields
amount - Money!available_gift_wrapping - [GiftWrapping]!custom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]gift_message - GiftMessagegift_wrapping - GiftWrappingis_available - 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!Example
{
"amount": Money,
"available_gift_wrapping": [GiftWrapping],
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"is_available": true,
"max_qty": 123.45,
"message": "xyz789",
"min_qty": 987.65,
"not_available_message": "abc123",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 123.45,
"recipient_email": "xyz789",
"recipient_name": "abc123",
"sender_email": "xyz789",
"sender_name": "xyz789",
"uid": "4"
}
GiftCardCreditMemoItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]gift_card - GiftCardItemid - ID!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": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_refunded": 987.65
}
GiftCardInvoiceItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]gift_card - GiftCardItemid - ID!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": "abc123",
"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": "abc123",
"recipient_email": "abc123",
"recipient_name": "xyz789",
"sender_email": "abc123",
"sender_name": "abc123"
}
GiftCardOptions
Contains details about the sender, recipient, and amount of a gift card.
Fields
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": "abc123",
"sender_email": "xyz789",
"sender_name": "xyz789"
}
GiftCardOrderItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_card - GiftCardItemgift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!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": true,
"entered_options": [OrderItemOption],
"gift_card": GiftCardItem,
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": "4",
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "xyz789",
"product_type": "xyz789",
"product_url_key": "xyz789",
"quantity_canceled": 123.45,
"quantity_invoiced": 987.65,
"quantity_ordered": 987.65,
"quantity_refunded": 987.65,
"quantity_return_requested": 123.45,
"quantity_returned": 123.45,
"quantity_shipped": 987.65,
"selected_options": [OrderItemOption],
"status": "abc123"
}
GiftCardProduct
Defines properties of a gift card.
Fields
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]product_links - [ProductLinksInterface]quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!upsell_products - [ProductInterface]url_key - Stringweight - FloatExample
{
"allow_message": false,
"allow_open_amount": true,
"canonical_url": "xyz789",
"categories": [CategoryInterface],
"country_of_manufacture": "xyz789",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_card_options": [CustomizableOptionInterface],
"gift_message_available": false,
"gift_wrapping_available": true,
"gift_wrapping_price": Money,
"giftcard_amounts": [GiftCardAmounts],
"giftcard_type": "VIRTUAL",
"image": ProductImage,
"is_redeemable": false,
"is_returnable": "xyz789",
"lifetime": 123,
"manufacturer": 987,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"message_max_length": 987,
"meta_description": "xyz789",
"meta_keyword": "xyz789",
"meta_title": "abc123",
"min_sale_qty": 123.45,
"name": "abc123",
"new_from_date": "xyz789",
"new_to_date": "xyz789",
"only_x_left_in_stock": 987.65,
"open_amount_max": 987.65,
"open_amount_min": 987.65,
"options": [CustomizableOptionInterface],
"options_container": "xyz789",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "xyz789",
"small_image": ProductImage,
"special_price": 123.45,
"special_to_date": "xyz789",
"stock_status": "IN_STOCK",
"swatch_image": "xyz789",
"thumbnail": ProductImage,
"uid": 4,
"upsell_products": [ProductInterface],
"url_key": "abc123",
"weight": 987.65
}
GiftCardRequisitionListItem
Contains details about gift cards added to a requisition list.
Fields
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": 123.45,
"sku": "abc123",
"uid": 4
}
GiftCardShipmentItem
Fields
gift_card - GiftCardItemid - ID!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": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_shipped": 987.65
}
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!product - ProductInterface!quantity - Float!Example
{
"added_at": "abc123",
"customizable_options": [SelectedCustomizableOption],
"description": "xyz789",
"gift_card_options": GiftCardOptions,
"id": "4",
"product": ProductInterface,
"quantity": 123.45
}
GiftMessage
Contains the text of a gift message, its sender, and recipient
Fields
from - String!message - String!to - String!Example
{
"from": "xyz789",
"message": "xyz789",
"to": "xyz789"
}
GiftMessageInput
Defines a gift message.
Input Fields
from - String!message - String!to - String!Example
{
"from": "xyz789",
"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": "xyz789",
"dynamic_attributes": [GiftRegistryDynamicAttribute],
"event_name": "abc123",
"items": [GiftRegistryItemInterface],
"message": "xyz789",
"owner_name": "abc123",
"privacy_settings": "PRIVATE",
"registrants": [GiftRegistryRegistrant],
"shipping_address": CustomerAddress,
"status": "ACTIVE",
"type": GiftRegistryType,
"uid": 4
}
GiftRegistryDynamicAttribute
Fields
code - ID!label - String!value - String!Example
{
"code": 4,
"group": "EVENT_INFORMATION",
"label": "abc123",
"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": "abc123"
}
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": "xyz789",
"code": "4",
"input_type": "abc123",
"is_required": true,
"label": "abc123",
"sort_order": 123
}
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": "abc123",
"sort_order": 987
}
GiftRegistryItem
Fields
created_at - String!note - Stringproduct - ProductInterface!quantity - Float!quantity_fulfilled - Float!uid - ID!Example
{
"created_at": "abc123",
"note": "abc123",
"product": ProductInterface,
"quantity": 123.45,
"quantity_fulfilled": 987.65,
"uid": "4"
}
GiftRegistryItemInterface
Fields
created_at - String!note - Stringproduct - ProductInterface!quantity - Float!quantity_fulfilled - Float!uid - ID!Possible Types
Example
{
"created_at": "abc123",
"note": "xyz789",
"product": ProductInterface,
"quantity": 987.65,
"quantity_fulfilled": 987.65,
"uid": "4"
}
GiftRegistryItemUserErrorInterface
Contains the status and any errors that encountered with the customer's gift register item.
Fields
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 - IDmessage - 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": "xyz789",
"event_title": "abc123",
"gift_registry_uid": 4,
"location": "abc123",
"name": "abc123",
"type": "xyz789"
}
GiftRegistryShippingAddressInput
Defines a shipping address for a gift registry. Specify either address_data or the address_id. If both are provided, validation will fail.
Input Fields
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!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": "abc123",
"url": "xyz789"
}
GooglePayButtonStyles
Fields
color - Stringheight - Inttype - StringExample
{
"color": "abc123",
"height": 987,
"type": "xyz789"
}
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": "abc123",
"is_visible": false,
"payment_intent": "xyz789",
"payment_source": "xyz789",
"sdk_params": [SDKParams],
"sort_order": "abc123",
"three_ds_mode": "OFF",
"title": "abc123"
}
GooglePayMethodInput
Google Pay inputs
Input Fields
payment_source - Stringpayments_order_id - Stringpaypal_order_id - StringExample
{
"payment_source": "abc123",
"payments_order_id": "xyz789",
"paypal_order_id": "abc123"
}
GroupedProduct
Defines a grouped product, which consists of simple standalone products that are presented as a group.
Fields
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]product_links - [ProductLinksInterface]quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!upsell_products - [ProductInterface]url_key - Stringweight - FloatExample
{
"canonical_url": "abc123",
"categories": [CategoryInterface],
"country_of_manufacture": "xyz789",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": true,
"gift_wrapping_available": true,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"items": [GroupedProductItem],
"manufacturer": 123,
"max_sale_qty": 987.65,
"media_gallery": [MediaGalleryInterface],
"meta_description": "abc123",
"meta_keyword": "abc123",
"meta_title": "abc123",
"min_sale_qty": 987.65,
"name": "xyz789",
"new_from_date": "xyz789",
"new_to_date": "xyz789",
"only_x_left_in_stock": 123.45,
"options_container": "xyz789",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "xyz789",
"stock_status": "IN_STOCK",
"swatch_image": "xyz789",
"thumbnail": ProductImage,
"uid": "4",
"upsell_products": [ProductInterface],
"url_key": "xyz789",
"weight": 987.65
}
GroupedProductItem
Contains information about an individual grouped product item.
Fields
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!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": "abc123"
}
GuestOrderInformationInput
Input to retrieve an order based on details.
Input Fields
email - String!lastname - String!number - String!Example
{
"email": "xyz789",
"lastname": "xyz789",
"number": "abc123"
}
Highlight
An object that provides highlighted text for matched words
Fields
attribute - String!matched_words - [String]!value - String!Example
{
"attribute": "abc123",
"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": "abc123",
"creator_type": "xyz789",
"item_id": 987,
"note": "abc123",
"product_name": "xyz789"
}
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": true,
"payment_intent": "abc123",
"payment_source": "abc123",
"requires_card_details": true,
"sdk_params": [SDKParams],
"sort_order": "xyz789",
"three_ds_mode": "OFF",
"title": "abc123"
}
HostedFieldsInput
Hosted Fields payment inputs
Input Fields
cardBin - StringcardExpiryMonth - StringcardExpiryYear - StringcardLast4 - StringholderName - Stringis_active_payment_token_enabler - Booleanpayment_source - Stringpayments_order_id - Stringpaypal_order_id - StringExample
{
"cardBin": "abc123",
"cardExpiryMonth": "abc123",
"cardExpiryYear": "xyz789",
"cardLast4": "xyz789",
"holderName": "xyz789",
"is_active_payment_token_enabler": true,
"payment_source": "abc123",
"payments_order_id": "xyz789",
"paypal_order_id": "xyz789"
}
ID
The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.
Example
"4"
ImageSwatchData
Fields
thumbnail - Stringvalue - StringExample
{
"thumbnail": "abc123",
"value": "xyz789"
}
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": "abc123",
"quantity": 987.65
}
Int
The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
987
InternalError
Contains an error message when an internal error occurred.
Fields
message - String!Example
{"message": "abc123"}
Invoice
Contains invoice details.
Fields
comments - [SalesCommentItem]custom_attributes - [CustomAttribute]id - ID!items - [InvoiceItemInterface]number - String!total - InvoiceTotalExample
{
"comments": [SalesCommentItem],
"custom_attributes": [CustomAttribute],
"id": 4,
"items": [InvoiceItemInterface],
"number": "xyz789",
"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!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": 123.45
}
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!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": "abc123",
"product_sale_price": Money,
"product_sku": "xyz789",
"quantity_invoiced": 123.45
}
InvoiceOutput
Contains details about the invoice after adding custom attributes to it.
Fields
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": true}
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": true}
IsCompanyUserEmailAvailableOutput
Contains the response of a company user email validation query.
Fields
is_email_available - Boolean!Example
{"is_email_available": true}
IsEmailAvailableOutput
Contains the result of the isEmailAvailable query.
Fields
is_email_available - BooleanExample
{"is_email_available": false}
IsOperatorInput
Input Fields
Example
{"type": "UNKNOWN_ISOPERATOR_TYPE", "value": true}
IsOperatorType
Values
UNKNOWN_ISOPERATOR_TYPEISExample
""UNKNOWN_ISOPERATOR_TYPE""
IsProductAlertSubscriptionResult
Fields
Example
{"isSubscribed": false, "message": "abc123"}
ItemNote
The note object for quote line item.
Fields
created_at - Stringcreator_id - Intcreator_name - Stringcreator_type - Intnegotiable_quote_item_uid - IDnote - Stringnote_uid - IDExample
{
"created_at": "xyz789",
"creator_id": 987,
"creator_name": "abc123",
"creator_type": 123,
"negotiable_quote_item_uid": 4,
"note": "abc123",
"note_uid": 4
}
ItemSelectedBundleOption
A list of options of the selected bundle product.
Fields
label - String!uid - ID!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!Example
{
"price": Money,
"product_name": "abc123",
"product_sku": "abc123",
"quantity": 123.45,
"uid": "4"
}
JSON
A JSON scalar
Example
{}
KeyValue
Contains a key-value pair.
Fields
name - Stringvalue - StringExample
{
"name": "abc123",
"value": "abc123"
}
LineItemNoteInput
Sets quote item note.
Input Fields
note - Stringquote_item_uid - ID!quote_uid - ID!Example
{
"note": "xyz789",
"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": false,
"label": "xyz789",
"position": 123,
"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": "xyz789"}
MessageStyles
Fields
Example
{
"layout": "abc123",
"logo": MessageStyleLogo
}
Money
Defines a monetary value, including a numeric value and a currency code.
Fields
currency - CurrencyEnumvalue - FloatExample
{"currency": "AFN", "value": 987.65}
MoveCartItemsToGiftRegistryOutput
Contains the customer's gift registry and any errors encountered.
Fields
gift_registry - GiftRegistrystatus - Boolean!user_errors - [GiftRegistryItemsUserError]!Example
{
"gift_registry": GiftRegistry,
"status": false,
"user_errors": [GiftRegistryItemsUserError]
}
MoveItemsBetweenRequisitionListsInput
An input object that defines the items in a requisition list to be moved.
Input Fields
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!quote_uid - ID!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 - IDtemplate_name - Stringtotal_quantity - Float!uid - ID!updated_at - StringExample
{
"available_payment_methods": [AvailablePaymentMethod],
"billing_address": NegotiableQuoteBillingAddress,
"buyer": NegotiableQuoteUser,
"comments": [NegotiableQuoteComment],
"created_at": "xyz789",
"custom_attributes": [CustomAttribute],
"email": "abc123",
"expiration_date": "xyz789",
"history": [NegotiableQuoteHistoryEntry],
"is_virtual": true,
"items": [CartItemInterface],
"name": "abc123",
"order": CustomerOrder,
"prices": CartPrices,
"sales_rep_name": "xyz789",
"selected_payment_method": SelectedPaymentMethod,
"shipping_addresses": [NegotiableQuoteShippingAddress],
"status": "SUBMITTED",
"template_id": "4",
"template_name": "abc123",
"total_quantity": 987.65,
"uid": "4",
"updated_at": "abc123"
}
NegotiableQuoteAddressCountry
Defines the company's country.
Fields
code - String!label - String!Example
{
"code": "xyz789",
"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": "xyz789",
"company": "xyz789",
"country_code": "xyz789",
"custom_attributes": [AttributeValueInput],
"fax": "xyz789",
"firstname": "abc123",
"lastname": "xyz789",
"middlename": "abc123",
"postcode": "abc123",
"prefix": "abc123",
"region": "xyz789",
"region_id": 123,
"save_in_address_book": true,
"street": ["abc123"],
"suffix": "abc123",
"telephone": "xyz789",
"vat_id": "abc123"
}
NegotiableQuoteAddressInterface
Fields
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": "abc123",
"country": NegotiableQuoteAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": "4",
"fax": "xyz789",
"firstname": "abc123",
"lastname": "abc123",
"middlename": "xyz789",
"postcode": "xyz789",
"prefix": "abc123",
"region": NegotiableQuoteAddressRegion,
"street": ["abc123"],
"suffix": "xyz789",
"telephone": "abc123",
"uid": "4",
"vat_id": "abc123"
}
NegotiableQuoteAddressRegion
Defines the company's state or province.
Fields
code - Stringlabel - Stringregion_id - IntExample
{
"code": "abc123",
"label": "xyz789",
"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": "abc123",
"country": NegotiableQuoteAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": 4,
"fax": "abc123",
"firstname": "abc123",
"lastname": "xyz789",
"middlename": "xyz789",
"postcode": "abc123",
"prefix": "abc123",
"region": NegotiableQuoteAddressRegion,
"street": ["xyz789"],
"suffix": "xyz789",
"telephone": "xyz789",
"uid": "4",
"vat_id": "abc123"
}
NegotiableQuoteBillingAddressInput
Defines the billing address.
Input Fields
address - NegotiableQuoteAddressInputcustomer_address_uid - IDsame_as_shipping - Booleanuse_for_shipping - BooleanExample
{
"address": NegotiableQuoteAddressInput,
"customer_address_uid": "4",
"same_as_shipping": true,
"use_for_shipping": false
}
NegotiableQuoteComment
Contains a single plain text comment from either the buyer or seller.
Fields
attachments - [NegotiableQuoteCommentAttachment]!author - NegotiableQuoteUser!created_at - String!creator_type - NegotiableQuoteCommentCreatorType!text - String!uid - ID!Example
{
"attachments": [NegotiableQuoteCommentAttachment],
"author": NegotiableQuoteUser,
"created_at": "xyz789",
"creator_type": "BUYER",
"text": "xyz789",
"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": "xyz789"}
NegotiableQuoteCommentCreatorType
Values
BUYERSELLERExample
""BUYER""
NegotiableQuoteCommentInput
Contains the commend provided by the buyer.
Input Fields
attachments - [NegotiableQuoteCommentAttachmentInput]comment - String!Example
{
"attachments": [NegotiableQuoteCommentAttachmentInput],
"comment": "xyz789"
}
NegotiableQuoteCustomLogChange
Contains custom log entries added by third-party extensions.
Fields
new_value - String!old_value - Stringtitle - String!Example
{
"new_value": "xyz789",
"old_value": "xyz789",
"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!Example
{
"author": NegotiableQuoteUser,
"change_type": "CREATED",
"changes": NegotiableQuoteHistoryChanges,
"created_at": "abc123",
"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": "xyz789"}
NegotiableQuoteItemQuantityInput
Specifies the updated quantity of an item.
Input Fields
quantity - Float!quote_item_uid - ID!Example
{"quantity": 987.65, "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": "xyz789",
"purchase_order_number": "abc123"
}
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": "abc123",
"link_id": 4,
"reference_document_url": "abc123"
}
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": "abc123",
"country": NegotiableQuoteAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": "4",
"fax": "xyz789",
"firstname": "abc123",
"lastname": "abc123",
"middlename": "abc123",
"postcode": "abc123",
"prefix": "xyz789",
"region": NegotiableQuoteAddressRegion,
"selected_shipping_method": SelectedShippingMethod,
"street": ["abc123"],
"suffix": "abc123",
"telephone": "xyz789",
"uid": "4",
"vat_id": "abc123"
}
NegotiableQuoteShippingAddressInput
Defines shipping addresses for the negotiable quote.
Input Fields
address - NegotiableQuoteAddressInputcustomer_address_uid - IDcustomer_notes - StringExample
{
"address": NegotiableQuoteAddressInput,
"customer_address_uid": "4",
"customer_notes": "abc123"
}
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!total_quantity - Float!uid - ID!updated_at - String!Example
{
"buyer": NegotiableQuoteUser,
"comments": [NegotiableQuoteComment],
"created_at": "xyz789",
"expiration_date": "abc123",
"history": [NegotiableQuoteHistoryEntry],
"historyV2": [NegotiableQuoteTemplateHistoryEntry],
"is_min_max_qty_used": false,
"is_virtual": true,
"items": [CartItemInterface],
"max_order_commitment": 123,
"min_order_commitment": 987,
"name": "xyz789",
"notifications": [QuoteTemplateNotificationMessage],
"prices": CartPrices,
"reference_document_links": [
NegotiableQuoteReferenceDocumentLink
],
"sales_rep_name": "xyz789",
"shipping_addresses": [NegotiableQuoteShippingAddress],
"status": "xyz789",
"template_id": 4,
"total_quantity": 123.45,
"uid": "4",
"updated_at": "abc123"
}
NegotiableQuoteTemplateFilterInput
Defines a filter to limit the negotiable quotes to return.
Input Fields
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!uid - ID!updated_at - String!Example
{
"activated_at": "xyz789",
"company_name": "abc123",
"created_at": "abc123",
"expiration_date": "abc123",
"is_min_max_qty_used": true,
"last_ordered_at": "xyz789",
"last_shared_at": "abc123",
"max_order_commitment": 987,
"min_negotiated_grand_total": 987.65,
"min_order_commitment": 123,
"name": "xyz789",
"orders_placed": 123,
"prices": CartPrices,
"sales_rep_name": "xyz789",
"state": "abc123",
"status": "abc123",
"submitted_by": "abc123",
"template_id": 4,
"uid": 4,
"updated_at": "abc123"
}
NegotiableQuoteTemplateHistoryChanges
Contains a list of changes to a negotiable quote template.
Fields
comment_added - NegotiableQuoteHistoryCommentChangecustom_changes - NegotiableQuoteCustomLogChangeexpiration - NegotiableQuoteHistoryExpirationChangeproducts_removed - NegotiableQuoteHistoryProductsRemovedChangestatuses - NegotiableQuoteTemplateHistoryStatusesChangeExample
{
"comment_added": NegotiableQuoteHistoryCommentChange,
"custom_changes": NegotiableQuoteCustomLogChange,
"expiration": NegotiableQuoteHistoryExpirationChange,
"products_removed": NegotiableQuoteHistoryProductsRemovedChange,
"statuses": NegotiableQuoteTemplateHistoryStatusesChange,
"total": NegotiableQuoteHistoryTotalChange
}