VLB Hilfe

https://vlb.de/hilfe/
Admin
VLB (Verzeichnis Lieferbarer Bücher) is a German book directory platform that enables publishers,...
Tokens:189,130
Snippets:1,221
Trust Score:9.6
Update:7 months ago
Show doc for...
Tokens:
Raw
### GET /products/{id} (Product Detail)

Source: https://vlb.de/hilfe/datenbezug/rest-api

Retrieves comprehensive details for a specific product using its GTIN-13 or VLB-ID.

```APIDOC
## GET /products/{id}

### Description
Retrieves detailed information for a specific product. Data can be requested in JSON or ONIX format.

### Method
GET

### Endpoint
/products/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The GTIN-13 or 32-digit VLB-ID of the product

#### Query Parameters
- **format** (string) - Optional - The desired output format (json, onix2.1, onix3)

### Request Example
GET /products/9783000000000?format=json

### Response
#### Success Response (200)
- **product** (object) - Full product details including availability and metadata

#### Response Example
{
  "id": "9783000000000",
  "title": "Example Book",
  "availability": "in stock"
}
```

--------------------------------

### GET /products (Product Search)

Source: https://vlb.de/hilfe/datenbezug/rest-api

Allows searching for products using keywords, ISBNs, or complex boolean criteria including author, publisher, and classification filters.

```APIDOC
## GET /products

### Description
Performs a search for products based on provided query parameters. Supports boolean search syntax for filtering by criteria like author, publisher, and publication year.

### Method
GET

### Endpoint
/products

### Parameters
#### Query Parameters
- **q** (string) - Optional - Search term (ISBN, author, title, etc.)
- **filter** (string) - Optional - Boolean search criteria (e.g., publisher, year, language)
- **sort** (string) - Optional - Sorting criteria for the result list

### Request Example
GET /products?q=Ullstein&filter=year:2010

### Response
#### Success Response (200)
- **results** (array) - List of products matching the search criteria

#### Response Example
{
  "results": [
    { "id": "vlb-123", "title": "Example Book", "isbn": "978-3-00000000-0" }
  ]
}
```

--------------------------------

### GET /api/v2/cover/{isbn}/{size}

Source: https://vlb.de/hilfe/datenbezug/onix-titeldaten

Retrieves a product cover image from the VLB Assetstore. Supports optional resizing parameters.

```APIDOC
## GET /api/v2/cover/{isbn}/{size}

### Description
Retrieves a product cover image. Access requires a valid token. You can request specific sizes by appending a size parameter to the URL.

### Method
GET

### Endpoint
http://api.vlb.de/api/v2/cover/{isbn}/{size}

### Parameters
#### Path Parameters
- **isbn** (string) - Required - The 13-digit ISBN of the product.
- **size** (string) - Optional - Image size: 's' (90px width), 'm' (200px width), 'l' (599px height). Omit for original size.

#### Query Parameters
- **access_token** (string) - Required - The authentication token provided by VLB.

### Request Example
GET http://api.vlb.de/api/v2/cover/9783540537120/m?access_token=04186fb7-397d-47a0-a9be-fbdbc1b95a3b

### Response
#### Success Response (200)
- **Content-Type** (image/*) - The image file binary data.

#### Success Response (304)
- **Status** (304) - Not Modified (returned if using If-None-Match or If-Modified-Since headers).
```

--------------------------------

### GET /media/{id}

Source: https://vlb.de/hilfe/datenbezug/rest-api

Retrieves a specific media file associated with a product. Supports conditional requests using ETag or Last-Modified headers for performance optimization.

```APIDOC
## GET /media/{id}

### Description
Retrieves the binary content of a media file. Use ETag (If-None-Match) or Last-Modified (If-Modified-Since) headers to avoid redundant downloads.

### Method
GET

### Endpoint
/media/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique media file ID or GTIN-13 identifier.

#### Query Parameters
- **If-None-Match** (string) - Optional - The ETag value of the locally cached version.
- **If-Modified-Since** (string) - Optional - The last modified timestamp of the locally cached version.

### Request Example
GET /media/1234567890123
If-None-Match: "abc-123-xyz"

### Response
#### Success Response (200)
- **Body** (binary) - The media file content.

#### Not Modified (304)
- **Status** (304) - Returned when the local version is already up to date.

#### Response Example
HTTP/1.1 200 OK
ETag: "abc-123-xyz"
Content-Type: image/jpeg
[Binary Data]
```

