ONIX metadata

The Luisterhuis catalogue of audiobook products contains all metadata of the audiobooks, like author, publisher, prices et cetera. The data is supplied in XML following the international ONIX 3.0 guidelines.

ONIX for Books is a worldwide XML standard to describe book information. It enables connecting the servers of publishers, distributors and retailers, without any conversion or manual data entry of the book data. Information about the ONIX standard is available online on www.editeur.org

It is important to know that to process the Luisterhuis XML files, you will have to 'know' how ONIX works. We can recommend downloading the documentation here: http://www.editeur.org/93/Release- 3.0-Downloads/

Chapter 5 contains information about the specific ONIX elements for audiobooks.

The basic steps to sell audiobooks using Luisterhuis API’s

It all starts with the initial retrieval of the product catalogue from Luisterhuis to incorporate the metadata in your own system. After the Luisterhuis audiobook products are available in your system, you can sell them to your customers. You will also have to check regularly if there are new or changed products. (New products and updated metadata are added on a daily basis; sometimes the price or the description of an existing product can change). The functions for catalogue retrieval are described in Chapter 4.

When an audiobook is being sold from your system, it is common practice to first check if the product is still available at Luisterhuis. So, before you accept payment from your customer, check the availability. There is an API call for that. (In fact: there are two ways of checking: you can simply check, or you can combine the checking with the placement of an order). The reason is not that the product can be out of stock, but the product can be withdrawn from the catalogue due to commercial or legal reasons. The functions for order placement are described in Chapter 6.

After you have received a confirmation that the product is still available, you can proceed to the checkout procedure in your own shop and accept payment from your customer.

When your shop places an order at Luisterhuis, you will have to supply Luisterhuis with some details of the order, like the product(s) to order, the customer name and/or their e-mail address and your internal order number. After Luisterhuis accepts your order, it will supply you with a Luisterhuis order id.

Using this Luisterhuis order id, your shop can request the download link. This download link can be stored in a private area on your site, available only for your end user. And/or you can send the link by e-mail to your end user. Using this link, the end user can download the ZIP files containing the audiobooks. The functions for handling the download links are described in Chapter 7.

Accounting and reporting

Luisterhuis handles all end user orders and fulfils the download links. Therefore Luisterhuis ‘knows’ about every end user transaction. Luisterhuis aggregates this data for the various publishers and uses this data for invoicing and pay-out purposes.

Depending on the agreement the web shop has with CB, they might receive a monthly or quarterly receipt with a detailed description of all audiobooks retrieved, played and/or sold.

A representative of the web shop (usually a member of the support desk) also has access to a real time report of all transactions and sales reports through a dashboard located at www.luisterhuis.nl/reseller or stub-www.luisterhuis.nl/reseller (testing purposes).

This dashboard offers an overview of all available titles, all basic metadata and all transactions. The dashboard can also be used to reset already used (or expired) download links. The dashboard is described in detail in Chapter 8: Reseller dashboard for web shops.

API for catalogue and metadata

Summary of functions

Luisterhuis uses a RESTful web service to provide all audiobook metadata to a web shop.

The interface offers the following API functions:

Catalogue metadata in ONIX 3 format
Single product metadata in ONIX 3 format

It is best practice to call the API once a day every 24 hours (for instance every night between 02:00 and 06:00).

Catalogue metadata in ONIX 3 format

To retrieve all metadata of all available audiobooks available for the web shop you can use the inventory API call. The inventory call supports the retrieval of ONIX metadata of a full catalogue (inventory) or only the updates over a certain period (‘what’s new since yesterday’).

Action

/v3/inventory/

Method

GET

Parameters

offset&limit

?offset=[offset]&limit=[limit]

Offset defines the number of products to be skipped. Default is 0.
Limit defines the number of products in the ONIX. Default is 200, max is 500.

modifiedfrom

?modifiedfrom=[date]

Modifiedfrom filters on new and modified products from specified date and
time. Format date YYYYMMDDHHIISS, YYYY = year, MM = month, DD = day,
HH = hour, II = minute, SS = second

Timezone: CET/CEST (= UTC+2)

Example:

To retrieve the first 100 ONIX metadata records from all products, use:

https://rest.luisterhuis.nl/v3/inventory/?offset=0&limit=100

