CustomizableFileOption

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

Fields

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

Example

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

CustomizableFileValue

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

Fields

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

Example

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

CustomizableMultipleOption

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

Fields

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

Example

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

CustomizableMultipleValue

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

Fields

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

Example

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

CustomizableOptionInput

Defines a customizable option.

Input Fields

Input Field
Description
id - Int
The customizable option ID of the product.
value_string - String!
The string value of the option.

Example

{"id": 987, "value_string": "xyz789"}

CustomizableOptionInterface

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

Fields

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

Possible Types

Example

{
  "option_id": 123,
  "required": false,
  "sort_order": 987,
  "title": "abc123",
  "uid": "4"
}

CustomizableProductInterface

Contains information about customizable product options.

Fields

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

Possible Types

Example

{"options": [CustomizableOptionInterface]}

CustomizableRadioOption

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

Fields

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

Example

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

CustomizableRadioValue

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

Fields

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

Example

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

DeleteCompanyRoleOutput

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

Fields

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

Example

{"success": true}

DeleteCompanyTeamOutput

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

Fields

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

Example

{"success": true}

DeleteCompanyUserOutput

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

Fields

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

Example

{"success": true}

DeleteCompareListOutput

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

Fields

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

Example

{"result": true}

DeleteNegotiableQuoteError

Types

Example

NegotiableQuoteInvalidStateError

DeleteNegotiableQuoteOperationFailure

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

Fields

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

Example

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

DeleteNegotiableQuoteOperationResult

Types

Example

NegotiableQuoteUidOperationSuccess

DeleteNegotiableQuotesInput

Input Fields

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

Example

{"quote_uids": [4]}

DeleteNegotiableQuotesOutput

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

Fields

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

Example

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

DeletePaymentTokenOutput

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

Fields

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

Example

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

DeletePurchaseOrderApprovalRuleError

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

Fields

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

Example

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

DeletePurchaseOrderApprovalRuleErrorType

Values

Enum Value
Description
UNDEFINED
NOT_FOUND

Example

""UNDEFINED""

DeletePurchaseOrderApprovalRuleInput

Specifies the IDs of the approval rules to delete.

Input Fields

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

Example

{"approval_rule_uids": [4]}

DeletePurchaseOrderApprovalRuleOutput

Contains any errors encountered while attempting to delete approval rules.

Fields

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

Example

{"errors": [DeletePurchaseOrderApprovalRuleError]}

DeleteRequisitionListItemsOutput

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

Fields

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

Example

{"requisition_list": RequisitionList}

DeleteRequisitionListOutput

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

Fields

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

Example

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

DeleteWishlistOutput

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

Fields

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

Example

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

Discount

Defines an individual discount. A discount can be applied to the cart as a whole or to an item.

Fields

Field Name
Description
amount - Money!
The amount of the discount.
label - String!
A description of the discount.

Example

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

DownloadableCartItem

An implementation for downloadable product cart items.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
An array containing the customizable options the shopper selected.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use `uid` instead.)
links - [DownloadableProductLinks]
An array containing information about the links for the downloadable product added to the cart.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
samples - [DownloadableProductSamples]
An array containing information about samples of the selected downloadable product.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "errors": [CartItemError],
  "id": "xyz789",
  "links": [DownloadableProductLinks],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "samples": [DownloadableProductSamples],
  "uid": "4"
}

DownloadableCreditMemoItem

Defines downloadable product options for CreditMemoItemInterface.

Fields

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

Example

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

DownloadableFileTypeEnum

Values

Enum Value
Description
FILE
(Deprecated: `sample_url` serves to get the downloadable sample)
URL
(Deprecated: `sample_url` serves to get the downloadable sample)

Example

""FILE""

DownloadableInvoiceItem

Defines downloadable product options for InvoiceItemInterface.

Fields

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

Example

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

Defines characteristics of the links for downloadable product.

Fields

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

Example

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

DownloadableOrderItem

Defines downloadable product options for OrderItemInterface.

Fields

Field Name
Description
discounts - [Discount]
The final discount information for the product.
downloadable_links - [DownloadableItemsLinks]
A list of downloadable links that are ordered from the downloadable product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an `OrderItemInterface` object.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

{
  "discounts": [Discount],
  "downloadable_links": [DownloadableItemsLinks],
  "eligible_for_return": true,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "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_returned": 123.45,
  "quantity_shipped": 123.45,
  "selected_options": [OrderItemOption],
  "status": "xyz789"
}

DownloadableProduct

Defines a product that the shopper downloads.

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
downloadable_product_links - [DownloadableProductLinks]
An array containing information about the links for this downloadable product.
downloadable_product_samples - [DownloadableProductSamples]
An array containing information about samples of this downloadable product.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
links_purchased_separately - Int
A value of 1 indicates that each link in the array must be purchased separately.
links_title - String
The heading above the list of downloadable products.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)

Example

{
  "activity": "xyz789",
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "abc123",
  "collar": "xyz789",
  "color": 123,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "downloadable_product_links": [
    DownloadableProductLinks
  ],
  "downloadable_product_samples": [
    DownloadableProductSamples
  ],
  "eco_collection": 123,
  "erin_recommends": 987,
  "features_bags": "xyz789",
  "format": 123,
  "gender": "xyz789",
  "gift_message_available": "xyz789",
  "id": 123,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "links_purchased_separately": 123,
  "links_title": "xyz789",
  "manufacturer": 123,
  "material": "xyz789",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "name": "xyz789",
  "new": 987,
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 123.45,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "pattern": "xyz789",
  "performance_fabric": 123,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "xyz789",
  "review_count": 987,
  "reviews": ProductReviews,
  "sale": 987,
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "xyz789",
  "sleeve": "abc123",
  "small_image": ProductImage,
  "special_from_date": "abc123",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": true,
  "stock_status": "IN_STOCK",
  "strap_bags": "xyz789",
  "style_bags": "abc123",
  "style_bottom": "abc123",
  "style_general": "xyz789",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": 4,
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website]
}

DownloadableProductCartItemInput

Defines a single downloadable product.

Input Fields

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

Example

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

Defines characteristics of a downloadable product.

Fields

Field Name
Description
id - Int
(Deprecated: This information should not be exposed on frontend.)
is_shareable - Boolean
(Deprecated: This information should not be exposed on frontend.)
link_type - DownloadableFileTypeEnum
(Deprecated: `sample_url` serves to get the downloadable sample)
number_of_downloads - Int
(Deprecated: This information should not be exposed on frontend.)
price - Float
The price of the downloadable product.
sample_file - String
(Deprecated: `sample_url` serves to get the downloadable sample)
sample_type - DownloadableFileTypeEnum
(Deprecated: `sample_url` serves to get the downloadable sample)
sample_url - String
The full URL to the downloadable sample.
sort_order - Int
A number indicating the sort order.
title - String
The display name of the link.
uid - ID!
The unique ID for a `DownloadableProductLinks` object.

Example

{
  "id": 987,
  "is_shareable": true,
  "link_type": "FILE",
  "number_of_downloads": 987,
  "price": 123.45,
  "sample_file": "xyz789",
  "sample_type": "FILE",
  "sample_url": "abc123",
  "sort_order": 123,
  "title": "abc123",
  "uid": 4
}

DownloadableProductLinksInput

Contains the link ID for the downloadable product.

Input Fields

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

Example

{"link_id": 987}

DownloadableProductSamples

Defines characteristics of a downloadable product.

Fields

Field Name
Description
id - Int
(Deprecated: This information should not be exposed on frontend.)
sample_file - String
(Deprecated: `sample_url` serves to get the downloadable sample)
sample_type - DownloadableFileTypeEnum
(Deprecated: `sample_url` serves to get the downloadable sample)
sample_url - String
The full URL to the downloadable sample.
sort_order - Int
A number indicating the sort order.
title - String
The display name of the sample.

Example

{
  "id": 987,
  "sample_file": "xyz789",
  "sample_type": "FILE",
  "sample_url": "abc123",
  "sort_order": 123,
  "title": "abc123"
}

DownloadableRequisitionListItem

Contains details about downloadable products added to a requisition list.

Fields

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

Example

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

DownloadableWishlistItem

A downloadable product wish list item.

Fields

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

Example

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

DynamicBlock

Contains a single dynamic block.

Fields

Field Name
Description
content - ComplexTextValue!
The renderable HTML code of the dynamic block.
uid - ID!
The unique ID of a `DynamicBlock` object.

Example

{
  "content": ComplexTextValue,
  "uid": "4"
}

DynamicBlockLocationEnum

Indicates the locations the dynamic block can be placed. If this field is not specified, the query returns all locations.

Values

Enum Value
Description
CONTENT
HEADER
FOOTER
LEFT
RIGHT

Example

""CONTENT""

DynamicBlockTypeEnum

Indicates the selected Dynamic Blocks Rotator inline widget.

Values

Enum Value
Description
SPECIFIED
CART_PRICE_RULE_RELATED
CATALOG_PRICE_RULE_RELATED

Example

""SPECIFIED""

DynamicBlocks

Contains an array of dynamic blocks.

Fields

Field Name
Description
items - [DynamicBlock]!
An array containing individual dynamic blocks.
page_info - SearchResultPageInfo
Metadata for pagination rendering.
total_count - Int!
The number of returned dynamic blocks.

Example

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

DynamicBlocksFilterInput

Defines the dynamic block filter. The filter can identify the block type, location and IDs to return.

Input Fields

Input Field
Description
dynamic_block_uids - [ID]
An array of dynamic block UIDs to filter on.
locations - [DynamicBlockLocationEnum]
An array indicating the locations the dynamic block can be placed.
type - DynamicBlockTypeEnum!
A value indicating the type of dynamic block to filter on.

Example

{
  "dynamic_block_uids": ["4"],
  "locations": ["CONTENT"],
  "type": "SPECIFIED"
}

EnteredCustomAttributeInput

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

Input Fields

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

Example

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

EnteredOptionInput