--------------------------------

### Configure Media Metadata and Author Attribution in ONIX 3

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/mediendateien

Demonstrates how to define resource features such as copyright, ISNI, and contributor sequence numbers within an ONIX 3 message. The example shows both Short and Reference tag formats for linking an author to a specific media resource.

```ONIX 3 Short
<contributor>
  <b034>3</b034>
  <nameidentifier>
    <x415>16</x415>
    <b244>0000000120999104</b244>
  </nameidentifier>
</contributor>
<supportingresource>
  <x436>04</x436>
  <resourcefeature>
    <x438>01</x438>
    <x440>© Fred Fotograf</x440>
  </resourcefeature>
  <resourcefeature>
    <x438>05</x438>
    <x439>0000000120999104</x439>
  </resourcefeature>
  <resourcefeature>
    <x438>06</x438>
    <x439>3</x439>
  </resourcefeature>
</supportingresource>
```

```ONIX 3 Reference
<Contributor>
  <SequenceNumber>3</SequenceNumber>
  <NameIdentifier>
    <NameIDType>16</NameIDType>
    <IDValue>0000000120999104</IDValue>
  </NameIdentifier>
</Contributor>
<SupportingResource>
  <ResourceContentType>04</ResourceContentType>
  <ResourceFeature>
    <ResourceFeatureType>01</ResourceFeatureType>
    <FeatureNote>© Fred Fotograf</FeatureNote>
  </ResourceFeature>
  <ResourceFeature>
    <ResourceFeatureType>05</ResourceFeatureType>
    <FeatureValue>0000000120999104</FeatureValue>
  </ResourceFeature>
  <ResourceFeature>
    <ResourceFeatureType>06</ResourceFeatureType>
    <FeatureValue>3</FeatureValue>
  </ResourceFeature>
</SupportingResource>
```

--------------------------------

### POST /product/form

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/produktformangaben

Sets the product form (e.g., Hardcover, E-Book, Audio) to determine genre and retail placement.

```APIDOC
## POST /product/form

### Description
Defines the product form (e.g., 'BB' for Hardcover). This is a mandatory field for every product in the VLB system.

### Method
POST

### Endpoint
/product/form

### Request Body
- **ProductForm** (string) - Required - The specific code representing the product form based on ONIX codelists.

### Request Example
{
  "ProductForm": "BB"
}

### Response
#### Success Response (200)
- **status** (string) - Confirmation of successful metadata update.

#### Response Example
{
  "status": "success"
}
```

--------------------------------

### Define Media Mention in ONIX 3

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/zitierte-inhalte

Example demonstrating how to structure a media mention citation. It includes the source type, source title, and specific timestamp formatting for media events.

```ONIX 3 Short
<citedcontent>
   <x430>03</x430>
   <x427>00</x427>
   <x431>04</x431>
   <x428>Name der Sendung</x428>
   <x434>Interview mit dem Autor</x434>
   <x435>https://TV.de</x435>
   <contentdate>
      <x429>01</x429>
      <b306 dateformat="13">20211010T1355</b306>
   </contentdate>
</citedcontent>
```

```ONIX 3 Reference
<CitedContent>
   <CitedContentType>03</CitedContentType>
   <ContentAudience>00</ContentAudience>
   <SourceType>04</SourceType>
   <SourceTitle>Name der Sendung</SourceTitle>
   <CitationNote>Interview mit dem Autor</CitationNote>
   <ResourceLink>https://TV.de</ResourceLink>
   <ContentDate>
      <ContentDateRole>01</ContentDateRole>
      <Date dateformat="13">20211010T1355</Date>
   </ContentDate>
</CitedContent>
```

--------------------------------