Click here to expand for ONIX message with 1 complete product metadata

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage xmlns="http://ns.editeur.org/onix/3.0/reference" release="3.0">
	<Header>
		<Sender>
			<SenderIdentifier>
				<SenderIDType>10</SenderIDType>
				<IDValue>7237977</IDValue>
			</SenderIdentifier>
			<SenderName>Luisterhuis</SenderName>
			<ContactName>Content</ContactName>
			<EmailAddress>content@luisterhuis.nl</EmailAddress>
		</Sender>
		<MessageNumber>20210218162644</MessageNumber>
		<SentDateTime>20210218T1626</SentDateTime>
	</Header>
    <Product>
		<RecordReference>9789490938024</RecordReference>
		<NotificationType>03</NotificationType>
		<ProductIdentifier>
			<ProductIDType>01</ProductIDType>
			<IDValue>18</IDValue>
		</ProductIdentifier>
		<ProductIdentifier>
			<ProductIDType>03</ProductIDType>
			<IDValue>9789490938024</IDValue>
		</ProductIdentifier>
		<DescriptiveDetail>
			<ProductComposition>00</ProductComposition>
			<ProductForm>AJ</ProductForm>
			<ProductFormDetail>A103</ProductFormDetail>
			<PrimaryContentType>01</PrimaryContentType>
			<TitleDetail>
				<TitleType>01</TitleType>
				<TitleElement>
					<TitleElementLevel>01</TitleElementLevel>
					<TitleText>Alles wat je wilt weten over het heelal</TitleText>
					<Subtitle>Een Time2Learn luistercursus over het heelal</Subtitle>
				</TitleElement>
			</TitleDetail>
			<Contributor>
				<SequenceNumber>1</SequenceNumber>
				<ContributorRole>A01</ContributorRole>
				<NameIdentifier>
					<NameIDType>01</NameIDType>
					<IDTypeName>Luisterhuis AuthorID</IDTypeName>
					<IDValue>2860</IDValue>
				</NameIdentifier>
				<PersonName>Noortje Henrichs</PersonName>
				<NamesBeforeKey>Noortje</NamesBeforeKey>
				<KeyNames>Henrichs</KeyNames>
				<BiographicalNote textformat="02"><![CDATA[<br />]]></BiographicalNote>
			</Contributor>
			<Contributor>
				<SequenceNumber>2</SequenceNumber>
				<ContributorRole>A01</ContributorRole>
				<NameIdentifier>
					<NameIDType>01</NameIDType>
					<IDTypeName>Luisterhuis AuthorID</IDTypeName>
					<IDValue>2859</IDValue>
				</NameIdentifier>
				<PersonName>Adrienne Simons</PersonName>
				<NamesBeforeKey>Adrienne</NamesBeforeKey>
				<KeyNames>Simons</KeyNames>
				<BiographicalNote textformat="02"><![CDATA[<br />]]></BiographicalNote>
			</Contributor>
			<Contributor>
				<SequenceNumber>3</SequenceNumber>
				<ContributorRole>E07</ContributorRole>
				<PersonName>Martijn Warnas</PersonName>
				<NamesBeforeKey>Martijn</NamesBeforeKey>
				<KeyNames>Warnas</KeyNames>
			</Contributor>
			<Contributor>
				<SequenceNumber>4</SequenceNumber>
				<ContributorRole>E07</ContributorRole>
				<PersonName>Adrienne Simons</PersonName>
				<NamesBeforeKey>Adrienne</NamesBeforeKey>
				<KeyNames>Simons</KeyNames>
			</Contributor>
			<Contributor>
				<SequenceNumber>5</SequenceNumber>
				<ContributorRole>E07</ContributorRole>
				<PersonName>Matthé Smit</PersonName>
				<NamesBeforeKey>Matthé</NamesBeforeKey>
				<KeyNames>Smit</KeyNames>
			</Contributor>
			<EditionType>UBR</EditionType>
			<Language>
				<LanguageRole>01</LanguageRole>
				<LanguageCode>dut</LanguageCode>
			</Language>
			<Language>
				<LanguageRole>08</LanguageRole>
				<LanguageCode>dut</LanguageCode>
			</Language>
			<Extent>
				<ExtentType>09</ExtentType>
				<ExtentValue>3648</ExtentValue>
				<ExtentUnit>06</ExtentUnit>
			</Extent>
			<Extent>
				<ExtentType>09</ExtentType>
				<ExtentValue>0010048</ExtentValue>
				<ExtentUnit>16</ExtentUnit>
			</Extent>
			<Extent>
				<ExtentType>22</ExtentType>
				<ExtentValue>84</ExtentValue>
				<ExtentUnit>19</ExtentUnit>
			</Extent>
			<Subject>
				<MainSubject/>
				<SubjectSchemeIdentifier>10</SubjectSchemeIdentifier>
				<SubjectCode>SCI004000</SubjectCode>
			</Subject>
			<Subject>
				<MainSubject/>
				<SubjectSchemeIdentifier>32</SubjectSchemeIdentifier>
				<SubjectCode>400</SubjectCode>
			</Subject>
			<Subject>
				<SubjectSchemeIdentifier>32</SubjectSchemeIdentifier>
				<SubjectCode>910</SubjectCode>
			</Subject>
		</DescriptiveDetail>
		<CollateralDetail>
			<TextContent>
				<TextType>02</TextType>
				<ContentAudience>00</ContentAudience>
				<Text><![CDATA[Wat is een zwart-gat? Hoe lang heeft de aarde nog? Hoe is het universum ontstaan? Time2Learn legt het allemaal uit in duidelijke taal. Een complete cursus in één uur.]]></Text>
				<ContentDate>
					<ContentDateRole>01</ContentDateRole>
					<Date dateformat="00">20061115</Date>
				</ContentDate>
			</TextContent>
			<TextContent>
				<TextType>03</TextType>
				<ContentAudience>00</ContentAudience>
				<Text textformat="02"><![CDATA[Hebben sterrenstelsels en planeten altijd je fantasie geprikkeld? En ben je altijd geïnteresseerd geweest in alles wat buiten onze dampkring te vinden is? Dan is deze cursus een must!<br />
<br />In deze Time2Learn kun je genieten van de volgende modules: De aarde, de zon en de maan, de planeten, sterren en sterrenstelsels, Het einde van sterren, de oerknal en leven in de ruimte. We wensen je een leerzame tijd toe!<br>
<br>
<b>Inhoud</b><br>
Wil jij weten wat het universum jou te bieden heeft! Deze cursus vertelt je alles wat je moet weten!<br> 
- Wat is de Big-Crunch theorie?<br>
- Hoe snel draait onze aarde?<br>
- Wie speelde er golf op de maan?<br>
- Wat is een zwart-gat?<br>
- Hoelang heeft onze aarde nog?<br>
En nog veel meer dan dat!<br />]]></Text>
			</TextContent>
			<SupportingResource>
				<ResourceContentType>03</ResourceContentType>
				<ContentAudience>00</ContentAudience>
				<ResourceMode>03</ResourceMode>
				<ResourceVersion>
					<ResourceForm>02</ResourceForm>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>01</ResourceVersionFeatureType>
						<FeatureValue>D502</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>02</ResourceVersionFeatureType>
						<FeatureValue>1024</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>03</ResourceVersionFeatureType>
						<FeatureValue>1024</FeatureValue>
						<FeatureNote>large</FeatureNote>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>04</ResourceVersionFeatureType>
						<FeatureValue>bookcover_master.jpg</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>05</ResourceVersionFeatureType>
						<FeatureValue>0.4</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>07</ResourceVersionFeatureType>
						<FeatureValue>417099</FeatureValue>
					</ResourceVersionFeature>
					<ResourceLink datestamp="20200403T140451">https://assets.luisterhuis.nl/cover/875e5c7f-43b4-4978-ae23-6672cfa9e8cf</ResourceLink>
					<ContentDate>
						<ContentDateRole>01</ContentDateRole>
						<Date dateformat="00">20200128</Date>
					</ContentDate>
				</ResourceVersion>
				<ResourceVersion>
					<ResourceForm>02</ResourceForm>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>01</ResourceVersionFeatureType>
						<FeatureValue>D502</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>02</ResourceVersionFeatureType>
						<FeatureValue>512</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>03</ResourceVersionFeatureType>
						<FeatureValue>512</FeatureValue>
						<FeatureNote>thumb</FeatureNote>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>04</ResourceVersionFeatureType>
						<FeatureValue>bookcover_square.jpg</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>07</ResourceVersionFeatureType>
						<FeatureValue>49127</FeatureValue>
					</ResourceVersionFeature>
					<ResourceLink datestamp="20200403T140451">https://assets.luisterhuis.nl/cover/98cfe6ee-3462-45ab-b7cf-5079da571c2d</ResourceLink>
					<ContentDate>
						<ContentDateRole>01</ContentDateRole>
						<Date dateformat="00">20200128</Date>
					</ContentDate>
				</ResourceVersion>
			</SupportingResource>
			<SupportingResource>
				<ResourceContentType>15</ResourceContentType>
				<ContentAudience>00</ContentAudience>
				<ResourceMode>02</ResourceMode>
				<ResourceVersion>
					<ResourceForm>02</ResourceForm>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>01</ResourceVersionFeatureType>
						<FeatureValue>A103</FeatureValue>
					</ResourceVersionFeature>
					<ResourceVersionFeature>
						<ResourceVersionFeatureType>04</ResourceVersionFeatureType>
						<FeatureValue>sample.mp3</FeatureValue>
					</ResourceVersionFeature>
					<ResourceLink datestamp="20200403T140455">https://assets.luisterhuis.nl/sample/01019cc1-b2b5-4b5b-80d7-e51e892cee59,1</ResourceLink>
					<ContentDate>
						<ContentDateRole>01</ContentDateRole>
						<Date dateformat="00">20200128</Date>
					</ContentDate>
				</ResourceVersion>
			</SupportingResource>
		</CollateralDetail>
		<PublishingDetail>
			<Imprint>
				<ImprintName>Time2Learn</ImprintName>
			</Imprint>
			<Publisher>
				<PublishingRole>01</PublishingRole>
				<PublisherIdentifier>
					<PublisherIDType>10</PublisherIDType>
					<IDValue>6780849</IDValue>
				</PublisherIdentifier>
				<PublisherName>Time2Learn</PublisherName>
				<Website>
					<WebsiteRole>18</WebsiteRole>
					<WebsiteDescription>Website uitgeverij</WebsiteDescription>
					<WebsiteLink>http://www.time2learn.nl</WebsiteLink>
				</Website>
			</Publisher>
			<PublishingStatus>04</PublishingStatus>
			<PublishingDate>
				<PublishingDateRole>01</PublishingDateRole>
				<Date dateformat="00">20061115</Date>
			</PublishingDate>
			<SalesRights>
				<SalesRightsType>01</SalesRightsType>
				<Territory>
					<RegionsIncluded>WORLD</RegionsIncluded>
				</Territory>
			</SalesRights>
		</PublishingDetail>
		<RelatedMaterial>
			<RelatedWork>
				<WorkRelationCode>01</WorkRelationCode>
				<WorkIdentifier>
					<WorkIDType>01</WorkIDType>
					<IDTypeName>NSTC</IDTypeName>
					<IDValue>500437832</IDValue>
				</WorkIdentifier>
			</RelatedWork>
		</RelatedMaterial>
		<ProductSupply>
			<Market>
				<Territory>
					<RegionsIncluded>WORLD</RegionsIncluded>
				</Territory>
			</Market>
			<SupplyDetail>
				<Supplier>
					<SupplierRole>00</SupplierRole>
					<SupplierName>Luisterhuis</SupplierName>
				</Supplier>
				<ProductAvailability>20</ProductAvailability>
				<Price>
					<PriceType>01</PriceType>
					<PriceAmount>7.33</PriceAmount>
					<CurrencyCode>EUR</CurrencyCode>
					<Territory>
						<RegionsIncluded>WORLD</RegionsIncluded>
						<CountriesExcluded>NL</CountriesExcluded>
					</Territory>
				</Price>
				<Price>
					<PriceType>02</PriceType>
					<PriceAmount>7.99</PriceAmount>
					<Tax>
						<TaxType>01</TaxType>
						<TaxRateCode>R</TaxRateCode>
						<TaxRatePercent>9.00</TaxRatePercent>
						<TaxableAmount>7.33</TaxableAmount>
						<TaxAmount>0.66</TaxAmount>
					</Tax>
					<CurrencyCode>EUR</CurrencyCode>
					<Territory>
						<CountriesIncluded>NL</CountriesIncluded>
					</Territory>
				</Price>
				<Price>
					<PriceType>05</PriceType>
					<PriceAmount>5.13</PriceAmount>
					<CurrencyCode>EUR</CurrencyCode>
				</Price>
			</SupplyDetail>
		</ProductSupply>
	</Product>
