Berichtdefinitie ONIX 3 (aanleveren) - Publisher to CB
- 1 Message declaration
- 2 Start ONIX-bericht
- 3 ONIX Message voor Reference (Long tags) en Short tags
- 4 Header composite
- 4.1 Sender composite
- 4.1.1 Sender Identifier composite
- 4.1.1.1 H.1 Sender ID Type
- 4.1.1.2 H.3 ID Value (afzender)
- 4.1.2 End of Sender Identifier composite
- 4.1.3 H.4 Sender Name
- 4.1.4 H.5 Sender Contact Name
- 4.1.5 H.6 Sender contact e-mail addres
- 4.1.1 Sender Identifier composite
- 4.2 End of Sender composite
- 4.3 Addressee composite
- 4.4 End of Addressee composite
- 4.5 H.13 Message sequence number
- 4.6 H.15 Message creation date/time
- 4.1 Sender composite
- 5 End of Header composite
- 6 Product composite
- 7 Block 1 Product description, Descriptive detail - Beschrijvende gegevens
- 7.1 Descriptive detail composite
- 7.1.1 P.3.1 Product composition
- 7.1.2 P.3.2 Product form
- 7.1.3 P.3.3 Product form detail
- 7.1.4 Product form feature composite
- 7.1.5 End of Product form feature
- 7.1.6 P.3.8 Product form description
- 7.1.7 P.3.10 Primary content type code - Verduidelijking van het type product
- 7.1.8 P.3.11 Product content type code - Verduidelijking van het type product
- 7.1.9 P.3.16 Epub technical protection
- 7.1.10 Epub usage constraint composite
- 7.1.10.1 P.3.17 Epub usage type
- 7.1.10.2 P.3.18 Epub usage status
- 7.1.11 End of Epub usage constraint composite
- 7.1.12 Product classification composite
- 7.1.12.1 P.3.22 Product classification type code
- 7.1.12.2 P.3.23 Product classification code
- 7.1.12.3 P.3.24 Percent
- 7.1.13 End of Product classification composite
- 7.1.14 Collection composite - Bibliografische reeks
- 7.1.14.1 P.5.1. Collection type
- 7.1.14.1.1 TitleDetail - Collection type composite
- 7.1.14.1.2 P.5.6 TitleType
- 7.1.14.1.3 Title element composite
- 7.1.14.1.3.1 P.5.7 Title element level
- 7.1.14.1.3.2 P.8 Part number
- 7.1.14.1.3.3 P.5.10 Title text
- 7.1.14.1.3.4 P.5.11 Title prefix
- 7.1.14.1.3.5 P.5.11a No prefix indicator
- 7.1.14.1.3.6 P.5.12 Title without prefix
- 7.1.14.1.4 End of Title element composite
- 7.1.14.2 End of Title detail Bibliografische reeks composite
- 7.1.14.1 P.5.1. Collection type
- 7.1.15 End of Collection composite - Bibliografische reeks
- 7.1.16 Title detail - Bibliografische titel composite
- 7.1.17 Hoofdtitel - Deeltitel - Sectietitel
- 7.1.18 Hoofdtitel - Deeltitel - Sectietitel voor educatieve uitgaven
- 7.1.18.1 P.6.1 Title type
- 7.1.18.2 Title element composite (R)
- 7.1.18.2.1 P.6.2 Title element level
- 7.1.18.2.2 P.6.3 Part number
- 7.1.18.2.3 P.6.5 Title text
- 7.1.18.2.4 Title detail - Auteur*titel composite
- 7.1.18.2.5 Title detail - Toekomstbestendige wijze titelgegevens (R) composite
- 7.1.18.2.5.1 P.6.6 Title prefix
- 7.1.18.2.5.2 P.6.6a No Prefix indicator
- 7.1.18.2.5.3 P.6.7 Title without prefix
- 7.1.18.2.6 P.6.8 Subtitle
- 7.1.18.2.7 End of Title detail - Toekomstige wijze titelgegevens composite
- 7.1.18.3 End of Title element composite
- 7.1.19 End of Title detail - Bibliografische titel composite
- 7.1.20 P.7 Contributor - Auteursvermelding composite
- 7.1.20.1 P.7.1 Contributor sequence number
- 7.1.20.2 P.7.2 Contributor Role
- 7.1.20.3 P.7.12 Person name part 2 - Names before key - Voornaam
- 7.1.20.4 P.7.13 Person name part 3 - Prefix to key - Voorvoegsel
- 7.1.20.5 P.7.15 Person name part 4 - Key names - Achternaam
- 7.1.20.6 P.7.19 Corporate name - Bedrijfsnaam
- 7.1.21 End of P.7 Contributor - Auteursvermelding composite
- 7.1.22 P.7.52 No authorship indicatior - ‘Geen betrokkene’ indicator
- 7.1.23 P.9.1 Edition type code - Editie type
- 7.1.24 P.9.2 Edition number Bibliografisch druknummer
- 7.1.25 P.9.3 Edtion version number - Druknummer
- 7.1.26 P.9.4 Edition statement
- 7.1.27 P.10 Language - taal composite
- 7.1.27.1 P.10.1 Language role - Taalrol
- 7.1.27.2 P.10.2 Language code - Taalcode
- 7.1.28 End of P.10 Language - Taal composite
- 7.1.29 P.11 Extent - Omvang, bestandsgrootte, aantal pagina’s - composite
- 7.1.29.1 P.11.1 Extent Type
- 7.1.29.2 P.11.2 Extent Value
- 7.1.29.3 P.11.3 Extent Value Roman
- 7.1.29.4 P.11.4 Extent Unit
- 7.1.30 End of P.11 Extent - Omvang, bestandsgrootte, aantal pagina’s - composite
- 7.1.31 P.11.5 Illustrated/Not Illustrated indicator
- 7.1.32 P.12 Subject - NUR, Thema, BISAC en Trefwoorden composite
- 7.1.32.1 P.12.1 Main Subject - NUR, BISAC en THEMA
- 7.1.32.2 P.12.2 Subject scheme identifier
- 7.1.32.3 P.12.4 Subject scheme version number
- 7.1.32.4 P.12.5 Subject code
- 7.1.32.5 P.12.6 Subject heading text
- 7.1.33 End of P.12 Subject - NUR, Thema, BISAC en Trefwoorden composite
- 7.1.34 P.13 Audience - AVI leesniveau composite
- 7.1.34.1 P.13.2 Audience code type
- 7.1.34.2 P.13.4 Audience code value
- 7.1.35 End of P.13 Audience - AVI leesniveau composite
- 7.1.36 P.13 Audience range - AVI leeftijdscategoriën composite
- 7.1.37 End of P.13 Audience range - AVI leeftijdscategorieën composite
- 7.1 Descriptive detail composite
- 8 End of Descriptive detail composite
- 9 Block 2 Collateral detail - Content
- 9.1 P.14 Text content - Promotionle tekst composite
- 9.1.1 P.14.1 Text type
- 9.1.2 P.14.2 Content audience
- 9.1.3 P.14.3 Text
- 9.1.4 P.14.4 Author of quoted text - Auteur van recensie
- 9.1.5 P.14.6 Source title - Publicatie recensie
- 9.1.6 Content date - Content datum composite
- 9.1.6.1 P.14.7 Content date role
- 9.1.6.2 P.14.9 Date - Publicatiedatum content
- 9.1.7 End of Content date - Content datum composite
- 9.2 End of P.14 Text content - Promotionele tekst composite
- 9.3 P.15.Cited content - Promotionele URL composite
- 9.4 End of P.15 Cited content - Promotionele URL composite
- 9.5 P.16 Supporting resources - Promotionele downloadbare bestanden composite
- 9.5.1 P.16.1 Resource content type
- 9.5.2 P.16.2 Target audience - Doelgroep content
- 9.5.3 P.16.3 Resource mode
- 9.5.4 Resource version composite - Versie promotionele bestanden
- 9.5.4.1 P.16.7 Resource form
- 9.5.4.2 Resource version feature composite
- 9.5.4.2.1 P.16.8 Resource version feature type
- 9.5.4.2.2 P.16.9 Resource version feature value
- 9.5.4.2.3 P.16.10 Resource version feature note
- 9.5.4.3 End of Resource version feature composite
- 9.5.4.4 P.16.11 Resource link
- 9.5.4.5 Content date - Content datum composite
- 9.5.4.5.1 P.16.12 Content date role
- 9.5.4.5.2 P.16.14 Date - Publicatiedatum content
- 9.5.4.6 End of Content date - Content datum composite
- 9.5.5 End of Resource version - Versie promotionele bestanden composite
- 9.6 End of P.16 Supporting resources - Promotionele downloadbare bestanden composite
- 9.7 P.17 Prizes - Literaire prijs of onderscheiding composite
- 9.7.1 P.17.1 Prize of award name - Naam literaire prijs of onderscheiding
- 9.7.2 P.17.2 Prize or award year - Jaar van de literaire prijs of onderscheiding
- 9.7.3 P.17.3 Prize or award country - Land waar de literaire prijs of onderscheiding wordt toegekend
- 9.7.4 P.17.4 Prize award achievement code - Prestatie van product in relatie tot prijs of onderscheiding
- 9.7.5 P.17.a Prize statement - Korte omschrijving van de prijs
- 9.8 End of P.17 Prizes - Literaire prijs of onderscheiding composite
- 9.1 P.14 Text content - Promotionle tekst composite
- 10 End of Collateral detail composite
- 11 Block 4 Publishing Detail - Gegevens uitgever, imprint, verschijningsdatum, verkoopland rechten en restricties
- 11.1 Imprint or Brand composite
- 11.2 End of Imprint or Brand composite
- 11.3 Imprint of Brand composite
- 11.4 End of Imprint or Brand composite
- 11.5 Publisher - Commerciële eigenaar composite
- 11.6 End of Publisher - Commerciële eigenaar composite
- 11.7 P.19.13 City or town of publication - Plaats van uitgave
- 11.8 Product contact composite
- 11.8.1 P.19.15 Product contact role
- 11.8.2 P.19.19 Product contact name
- 11.8.3 P.19.20 Contact name
- 11.8.4 P.19.20a Product contact telephone number
- 11.8.5 P.19.21 Product contact e-mail address
- 11.8.6 P.19.22 Product contact street address
- 11.8.7 P.19.23 Product contact location name
- 11.8.8 P.19.24 Product contact postal code
- 11.8.9 P.19.26 Product contact country code
- 11.9 End of Product contact composite
- 11.10 P.20.1 Publishing status - Stadium levenscyclus
- 11.11 Publishing date - Bibliografische verschijningsdatum composite
- 11.12 End of Publishing date - Bibliografische verschijningsdatum composite
- 11.13 Sales rights - Restricties en verkoopland uitsluiting composite
- 11.14 End of Sales Rights - Restricties en verkoopland uitsluiting composite
- 12 End of Publishing detail - Uitgegever gegevens composite
- 13 Block 5 Related Material - Gerelateerd materiaal
- 14 Related Material - Gerelateerd materiaal composite
- 15 End of Related Materiaal - Gerelateerd materiaal
- 16 Block 6 Product Supply - Artikel beschikbaarheid en artikelprijzen
- 17 Product Supply - Product beschikbaarheid composite
- 17.1 P.25 Market publishing detail composite - Titel vrijgeven op specifeke datum/Presales composite
- 17.1.1 P.25.12 Market publishing status - Publicatie status voor een specifieke markt
- 17.1.2 Market date composite - Datum beschikbaar voor de markt composite
- 17.1.2.1 P.25.14 Market date role code
- 17.1.2.2 P.25.16 Date - Markt verschijningsdatum
- 17.1.3 End of Market date composite - Datum beschikbaar voor de markt composite
- 17.2 End of P.25 Market publishing detail composite - Titel vrijgeven op specifieke datum/Presales composite
- 17.3 P.26 Supply detail composite
- 17.3.1 Supplier - Distributeur composite
- 17.3.1.1 P.26.1 Supplier role
- 17.3.1.2 P.26.5 Supplier name
- 17.3.2 End of Supplier - distributeur composite
- 17.3.3 P.26.17 Product Availability - Artikelbeschikbaarheid
- 17.3.4 Supply date - Verwachte verschijningsdatum composite
- 17.3.4.1 P.26.18 Supply date role code
- 17.3.4.2 P.26.20 Date - verwachte verschijningsdatum
- 17.3.5 End of Supply date composite - Verwachte verschijningsdatum composite
- 17.3.6 P.26.41 Pack or carton quantity - Bindersverpakking
- 17.3.7 Price - Prijs composite
- 17.3.7.1 P.26.43 Price type code - Typering van de prijs
- 17.3.7.2 Price condition - Prijsconditie composite
- 17.3.7.3 End of Price condition - Prijsconditie composite
- 17.3.7.4 Discount code - Korting (Boeksoort) codering composite
- 17.3.7.4.1 P.26.54 Discount code type- Korting typering
- 17.3.7.4.2 P.26.56 Discount code - Boeksoort
- 17.3.7.5 End of Discount coded - Korting (Boeksoort) codering composite
- 17.3.7.6 P.26.61 Price status - Prijs status/Vrijgave akkoord
- 17.3.7.7 P.26.70a Unpriced item type - Artikel zonder prijs
- 17.3.7.8 P.26.62 Price Amount - Bedrag Verkoopprijs
- 17.3.7.9 Tax - BTW composite
- 17.3.7.10 End of Tax - BTW composite
- 17.3.7.11 P.26.71 Currency code - Valuta code
- 17.3.7.12 Price date - Prijs geldigheid composite
- 17.3.7.12.1 P.26.83 Price date role - Prijsdatum rol
- 17.3.7.12.2 P.26.85 Price date - Geldigheid prijs composite
- 17.3.8 End of Price - Prijs composite
- 17.3.1 Supplier - Distributeur composite
- 17.4 End of Product Supply - Product beschikbaarheid composite
- 17.1 P.25 Market publishing detail composite - Titel vrijgeven op specifeke datum/Presales composite
- 18 End of ONIX bericht
Message declaration
De inhoud en de structuur van de Message declaration is voorgeschreven door de XML standaard. De tekenset die is aangegeven in de MessageDeclaration is leidend voor de verwerking van het ONIX bericht in de CB-systemen. Indien er geen tekenset is aangegeven wordt er van uitgegaan dat de tekenset UTF-8 is.
Start ONIX-bericht
ONIX Message voor Reference (Long tags) en Short tags
ONIXMessage voor Reference (Long tags)
<?xml version="1.0" encoding="UTF-8"?>
<ONIXMessage release="3.1">
Hieraan kan eventueel worden toegevoegd op basis van welk schema het bericht gevalideerd is; de message declaration komt er dan als volgt uit te zien:
<?xml version="1.0" encoding="iso-8859-1"?>
<ONIXMessage release="3.1" xmlns="http://ns.editeur.org/onix/3.1/reference">ONIXmessage voor Short tags
<?xml version="1.0" encoding="UTF-8"?>
<ONIXmessage release="3.1" xmlns="http://ns.editeur.org/onix/3.1/short">Validatie schema voor Reference
Een ONIX bericht met short tags wordt door CB direct omgezet naar long tags. Alle bij CB aangeboden ONIX berichten worden vervolgens gevalideerd met het schema voor de Reference (long tags).
Header composite
Een groep van data element welke tezamen de message header vormen. Verplicht in ieder ONIX bericht. | |
|---|---|
Reference name | <Header> |
Short tag | <header> |
ONIX M/O | M |
CB M/O | M |
Example/voorbeeld | <Header>
<Sender>
<SenderIdentifier>
<SenderIDType>10</SenderIDType>
<IDValue>7200124</IDValue>
</SenderIdentifier>
<SenderName>Veen Bosch & Keuning Uitgeversgroep BV</SenderName>
<ContactName>KCC VBK Media</ContactName>
<EmailAddress>kcc@vbkmedia.nl</EmailAddress>
</Sender>
<Addressee>
<AddresseeIdentifier>
<AddresseeIDType>10</AddresseeIDType>
<IDValue>8894126</IDValue>
</AddresseeIdentifier>
<AddresseeName>Centraal Boekhuis B.V.</AddresseeName>
</Addressee>
<MessageNumber>201301040</MessageNumber>
<SentDateTime>20180130T104000</SentDateTime>
</Header> |
Sender composite
Een groep van data element welke tezamen de de gegevens van de afzender van het bericht bevatten. Verplicht in ieder ONIX bericht. | |
|---|---|
Reference name | <Sender> |
Short tag | <sender> |
ONIX M/O | M |
CB M/O | M |
Sender Identifier composite
Een groep van data elementen welke tezamen de identificatie van de afzender van het bericht vormen. | |
|---|---|
Reference name | <SenderIdentifier> |
Short tag | <senderidentifier> |
ONIX M/O | O |
CB M/O | M |
Example/voorbeeld | Voor levering van gegevens door CB
<SenderIdentifier>
<SenderIDType>10</SenderIDType>
<IDValue>8894126</IDValue>
</SenderIdentifier>
Voor aanleveren van gegevens bij CB
<SenderIdentifier>
<SenderIDType>10</SenderIDType>
<IDValue>7200124</IDValue>
</SenderIdentifier> |
H.1 Sender ID Type
De type codering van de afzender die wordt opgenomen in het element <IDValue>. | |
|---|---|
Format/Posities | Numeriek, 2 posities. Waarde '10' uit de Code-list duidt aan dat het een CB Relatie ID betreft |
Reference name | <SenderIDType> |
Short tag | <m379> |
Code list | |
ONIX M/O | M |
CB M/O | M |
Example/voorbeeld | <SenderIDType>10</SenderIDType> |
H.3 ID Value (afzender)
De afzender van het bericht wordt geïdentificeerd door middel van het Relatie ID bij CB. Dit is een uniek identificatienummer gebruikt voor identificatie van zowel leveranciers als boekverkopers. | |
|---|---|
Format/Posities | Numeriek, 7 posities. Het CB Relatie ID |
Reference name | <IDValue> |
Short tag | <b244> |
ONIX M/O | M |
CB M/O | M |
Example/voorbeeld | Voor levering van gegevens door CB
<IDValue>8894126</IDValue>
Voor aanleveren van gegevens bij CB
<IDValue>7200124</IDValue> |
End of Sender Identifier composite
H.4 Sender Name
De bedrijfsnaam van de afzender van het bericht | |
|---|---|
Format/Posities | Alfa Numeriek, maximaal 50 posities. |
Reference name | <SenderName> |
Short tag | <x298> |
ONIX M/O | O |
CB M/O | M |
Example/voorbeeld | Voor levering van gegevens door CB
<SenderName>CB B.V.</SenderName>
Voor aanleveren van gegevens bij CB
<SenderName>Veen Bosch & Keuning Uitgeversgroep BV</SenderName> |
H.5 Sender Contact Name
H.6 Sender contact e-mail addres
End of Sender composite
Addressee composite
Addressee identifier composite
H.7 Addressee identifier type
H.8 ID Value (geaddresseerde)
End of Addressee indentifier composite
End of Addressee composite
H.13 Message sequence number
H.15 Message creation date/time
End of Header composite
Product composite
P.1.1 Record reference
P.1.2 Notification type
P.2 Product identifier composite
P.2.1 Product identifier type code
P.2.3 Identifier value code
End of Product identifier composite
Block 1 Product description, Descriptive detail - Beschrijvende gegevens
Descriptive detail composite
P.3.1 Product composition
P.3.2 Product form
P.3.3 Product form detail
Product form feature composite
P.3.4 Product form feature type
P.3.5 Product form feature value
P.3.6 Product form feature description
End of Product form feature
P.3.8 Product form description
P.3.10 Primary content type code - Verduidelijking van het type product
P.3.11 Product content type code - Verduidelijking van het type product
P.3.16 Epub technical protection
Epub usage constraint composite
P.3.17 Epub usage type
P.3.18 Epub usage status
End of Epub usage constraint composite
Product classification composite
P.3.22 Product classification type code
P.3.23 Product classification code
P.3.24 Percent
End of Product classification composite
Collection composite - Bibliografische reeks
P.5.1. Collection type
TitleDetail - Collection type composite