### Define Online Review in ONIX 3

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/zitierte-inhalte

Example demonstrating how to structure an online review citation using CitedContent. It includes the source title, URL, and publication date with specific date formatting.

```ONIX 3 Short
<citedcontent>
	<x430>01</x430>
	<x427>03</x427>
	<x428>FAZ</x428>
	<x434>Bemerkung zur Rezension</x434>
	<x435>https/faz.net/rezension</x435>
	<contentdate>
		<x429>01</x429>
		<b306 dateformat="00">20210101</b306>
	</contentdate>
</citedcontent>
```

```ONIX 3 Reference
<CitedContent>
	<CitedContentType>01</CitedContentType>
	<ContentAudience>03</ContentAudience>
	<SourceTitle>FAZ</SourceTitle>
	<CitationNote>Bemerkung zur Rezension</CitationNote>
	<ResourceLink>https/faz.net/rezension</ResourceLink>
	<ContentDate>
		<ContentDateRole>01</ContentDateRole>
		<Date dateformat="00">20210101</Date>
	</ContentDate>
</CitedContent>
```

--------------------------------

### Rezensionszitat in ONIX 2.1 formatieren

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/zusatztexte

Beispiele für die Einbindung von Rezensionszitaten in ONIX 2.1. Da ONIX 2.1 im VLB nur eingeschränkte Felder unterstützt, muss die Quellenangabe direkt im Textfeld enthalten sein.

```ONIX 2.1 Short
<othertext>
  <d102>08</d102>
  <d103>06</d103>
  <d104 language="ger">Dieses Buch ist die Essenz des literarischen Schaffens von Bodo Kirchhoff. Und dabei ist es „nur“ eine Novelle. (Martin Doerry, Der Spiegel, 20.09.2016)</d104>
  <d109>20160920</d109>
</othertext>
<othertext>
  <d102>08</d102>
  <d103>06</d103>
  <d104 language="eng">This book is the essence of the literary work of Bodo Kirchhoff. And it is "only" a short story. (Martin Doerry, Der Spiegel, 20.09.2016)</d104>
  <d109>20160920</d109>
</othertext>
```

```ONIX 2.1 Reference
<OtherText>
  <TextTypeCode>08</TextTypeCode>
  <TextFormat>06</TextFormat>
  <Text language="ger">Dieses Buch ist die Essenz des literarischen Schaffens von Bodo Kirchhoff. Und dabei ist es „nur“ eine Novelle. (Martin Doerry, Der Spiegel, 20.09.2016)</Text>
  <TextPublicationDate>20160920</TextPublicationDate>
</OtherText>
<OtherText>
  <TextTypeCode>08</TextTypeCode>
  <TextFormat>06</TextFormat>
  <Text language="eng">This book is the essence of the literary work of Bodo Kirchhoff. And it is "only" a short story. (Martin Doerry, Der Spiegel, 20.09.2016)</Text>
  <TextPublicationDate>20160920</TextPublicationDate>
</OtherText>
```

--------------------------------

### ONIX 3 Reference Example for Game Classification

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/spiele-spielware

This snippet provides an example of game classification using the ONIX 3 Reference format, highlighting the main subject and other classifications.

```APIDOC
## ONIX 3 Reference Example for Game Classification

### Description
This example illustrates the ONIX 3 Reference format for classifying a board game as the main subject, along with its secondary classification as a crime/detective game and its characteristic as a strategy game.

### Method
GET

### Endpoint
/websites/vlb_de_hilfe/onix/games-puzzles-toys/reference

### Response
#### Success Response (200)
- **onix_xml** (string) - The XML representation of the classification in ONIX 3 Reference format.

#### Response Example
```xml
<Subject>
  <MainSubject/>
  <SubjectSchemeIdentifier>C7</SubjectSchemeIdentifier>
  <SubjectCode>A101</SubjectCode>
  <SubjectHeadingText>Brettspiel</SubjectHeadingText>
</Subject>
<Subject>
  <SubjectSchemeIdentifier>C7</SubjectSchemeIdentifier>
  <SubjectCode>A110</SubjectCode>
  <SubjectHeadingText>Krimi- & Detektivspiel</SubjectHeadingText>