</ONIXMessage>

(This is a partial ONIX message with 1 complete Product record. See Chapter 5 for more information about ONIX).

Due to the size of the resulting metadata file, it’s not possible to retrieve all metadata for all titles in a single call. The limit for a single call is 500 titles. Therefore, it is necessary to retrieve the metadata in multiple calls using the offset&limit parameters, and to collect all result sets on your server. The modifiedfrom parameter is used to select a subset of all new or modified products since a specific date.

Usually, all these parameters are combined. The following example shows how the first, second and subsequent 500 ONIX metadata records from all new and modified products, since June 24, 2020 at 02.00.00, can be retrieved:

/v3/inventory/?offset=0&limit=500&modifiedfrom=20200624020000

/v3/inventory/?offset=500&limit=500&modifiedfrom=20200624020000

/v3/inventory/?offset=1000&limit=500&modifiedfrom=20200624020000

and so on, until no Product elements are returned. Such an ‘empty’ result set looks like this:

Click here to expand for example 'empty' result set

<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage xmlns="http://ns.editeur.org/onix/3.0/reference" release="3.0">
  <Header>
    <Sender>
      <SenderIdentifier>
        <SenderIDType>10</SenderIDType>
        <IDValue>7237977</IDValue>
      </SenderIdentifier>
      <SenderName>Luisterhuis</SenderName>
      <ContactName>Content</ContactName>
      <EmailAddress>content@luisterhuis.nl</EmailAddress>
    </Sender>
    <MessageNumber>20210218162644</MessageNumber>
    <SentDateTime>20210218T1626</SentDateTime>
  </Header>
</ONIXMessage>

Single product metadata in ONIX 3 format

If you know the ISBN of an audiobook and want to retrieve an uptodate metadata record, you could use the ‘product’ API call. All product metadata of a single audiobook can be retrieved like this:

Action		/v3/product/isbn/[ISBN] /* 13 character ISBN/EAN/UPC/GS1 product identifier*/
Method		GET
Example:		all metadata of an audiobook with ISBN 9789024577934, use this REST call: https://rest.luisterhuis.nl/v3/product/isbn/9789024577934/
Click here to expand example of complete Product record <?xml version="1.0" encoding="UTF-8"?> <ONIXMessage xmlns="http://ns.editeur.org/onix/3.0/reference" release="3.0"> <Header> <Sender> <SenderIdentifier> <SenderIDType>10</SenderIDType> <IDValue>7237977</IDValue> </SenderIdentifier> <SenderName>Luisterhuis</SenderName> <ContactName>Content</ContactName> <EmailAddress>content@luisterhuis.nl</EmailAddress> </Sender> <MessageNumber>20210218162742</MessageNumber> <SentDateTime>20210218T1627</SentDateTime> </Header> <Product> <RecordReference>9789024577934</RecordReference> <NotificationType>03</NotificationType> <ProductIdentifier> <ProductIDType>01</ProductIDType> <IDValue>4039</IDValue> </ProductIdentifier> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789024577934</IDValue> </ProductIdentifier> <DescriptiveDetail> <ProductComposition>00</ProductComposition> <ProductForm>AJ</ProductForm> <ProductFormDetail>A103</ProductFormDetail> <PrimaryContentType>01</PrimaryContentType> <Collection> <CollectionType>10</CollectionType> <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>02</TitleElementLevel> <PartNumber>5</PartNumber> <TitleText>Robert Langdon</TitleText> </TitleElement> </TitleDetail> </Collection> <TitleDetail> <TitleType>01</TitleType> <TitleElement> <TitleElementLevel>01</TitleElementLevel> <TitleText>Oorsprong</TitleText> <Subtitle>Auteur van De Da Vinci Code</Subtitle> </TitleElement> </TitleDetail> <Contributor> <SequenceNumber>1</SequenceNumber> <ContributorRole>A01</ContributorRole> <NameIdentifier> <NameIDType>01</NameIDType> <IDTypeName>Luisterhuis AuthorID</IDTypeName> <IDValue>1004</IDValue> </NameIdentifier> <PersonName>Dan Brown</PersonName> <NamesBeforeKey>Dan</NamesBeforeKey> <KeyNames>Brown</KeyNames> <BiographicalNote textformat="02"><![CDATA[<b>Dan Brown</b> (1964) is een van de succesvolste thrillerauteurs van het moment. Hij brak wereldwijd door met zijn thrillers <i>De Da Vinci Code</i>, <i>Het Bernini Mysterie</i>, <i>Het Verloren Symbool</i> en <i>Inferno</i>. September 2016, dertien jaar na het fenomenale, internationale succes van <i>De Da Vinci Code</i>, verschijnt een Young Adult versie voor 13+ van deze wereldwijde bestseller.<br /> <br /> Als zoon van een prijswinnend wiskundige en een moeder die religieuze muziek speelde, werd Dan Brown in zijn jeugd omringd door de tegengestelde ideeën van wetenschap en geloof. Deze tegenstellingen vormden de inspiratiebron voor <i>Het Bernini Mysterie</i>, het eerste boek met professor Robert Langdon in de hoofdrol. <br /> <br /> Tot hij besloot zich volledig op het schrijven te storten, doceerde Dan Brown Engels aan de Philips Exeter Acadamy. Samen met zijn vrouw Blythe, die kunsthistorica en schilderes is, gaat hij regelmatig op reis om research voor zijn boeken te doen.<br /> <br /> Op 3 oktober 2017 verscheen <i>Origin</i>, het nieuwe boek van Dan Brown.<br /> ]]></BiographicalNote> <Website> <WebsiteRole>06</WebsiteRole> <WebsiteDescription>Website van de auteur</WebsiteDescription> <WebsiteLink>http://www.danbrown.com</WebsiteLink> </Website> <Website> <WebsiteRole>42</WebsiteRole> <WebsiteDescription>Twitteradres van de auteur</WebsiteDescription> <WebsiteLink>http://www.twitter.com/AuthorDanBrown</WebsiteLink> </Website> <Website> <WebsiteRole>42</WebsiteRole> <WebsiteDescription>Facebookpagina van de auteur</WebsiteDescription> <WebsiteLink>http://www.facebook.com/DanBrown</WebsiteLink> </Website> </Contributor> <Contributor> <SequenceNumber>2</SequenceNumber> <ContributorRole>E07</ContributorRole> <PersonName>Casper Gimbrère</PersonName> <NamesBeforeKey>Casper</NamesBeforeKey> <KeyNames>Gimbrère</KeyNames> </Contributor> <EditionType>UBR</EditionType> <Language> <LanguageRole>01</LanguageRole> <LanguageCode>dut</LanguageCode> </Language> <Language> <LanguageRole>08</LanguageRole> <LanguageCode>dut</LanguageCode> </Language> <Extent> <ExtentType>09</ExtentType> <ExtentValue>62300</ExtentValue> <ExtentUnit>06</ExtentUnit> </Extent> <Extent> <ExtentType>09</ExtentType> <ExtentValue>0171820</ExtentValue> <ExtentUnit>16</ExtentUnit> </Extent> <Extent> <ExtentType>22</ExtentType> <ExtentValue>951</ExtentValue> <ExtentUnit>19</ExtentUnit> </Extent> <Subject> <MainSubject/> <SubjectSchemeIdentifier>10</SubjectSchemeIdentifier> <SubjectCode>FIC002000</SubjectCode> </Subject> <Subject> <MainSubject/> <SubjectSchemeIdentifier>10</SubjectSchemeIdentifier> <SubjectCode>FIC030000</SubjectCode> </Subject> <Subject> <MainSubject/> <SubjectSchemeIdentifier>10</SubjectSchemeIdentifier> <SubjectCode>FIC031000</SubjectCode> </Subject> <Subject> <SubjectSchemeIdentifier>20</SubjectSchemeIdentifier> <SubjectHeadingText>dan brown;geschiedenis;kunst;mysterie;religie;spanning;wetenschap</SubjectHeadingText> </Subject> <Subject> <MainSubject/> <SubjectSchemeIdentifier>32</SubjectSchemeIdentifier> <SubjectCode>332</SubjectCode> </Subject> <Subject> <SubjectSchemeIdentifier>32</SubjectSchemeIdentifier> <SubjectCode>305</SubjectCode> </Subject> <Subject> <MainSubject/> <SubjectSchemeIdentifier>93</SubjectSchemeIdentifier> <SubjectSchemeVersion>1.4</SubjectSchemeVersion> <SubjectCode>FHK</SubjectCode> </Subject> <Subject> <SubjectSchemeIdentifier>93</SubjectSchemeIdentifier> <SubjectSchemeVersion>1.4</SubjectSchemeVersion> <SubjectCode>FFD</SubjectCode> </Subject> <Subject> <SubjectSchemeIdentifier>93</SubjectSchemeIdentifier> <SubjectSchemeVersion>1.4</SubjectSchemeVersion> <SubjectCode>FJ</SubjectCode> </Subject> </DescriptiveDetail> <CollateralDetail> <TextContent> <TextType>02</TextType> <ContentAudience>00</ContentAudience> <Text><![CDATA[In 'Oorsprong' houdt Robert Langdon zich bezig met de vragen: Waar komen wij vandaan en waar gaan wij naartoe? Vol moderne kunst, innovatieve technologie, religie en geschiedenis.]]></Text> <ContentDate> <ContentDateRole>01</ContentDateRole> <Date dateformat="00">20171003</Date> </ContentDate> </TextContent> <TextContent> <TextType>03</TextType> <ContentAudience>00</ContentAudience> <Text textformat="02"><![CDATA[In Oorsprong van Dan Brown keert Robert Langdon weer terug om een van de grootste mysteries in zijn carrière op te lossen. Robert Langdon, hoogleraar kunstgeschiedenis en symboliek, is te gast in het hypermoderne Guggenheim-museum in Bilbao, voor een belangrijke onthulling die de wetenschap voor altijd zal veranderen. De gastheer van de avond is Edmond Kirsch, een veertigjarige miljardair en futuroloog wiens oogverblindende hightech uitvindingen en gewaagde uitspraken hem wereldberoemd hebben gemaakt. Maar de zorgvuldig georkestreerde avond barst plotseling uit in chaos, waardoor Kirsch’ waardevolle ontdekking voorgoed dreigt te verdwijnen. Samen met de elegante museumdirecteur Ambra Vidal vlucht Langdon naar Barcelona, waar ze een spoor volgen dat ze uiteindelijk oog in oog zal brengen met Kirsch’ schokkende ontdekking…]]></Text> </TextContent> <SupportingResource> <ResourceContentType>04</ResourceContentType> <ContentAudience>00</ContentAudience> <ResourceMode>03</ResourceMode> <ResourceFeature> <ResourceFeatureType>06</ResourceFeatureType> <FeatureValue>1004</FeatureValue> </ResourceFeature> <ResourceVersion> <ResourceForm>02</ResourceForm> <ResourceVersionFeature> <ResourceVersionFeatureType>01</ResourceVersionFeatureType> <FeatureValue>D502</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>02</ResourceVersionFeatureType> <FeatureValue>140</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>03</ResourceVersionFeatureType> <FeatureValue>210</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>04</ResourceVersionFeatureType> <FeatureValue>Dan_Brown.jpg</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>07</ResourceVersionFeatureType> <FeatureValue>25382</FeatureValue> </ResourceVersionFeature> <ResourceLink>https://assets.luisterhuis.nl/author/Dan_Brown.jpg</ResourceLink> <ContentDate> <ContentDateRole>01</ContentDateRole> <Date dateformat="00">20200127</Date> </ContentDate> </ResourceVersion> </SupportingResource> <SupportingResource> <ResourceContentType>03</ResourceContentType> <ContentAudience>00</ContentAudience> <ResourceMode>03</ResourceMode> <ResourceVersion> <ResourceForm>02</ResourceForm> <ResourceVersionFeature> <ResourceVersionFeatureType>01</ResourceVersionFeatureType> <FeatureValue>D502</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>02</ResourceVersionFeatureType> <FeatureValue>1024</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>03</ResourceVersionFeatureType> <FeatureValue>673</FeatureValue> <FeatureNote>large</FeatureNote> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>04</ResourceVersionFeatureType> <FeatureValue>bookcover_master.jpg</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>05</ResourceVersionFeatureType> <FeatureValue>0.4</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>07</ResourceVersionFeatureType> <FeatureValue>460536</FeatureValue> </ResourceVersionFeature> <ResourceLink datestamp="20200129T104331">https://assets.luisterhuis.nl/cover/c2e347e7-7f60-47c3-876d-1adb2005ba81</ResourceLink> <ContentDate> <ContentDateRole>01</ContentDateRole> <Date dateformat="00">20200129</Date> </ContentDate> </ResourceVersion> <ResourceVersion> <ResourceForm>02</ResourceForm> <ResourceVersionFeature> <ResourceVersionFeatureType>01</ResourceVersionFeatureType> <FeatureValue>D502</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>02</ResourceVersionFeatureType> <FeatureValue>512</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>03</ResourceVersionFeatureType> <FeatureValue>512</FeatureValue> <FeatureNote>thumb</FeatureNote> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>04</ResourceVersionFeatureType> <FeatureValue>bookcover_square.jpg</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>05</ResourceVersionFeatureType> <FeatureValue>0.1</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>07</ResourceVersionFeatureType> <FeatureValue>56704</FeatureValue> </ResourceVersionFeature> <ResourceLink datestamp="20200129T104331">https://assets.luisterhuis.nl/cover/4aaa36c3-b297-4686-b9ba-f8f8e736cd59</ResourceLink> <ContentDate> <ContentDateRole>01</ContentDateRole> <Date dateformat="00">20200129</Date> </ContentDate> </ResourceVersion> </SupportingResource> <SupportingResource> <ResourceContentType>15</ResourceContentType> <ContentAudience>00</ContentAudience> <ResourceMode>02</ResourceMode> <ResourceVersion> <ResourceForm>02</ResourceForm> <ResourceVersionFeature> <ResourceVersionFeatureType>01</ResourceVersionFeatureType> <FeatureValue>A103</FeatureValue> </ResourceVersionFeature> <ResourceVersionFeature> <ResourceVersionFeatureType>04</ResourceVersionFeatureType> <FeatureValue>sample.mp3</FeatureValue> </ResourceVersionFeature> <ResourceLink datestamp="20200825T150803">https://assets.luisterhuis.nl/sample/377dfd1e-731a-4047-8040-ee051231f2b1,1</ResourceLink> <ContentDate> <ContentDateRole>01</ContentDateRole> <Date dateformat="00">20200129</Date> </ContentDate> </ResourceVersion> </SupportingResource> </CollateralDetail> <PublishingDetail> <Imprint> <ImprintName>Uitgeverij Luitingh-Sijthoff</ImprintName> </Imprint> <Publisher> <PublishingRole>01</PublishingRole> <PublisherIdentifier> <PublisherIDType>10</PublisherIDType> <IDValue>7700068</IDValue> </PublisherIdentifier> <PublisherName>LS Amsterdam</PublisherName> <Website> <WebsiteRole>18</WebsiteRole> <WebsiteDescription>Website uitgeverij</WebsiteDescription> <WebsiteLink>http://www.lsamsterdam.nl</WebsiteLink> </Website> <Website> <WebsiteRole>43</WebsiteRole> <WebsiteDescription>Twitteradres van de uitgeverij</WebsiteDescription> <WebsiteLink>http://www.twitter.com/lsamsterdam</WebsiteLink> </Website> <Website> <WebsiteRole>43</WebsiteRole> <WebsiteDescription>Facebookpagina van de uitgeverij</WebsiteDescription> <WebsiteLink>http://www.facebook.com/lsamsterdam</WebsiteLink> </Website> </Publisher> <PublishingStatus>04</PublishingStatus> <PublishingDate> <PublishingDateRole>01</PublishingDateRole> <Date dateformat="00">20171003</Date> </PublishingDate> <SalesRights> <SalesRightsType>01</SalesRightsType> <Territory> <RegionsIncluded>WORLD</RegionsIncluded> </Territory> </SalesRights> </PublishingDetail> <RelatedMaterial> <RelatedWork> <WorkRelationCode>01</WorkRelationCode> <WorkIdentifier> <WorkIDType>01</WorkIDType> <IDTypeName>NSTC</IDTypeName> <IDValue>500099407</IDValue> </WorkIdentifier> </RelatedWork> <RelatedProduct> <ProductRelationCode>06</ProductRelationCode> <ProductRelationCode>13</ProductRelationCode> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789024577941</IDValue> </ProductIdentifier> <ProductForm>AA</ProductForm> </RelatedProduct> <RelatedProduct> <ProductRelationCode>06</ProductRelationCode> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789024576791</IDValue> </ProductIdentifier> <ProductForm>BC</ProductForm> </RelatedProduct> <RelatedProduct> <ProductRelationCode>06</ProductRelationCode> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789024577927</IDValue> </ProductIdentifier> <ProductForm>BB</ProductForm> </RelatedProduct> <RelatedProduct> <ProductRelationCode>06</ProductRelationCode> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789024576807</IDValue> </ProductIdentifier> <ProductForm>ED</ProductForm> </RelatedProduct> <RelatedProduct> <ProductRelationCode>06</ProductRelationCode> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9789049805708</IDValue> </ProductIdentifier> <ProductForm>BC</ProductForm> </RelatedProduct> </RelatedMaterial> <ProductSupply> <Market> <Territory> <RegionsIncluded>WORLD</RegionsIncluded> </Territory> </Market> <SupplyDetail> <Supplier> <SupplierRole>00</SupplierRole> <SupplierName>Luisterhuis</SupplierName> </Supplier> <ProductAvailability>20</ProductAvailability> <Price> <PriceType>01</PriceType> <PriceAmount>16.50</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <Territory> <RegionsIncluded>WORLD</RegionsIncluded> <CountriesExcluded>NL</CountriesExcluded> </Territory> </Price> <Price> <PriceType>02</PriceType> <PriceAmount>17.99</PriceAmount> <Tax> <TaxType>01</TaxType> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>9.00</TaxRatePercent> <TaxableAmount>16.50</TaxableAmount> <TaxAmount>1.49</TaxAmount> </Tax> <CurrencyCode>EUR</CurrencyCode> <Territory> <CountriesIncluded>NL</CountriesIncluded> </Territory> </Price> <Price> <PriceType>05</PriceType> <PriceAmount>11.55</PriceAmount> <CurrencyCode>EUR</CurrencyCode> </Price> </SupplyDetail> </ProductSupply> </Product> </ONIXMessage> See Chapter 5 for more information about ONIX.