Defines a customer-entered option.

Input Fields

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

Example

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

EntityUrl

Contains the uid, relative_url, and type attributes.

Fields

Field Name
Description
canonical_url - String
(Deprecated: Use `relative_url` instead.)
entity_uid - ID
The unique ID for a `ProductInterface`, `CategoryInterface`, `CmsPage`, or similar object associated with the specified URL. This could be a product, category, or CMS page UID.
id - Int
The ID assigned to the object associated with the specified url. This could be a product ID, category ID, or page ID. (Deprecated: Use `entity_uid` instead.)
redirectCode - Int
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.

Example

{
  "canonical_url": "abc123",
  "entity_uid": 4,
  "id": 123,
  "redirectCode": 123,
  "relative_url": "abc123",
  "type": "CMS_PAGE"
}

ErrorInterface

Fields

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

Possible Types

Example

{"message": "abc123"}

ExchangeRate

Lists the exchange rate.

Fields

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

Example

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

FilterEqualTypeInput

Defines a filter that matches the input exactly.

Input Fields

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

Example

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

FilterMatchTypeInput

Defines a filter that performs a fuzzy search.

Input Fields

Input Field
Description
match - String
Use this attribute to exactly match the specified string. For example, to filter on a specific SKU, specify a value such as `24-MB01`.

Example

{"match": "abc123"}

FilterRangeTypeInput

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

Input Fields

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

Example

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

FilterStringTypeInput

Defines a filter for an input string.

Input Fields

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

Example

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

FilterTypeInput

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

Input Fields

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

Example

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

FixedProductTax

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

Fields

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

Example

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

FixedProductTaxDisplaySettings

Lists display settings for the Fixed Product Tax.

Values

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

Example

""INCLUDE_FPT_WITHOUT_DETAILS""

Float

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

Example

123.45

GenerateCustomerTokenAsAdminInput

Identifies which customer requires remote shopping assistance.

Input Fields

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

Example

{"customer_email": "xyz789"}

GenerateCustomerTokenAsAdminOutput

Contains the generated customer token.

Fields

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

Example

{"customer_token": "xyz789"}

GiftCardAccount

Contains details about the gift card account.

Fields

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

Example

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

GiftCardAccountInput

Contains the gift card code.

Input Fields

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

Example

{"gift_card_code": "abc123"}

GiftCardAmounts

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

Fields

Field Name
Description
attribute_id - Int
An internal attribute ID.
uid - ID!
The unique ID for a `GiftCardAmounts` object.
value - Float
The value of the gift card.
value_id - Int
An ID that is assigned to each unique gift card amount. (Deprecated: Use `uid` instead)
website_id - Int
The ID of the website that generated the gift card.
website_value - Float
The value of the gift card.

Example

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

GiftCardCartItem

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

Fields

Field Name
Description
amount - Money!
The amount and currency of the gift card.
customizable_options - [SelectedCustomizableOption]!
An array of customizations applied to the gift card.
errors - [CartItemError]
An array of errors encountered while loading the cart item
id - String!
(Deprecated: Use `uid` instead.)
message - String
The message from the sender to the recipient.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart.
quantity - Float!
The quantity of this item in the cart.
recipient_email - String
The email address of the person receiving the gift card.
recipient_name - String!
The name of the person receiving the gift card.
sender_email - String
The email address of the sender.
sender_name - String!
The name of the sender.
uid - ID!
The unique ID for a `CartItemInterface` object.

Example

{
  "amount": Money,
  "customizable_options": [SelectedCustomizableOption],
  "errors": [CartItemError],
  "id": "abc123",
  "message": "abc123",
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 987.65,
  "recipient_email": "xyz789",
  "recipient_name": "abc123",
  "sender_email": "abc123",
  "sender_name": "xyz789",
  "uid": 4
}

GiftCardCreditMemoItem

Fields

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

Example

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

GiftCardInvoiceItem

Fields

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

Example

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

GiftCardItem

Contains details about a gift card.

Fields

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

Example

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

GiftCardOptions

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

Fields

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

Example

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

GiftCardOrderItem

Fields

Field Name
Description
discounts - [Discount]
The final discount information for the product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_card - GiftCardItem
Selected gift card properties for an order item.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an `OrderItemInterface` object.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

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

GiftCardProduct

Defines properties of a gift card.

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
allow_message - Boolean
Indicates whether the customer can provide a message to accompany the gift card.
allow_open_amount - Boolean
Indicates whether shoppers have the ability to set the value of the gift card.
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_card_options - [CustomizableOptionInterface]!
An array of customizable gift card options.
gift_message_available - String
Indicates whether a gift message is available.
giftcard_amounts - [GiftCardAmounts]
An array that contains information about the values and ID of a gift card.
giftcard_type - GiftCardTypeEnum
An enumeration that specifies the type of gift card.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_redeemable - Boolean
Indicates whether the customer can redeem the value on the card for cash.
is_returnable - String
Indicates whether the product can be returned.
lifetime - Int
The number of days after purchase until the gift card expires. A null value means there is no limit.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
message_max_length - Int
The maximum number of characters the gift message can contain.
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
open_amount_max - Float
The maximum acceptable value of an open amount gift card.
open_amount_min - Float
The minimum acceptable value of an open amount gift card.
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "activity": "abc123",
  "allow_message": true,
  "allow_open_amount": false,
  "attribute_set_id": 123,
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "category_gear": "abc123",
  "climate": "xyz789",
  "collar": "xyz789",
  "color": 123,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 123,
  "erin_recommends": 987,
  "features_bags": "abc123",
  "format": 987,
  "gender": "xyz789",
  "gift_card_options": [CustomizableOptionInterface],
  "gift_message_available": "abc123",
  "giftcard_amounts": [GiftCardAmounts],
  "giftcard_type": "VIRTUAL",
  "id": 987,
  "image": ProductImage,
  "is_redeemable": true,
  "is_returnable": "abc123",
  "lifetime": 123,
  "manufacturer": 987,
  "material": "abc123",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "message_max_length": 987,
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "abc123",
  "name": "xyz789",
  "new": 123,
  "new_from_date": "abc123",
  "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": "abc123",
  "pattern": "xyz789",
  "performance_fabric": 123,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 987,
  "rating_summary": 123.45,
  "redirect_code": 123,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 987,
  "reviews": ProductReviews,
  "sale": 987,
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "xyz789",
  "sleeve": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "xyz789",
  "staged": false,
  "stock_status": "IN_STOCK",
  "strap_bags": "abc123",
  "style_bags": "xyz789",
  "style_bottom": "xyz789",
  "style_general": "xyz789",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "xyz789",
  "uid": "4",
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website],
  "weight": 987.65
}

GiftCardRequisitionListItem

Contains details about gift cards added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
gift_card_options - GiftCardOptions!
An array that defines gift card properties.
product - ProductInterface!
Details about a requisition list item.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Example

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

GiftCardShipmentItem

Fields

Field Name
Description
gift_card - GiftCardItem
Selected gift card properties for a shipment item.
id - ID!
The unique ID for a `ShipmentItemInterface` object.
order_item - OrderItemInterface
The order item associated with the shipment item.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price for the base product.
product_sku - String!
The SKU of the base product.
quantity_shipped - Float!
The number of shipped items.

Example

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

GiftCardTypeEnum

Specifies the gift card type.

Values

Enum Value
Description
VIRTUAL
PHYSICAL
COMBINED

Example

""VIRTUAL""

GiftCardWishlistItem

A single gift card added to a wish list.

Fields

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

Example

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

GiftMessage

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

Fields

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

Example

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

GiftMessageInput

Defines a gift message.

Input Fields

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

Example

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

GiftOptionsPrices

Contains prices for gift wrapping options.

Fields

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

Example

{
  "gift_wrapping_for_items": Money,
  "gift_wrapping_for_order": Money,
  "printed_card": Money
}

GiftRegistry

Contains details about a gift registry.

Fields

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

Example

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

GiftRegistryDynamicAttribute

Fields

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

Example

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

GiftRegistryDynamicAttributeGroup

Defines the group type of a gift registry dynamic attribute.

Values

Enum Value
Description
EVENT_INFORMATION
PRIVACY_SETTINGS
REGISTRANT
GENERAL_INFORMATION
DETAILED_INFORMATION
SHIPPING_ADDRESS

Example

""EVENT_INFORMATION""

GiftRegistryDynamicAttributeInput

Defines a dynamic attribute.

Input Fields

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

Example

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

GiftRegistryDynamicAttributeInterface

Fields

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

Possible Types

GiftRegistryDynamicAttributeInterface Types
GiftRegistryRegistrantDynamicAttribute
GiftRegistryDynamicAttribute

Example

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

GiftRegistryDynamicAttributeMetadata

Fields

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

Example

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

GiftRegistryDynamicAttributeMetadataInterface

Fields

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

Possible Types

GiftRegistryDynamicAttributeMetadataInterface Types
GiftRegistryDynamicAttributeMetadata

Example

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

GiftRegistryItem

Fields

Field Name
Description
created_at - String!
The date the product was added to the gift registry.
note - String
A brief message about the gift registry item.
product - ProductInterface
Details about the gift registry item.
quantity - Float!
The requested quantity of the product.
quantity_fulfilled - Float!
The fulfilled quantity of the product.
uid - ID!
The unique ID of a gift registry item.

Example

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

GiftRegistryItemInterface

Fields

Field Name
Description
created_at - String!
The date the product was added to the gift registry.
note - String
A brief message about the gift registry item.
product - ProductInterface
Details about the gift registry item.
quantity - Float!
The requested quantity of the product.
quantity_fulfilled - Float!
The fulfilled quantity of the product.
uid - ID!
The unique ID of a gift registry item.

Possible Types

GiftRegistryItemInterface Types
GiftRegistryItem

Example

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

GiftRegistryItemUserErrorInterface

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

Fields

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

Possible Types

GiftRegistryItemUserErrorInterface Types
MoveCartItemsToGiftRegistryOutput