</Subject>
<Subject>
  <SubjectSchemeIdentifier>C7</SubjectSchemeIdentifier>
  <SubjectCode>A201</SubjectCode>
  <SubjectHeadingText>Strategiespiel</SubjectHeadingText>
</Subject>
```
```

--------------------------------

### Price Validity Period

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/preise

Defines the time frame during which a price is valid. This allows for sequential pricing by specifying start and end dates. The end date of a previous price must be the day before the start date of the next price.

```APIDOC
## Price Validity Period

### Description
Allows setting a start and/or end date for a price, enabling sequential pricing. The end date of a preceding price must be the day before the next price's start date.

### Method
Not applicable (describes data structure)

### Endpoint
Not applicable (describes data structure)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
*   **PriceEffectiveFrom** (Date) - Optional - The start date for the price validity.
*   **PriceEffectiveUntil** (Date) - Optional - The end date for the price validity.
*   **PriceDate** (Composite) - Optional - A composite structure for price date information in ONIX 3.
    *   **PriceDateRole** (Code) - Required - Specifies the role of the date (e.g., start, end, combined).
    *   **Date** (Date) - Required - The actual date value.
    *   **dateformat** (Code) - Required - The format of the date provided (e.g., '00' for YYYYMMDD, '06' for YYYYMMDDYYYYMMDD).

### Request Example
#### ONIX 2.1 Short
```xml
<j161>20180101</j161>
<j162>20181231</j162>
```

#### ONIX 2.1 Reference
```xml
<PriceEffectiveFrom>20180101</PriceEffectiveFrom>
<PriceEffectiveUntil>20181231</PriceEffectiveUntil>
```

#### ONIX 3 Short
```xml
<pricedate>
  <x476>14</x476>
  <b306 dateformat="00">20180101</b306>
</pricedate>
<pricedate>
  <x476>15</x476>
  <b306 dateformat="00">20181231</b306>
</pricedate>

---

<pricedate>
  <x476>24</x476>
  <b306 dateformat="06">2018010120181231</b306>
</pricedate>
```

#### ONIX 3 Reference
```xml
<PriceDate>
  <PriceDateRole>14</PriceDateRole>
  <Date dateformat="00">20180101</Date>
</PriceDate>
<PriceDate>
  <PriceDateRole>15</PriceDateRole>
  <Date dateformat="00">20181231</Date>
</PriceDate>

---

<PriceDate>
  <PriceDateRole>24</PriceDateRole>
  <Date dateformat="06">2018010120181231</Date>
</PriceDate>
```

### Response
#### Success Response (200)
Not applicable (describes data structure)

#### Response Example
Not applicable (describes data structure)
```

--------------------------------

### POST /product/title/prefix

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/titel-produktsprache

Handles titles with prefixes to allow for accurate sorting in search results.

```APIDOC
## POST /product/title/prefix

### Description
Allows submission of titles split into prefix and main text components for sorting purposes in ONIX 3.

### Method
POST

### Endpoint
/product/title/prefix

### Parameters
#### Request Body
- **TitlePrefix** (string) - Optional - The prefix of the title (e.g., 'Der')
- **TitleWithoutPrefix** (string) - Required - The main title without the prefix (e.g., 'Vorleser')
- **NoPrefix** (boolean) - Optional - Flag to indicate no prefix exists

### Request Example (ONIX 3 Reference)
<TitlePrefix>Der</TitlePrefix>
<TitleWithoutPrefix>Vorleser</TitleWithoutPrefix>

### Response
#### Success Response (200)
- **status** (string) - Confirmation of successful title processing

#### Response Example
{
  "status": "success",
  "message": "Title with prefix processed"
}
```

--------------------------------

### ONIX 3 Short Beispiel für Listenplatzierung

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/zitierte-inhalte

Dieses Snippet zeigt ein Beispiel für die Platzierung eines Produkts auf einer Bestsellerliste im ONIX 3 Short Format. Es enthält Elemente wie x430 (CitedContentType), x428 (SourceTitle), x432 (ListName), x433 (PositionOnList), x434 (CitationNote) und x435 (ResourceLink).