ONIX metadata

Background

The Luisterhuis catalogue of audiobook products contains all metadata of the audiobooks, like author, publisher, prices et cetera. The data is supplied in XML following the ONIX 3.0 guidelines.

ONIX for Books is a worldwide XML standard to describe book information, to be able to connect the servers of publishers, distributors and retailers, without any conversion or manual data entry of the book data. Information about the ONIX standard is available online on www.editeur.org. We recommend downloading the most current documentation on http://www.editeur.org/93/Release-3.0-Downloads/

The current supported ONIX version by Luisterhuis is a subset of ONIX 3.0 revision 7 with ONIX Code Lists Issue 49. Please note: the ONIX metadata will always be supplied using full reference names.
In this chapter we’ll discuss the subset used by Luisterhuis. Test ONIX XML-files are available on request.

Web shop specific ONIX

Luisterhuis creates web shop specific ONIX metadata. The content is based on a combination of parameters of the underlying CB Online system. The ONIX is tailored and personalized to the specific web shop. For instance, catalogue selection, pricing and publication dates can differ from web shop to web shop based on agreements with publishers.

Local ONIX best practices

Since CB and Luisterhuis both have their roots in the Dutch language publishing market, the ONIX 3.0 subset used by Luisterhuis is highly compatible with the Dutch ONIX subset defined by CB. CB is Charter Member of EDItEUR and takes part in the Dutch language ONIX working group. CB maintains the ‘best practice’ for ONIX in the Dutch language area.

