ONIX 3.0.3
Auteur Margot Kersaan
Inleiding
Voor het presenteren van boeken in de etalage van een webwinkel en voor het juist en volledig tonen van de gegevens van de boeken is het belangrijk dat gebruik wordt gemaakt van standaards in de uitwisseling van gegevens. ISBN is al 45 jaar de internationale standaard voor het uniek identificeren van een uitgave van een boek (en onder beheer van het International ISBN Agency te Londen). Bureau ISBN is binnen Nederland verantwoordelijk voor de toepassing van het ISBN en voor het eenduidig en gestandaardiseerd vastleggen van de titelgegevens (metadata) van de boeken met een ISBN. ONIX is al 15 jaar de internationale standaard voor het uitwisselen van de gegevens van de boeken met een ISBN (en onder beheer van Editeur). CB faciliteert als spin in het web van de Nederlandse boekenbranche Bureau ISBN en vertegenwoordigt Nederland binnen Editeur.
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
Tips en trucs
Welke titels lees ik in?
Mogelijk zijn niet alle titels relevant voor uw webwinkel. Er kunnen titels in het bestand zitten die niet (meer) leverbaar zijn en die u wilt uitsluiten van het tonen op uw website. Hiervoor kunt u filteren 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 overige ProductAvailabilities 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 kunnen bijvoorbeeld zijn: het aanvullen of bijwerken van de titelgegevens of auteurs, het wijzigen van de beschikbaarheid, het wijzigen van de prijs, het toevoegen of wijzigen van een cover, een leesfragment, boekbeschrijving of promotionele tekst, het toevoegen van trefwoorden. Om de gegevens op uw website actueel te houden is het van belang dat u de mutaties dagelijks verwerkt.
Een ONIX 3.0 bericht is opgebouwd uit blokken. Mutaties worden doorgegeven als block update. Dat betekent dat u bij een mutatie op een titel GEEN volledig record krijgt aangeleverd. U krijgt alleen het block /de blocks door waarin wijzigingen zijn opgetreden. Hiermee overschrijft u de identieke blocks in uw database.
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.
Hoe toon ik een titel op mijn website?
Het is voor de vindbaarheid van een titel van belang dat u de titelgegevens juist en volledig opneemt en dat de klant van de webwinkel kan zoeken op herkenbare woorden uit de titel en de serie. Vooral de naam van een serie is het meest herkenbare deel van de titel waar de klant het eerst op zal zoeken. De serietitel staat in een aparte <Collection> composite. Het is dus van groot belang dat u deze betrekt bij de opbouw van de titel op uw 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
gebruiken:
- 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.
- Check daarna hoeveel TitleElementLevels in de <TitleDetail> composite met <TitleType> 01 zitten.
- Is er alleen een <TitleElementLevel> 01 dan neemt u daar de <TitleText> van.
- Is er een <TitleElementLevel> 01 en 02, dan neemt u eerst de <TitleText> van TitleElementLevel 02 en daarachter de <TitleText van TitleElementLevel 01.
- 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.
De titelopbouw is dus dat het meest specifieke element het laagste <TitleElementLevel> krijgt.
Als u bovengenoemde logica volgt gaat 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 met verschillende schrijfwijzes van een identieke auteursnaam (Annie Schmidt, Annie M.G. Schmidt, A.M.G. Schmidt) .
Dit kan een webwinkel oplossen door bij voorkeur de gestandaardiseerde vorm van de auteursnaam in te lezen. De webwinkel kan hiermee alle titels van dezelfde auteur onder één naamsvermelding vindbaar maken en titels van dezelfde auteur bij elkaar plaatsen. Omdat nog niet alle titels zijn voorzien van gestandaardiseerde auteursnamen 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 aanwezig is met <PrimaryNameType> 02, toon de auteursnaam uit de <ContributorComposite> zonder <NameType>. Dit is de auteursvermelding zoals die bij de redactionele controle door Bureau ISBN in het boek is aangetroffen.
Het tonen van de naam van de uitgever op een website
Een boek wordt uitgegeven door een uitgever en 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 zal dus zeker willen dat zijn naam wordt opgenomen bij de titelgegevens op de website. In het ONIX 3.0 record wordt de <PublisherName> (de naam van de uitgever die het boek laat distribueren via CB) opgenomen en daar waar de naam van de uitgever in het boek afwijkt van de <PublisherName> 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 van belang dat het boek met de juiste prijs wordt getoond in de webwinkel. Daarvoor is het goed om u te realiseren dat in het ONIX file prijzen met een ingangsdatum in de toekomst kunnen worden doorgegeven.
Het is ook goed om u te realiseren dat een ONIX record naast een standaard prijs ook een tijdelijke actieprijs kan bevatten.
De aanbevolen logica is:
- Als er op de systeemdatum een actieprijs geldig is, vermeld dan de actieprijs. Een actieprijs is herkenbaar aan PriceType 14 (voor fysieke boeken) of PriceType 12 (voor ebooks)
- Als er op de systeemdatum geen actieprijs van toepassing is, vermeld dan de bruto vaste boekenprijs (PriceType 14) of de bruto adviesprijs (PriceType 12).
Het interpreteren van beschikbaarheidsinformatie
De klant die zoekt op de site van een webwinkel moet juist worden geïnformeerd over de beschikbaarheid van een titel, al was het alleen al omdat hij vaak vooruit moet betalen en hij het boek al helemaal niet had besteld als hij had geweten dat het niet leverbaar was. Het is dus van belang om dagelijks de mutaties in de beschikbaarheid te verwerken. Voor de bepaling van leverbaar/niet leverbaar en wat er gebeurt met de orders kan de beschikbaarheidsstatus gebruikt worden.
Verschillende uitgaven met dezelfde inhoud bij elkaar tonen
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.