Example

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

GiftRegistryItemsUserError

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

Fields

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

Example

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

GiftRegistryItemsUserErrorType

Defines the error type.

Values

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

Example

""OUT_OF_STOCK""

GiftRegistryOutputInterface

Contains the customer's gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry.

Possible Types

GiftRegistryOutputInterface Types
MoveCartItemsToGiftRegistryOutput

Example

{"gift_registry": GiftRegistry}

GiftRegistryPrivacySettings

Defines the privacy setting of the gift registry.

Values

Enum Value
Description
PRIVATE
PUBLIC

Example

""PRIVATE""

GiftRegistryRegistrant

Contains details about a registrant.

Fields

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

Example

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

GiftRegistryRegistrantDynamicAttribute

Fields

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

Example

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

GiftRegistrySearchResult

Contains the results of a gift registry search.

Fields

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

Example

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

GiftRegistryShippingAddressInput

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

Input Fields

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

Example

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

GiftRegistryStatus

Defines the status of the gift registry.

Values

Enum Value
Description
ACTIVE
INACTIVE

Example

""ACTIVE""

GiftRegistryType

Contains details about a gift registry type.

Fields

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

Example

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

GiftWrapping

Contains details about the selected or available gift wrapping options.

Fields

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

Example

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

GiftWrappingImage

Points to an image associated with a gift wrapping option.

Fields

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

Example

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

GroupedProduct

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

Fields

Field Name
Description
activity - String
(Deprecated: Use the `custom_attributes` field instead.)
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
category_gear - String
(Deprecated: Use the `custom_attributes` field instead.)
climate - String
(Deprecated: Use the `custom_attributes` field instead.)
collar - String
(Deprecated: Use the `custom_attributes` field instead.)
color - Int
(Deprecated: Use the `custom_attributes` field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
eco_collection - Int
(Deprecated: Use the `custom_attributes` field instead.)
erin_recommends - Int
(Deprecated: Use the `custom_attributes` field instead.)
features_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
format - Int
(Deprecated: Use the `custom_attributes` field instead.)
gender - String
(Deprecated: Use the `custom_attributes` field instead.)
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the `uid` field instead.)
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
items - [GroupedProductItem]
An array containing grouped product items.
manufacturer - Int
A number representing the product's manufacturer. (Deprecated: Use the `custom_attributes` field instead.)
material - String
(Deprecated: Use the `custom_attributes` field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use `media_gallery` instead.)
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
name - String
The product name. Customers use this name to identify the product.
new - Int
(Deprecated: Use the `custom_attributes` field instead.)
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options_container - String
If the product has multiple options, determines where they appear on the product page.
pattern - String
(Deprecated: Use the `custom_attributes` field instead.)
performance_fabric - Int
(Deprecated: Use the `custom_attributes` field instead.)
price - ProductPrices
Indicates the price of an item. (Deprecated: Use `price_range` for product price information.)
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of `TierPrice` objects.
product_links - [ProductLinksInterface]
An array of `ProductLinks` objects.
purpose - Int
(Deprecated: Use the `custom_attributes` field instead.)
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
sale - Int
(Deprecated: Use the `custom_attributes` field instead.)
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
size - Int
(Deprecated: Use the `custom_attributes` field instead.)
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
sleeve - String
(Deprecated: Use the `custom_attributes` field instead.)
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
stock_status - ProductStockStatus
Stock status of the product
strap_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bags - String
(Deprecated: Use the `custom_attributes` field instead.)
style_bottom - String
(Deprecated: Use the `custom_attributes` field instead.)
style_general - String
(Deprecated: Use the `custom_attributes` field instead.)
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use `price_tiers` for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use `price_tiers` for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use `__typename` instead.)
uid - ID!
The unique ID for a `ProductInterface` object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's `canonical_url` or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)
weight - Float
The weight of the item, in units defined by the store.

Example

{
  "activity": "abc123",
  "attribute_set_id": 987,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "category_gear": "xyz789",
  "climate": "abc123",
  "collar": "xyz789",
  "color": 123,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "description": ComplexTextValue,
  "eco_collection": 123,
  "erin_recommends": 123,
  "features_bags": "abc123",
  "format": 987,
  "gender": "xyz789",
  "gift_message_available": "xyz789",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "abc123",
  "items": [GroupedProductItem],
  "manufacturer": 987,
  "material": "xyz789",
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "abc123",
  "meta_keyword": "xyz789",
  "meta_title": "abc123",
  "name": "xyz789",
  "new": 123,
  "new_from_date": "xyz789",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 123.45,
  "options_container": "xyz789",
  "pattern": "xyz789",
  "performance_fabric": 123,
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "purpose": 123,
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "abc123",
  "review_count": 123,
  "reviews": ProductReviews,
  "sale": 123,
  "short_description": ComplexTextValue,
  "size": 123,
  "sku": "abc123",
  "sleeve": "abc123",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 123.45,
  "special_to_date": "abc123",
  "staged": true,
  "stock_status": "IN_STOCK",
  "strap_bags": "xyz789",
  "style_bags": "abc123",
  "style_bottom": "xyz789",
  "style_general": "xyz789",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "tier_price": 987.65,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": "4",
  "updated_at": "abc123",
  "upsell_products": [ProductInterface],
  "url_key": "xyz789",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "xyz789",
  "websites": [Website],
  "weight": 123.45
}

GroupedProductItem

Contains information about an individual grouped product item.

Fields

Field Name
Description
position - Int
The relative position of this item compared to the other group items.
product - ProductInterface
Details about this product option.
qty - Float
The quantity of this grouped product item.

Example

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

GroupedProductWishlistItem

A grouped product wish list item.

Fields

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

Example

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

HostedProInput

Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Payments Pro Hosted Solution payment method.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. For example, if the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
return_url - String!
The relative URL of the final confirmation page that PayPal redirects to upon payment success. For example, if the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.

Example

{
  "cancel_url": "xyz789",
  "return_url": "abc123"
}

HostedProUrl

Contains the secure URL used for the Payments Pro Hosted Solution payment method.

Fields

Field Name
Description
secure_form_url - String
The secure URL generated by PayPal.

Example

{"secure_form_url": "xyz789"}

HostedProUrlInput

Contains the required input to request the secure URL for Payments Pro Hosted Solution payment.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.

Example

{"cart_id": "xyz789"}

HttpQueryParameter

Contains target path parameters.

Fields

Field Name
Description
name - String
A parameter name.
value - String
A parameter value.

Example

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

ID

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

Example

4

ImageSwatchData

Fields

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

Example

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

Int

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

Example

987

InternalError

Contains an error message when an internal error occurred.

Fields

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

Example

{"message": "abc123"}

Invoice

Contains invoice details.

Fields

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

Example

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

InvoiceItem

Fields

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

Example

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

InvoiceItemInterface

Contains detailes about invoiced items.

Fields

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

Possible Types

Example

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

InvoiceTotal

Contains price details from an invoice.

Fields

Field Name
Description
base_grand_total - Money!
The final base grand total amount in the base currency.
discounts - [Discount]
The applied discounts to the invoice.
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the invoice.
subtotal - Money!
The subtotal of the invoice, excluding shipping, discounts, and taxes.
taxes - [TaxItem]
The invoice tax details.
total_shipping - Money!
The shipping amount for the invoice.
total_tax - Money!
The amount of tax applied to the invoice.

Example

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

IsCompanyAdminEmailAvailableOutput

Contains the response of a company admin email validation query.

Fields

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

Example

{"is_email_available": false}

IsCompanyEmailAvailableOutput

Contains the response of a company email validation query.

Fields

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

Example

{"is_email_available": true}

IsCompanyRoleNameAvailableOutput

Contains the response of a role name validation query.

Fields

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

Example

{"is_role_name_available": false}

IsCompanyUserEmailAvailableOutput

Contains the response of a company user email validation query.

Fields

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

Example

{"is_email_available": true}

IsEmailAvailableOutput

Contains the result of the isEmailAvailable query.

Fields

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

Example

{"is_email_available": false}

ItemSelectedBundleOption

A list of options of the selected bundle product.

Fields

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

Example

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

ItemSelectedBundleOptionValue

A list of values for the selected bundle product.

Fields

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

Example

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

KeyValue

Contains a key-value pair.

Fields

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

Example

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

LayerFilter

Contains information for rendering layered navigation.

Fields

Field Name
Description
filter_items - [LayerFilterItemInterface]
An array of filter items. (Deprecated: Use `Aggregation.options` instead.)
filter_items_count - Int
The count of filter items in filter group. (Deprecated: Use `Aggregation.count` instead.)
name - String
The name of a layered navigation filter. (Deprecated: Use `Aggregation.label` instead.)
request_var - String
The request variable name for a filter query. (Deprecated: Use `Aggregation.attribute_code` instead.)

Example

{
  "filter_items": [LayerFilterItemInterface],
  "filter_items_count": 123,
  "name": "abc123",
  "request_var": "abc123"
}

LayerFilterItem

Fields

Field Name
Description
items_count - Int
The count of items per filter. (Deprecated: Use `AggregationOption.count` instead.)
label - String
The label for a filter. (Deprecated: Use `AggregationOption.label` instead.)
value_string - String
The value of a filter request variable to be used in query. (Deprecated: Use `AggregationOption.value` instead.)

Example

{
  "items_count": 123,
  "label": "abc123",
  "value_string": "xyz789"
}

LayerFilterItemInterface

Fields

Field Name
Description
items_count - Int
The count of items per filter. (Deprecated: Use `AggregationOption.count` instead.)
label - String
The label for a filter. (Deprecated: Use `AggregationOption.label` instead.)
value_string - String
The value of a filter request variable to be used in query. (Deprecated: Use `AggregationOption.value` instead.)

Possible Types

LayerFilterItemInterface Types
LayerFilterItem
SwatchLayerFilterItem

Example

{
  "items_count": 987,
  "label": "abc123",
  "value_string": "xyz789"
}