The following paragraphs describe the specific ONIX implementation and best practices for the Dutch market.

ProductForm and PrimaryContentType

For digital audiobooks, the following <ProductForm> is used:

ProductForm

<ProductForm>AJ</ProductForm>
<ProductFormDetail>A103</ProductFormDetail>
<PrimaryContentType>01</ PrimaryContentType>

The following values for <PrimaryContentType> are supported:

01 Audio (audiobook)
02 Performance (audio drama, theatre, cabaret)
03 Music Recording
04 Other Audio (nature sounds, soundscapes)
13 Other Speech Content (lectures, interviews, discussions, audio tours)

Title and collection

The ONIX metadata supports the following title and collection elements:

Title detail:

Title (Title is alway available. The elements are optional)
Sub title

Click here for an example without collection

			<TitleDetail>
				<TitleType>01</TitleType>
				<TitleElement>
					<TitleElementLevel>01</TitleElementLevel>
					<TitleText>Alles wat je wilt weten over het heelal</TitleText>
					<Subtitle>Een Time2Learn luistercursus over het heelal</Subtitle>
				</TitleElement>
			</TitleDetail>

Collection:

Series title
Series part number

Click here for an example with collection

			<Collection>
				<CollectionType>10</CollectionType>
				<TitleDetail>
					<TitleType>01</TitleType>
					<TitleElement>
						<TitleElementLevel>02</TitleElementLevel>
						<PartNumber>5</PartNumber>
						<TitleText>Robert Langdon</TitleText>
					</TitleElement>
				</TitleDetail>
			</Collection>
			<TitleDetail>
				<TitleType>01</TitleType>
				<TitleElement>
					<TitleElementLevel>01</TitleElementLevel>
					<TitleText>Oorsprong</TitleText>
					<Subtitle>Auteur van De Da Vinci Code</Subtitle>
				</TitleElement>
			</TitleDetail>

Contributor roles

Audiobook metadata supports the following contributor roles:

A01 Author of the work
E07 Read by (reader of recorded text)
B06 Translator (optionally)

PrefixToKey in contributor elements

In the Dutch language area <PrefixToKey> is used for all relevant contributor names (authors, narrators) with a typical Dutch prefix in their last name. For instance, the name ‘Dirkjan van Ittersum’ will be supplied in the ONIX as follows:

Contributor - PrefixToKey

<PersonName>Dirkjan van Ittersum</PersonName>
<NamesBeforeKey>Dirkjan</NamesBeforeKey>
<PrefixToKey>van</PrefixToKey>
<KeyNames>Ittersum</KeyNames>

It is the responsibility of the web shop to comply with this standard and parse the <PrefixToKey> field.

Abridged / unabridged

The ONIX contains the <EditionType> element which refers to either abridged (content has been shortened in relation to the original book) or unabridged content.

There are 2 possible values for <EditionType> supported:

ABR Abridged
UBR Unabridged

Language codes

All audiobooks contain the language code for the text <LanguageRole> 01 and spoken language <LanguageRole> 08, which are always identical. Most translated audiobooks also contain the language code for the original language <LanguageRole> 02.

Example for Dutch spoken audio book:

<Language>
 <LanguageRole>01</LanguageRole>
 <LanguageCode>dut</LanguageCode>
</Language>
<Language>
 <LanguageRole>08</LanguageRole>
 <LanguageCode>dut</LanguageCode>
</Language>

Example for Dutch spoken audiobook, translated from Swedish

<Language>
 <LanguageRole>01</LanguageRole>
 <LanguageCode>dut</LanguageCode>
</Language>
<Language>
 <LanguageRole>02</LanguageRole>
 <LanguageCode>swe</LanguageCode>
</Language>
<Language>
 <LanguageRole>08</LanguageRole>
 <LanguageCode>dut</LanguageCode>
</Language>

Duration and size values

The ONIX contains duration and size values of the audiobook files.

Duration and size values

<Extent>
 <ExtentType>09</ExtentType>
 <ExtentValue>21287</ExtentValue>
 <ExtentUnit>06</ExtentUnit>
</Extent>
<Extent>
 <ExtentType>09</ExtentType>
 <ExtentValue>0055447</ExtentValue>
 <ExtentUnit>16</ExtentUnit>
</Extent>
<Extent>
 <ExtentType>22</ExtentType>
 <ExtentValue>197</ExtentValue>
 <ExtentUnit>19</ExtentUnit>
</Extent>

These are the supported types and units:

ExtentType

09 Duration (running time)
22 File size

ExtentUnit

06 seconds (integer value)
16 Hours minutes seconds (HHHMMSS)
19 Mbytes (integer value)

Subject metadata

The ONIX can contain up to four different subject elements: NUR (Dutch), BISAC (international), Thema (international) and keywords. All titles contain at least one NUR and one BISAC value. Thema values and keywords are optional. A growing number of titles will be supplied with Thema subject metadata.

ONIX elements
NUR	NUR <Subject> <MainSubject/> <SubjectSchemeIdentifier>32</SubjectSchemeIdentifier> <SubjectCode>332</SubjectCode> </Subject>	The NUR value of 332 is an example. The valid NUR range is 200 to 999. More info about NUR can be found here: https://www.isbn.nl/uploads/images/NUR-lijst-versie-2011.pdf Multiple NUR values are supported. The main NUR subject has the tag <MainSubject/>.
BISAC	BISAC <Subject> <MainSubject/> <SubjectSchemeIdentifier>10</SubjectSchemeIdentifier> <SubjectCode>HIS010020</SubjectCode> </Subject>	Multiple BISAC values are supported. The main BISAC subject has the tag <MainSubject/>.
Thema	Thema <Subject> <MainSubject/> <SubjectSchemeIdentifier>93</SubjectSchemeIdentifier> <SubjectSchemeVersion>1.3</SubjectSchemeVersion> <SubjectCode>FXM</SubjectCode> </Subject> <Subject> <SubjectSchemeIdentifier>93</SubjectSchemeIdentifier> <SubjectSchemeVersion>1.3</SubjectSchemeVersion> <SubjectCode>FBA</SubjectCode> </Subject> <Subject> <SubjectSchemeIdentifier>94</SubjectSchemeIdentifier> <SubjectSchemeVersion>1.3</SubjectSchemeVersion> <SubjectCode>1KBB-US-WPC</SubjectCode> </Subject>	The ONIX elements for Thema supports multiple values of the <SubjectSchemeIdentifier> 93, 94, 95, 96, 97 and 98.
Keywords	Keywords <Subject> <SubjectSchemeIdentifier>20</SubjectSchemeIdentifier> <SubjectHeadingText>chicklit;dochtertje becky;engels;feel-good roman; rebecca bloomwood;shopaholic;sophie kinsella</SubjectHeadingText> </Subject>	The ONIX element for Keywords uses <SubjectSchemeIdentifier> 20. Different keywords are separated by a ; character.

