Skip to main content
inputCreateSubsetStockItemCommandRequestInput

Fields

name
String!
required

Name of the item in the default language. Further languages and sales channel texts are the descriptions of the item.

identifiers

The identifiers of the item. The item number (SKU) is mandatory and unique.

categoryIds
[ID]!
required

The IDs of the categories the new item is assigned to. At least one: every item that is not a combination of a variation parent has a category, and an item without one is not valid (an empty list is refused with 400). A combination takes over the categories of its parent and is created through the combinations of the parent, which have no such field. Further assignments are made through the categories of the item.

isActive
Boolean

Whether the item is active. Defaults to true when omitted.

productGroupId
ID

The ID of the product group.

manufacturerId
ID

The ID of the manufacturer.

conditionId
ID

The ID of the item condition, for example new or used.

deliveryStatusId
ID

The ID of the delivery status of the item (the master data of delivery statuses, for example "in stock" or "ships in 3 days").

taxClassId
ID

The ID of the tax class. When omitted the item gets the company default. The value must reference an existing tax class.

shippingClassId
ID

The ID of the shipping class.

Outer dimensions as shipped.

Weights.

Customs information.

Sales unit and content with its base price.

stockManagement

Settings of the stock management.

dimensionSetId
ID!
required

The dimension set of the item. It cannot be changed afterwards.

subsetDimensions

One value per dimension of the dimension set.

reservation

How much of the item is reserved for production.

characteristicValueIds
[ID]

The characteristic values (German 'Merkmalwerte') assigned to the item. Omitted means none.

attributes

The attribute values of the item, per attribute, sales channel and language. Omitted means none. The attributes the system derives itself, such as those of a voucher, cannot be sent.

customFields

The custom field values of the item. Omitted means none. A custom field has to apply to the item, which depends on its product group.

freeTextVariations

The free-text variations of the item (German 'Freitext'), added in the same call. Every kind can have them. Omitted means none. Refused with 409 for an item of the fulfillment network.

The sales channels the item is activated in, set in the same call. The item has to be in a category that is active in each of them. Omitted means none; the item is activated afterwards through its sales channels.

The prices of the item, created in the same call. Every part is the model of the matching prices route. Omitted means the item is created without prices and they are set through those routes.

The supplier items of the item, created in the same call. Every entry is the model of the supplier item route. Omitted means none; they are added through the suppliers of the item.

disableAutomaticWorkflows
Boolean

Suppresses the automatic workflow triggers of this call. Defaults to false when omitted.

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.