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.

Open

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.

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:

1. 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.

2. Controleer daarna hoeveel TitleElementLevels in de <TitleDetail> composite met <TitleType> 01 zitten.

3.  

   1. Is er alleen een <TitleElementLevel> 01, neem dan de <TitleText> daarvan.

   2. Is er een <TitleElementLevel> 01 en 02, neem dan eerst de <TitleText> van level 02 en daarna die van level 01.

   3. 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:

1. Toon de <ImprintName>

2. 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:

1. 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).

2. 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).

Opbouw Product record

Beschrijving van een Data element