Skip to main content
GET
Retrieves a single article by its ID including all sub-elements

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-companyid
string

The Company-Id (int or uuid) of the company on whose behalf the request is executed.

x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Path Parameters

itemId
string<uuid>
required
Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

Response

Complete item details including all sub-elements

id
string<uuid>
required

Item id

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

identifiers
object
required

Various identifiers of the item for unique identification (SKU, GTIN, ISBN, etc.)

productGroupId
string<uuid>

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.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

shippingClassId
string<uuid>

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

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

manufacturerId
string<uuid>

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

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

categories
object

Categories to which the item is assigned

descriptions
object

List of item descriptions in different languages

prices
object

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

images
object

Images associated with the item

measurements
object

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

customFields
object

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

suppliers
object

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

includeInPriceList
boolean

Indicates whether the item can be included in exported price lists. From 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. From Tab 'Sonstiges'.

ignoreDiscounts
boolean

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

countryOfOrigin
string

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

notes
string

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

variations
object

Variations of an item

features
object

Features of an item

attributes
object

Attributes of an item

unitPricing
object

UnitPricing information of an item

specialPrices
object

SpecialPrices information of an item

storageConstraints
object

ItemStorageConstraints information of an item