Table of Contents

Doel

Titelbank stelt aan boekhandels, uitgevers en andere derde partijen titelinformatie beschikbaar in ONIX 3.0 formaat, met het doel dat zij deze titelinformatie kunnen importeren in hun eigen artikeldatabank en/of tonen op hun website. ONIX for Books versie 3.0 is een internationale standaard voor het uitwisselen van titelgegevens die wordt beheerd door Editeur. Dit document beschrijft de functionele specificaties voor ONIX 3.0 product records die komen uit Titelbank.

...

DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O (Onix)

M/O

(TB)

LIST

A|N

POS.

Naam van het veld

Veld zoals gebruikt in de Editeur documentatie

Naam van het veld zoals gebruikt binnen het bericht

Verplicht of optioneel (Mandatory/optional) volgens ONIX

Verplicht of optioneel (Mandatory/Optional) bij titelbank

Gebruikte ONIX codelijst (indien van toepassing)

Alfanumeriek of numeriek

Aantal posities

Opbouw ONIX 3.0 bericht

Message declaration WIjzigt m.i.v. 04 May 2020	<?xml version="1.0"?> <ONIXMessage release="3.0" xmlns="http://www.editeur.org/onix/3.0/reference">
<MessageHeader>	Identificatie van afzender, berichtnummer en verzendtijdstip
<Product>
Record metadata	Identificatie van het record	Group P.1
Product numbers	Identificatie van het product	Group P.2
<DescriptiveDetail> ………… </DescriptiveDetail>	Beschrijving van de uiterlijke kenmerken van het product zelf en van de content, bibliografische beschrijving, basistitelgegevens	Block 1
<CollateralDetail> …………… </CollateralDetail>	Verrijkte titelgegevens, ondersteunende teksten, bestanden en linkjes	Block 2
<ContentDetail> ……………… </ContentDetail>	Beschrijving van individuele hoofdstukken uit het product, wordt in Titelbank niet gebruikt	Block 3
<PublishingDetail> ………… </PublishingDetail>	Beschrijving van de uitgever, imprint en verschijningsdatum	Block 4
<RelatedMaterial> …………… </RelatedMaterial>	Verwijzingen naar gerelateerde producten	Block 5
<ProductSupply> ……………… </ProductSupply>	Beschrijft de beschikbaarheid van het product in de markt	Block 6
</Product>
</ONIXMessage>

Message Header - Opbouw Headerrecord

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
		<ONIXMessage release=”3.0”>	M	M		A
Header composite		<Header>	M	M
Sender composite		<Sender>	M	M
Sender identifier composite		<SenderIdentifier>	O*	M
Sender identifier type code	H.1	<SenderIDType>	M	M	44			Bevat waarde 10 waarmee wordt aangeduid dat <IDValue> een CB_relatie_id betreft
Identifier value	H.3	< IDValue>	M	M				Wordt gevuld met waarde 8894126, het CB_relatiie_id van CB
Sender name	H.4	<SenderName>	O	O		A		Wordt gevuld met 'Titelbank'.
Message sequence number	H.13	<MessageNumber>	O	O		N		Wordt gevuld met volgnummer ONIX bericht
Message creation date/time	H.15	<SentDateTime>	M	M		A	13	Wordt gevuld met datum/tijd in formaat yyyymmddThhmm

Code Block

language	xml
title	Voorbeeld van ONIXMessage Header
collapse	true

<ONIXMessage release="3.0" xmlns="http://www.editeur.org/onix/3.0/reference">
	<Header>
		<Sender>
			<SenderIdentifier>
				<SenderIDType>10</SenderIDType>
				<IDValue>8894126</IDValue>
			</SenderIdentifier>
			<SenderName>Titelbank</SenderName>
		</Sender>
		<MessageNumber>4909</MessageNumber>
		<SentDateTime>20200112T2200</SentDateTime>
	</Header>

Het bericht wordt afgesloten met een sluit tag </OnixMessage>.

Opbouw ProductRecord

<Product>	Toelichting
Record metadata	Identificatie van het record	Group P.1
Product numbers	Identificatie van het product	Group P.2
<DescriptiveDetail> ………… </DescriptiveDetail>	Beschrijving van de uiterlijke kenmerken van het product zelf en van de content, bibliografische beschrijving, basistitelgegevens	Block 1
<CollateralDetail> …………… </CollateralDetail>	Verrijkte titelgegevens, ondersteunende teksten, bestanden en linkjes	Block 2
<ContentDetail> ……………… </ContentDetail>	Beschrijving van individuele hoofdstukken uit het product, wordt in Titelbank niet gebruikt	Block 3
<PublishingDetail> ………… </PublishingDetail>	Beschrijving van de uitgever, imprint en verschijningsdatum	Block 4
<RelatedMaterial> …………… </RelatedMaterial>	Verwijzingen naar gerelateerde producten	Block 5
<ProductSupply> ……………… </ProductSupply>	Beschrijft de beschikbaarheid van het product in de markt	Block 6
</Product>

