Types
TaxItem
Contains tax item details.
Fields
amount - Money!rate - Float!title - String!Example
{
"amount": Money,
"rate": 987.65,
"title": "abc123"
}
TaxWrappingEnum
Values
DISPLAY_EXCLUDING_TAXDISPLAY_INCLUDING_TAXDISPLAY_TYPE_BOTHExample
""DISPLAY_EXCLUDING_TAX""
TextSwatchData
Fields
value - StringExample
{"value": "xyz789"}
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": 123.45
}
UnassignChildCompanyInput
Defines the input schema for unassigning a child company from its parent company.
Input Fields
child_company_id - ID!Example
{"child_company_id": 4}
UnassignChildCompanyOutput
Contains the response to the request to unassign a child company.
Fields
company_hierarchy - CompanyHierarchy!Example
{"company_hierarchy": CompanyHierarchy}
UnitConfigInput
Input Fields
unitName - StringstorefrontLabel - StringpagePlacement - StringdisplayNumber - IntpageType - StringunitStatus - StringtypeId - StringfilterRules - [FilterRuleInput]Example
{
"unitName": "xyz789",
"storefrontLabel": "xyz789",
"pagePlacement": "xyz789",
"displayNumber": 123,
"pageType": "xyz789",
"unitStatus": "abc123",
"typeId": "xyz789",
"filterRules": [FilterRuleInput]
}
UpdateCartItemsInput
Modifies the specified items in the cart.
Input Fields
cart_id - String!Cart object.cart_items - [CartItemUpdateInput]!Example
{
"cart_id": "xyz789",
"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": "abc123",
"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": "abc123",
"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": "abc123",
"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": "abc123"
}
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": ["xyz789"]
}
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"
}
UserCompaniesInput
Defines the input for returning matching companies the customer is assigned to.
Input Fields
currentPage - IntpageSize - Intsort - [CompaniesSortInput]Example
{
"currentPage": 123,
"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": "xyz789",
"public_hash": "xyz789"
}
VaultSetupTokenInput
The payment source information
Input Fields
payment_source - PaymentSourceInput!Example
{"payment_source": PaymentSourceInput}
ViewHistory
User view history
Input Fields
Example
{
"date": "2007-12-03T10:15:30Z",
"sku": "abc123"
}
ViewHistoryInput
User view history
Input Fields
Example
{
"dateTime": "2007-12-03T10:15:30Z",
"sku": "xyz789"
}
VirtualCartItem
An implementation for virtual product cart items.
Fields
backorder_message - Stringcustom_attributes - [CustomAttribute]customizable_options - [SelectedCustomizableOption]!discount - [Discount]errors - [CartItemError]is_available - Boolean!is_salable instead. It indicates whether the line can be purchased, including backorder configuration.)is_salable - Boolean!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
{
"backorder_message": "abc123",
"custom_attributes": [CustomAttribute],
"customizable_options": [SelectedCustomizableOption],
"discount": [Discount],
"errors": [CartItemError],
"is_available": false,
"is_salable": true,
"max_qty": 987.65,
"min_qty": 123.45,
"not_available_message": "abc123",
"note_from_buyer": [ItemNote],
"note_from_seller": [ItemNote],
"prices": CartItemPrices,
"product": ProductInterface,
"quantity": 123.45,
"uid": 4
}
VirtualProduct
Defines a virtual product, which is a non-tangible product that does not require shipping and is not kept in inventory.
Fields
canonical_url - Stringcategories - [CategoryInterface]country_of_manufacture - Stringcrosssell_products - [ProductInterface]custom_attributesV2 - ProductCustomAttributesdescription - ComplexTextValuegift_message_available - Boolean!gift_wrapping_available - Boolean!gift_wrapping_price - Moneyimage - ProductImageis_returnable - Stringmanufacturer - Intmax_sale_qty - Floatmedia_gallery - [MediaGalleryInterface]meta_description - Stringmeta_keyword - Stringmeta_title - Stringmin_sale_qty - Floatname - Stringnew_from_date - Stringnew_to_date - Stringonly_x_left_in_stock - Floatoptions - [CustomizableOptionInterface]options_container - Stringprice_range - PriceRange!price_tiers - [TierPrice]TierPrice objects.product_links - [ProductLinksInterface]ProductLinks objects.quantity - Floatrelated_products - [ProductInterface]short_description - ComplexTextValuesku - Stringsmall_image - ProductImagespecial_price - Floatspecial_to_date - Stringstock_status - ProductStockStatusswatch_image - Stringthumbnail - ProductImageuid - ID!ProductInterface object.upsell_products - [ProductInterface]url_key - StringExample
{
"canonical_url": "xyz789",
"categories": [CategoryInterface],
"country_of_manufacture": "abc123",
"crosssell_products": [ProductInterface],
"custom_attributesV2": ProductCustomAttributes,
"description": ComplexTextValue,
"gift_message_available": false,
"gift_wrapping_available": false,
"gift_wrapping_price": Money,
"image": ProductImage,
"is_returnable": "abc123",
"manufacturer": 123,
"max_sale_qty": 123.45,
"media_gallery": [MediaGalleryInterface],
"meta_description": "abc123",
"meta_keyword": "abc123",
"meta_title": "xyz789",
"min_sale_qty": 987.65,
"name": "xyz789",
"new_from_date": "xyz789",
"new_to_date": "xyz789",
"only_x_left_in_stock": 987.65,
"options": [CustomizableOptionInterface],
"options_container": "xyz789",
"price_range": PriceRange,
"price_tiers": [TierPrice],
"product_links": [ProductLinksInterface],
"quantity": 123.45,
"related_products": [ProductInterface],
"short_description": ComplexTextValue,
"sku": "abc123",
"small_image": ProductImage,
"special_price": 987.65,
"special_to_date": "abc123",
"stock_status": "IN_STOCK",
"swatch_image": "abc123",
"thumbnail": ProductImage,
"uid": 4,
"upsell_products": [ProductInterface],
"url_key": "xyz789"
}
VirtualRequisitionListItem
Contains details about virtual products added to a requisition list.
Fields
customizable_options - [SelectedCustomizableOption]!product - ProductInterface!quantity - Float!sku - String!uid - ID!Example
{
"customizable_options": [SelectedCustomizableOption],
"product": ProductInterface,
"quantity": 123.45,
"sku": "xyz789",
"uid": "4"
}
VirtualWishlistItem
Contains a virtual product wish list item.
Fields
added_at - String!customizable_options - [SelectedCustomizableOption]!description - Stringid - ID!WishlistItemInterface object.product - ProductInterface!quantity - Float!Example
{
"added_at": "abc123",
"customizable_options": [SelectedCustomizableOption],
"description": "xyz789",
"id": "4",
"product": ProductInterface,
"quantity": 123.45
}
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_count - Intitems_v2 - WishlistItemsname - Stringsharing_code - Stringupdated_at - Stringvisibility - WishlistVisibilityEnum!Example
{
"id": "4",
"items_count": 123,
"items_v2": WishlistItems,
"name": "xyz789",
"sharing_code": "xyz789",
"updated_at": "abc123",
"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": "xyz789",
"wishlistId": "4",
"wishlistItemId": 4
}
WishlistCartUserInputErrorType
A list of possible error types.
Values
PRODUCT_NOT_FOUNDNOT_SALABLEINSUFFICIENT_STOCKUNDEFINEDREQUIRED_PARAMETER_MISSINGExample
""PRODUCT_NOT_FOUND""
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": "xyz789",
"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 - ProductInterface!quantity - Float!Possible Types
Example
{
"added_at": "xyz789",
"customizable_options": [SelectedCustomizableOption],
"description": "abc123",
"id": "4",
"product": ProductInterface,
"quantity": 123.45
}
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": "xyz789",
"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
}
WishlistVisibilityEnum
Defines the wish list visibility types.
Values
PUBLICPRIVATEExample
""PUBLIC""