Types
AcceptNegotiableQuoteTemplateInput
Specifies the quote template id to accept quote template.
Input Fields
template_id - ID!Example
{"template_id": "4"}
AddCustomAttributesToCartItemOutput
Contains details about the cart after adding custom attributes to it items.
Fields
cart - Cart!Example
{"cart": Cart}
AddDownloadableProductsToCartInput
Input Fields
cart_id - String!cart_items - [DownloadableProductCartItemInput]!Example
{
"cart_id": "xyz789",
"cart_items": [DownloadableProductCartItemInput]
}
AddDownloadableProductsToCartOutput
Contains details about the cart after adding downloadable products.
Fields
cart - Cart!Example
{"cart": Cart}
AddGiftRegistryRegistrantInput
Defines a new registrant.
Input Fields
dynamic_attributes - [GiftRegistryDynamicAttributeInput]email - String!firstname - String!lastname - String!Example
{
"dynamic_attributes": [
GiftRegistryDynamicAttributeInput
],
"email": "xyz789",
"firstname": "abc123",
"lastname": "abc123"
}
AddGiftRegistryRegistrantsOutput
Contains the results of a request to add registrants.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
AddProductsToCartOutput
Contains details about the cart after adding products to it.
Fields
cart - Cart!user_errors - [Error]!Example
{
"cart": Cart,
"user_errors": [Error]
}
AddProductsToCompareListInput
Contains products to add to an existing compare list.
Input Fields
products - [ID]!uid - ID!Example
{"products": [4], "uid": 4}
AddProductsToNewCartOutput
Contains details about the cart after adding products to it.
Fields
cart - Cartuser_errors - [CartUserInputError]Example
{
"cart": Cart,
"user_errors": [CartUserInputError]
}
AddProductsToRequisitionListOutput
Output of the request to add products to a requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
AddProductsToWishlistOutput
Contains the customer's wish list and any errors encountered.
Fields
user_errors - [WishListUserInputError]!wishlist - Wishlist!Example
{
"user_errors": [WishListUserInputError],
"wishlist": Wishlist
}
AddPurchaseOrderCommentInput
Contains the comment to be added to a purchase order.
Input Fields
comment - String!purchase_order_uid - ID!Example
{
"comment": "xyz789",
"purchase_order_uid": "4"
}
AddPurchaseOrderCommentOutput
Contains the successfully added comment.
Fields
comment - PurchaseOrderComment!Example
{"comment": PurchaseOrderComment}
AddPurchaseOrderItemsToCartInput
Defines the purchase order and cart to act on.
Input Fields
cart_id - String!purchase_order_uid - ID!replace_existing_cart_items - Boolean!Example
{
"cart_id": "xyz789",
"purchase_order_uid": 4,
"replace_existing_cart_items": false
}
AddRequisitionListItemToCartUserError
Contains details about why an attempt to add items to the requistion list failed.
Fields
message - String!Example
{
"message": "xyz789",
"type": "OUT_OF_STOCK"
}
AddRequisitionListItemToCartUserErrorType
Values
OUT_OF_STOCKUNAVAILABLE_SKUOPTIONS_UPDATEDLOW_QUANTITYExample
""OUT_OF_STOCK""
AddRequisitionListItemsToCartOutput
Output of the request to add items in a requisition list to the cart.
Fields
add_requisition_list_items_to_cart_user_errors - [AddRequisitionListItemToCartUserError]!cart - Cartstatus - Boolean!Example
{
"add_requisition_list_items_to_cart_user_errors": [
AddRequisitionListItemToCartUserError
],
"cart": Cart,
"status": false
}
AddReturnCommentInput
Defines a return comment.
Input Fields
comment_text - String!return_uid - ID!Example
{
"comment_text": "abc123",
"return_uid": "4"
}
AddReturnCommentOutput
Contains details about the return request.
Fields
return - ReturnExample
{"return": Return}
AddReturnTrackingInput
Defines tracking information to be added to the return.
Input Fields
carrier_uid - ID!return_uid - ID!tracking_number - String!Example
{
"carrier_uid": "4",
"return_uid": "4",
"tracking_number": "abc123"
}
AddReturnTrackingOutput
Contains the response after adding tracking information.
Fields
return - Returnreturn_shipping_tracking - ReturnShippingTrackingExample
{
"return": Return,
"return_shipping_tracking": ReturnShippingTracking
}
AddWishlistItemsToCartOutput
Contains the resultant wish list and any error information.
Fields
add_wishlist_items_to_cart_user_errors - [WishlistCartUserInputError]!status - Boolean!wishlist - Wishlist!Example
{
"add_wishlist_items_to_cart_user_errors": [
WishlistCartUserInputError
],
"status": false,
"wishlist": Wishlist
}
Aggregation
A bucket that contains information for each filterable option
Fields
attribute - String!buckets - [Bucket]!title - String!type - AggregationTypeExample
{
"attribute": "xyz789",
"buckets": [Bucket],
"title": "xyz789",
"type": "INTELLIGENT"
}
AggregationType
Identifies the data type of the aggregation
Values
INTELLIGENTPINNEDPOPULARExample
""INTELLIGENT""
ApplePayConfig
Fields
button_styles - ButtonStylescode - Stringis_visible - Booleanpayment_intent - Stringpayment_source - Stringsdk_params - [SDKParams]sort_order - Stringtitle - StringExample
{
"button_styles": ButtonStyles,
"code": "xyz789",
"is_visible": true,
"payment_intent": "abc123",
"payment_source": "abc123",
"sdk_params": [SDKParams],
"sort_order": "abc123",
"title": "abc123"
}
ApplePayMethodInput
Apple Pay inputs
Input Fields
payment_source - Stringpayments_order_id - Stringpaypal_order_id - StringExample
{
"payment_source": "xyz789",
"payments_order_id": "abc123",
"paypal_order_id": "xyz789"
}
AppliedCoupon
Contains the applied coupon code.
Fields
code - String!Example
{"code": "xyz789"}
AppliedGiftCard
Contains an applied gift card with applied and remaining balance.
Fields
applied_balance - Moneycode - Stringcurrent_balance - Moneyexpiration_date - StringExample
{
"applied_balance": Money,
"code": "abc123",
"current_balance": Money,
"expiration_date": "abc123"
}
AppliedQueryRule
The rule that was applied to this product
Fields
action_type - AppliedQueryRuleActionTyperule_id - Stringrule_name - StringExample
{
"action_type": "BOOST",
"rule_id": "xyz789",
"rule_name": "xyz789"
}
AppliedQueryRuleActionType
The type of rule that was applied to a product during search (optional)
Values
BOOSTBURYPINExample
""BOOST""
AppliedStoreCredit
Contains the applied and current balances.
Fields
applied_balance - Moneycurrent_balance - Moneyenabled - BooleanExample
{
"applied_balance": Money,
"current_balance": Money,
"enabled": true
}
ApplyCouponToCartInput
Specifies the coupon code to apply to the cart.
Input Fields
cart_id - String!coupon_code - String!Example
{
"cart_id": "abc123",
"coupon_code": "xyz789"
}
ApplyCouponToCartOutput
Contains details about the cart after applying a coupon.
Fields
cart - Cart!Example
{"cart": Cart}
ApplyCouponsStrategy
The strategy to apply coupons to the cart.
Values
APPENDREPLACEExample
""APPEND""
ApplyCouponsToCartInput
Apply coupons to the cart.
Input Fields
cart_id - String!coupon_codes - [String]!type - ApplyCouponsStrategyExample
{
"cart_id": "xyz789",
"coupon_codes": ["abc123"],
"type": "APPEND"
}
ApplyGiftCardToCartInput
Defines the input required to run the applyGiftCardToCart mutation.
Input Fields
cart_id - String!gift_card_code - String!Example
{
"cart_id": "abc123",
"gift_card_code": "abc123"
}
ApplyGiftCardToCartOutput
Defines the possible output for the applyGiftCardToCart mutation.
Fields
cart - Cart!Example
{"cart": Cart}
ApplyGiftCardToOrder
Contains applied gift cards with gift card code and amount.
Fields
applied_balance - Money!code - String!Example
{
"applied_balance": Money,
"code": "abc123"
}
ApplyRewardPointsToCartOutput
Contains the customer cart.
Fields
cart - Cart!Example
{"cart": Cart}
ApplyStoreCreditToCartInput
Defines the input required to run the applyStoreCreditToCart mutation.
Input Fields
cart_id - String!Example
{"cart_id": "xyz789"}
ApplyStoreCreditToCartOutput
Defines the possible output for the applyStoreCreditToCart mutation.
Fields
cart - Cart!Example
{"cart": Cart}
AreaInput
AreaInput defines the parameters which will be used for filter by specified location.
Input Fields
radius - Int!search_term - String!Example
{"radius": 987, "search_term": "xyz789"}
AssetImage
Contains information about an asset image.
Fields
asset_image - ProductMediaGalleryEntriesAssetImagedisabled - Booleanlabel - Stringposition - Inturl - StringExample
{
"asset_image": ProductMediaGalleryEntriesAssetImage,
"disabled": true,
"label": "xyz789",
"position": 123,
"url": "xyz789"
}
AssetVideo
Contains information about an asset video.
Fields
asset_video - ProductMediaGalleryEntriesAssetVideodisabled - Booleanlabel - Stringposition - Inturl - StringExample
{
"asset_video": ProductMediaGalleryEntriesAssetVideo,
"disabled": false,
"label": "abc123",
"position": 123,
"url": "abc123"
}
AssignCompareListToCustomerOutput
Contains the results of the request to assign a compare list.
Fields
compare_list - CompareListresult - Boolean!Example
{"compare_list": CompareList, "result": true}
AttributeEntityTypeEnum
List of all entity types. Populated by the modules introducing EAV entities.
Values
CATALOG_PRODUCTCATALOG_CATEGORYCUSTOMERCUSTOMER_ADDRESSRMA_ITEMExample
""CATALOG_PRODUCT""
AttributeFile
Fields
attribute_type - Stringcode - ID!url - String!value - String!Example
{
"attribute_type": "abc123",
"code": "4",
"url": "abc123",
"value": "abc123"
}
AttributeFilterInput
An input object that specifies the filters used for attributes.
Input Fields
is_comparable - Booleanis_filterable - Booleanis_filterable_in_search - Booleanis_html_allowed_on_front - Booleanis_searchable - Booleanis_used_for_customer_segment - Booleanis_used_for_price_rules - Booleanis_used_for_promo_rules - Booleanis_visible_in_advanced_search - Booleanis_visible_on_front - Booleanis_wysiwyg_enabled - Booleanused_in_product_listing - BooleanExample
{
"is_comparable": true,
"is_filterable": false,
"is_filterable_in_search": false,
"is_html_allowed_on_front": false,
"is_searchable": false,
"is_used_for_customer_segment": true,
"is_used_for_price_rules": true,
"is_used_for_promo_rules": false,
"is_visible_in_advanced_search": true,
"is_visible_on_front": false,
"is_wysiwyg_enabled": true,
"used_in_product_listing": false
}
AttributeFrontendInputEnum
EAV attribute frontend input types.
Values
BOOLEANDATEDATETIMEFILEGALLERYHIDDENIMAGEMEDIA_IMAGEMULTILINEMULTISELECTPRICESELECTTEXTTEXTAREAWEIGHTUNDEFINEDExample
""BOOLEAN""
AttributeImage
Fields
attribute_type - Stringcode - ID!url - String!value - String!Example
{
"attribute_type": "xyz789",
"code": 4,
"url": "xyz789",
"value": "xyz789"
}
AttributeInput
Defines the attribute characteristics to search for the attribute_code and entity_type to search.
Input Fields
attribute_code - Stringentity_type - StringExample
{
"attribute_code": "abc123",
"entity_type": "abc123"
}
AttributeInputSelectedOption
Specifies selected option for a select or multiselect attribute value.
Input Fields
value - String!Example
{"value": "xyz789"}
AttributeMetadata
Base EAV implementation of CustomAttributeMetadataInterface.
Fields
code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnumis_required - Boolean!is_unique - Boolean!label - Stringoptions - [CustomAttributeOptionInterface]!Example
{
"code": 4,
"default_value": "abc123",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "abc123",
"frontend_input": "BOOLEAN",
"is_required": true,
"is_unique": true,
"label": "xyz789",
"options": [CustomAttributeOptionInterface]
}
AttributeMetadataError
Attribute metadata retrieval error.
Fields
message - String!type - AttributeMetadataErrorType!Example
{
"message": "xyz789",
"type": "ENTITY_NOT_FOUND"
}
AttributeMetadataErrorType
Attribute metadata retrieval error types.
Values
ENTITY_NOT_FOUNDATTRIBUTE_NOT_FOUNDFILTER_NOT_FOUNDUNDEFINEDExample
""ENTITY_NOT_FOUND""
AttributeMetadataResponse
Contains the output of the attributeMetadata query
Fields
filterableInSearch - [FilterableInSearchAttribute!]sortable - [SortableAttribute!]Example
{
"filterableInSearch": [FilterableInSearchAttribute],
"sortable": [SortableAttribute]
}
AttributeOptionMetadata
Base EAV implementation of CustomAttributeOptionInterface.
Fields
is_default - Boolean!label - String!value - String!Example
{
"is_default": true,
"label": "abc123",
"value": "abc123"
}
AttributeSelectedOption
Fields
label - String!value - String!Example
{
"label": "abc123",
"value": "abc123"
}
AttributeSelectedOptionInterface
Fields
label - String!value - String!Possible Types
Example
{
"label": "xyz789",
"value": "abc123"
}
AttributeSelectedOptions
Fields
attribute_type - Stringcode - ID!selected_options - [AttributeSelectedOptionInterface]!Example
{
"attribute_type": "xyz789",
"code": 4,
"selected_options": [AttributeSelectedOptionInterface]
}
AttributeValue
Fields
attribute_type - Stringcode - ID!value - String!Example
{
"attribute_type": "abc123",
"code": "4",
"value": "abc123"
}
AttributeValueInput
Specifies the value for attribute.
Input Fields
attribute_code - String!selected_options - [AttributeInputSelectedOption]value - StringExample
{
"attribute_code": "xyz789",
"selected_options": [AttributeInputSelectedOption],
"value": "xyz789"
}
AttributeValueInterface
Fields
Possible Types
Example
{"attribute_type": "abc123", "code": 4}
AttributesFormOutput
Metadata of EAV attributes associated to form
Fields
errors - [AttributeMetadataError]!Example
{
"errors": [AttributeMetadataError],
"items": [CustomAttributeMetadataInterface]
}
AttributesMetadataOutput
Metadata of EAV attributes.
Fields
errors - [AttributeMetadataError]!Example
{
"errors": [AttributeMetadataError],
"items": [CustomAttributeMetadataInterface]
}
AvailableCurrency
Defines the code and symbol of a currency that can be used for purchase orders.
Fields
code - CurrencyEnum!symbol - String!Example
{"code": "AFN", "symbol": "abc123"}
AvailablePaymentMethod
Describes a payment method that the shopper can use to pay for the order.
Fields
code - String!is_deferred - Boolean!oope_payment_method_config - OopePaymentMethodConfigtitle - String!Example
{
"code": "xyz789",
"is_deferred": true,
"oope_payment_method_config": OopePaymentMethodConfig,
"title": "xyz789"
}
AvailableShippingMethod
Contains details about the possible shipping methods and carriers.
Fields
additional_data - [ShippingAdditionalData]amount - Money!available - Boolean!carrier_code - String!carrier_title - String!error_message - Stringmethod_code - Stringmethod_title - Stringprice_excl_tax - Money!price_incl_tax - Money!Example
{
"additional_data": [ShippingAdditionalData],
"amount": Money,
"available": true,
"carrier_code": "abc123",
"carrier_title": "xyz789",
"error_message": "abc123",
"method_code": "abc123",
"method_title": "abc123",
"price_excl_tax": Money,
"price_incl_tax": Money
}
BatchMutationStatus
Values
SUCCESSFAILUREMIXED_RESULTSExample
""SUCCESS""
BillingAddressInput
Defines the billing address.
Input Fields
address - CartAddressInputcustomer_address_id - Intcustomer_address_uid - IDsame_as_shipping - Booleanuse_for_shipping - BooleanExample
{
"address": CartAddressInput,
"customer_address_id": 987,
"customer_address_uid": "4",
"same_as_shipping": true,
"use_for_shipping": false
}
BillingAddressPaymentSourceInput
The billing address information
Input Fields
address_line_1 - Stringaddress_line_2 - Stringcity - Stringcountry_code - String!postal_code - Stringregion - StringExample
{
"address_line_1": "abc123",
"address_line_2": "abc123",
"city": "abc123",
"country_code": "abc123",
"postal_code": "abc123",
"region": "abc123"
}
BillingCartAddress
Contains details about the billing address.
Fields
city - String!company - Stringcountry - CartAddressCountry!custom_attributes - [AttributeValueInterface]!customer_address_uid - IDfax - Stringfirstname - String!id - Intlastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - CartAddressRegionstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringExample
{
"city": "xyz789",
"company": "abc123",
"country": CartAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": "4",
"fax": "abc123",
"firstname": "xyz789",
"id": 987,
"lastname": "xyz789",
"middlename": "abc123",
"postcode": "abc123",
"prefix": "xyz789",
"region": CartAddressRegion,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "abc123",
"uid": "4",
"vat_id": "abc123"
}
Boolean
The Boolean scalar type represents true or false.
Example
true
Breadcrumb
Contains details about an individual category that comprises a breadcrumb.
Fields
category_level - Intcategory_name - Stringcategory_uid - ID!category_url_key - Stringcategory_url_path - StringExample
{
"category_level": 123,
"category_name": "abc123",
"category_uid": "4",
"category_url_key": "abc123",
"category_url_path": "abc123"
}
Bucket
An interface for bucket contents
Fields
title - String!Possible Types
Example
{"title": "abc123"}
BundleCartItem
An implementation for bundle product cart items.
Fields
available_gift_wrapping - [GiftWrapping]!bundle_options - [SelectedBundleOption]!custom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]gift_message - GiftMessagegift_wrapping - GiftWrappingis_available - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!Example
{
"available_gift_wrapping": [GiftWrapping],
"bundle_options": [SelectedBundleOption],
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"is_available": false,
"max_qty": 123.45,
"min_qty": 123.45,
"not_available_message": "xyz789",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 123.45,
"uid": 4
}
BundleCreditMemoItem
Defines bundle product options for CreditMemoItemInterface.
Fields
bundle_options - [ItemSelectedBundleOption]custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatExample
{
"bundle_options": [ItemSelectedBundleOption],
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": "4",
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_refunded": 123.45
}
BundleInvoiceItem
Defines bundle product options for InvoiceItemInterface.
Fields
bundle_options - [ItemSelectedBundleOption]custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_invoiced - FloatExample
{
"bundle_options": [ItemSelectedBundleOption],
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_invoiced": 987.65
}
BundleItem
Defines an individual item within a bundle product.
Fields
options - [BundleItemOption]position - Intprice_range - PriceRange!required - Booleansku - Stringtitle - Stringtype - Stringuid - IDExample
{
"options": [BundleItemOption],
"position": 987,
"price_range": PriceRange,
"required": true,
"sku": "abc123",
"title": "xyz789",
"type": "xyz789",
"uid": 4
}
BundleItemOption
Defines the characteristics that comprise a specific bundle item and its options.
Fields
can_change_quantity - Booleanis_default - Booleanlabel - Stringposition - Intprice - Floatprice_type - PriceTypeEnumproduct - ProductInterfacequantity - Floatuid - ID!Example
{
"can_change_quantity": true,
"is_default": true,
"label": "abc123",
"position": 987,
"price": 987.65,
"price_type": "FIXED",
"product": ProductInterface,
"quantity": 123.45,
"uid": "4"
}
BundleOrderItem
Defines bundle product options for OrderItemInterface.
Fields
bundle_options - [ItemSelectedBundleOption]custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!parent_sku - Stringprices - OrderItemPricesproduct - ProductInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!product_type - Stringproduct_url_key - Stringquantity_canceled - Floatquantity_invoiced - Floatquantity_ordered - Floatquantity_refunded - Floatquantity_return_requested - Floatquantity_returned - Floatquantity_shipped - Floatselected_options - [OrderItemOption]status - StringExample
{
"bundle_options": [ItemSelectedBundleOption],
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"eligible_for_return": true,
"entered_options": [OrderItemOption],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": 4,
"parent_sku": "abc123",
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"product_type": "xyz789",
"product_url_key": "abc123",
"quantity_canceled": 123.45,
"quantity_invoiced": 987.65,
"quantity_ordered": 123.45,
"quantity_refunded": 987.65,
"quantity_return_requested": 987.65,
"quantity_returned": 987.65,
"quantity_shipped": 123.45,
"selected_options": [OrderItemOption],
"status": "xyz789"
}
BundleProduct
Defines basic features of a bundle product and contains multiple BundleItems.
Fields
canonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuedynamic_price - Booleandynamic_sku - Booleandynamic_weight - Booleangift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringitems - [BundleItem]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 - [CustomizableOptionInterface]options_container - Stringprice_details - PriceDetailsprice_range - PriceRange!price_tiers - [TierPrice]price_view - PriceViewEnumproduct_links - [ProductLinksInterface]quantity - Floatrelated_products - [ProductInterface]ship_bundle_items - ShipBundleItemsEnumshort_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": "xyz789",
"categories": [CategoryInterface],
"country_of_manufacture": "abc123",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"dynamic_price": true,
"dynamic_sku": false,
"dynamic_weight": false,
"gift_message_available": true,
"gift_wrapping_available": true,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"items": [BundleItem],
"manufacturer": 987,
"max_sale_qty": 987.65,
"media_gallery": [MediaGalleryInterface],
"meta_description": "abc123",
"meta_keyword": "abc123",
"meta_title": "xyz789",
"min_sale_qty": 987.65,
"name": "xyz789",
"new_from_date": "abc123",
"new_to_date": "abc123",
"only_x_left_in_stock": 987.65,
"options": [CustomizableOptionInterface],
"options_container": "xyz789",
"price_details": PriceDetails,
"price_range": PriceRange,
"price_tiers": [TierPrice],
"price_view": "PRICE_RANGE",
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"ship_bundle_items": "TOGETHER",
"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
}
BundleRequisitionListItem
Contains details about bundle products added to a requisition list.
Fields
bundle_options - [SelectedBundleOption]!customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!sku - String!uid - ID!Example
{
"bundle_options": [SelectedBundleOption],
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 123.45,
"sku": "xyz789",
"uid": "4"
}
BundleShipmentItem
Defines bundle product options for ShipmentItemInterface.
Fields
bundle_options - [ItemSelectedBundleOption]id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_shipped - Float!Example
{
"bundle_options": [ItemSelectedBundleOption],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "abc123",
"quantity_shipped": 987.65
}
BundleWishlistItem
Defines bundle product options for WishlistItemInterface.
Fields
added_at - String!bundle_options - [SelectedBundleOption]customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!product - ProductInterface!quantity - Float!Example
{
"added_at": "xyz789",
"bundle_options": [SelectedBundleOption],
"customizable_options": [SelectedCustomizableOption],
"description": "xyz789",
"id": "4",
"product": ProductInterface,
"quantity": 987.65
}
ButtonStyles
Fields
color - Stringheight - Intlabel - Stringlayout - Stringshape - Stringtagline - Booleanuse_default_height - BooleanExample
{
"color": "abc123",
"height": 123,
"label": "abc123",
"layout": "abc123",
"shape": "abc123",
"tagline": false,
"use_default_height": true
}
CancelNegotiableQuoteTemplateInput
Specifies the quote template id of the quote template to cancel
Input Fields
cancellation_comment - Stringtemplate_id - ID!Example
{
"cancellation_comment": "xyz789",
"template_id": "4"
}
CancelOrderError
Fields
code - CancelOrderErrorCode!message - String!Example
{
"code": "ORDER_CANCELLATION_DISABLED",
"message": "abc123"
}
CancelOrderErrorCode
Values
ORDER_CANCELLATION_DISABLEDUNDEFINEDUNAUTHORISEDORDER_NOT_FOUNDPARTIAL_ORDER_ITEM_SHIPPEDINVALID_ORDER_STATUSExample
""ORDER_CANCELLATION_DISABLED""
CancelOrderInput
Defines the order to cancel.
Input Fields
order_id - ID!reason - String!Example
{
"order_id": "4",
"reason": "xyz789"
}
CancelOrderOutput
Contains the updated customer order and error message if any.
Fields
error - StringerrorV2 - CancelOrderErrororder - CustomerOrderExample
{
"error": "xyz789",
"errorV2": CancelOrderError,
"order": CustomerOrder
}
CancellationReason
Fields
description - String!Example
{"description": "abc123"}
Card
Fields
bin_details - CardBincard_expiry_month - Stringcard_expiry_year - Stringlast_digits - Stringname - StringExample
{
"bin_details": CardBin,
"card_expiry_month": "abc123",
"card_expiry_year": "abc123",
"last_digits": "xyz789",
"name": "abc123"
}
CardBin
Fields
bin - StringExample
{"bin": "xyz789"}
CardPaymentSourceInput
The card payment source information
Input Fields
billing_address - BillingAddressPaymentSourceInput!name - StringExample
{
"billing_address": BillingAddressPaymentSourceInput,
"name": "abc123"
}
CardPaymentSourceOutput
The card payment source information
Fields
brand - Stringexpiry - Stringlast_digits - StringExample
{
"brand": "abc123",
"expiry": "abc123",
"last_digits": "abc123"
}
Cart
Contains the contents and other details about a guest or customer cart.
Fields
applied_coupons - [AppliedCoupon]applied_gift_cards - [AppliedGiftCard]applied_reward_points - RewardPointsAmountapplied_store_credit - AppliedStoreCreditavailable_gift_wrappings - [GiftWrapping]!available_payment_methods - [AvailablePaymentMethod]billing_address - BillingCartAddresscustom_attributes - [CustomAttribute]email - Stringgift_message - GiftMessagegift_receipt_included - Boolean!gift_wrapping - GiftWrappingid - ID!is_virtual - Boolean!itemsV2 - CartItemsprices - CartPricesprinted_card_included - Boolean!rules - [CartRuleStorefront]selected_payment_method - SelectedPaymentMethodshipping_addresses - [ShippingCartAddress]!total_quantity - Float!Example
{
"applied_coupons": [AppliedCoupon],
"applied_gift_cards": [AppliedGiftCard],
"applied_reward_points": RewardPointsAmount,
"applied_store_credit": AppliedStoreCredit,
"available_gift_wrappings": [GiftWrapping],
"available_payment_methods": [AvailablePaymentMethod],
"billing_address": BillingCartAddress,
"custom_attributes": [CustomAttribute],
"email": "abc123",
"gift_message": GiftMessage,
"gift_receipt_included": true,
"gift_wrapping": GiftWrapping,
"id": "4",
"is_virtual": false,
"itemsV2": CartItems,
"prices": CartPrices,
"printed_card_included": false,
"rules": [CartRuleStorefront],
"selected_payment_method": SelectedPaymentMethod,
"shipping_addresses": [ShippingCartAddress],
"total_quantity": 987.65
}
CartAddressCountry
Contains details the country in a billing or shipping address.
Fields
code - String!label - String!Example
{
"code": "xyz789",
"label": "xyz789"
}
CartAddressInput
Defines the billing or shipping address to be applied to the cart.
Input Fields
city - String!company - Stringcountry_code - String!custom_attributes - [AttributeValueInput]fax - Stringfirstname - String!lastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - Stringregion_id - Intsave_in_address_book - Booleanstreet - [String]!suffix - Stringtelephone - Stringvat_id - StringExample
{
"city": "abc123",
"company": "abc123",
"country_code": "abc123",
"custom_attributes": [AttributeValueInput],
"fax": "xyz789",
"firstname": "abc123",
"lastname": "abc123",
"middlename": "abc123",
"postcode": "xyz789",
"prefix": "xyz789",
"region": "xyz789",
"region_id": 987,
"save_in_address_book": true,
"street": ["abc123"],
"suffix": "xyz789",
"telephone": "abc123",
"vat_id": "abc123"
}
CartAddressInterface
Fields
city - String!company - Stringcountry - CartAddressCountry!custom_attributes - [AttributeValueInterface]!customer_address_uid - IDfax - Stringfirstname - String!id - Intlastname - String!middlename - Stringpostcode - Stringprefix - Stringregion - CartAddressRegionstreet - [String]!suffix - Stringtelephone - Stringuid - ID!vat_id - StringPossible Types
Example
{
"city": "abc123",
"company": "abc123",
"country": CartAddressCountry,
"custom_attributes": [AttributeValueInterface],
"customer_address_uid": "4",
"fax": "abc123",
"firstname": "abc123",
"id": 987,
"lastname": "abc123",
"middlename": "xyz789",
"postcode": "xyz789",
"prefix": "abc123",
"region": CartAddressRegion,
"street": ["xyz789"],
"suffix": "abc123",
"telephone": "abc123",
"uid": "4",
"vat_id": "xyz789"
}
CartAddressRegion
Contains details about the region in a billing or shipping address.
Fields
code - Stringlabel - Stringregion_id - IntExample
{
"code": "abc123",
"label": "xyz789",
"region_id": 123
}
CartCustomAttributesInput
Defines a cart custom attributes.
Input Fields
cart_id - String!custom_attributes - [CustomAttributeInput]Example
{
"cart_id": "abc123",
"custom_attributes": [CustomAttributeInput]
}
CartDiscountType
Values
ITEMSHIPPINGExample
""ITEM""
CartItemCustomAttributesInput
Defines a cart item custom attributes.
Input Fields
cart_id - String!cart_item_id - String!custom_attributes - [CustomAttributeInput]Example
{
"cart_id": "xyz789",
"cart_item_id": "abc123",
"custom_attributes": [CustomAttributeInput]
}
CartItemError
Fields
code - CartItemErrorType!message - String!Example
{"code": "UNDEFINED", "message": "xyz789"}
CartItemErrorType
Values
UNDEFINEDITEM_QTYITEM_INCREMENTSExample
""UNDEFINED""
CartItemInput
Defines an item to be added to the cart.
Input Fields
entered_options - [EnteredOptionInput]parent_sku - Stringquantity - Float!selected_options - [ID]sku - String!Example
{
"entered_options": [EnteredOptionInput],
"parent_sku": "xyz789",
"quantity": 123.45,
"selected_options": ["4"],
"sku": "abc123"
}
CartItemInterface
An interface for products in a cart.
Fields
custom_attributes - [CustomAttribute]discount - [Discount]errors - [CartItemError]is_available - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!Possible Types
Example
{
"custom_attributes": [CustomAttribute],
"discount": [Discount],
"errors": [CartItemError],
"is_available": false,
"max_qty": 123.45,
"min_qty": 123.45,
"not_available_message": "xyz789",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 987.65,
"uid": 4
}
CartItemPrices
Contains details about the price of the item, including taxes and discounts.
Fields
catalog_discount - ProductDiscountdiscounts - [Discount]fixed_product_taxes - [FixedProductTax]original_item_price - Money!original_row_total - Money!price - Money!price_including_tax - Money!row_catalog_discount - ProductDiscountrow_total - Money!row_total_including_tax - Money!total_item_discount - MoneyExample
{
"catalog_discount": ProductDiscount,
"discounts": [Discount],
"fixed_product_taxes": [FixedProductTax],
"original_item_price": Money,
"original_row_total": Money,
"price": Money,
"price_including_tax": Money,
"row_catalog_discount": ProductDiscount,
"row_total": Money,
"row_total_including_tax": Money,
"total_item_discount": Money
}
CartItemSelectedOptionValuePrice
Contains details about the price of a selected customizable value.
Fields
type - PriceTypeEnum!units - String!value - Float!Example
{
"type": "FIXED",
"units": "abc123",
"value": 123.45
}
CartItemUpdateInput
A single item to be updated.
Input Fields
cart_item_uid - IDcustomizable_options - [CustomizableOptionInput]gift_message - GiftMessageInputgift_wrapping_id - IDquantity - FloatExample
{
"cart_item_uid": 4,
"customizable_options": [CustomizableOptionInput],
"gift_message": GiftMessageInput,
"gift_wrapping_id": "4",
"quantity": 987.65
}
CartItems
Fields
items - [CartItemInterface]!page_info - SearchResultPageInfototal_count - Int!Example
{
"items": [CartItemInterface],
"page_info": SearchResultPageInfo,
"total_count": 987
}
CartPrices
Contains details about the final price of items in the cart, including discount and tax information.
Fields
applied_taxes - [CartTaxItem]discounts - [Discount]gift_options - GiftOptionsPricesgrand_total - Moneygrand_total_excluding_tax - Moneysubtotal_excluding_tax - Moneysubtotal_including_tax - Moneysubtotal_with_discount_excluding_tax - MoneyExample
{
"applied_taxes": [CartTaxItem],
"discounts": [Discount],
"gift_options": GiftOptionsPrices,
"grand_total": Money,
"grand_total_excluding_tax": Money,
"subtotal_excluding_tax": Money,
"subtotal_including_tax": Money,
"subtotal_with_discount_excluding_tax": Money
}
CartRuleStorefront
Fields
uid - ID!Example
{"uid": "4"}
CartTaxItem
Contains tax information about an item in the cart.
Fields
amount - Money!label - String!Example
{
"amount": Money,
"label": "xyz789"
}
CartUserInputError
Fields
code - CartUserInputErrorType!message - String!Example
{
"code": "PRODUCT_NOT_FOUND",
"message": "xyz789"
}
CartUserInputErrorType
Values
PRODUCT_NOT_FOUNDNOT_SALABLEINSUFFICIENT_STOCKCOULD_NOT_FIND_CART_ITEMREQUIRED_PARAMETER_MISSINGINVALID_PARAMETER_VALUEUNDEFINEDPERMISSION_DENIEDExample
""PRODUCT_NOT_FOUND""
CatalogAttributeApplyToEnum
Values
SIMPLEVIRTUALBUNDLEDOWNLOADABLECONFIGURABLEGROUPEDCATEGORYExample
""SIMPLE""
CatalogAttributeMetadata
Swatch attribute metadata.
Fields
apply_to - [CatalogAttributeApplyToEnum]code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnumis_comparable - Booleanis_filterable - Booleanis_filterable_in_search - Booleanis_html_allowed_on_front - Booleanis_required - Boolean!is_searchable - Booleanis_unique - Boolean!is_used_for_price_rules - Booleanis_used_for_promo_rules - Booleanis_visible_in_advanced_search - Booleanis_visible_on_front - Booleanis_wysiwyg_enabled - Booleanlabel - Stringoptions - [CustomAttributeOptionInterface]!swatch_input_type - SwatchInputTypeEnumupdate_product_preview_image - Booleanuse_product_image_for_swatch - Booleanused_in_product_listing - BooleanExample
{
"apply_to": ["SIMPLE"],
"code": "4",
"default_value": "xyz789",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "abc123",
"frontend_input": "BOOLEAN",
"is_comparable": false,
"is_filterable": true,
"is_filterable_in_search": true,
"is_html_allowed_on_front": true,
"is_required": false,
"is_searchable": true,
"is_unique": true,
"is_used_for_price_rules": true,
"is_used_for_promo_rules": true,
"is_visible_in_advanced_search": false,
"is_visible_on_front": false,
"is_wysiwyg_enabled": true,
"label": "xyz789",
"options": [CustomAttributeOptionInterface],
"swatch_input_type": "BOOLEAN",
"update_product_preview_image": true,
"use_product_image_for_swatch": false,
"used_in_product_listing": true
}
CategoryBucket
New category bucket for federation
Fields
Example
{
"count": 123,
"id": 4,
"path": "abc123",
"title": "abc123"
}
CategoryBucketInterface
Fields
id - ID!Possible Types
Example
{"id": "4"}
CategoryImage
Represents an image associated with a category.
Fields
url - String!label - Stringroles - [String]customRoles - [String]Example
{
"url": "xyz789",
"label": "abc123",
"roles": ["xyz789"],
"customRoles": ["abc123"]
}
CategoryInterface
Contains the full set of attributes that can be returned in a category search.
Fields
available_sort_by - [String]breadcrumbs - [Breadcrumb]canonical_url - Stringchildren_count - Stringcustom_layout_update_file - Stringdefault_sort_by - Stringdescription - Stringdisplay_mode - Stringfilter_price_range - Floatimage - Stringinclude_in_menu - Intis_anchor - Intlanding_page - Intlevel - Intmeta_description - Stringmeta_keywords - Stringmeta_title - Stringname - Stringpath - Stringpath_in_store - Stringposition - Intproduct_count - Intuid - ID!url_key - Stringurl_path - StringPossible Types
Example
{
"available_sort_by": ["xyz789"],
"breadcrumbs": [Breadcrumb],
"canonical_url": "abc123",
"children_count": "abc123",
"custom_layout_update_file": "xyz789",
"default_sort_by": "xyz789",
"description": "abc123",
"display_mode": "xyz789",
"filter_price_range": 123.45,
"image": "abc123",
"include_in_menu": 123,
"is_anchor": 123,
"landing_page": 123,
"level": 987,
"meta_description": "xyz789",
"meta_keywords": "abc123",
"meta_title": "abc123",
"name": "xyz789",
"path": "xyz789",
"path_in_store": "xyz789",
"position": 987,
"product_count": 987,
"uid": 4,
"url_key": "abc123",
"url_path": "abc123"
}
CategoryMetaTags
SEO metadata tags for the category.
Fields
title - Stringdescription - Stringkeywords - [String]Example
{
"title": "abc123",
"description": "xyz789",
"keywords": ["xyz789"]
}
CategoryNavigationView
Represents a category optimized for navigation menus, with nested children for building navigation trees.
Fields
slug - String!name - String!children - [CategoryNavigationView]Example
{
"slug": "abc123",
"name": "xyz789",
"children": [CategoryNavigationView]
}
CategoryProductView
Represents category information associated with a product, including hierarchical parent relationships.
Fields
name - String!slug - String!level - Int!parents - [CategoryProductView!]Example
{
"name": "abc123",
"slug": "xyz789",
"level": 123,
"parents": [CategoryProductView]
}
CategoryTree
Contains the hierarchy of categories.
Fields
available_sort_by - [String]breadcrumbs - [Breadcrumb]canonical_url - Stringchildren_count - Stringcustom_layout_update_file - Stringdefault_sort_by - Stringdescription - Stringdisplay_mode - Stringfilter_price_range - Floatimage - Stringinclude_in_menu - Intis_anchor - Intlanding_page - Intlevel - Intmeta_description - Stringmeta_keywords - Stringmeta_title - Stringname - Stringpath - Stringpath_in_store - Stringposition - Intproduct_count - Intuid - ID!url_key - Stringurl_path - StringExample
{
"available_sort_by": ["xyz789"],
"breadcrumbs": [Breadcrumb],
"canonical_url": "abc123",
"children_count": "xyz789",
"custom_layout_update_file": "xyz789",
"default_sort_by": "xyz789",
"description": "xyz789",
"display_mode": "xyz789",
"filter_price_range": 123.45,
"image": "abc123",
"include_in_menu": 123,
"is_anchor": 987,
"landing_page": 987,
"level": 987,
"meta_description": "xyz789",
"meta_keywords": "abc123",
"meta_title": "abc123",
"name": "abc123",
"path": "abc123",
"path_in_store": "abc123",
"position": 123,
"product_count": 987,
"uid": 4,
"url_key": "xyz789",
"url_path": "xyz789"
}
CategoryTreeView
Represents a category within a hierarchical tree structure, including parent and children relationships.
Fields
slug - String!name - String!description - StringmetaTags - CategoryMetaTagsimages - [CategoryImage]level - IntparentSlug - StringchildrenSlugs - [String]Example
{
"slug": "xyz789",
"name": "xyz789",
"description": "xyz789",
"metaTags": CategoryMetaTags,
"images": [CategoryImage],
"level": 123,
"parentSlug": "abc123",
"childrenSlugs": ["xyz789"]
}
CategoryView
Represents a category. Contains information about a category, including the category ID, the category name, the category path, the category URL key, the category URL path, and the category roles.
Fields
availableSortBy - [String]children - [String!]defaultSortBy - Stringid - ID!level - Intname - StringparentId - String!path - Stringroles - [String!]!urlKey - StringurlPath - Stringcount - Int!title - String!Example
{
"availableSortBy": ["abc123"],
"children": ["xyz789"],
"defaultSortBy": "abc123",
"id": "4",
"level": 123,
"name": "abc123",
"parentId": "xyz789",
"path": "xyz789",
"roles": ["xyz789"],
"urlKey": "xyz789",
"urlPath": "xyz789",
"count": 987,
"title": "xyz789"
}
CategoryViewInterface
Base interface defining essential category fields shared across all category views.
Fields
availableSortBy - [String]defaultSortBy - Stringid - ID!level - Intname - Stringpath - Stringroles - [String]urlKey - StringurlPath - StringPossible Types
Example
{
"availableSortBy": ["xyz789"],
"defaultSortBy": "abc123",
"id": 4,
"level": 987,
"name": "abc123",
"path": "abc123",
"roles": ["abc123"],
"urlKey": "xyz789",
"urlPath": "xyz789"
}
CategoryViewV2
Base interface defining essential category fields shared across all category views.
Fields
slug - String!name - String!Possible Types
Example
{
"slug": "abc123",
"name": "xyz789"
}
CheckoutAgreement
Defines details about an individual checkout agreement.
Fields
agreement_id - Int!checkbox_text - String!content - String!content_height - Stringis_html - Boolean!mode - CheckoutAgreementMode!name - String!Example
{
"agreement_id": 123,
"checkbox_text": "abc123",
"content": "xyz789",
"content_height": "abc123",
"is_html": false,
"mode": "AUTO",
"name": "xyz789"
}
CheckoutAgreementMode
Indicates how agreements are accepted.
Values
AUTOMANUALExample
""AUTO""
CheckoutUserInputError
An error encountered while adding an item to the cart.
Fields
code - CheckoutUserInputErrorCodes!message - String!path - [String]!Example
{
"code": "REORDER_NOT_AVAILABLE",
"message": "abc123",
"path": ["xyz789"]
}
CheckoutUserInputErrorCodes
Values
REORDER_NOT_AVAILABLEPRODUCT_NOT_FOUNDNOT_SALABLEINSUFFICIENT_STOCKUNDEFINEDExample
""REORDER_NOT_AVAILABLE""
ClearCustomerCartOutput
Output of the request to clear the customer cart.
Fields
cart - Cartstatus - Boolean!Example
{"cart": Cart, "status": true}
CloseNegotiableQuoteError
Types
Example
NegotiableQuoteInvalidStateError
CloseNegotiableQuoteOperationFailure
Contains details about a failed close operation on a negotiable quote.
Fields
errors - [CloseNegotiableQuoteError]!quote_uid - ID!Example
{
"errors": [NegotiableQuoteInvalidStateError],
"quote_uid": 4
}
CloseNegotiableQuoteOperationResult
Types
Example
NegotiableQuoteUidOperationSuccess
CloseNegotiableQuotesInput
Defines the negotiable quotes to mark as closed.
Input Fields
quote_uids - [ID]!Example
{"quote_uids": ["4"]}
CloseNegotiableQuotesOutput
Contains the closed negotiable quotes and other negotiable quotes the company user can view.
Fields
negotiable_quotes - NegotiableQuotesOutputoperation_results - [CloseNegotiableQuoteOperationResult]!result_status - BatchMutationStatus!Example
{
"negotiable_quotes": NegotiableQuotesOutput,
"operation_results": [
NegotiableQuoteUidOperationSuccess
],
"result_status": "SUCCESS"
}
ColorSwatchData
Fields
value - StringExample
{"value": "abc123"}
CommerceOptimizerContext
Commerce Optimizer entities
Fields
priceBookId - ID!Example
{"priceBookId": 4}
CompaniesSortFieldEnum
The fields available for sorting the customer companies.
Values
NAMEExample
""NAME""
CompaniesSortInput
Specifies which field to sort on, and whether to return the results in ascending or descending order.
Input Fields
field - CompaniesSortFieldEnum!order - SortEnum!Example
{"field": "NAME", "order": "ASC"}
Company
Contains the output schema for a company.
Fields
acl_resources - [CompanyAclResource]available_payment_methods - [AvailablePaymentMethod]available_shipping_methods - [CompanyAvailableShippingMethod]company_admin - Customercredit - CompanyCredit!credit_history - CompanyCreditHistory!custom_attributes - [CustomAttribute]email - Stringid - ID!legal_address - CompanyLegalAddresslegal_name - Stringname - Stringpayment_methods - [String]reseller_id - Stringrole - CompanyRoleroles - CompanyRoles!sales_representative - CompanySalesRepresentativestatus - CompanyStatusEnumstructure - CompanyStructureteam - CompanyTeamuser - Customerusers - CompanyUsersvat_tax_id - StringExample
{
"acl_resources": [CompanyAclResource],
"available_payment_methods": [AvailablePaymentMethod],
"available_shipping_methods": [
CompanyAvailableShippingMethod
],
"company_admin": Customer,
"credit": CompanyCredit,
"credit_history": CompanyCreditHistory,
"custom_attributes": [CustomAttribute],
"email": "xyz789",
"id": "4",
"legal_address": CompanyLegalAddress,
"legal_name": "abc123",
"name": "abc123",
"payment_methods": ["abc123"],
"reseller_id": "abc123",
"role": CompanyRole,
"roles": CompanyRoles,
"sales_representative": CompanySalesRepresentative,
"status": "PENDING",
"structure": CompanyStructure,
"team": CompanyTeam,
"user": Customer,
"users": CompanyUsers,
"vat_tax_id": "xyz789"
}
CompanyAclResource
Contains details about the access control list settings of a resource.
Fields
children - [CompanyAclResource]id - ID!sort_order - Inttext - StringExample
{
"children": [CompanyAclResource],
"id": "4",
"sort_order": 123,
"text": "abc123"
}
CompanyAdminInput
Defines the input schema for creating a company administrator.
Input Fields
custom_attributes - [AttributeValueInput]email - String!firstname - String!gender - Intjob_title - Stringlastname - String!telephone - StringExample
{
"custom_attributes": [AttributeValueInput],
"email": "xyz789",
"firstname": "xyz789",
"gender": 987,
"job_title": "abc123",
"lastname": "abc123",
"telephone": "abc123"
}
CompanyAvailableShippingMethod
Describes a carrier-level shipping option available to the company.
Fields
Example
{
"code": "xyz789",
"title": "abc123"
}
CompanyBasicInfo
The minimal required information to identify and display the company.
Fields
id - ID!legal_name - Stringname - Stringstatus - CompanyStatusEnumExample
{
"id": "4",
"legal_name": "xyz789",
"name": "xyz789",
"status": "PENDING"
}
CompanyCreateInput
Defines the input schema for creating a new company.
Input Fields
company_admin - CompanyAdminInput!company_email - String!company_name - String!legal_address - CompanyLegalAddressCreateInput!legal_name - Stringreseller_id - Stringvat_tax_id - StringExample
{
"company_admin": CompanyAdminInput,
"company_email": "xyz789",
"company_name": "xyz789",
"legal_address": CompanyLegalAddressCreateInput,
"legal_name": "xyz789",
"reseller_id": "xyz789",
"vat_tax_id": "xyz789"
}
CompanyCredit
Contains company credit balances and limits.
Fields
available_credit - Money!credit_limit - Money!exceed_limit - Boolean!outstanding_balance - Money!Example
{
"available_credit": Money,
"credit_limit": Money,
"exceed_limit": false,
"outstanding_balance": Money
}
CompanyCreditHistory
Contains details about prior company credit operations.
Fields
items - [CompanyCreditOperation]!page_info - SearchResultPageInfo!total_count - IntExample
{
"items": [CompanyCreditOperation],
"page_info": SearchResultPageInfo,
"total_count": 123
}
CompanyCreditHistoryFilterInput
Defines a filter for narrowing the results of a credit history search.
Input Fields
custom_reference_number - Stringoperation_type - CompanyCreditOperationTypeupdated_by - StringExample
{
"custom_reference_number": "abc123",
"operation_type": "ALLOCATION",
"updated_by": "xyz789"
}
CompanyCreditOperation
Contains details about a single company credit operation.
Fields
amount - Moneybalance - CompanyCredit!custom_reference_number - Stringdate - String!type - CompanyCreditOperationType!updated_by - CompanyCreditOperationUser!Example
{
"amount": Money,
"balance": CompanyCredit,
"custom_reference_number": "abc123",
"date": "abc123",
"type": "ALLOCATION",
"updated_by": CompanyCreditOperationUser
}
CompanyCreditOperationType
Values
ALLOCATIONUPDATEPURCHASEREIMBURSEMENTREFUNDREVERTExample
""ALLOCATION""
CompanyCreditOperationUser
Defines the administrator or company user that submitted a company credit operation.
Fields
name - String!Example
{"name": "xyz789", "type": "CUSTOMER"}
CompanyCreditOperationUserType
Values
CUSTOMERADMINExample
""CUSTOMER""
CompanyInvitationInput
Defines the input schema for accepting the company invitation.
Input Fields
code - String!role_id - IDuser - CompanyInvitationUserInput!Example
{
"code": "xyz789",
"role_id": 4,
"user": CompanyInvitationUserInput
}
CompanyInvitationOutput
The result of accepting the company invitation.
Fields
success - BooleanExample
{"success": true}
CompanyInvitationUserInput
Company user attributes in the invitation.
Input Fields
company_id - ID!customer_id - ID!job_title - Stringstatus - CompanyUserStatusEnumtelephone - StringExample
{
"company_id": 4,
"customer_id": "4",
"job_title": "abc123",
"status": "ACTIVE",
"telephone": "abc123"
}
CompanyLegalAddress
Contains details about the address where the company is registered to conduct business.
Fields
city - Stringcountry_code - CountryCodeEnumpostcode - Stringregion - CustomerAddressRegionstreet - [String]telephone - StringExample
{
"city": "xyz789",
"country_code": "AF",
"postcode": "abc123",
"region": CustomerAddressRegion,
"street": ["abc123"],
"telephone": "xyz789"
}
CompanyLegalAddressCreateInput
Defines the input schema for defining a company's legal address.
Input Fields
city - String!country_id - CountryCodeEnum!postcode - String!region - CustomerAddressRegionInput!street - [String]!telephone - String!Example
{
"city": "xyz789",
"country_id": "AF",
"postcode": "abc123",
"region": CustomerAddressRegionInput,
"street": ["abc123"],
"telephone": "abc123"
}
CompanyLegalAddressUpdateInput
Defines the input schema for updating a company's legal address.
Input Fields
city - Stringcountry_id - CountryCodeEnumpostcode - Stringregion - CustomerAddressRegionInputstreet - [String]telephone - StringExample
{
"city": "xyz789",
"country_id": "AF",
"postcode": "abc123",
"region": CustomerAddressRegionInput,
"street": ["xyz789"],
"telephone": "abc123"
}
CompanyRole
Contails details about a single role.
Fields
id - ID!name - Stringpermissions - [CompanyAclResource]users_count - IntExample
{
"id": "4",
"name": "abc123",
"permissions": [CompanyAclResource],
"users_count": 123
}
CompanyRoleCreateInput
Defines the input schema for creating a company role.
Input Fields
name - String!permissions - [String]Example
{
"name": "abc123",
"permissions": ["abc123"]
}
CompanyRoleUpdateInput
Defines the input schema for updating a company role.
Input Fields
id - ID!name - Stringpermissions - [String]Example
{
"id": "4",
"name": "xyz789",
"permissions": ["xyz789"]
}
CompanyRoles
Contains an array of roles.
Fields
items - [CompanyRole]!page_info - SearchResultPageInfototal_count - Int!Example
{
"items": [CompanyRole],
"page_info": SearchResultPageInfo,
"total_count": 987
}
CompanySalesRepresentative
Contains details about a company sales representative.
Fields
email - Stringfirstname - Stringlastname - StringExample
{
"email": "abc123",
"firstname": "xyz789",
"lastname": "xyz789"
}
CompanyStatusEnum
Defines the list of company status values.
Values
PENDINGAPPROVEDREJECTEDBLOCKEDExample
""PENDING""
CompanyStructure
Contains an array of the individual nodes that comprise the company structure.
Fields
items - [CompanyStructureItem]Example
{"items": [CompanyStructureItem]}
CompanyStructureEntity
Types
Example
CompanyTeam
CompanyStructureItem
Defines an individual node in the company structure.
Fields
entity - CompanyStructureEntityid - ID!parent_id - IDExample
{
"entity": CompanyTeam,
"id": "4",
"parent_id": 4
}
CompanyStructureUpdateInput
Defines the input schema for updating the company structure.
Input Fields
parent_tree_id - ID!tree_id - ID!Example
{
"parent_tree_id": "4",
"tree_id": "4"
}
CompanyTeam
Describes a company team.
Fields
description - Stringid - IDname - Stringstructure_id - ID!Example
{
"description": "abc123",
"id": 4,
"name": "abc123",
"structure_id": "4"
}
CompanyTeamCreateInput
Defines the input schema for creating a company team.
Input Fields
description - Stringname - String!target_id - IDExample
{
"description": "abc123",
"name": "xyz789",
"target_id": "4"
}
CompanyTeamUpdateInput
Defines the input schema for updating a company team.
Input Fields
description - Stringid - ID!name - StringExample
{
"description": "xyz789",
"id": "4",
"name": "xyz789"
}
CompanyUpdateInput
Defines the input schema for updating a company.
Input Fields
company_email - Stringcompany_name - Stringlegal_address - CompanyLegalAddressUpdateInputlegal_name - Stringreseller_id - Stringvat_tax_id - StringExample
{
"company_email": "xyz789",
"company_name": "abc123",
"legal_address": CompanyLegalAddressUpdateInput,
"legal_name": "abc123",
"reseller_id": "abc123",
"vat_tax_id": "xyz789"
}
CompanyUserCreateInput
Defines the input schema for creating a company user.
Input Fields
email - String!firstname - String!job_title - String!lastname - String!role_id - ID!status - CompanyUserStatusEnum!target_id - IDtelephone - String!Example
{
"email": "abc123",
"firstname": "abc123",
"job_title": "abc123",
"lastname": "xyz789",
"role_id": "4",
"status": "ACTIVE",
"target_id": 4,
"telephone": "xyz789"
}
CompanyUserStatusEnum
Defines the list of company user status values.
Values
ACTIVEINACTIVEExample
""ACTIVE""
CompanyUserUpdateInput
Defines the input schema for updating a company user.
Input Fields
email - Stringfirstname - Stringid - ID!job_title - Stringlastname - Stringrole_id - IDstatus - CompanyUserStatusEnumtelephone - StringExample
{
"email": "abc123",
"firstname": "abc123",
"id": "4",
"job_title": "xyz789",
"lastname": "xyz789",
"role_id": "4",
"status": "ACTIVE",
"telephone": "xyz789"
}
CompanyUsers
Contains details about company users.
Fields
items - [Customer]!page_info - SearchResultPageInfototal_count - Int!Example
{
"items": [Customer],
"page_info": SearchResultPageInfo,
"total_count": 123
}
CompanyUsersFilterInput
Defines the filter for returning a list of company users.
Input Fields
status - CompanyUserStatusEnumExample
{"status": "ACTIVE"}
ComparableAttribute
Contains an attribute code that is used for product comparisons.
Fields
code - String!label - String!Example
{
"code": "xyz789",
"label": "xyz789"
}
ComparableItem
Defines an object used to iterate through items for product comparisons.
Fields
attributes - [ProductAttribute]!product - ProductInterface!uid - ID!Example
{
"attributes": [ProductAttribute],
"product": ProductInterface,
"uid": "4"
}
CompareList
Contains iterable information such as the array of items, the count, and attributes that represent the compare list.
Fields
attributes - [ComparableAttribute]item_count - Int!items - [ComparableItem]uid - ID!Example
{
"attributes": [ComparableAttribute],
"item_count": 123,
"items": [ComparableItem],
"uid": "4"
}
CompleteOrderInput
Update the quote and complete the order
Input Fields
Example
{
"cartId": "abc123",
"id": "xyz789"
}
ComplexProductView
Represents all product types, except simple products. Complex product prices are returned as a price range, because price values can vary based on selected options.
Fields
addToCartAllowed - BooleaninStock - BooleanlowStock - Booleanattributes - [ProductViewAttribute]description - Stringid - ID!images - [ProductViewImage]videos - [ProductViewVideo]lastModifiedAt - DateTimemetaDescription - StringmetaKeyword - StringmetaTitle - Stringname - StringinputOptions - [ProductViewInputOption]options - [ProductViewOption]priceRange - ProductViewPriceRangeshortDescription - Stringsku - StringexternalId - Stringurl - StringurlKey - Stringlinks - [ProductViewLink]categories - [CategoryProductView!]queryType - Stringvisibility - StringExample
{
"addToCartAllowed": true,
"inStock": false,
"lowStock": true,
"attributes": [ProductViewAttribute],
"description": "abc123",
"id": 4,
"images": [ProductViewImage],
"videos": [ProductViewVideo],
"lastModifiedAt": "2007-12-03T10:15:30Z",
"metaDescription": "xyz789",
"metaKeyword": "xyz789",
"metaTitle": "xyz789",
"name": "xyz789",
"inputOptions": [ProductViewInputOption],
"options": [ProductViewOption],
"priceRange": ProductViewPriceRange,
"shortDescription": "xyz789",
"sku": "xyz789",
"externalId": "abc123",
"url": "abc123",
"urlKey": "abc123",
"links": [ProductViewLink],
"categories": [CategoryProductView],
"queryType": "xyz789",
"visibility": "abc123"
}
ComplexTextValue
Fields
html - String!Example
{"html": "xyz789"}
ConditionInput
Input Fields
Example
{
"field": "UNKNOWN_FIELD",
"operator": OperatorInput,
"enabled": true
}
ConfigurableAttributeOption
Contains details about a configurable product attribute option.
Fields
code - Stringlabel - Stringuid - ID!value_index - IntExample
{
"code": "abc123",
"label": "xyz789",
"uid": "4",
"value_index": 123
}
ConfigurableCartItem
An implementation for configurable product cart items.
Fields
available_gift_wrapping - [GiftWrapping]!configurable_options - [SelectedConfigurableOption]!configured_variant - ProductInterface!custom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]gift_message - GiftMessagegift_wrapping - GiftWrappingis_available - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!Example
{
"available_gift_wrapping": [GiftWrapping],
"configurable_options": [SelectedConfigurableOption],
"configured_variant": ProductInterface,
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"is_available": false,
"max_qty": 123.45,
"min_qty": 123.45,
"not_available_message": "abc123",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 123.45,
"uid": "4"
}
ConfigurableOptionAvailableForSelection
Describes configurable options that have been selected and can be selected as a result of the previous selections.
Fields
attribute_code - String!option_value_uids - [ID]!Example
{
"attribute_code": "abc123",
"option_value_uids": [4]
}
ConfigurableOrderItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]eligible_for_return - Booleanentered_options - [OrderItemOption]gift_message - GiftMessagegift_wrapping - GiftWrappingid - ID!parent_sku - Stringprices - OrderItemPricesproduct - ProductInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!product_type - Stringproduct_url_key - Stringquantity_canceled - Floatquantity_invoiced - Floatquantity_ordered - Floatquantity_refunded - Floatquantity_return_requested - Floatquantity_returned - Floatquantity_shipped - Floatselected_options - [OrderItemOption]status - StringExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"eligible_for_return": true,
"entered_options": [OrderItemOption],
"gift_message": GiftMessage,
"gift_wrapping": GiftWrapping,
"id": 4,
"parent_sku": "abc123",
"prices": OrderItemPrices,
"product": ProductInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "abc123",
"product_type": "abc123",
"product_url_key": "xyz789",
"quantity_canceled": 987.65,
"quantity_invoiced": 987.65,
"quantity_ordered": 987.65,
"quantity_refunded": 123.45,
"quantity_return_requested": 987.65,
"quantity_returned": 123.45,
"quantity_shipped": 987.65,
"selected_options": [OrderItemOption],
"status": "xyz789"
}
ConfigurableProduct
Defines basic features of a configurable product and its simple product variants.
Fields
canonical_url - Stringcategories - [CategoryInterface]configurable_options - [ConfigurableProductOptions]configurable_product_options_selection - ConfigurableProductOptionsSelectioncountry_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions - [CustomizableOptionInterface]options_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]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 - Stringvariants - [ConfigurableVariant]weight - FloatExample
{
"canonical_url": "xyz789",
"categories": [CategoryInterface],
"configurable_options": [ConfigurableProductOptions],
"configurable_product_options_selection": ConfigurableProductOptionsSelection,
"country_of_manufacture": "xyz789",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": true,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "xyz789",
"manufacturer": 987,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "abc123",
"meta_keyword": "xyz789",
"meta_title": "abc123",
"min_sale_qty": 987.65,
"name": "xyz789",
"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": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 123.45,
"special_to_date": "xyz789",
"stock_status": "IN_STOCK",
"swatch_image": "abc123",
"thumbnail": ProductImage,
"uid": 4,
"upsell_products": [ProductInterface],
"url_key": "abc123",
"variants": [ConfigurableVariant],
"weight": 987.65
}
ConfigurableProductOption
Contains details about configurable product options.
Fields
attribute_code - String!label - String!uid - ID!values - [ConfigurableProductOptionValue]Example
{
"attribute_code": "xyz789",
"label": "abc123",
"uid": 4,
"values": [ConfigurableProductOptionValue]
}
ConfigurableProductOptionValue
Defines a value for a configurable product option.
Fields
is_available - Boolean!is_use_default - Boolean!label - String!swatch - SwatchDataInterfaceuid - ID!Example
{
"is_available": true,
"is_use_default": true,
"label": "abc123",
"swatch": SwatchDataInterface,
"uid": "4"
}
ConfigurableProductOptions
Defines configurable attributes for the specified product.
Fields
attribute_code - Stringattribute_uid - ID!label - Stringposition - Intuid - ID!use_default - Booleanvalues - [ConfigurableProductOptionsValues]Example
{
"attribute_code": "xyz789",
"attribute_uid": 4,
"label": "abc123",
"position": 987,
"uid": "4",
"use_default": true,
"values": [ConfigurableProductOptionsValues]
}
ConfigurableProductOptionsSelection
Contains metadata corresponding to the selected configurable options.
Fields
configurable_options - [ConfigurableProductOption]media_gallery - [MediaGalleryInterface]options_available_for_selection - [ConfigurableOptionAvailableForSelection]variant - SimpleProductExample
{
"configurable_options": [ConfigurableProductOption],
"media_gallery": [MediaGalleryInterface],
"options_available_for_selection": [
ConfigurableOptionAvailableForSelection
],
"variant": SimpleProduct
}
ConfigurableProductOptionsValues
Contains the index number assigned to a configurable product option.
Fields
default_label - Stringlabel - Stringstore_label - Stringswatch_data - SwatchDataInterfaceuid - IDuse_default_value - BooleanExample
{
"default_label": "xyz789",
"label": "xyz789",
"store_label": "xyz789",
"swatch_data": SwatchDataInterface,
"uid": "4",
"use_default_value": true
}
ConfigurableRequisitionListItem
Contains details about configurable products added to a requisition list.
Fields
configurable_options - [SelectedConfigurableOption]customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!sku - String!uid - ID!Example
{
"configurable_options": [SelectedConfigurableOption],
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 987.65,
"sku": "xyz789",
"uid": 4
}
ConfigurableVariant
Contains all the simple product variants of a configurable product.
Fields
attributes - [ConfigurableAttributeOption]product - SimpleProductExample
{
"attributes": [ConfigurableAttributeOption],
"product": SimpleProduct
}
ConfigurableWishlistItem
A configurable product wish list item.
Fields
added_at - String!configurable_options - [SelectedConfigurableOption]configured_variant - ProductInterfacecustomizable_options - [SelectedCustomizableOption]!description - Stringid - ID!product - ProductInterface!quantity - Float!Example
{
"added_at": "abc123",
"configurable_options": [SelectedConfigurableOption],
"configured_variant": ProductInterface,
"customizable_options": [SelectedCustomizableOption],
"description": "abc123",
"id": "4",
"product": ProductInterface,
"quantity": 123.45
}
ConfirmCancelOrderInput
Input Fields
confirmation_key - String!order_id - ID!Example
{
"confirmation_key": "xyz789",
"order_id": "4"
}
ConfirmEmailInput
Contains details about a customer email address to confirm.
Input Fields
confirmation_key - String!email - String!Example
{
"confirmation_key": "xyz789",
"email": "abc123"
}
ConfirmReturnInput
Input Fields
confirmation_key - String!order_id - ID!Example
{
"confirmation_key": "abc123",
"order_id": 4
}
ConfirmationStatusEnum
List of account confirmation statuses.
Values
ACCOUNT_CONFIRMEDACCOUNT_CONFIRMATION_NOT_REQUIREDExample
""ACCOUNT_CONFIRMED""
ContactUsInput
Input Fields
comment - String!email - String!name - String!telephone - StringExample
{
"comment": "abc123",
"email": "xyz789",
"name": "xyz789",
"telephone": "abc123"
}
ContactUsOutput
Contains the status of the request.
Fields
status - Boolean!Example
{"status": false}
CopyItemsBetweenRequisitionListsInput
An input object that defines the items in a requisition list to be copied.
Input Fields
requisitionListItemUids - [ID]!Example
{"requisitionListItemUids": [4]}
CopyItemsFromRequisitionListsOutput
Output of the request to copy items to the destination requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
CopyProductsBetweenWishlistsOutput
Contains the source and target wish lists after copying products.
Fields
destination_wishlist - Wishlist!source_wishlist - Wishlist!user_errors - [WishListUserInputError]!Example
{
"destination_wishlist": Wishlist,
"source_wishlist": Wishlist,
"user_errors": [WishListUserInputError]
}
Country
Fields
available_regions - [Region]full_name_english - Stringfull_name_locale - Stringid - Stringthree_letter_abbreviation - Stringtwo_letter_abbreviation - StringExample
{
"available_regions": [Region],
"full_name_english": "xyz789",
"full_name_locale": "abc123",
"id": "xyz789",
"three_letter_abbreviation": "abc123",
"two_letter_abbreviation": "xyz789"
}
CountryCodeEnum
The list of country codes.
Values
AFAXALDZASADAOAIAQAGARAMAWAUATAZBSBHBDBBBYBEBZBJBMBTBOBABWBVBRIOVGBNBGBFBIKHCMCACVKYCFTDCLCNCXCCCOKMCGCDCKCRCIHRCUCYCZDKDJDMDOECEGSVGQEREESZETFKFOFJFIFRGFPFTFGAGMGEDEGHGIGRGLGDGPGUGTGGGNGWGYHTHMHNHKHUISINIDIRIQIEIMILITJMJPJEJOKZKEKIKWKGLALVLBLSLRLYLILTLUMOMKMGMWMYMVMLMTMHMQMRMUYTMXFMMDMCMNMEMSMAMZMMNANRNPNLANNCNZNINENGNUNFMPKPNOOMPKPWPSPAPGPYPEPHPNPLPTQARERORURWWSSMSTSASNRSSCSLSGSKSISBSOZAGSKRESLKBLSHKNLCMFPMVCSDSRSJSECHSYTWTJTZTHTLTGTKTOTTTNTRTMTCTVUGUAAEGBUSUYUMVIUZVUVAVEVNWFEHYEZMZWExample
""AF""
CreateCompanyOutput
Contains the response to the request to create a company.
Fields
company - Company!Example
{"company": Company}
CreateCompanyRoleOutput
Contains the response to the request to create a company role.
Fields
role - CompanyRole!Example
{"role": CompanyRole}
CreateCompanyTeamOutput
Contains the response to the request to create a company team.
Fields
team - CompanyTeam!Example
{"team": CompanyTeam}
CreateCompanyUserOutput
Contains the response to the request to create a company user.
Fields
user - Customer!Example
{"user": Customer}
CreateCompareListInput
Contains an array of product IDs to use for creating a compare list.
Input Fields
products - [ID]Example
{"products": [4]}
CreateGiftRegistryInput
Defines a new gift registry.
Input Fields
dynamic_attributes - [GiftRegistryDynamicAttributeInput]event_name - String!gift_registry_type_uid - ID!message - String!privacy_settings - GiftRegistryPrivacySettings!registrants - [AddGiftRegistryRegistrantInput]!shipping_address - GiftRegistryShippingAddressInputstatus - GiftRegistryStatus!Example
{
"dynamic_attributes": [
GiftRegistryDynamicAttributeInput
],
"event_name": "abc123",
"gift_registry_type_uid": 4,
"message": "abc123",
"privacy_settings": "PRIVATE",
"registrants": [AddGiftRegistryRegistrantInput],
"shipping_address": GiftRegistryShippingAddressInput,
"status": "ACTIVE"
}
CreateGiftRegistryOutput
Contains the results of a request to create a gift registry.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
CreateGuestCartInput
Input Fields
cart_uid - IDExample
{"cart_uid": 4}
CreateGuestCartOutput
Fields
cart - CartExample
{"cart": Cart}
CreatePaymentOrderInput
Contains payment order details that are used while processing the payment order
Input Fields
cartId - String!location - PaymentLocation!methodCode - String!paymentSource - String!vaultIntent - BooleanExample
{
"cartId": "xyz789",
"location": "PRODUCT_DETAIL",
"methodCode": "abc123",
"paymentSource": "abc123",
"vaultIntent": false
}
CreatePaymentOrderOutput
Contains payment order details that are used while processing the payment order
Fields
amount - Floatcurrency_code - Stringid - Stringmp_order_id - Stringstatus - StringExample
{
"amount": 123.45,
"currency_code": "xyz789",
"id": "abc123",
"mp_order_id": "abc123",
"status": "xyz789"
}
CreatePurchaseOrderApprovalRuleConditionAmountInput
Specifies the amount and currency to evaluate.
Input Fields
currency - CurrencyEnum!value - Float!Example
{"currency": "AFN", "value": 987.65}
CreatePurchaseOrderApprovalRuleConditionInput
Defines a set of conditions that apply to a rule.
Input Fields
attribute - PurchaseOrderApprovalRuleType!operator - PurchaseOrderApprovalRuleConditionOperator!quantity - IntExample
{
"amount": CreatePurchaseOrderApprovalRuleConditionAmountInput,
"attribute": "GRAND_TOTAL",
"operator": "MORE_THAN",
"quantity": 123
}
CreateRequisitionListInput
An input object that identifies and describes a new requisition list.
Input Fields
description - Stringname - String!Example
{
"description": "abc123",
"name": "xyz789"
}
CreateRequisitionListOutput
Output of the request to create a requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
CreateVaultCardPaymentTokenInput
Describe the variables needed to create a vault payment token
Input Fields
card_description - Stringsetup_token_id - String!Example
{
"card_description": "xyz789",
"setup_token_id": "xyz789"
}
CreateVaultCardPaymentTokenOutput
The vault token id and information about the payment source
Fields
payment_source - PaymentSourceOutput!vault_token_id - String!Example
{
"payment_source": PaymentSourceOutput,
"vault_token_id": "xyz789"
}
CreateVaultCardSetupTokenInput
Describe the variables needed to create a vault card setup token
Input Fields
setup_token - VaultSetupTokenInput!three_ds_mode - ThreeDSModeExample
{
"setup_token": VaultSetupTokenInput,
"three_ds_mode": "OFF"
}
CreateVaultCardSetupTokenOutput
The setup token id information
Fields
setup_token - String!Example
{"setup_token": "xyz789"}
CreateWishlistInput
Defines the name and visibility of a new wish list.
Input Fields
name - String!visibility - WishlistVisibilityEnum!Example
{"name": "abc123", "visibility": "PUBLIC"}
CreateWishlistOutput
Contains the wish list.
Fields
wishlist - Wishlist!Example
{"wishlist": Wishlist}
CreditMemo
Contains credit memo details.
Fields
comments - [SalesCommentItem]custom_attributes - [CustomAttribute]id - ID!items - [CreditMemoItemInterface]number - String!total - CreditMemoTotalExample
{
"comments": [SalesCommentItem],
"custom_attributes": [CustomAttribute],
"id": 4,
"items": [CreditMemoItemInterface],
"number": "xyz789",
"total": CreditMemoTotal
}
CreditMemoCustomAttributesInput
Defines a credit memo item's custom attributes.
Input Fields
credit_memo_id - String!custom_attributes - [CustomAttributeInput]Example
{
"credit_memo_id": "abc123",
"custom_attributes": [CustomAttributeInput]
}
CreditMemoItem
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatExample
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "abc123",
"product_sale_price": Money,
"product_sku": "xyz789",
"quantity_refunded": 987.65
}
CreditMemoItemCustomAttributesInput
Defines a credit memo's custom attributes.
Input Fields
credit_memo_id - String!credit_memo_item_id - String!custom_attributes - [CustomAttributeInput]Example
{
"credit_memo_id": "xyz789",
"credit_memo_item_id": "xyz789",
"custom_attributes": [CustomAttributeInput]
}
CreditMemoItemInterface
Credit memo item details.
Fields
custom_attributes - [CustomAttribute]discounts - [Discount]id - ID!order_item - OrderItemInterfaceproduct_name - Stringproduct_sale_price - Money!product_sku - String!quantity_refunded - FloatPossible Types
Example
{
"custom_attributes": [CustomAttribute],
"discounts": [Discount],
"id": 4,
"order_item": OrderItemInterface,
"product_name": "xyz789",
"product_sale_price": Money,
"product_sku": "xyz789",
"quantity_refunded": 123.45
}
CreditMemoOutput
Contains details about the credit memo after adding custom attributes to it.
Fields
credit_memo - CreditMemo!Example
{"credit_memo": CreditMemo}
CreditMemoTotal
Contains credit memo price details.
Fields
adjustment - Money!base_grand_total - Money!discounts - [Discount]grand_total - Money!shipping_handling - ShippingHandlingsubtotal - Money!taxes - [TaxItem]total_shipping - Money!total_tax - Money!Example
{
"adjustment": Money,
"base_grand_total": Money,
"discounts": [Discount],
"grand_total": Money,
"shipping_handling": ShippingHandling,
"subtotal": Money,
"taxes": [TaxItem],
"total_shipping": Money,
"total_tax": Money
}
Currency
Fields
available_currency_codes - [String]base_currency_code - Stringbase_currency_symbol - Stringdefault_display_currency_code - Stringdefault_display_currency_symbol - Stringexchange_rates - [ExchangeRate]Example
{
"available_currency_codes": ["abc123"],
"base_currency_code": "xyz789",
"base_currency_symbol": "xyz789",
"default_display_currency_code": "abc123",
"default_display_currency_symbol": "xyz789",
"exchange_rates": [ExchangeRate]
}
CurrencyEnum
The list of available currency codes.
Values
AFNALLAZNDZDAOAARSAMDAWGAUDBSDBHDBDTBBDBYNBZDBMDBTNBOBBAMBWPBRLGBPBNDBGNBUKBIFKHRCADCVECZKKYDGQECLPCNYCOPKMFCDFCRCHRKCUPDKKDJFDOPXCDEGPSVCERNEEKETBEURFKPFJDGMDGEKGELGHSGIPGTQGNFGYDHTGHNLHKDHUFISKINRIDRIRRIQDILSJMDJPYJODKZTKESKWDKGSLAKLVLLBPLSLLRDLYDLTLMOPMKDMGAMWKMYRMVRLSMMROMURMXNMDLMNTMADMZNMMKNADNPRANGNZDNICNGNKPWNOKOMRPKRPABPGKPYGPENPHPPLNQARRHDRONRUBRWFSHPSTDSARRSDSCRSLLSGDSKKSBDSOSZARKRWLKRSDGSRDSZLSEKCHFSYPTWDTJSTZSTHBTOPTTDTNDTMMUSDUGXUAHAEDUYUUZSVUVVEBVEFVNDCHECHWXOFWSTYERZMKZWDTRYAZMROLTRLXPFExample
""AFN""
CustomAttribute
Specifies the custom attribute code and value.
Fields
attribute_code - Stringvalue - StringExample
{
"attribute_code": "xyz789",
"value": "abc123"
}
CustomAttributeInput
Defines a custom attribute.
Input Fields
Example
{
"attribute_code": "abc123",
"value": "xyz789"
}
CustomAttributeMetadataInterface
An interface containing fields that define the EAV attribute.
Fields
code - ID!default_value - Stringentity_type - AttributeEntityTypeEnum!frontend_class - Stringfrontend_input - AttributeFrontendInputEnumis_required - Boolean!is_unique - Boolean!label - Stringoptions - [CustomAttributeOptionInterface]!Possible Types
Example
{
"code": "4",
"default_value": "abc123",
"entity_type": "CATALOG_PRODUCT",
"frontend_class": "xyz789",
"frontend_input": "BOOLEAN",
"is_required": false,
"is_unique": false,
"label": "abc123",
"options": [CustomAttributeOptionInterface]
}
CustomAttributeOptionInterface
Fields
is_default - Boolean!label - String!value - String!Possible Types
Example
{
"is_default": true,
"label": "xyz789",
"value": "abc123"
}
CustomConfigKeyValue
A simple key value object.
Fields
Example
{
"key": "abc123",
"value": "abc123"
}