Code Block

language	xml
title	Volledig Product record
collapse	true

	<Product>
		<RecordReference>9789065507808</RecordReference>
		<NotificationType>04</NotificationType>
		<RecordSourceType>01</RecordSourceType>
		<ProductIdentifier>
			<ProductIDType>03</ProductIDType>
			<IDValue>9789065507808</IDValue>
		</ProductIdentifier>
		<DescriptiveDetail>
			<ProductComposition>00</ProductComposition>
			<ProductForm>BA</ProductForm>
			<Collection>
				<CollectionType>10</CollectionType>
				<TitleDetail>
					<TitleType>01</TitleType>
					<TitleElement>
						<TitleElementLevel>02</TitleElementLevel>
						<PartNumber>3</PartNumber>
						<TitleText>Zoekreeks</TitleText>
					</TitleElement>
				</TitleDetail>
			</Collection>
			<TitleDetail>
				<TitleType>01</TitleType>
				<TitleElement>
					<TitleElementLevel>01</TitleElementLevel>
					<TitleText>Op zoek naar een biografisch portret in het verleden</TitleText>
				</TitleElement>
			</TitleDetail>
			<Contributor>
				<SequenceNumber>1</SequenceNumber>
				<ContributorRole>A01</ContributorRole>
				<PersonName>K. van der Wiel</PersonName>
				<NamesBeforeKey>K.</NamesBeforeKey>
				<PrefixToKey>van der</PrefixToKey>
				<KeyNames>Wiel</KeyNames>
			</Contributor>
			<Contributor>
				<SequenceNumber>2</SequenceNumber>
				<ContributorRole>B01</ContributorRole>
				<PersonName>K.  Bossaers</PersonName>
				<NamesBeforeKey>K.</NamesBeforeKey>
				<KeyNames>Bossaers</KeyNames>
			</Contributor>
			<Contributor>
				<SequenceNumber>3</SequenceNumber>
				<ContributorRole>B01</ContributorRole>
				<PersonName>J.  Brugman</PersonName>
				<NamesBeforeKey>J.</NamesBeforeKey>
				<KeyNames>Brugman</KeyNames>
			</Contributor>
			<Contributor>
				<SequenceNumber>4</SequenceNumber>
				<ContributorRole>B01</ContributorRole>
				<PersonName>J.  Knoester</PersonName>
				<NamesBeforeKey>J.</NamesBeforeKey>
				<KeyNames>Knoester</KeyNames>
			</Contributor>
			<EditionNumber>1</EditionNumber>
			<Language>
				<LanguageRole>01</LanguageRole>
				<LanguageCode>dut</LanguageCode>
			</Language>
			<Extent>
				<ExtentType>00</ExtentType>
				<ExtentValue>123</ExtentValue>
				<ExtentUnit>03</ExtentUnit>
			</Extent>
			<Illustrated>02</Illustrated>
			<Subject>
				<MainSubject/>
				<SubjectSchemeIdentifier>32</SubjectSchemeIdentifier>
				<SubjectCode>681</SubjectCode>
			</Subject>
		</DescriptiveDetail>
		<PublishingDetail>
			<Publisher>
				<PublishingRole>01</PublishingRole>
				<PublisherIdentifier>
					<PublisherIDType>10</PublisherIDType>
					<IDValue>7300840</IDValue>
				</PublisherIdentifier>
				<PublisherName>Verloren b.v., uitgeverij</PublisherName>
			</Publisher>
			<PublishingStatus>08</PublishingStatus>
			<PublishingDate>
				<PublishingDateRole>01</PublishingDateRole>
				<DateFormat>00</DateFormat>
				<Date>20030101</Date>
			</PublishingDate>
		</PublishingDetail>
		<RelatedMaterial/>
		<ProductSupply>
			<SupplyDetail>
				<Supplier>
					<SupplierRole>00</SupplierRole>
					<SupplierName>TitelBank</SupplierName>
				</Supplier>
				<ProductAvailability>99</ProductAvailability>
				<Price>
					<PriceType>02</PriceType>
					<PriceAmount>19</PriceAmount>
				</Price>
			</SupplyDetail>
		</ProductSupply>
	</Product>

Record metadata (Group P1 en P2)