Short and long description/annotation

The ONIX metadata contains two different descriptive texts for every audiobook: a short one (max. 200 characters, no HTML) and a long one (no limitations).

The short text (Short description/annotation) can be used for hitlists, SEO, mobile, social media, popups, alt-tags, and other situations where there is no space for a long text.

The ONIX element for short text is defined by <TextType> 02:

Short text

<TextContent>
   <TextType>02</TextType>
   <ContentAudience>00</ContentAudience>
   <Text><![CDATA[In 'Oorsprong' houdt Robert Langdon zich bezig met de vragen: Waar komen wij vandaan en waar gaan wij naartoe? Vol moderne kunst, innovatieve technologie, religie en geschiedenis.]]></Text>
   <ContentDate>
     <ContentDateRole>01</ContentDateRole>
     <Date dateformat="00">20171003</Date>
   </ContentDate>
</TextContent>

The long description is defined by <TextType> 03:

Long description

<TextContent>
  <TextType>03</TextType>
  <ContentAudience>00</ContentAudience>
  <Text textformat="02"><![CDATA[In Oorsprong van Dan Brown keert Robert Langdon weer terug om een van de grootste mysteries in zijn carrière op te lossen.

Robert Langdon, hoogleraar kunstgeschiedenis en symboliek, is te gast in het hypermoderne Guggenheim-museum in Bilbao, voor een belangrijke onthulling die de wetenschap voor altijd zal veranderen. De gastheer van de avond is Edmond Kirsch, een veertigjarige miljardair en futuroloog wiens oogverblindende hightech uitvindingen en gewaagde uitspraken hem wereldberoemd hebben gemaakt. Maar de zorgvuldig georkestreerde avond barst plotseling uit in chaos, waardoor Kirsch’ waardevolle ontdekking voorgoed dreigt te verdwijnen.
Samen met de elegante museumdirecteur Ambra Vidal vlucht Langdon naar Barcelona, waar ze een spoor volgen dat ze uiteindelijk oog in oog zal brengen met Kirsch’ schokkende
ontdekking…]]></Text>
</TextContent>

Image assets

In <SupportingResource>, the ONIX contains 2 references to image assets for the audiobook cover, using <FeatureNote> large and thumb. The images itself are supplied as jpg files.

The large cover image has a minimum resolution of 1024 x 1024 px (jpg, RGB), but sometimes higher resolutions (up to 3000 x 3000) are available. The size of the thumb cover image asset is always 512 x 512 px (jpg, RGB). It is the responsibility of the web shop to resize the cover images.

All images are served from the endpoint https://assets.luisterhuis.nl/. They must be downloaded and cached by the web shop. Hotlinking to the assets server is not supported.

Example for the lager image asset

<SupportingResource>
 <ResourceContentType>03</ResourceContentType>
 <ContentAudience>00</ContentAudience>
 <ResourceMode>03</ResourceMode>
 <ResourceVersion>
  <ResourceForm>02</ResourceForm>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>01</ResourceVersionFeatureType>
   <FeatureValue>D502</FeatureValue>
  </ResourceVersionFeature>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>02</ResourceVersionFeatureType>
   <FeatureValue>3000</FeatureValue>
  </ResourceVersionFeature>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>03</ResourceVersionFeatureType>
   <FeatureValue>3000</FeatureValue>
  <FeatureNote>large</FeatureNote>
  </ResourceVersionFeature>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>04</ResourceVersionFeatureType>
   <FeatureValue>bookcover_org.jpg</FeatureValue>
  </ResourceVersionFeature>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>05</ResourceVersionFeatureType>
   <FeatureValue>0.3</FeatureValue>
  </ResourceVersionFeature>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>07</ResourceVersionFeatureType>
   <FeatureValue>289348</FeatureValue>
  </ResourceVersionFeature>
  <ResourceLink datestamp="20200129T104331">https://assets.luisterhuis.nl/cover/c2e347e7-7f60-47c3-876d-1adb2005ba81</ResourceLink>
    <ContentDate>
    <ContentDateRole>01</ContentDateRole>
    <Date dateformat="00">20200903</Date>
    </ContentDate>
  </ResourceVersion>
</SupportingResource>

Sample audio file asset

In <SupportingResource>, the ONIX contains a reference to an audiobook sample file. It is allowed to use this sample file for promotional purposes. The sample file is supplied in mp3 format, 96 / 128 / 192 / 256 kbps, CBR/VBR, (joint) stereo. The audio length is usually 1 to 5 minutes. In most cases the sample is hand-picked by the studio. However, in some cases, the sample is auto generated.

All samples are served from the endpoint https://assets.luisterhuis.nl/. They must be downloaded and cached by the web shop. Hotlinking to the assets server is not supported.

Sample audio file asset

<SupportingResource>
 <ResourceContentType>15</ResourceContentType>
 <ContentAudience>00</ContentAudience>
 <ResourceMode>02</ResourceMode>
 <ResourceVersion>
  <ResourceForm>02</ResourceForm>
  <ResourceVersionFeature>
   <ResourceVersionFeatureType>01</ResourceVersionFeatureType>
   <FeatureValue>A103</FeatureValue>
  </ResourceVersionFeature>
  <ResourceVersionFeature>
    <ResourceVersionFeatureType>04</ResourceVersionFeatureType>
    <FeatureValue>sample.mp3</FeatureValue>
  </ResourceVersionFeature>
  <ResourceLink datestamp="20200903T110746">https://assets.luisterhuis.nl/sample/377dfd1e-731a-4047-8040-ee051231f2b1</ResourceLink>
  <ContentDate>
   <ContentDateRole>01</ContentDateRole>
   <Date dateformat="00">20200129</Date>
  </ContentDate>
 </ResourceVersion>
</SupportingResource>

Content Detail

The "ContentDetail" element is used in metadata to provide information about the content items in an audiobook, including any chapter or scene titles. This is important for organizing and categorizing the content as well as for helping listeners find the parts they are looking for.

The ContentDetail block consists of multiple ContentItem elements, with each element representing a part of the table of contents.
Each ContentItem element has a LevelSequenceNumber, which indicates the hierarchical position of the corresponding part in the table of contents (1.1, 1.2, 1.3, etc.).
Within the ContentItem element, there is the AVItem element, which contains an AVItemType with a value of "03".

Example ContentDetail