```xml
<citedcontent>
 
 	<x430>02</x430>
 
 	<x427>00</x427>
 
 	<x428>Spiegel Online</x428>
 
 	<x432>Spiegel-Bestsellerliste Belletristik Taschenbuch</x432>
 
 	<x433>1</x433>
 
 	<x434>nach nur 3 Wochen auf Platz 1</x434>
 
 	<x435>https://spiegel.de/bestseller</x435>
 
 	<contentdate>
 
 		<x429>02</x429>
 
 		<b306 dateformat="02">202050</b306>
 
 	</contentdate>
 
</citedcontent>
```

--------------------------------

### GET /availability-feed

Source: https://vlb.de/hilfe/datenbezug/lieferbarkeitsinformationen

Retrieves the XML-formatted availability feed containing product stock status from various distributors.

```APIDOC
## GET /availability-feed

### Description
Returns an XML feed containing current availability information for products across multiple distributors. The feed allows users to check stock status beyond the publisher's base information.

### Method
GET

### Endpoint
/availability-feed

### Parameters
#### Query Parameters
- **format** (string) - Optional - Defaults to XML

### Request Example
GET /availability-feed

### Response
#### Success Response (200)
- **AvailabilityFeed** (XML) - Root node containing a list of Product elements.

#### Response Example
```xml
<AvailabilityFeed>
  <Product>
    <GTIN>9783499626142</GTIN>
    <AvailabilitySupplier>
      <Name>VVA</Name>
      <AvailabilityCode>15</AvailabilityCode>
      <AvailabilityText>lieferbar innerhalb von 14 Tagen</AvailabilityText>
    </AvailabilitySupplier>
  </Product>
</AvailabilityFeed>
```
```

--------------------------------

### Define E-Book Format Versioning (ONIX 3)

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/produktformangaben

Illustrates how to specify the e-book format version (e.g., EPUB 3.3) using ProductFormFeature composites in ONIX 3.

```ONIX 3 Short
<b333>E101</b333>
<productformfeature>
  <b334>15</b334>
  <b335>101A</b335>
</productformfeature>
```

```ONIX 3 Reference
<ProductFormDetail>E101</ProductFormDetail>
<ProductFormFeature>
  <ProductFormFeatureType>15</ProductFormFeatureType>
  <ProductFormFeatureValue>101A</ProductFormFeatureValue>
</ProductFormFeature>
```

--------------------------------

### Link Video - ONIX 2.1 Short

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/mediendateien

This ONIX 2.1 short format demonstrates how to link a trailer video. It specifies the media file type and the URL for the video content.

```xml
<mediafile>
  <f114>36</f114>
  <f116>01</f116>
  <f117>https://website/trailer</f117>
</mediafile>
```

--------------------------------

### ONIX: Specify Publisher Website Link

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/verlag

This snippet shows how to link to a publisher's website, specifically for product presentations. It includes short and reference formats for ONIX 2.1 and ONIX 3.0, detailing the website role, description, and URL.

```XML
<website>
 
 <b367>02</b367>
 
 <b294>Produktpräsentation auf der Website des Verlags</b294>
 
 <b295>http://verlag.de/produkt</b295>
 
</website>
```

```XML
<Website>
 
 <WebsiteRole>02</WebsiteRole>
 
 <WebsiteDescription>Produktpräsentation auf der Website des Verlags</WebsiteDescription>
 
 <WebsiteLink>http://verlag.de/produkt</WebsiteLink>
 
</Website>
```

--------------------------------

### Price Information With VAT Splitting (ONIX 3.0 Reference)

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/preise

Reference guide for ONIX 3.0 price structure with VAT splitting details.

