Types
TaxItem
Contains tax item details.
Fields
amount - Money!rate - Float!title - String!Example
{
"amount": Money,
"rate": 987.65,
"title": "xyz789"
}
TaxWrappingEnum
Values
DISPLAY_EXCLUDING_TAXDISPLAY_INCLUDING_TAXDISPLAY_TYPE_BOTHExample
""DISPLAY_EXCLUDING_TAX""
TextSwatchData
Fields
value - StringExample
{"value": "abc123"}
ThreeDSMode
3D Secure mode.
Values
OFFSCA_WHEN_REQUIREDSCA_ALWAYSExample
""OFF""
TierPrice
Defines a price based on the quantity purchased.
Fields
discount - ProductDiscountfinal_price - Moneyquantity - FloatExample
{
"discount": ProductDiscount,
"final_price": Money,
"quantity": 987.65
}
UpdateCartItemsInput
Modifies the specified items in the cart.
Input Fields
cart_id - String!Cart object.cart_items - [CartItemUpdateInput]!Example
{
"cart_id": "abc123",
"cart_items": [CartItemUpdateInput]
}
UpdateCartItemsOutput
Contains details about the cart after updating items.
Fields
cart - Cart!errors - [CartUserInputError]!Example
{
"cart": Cart,
"errors": [CartUserInputError]
}
UpdateCompanyOutput
Contains the response to the request to update the company.
Fields
company - Company!Example
{"company": Company}
UpdateCompanyRoleOutput
Contains the response to the request to update the company role.
Fields
role - CompanyRole!Example
{"role": CompanyRole}
UpdateCompanyStructureOutput
Contains the response to the request to update the company structure.
Fields
company - Company!Example
{"company": Company}
UpdateCompanyTeamOutput
Contains the response to the request to update a company team.
Fields
team - CompanyTeam!Example
{"team": CompanyTeam}
UpdateCompanyUserOutput
Contains the response to the request to update the company user.
Fields
user - Customer!Example
{"user": Customer}
UpdateGiftRegistryInput
Defines updates to a GiftRegistry object.
Input Fields
dynamic_attributes - [GiftRegistryDynamicAttributeInput]event_name - Stringmessage - Stringprivacy_settings - GiftRegistryPrivacySettingsshipping_address - GiftRegistryShippingAddressInputstatus - GiftRegistryStatusExample
{
"dynamic_attributes": [
GiftRegistryDynamicAttributeInput
],
"event_name": "abc123",
"message": "abc123",
"privacy_settings": "PRIVATE",
"shipping_address": GiftRegistryShippingAddressInput,
"status": "ACTIVE"
}
UpdateGiftRegistryItemInput
Defines updates to an item in a gift registry.
Input Fields
gift_registry_item_uid - ID!giftRegistryItem object.note - Stringquantity - Float!Example
{
"gift_registry_item_uid": "4",
"note": "xyz789",
"quantity": 987.65
}
UpdateGiftRegistryItemsOutput
Contains the results of a request to update gift registry items.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
UpdateGiftRegistryOutput
Contains the results of a request to update a gift registry.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
UpdateGiftRegistryRegistrantInput
Defines updates to an existing registrant.
Input Fields
dynamic_attributes - [GiftRegistryDynamicAttributeInput]email - Stringfirstname - Stringgift_registry_registrant_uid - ID!giftRegistryRegistrant object.lastname - StringExample
{
"dynamic_attributes": [
GiftRegistryDynamicAttributeInput
],
"email": "xyz789",
"firstname": "abc123",
"gift_registry_registrant_uid": "4",
"lastname": "abc123"
}
UpdateGiftRegistryRegistrantsOutput
Contains the results a request to update registrants.
Fields
gift_registry - GiftRegistryExample
{"gift_registry": GiftRegistry}
UpdateNegotiableQuoteItemsQuantityOutput
Contains the updated negotiable quote.
Fields
quote - NegotiableQuoteExample
{"quote": NegotiableQuote}
UpdateNegotiableQuoteQuantitiesInput
Specifies the items to update.
Input Fields
quote_uid - ID!NegotiableQuote object.Example
{
"items": [NegotiableQuoteItemQuantityInput],
"quote_uid": "4"
}
UpdateNegotiableQuoteTemplateItemsQuantityOutput
Contains the updated negotiable quote template.
Fields
quote_template - NegotiableQuoteTemplateExample
{"quote_template": NegotiableQuoteTemplate}
UpdateNegotiableQuoteTemplateQuantitiesInput
Specifies the items to update.
Input Fields
template_id - ID!NegotiableQuoteTemplate object.Example
{
"items": [NegotiableQuoteTemplateItemQuantityInput],
"template_id": 4
}
UpdateProductsInWishlistOutput
Contains the customer's wish list and any errors encountered.
Fields
user_errors - [WishListUserInputError]!wishlist - Wishlist!Example
{
"user_errors": [WishListUserInputError],
"wishlist": Wishlist
}
UpdatePurchaseOrderApprovalRuleInput
Defines the changes to be made to an approval rule.
Input Fields
applies_to - [ID]approvers - [ID]condition - CreatePurchaseOrderApprovalRuleConditionInputdescription - Stringname - Stringstatus - PurchaseOrderApprovalRuleStatusuid - ID!Example
{
"applies_to": [4],
"approvers": [4],
"condition": CreatePurchaseOrderApprovalRuleConditionInput,
"description": "abc123",
"name": "xyz789",
"status": "ENABLED",
"uid": "4"
}
UpdateRequisitionListInput
An input object that defines which requistion list characteristics to update.
Input Fields
description - Stringname - String!Example
{
"description": "xyz789",
"name": "xyz789"
}
UpdateRequisitionListItemsInput
Defines which items in a requisition list to update.
Input Fields
entered_options - [EnteredOptionInput]item_id - ID!quantity - Floatselected_options - [String]Example
{
"entered_options": [EnteredOptionInput],
"item_id": "4",
"quantity": 123.45,
"selected_options": ["abc123"]
}
UpdateRequisitionListItemsOutput
Output of the request to update items in the specified requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
UpdateRequisitionListOutput
Output of the request to rename the requisition list.
Fields
requisition_list - RequisitionListExample
{"requisition_list": RequisitionList}
UpdateWishlistOutput
Contains the name and visibility of an updated wish list.
Fields
name - String!uid - ID!Wishlist object.visibility - WishlistVisibilityEnum!Example
{
"name": "abc123",
"uid": 4,
"visibility": "PUBLIC"
}
UrlRewrite
Contains URL rewrite details.
Fields
parameters - [HttpQueryParameter]url - StringExample
{
"parameters": [HttpQueryParameter],
"url": "abc123"
}
UrlRewriteEntityTypeEnum
This enumeration defines the entity type.
Values
CMS_PAGEPRODUCTCATEGORYExample
""CMS_PAGE""
UseInLayeredNavigationOptions
Defines whether the attribute is filterable in layered navigation.
Values
NOFILTERABLE_WITH_RESULTSFILTERABLE_NO_RESULTExample
""NO""
UserCompaniesInput
Defines the input for returning matching companies the customer is assigned to.
Input Fields
currentPage - IntpageSize - Intsort - [CompaniesSortInput]Example
{
"currentPage": 987,
"pageSize": 987,
"sort": [CompaniesSortInput]
}
UserCompaniesOutput
An object that contains a list of companies customer is assigned to.
Fields
items - [CompanyBasicInfo]!page_info - SearchResultPageInfo!Example
{
"items": [CompanyBasicInfo],
"page_info": SearchResultPageInfo
}
ValidatePurchaseOrderError
Contains details about a failed validation attempt.
Fields
Example
{"message": "abc123", "type": "NOT_FOUND"}
ValidatePurchaseOrderErrorType
Values
NOT_FOUNDOPERATION_NOT_APPLICABLECOULD_NOT_SAVENOT_VALID_DATAUNDEFINEDExample
""NOT_FOUND""
ValidatePurchaseOrdersInput
Defines the purchase orders to be validated.
Input Fields
purchase_order_uids - [ID]!Example
{"purchase_order_uids": [4]}
ValidatePurchaseOrdersOutput
Contains the results of validation attempts.
Fields
errors - [ValidatePurchaseOrderError]!purchase_orders - [PurchaseOrder]!Example
{
"errors": [ValidatePurchaseOrderError],
"purchase_orders": [PurchaseOrder]
}
ValidationRule
Defines a customer attribute validation rule.
Fields
name - ValidationRuleEnumvalue - StringExample
{
"name": "DATE_RANGE_MAX",
"value": "abc123"
}
ValidationRuleEnum
List of validation rule names applied to a customer attribute.
Values
DATE_RANGE_MAXDATE_RANGE_MINFILE_EXTENSIONSINPUT_VALIDATIONMAX_TEXT_LENGTHMIN_TEXT_LENGTHMAX_FILE_SIZEMAX_IMAGE_HEIGHTMAX_IMAGE_WIDTHExample
""DATE_RANGE_MAX""
VaultConfigOutput
Retrieves the vault configuration
Fields
credit_card - VaultCreditCardConfigExample
{"credit_card": VaultCreditCardConfig}
VaultCreditCardConfig
Fields
is_vault_enabled - Booleansdk_params - [SDKParams]three_ds_mode - ThreeDSModeExample
{
"is_vault_enabled": true,
"sdk_params": [SDKParams],
"three_ds_mode": "OFF"
}
VaultMethodInput
Vault payment inputs
Input Fields
payment_source - Stringpayments_order_id - Stringpaypal_order_id - Stringpublic_hash - StringExample
{
"payment_source": "abc123",
"payments_order_id": "xyz789",
"paypal_order_id": "abc123",
"public_hash": "abc123"
}
VaultSetupTokenInput
The payment source information
Input Fields
payment_source - PaymentSourceInput!Example
{"payment_source": PaymentSourceInput}
VaultTokenInput
Contains required input for payment methods with Vault support.
Input Fields
public_hash - String!Example
{"public_hash": "abc123"}
VirtualCartItem
An implementation for virtual product cart items.
Fields
customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]id - String!uid instead.)is_available - Boolean!max_qty - Floatmin_qty - Floatnot_available_message - Stringnote_from_buyer - [ItemNote]note_from_seller - [ItemNote]prices - CartItemPricesproduct - ProductInterface!quantity - Float!uid - ID!CartItemInterface object.Example
{
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"id": "xyz789",
"is_available": true,
"max_qty": 123.45,
"min_qty": 987.65,
"not_available_message": "abc123",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 987.65,
"uid": 4
}
VirtualProduct
Defines a virtual product, which is a non-tangible product that does not require shipping and is not kept in inventory.
Fields
attribute_set_id - Intcanonical_url - Stringcategories - [CategoryInterface]color - Intcustom_attributes field instead.)country_of_manufacture - Stringcreated_at - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyid - Intuid field instead.)image - ProductImageis_returnable - Stringmanufacturer - Intcustom_attributes field instead.)max_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]media_gallery_entries - [MediaGalleryEntry]media_gallery instead.)meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions - [CustomizableOptionInterface]options_container - Stringprice - ProductPricesprice_range for product price information.)price_range - PriceRange!price_tiers - [TierPrice]TierPrice objects.product_links - [ProductLinksInterface]ProductLinks objects.quantity - Floatrating_summary - Float!redirect_code - Int!related_products - [ProductInterface]relative_url - Stringreview_count - Int!reviews - ProductReviews!short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_from_date - Stringspecial_price - Floatspecial_to_date - Stringstaged - Boolean!stock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImagetier_price - Floatprice_tiers for product tier price information.)tier_prices - [ProductTierPrices]price_tiers for product tier price information.)type - UrlRewriteEntityTypeEnumtype_id - String__typename instead.)uid - ID!ProductInterface object.updated_at - Stringupsell_products - [ProductInterface]url_key - Stringurl_path - Stringcanonical_url or url rewrites instead)url_rewrites - [UrlRewrite]url_suffix - Stringwebsites - [Website]Example
{
"attribute_set_id": 123,
"canonical_url": "abc123",
"categories": [CategoryInterface],
"color": 123,
"country_of_manufacture": "abc123",
"created_at": "xyz789",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": true,
"gift_wrapping_available": true,
"gift_wrapping_price": Money,
"id": 123,
"image": ProductImage,
"is_returnable": "xyz789",
"manufacturer": 987,
"max_sale_qty": 987.65,
"media_gallery": [MediaGalleryInterface],
"media_gallery_entries": [MediaGalleryEntry],
"meta_description": "abc123",
"meta_keyword": "abc123",
"meta_title": "abc123",
"min_sale_qty": 987.65,
"name": "xyz789",
"new_from_date": "abc123",
"new_to_date": "xyz789",
"only_x_left_in_stock": 123.45,
"options": [CustomizableOptionInterface],
"options_container": "xyz789",
"price": ProductPrices,
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"rating_summary": 987.65,
"redirect_code": 987,
"related_products": [ProductInterface],
"relative_url": "xyz789",
"review_count": 123,
"reviews": ProductReviews,
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_from_date": "xyz789",
"special_price": 123.45,
"special_to_date": "xyz789",
"staged": true,
"stock_status": "IN_STOCK",
"swatch_image": "abc123",
"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": "xyz789",
"url_rewrites": [UrlRewrite],
"url_suffix": "abc123",
"websites": [Website]
}
VirtualProductCartItemInput
Defines a single product to add to the cart.
Input Fields
customizable_options - [CustomizableOptionInput]data - CartItemInput!sku, quantity, and other relevant information about the product.Example
{
"customizable_options": [CustomizableOptionInput],
"data": CartItemInput
}
VirtualRequisitionListItem
Contains details about virtual products added to a requisition list.
Fields
customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!uid - ID!Example
{
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 987.65,
"uid": "4"
}
VirtualWishlistItem
Contains a virtual product wish list item.
Fields
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!WishlistItemInterface object.product - ProductInterfacequantity - Float!Example
{
"added_at": "abc123",
"customizable_options": [SelectedCustomizableOption],
"description": "xyz789",
"id": 4,
"product": ProductInterface,
"quantity": 123.45
}
Website
Deprecated. It should not be used on the storefront. Contains information about a website.
Fields
code - Stringdefault_group_id - Stringid - Intis_default - Booleanname - Stringsort_order - IntExample
{
"code": "abc123",
"default_group_id": "xyz789",
"id": 987,
"is_default": true,
"name": "xyz789",
"sort_order": 987
}
WishListUserInputError
An error encountered while performing operations with WishList.
Fields
code - WishListUserInputErrorType!message - String!Example
{
"code": "PRODUCT_NOT_FOUND",
"message": "abc123"
}
WishListUserInputErrorType
A list of possible error types.
Values
PRODUCT_NOT_FOUNDUNDEFINEDExample
""PRODUCT_NOT_FOUND""
Wishlist
Contains a customer wish list.
Fields
id - IDWishlist object.items - [WishlistItem]items_v2 field instead.)items_count - Intitems_v2 - WishlistItemsname - Stringsharing_code - Stringupdated_at - Stringvisibility - WishlistVisibilityEnum!Example
{
"id": "4",
"items": [WishlistItem],
"items_count": 123,
"items_v2": WishlistItems,
"name": "xyz789",
"sharing_code": "xyz789",
"updated_at": "xyz789",
"visibility": "PUBLIC"
}
WishlistCartUserInputError
Contains details about errors encountered when a customer added wish list items to the cart.
Fields
message - String!wishlistId - ID!Wishlist object containing an error.wishlistItemId - ID!Example
{
"code": "PRODUCT_NOT_FOUND",
"message": "abc123",
"wishlistId": 4,
"wishlistItemId": "4"
}
WishlistCartUserInputErrorType
A list of possible error types.
Values
PRODUCT_NOT_FOUNDREQUIRED_PARAMETER_MISSINGNOT_SALABLEINSUFFICIENT_STOCKUNDEFINEDExample
""PRODUCT_NOT_FOUND""
WishlistItem
Contains details about a wish list item.
Fields
added_at - Stringdescription - Stringid - IntWishlistItem object.product - ProductInterfaceqty - FloatExample
{
"added_at": "abc123",
"description": "abc123",
"id": 123,
"product": ProductInterface,
"qty": 123.45
}
WishlistItemCopyInput
Specifies the IDs of items to copy and their quantities.
Input Fields
quantity - Floatwishlist_item_id - ID!WishlistItemInterface object to be copied.Example
{
"quantity": 987.65,
"wishlist_item_id": "4"
}
WishlistItemInput
Defines the items to add to a wish list.
Input Fields
entered_options - [EnteredOptionInput]parent_sku - Stringquantity - Float!selected_options - [ID]sku - String!Example
{
"entered_options": [EnteredOptionInput],
"parent_sku": "abc123",
"quantity": 987.65,
"selected_options": [4],
"sku": "xyz789"
}
WishlistItemInterface
The interface for wish list items.
Fields
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!WishlistItemInterface object.product - ProductInterfacequantity - Float!Possible Types
Example
{
"added_at": "abc123",
"customizable_options": [SelectedCustomizableOption],
"description": "abc123",
"id": "4",
"product": ProductInterface,
"quantity": 987.65
}
WishlistItemMoveInput
Specifies the IDs of the items to move and their quantities.
Input Fields
quantity - Floatwishlist_item_id - ID!WishlistItemInterface object to be moved.Example
{
"quantity": 987.65,
"wishlist_item_id": "4"
}
WishlistItemUpdateInput
Defines updates to items in a wish list.
Input Fields
description - Stringentered_options - [EnteredOptionInput]quantity - Floatselected_options - [ID]wishlist_item_id - ID!WishlistItemInterface object.Example
{
"description": "abc123",
"entered_options": [EnteredOptionInput],
"quantity": 123.45,
"selected_options": [4],
"wishlist_item_id": 4
}
WishlistItems
Contains an array of items in a wish list.
Fields
items - [WishlistItemInterface]!page_info - SearchResultPageInfoExample
{
"items": [WishlistItemInterface],
"page_info": SearchResultPageInfo
}
WishlistOutput
Deprecated: Use the Wishlist type instead.
Fields
items - [WishlistItem]Wishlist.items field instead.)items_count - IntWishlist.items_count field instead.)name - Stringnull in Open Source.)sharing_code - StringWishlist.sharing_code field instead.)updated_at - StringWishlist.updated_at field instead.)Example
{
"items": [WishlistItem],
"items_count": 123,
"name": "abc123",
"sharing_code": "xyz789",
"updated_at": "xyz789"
}
WishlistVisibilityEnum
Defines the wish list visibility types.
Values
PUBLICPRIVATEExample
""PUBLIC""