Skip to main content
inputChangeItemCommandRequestInput

Fields

itemId
ID!
required

Unique ID of the item to be modified - this key is used for all further operations with the item.

productGroupId
ID

The ID of the product group to which the item should be assigned. Product groups serve for categorical classification of items for reports and analyses.

shippingClassId
ID

The ID of the shipping class to which the item should be assigned.

manufacturerId
ID

The ID of the manufacturer to which the item should be assigned.

taxClassId
ID

The ID of the tax class to which the item should be assigned. When omitted the item keeps its current tax class. The value must reference an existing tax class - an unknown ID and an explicit null are both rejected as a validation error. An item whose tax class reads back as null cannot be echoed unchanged; omit the field instead of sending null.

Category assignments of the item. Defines all categories to which the item should be assigned for better organization and navigation.

Identifiers of the item with all relevant markings and numbers for unique identification of the item in various systems.

Descriptions of the item in different languages and for different platforms/sales channels. Includes names, short and long descriptions as well as SEO-relevant information.

Price structures of the item for different sales channels, customer groups and individual customers. Includes sales prices, purchase prices and tier prices.

Physical dimensions and weight specifications of the item for storage, shipping and product presentation. Important for shipping cost calculations and storage space optimization.

Custom fields defined for the item to store additional information. Useful for special requirements or integrations.

Suppliers associated with the item including supplier-specific information such as purchase prices, delivery times and order intervals.

Variations of an item

deliveryStatusId
ID

Delivery status id determining the availability display of the item (e.g. 'immediately available', '2-3 days'). Tab 'Sonstiges'.

includeInPriceList
Boolean

Indicates whether the item can be included in exported price lists. Tab 'Sonstiges'.

ignoreOrderSuggestions
Boolean

Indicates whether order suggestions should be ignored for this item. If true, the item will not appear in automatic order suggestions. Tab 'Sonstiges'.

ignoreDiscounts
Boolean

Indicates whether the item is not eligible for discounts (Rabatte ignorieren / Nicht Rabattfähig). Tab 'Sonstiges'.

countryOfOrigin
String

Country of origin (Herkunftsland) - ISO code or country name. Max length 64. Tab 'Sonstiges'.

notes
String

Additional notes (Anmerkung) for the item - unlimited length. Tab 'Sonstiges'.

Features of an item

Attributes of an item

UnitPricing information of an item

SpecialPrices information of an item

ItemStorageConstraints information of an item

CrosssellingGroups of an item

A list of sales channels that should be activated after a successful update of the item. When omitted or null, the current sales channel assignment of the item stays unchanged. Sales channels that are active and included in this list remain active. Sales channels that are inactive and not included in this list remain inactive. Sales channels that are active but not included in this list are deactivated. Sales channels that are inactive but included in this list are activated. An empty list therefore deactivates every sales channel of the item. If a sales channel is deactivated for an item, the activation status of that sales channel for the item images remains unchanged to allow the original listing to be restored.

idempotencyKey
String

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.