Menü

Sub-products and Adjuncts

Sub-products and Adjuncts

A product contains sub-products, if:

  • Adjuncts have been added to the product,
  • The product contains multiple parts or volumes, or
  • A bundle of products is being sold, which may contain the same product multiple times, or may contain several different products.

Products composed of more than one sub-product are called multi-part products. This information is already required to be provided with the entries for composition and product form.

Frequently, notes on sub-products and adjuncts are present only in descriptions. The customer does not always notice these. In the section on sub-products, you are able to provide concrete details about the sub-products or adjuncts contained in the product. By providing structured information on sub-products, booksellers are able to make them more clearly visible to customers.

Please note: if your multi-part product contains separately listed VAT, you are actually required to provide details on the sub-products, because if you do not, they cannot be displayed on the bill with their respective partial prices.

Description of sub-products

Sub-products are displayed in ONIX 3.0 using ProductPart composites. For each sub-product, a separate composite is to be created. If your product contains sub-products of the same type, you can file this in a composite by stating the number.

For multi-part products, it is important to determine which part is the main, or primary, part. If, e. g. you include a CD with your book, the book is the main product, and the CD the adjunct. In ONIX 3.0, the primary part is marked with PrimaryPart or x457.

For each sub-product, the product form (ProductForm or b012) must be defined. You can do this by providing a detailed product form (ProductFormDetail or b333) and specifying the product content (ProductContentType or b385). Particularly with digital products, you should utilise detailed product forms and provide additional information on product content. Should you find the coded details insufficiently detailed, you can also add a textual product form description (ProductFormDescription or b014).

In order to note how many sub-products your product contains, you need to provide a number for each sub-product listed (as a rule per product form). E. g., if your product consists of a book and two CDs, the composite for the book would feature the number 1 and the composite for the CDs the number 2.

In ONIX 3.0 you need to specify whether the parts are identical, or merely the same type of product. If both CDs from the example above had different content, you would specify
NumberOfItemsOfThisForm or x322. If you instead had a bundle consisting of 10 copies of the same product, you would use NumberOfCopies or x323.

A product containing the following elements, with the book as the primary element, would have the following sub-product data.

  • A book with a flexible paperback binding of the type Text
  • A video DVD in PAL format of the type Video showing a performance
ONIX 3.0 Short
<productpart>
 <x457/>
 <b012>BC</b012> 
 <b333>B131</b333> 
 <b014>Description of the book</b014>
 <b385>10</b385>
 <x322>1</x322>
 <x323>1</x323>
</productpart>
<productpart> 
 <b012>VI</b012> 
 <b333>V201</b333> 
 <b014>Description of the DVD</b014> 
 <b385>27</b385>
 <x322>1</x322>
 <x323>1</x323>
</productpart>
ONIX 3.0 Reference
<ProductPart>
 <PrimaryPart/>
 <ProductForm>BC</ProductForm>
 <ProductFormDetail>B131</ProductFormDetail>
 <ProductFormDescription>Description of the book</ProductFormDescription>
 <ProductContentType>10</ProductContentType>
 <NumberOfItemsOfThisForm>1</NumberOfItemsOfThisForm>
 <NumberOfCopies>1</NumberOfCopies>
</ProductPart>
<ProductPart>
 <ProductForm>VI</ProductForm>
 <ProductFormDetail>V201</ProductFormDetail>
 <ProductFormDescription>Description of the DVD</ProductFormDescription>
 <ProductContentType>27</ProductContentType>
 <NumberOfItemsOfThisForm>1</NumberOfItemsOfThisForm>
 <NumberOfCopies>1</NumberOfCopies> 
</ProductPart>

A bundle with 10 identical vinyl records can be entered as follows.

ONIX 3.0 Short
<productpart>
 <b012>AE</b012> 
 <x323>10</x323>
</productpart>
ONIX 3.0 Reference
<ProductPart>
 <ProductForm>AE</ProductForm>
 <NumberOfCopies>10</NumberOfCopies>
</ProductPart>


Product number for sub-products

Product numbers for sub-products are to be provided in the two following cases. In all other cases, product numbers for sub-products are not mandatory.

  1. the sub-products contained are available separately, or
  2. the product requires separately listed VAT, so that the sub-products need to be listed individually on the invoice.

In ONIX 3.0, the product number of a sub-product is to be listed in the product identifier composite. The product number itself is to be provided in ProductIDType or b221. The type of product number is to be specified in ProductIDType or b221. For Metabooks, possible types of product numbers are available in the following code list 5.

CodeProduct number
01Proprietary
03GTIN-13
15ISBN-13

Providing a proprietary product number allows you to unambiguously identify sub-products without GTIN-13 or ISBN-13 within a separate VAT listing and hence enable them to be displayed on the invoice.

A proprietary product number should always follow the pattern

  • “GTIN main product” + “n”

Wherein all sub-products without GTIN-13 or ISBN 13 are numbered beginning with a value of “1” for “n”.

If in a multi-part product with the ISBN-13 9783000000003 only the included book with the ISBN-13 9783111111117 has an actual product number, it is necessary to provide all other sub-products with proprietary product numbers as shown below.

ONIX 3.0 Short
<productpart>
 <x457/>
 <productidentifier>
 <b221>15</b221>
 <b244>9783111111117</b244>
 </productidentifier>
 <b012>BC</b012>
 <x322>1</x322>
</productpart>
<productpart>
 <productidentifier>
 <b221>01</b221>
 <b244>9783000000003-1</b244>
 </productidentifier>
 <b012>VI</b012>
 <x322>1</x322>
</productpart>
<productpart>
 <productidentifier>
 <b221>01</b221>
 <b244>9783000000003-2</b244>
 </productidentifier>
 <b012>PB</b012>
 <x322>1</x322>
</productpart>
ONIX 3.0 Reference
<ProductPart>
 <ProductIdentifier>
 <ProductIDType>15</ProductIDType>
 <IDValue>9783111111117</IDValue>
 </ProductIdentifier>
 <ProductForm>BC</ProductForm>
 <NumberOfItemsOfThisForm>1</NumberOfItemsOfThisForm>
</ProductPart>
<ProductPart>
 <ProductIdentifier>
 <ProductIDType>01</ProductIDType>
 <IDValue>9783000000003-1</IDValue>
 </ProductIdentifier>
 <ProductForm>VI</ProductForm>
 <NumberOfItemsOfThisForm>1</NumberOfItemsOfThisForm>
</ProductPart>
<ProductPart>
 <ProductIdentifier>
 <ProductIDType>01</ProductIDType>
 <IDValue>9783000000003-2</IDValue>
 </ProductIdentifier>
 <ProductForm>PB</ProductForm>
 <NumberOfItemsOfThisForm>1</NumberOfItemsOfThisForm>
</ProductPart>