ONIX 3.0.3

Auteur Margot Kersaan

...

Opbouw document

Dit document beschrijft de aanlevering van artikelgegevens door het CB aan boekverkopers, uitgevers en andere derde partijen. Deze gegevens aanlevering is gebaseerd op de internationale ONIX 3.0 standaard. In dit document worden de verschillende aspecten van de gegevensuitwisseling beschreven zoals die worden gebruikt vanuit de systemen van CB ten behoeve van het inlezen in de systemen van afnemers van titelinformatie van CB.

Uitgangsdocumentatie

De volledige documentatie betreffende de ONIX 3.0 standaard is te vinden en te downloaden op www.editeur.org. 

Voor ontwikkeling van de berichtuitwisseling gaan we uit van de onderstaande versie van de ONIX standaard:

• ONIX for Books, Product Information, Format Specification Release 3.0 , Revision 3, April 2016
• ONIX Code Lists, Issue 35

Interpretatie van het ONIX 3.0 bericht.
In de ONIX 3.0 bericht standaard is een zeer groot aantal gegevens opgenomen. In de ONIX 3.0 bericht standaard is een zeer groot aantal gegevens opgenomen. De gehele standaard wordt aanvaard.

Het CB levert niet alle mogelijke gegevens aan, maar beperkt zich tot de in het document beschreven elementen. Dit geldt ook voor mogelijke waarden die worden aangeleverd om elementen te classificeren.

Doel van de ONIX 3.0 berichten

Gegevens van boeken worden regelmatig aangepast. Een nieuw boek wordt al aangekondigd voordat het is verschenen. Bij verschijnen van het boek worden de gegevens gecontroleerd en compleet gemaakt door Bureau ISBN. Prijzen en beschikbaarheid kunnen wijzigen in de loop van de tijd. Er wordt aanvullende informatie toegevoegd door de uitgever zoals covers, leesfragmenten, boekbeschrijvingen. Dagelijks worden alle mutaties doorgegeven naar de boekverkopers/webwinkels in ONIX mutatiebestanden. Voor het up to date houden van de gegevens over het boek in de webwinkel is het belangrijk om dagelijks de mutaties te verwerken.

Tekenset

In de ONIX 3.0 files wordt gecommuniceerd met de UTF-8 tekenset. 

Assortimenten en beschikbaarstelling van het bericht

...

E-books in Onix 3.0

In het ONIX 3.0 bestand 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 3.0 bestand met e-book metadata maar kunt u niet altijd bestellen.
Het is mogelijk om in het ONIX 3.0 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 3.0 bestand. 

Er wordt gewerkt aan een oplossing hiervoor, dit heeft als consequentie dat u als webwinkel die e-book dienstverlening van ons afneemt niet kunt volstaan met het ONIX 3.0 bestand met de e-book metadata. 
Om er achter te komen welke titels u kunt bestellen en wat voor korting u krijgt dient u aanvullend gebruik te maken van een dagelijks eboeken.csv mutatiebestand, het EBOOK_UIT bericht. De specifieke informatie m.b.t. e-books in de ONIX 3.0 blokken wordt in de betreffende blokken beschreven.

FTP account

Beschikbaarstelling van het bericht

Als de boekverkoper hiervoor een afspraak heeft, wordt dagelijks iedere ochtend, met uitzondering van zaterdag, een zip file geplaatst in de out-map van het FTP account wat voor de boekverkoper is ingericht. Dit bevat de mutaties van titels die gedurende de voorgaande dag(en) zijn opgetreden in de artikelgegevens of in de beschikbaarheid van een artikel. De zip file bevat 1 of meerdere bestanden met Product records, maximaal 2.500 per bestand.

Tips en trucs

Welke titels lees ik in?

...

Voorbeeld: de prijs van een boek wijzigt.
De prijs is opgenomen in het block ProductSupply.
U krijgt in het ONIX bericht een Block update door van het Block ProductSupply. Dit bevat alle gegevens in het Block ProductSupply en bevat de volledige nieuwe waarheid van dat block. U overschrijft het block ProductSupply in uw eigen aritkelbestand met het aangeleverde block. De overige blocks blijven ongewijzigd in uw database want deze krijgt u niet opnieuw aangeleverd.

Block updates, hoe verwerk ik een ONIX 3.0 mutatie bericht?

Hoe toon ik een titel op mijn website?

...

Ons advies is om van de serietitel een apart veld te maken waar op gezocht kan worden en waar de klant ook alle titels uit dezelfde serie gemakkelijk bij elkaar kan zien.
Als uw database geen apart veld heeft voor de serie dan adviseren wij om de volgende logica te te 
gebruiken:

1. Check of er een <Collection> composite met bijbehorend <TitleText> en evt. <PartNumber> in het ProductRecord aanwezig is.  Zo ja plaats deze dan altijd vooraan in de titelopbouw . Als hij afwezig is wordt deze natuurlijk weggelaten.
2. Check daarna hoeveel TitleElementLevels in de <TitleDetail> composite met <TitleType> 01 zitten.
   
   1. Is er alleen een <TitleElementLevel> 01 dan neemt u daar de <TitleText> van. 
   2. Is er een <TitleElementLevel> 01 en 02, dan neemt u eerst de <TitleText> van TitleElementLevel 02 en daarachter de <TitleText van TitleElementLevel 01.
   3. Is er een <TitleElementLevel 01, 02 en 03 dan neemt ue eerst de <titleText> van TitleElementLevel 03, daarna die van 02 en daarna die van 01.

...

Een klant die op zoek is naar een bepaald boek (werk) vindt het prettig als hij bij elkaar kan zien in welke uitvoeringen dit boek beschikbaar is. Bijvoorbeeld een paperback, een hardback, een ebook en een luisterboek. Dit zijn vier verschillende ISBN’s, maar het zelfde werk. De koppeling tussen verschillende uitvoeringen van het zelfde werk op uw website kunt u leggen via het NSTC. (zie Block 5 Related Materiaal).

Opbouw van het bericht

Een ONIX bericht is opgebouwd uit een Message declaration, een Header record en één of meer Product records.

...

Product Record

...

Block updates, hoe verwerk ik een ONIX 3.0 mutatie bericht?

...

Structuur van een ONIX 3.0 bericht

...

Product record

Record reference number, type and source

...

Product identifier composite

Include PageOX30 PR-Product identifier compositeOX30 PR-Product identifier compositeRelatedMaterial).