MediaGalleryEntry

Defines characteristics about images and videos associated with a specific product.

Fields

Field Name
Description
content - ProductMediaGalleryEntriesContent
Details about the content of the media gallery item.
disabled - Boolean
Indicates whether the image is hidden from view.
file - String
The path of the image on the server.
id - Int
The identifier assigned to the object. (Deprecated: Use `uid` instead.)
label - String
The alt text displayed on the storefront when the user points to the image.
media_type - String
Either `image` or `video`.
position - Int
The media item's position after it has been sorted.
types - [String]
Array of image types. It can have the following values: image, small_image, thumbnail.
uid - ID!
The unique ID for a `MediaGalleryEntry` object.
video_content - ProductMediaGalleryEntriesVideoContent
Details about the content of a video item.

Example

{
  "content": ProductMediaGalleryEntriesContent,
  "disabled": false,
  "file": "xyz789",
  "id": 123,
  "label": "xyz789",
  "media_type": "abc123",
  "position": 987,
  "types": ["abc123"],
  "uid": "4",
  "video_content": ProductMediaGalleryEntriesVideoContent
}

MediaGalleryInterface

Contains basic information about a product image or video.

Fields

Field Name
Description
disabled - Boolean
Indicates whether the image is hidden from view.
label - String
The label of the product image or video.
position - Int
The media item's position after it has been sorted.
url - String
The URL of the product image or video.

Possible Types

MediaGalleryInterface Types
ProductImage
ProductVideo

Example

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

Money

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

Fields

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

Example

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

MoveCartItemsToGiftRegistryOutput

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

Fields

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

Example

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

MoveItemsBetweenRequisitionListsInput

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

Input Fields

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

Example

{"requisitionListItemUids": [4]}

MoveItemsBetweenRequisitionListsOutput

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

Fields

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

Example

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

MoveProductsBetweenWishlistsOutput

Contains the source and target wish lists after moving products.

Fields

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

Example

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

NegotiableQuote

Contains details about a negotiable quote.

Fields

Field Name
Description
available_payment_methods - [AvailablePaymentMethod]
An array of payment methods that can be applied to the negotiable quote.
billing_address - NegotiableQuoteBillingAddress
The billing address applied to the negotiable quote.
buyer - NegotiableQuoteUser!
The first and last name of the buyer.
comments - [NegotiableQuoteComment]
A list of comments made by the buyer and seller.
created_at - String
Timestamp indicating when the negotiable quote was created.
email - String
The email address of the company user.
history - [NegotiableQuoteHistoryEntry]
A list of status and price changes for the negotiable quote.
is_virtual - Boolean!
Indicates whether the negotiable quote contains only virtual products.
items - [CartItemInterface]
The list of items in the negotiable quote.
name - String!
The title assigned to the negotiable quote.
prices - CartPrices
A set of subtotals and totals applied to the negotiable quote.
selected_payment_method - SelectedPaymentMethod
The payment method that was applied to the negotiable quote.
shipping_addresses - [NegotiableQuoteShippingAddress]!
A list of shipping addresses applied to the negotiable quote.
status - NegotiableQuoteStatus!
The status of the negotiable quote.
total_quantity - Float!
The total number of items in the negotiable quote.
uid - ID!
The unique ID of a `NegotiableQuote` object.
updated_at - String
Timestamp indicating when the negotiable quote was updated.

Example

{
  "available_payment_methods": [AvailablePaymentMethod],
  "billing_address": NegotiableQuoteBillingAddress,
  "buyer": NegotiableQuoteUser,
  "comments": [NegotiableQuoteComment],
  "created_at": "xyz789",
  "email": "xyz789",
  "history": [NegotiableQuoteHistoryEntry],
  "is_virtual": true,
  "items": [CartItemInterface],
  "name": "abc123",
  "prices": CartPrices,
  "selected_payment_method": SelectedPaymentMethod,
  "shipping_addresses": [NegotiableQuoteShippingAddress],
  "status": "SUBMITTED",
  "total_quantity": 123.45,
  "uid": 4,
  "updated_at": "abc123"
}

NegotiableQuoteAddressCountry

Defines the company's country.

Fields

Field Name
Description
code - String!
The address country code.
label - String!
The display name of the region.

Example

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

NegotiableQuoteAddressInput

Defines the billing or shipping address to be applied to the cart.

Input Fields

Input Field
Description
city - String!
The city specified for the billing or shipping address.
company - String
The company name.
country_code - String!
The country code and label for the billing or shipping address.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The ZIP or postal code of the billing or shipping address.
region - String
A string that defines the state or province of the billing or shipping address.
region_id - Int
An integer that defines the state or province of the billing or shipping address.
save_in_address_book - Boolean
Determines whether to save the address in the customer's address book. The default value is true.
street - [String]!
An array containing the street for the billing or shipping address.
telephone - String
The telephone number for the billing or shipping address.

Example

{
  "city": "abc123",
  "company": "xyz789",
  "country_code": "abc123",
  "firstname": "xyz789",
  "lastname": "abc123",
  "postcode": "abc123",
  "region": "xyz789",
  "region_id": 123,
  "save_in_address_book": false,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

NegotiableQuoteAddressInterface

Fields

Field Name
Description
city - String!
The company's city or town.
company - String
The company name associated with the shipping/billing address.
country - NegotiableQuoteAddressCountry!
The company's country.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The company's ZIP or postal code.
region - NegotiableQuoteAddressRegion
An object containing the region name, region code, and region ID.
street - [String]!
An array of strings that define the street number and name.
telephone - String
The customer's telephone number.

Possible Types

NegotiableQuoteAddressInterface Types
NegotiableQuoteShippingAddress
NegotiableQuoteBillingAddress

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country": NegotiableQuoteAddressCountry,
  "firstname": "xyz789",
  "lastname": "xyz789",
  "postcode": "xyz789",
  "region": NegotiableQuoteAddressRegion,
  "street": ["abc123"],
  "telephone": "abc123"
}

NegotiableQuoteAddressRegion

Defines the company's state or province.

Fields

Field Name
Description
code - String
The address region code.
label - String
The display name of the region.
region_id - Int
The unique ID for a pre-defined region.

Example

{
  "code": "abc123",
  "label": "xyz789",
  "region_id": 123
}

NegotiableQuoteBillingAddress

Fields

Field Name
Description
city - String!
The company's city or town.
company - String
The company name associated with the shipping/billing address.
country - NegotiableQuoteAddressCountry!
The company's country.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The company's ZIP or postal code.
region - NegotiableQuoteAddressRegion
An object containing the region name, region code, and region ID.
street - [String]!
An array of strings that define the street number and name.
telephone - String
The customer's telephone number.

Example