DATA ELEMENT	FIELD	XML REFERENCE NAME	M/O Onix	M/O TB	LIST	A \| N	POS.	Toelichting
Record reference number and type	P.1
Record reference number	P.1.1	<RecordReference>	M	M		A	13	Bevat het ISBN13-EAN P1.1. bevat het referentienummer voor het ProductRecord, P. 2.3 bevat de bibliografische identificatie van de titel met bijbehorende metadata. In de ONIX van Titelbank zijn deze twee altijd identiek.
Notification or update type code	P.1.2	<NotificationType>	M	M	1	N		Bevat waarde '03' bij volledig record of waarde '04'bij een block update Als bestaande gegevens zijn verwijderd, ongeacht uit welk blok, dan wordt altijd het volledige record aangeleverd met NotificationType 03. Als gegevens in een blok zijn gewijzigd, dan wordt altijd het volledige blok aangeleverd met NotificationType 04.
Record source type code	P.1.4	<RecordSourceType>	O	O	3	N		Bevat waarde '01'(Publisher)
Product numbers	P.2
Product identifier composite		<ProductIdentifier>	M	M
Product identifier type code	P.2.1	<ProductIDType>	M	M	5	N		Bevat waarde '03'(EAN/GTIN-13)
Identifier value	P.2.3	<IDValue>	M	M		N	13	Bevat het EAN van de titel P1.1. bevat het referentienummer voor het ProductRecord, P. 2.3 bevat de bibliografische identificatie van de titel met bijbehorende metadata. In de ONIX van Titelbank zijn deze twee altijd identiek.

...

DATA ELEMENT

FIELD

XML REFERENCE NAME

M/O
Onix

A/S
CB

LIST

A | N

POS.

Toelichting

Product Composition

P3.1

M

2

A

2

Bevat '00' als het een enkelvoudig product betreft of '10'indien het product begeleidend materiaal heeft

Product Form Code

P.3.2

M

A

150

A

Code voor de verschijningsvorm van het product

Note
Voor een fysiek (gedrukt) boek wordt de verschijningsvorm in het ONIX 3.0 bericht gedefinieerd door de ProductForm. Voor een e-book wordt de verschijningsvorm in het ONIX 3.0 bericht gedefinieerd door de combinatie van de tags ProductForm, ProductFormDetail, ProductFormFeature en EpubTechnicalProtection

Product Form Detail

P.3.3

O

S

175

A

5

Nadere specificaties van de verschijningsvorm van het product (bijvoorbeeld technisch platform bij ebooks)

Product Form Feature Composite

O

ProductFormFeatureType Code

P.3.4

M

A

79

N

2

Wordt gevuld met waarde 10 (alleen bij epubs)

ProductFormFeatureValue

P.3.5

M

A

N

1

geeft aan of een epub versie 2 of versie 3 is

Einde ProductFormFeature Composite

</ProductFormFeature>

ProductForm Description

P.3.8

ProductFormdescription

O

S

A

255

Vrij tekstveld t.b.v. omschrijving begeleidend materiaal

Epub technical Protection

P. 3.16

O

144

N

2

Type beveiliging bij een ebook

Expand

title	Klik hier voor mogelijke verschijningsvormen

Include Page

	Product Form fysieke boeken
	Product Form fysieke boeken

Note
Voor een fysiek (gedrukt) boek wordt de verschijningsvorm in het ONIX 3.0 bericht gedefinieerd door de ProductForm. Voor een e-book wordt de verschijningsvorm in het ONIX 3.0 bericht gedefinieerd door de combinatie van de tags ProductForm, ProductFormDetail, ProductFormFeature en EpubTechnicalProtection

Include Page

	Product Form e-books
	Product Form e-books

...

1.Totaalbestanden: op aanvraag, wordt aangeleverd op USB-stick Het middels een url

Het totaalbestand bevat alle beschikbare gegevens van alle titels met een geregistreerd ISBN binnen het Nederlands taalgebied sinds 1970. Om Om het totaal bestand aan te vragen vult u het daarvoor beschikbare formulier in in de Titelbank-applicatie en drukt u op versturen(Tabblad Aanvraag bestand). Een totaalbestand is ongeveer 30 – 40 GB minimaal 300Gb groot en is opgedeeld in segmenten van 4000 records (ISBN’s). Deze opdeling wordt gedaan om te voorkomen dat de verwerking van het bestand in de applicatie van de afnemer vastloopt

...

Versions Compared

Old Version 59

New Version 60

Key

Doel

Opbouw ONIX 3.0 bericht

Message Header - Opbouw Headerrecord

Opbouw ProductRecord

Record metadata (Group P1 en P2)

Page Comparison

Versions Compared

Old Version 59

New Version 60

Key

Doel

Opbouw ONIX 3.0 bericht

Message Header - Opbouw Headerrecord

Opbouw ProductRecord

Record metadata (Group P1 en P2)