ONIX 3 CB to Retailers - bericht voor retailers
Wijzigingshistorie | ||
Datum | Onderdeel | Wijziging |
Apr 17, 2026 | ONIX upgrade Codelist issue 72 | Implementatie Codelists issue 72, Release 20-01-2026 |
Apr 17, 2026 | P.6.1 TitleType waarde 03 | Voor Nederlandse ISBN’s kan de ‘Oorspronkelijke titel bij vertaald werk’ al worden vastgelegd met TitleType waarde 03. Dit wordt ook voor buitenlandse ISBN’s ondersteund |
Apr 17, 2026 | P.10 Language - Taal | Originele taal wordt toegevoegd voor ‘Oorspronkelijke titel bij vertaald werk’ Bij fysieke en digitale boeken, Nederlandse en buitenlandse ISBN’s met een 'Oorspronkelijke titel bij vertaald werk', TitleType waarde 03, voegen we de mogelijkheid toe om de taalcode van het oorspronkelijke werk vast te leggen. We voegen hiervoor aan P.10 Language - Taal een extra Language composite toe met LanguageRole waarde 02. <Language>
<LanguageRole>01</LanguageRole>
<LanguageCode>dut</LanguageCode>
</Language>
<Language>
<LanguageRole>02</LanguageRole>
<LanguageCode>eng</LanguageCode>
</Language> |
Apr 17, 2026 | PublishingDate | Release jaar - Actueel jaar van uitgave wordt ook ondersteund voor buitenlandse ISBN’s. Voor Nederlandse ISBN’s werd dit al ondersteund. <PublishingDate>
<PublishingDateRole>16</PublishingDateRole>
<Date dateformat="05">2023</Date>
</PublishingDate> |
Uitgesteld | P.3.10 Primary content type | Ter voorbereiding op de overgang van hosting van audioboeken van Luisterhuis naar Bookwire wordt de PrimaryContentType waarde 02 - Audio drama toegevoegd. Daarmee ondersteunt CB de waardes 01 en 02. |
Apr 17, 2026 | P.19.4 Imprint name - Bibliografische imprint | Als de door de uitgever aangeleverde imprint afwijkt van de bij CB bekende imprint in hoofdletters, kleine letters, diakritische tekens of spaties vóór of na de imprintnaam, koppelt CB deze aan de al bekende imprint. |
Apr 17, 2026 | Collection composite | Als de door de uitgever aangeleverde reeksnaam afwijkt van de bij CB bekende reeks in hoofdletters, kleine letters, diakritische tekens of spaties voor of achter de reeksnaam, koppelt CB de titel aan de al bekende reeks |
Apr 17, 2026 | Product form feature composite | Toegankelijkheidsgegevens digitale producten uitgebreid met Toegankelijkheidsgevaren (Hazard warning) Toegankelijkheidsinformatie is uitgebreid met de mogelijkheid om aan te geven of de e-publicatie gevaren bevat.
|
Feb 11, 2026 | P.21.1 Sales rights met P.21 Territory composite | Verkoopland rechten (Sales rights) voor e-books worden vanaf 11 februari vastgelegd op e-book niveau en niet meer per specifiek platform. Dit houdt in dat de verkoopland insluiting en/of uitsluiting niet meer in block 6 Product Supply - Market - P.24 Territory composite doorgegeven wordt maar in block 4 Publishing Detail - Sales rights P.21.1 met P.21. Territory composite. Nieuw is de mogelijkheid om <CountriesExcluded> bij gebruik van <RegionsIncluded> waarde 'WORLD' vast te leggen. <PublishingDetail>
<SalesRights>
<SalesRightType>02</SalesRightType>
<Territory>
specificatie d.m.v. CountriesIncluded, RegionsIncluded, CountriesExcluded
</Territory>
</SalesRights>
Voorbeelden
<SalesRights>
<SalesRightsType>02</SalesRightsType>
<Territory>
<RegionsIncluded>WORLD</RegionsIncluded>
</Territory>
</SalesRights>
<SalesRights>
<SalesRightsType>02</SalesRightsType>
<Territory>
<CountriesIncluded>AD AT BE CY DE EE ES FI FR GR HR IE IT LT LU LV MC ME MT NL PT SI SK SM VA</CountriesIncluded>
<RegionsIncluded>RS-KM</RegionsIncluded>
</Territory>
</SalesRights>
<SalesRights>
<SalesRightsType>02</SalesRightsType>
<Territory>
<RegionsIncluded>WORLD</RegionsIncluded>
<CountriesExcluded>GS</CountriesExcluded>
</Territory>
</SalesRights> |
Feb 11, 2026 | P.21.3 - P.24.2 Regions included | Regio ECZ (Eurozone) in <RegionsIncluded> en <RegionsExcluded> niet meer ondersteund - vervangen door <CountriesIncluded> en <CountriesExcluded> De regio ECZ (Eurozone) komt voor in ONIX list 49 maar dient uitsluitend voor compatibiliteit met eerdere versies van ONIX. CB zal een conversie doen van de bestaande ECZ data naar het equivalent: <Territory>
<CountriesIncluded>AD AT BE CY DE EE ES FI FR GR HR IE IT LT LU LV MC ME MT NL PT SI SK SM VA</CountriesIncluded>
<RegionsIncluded>RS-KM</RegionsIncluded>
</Territory> |
Feb 11, 2026 | P.3.9 Trade category | Digitaal | Kort verhaal indicatie vervalt voor e-books De indicatie dat een e-book een kort verhaal betreft wordt als gevolg van de distributie via Bookwire voortaan niet meer ondersteund. |
Feb 11, 2026 | SupplyDate met P.26.18 SupplyDateRole 08 bij ProductAvailability 31 'Out of stock' | Verwachte leverdatum bij 'verschenen titels zonder voorraad bij CB' Bij verschenen titels zonder voorraad, voor vooral het buitenlands assortiment, is het voor de boekverkoper wenselijk om te weten wanneer de titel weer bij CB beschikbaar is. Voor een verschenen titel zonder voorraad kan door de uitgever al ProductAvailability 31 'Out of stock' worden meegeven inclusief een datum. Deze datum geeft aan wanneer er weer voorraad verwacht wordt. Deze datum werd door CB nog niet opgeslagen en doorgegeven. |
Feb 11, 2026 | ONIX upgrade Codelist issue 71 | Implementatie Codelist issue 71, Release 31-10-2025 |
Nov 5, 2025 | ONIX upgrade Codelist issue 70 | Implementatie Codelist issue 70, Release 21-07-2025 |
Nov 5, 2025 | ProductFormFeature composite | EU Deforestation Regulation (EUDR) De EU Deforestation Regulation (EUDR) gaat in per 30 december 2025. De Due Diligence Statement referentie, afgekort: DDS, kan de uitgever registeren in het EU portaal - Deforestation Regulation - European Commission. Deze DDS-referentie wordt door de uitgever aan CB doorgegeven en wordt vervolgens opgenomen in het ProductFormFeature composite. Bij het opgeven van de DDS wordt het per 5 november verplicht om de verificatiecode mee te geven, daarmee kan binnen de keten worden gevalideerd of de DDS geldig is. Het format voor DDS-referentie met bijbehorende verificatiecode is conform ONIX specificatie: 24FRXVV3VOS991+0123456789
Daarnaast worden per 5 november onderstaande mogelijkheden toegevoegd. Daarmee kan worden aangegeven als er een uitzondering geldt waardoor geen DDS beschikbaar is voor het betreffende product:
|
11 Jun 2025 | TitleText - vooralsnog ongewijzigd TitleText in Collection composite | TitleText blijft vooralsnog ongewijzigd en zal gefaseerd ingevoerd worden Ten behoeve van sorteerdoeleinden dient een voorvoegsel of lidwoord in de titel, <TitlePrefix>, gescheiden te worden van de titel,<TitleWithoutPrefix>. Als er geen voorvoegsel of lidwoord aanwezig is de <NoPrefix/> indicator van toepassing. Collection composite - P.5.10 <TitleText> vervalt en wordt vervangen door P.5.11<TitlePrefix>, P.5.11a <NoPrefix/> en P.5.12 <TitleWithoutPrefix> |
- 1 Inleiding
- 2 Het doel van het bericht
- 3 Gebruik document
- 4 Zoekadvies
- 5 Beschikbaarstelling van het bericht
- 6 Assortimenten
- 7 Tips en trucs
- 7.1 Welke titels lees ik in?
- 7.2 Hoe verwerk ik mutaties?
- 7.3 Block updates, hoe verwerk ik een ONIX 3 mutatie bericht?
- 7.4 Hoe toon ik een titel op mijn website?
- 7.5 Het tonen van een auteursnaam op een website
- 7.6 Het tonen van de naam van de uitgever op een website
- 7.7 Het interpreteren van prijsinformatie
- 7.8 Het interpreteren van beschikbaarheidsinformatie
- 7.9 Verschillende uitgaven met dezelfde inhoud bij elkaar tonen
- 8 Opbouw Product record
- 9 Beschrijving van een Data element
Inleiding
Voor het presenteren van artikelen in de etalage van een webwinkel en het correct tonen van boekgegevens is het belangrijk standaarden te gebruiken voor gegevensuitwisseling. ISBN is al decennia de internationale standaard voor het uniek identificeren van een boekuitgave, beheerd door het International ISBN Agency in Londen. Bureau ISBN is in Nederland verantwoordelijk voor de toepassing van ISBN en het eenduidig vastleggen van titelgegevens van boeken met een ISBN. ONIX is al jaren de internationale standaard voor het uitwisselen van gegevens van boeken met een ISBN, beheerd door EDItEUR. CB faciliteert als spin in het web van de Nederlandse boekenbranche Bureau ISBN en vertegenwoordigt Nederland binnen EDItEUR.
Het doel van het bericht
Dit document beschrijft de aanlevering van artikelgegevens door het CB aan boekverkopers, uitgevers en andere derden. Deze aanlevering volgt de internationale ONIX-standaard. Het document behandelt de gegevensuitwisseling vanuit de systemen van CB voor het inlezen in de systemen van afnemers van CB's titelinformatie.
Boekgegevens worden regelmatig aangepast. Een nieuw boek wordt aangekondigd voordat het verschijnt. Bij verschijnen controleert en voltooit Bureau ISBN de gegevens. Prijzen en beschikbaarheid veranderen in de tijd. Uitgevers voegen aanvullende informatie toe, zoals cover, leesfragment, boekbeschrijving, trefwoorden en recensies. Dagelijks stuurt CB mutaties in ONIX-bestanden naar boekverkopers. Voor actuele gegevens in de webwinkel is het belangrijk deze mutaties dagelijks te verwerken.
Gebruik document
De volledige ONIX-berichtdefinitie toont de geneste structuur met blocks, composites en elementen (tags) in de inhoudsopgave. Zo zie je ook de volgorde van composites en elementen. Vanuit de inhoudsopgave klik je eenvoudig door naar de onderdelen.
Zoekadvies
Zoeken werkt het beste via de inhoudsopgave op hoofd- en subpagina's of met de functietoets F3 of CTRL + F op de betreffende pagina en niet via het zoekveld rechtsboven in het CB Wiki-scherm (zie onderstaande schermprint). Het document bestaat uit diverse componenten. Zoeken via het zoekveld zoekt in de componentendatabase, waardoor je het document en het overzicht van de gebruikershandleiding en berichtdefinitie verlaat.
Beschikbaarstelling van het bericht
Als de boekverkoper een afspraak heeft, wordt elke ochtend, behalve zaterdag, een zipbestand in de out-map van het FTP-account geplaatst. Dit bestand bevat mutaties van titels die de voorgaande dag(en) in artikelgegevens of beschikbaarheid zijn opgetreden. De zip bevat één of meer bestanden met productrecords, maximaal 2.500 per bestand.
Assortimenten
CB biedt verschillende selecties van titelgegevens aan via diverse typen ONIX-berichten. Deze selecties verschillen in het assortiment titels. De XML-structuur, het gebruik van elementen en hun inhoud zijn grotendeels hetzelfde. Voor de boekverkoper kunnen één of meerdere selecties geactiveerd worden.
De bestanden worden als zip-bestand aangeboden en geplaatst in de out-map van de FTP-account die voor de boekverkoper op de CB FTP-server is ingericht. Deze bestanden bevatten mutaties van artikelgegevens en beschikbaarheid sinds het vorige mutatiebericht. Een zip-bestand bevat één of meerdere bestanden met maximaal 2500 Product records per bestand.
In een weekend of op een feestdag kan het voorkomen dat er geen enkel artikel is gemuteerd of toegevoegd. Het ONIX-bericht wordt dan toch aangemaakt om de boekverkoper te informeren dat er geen updates zijn gemist. Het ONIX-bericht bevat dan geen Product records, maar een <NoProduct/>-tag.
Om één of meer selecties af te nemen, moet in de CB-systemen de dienst voor het betreffende assortiment geactiveerd worden Elke dag, behalve op zaterdag, wordt een mutatiebericht gegenereerd en in de out-map van het FTP-account geplaatst.
Bij aanvang genereert het systeem een initieel basisbestand met complete productrecords voor het assortiment. Voor het dagelijks up-to-date houden van de artikeldata worden dagelijks mutatieberichten aangeboden.
E-books in ONIX 3 versus DIPRAGMTCS.xml bericht
In het ONIX bericht met e-book metadata is het volledige e-book assortiment van CB opgenomen. Niet al deze titels worden geleverd aan alle boekhandels. Uitgevers maken over e-books vaak exclusiviteitsafspraken met bepaalde webwinkels. De titels waarvoor een exclusiviteitsafspraak geldt zijn wel opgenomen in het ONIX bericht met e-book metadata maar kun je niet altijd bestellen.
Het is mogelijk om in het ONIX-bericht aan te geven dat een titel onder een exclusiviteitsafspraak valt, maar uitgevers hebben er bezwaar tegen dat deze informatie openbaar wordt. Uitgevers hebben er ook bezwaar tegen dat gemaakte kortingsafspraken aan alle boekhandels openbaar worden gemaakt in een ONIX-bericht.
Er wordt gewerkt aan een oplossing hiervoor, dit heeft als consequentie dat je als webwinkel die e-book dienstverlening van ons afneemt niet kunt volstaan met het ONIX-bericht met de e-book metadata.
Voor de bepaling welke welke titels de webshop kan bestellen en welke korting voor de webshop van toepassing is dient het aanvullende afspraken bericht voor digitale producten, het zogenaamde DIPRAGMTCS bericht, dit wordt dagelijks verstrekt. De specifieke informatie m.b.t. e-books in de ONIX blokken wordt in de betreffende blokken beschreven.
Tips en trucs
Welke titels lees ik in?
Mogelijk zijn niet alle titels relevant voor de webwinkel. Sommige titels in het bestand zijn niet (meer) leverbaar en wil je uitsluiten van de website. Filter hiervoor op de waarde in de tag <ProductAvailability>. Titels met ProductAvailability 21, 22 of 23 zijn direct leverbaar. Bij ProductAvailability 10, 12, 30, 31, 32 en 34 worden orders in nota genomen. Alle andere ProductAvailability-waarden betekenen dat de titels niet (meer) leverbaar zijn.
Het is van belang om alle mutaties in zijn geheel te verwerken, ook van titels die u nog niet hebt opgenomen.
Hoe verwerk ik mutaties?
Mutaties zijn bijvoorbeeld: aanvullen of bijwerken van titelgegevens of auteurs, wijzigen van beschikbaarheid of prijs, toevoegen of aanpassen van cover, leesfragment, boekbeschrijving, promotionele tekst of trefwoorden. Verwerk mutaties dagelijks om de website actueel te houden.
Een ONIX-bericht bestaat uit blokken. Mutaties worden als block update doorgegeven. Bij een mutatie op een titel krijg je geen volledig record, maar alleen het block of de blocks met wijzigingen. Hiermee overschrijf je de identieke blocks in de database.
Voorbeeld: de prijs van een boek wijzigt.
De prijs staat in het block ProductSupply.
Het ONIX-bericht is een blockupdate van het block ProductSupply. Dit bevat alle gegevens van het block en vormt de volledige nieuwe waarheid. Je overschrijft het block ProductSupply in de eigen artikeldatabase met het aangeleverde block. De overige blocks blijven ongewijzigd omdat je die niet opnieuw ontvangt.
Block updates, hoe verwerk ik een ONIX 3 mutatie bericht?
Hoe toon ik een titel op mijn website?
Voor de vindbaarheid van een titel is het belangrijk om de titelgegevens juist en volledig op te nemen. De klant moet kunnen zoeken op herkenbare woorden uit de titel en de serie. Vooral de naam van een serie is het meest herkenbare deel van de titel waarop de klant eerst zoekt. De serie/reekstitel staat in een aparte <Collection> composite. Betrek deze daarom bij de opbouw van de titel op uw website.
Ons advies is om van de serie/reeks titel een apart veld te maken waar op gezocht kan worden en waar de klant alle titels uit dezelfde serie gemakkelijk kan zien.
Heeft de database geen apart veld voor de serie/reeks, gebruik dan de volgende logica:
Controleer of er een <Collection> composite met bijbehorend <TitleText> en eventueel <PartNumber> in het ProductRecord aanwezig is. Zo ja, plaats deze altijd vooraan in de titelopbouw. Is deze afwezig, laat hem dan weg.
Controleer daarna hoeveel TitleElementLevels in de <TitleDetail> composite met <TitleType> 01 zitten.
Is er alleen een <TitleElementLevel> 01, neem dan de <TitleText> daarvan.
Is er een <TitleElementLevel> 01 en 02, neem dan eerst de <TitleText> van level 02 en daarna die van level 01.
Is er een <TitleElementLevel> 01, 02 en 03, neem dan eerst de <TitleText> van level 03, daarna die van 02 en tenslotte die van 01.
De titelopbouw geeft het meest specifieke element het laagste <TitleElementLevel>.
Volg je deze logica, dan werkt het in alle gevallen goed.
Het tonen van een auteursnaam op een website
Een klant die in een webwinkel een titel zoekt op auteur kan last hebben van verschillende schrijfwijzen van dezelfde auteursnaam (Annie Schmidt, Annie M.G. Schmidt, A.M.G. Schmidt).
Een webwinkel kan dit oplossen door de gestandaardiseerde auteursnaam in te lezen. Zo maakt de webwinkel alle titels van dezelfde auteur onder één naamsvermelding vindbaar en plaatst titels van dezelfde auteur bij elkaar. Omdat nog niet alle titels gestandaardiseerde auteursnamen hebben, wordt de volgende logica aangeraden:
Toon <Contributor> composite met <PrimaryNameType> 02 – authority controlled – als deze aanwezig is. Dit is de gestandaardiseerde auteursnaam
Als er geen <Contributor> composite met <PrimaryNameType> 02 is, toon de auteursnaam uit de <ContributorComposite> zonder <NameType>. Dit is de auteursvermelding zoals die Bureau ISBN bij redactionele controle in het boek aantrof.
Het tonen van de naam van de uitgever op een website
Een boek wordt uitgegeven door een uitgever. De naam van de uitgever zoals die in het boek staat, is de “merknaam” (in boekjargon: imprint) en vergroot de herkenbaarheid van het boek. De uitgever wil daarom zijn naam bij de titelgegevens op de website opnemen. In het ONIX 3.0-record staat de <PublisherName> (de naam van de uitgever die het boek via CB distribueert). Als deze naam afwijkt van de naam in het boek, wordt ook de <ImprintName> opgenomen.
Ons advies is om voor het tonen van de uitgeversnaam op de website de volgende logica te hanteren:
Toon de <ImprintName>
Als deze niet aanwezig is, toon de <PublisherName>
Het interpreteren van prijsinformatie
Het is belangrijk dat het boek in de webwinkel met de juiste prijs wordt getoond. Realiseer je dat een ONIX-bestand meerdere prijsperioden kan bevatten, maar er altijd slechts één prijs geldig is.
Een ONIX-record kan naast een standaardprijs ook een tijdelijke actieprijs bevatten.
De aanbevolen logica is:
Is er op de systeemdatum een actieprijs geldig, vermeld dan de actieprijs. Deze is herkenbaar aan PriceType 14 (fysieke boeken) of PriceType 12 (e-books).
Is er geen actieprijs van toepassing, vermeld dan de bruto vaste boekenprijs (PriceType 04) of de bruto adviesprijs (PriceType 02).
Het interpreteren van beschikbaarheidsinformatie
De klant die op de site van een webwinkel zoekt, moet correct geïnformeerd worden over de beschikbaarheid van een titel. Dit is belangrijk omdat hij vaak vooruit betaalt en het boek niet had besteld als hij wist dat het niet leverbaar was. Daarom is het essentieel om dagelijks de wijzigingen in beschikbaarheid te verwerken. De beschikbaarheidsstatus bepaalt of een titel leverbaar is en hoe orders worden afgehandeld.
Verschillende uitgaven met dezelfde inhoud bij elkaar tonen
Een klant die een bepaald boek zoekt, ziet graag in één overzicht welke uitvoeringen beschikbaar zijn: paperback, hardback, ebook en luisterboek. Dit zijn vier verschillende ISBN’s, maar hetzelfde werk. De koppeling tussen verschillende uitvoeringen van hetzelfde werk op uw website legt u via het NSTC (zie Block 5 RelatedMaterial).