```APIDOC
## Price Information With VAT Splitting (ONIX 3.0 Reference)

### Description
Provides a reference for ONIX 3.0 price elements, detailing the structure for VAT splitting.

### Method
N/A

### Endpoint
N/A

### Parameters
N/A

### Request Example
N/A

### Response
#### Success Response (200)
- **PriceType** (string) - Type of price.
- **PriceStatus** (string) - Status of the price.
- **PriceAmount** (string) - The total price amount.
- **Tax** (object) - Contains tax details for each tax component.
  - **TaxType** (string) - Type of tax.
  - **TaxRateCode** (string) - Tax rate code.
  - **TaxRatePercent** (string) - Tax rate percentage.
  - **TaxableAmount** (string) - Taxable amount.
  - **TaxAmount** (string) - Tax amount.
- **CurrencyCode** (string) - Currency code.
- **Territory** (object) - Geographic area for the price.
  - **CountriesIncluded** (string) - Country codes included.
- **PriceDate** (object) - Date information for the price.
  - **PriceDateRole** (string) - Role of the date.
  - **Date** (string) - The date value.

#### Response Example
```xml
<Price>
  <PriceType>04</PriceType>
  <PriceStatus>02</PriceStatus>
  <PriceAmount>22.99</PriceAmount>
  <Tax>
    <TaxType>01</TaxType>
    <TaxRateCode>R</TaxRateCode>
    <TaxRatePercent>7</TaxRatePercent>
    <TaxableAmount>17.19</TaxableAmount>
    <TaxAmount>1.20</TaxAmount>
  </Tax>
  <Tax>
    <TaxType>01</TaxType>
    <TaxRateCode>S</TaxRateCode>
    <TaxRatePercent>19</TaxRatePercent>
    <TaxableAmount>3.87</TaxableAmount>
    <TaxAmount>0.73</TaxAmount>
  </Tax>
  <CurrencyCode>EUR</CurrencyCode>
  <Territory>
    <CountriesIncluded>DE</CountriesIncluded>
  </Territory>
  <PriceDate>
    <PriceDateRole>14</PriceDateRole>
    <Date dateformat="00">20180101</Date>
  </PriceDate>
  <PriceDate>
    <PriceDateRole>15</PriceDateRole>
    <Date dateformat="00">20181231</Date>
  </PriceDate>
</Price>
```
```

--------------------------------

### Define EPUB E-Book Format

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/produktformangaben

Shows the standard representation of an EPUB format e-book using ONIX 2.1 and ONIX 3 tags.

```ONIX 2.1 Short
<b211>029</b211>
```

```ONIX 2.1 Reference
<EpubType>029</EpubType>
```

```ONIX 3 Short
<b333>E101</b333>
```

```ONIX 3 Reference
<ProductFormDetail>E101</ProductFormDetail>
```

--------------------------------

### Define Verkehrsnummer Identifier in ONIX

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/verlag

Specifies the Verkehrsnummer (Code 04) for publisher identification. Used as an alternative to the MVB-Kennnummer.

```ONIX 2.1 Short
<b241>04</b241>
<b243>12333</b243>
```

```ONIX 2.1 Reference
<NameCodeType>04</NameCodeType>
<NameCodeValue>12333</NameCodeValue>
```

```ONIX 3 Short
<publisheridentifier>
  <x447>04</x447>
  <b244>12333</b244>
</publisheridentifier>
```

```ONIX 3 Reference
<PublisherIdentifier>
  <PublisherIDType>04</PublisherIDType>
  <IDValue>12333</IDValue>
</PublisherIdentifier>
```

--------------------------------

### Price Information Without VAT Splitting (ONIX 3.0 Reference)

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/preise

Reference guide for ONIX 3.0 price structure without VAT splitting.