<ContentDetail>
  <ContentItem>
    <LevelSequenceNumber>1.1</LevelSequenceNumber>
    <AVItem>
      <AVItemType>03</AVItemType>
    </AVItem>
    <TitleDetail>
      <TitleType>01</TitleType>
      <TitleElement>
        <TitleElementLevel>04</TitleElementLevel>
        <TitleText>Proloog</TitleText>
      </TitleElement>
    </TitleDetail>
  </ContentItem>
  <ContentItem>
    <LevelSequenceNumber>1.2</LevelSequenceNumber>
    <AVItem>
      <AVItemType>03</AVItemType>
    </AVItem>
    <TitleDetail>
      <TitleType>01</TitleType>
      <TitleElement>
        <TitleElementLevel>04</TitleElementLevel>
        <TitleText>Hoofdstuk 1</TitleText>
      </TitleElement>
    </TitleDetail>
  </ContentItem>
  <ContentItem>
    <LevelSequenceNumber>1.3</LevelSequenceNumber>
    <AVItem>
      <AVItemType>03</AVItemType>
    </AVItem>
    <TitleDetail>
      <TitleType>01</TitleType>
      <TitleElement>
        <TitleElementLevel>04</TitleElementLevel>
        <TitleText>Hoofdstuk 2</TitleText>
      </TitleElement>
    </TitleDetail>
  </ContentItem>
</ContentDetail>

Related products (ISBN) and related works (NSTC)

The ONIX feed can contain Related products. These products refer to the same work as the audiobook but with a different ProductForm. The supported ProductRelationCode is: 13 (= Epublication based on print product).

Example ONIX elements for Related ISBNs

<RelatedMaterial>
 <RelatedProduct>
  <ProductRelationCode>13</ProductRelationCode>
   <ProductIdentifier>
    <ProductIDType>03</ProductIDType>
    <IDValue>9789020211122</IDValue>
  </ProductIdentifier>
   <ProductIdentifier>
    <ProductIDType>15</ProductIDType>
    <IDValue>9789020211122</IDValue>
  </ProductIdentifier>
 </RelatedProduct>
</RelatedMaterial>

In addtion, CB assigns a unique work identifier called NSTC (Netherlaends Standard Text Code) to every work published in the Netherlands and Flanders. All product forms of a specific book (hardback, paperback, ebook, audiobook) have the same NSTC, which allows a web shop to group the different product forms of the same book. This value is less relevant for web shops that only offer audiobooks.

The ONIX contains a reference to the NSTC as follows

<RelatedMaterial>
 <RelatedWork>
  <WorkRelationCode>01</WorkRelationCode>
   <WorkIdentifier>
    <WorkIDType>01</WorkIDType>
    <IDTypeName>NSTC</IDTypeName>
    <IDValue>100020228</IDValue>
  </WorkIdentifier>
 </RelatedWork>
</RelatedMaterial>

Product availability

The value of the element <ProductAvailability> defines whether or not an audiobook product is allowed for sale / use or not. The ONIX contains a reference to the <ProductAvailability> as follows:

Product availability

<ProductSupply>
 <SupplyDetail>
  <ProductAvailability>20</ProductAvailability>
 </SupplyDetail>
</ProductSupply>

There are 3 possible values for <ProductAvailability>:

10 Announced (this includes a future SupplyDate)
20 Available
40 Withdrawn

It is the responsibility of the web shop client to comply with this standard, parse the <ProductAvailability> field, and show or take down the title when necessary.

The audiobook may be enabled for sale only when <ProductAvailability> is 20 As soon as the <ProductAvailability> value changes to 40, the title needs to be disabled for sale in the web shop.

Behaviour of Announcements:

For audiobooks where the CB Online life cycle is set to ‘Aangekondigd’ (Announced), the ONIX element <ProductAvailability> will contain 10 and <PublishingStatus> will contain 02.
The expected delivery date of the complete audiobook (Expected availability date) is passed through <SupplyDate> and the <SupplyDateRole> with the value 08.
The formal publication date is specified in <PublishingDate> with a <PublishingDateRole> 01.
As soon as the life cycle in CB Online is set to 'Verschenen’ (Available), the element <ProductAvailability> will contain 20 and <PublishingStatus> will contain 04. <SupplyDate> with a <SupplyDateRole> 08 will then contain the delivery date of the complete audiobook (Expected availability date).

Example ONIX elements for an announcement

<ProductSupply>
<SupplyDetail>
  <ProductAvailability>10</ProductAvailability>
  <SupplyDate>
   <SupplyDateRole>08</SupplyDateRole>
   <Date dateformat="00">20221005</Date>
  </SupplyDate>
</SupplyDetail>
</ProductSupply>

<PublishingDetail>
<PublishingStatus>02</PublishingStatus>
<PublishingDate>
  <PublishingDateRole>01</PublishingDateRole>
  <Date dateformat="00">20221103</Date>
</PublishingDate>
</PublishingDetail>

Comments:

The publication date in the ONIX (<PublishingDate> with <PublishingDateRole> 01) may differ from the actual publication date, because of the following: if Bureau ISBN has not yet carried out the editorial check, the publisher can modify the publication date and updates will be specified in the ONIX for resellers. After Bureau ISBN has carried out the editorial check, the publication date is fixed. If in doubt, contact the publisher.
Announced audiobooks will not always have an audio sample, cover image, and/or sales price. The description and subject classification may also still be incomplete. As soon as the title has been published (<ProductAvailability> 20) there is always an audio fragment and cover image available, and the metadata has been checked and complete.
Orders for announced audiobooks will not be processed. These orders give an error. The web shop must therefore make its own provision for the possible registration of pre-orders. Orders will only be processed for audiobooks with a <ProductAvailability> 20.

Price fields and territorial restrictions

Luisterhuis provides at least a single RRP (recommended retail price) in the ONIX. The ONIX contains the correct RRP and special sale price (temporary discounted prices, with start and end date) as supplied by the publisher for this specific web shop. There are no ‘fixed book prices’, so it might be possible that the prices will differ between different web shops. Please note: the current (reduced) VAT percentage for digital audiobooks in The Netherlands is 9% and in Flanders is 6%.

Special sale prices (temporary discounts) are supported with <PriceType> 11 and 12 using <PriceDate> <PriceDateRole> 14 and 15 to define the period.

Example

<Price>
 <PriceType>01</PriceType>
 <PriceAmount>9.17</PriceAmount>
 <CurrencyCode>EUR</CurrencyCode>
 <Territory>
  <RegionsIncluded>WORLD</RegionsIncluded>
  <CountriesExcluded>NL</CountriesExcluded>
  </Territory>
</Price>
<Price>
 <PriceType>02</PriceType>
 <PriceAmount>9.99</PriceAmount>
 <Tax>
  <TaxType>01</TaxType>
  <TaxRateCode>R</TaxRateCode>
  <TaxRatePercent>9.00</TaxRatePercent>
  <TaxableAmount>9.17</TaxableAmount>
  <TaxAmount>0.82</TaxAmount>
 </Tax>
 <CurrencyCode>EUR</CurrencyCode>
 <Territory>
  <CountriesIncluded>NL</CountriesIncluded>
 </Territory>
</Price>
<Price>
 <PriceType>05</PriceType>
 <PriceAmount>6.42</PriceAmount>
 <CurrencyCode>EUR</CurrencyCode>
</Price>

Browser not supported