{
  "city": "xyz789",
  "company": "xyz789",
  "country": NegotiableQuoteAddressCountry,
  "firstname": "abc123",
  "lastname": "xyz789",
  "postcode": "abc123",
  "region": NegotiableQuoteAddressRegion,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

NegotiableQuoteBillingAddressInput

Defines the billing address.

Input Fields

Input Field
Description
address - NegotiableQuoteAddressInput
Defines a billing address.
customer_address_uid - ID
The unique ID of a `CustomerAddress` object.
same_as_shipping - Boolean
Indicates whether to set the billing address to be the same as the existing shipping address on the negotiable quote.
use_for_shipping - Boolean
Indicates whether to set the shipping address to be the same as this billing address.

Example

{
  "address": NegotiableQuoteAddressInput,
  "customer_address_uid": 4,
  "same_as_shipping": false,
  "use_for_shipping": true
}

NegotiableQuoteComment

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

Fields

Field Name
Description
author - NegotiableQuoteUser!
The first and last name of the commenter.
created_at - String!
Timestamp indicating when the comment was created.
creator_type - NegotiableQuoteCommentCreatorType!
Indicates whether a buyer or seller commented.
text - String!
The plain text comment.
uid - ID!
The unique ID of a `NegotiableQuoteComment` object.

Example

{
  "author": NegotiableQuoteUser,
  "created_at": "xyz789",
  "creator_type": "BUYER",
  "text": "abc123",
  "uid": "4"
}

NegotiableQuoteCommentCreatorType

Values

Enum Value
Description
BUYER
SELLER

Example

""BUYER""

NegotiableQuoteCommentInput

Contains the commend provided by the buyer.

Input Fields

Input Field
Description
comment - String!
The comment provided by the buyer.

Example

{"comment": "xyz789"}

NegotiableQuoteCustomLogChange

Contains custom log entries added by third-party extensions.

Fields

Field Name
Description
new_value - String!
The new entry content.
old_value - String
The previous entry in the custom log.
title - String!
The title of the custom log entry.

Example

{
  "new_value": "xyz789",
  "old_value": "abc123",
  "title": "xyz789"
}

NegotiableQuoteFilterInput

Defines a filter to limit the negotiable quotes to return.

Input Fields

Input Field
Description
ids - FilterEqualTypeInput
Filter by the ID of one or more negotiable quotes.
name - FilterMatchTypeInput
Filter by the negotiable quote name.

Example

{
  "ids": FilterEqualTypeInput,
  "name": FilterMatchTypeInput
}

NegotiableQuoteHistoryChanges

Contains a list of changes to a negotiable quote.

Fields

Field Name
Description
comment_added - NegotiableQuoteHistoryCommentChange
The comment provided with a change in the negotiable quote history.
custom_changes - NegotiableQuoteCustomLogChange
Lists log entries added by third-party extensions.
expiration - NegotiableQuoteHistoryExpirationChange
The expiration date of the negotiable quote before and after a change in the quote history.
products_removed - NegotiableQuoteHistoryProductsRemovedChange
Lists products that were removed as a result of a change in the quote history.
statuses - NegotiableQuoteHistoryStatusesChange
The status before and after a change in the negotiable quote history.
total - NegotiableQuoteHistoryTotalChange
The total amount of the negotiable quote before and after a change in the quote history.

Example

{
  "comment_added": NegotiableQuoteHistoryCommentChange,
  "custom_changes": NegotiableQuoteCustomLogChange,
  "expiration": NegotiableQuoteHistoryExpirationChange,
  "products_removed": NegotiableQuoteHistoryProductsRemovedChange,
  "statuses": NegotiableQuoteHistoryStatusesChange,
  "total": NegotiableQuoteHistoryTotalChange
}

NegotiableQuoteHistoryCommentChange

Contains a comment submitted by a seller or buyer.

Fields

Field Name
Description
comment - String!
A plain text comment submitted by a seller or buyer.

Example

{"comment": "abc123"}

NegotiableQuoteHistoryEntry

Contains details about a change for a negotiable quote.

Fields

Field Name
Description
author - NegotiableQuoteUser!
The person who made a change in the status of the negotiable quote.
change_type - NegotiableQuoteHistoryEntryChangeType!
An enum that describes the why the entry in the negotiable quote history changed status.
changes - NegotiableQuoteHistoryChanges
The set of changes in the negotiable quote.
created_at - String
Timestamp indicating when the negotiable quote entry was created.
uid - ID!
The unique ID of a `NegotiableQuoteHistoryEntry` object.

Example

{
  "author": NegotiableQuoteUser,
  "change_type": "CREATED",
  "changes": NegotiableQuoteHistoryChanges,
  "created_at": "abc123",
  "uid": "4"
}

NegotiableQuoteHistoryEntryChangeType

Values

Enum Value
Description
CREATED
UPDATED
CLOSED
UPDATED_BY_SYSTEM

Example

""CREATED""

NegotiableQuoteHistoryExpirationChange

Contains a new expiration date and the previous date.

Fields

Field Name
Description
new_expiration - String
The expiration date after the change. The value will be 'null' if not set.
old_expiration - String
The previous expiration date. The value will be 'null' if not previously set.

Example

{
  "new_expiration": "xyz789",
  "old_expiration": "abc123"
}

NegotiableQuoteHistoryProductsRemovedChange

Contains lists of products that have been removed from the catalog and negotiable quote.

Fields

Field Name
Description
products_removed_from_catalog - [ID]
A list of product IDs the seller removed from the catalog.
products_removed_from_quote - [ProductInterface]
A list of products removed from the negotiable quote by either the buyer or the seller.

Example

{
  "products_removed_from_catalog": [4],
  "products_removed_from_quote": [ProductInterface]
}

NegotiableQuoteHistoryStatusChange

Lists a new status change applied to a negotiable quote and the previous status.

Fields

Field Name
Description
new_status - NegotiableQuoteStatus!
The updated status.
old_status - NegotiableQuoteStatus
The previous status. The value will be null for the first history entry in a negotiable quote.

Example

{"new_status": "SUBMITTED", "old_status": "SUBMITTED"}

NegotiableQuoteHistoryStatusesChange

Contains a list of status changes that occurred for the negotiable quote.

Fields

Field Name
Description
changes - [NegotiableQuoteHistoryStatusChange]!
A list of status changes.

Example

{"changes": [NegotiableQuoteHistoryStatusChange]}

NegotiableQuoteHistoryTotalChange

Contains a new price and the previous price.

Fields

Field Name
Description
new_price - Money
The total price as a result of the change.
old_price - Money
The previous total price on the negotiable quote.

Example

{
  "new_price": Money,
  "old_price": Money
}

NegotiableQuoteInvalidStateError

An error indicating that an operation was attempted on a negotiable quote in an invalid state.

Fields

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

Example

{"message": "abc123"}

NegotiableQuoteItemQuantityInput

Specifies the updated quantity of an item.

Input Fields

Input Field
Description
quantity - Float!
The new quantity of the negotiable quote item.
quote_item_uid - ID!
The unique ID of a `CartItemInterface` object.

Example

{"quantity": 987.65, "quote_item_uid": 4}

NegotiableQuotePaymentMethodInput

Defines the payment method to be applied to the negotiable quote.

Input Fields

Input Field
Description
code - String!
Payment method code
purchase_order_number - String
The purchase order number. Optional for most payment methods.

Example

{
  "code": "xyz789",
  "purchase_order_number": "abc123"
}

NegotiableQuoteShippingAddress

Fields

Field Name
Description
available_shipping_methods - [AvailableShippingMethod]
An array of shipping methods available to the buyer.
city - String!
The company's city or town.
company - String
The company name associated with the shipping/billing address.
country - NegotiableQuoteAddressCountry!
The company's country.
firstname - String!
The first name of the company user.
lastname - String!
The last name of the company user.
postcode - String
The company's ZIP or postal code.
region - NegotiableQuoteAddressRegion
An object containing the region name, region code, and region ID.
selected_shipping_method - SelectedShippingMethod
The selected shipping method.
street - [String]!
An array of strings that define the street number and name.
telephone - String
The customer's telephone number.

Example

{
  "available_shipping_methods": [AvailableShippingMethod],
  "city": "xyz789",
  "company": "xyz789",
  "country": NegotiableQuoteAddressCountry,
  "firstname": "xyz789",
  "lastname": "xyz789",
  "postcode": "abc123",
  "region": NegotiableQuoteAddressRegion,
  "selected_shipping_method": SelectedShippingMethod,
  "street": ["xyz789"],
  "telephone": "xyz789"
}

NegotiableQuoteShippingAddressInput

Defines shipping addresses for the negotiable quote.

Input Fields

Input Field
Description
address - NegotiableQuoteAddressInput
A shipping address.
customer_address_uid - ID
An ID from the company user's address book that uniquely identifies the address to be used for shipping.
customer_notes - String
Text provided by the company user.

Example

{
  "address": NegotiableQuoteAddressInput,
  "customer_address_uid": "4",
  "customer_notes": "abc123"
}

NegotiableQuoteSortInput

Defines the field to use to sort a list of negotiable quotes.

Input Fields

Input Field
Description
sort_direction - SortEnum!
Whether to return results in ascending or descending order.
sort_field - NegotiableQuoteSortableField!
The specified sort field.

Example

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

NegotiableQuoteSortableField

Values

Enum Value
Description
QUOTE_NAME
Sorts negotiable quotes by name.
CREATED_AT
Sorts negotiable quotes by the dates they were created.
UPDATED_AT
Sorts negotiable quotes by the dates they were last modified.

Example

""QUOTE_NAME""

NegotiableQuoteStatus

Values

Enum Value
Description
SUBMITTED
PENDING
UPDATED
OPEN
ORDERED
CLOSED
DECLINED
EXPIRED

Example

""SUBMITTED""

NegotiableQuoteUidNonFatalResultInterface

Fields

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

Possible Types

NegotiableQuoteUidNonFatalResultInterface Types
NegotiableQuoteUidOperationSuccess

Example

{"quote_uid": "4"}

NegotiableQuoteUidOperationSuccess

Contains details about a successful operation on a negotiable quote.

Fields

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

Example

{"quote_uid": 4}

NegotiableQuoteUser

A limited view of a Buyer or Seller in the negotiable quote process.

Fields

Field Name
Description
firstname - String!
The first name of the buyer or seller making a change.
lastname - String!
The buyer's or seller's last name.

Example

{
  "firstname": "abc123",
  "lastname": "abc123"
}

NegotiableQuotesOutput

Contains a list of negotiable that match the specified filter.

Fields

Field Name
Description
items - [NegotiableQuote]!
A list of negotiable quotes
page_info - SearchResultPageInfo!
Contains pagination metadata
sort_fields - SortFields
Contains the default sort field and all available sort fields.
total_count - Int!
The number of negotiable quotes returned

Example

{
  "items": [NegotiableQuote],
  "page_info": SearchResultPageInfo,
  "sort_fields": SortFields,
  "total_count": 987
}

NoSuchEntityUidError

Contains an error message when an invalid UID was specified.

Fields

Field Name
Description
message - String!
The returned error message.
uid - ID!
The specified invalid unique ID of an object.

Example

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

Order

Contains the order ID.

Fields

Field Name
Description
order_id - String
(Deprecated: Use `order_number` instead.)
order_number - String!
The unique ID for an `Order` object.

Example

{
  "order_id": "xyz789",
  "order_number": "abc123"
}

OrderAddress

Contains detailed information about an order's billing and shipping addresses.

Fields

Field Name
Description
city - String!
The city or town.
company - String
The customer's company.
country_code - CountryCodeEnum
The customer's country.
fax - String
The fax number.
firstname - String!
The first name of the person associated with the shipping/billing address.
lastname - String!
The family name of the person associated with the shipping/billing address.
middlename - String
The middle name of the person associated with the shipping/billing address.
postcode - String
The customer's ZIP or postal code.
prefix - String
An honorific, such as Dr., Mr., or Mrs.
region - String
The state or province name.
region_id - ID
The unique ID for a `Region` object of a pre-defined region.
street - [String]!
An array of strings that define the street number and name.
suffix - String
A value such as Sr., Jr., or III.
telephone - String
The telephone number.
vat_id - String
The customer's Value-added tax (VAT) number (for corporate customers).

Example

{
  "city": "xyz789",
  "company": "abc123",
  "country_code": "AF",
  "fax": "xyz789",
  "firstname": "abc123",
  "lastname": "xyz789",
  "middlename": "abc123",
  "postcode": "xyz789",
  "prefix": "abc123",
  "region": "abc123",
  "region_id": 4,
  "street": ["xyz789"],
  "suffix": "xyz789",
  "telephone": "abc123",
  "vat_id": "xyz789"
}

OrderItem

Fields

Field Name
Description
discounts - [Discount]
The final discount information for the product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an `OrderItemInterface` object.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Example

{
  "discounts": [Discount],
  "eligible_for_return": false,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": 4,
  "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": 123.45,
  "quantity_refunded": 123.45,
  "quantity_returned": 123.45,
  "quantity_shipped": 987.65,
  "selected_options": [OrderItemOption],
  "status": "xyz789"
}

OrderItemInterface

Order item details.

Fields

Field Name
Description
discounts - [Discount]
The final discount information for the product.
eligible_for_return - Boolean
Indicates whether the order item is eligible to be in a return request.
entered_options - [OrderItemOption]
The entered option for the base product, such as a logo or image.
gift_message - GiftMessage
The selected gift message for the order item
gift_wrapping - GiftWrapping
The selected gift wrapping for the order item.
id - ID!
The unique ID for an `OrderItemInterface` object.
product_name - String
The name of the base product.
product_sale_price - Money!
The sale price of the base product, including selected options.
product_sku - String!
The SKU of the base product.
product_type - String
The type of product, such as simple, configurable, etc.
product_url_key - String
URL key of the base product.
quantity_canceled - Float
The number of canceled items.
quantity_invoiced - Float
The number of invoiced items.
quantity_ordered - Float
The number of units ordered for this item.
quantity_refunded - Float
The number of refunded items.
quantity_returned - Float
The number of returned items.
quantity_shipped - Float
The number of shipped items.
selected_options - [OrderItemOption]
The selected options for the base product, such as color or size.
status - String
The status of the order item.

Possible Types

Example

{
  "discounts": [Discount],
  "eligible_for_return": false,
  "entered_options": [OrderItemOption],
  "gift_message": GiftMessage,
  "gift_wrapping": GiftWrapping,
  "id": "4",
  "product_name": "abc123",
  "product_sale_price": Money,
  "product_sku": "xyz789",
  "product_type": "xyz789",
  "product_url_key": "abc123",
  "quantity_canceled": 987.65,
  "quantity_invoiced": 987.65,
  "quantity_ordered": 987.65,
  "quantity_refunded": 123.45,
  "quantity_returned": 987.65,
  "quantity_shipped": 123.45,
  "selected_options": [OrderItemOption],
  "status": "abc123"
}

OrderItemOption

Represents order item options like selected or entered.

Fields

Field Name
Description
label - String!
The name of the option.
value - String!
The value of the option.

Example

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

OrderPaymentMethod

Contains details about the payment method used to pay for the order.

Fields

Field Name
Description
additional_data - [KeyValue]
Additional data per payment method type.
name - String!
The label that describes the payment method.
type - String!
The payment method code that indicates how the order was paid for.

Example

{
  "additional_data": [KeyValue],
  "name": "abc123",
  "type": "xyz789"
}

OrderShipment

Contains order shipment details.

Fields

Field Name
Description
comments - [SalesCommentItem]
Comments added to the shipment.
id - ID!
The unique ID for a `OrderShipment` object.
items - [ShipmentItemInterface]
An array of items included in the shipment.
number - String!
The sequential credit shipment number.
tracking - [ShipmentTracking]
An array of shipment tracking details.

Example

{
  "comments": [SalesCommentItem],
  "id": 4,
  "items": [ShipmentItemInterface],
  "number": "xyz789",
  "tracking": [ShipmentTracking]
}

OrderTotal

Contains details about the sales total amounts used to calculate the final price.

Fields

Field Name
Description
base_grand_total - Money!
The final base grand total amount in the base currency.
discounts - [Discount]
The applied discounts to the order.
grand_total - Money!
The final total amount, including shipping, discounts, and taxes.
shipping_handling - ShippingHandling
Details about the shipping and handling costs for the order.
subtotal - Money!
The subtotal of the order, excluding shipping, discounts, and taxes.
taxes - [TaxItem]
The order tax details.
total_giftcard - Money
The gift card balance applied to the order.
total_shipping - Money!
The shipping amount for the order.
total_tax - Money!
The amount of tax applied to the order.

Example

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

PayflowExpressInput

Contains required input for Payflow Express Checkout payments.

Input Fields

Input Field
Description
payer_id - String!
The unique ID of the PayPal user.
token - String!
The token returned by the createPaypalExpressToken mutation.

Example

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

PayflowLinkInput

A set of relative URLs that PayPal uses in response to various actions during the authorization process. Adobe Commerce prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Payflow Link and Payments Advanced payment methods.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
error_url - String!
The relative URL of the transaction error page that PayPal redirects to upon payment error. If the full URL to this page is https://www.example.com/paypal/action/error.html, the relative URL is paypal/action/error.html.
return_url - String!
The relative URL of the order confirmation page that PayPal redirects to when the payment is successful and additional confirmation is not needed. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.

Example

{
  "cancel_url": "xyz789",
  "error_url": "abc123",
  "return_url": "abc123"
}

PayflowLinkMode

Indicates the mode for payment. Applies to the Payflow Link and Payments Advanced payment methods.

Values

Enum Value
Description
TEST
LIVE

Example

""TEST""

PayflowLinkToken

Contains information used to generate PayPal iframe for transaction. Applies to Payflow Link and Payments Advanced payment methods.

Fields

Field Name
Description
mode - PayflowLinkMode
The mode for the Payflow transaction.
paypal_url - String
The PayPal URL used for requesting a Payflow form.
secure_token - String
The secure token generated by PayPal.
secure_token_id - String
The secure token ID generated by PayPal.

Example

{
  "mode": "TEST",
  "paypal_url": "abc123",
  "secure_token": "abc123",
  "secure_token_id": "xyz789"
}

PayflowLinkTokenInput

Contains information required to fetch payment token information for the Payflow Link and Payments Advanced payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.

Example

{"cart_id": "abc123"}

PayflowProInput

Contains input for the Payflow Pro and Payments Pro payment methods.

Input Fields

Input Field
Description
cc_details - CreditCardDetailsInput!
Required input for credit card related information.
is_active_payment_token_enabler - Boolean
Indicates whether details about the shopper's credit/debit card should be tokenized for later usage. Required only if Vault is enabled for the PayPal Payflow Pro payment integration.

Example

{
  "cc_details": CreditCardDetailsInput,
  "is_active_payment_token_enabler": true
}

PayflowProResponseInput

Input required to complete payment. Applies to Payflow Pro and Payments Pro payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.
paypal_payload - String!
The payload returned from PayPal.

Example

{
  "cart_id": "abc123",
  "paypal_payload": "abc123"
}

PayflowProResponseOutput

Fields

Field Name
Description
cart - Cart!
The cart with the updated selected payment method.

Example

{"cart": Cart}

PayflowProTokenInput

Contains input required to fetch payment token information for the Payflow Pro and Payments Pro payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the shopper's cart.
urls - PayflowProUrlInput!
A set of relative URLs that PayPal uses for callback.

Example

{
  "cart_id": "abc123",
  "urls": PayflowProUrlInput
}

PayflowProUrlInput

Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for the Payflow Pro and Payment Pro payment methods.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
error_url - String!
The relative URL of the transaction error page that PayPal redirects to upon payment error. If the full URL to this page is https://www.example.com/paypal/action/error.html, the relative URL is paypal/action/error.html.
return_url - String!
The relative URL of the final confirmation page that PayPal redirects to upon payment success. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.

Example

{
  "cancel_url": "xyz789",
  "error_url": "abc123",
  "return_url": "xyz789"
}

PaymentMethodInput

Defines the payment method.

Input Fields

Input Field
Description
braintree - BraintreeInput
braintree_cc_vault - BraintreeCcVaultInput
code - String!
The internal name for the payment method.
hosted_pro - HostedProInput
Required input for PayPal Hosted pro payments.
payflow_express - PayflowExpressInput
Required input for Payflow Express Checkout payments.
payflow_link - PayflowLinkInput
Required input for PayPal Payflow Link and Payments Advanced payments.
payflowpro - PayflowProInput
Required input for PayPal Payflow Pro and Payment Pro payments.
payflowpro_cc_vault - VaultTokenInput
Required input for PayPal Payflow Pro vault payments.
paypal_express - PaypalExpressInput
Required input for Express Checkout and Payments Standard payments.
purchase_order_number - String
The purchase order number. Optional for most payment methods.

Example

{
  "braintree": BraintreeInput,
  "braintree_cc_vault": BraintreeCcVaultInput,
  "code": "xyz789",
  "hosted_pro": HostedProInput,
  "payflow_express": PayflowExpressInput,
  "payflow_link": PayflowLinkInput,
  "payflowpro": PayflowProInput,
  "payflowpro_cc_vault": VaultTokenInput,
  "paypal_express": PaypalExpressInput,
  "purchase_order_number": "abc123"
}

PaymentToken

The stored payment method available to the customer.

Fields

Field Name
Description
details - String
A description of the stored account details.
payment_method_code - String!
The payment method code associated with the token.
public_hash - String!
The public hash of the token.
type - PaymentTokenTypeEnum!
Specifies the payment token type.

Example

{
  "details": "xyz789",
  "payment_method_code": "abc123",
  "public_hash": "xyz789",
  "type": "card"
}

PaymentTokenTypeEnum

The list of available payment token types.

Values

Enum Value
Description
card
phpcs:ignore Magento2.GraphQL.ValidArgumentName
account
phpcs:ignore Magento2.GraphQL.ValidArgumentName

Example

""card""

PaypalExpressInput

Contains required input for Express Checkout and Payments Standard payments.

Input Fields

Input Field
Description
payer_id - String!
The unique ID of the PayPal user.
token - String!
The token returned by the `createPaypalExpressToken` mutation.

Example

{
  "payer_id": "abc123",
  "token": "abc123"
}

PaypalExpressTokenInput

Defines the attributes required to receive a payment token for Express Checkout and Payments Standard payment methods.

Input Fields

Input Field
Description
cart_id - String!
The unique ID that identifies the customer's cart.
code - String!
The payment method code.
express_button - Boolean
Indicates whether the buyer selected the quick checkout button. The default value is false.
urls - PaypalExpressUrlsInput!
A set of relative URLs that PayPal uses in response to various actions during the authorization process.
use_paypal_credit - Boolean
Indicates whether the buyer clicked the PayPal credit button. The default value is false.

Example

{
  "cart_id": "xyz789",
  "code": "xyz789",
  "express_button": true,
  "urls": PaypalExpressUrlsInput,
  "use_paypal_credit": true
}

PaypalExpressTokenOutput

Contains the token returned by PayPal and a set of URLs that allow the buyer to authorize payment and adjust checkout details. Applies to Express Checkout and Payments Standard payment methods.

Fields

Field Name
Description
paypal_urls - PaypalExpressUrlList
A set of URLs that allow the buyer to authorize payment and adjust checkout details.
token - String
The token returned by PayPal.

Example

{
  "paypal_urls": PaypalExpressUrlList,
  "token": "xyz789"
}

PaypalExpressUrlList

Contains a set of URLs that allow the buyer to authorize payment and adjust checkout details for Express Checkout and Payments Standard transactions.

Fields

Field Name
Description
edit - String
The PayPal URL that allows the buyer to edit their checkout details.
start - String
The URL to the PayPal login page.

Example

{
  "edit": "abc123",
  "start": "xyz789"
}

PaypalExpressUrlsInput

Contains a set of relative URLs that PayPal uses in response to various actions during the authorization process. Magento prepends the base URL to this value to create a full URL. For example, if the full URL is https://www.example.com/path/to/page.html, the relative URL is path/to/page.html. Use this input for Express Checkout and Payments Standard payment methods.

Input Fields

Input Field
Description
cancel_url - String!
The relative URL of the page that PayPal redirects to when the buyer cancels the transaction in order to choose a different payment method. If the full URL to this page is https://www.example.com/paypal/action/cancel.html, the relative URL is paypal/action/cancel.html.
pending_url - String
The relative URL of the page that PayPal redirects to when the payment has been put on hold for additional review. This condition mostly applies to ACH transactions, and is not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success_pending.html, the relative URL is paypal/action/success_pending.html.
return_url - String!
The relative URL of the final confirmation page that PayPal redirects to upon payment success. If the full URL to this page is https://www.example.com/paypal/action/return.html, the relative URL is paypal/action/return.html.
success_url - String
The relative URL of the order confirmation page that PayPal redirects to when the payment is successful and additional confirmation is not needed. Not applicable to most PayPal solutions. If the full URL to this page is https://www.example.com/paypal/action/success.html, the relative URL is paypal/action/success.html.

Example

{
  "cancel_url": "xyz789",
  "pending_url": "abc123",
  "return_url": "xyz789",
  "success_url": "xyz789"
}

PhysicalProductInterface

Contains attributes specific to tangible products.

Fields

Field Name
Description
weight - Float
The weight of the item, in units defined by the store.

Possible Types

Example

{"weight": 123.45}

PickupLocation

Defines Pickup Location information.

Fields

Field Name
Description
city - String
contact_name - String
country_id - String
description - String
email - String
fax - String
latitude - Float
longitude - Float
name - String
phone - String
pickup_location_code - String
postcode - String
region - String
region_id - Int
street - String

Example

{
  "city": "xyz789",
  "contact_name": "xyz789",
  "country_id": "xyz789",
  "description": "abc123",
  "email": "abc123",
  "fax": "xyz789",
  "latitude": 987.65,
  "longitude": 123.45,
  "name": "xyz789",
  "phone": "xyz789",
  "pickup_location_code": "abc123",
  "postcode": "abc123",
  "region": "abc123",
  "region_id": 987,
  "street": "abc123"
}

PickupLocationFilterInput

PickupLocationFilterInput defines the list of attributes and filters for the search.

Input Fields

Input Field
Description
city - FilterTypeInput
Filter by city.
country_id - FilterTypeInput
Filter by country.
name - FilterTypeInput
Filter by pickup location name.
pickup_location_code - FilterTypeInput
Filter by pickup location code.
postcode - FilterTypeInput
Filter by postcode.
region - FilterTypeInput
Filter by region.
region_id - FilterTypeInput
Filter by region id.
street - FilterTypeInput
Filter by street.

Example

{
  "city": FilterTypeInput,
  "country_id": FilterTypeInput,
  "name": FilterTypeInput,
  "pickup_location_code": FilterTypeInput,
  "postcode": FilterTypeInput,
  "region": FilterTypeInput,
  "region_id": FilterTypeInput,
  "street": FilterTypeInput
}

PickupLocationSortInput

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

Input Fields

Input Field
Description
city - SortEnum
City where pickup location is placed.
contact_name - SortEnum
Name of the contact person.
country_id - SortEnum
Id of the country in two letters.
description - SortEnum
Description of the pickup location.
distance - SortEnum
Distance to the address, requested by distance filter. Applicable only with distance filter. If distance sort order is present, all other sort orders will be ignored.
email - SortEnum
Contact email of the pickup location.
fax - SortEnum
Contact fax of the pickup location.
latitude - SortEnum
Geographic latitude where pickup location is placed.
longitude - SortEnum
Geographic longitude where pickup location is placed.
name - SortEnum
The pickup location name. Customer use this to identify the pickup location.
phone - SortEnum
Contact phone number of the pickup location.
pickup_location_code - SortEnum
A code assigned to pickup location to identify the source.
postcode - SortEnum
Postcode where pickup location is placed.
region - SortEnum
Name of the region.
region_id - SortEnum
Id of the region.
street - SortEnum
Street where pickup location is placed.

Example

{
  "city": "ASC",
  "contact_name": "ASC",
  "country_id": "ASC",
  "description": "ASC",
  "distance": "ASC",
  "email": "ASC",
  "fax": "ASC",
  "latitude": "ASC",
  "longitude": "ASC",
  "name": "ASC",
  "phone": "ASC",
  "pickup_location_code": "ASC",
  "postcode": "ASC",
  "region": "ASC",
  "region_id": "ASC",
  "street": "ASC"
}

PickupLocations

Top level object returned in a pickup locations search.

Fields

Field Name
Description
items - [PickupLocation]
An array of pickup locations that match the specific search request.
page_info - SearchResultPageInfo
An object that includes the page_info and currentPage values specified in the query.
total_count - Int
The number of products returned.

Example

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

PlaceNegotiableQuoteOrderInput

Specifies the negotiable quote to convert to an order.

Input Fields

Input Field
Description
quote_uid - ID!
The unique ID of a `NegotiableQuote` object.

Example

{"quote_uid": 4}

PlaceNegotiableQuoteOrderOutput

An output object that returns the generated order.

Fields

Field Name
Description
order - Order!
Contains the generated order number.

Example

{"order": Order}

PlaceOrderForPurchaseOrderInput

Specifies the purchase order to convert to an order.

Input Fields

Input Field
Description
purchase_order_uid - ID!
The unique ID of a purchase order.

Example

{"purchase_order_uid": "4"}

PlaceOrderForPurchaseOrderOutput

Contains the results of the request to place an order.

Fields

Field Name
Description
order - CustomerOrder!
Placed order.

Example

{"order": CustomerOrder}

PlaceOrderInput

Specifies the quote to be converted to an order.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.

Example

{"cart_id": "abc123"}

PlaceOrderOutput

Contains the results of the request to place an order.

Fields

Field Name
Description
order - Order!
The ID of the order.

Example

{"order": Order}

PlacePurchaseOrderInput

Specifies the quote to be converted to a purchase order.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a `Cart` object.

Example

{"cart_id": "abc123"}

PlacePurchaseOrderOutput

Contains the results of the request to place a purchase order.

Fields

Field Name
Description
purchase_order - PurchaseOrder!
Placed purchase order.

Example

{"purchase_order": PurchaseOrder}

Price

Deprecated. Use ProductPrice instead. Defines the price of a product as well as any tax-related adjustments.

Fields

Field Name
Description
adjustments - [PriceAdjustment]
An array that provides information about tax, weee, or weee_tax adjustments. (Deprecated: Use `ProductPrice` instead.)
amount - Money
The price of a product plus a three-letter currency code. (Deprecated: Use `ProductPrice` instead.)

Example

{
  "adjustments": [PriceAdjustment],
  "amount": Money
}

PriceAdjustment

Deprecated. Taxes will be included or excluded in the price. Defines the amount of money to apply as an adjustment, the type of adjustment to apply, and whether the item is included or excluded from the adjustment.

Fields

Field Name
Description
amount - Money
The amount of the price adjustment and its currency code.
code - PriceAdjustmentCodesEnum
Indicates whether the adjustment involves tax, weee, or weee_tax. (Deprecated: `PriceAdjustment` is deprecated.)
description - PriceAdjustmentDescriptionEnum
Indicates whether the entity described by the code attribute is included or excluded from the adjustment. (Deprecated: `PriceAdjustment` is deprecated.)

Example

{
  "amount": Money,
  "code": "TAX",
  "description": "INCLUDED"
}

PriceAdjustmentCodesEnum

PriceAdjustment.code is deprecated.

Values

Enum Value
Description
TAX
(Deprecated: `PriceAdjustmentCodesEnum` is deprecated. Tax is included or excluded in the price. Tax is not shown separately in Catalog.)
WEEE
(Deprecated: WEEE code is deprecated. Use `fixed_product_taxes.label` instead.)
WEEE_TAX
(Deprecated: Use `fixed_product_taxes` instead. Tax is included or excluded in price. The tax is not shown separtely in Catalog.)

Example

""TAX""

PriceAdjustmentDescriptionEnum

PriceAdjustmentDescriptionEnum is deprecated. States whether a price adjustment is included or excluded.

Values

Enum Value
Description
INCLUDED
EXCLUDED

Example

""INCLUDED""

PriceRange

Contains the price range for a product. If the product has a single price, the minimum and maximum price will be the same.

Fields

Field Name
Description
maximum_price - ProductPrice
The highest possible price for the product.
minimum_price - ProductPrice!
The lowest possible price for the product.

Example

{
  "maximum_price": ProductPrice,
  "minimum_price": ProductPrice
}

PriceTypeEnum

Defines the price type.

Values

Enum Value
Description
FIXED
PERCENT
DYNAMIC

Example

""FIXED""

PriceViewEnum

Defines whether a bundle product's price is displayed as the lowest possible value or as a range.

Values

Enum Value
Description
PRICE_RANGE
AS_LOW_AS

Example

""PRICE_RANGE""

ProductAttribute

Contains a product attribute code and value.

Fields

Field Name
Description
code - String!
The unique identifier for a product attribute code.
value - String!
The display value of the attribute.

Example

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

ProductAttributeFilterInput

Defines the filters to be used in the search. A filter contains at least one attribute, a comparison operator, and the value that is being searched for.

Input Fields

Input Field
Description
activity - FilterEqualTypeInput
Attribute label: Activity
category_gear - FilterEqualTypeInput
Attribute label: Category Gear
category_id - FilterEqualTypeInput
Deprecated: use `category_uid` to filter product by category ID.
category_uid - FilterEqualTypeInput
Filter product by the unique ID for a `CategoryInterface` object.
climate - FilterEqualTypeInput
Attribute label: Climate
collar - FilterEqualTypeInput
Attribute label: Collar
color - FilterEqualTypeInput
Attribute label: Color
description - FilterMatchTypeInput
Attribute label: Description
eco_collection - FilterEqualTypeInput
Attribute label: Eco Collection
erin_recommends - FilterEqualTypeInput
Attribute label: Erin Recommends
features_bags - FilterEqualTypeInput
Attribute label: Features
format - FilterEqualTypeInput
Attribute label: Format
gender - FilterEqualTypeInput
Attribute label: Gender
material - FilterEqualTypeInput
Attribute label: Material
name - FilterMatchTypeInput
Attribute label: Product Name
new - FilterEqualTypeInput
Attribute label: New
pattern - FilterEqualTypeInput
Attribute label: Pattern
performance_fabric - FilterEqualTypeInput
Attribute label: Performance Fabric
price - FilterRangeTypeInput
Attribute label: Price
purpose - FilterEqualTypeInput
Attribute label: Purpose
sale - FilterEqualTypeInput
Attribute label: Sale
short_description - FilterMatchTypeInput
Attribute label: Short Description
size - FilterEqualTypeInput
Attribute label: Size
sku - FilterEqualTypeInput
Attribute label: SKU
sleeve - FilterEqualTypeInput
Attribute label: Sleeve
strap_bags - FilterEqualTypeInput
Attribute label: Strap/Handle
style_bags - FilterEqualTypeInput
Attribute label: Style Bags
style_bottom - FilterEqualTypeInput
Attribute label: Style Bottom
style_general - FilterEqualTypeInput
Attribute label: Style General
url_key - FilterEqualTypeInput
The part of the URL that identifies the product

Example

{
  "activity": FilterEqualTypeInput,
  "category_gear": FilterEqualTypeInput,
  "category_id": FilterEqualTypeInput,
  "category_uid": FilterEqualTypeInput,
  "climate": FilterEqualTypeInput,
  "collar": FilterEqualTypeInput,
  "color": FilterEqualTypeInput,
  "description": FilterMatchTypeInput,
  "eco_collection": FilterEqualTypeInput,
  "erin_recommends": FilterEqualTypeInput,
  "features_bags": FilterEqualTypeInput,
  "format": FilterEqualTypeInput,
  "gender": FilterEqualTypeInput,
  "material": FilterEqualTypeInput,
  "name": FilterMatchTypeInput,
  "new": FilterEqualTypeInput,
  "pattern": FilterEqualTypeInput,
  "performance_fabric": FilterEqualTypeInput,
  "price": FilterRangeTypeInput,
  "purpose": FilterEqualTypeInput,
  "sale": FilterEqualTypeInput,
  "short_description": FilterMatchTypeInput,
  "size": FilterEqualTypeInput,
  "sku": FilterEqualTypeInput,
  "sleeve": FilterEqualTypeInput,
  "strap_bags": FilterEqualTypeInput,
  "style_bags": FilterEqualTypeInput,
  "style_bottom": FilterEqualTypeInput,
  "style_general": FilterEqualTypeInput,
  "url_key": FilterEqualTypeInput
}

ProductAttributeSortInput

Specifies the attribute to use for sorting search results and indicates whether the results are sorted in ascending or descending order. It's possible to sort products using searchable attributes with enabled 'Use in Filter Options' option

Input Fields

Input Field
Description
name - SortEnum
Attribute label: Product Name
position - SortEnum
Sort by the position assigned to each product.
price - SortEnum
Attribute label: Price
relevance - SortEnum
Sort by the search relevance score (default).

Example

{"name": "ASC", "position": "ASC", "price": "ASC", "relevance": "ASC"}

ProductDiscount

Contains the discount applied to a product price.

Fields

Field Name
Description
amount_off - Float
The actual value of the discount.
percent_off - Float
The discount expressed a percentage.

Example

{"amount_off": 123.45, "percent_off": 987.65}

ProductFilterInput

ProductFilterInput is deprecated, use @ProductAttributeFilterInput instead. ProductFilterInput defines the filters to be used in the search. A filter contains at least one attribute, a comparison operator, and the value that is being searched for.

Input Fields

Input Field
Description
category_id - FilterTypeInput
The category ID the product belongs to.
country_of_manufacture - FilterTypeInput
The product's country of origin.
created_at - FilterTypeInput
The timestamp indicating when the product was created.
custom_layout - FilterTypeInput
The name of a custom layout.
custom_layout_update - FilterTypeInput
XML code that is applied as a layout update to the product page.
description - FilterTypeInput
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - FilterTypeInput
Indicates whether a gift message is available.
has_options - FilterTypeInput
Indicates whether additional attributes have been created for the product.
image - FilterTypeInput
The relative path to the main image on the product page.
image_label - FilterTypeInput
The label assigned to a product image.
is_returnable - FilterTypeInput
Indicates whether the product can be returned.
manufacturer - FilterTypeInput
A number representing the product's manufacturer.
max_price - FilterTypeInput
The numeric maximal price of the product. Do not include the currency code.
meta_description - FilterTypeInput
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - FilterTypeInput
A comma-separated list of keywords that are visible only to search engines.
meta_title - FilterTypeInput
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_price - FilterTypeInput
The numeric minimal price of the product. Do not include the currency code.
name - FilterTypeInput
The product name. Customers use this name to identify the product.
news_from_date - FilterTypeInput
The beginning date for new product listings, and determines if the product is featured as a new product.
news_to_date - FilterTypeInput
The end date for new product listings.
options_container - FilterTypeInput
If the product has multiple options, determines where they appear on the product page.
or - ProductFilterInput
The keyword required to perform a logical OR comparison.
price - FilterTypeInput
The price of an item.
required_options - FilterTypeInput
Indicates whether the product has required options.
short_description - FilterTypeInput
A short description of the product. Its use depends on the theme.
sku - FilterTypeInput
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - FilterTypeInput
The relative path to the small image, which is used on catalog pages.
small_image_label - FilterTypeInput
The label assigned to a product's small image.
special_from_date - FilterTypeInput
The beginning date that a product has a special price.
special_price - FilterTypeInput
The discounted price of the product. Do not include the currency code.
special_to_date - FilterTypeInput
The end date that a product has a special price.
swatch_image - FilterTypeInput
The file name of a swatch image.
thumbnail - FilterTypeInput
The relative path to the product's thumbnail image.
thumbnail_label - FilterTypeInput
The label assigned to a product's thumbnail image.
tier_price - FilterTypeInput
The price when tier pricing is in effect and the items purchased threshold has been reached.
updated_at - FilterTypeInput
The timestamp indicating when the product was updated.
url_key - FilterTypeInput
The part of the URL that identifies the product
url_path - FilterTypeInput
weight - FilterTypeInput
The weight of the item, in units defined by the store.

Example

{
  "category_id": FilterTypeInput,
  "country_of_manufacture": FilterTypeInput,
  "created_at": FilterTypeInput,
  "custom_layout": FilterTypeInput,
  "custom_layout_update": FilterTypeInput,
  "description": FilterTypeInput,
  "gift_message_available": FilterTypeInput,
  "has_options": FilterTypeInput,
  "image": FilterTypeInput,
  "image_label": FilterTypeInput,
  "is_returnable": FilterTypeInput,
  "manufacturer": FilterTypeInput,
  "max_price": FilterTypeInput,
  "meta_description": FilterTypeInput,
  "meta_keyword": FilterTypeInput,
  "meta_title": FilterTypeInput,
  "min_price": FilterTypeInput,
  "name": FilterTypeInput,
  "news_from_date": FilterTypeInput,
  "news_to_date": FilterTypeInput,
  "options_container": FilterTypeInput,
  "or": ProductFilterInput,
  "price": FilterTypeInput,
  "required_options": FilterTypeInput,
  "short_description": FilterTypeInput,
  "sku": FilterTypeInput,
  "small_image": FilterTypeInput,
  "small_image_label": FilterTypeInput,
  "special_from_date": FilterTypeInput,
  "special_price": FilterTypeInput,
  "special_to_date": FilterTypeInput,
  "swatch_image": FilterTypeInput,
  "thumbnail": FilterTypeInput,
  "thumbnail_label": FilterTypeInput,
  "tier_price": FilterTypeInput,
  "updated_at": FilterTypeInput,
  "url_key": FilterTypeInput,
  "url_path": FilterTypeInput,
  "weight": FilterTypeInput
}

ProductImage

Contains product image information, including the image URL and label.

Fields

Field Name
Description
disabled - Boolean
Indicates whether the image is hidden from view.
label - String
The label of the product image or video.
position - Int
The media item's position after it has been sorted.
url - String
The URL of the product image or video.

Example

{
  "disabled": false,
  "label": "abc123",
  "position": 987,
  "url": "abc123"
}

ProductInfoInput

Product Information used for Pickup Locations search.

Input Fields

Input Field
Description
sku - String!
Product SKU.

Example

{"sku": "xyz789"}