```APIDOC
## Price Information Without VAT Splitting (ONIX 3.0 Reference)

### Description
Provides a reference for ONIX 3.0 price elements, focusing on scenarios without VAT breakdown.

### Method
N/A

### Endpoint
N/A

### Parameters
N/A

### Request Example
N/A

### Response
#### Success Response (200)
- **PriceType** (string) - Type of price.
- **PriceStatus** (string) - Status of the price.
- **PriceAmount** (string) - The price amount.
- **Tax** (object) - Contains tax details.
  - **TaxType** (string) - Type of tax.
  - **TaxRateCode** (string) - Tax rate code.
  - **TaxRatePercent** (string) - Tax rate percentage.
- **CurrencyCode** (string) - Currency code.
- **Territory** (object) - Geographic area for the price.
  - **CountriesIncluded** (string) - Country codes included.
- **PriceDate** (object) - Date information for the price.
  - **PriceDateRole** (string) - Role of the date.
  - **Date** (string) - The date value.

#### Response Example
```xml
<Price>
  <PriceType>04</PriceType>
  <PriceStatus>02</PriceStatus>
  <PriceAmount>22.99</PriceAmount>
  <Tax>
    <TaxType>01</TaxType>
    <TaxRateCode>R</TaxRateCode>
    <TaxRatePercent>7</TaxRatePercent>
  </Tax>
  <CurrencyCode>EUR</CurrencyCode>
  <Territory>
    <CountriesIncluded>DE</CountriesIncluded>
  </Territory>
  <PriceDate>
    <PriceDateRole>14</PriceRole>
    <Date dateformat="00">20180101</Date>
  </PriceDate>
  <PriceDate>
    <PriceDateRole>15</PriceDateRole>
    <Date dateformat="00">20181231</Date>
  </PriceDate>
</Price>
```
```

--------------------------------

### Define MVB-Kennnummer Identifier in ONIX

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/verlag

Specifies the MVB-Kennnummer (Code 05) for publisher identification. This is mandatory for the main publisher in the VLB.

```ONIX 2.1 Short
<b241>05</b241>
<b243>5100000</b243>
```

```ONIX 2.1 Reference
<NameCodeType>05</NameCodeType>
<NameCodeValue>5100000</NameCodeValue>
```

```ONIX 3 Short
<publisheridentifier>
  <x447>05</x447>
  <b244>5100000</b244>
</publisheridentifier>
```

```ONIX 3 Reference
<PublisherIdentifier>
  <PublisherIDType>05</PublisherIDType>
  <IDValue>5100000</IDValue>
</PublisherIdentifier>
```

--------------------------------

### POST /product/composition

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/produktformangaben

Defines whether a product is a single-part item or a multi-part product (e.g., book with CD).

```APIDOC
## POST /product/composition

### Description
Defines the composition of the product. Use '00' for single-part products and '10' for multi-part products.

### Method
POST

### Endpoint
/product/composition

### Request Body
- **ProductComposition** (string) - Required - The code representing product composition (00 for single, 10 for multi-part).

### Request Example
{
  "ProductComposition": "00"
}

### Response
#### Success Response (200)
- **status** (string) - Confirmation of successful metadata update.

#### Response Example
{
  "status": "success"
}
```

--------------------------------

### Define Physical Product Weight in ONIX

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/umfang

Shows the implementation of weight specifications using the Measure composite with type code 08. Examples are provided for both ONIX 2.1 and 3.0 in Short and Reference formats.

```ONIX 2.1 Short
<measure>
  <c093>08</c093>
  <c094>900</c094>
  <c095>gr</c095>
</measure>
```

```ONIX 2.1 Reference
<Measure>
  <MeasureTypeCode>08</MeasureTypeCode>
  <Measurement>900</Measurement>
  <MeasureUnitCode>gr</MeasureUnitCode>
</Measure>
```

```ONIX 3 Short
<measure>
  <x315>08</x315>
  <c094>900</c094>
  <c095>gr</c095>
</measure>
```

```ONIX 3 Reference
<Measure>
  <MeasureType>08</MeasureType>
  <Measurement>900</Measurement>
  <MeasureUnitCode>gr</MeasureUnitCode>
</Measure>
```

--------------------------------

### Define Publisher Name in ONIX

Source: https://vlb.de/hilfe/vlb-onix-empfehlungen/verlag

Specifies the official name of the publisher. If an ID is provided, the VLB system may automatically update this based on the official directory.

```ONIX 2.1 / ONIX 3 Short
<b081>Der Verlag</b081>
```

```ONIX 2.1 / ONIX 3 Reference
<PublisherName>Der Verlag</PublisherName>
```
Tokens:
Raw