ONIX 3 CB to Publisher - bericht voor eigenaren
Wijzigingshistorie | ||
Datum | Onderdeel | Wijziging |
P.12.2 SubjectSchemeIdentifier - Thema & BISAC | Per 23 juli wordt Thema verplicht bij het commercieel aanmelden en/of muteren van een titel. Dit geldt voor zowel fysieke als digitale boeken. BISAC wordt per 23 juli verplicht voor alle digitale boeken. | |
P.12.4 SubjectSchemeVersion - Thema | Upgrade Thema naar versie 1.6 | |
P.12.2 SubjectSchemeIdentifier - 10 BISAC | Upgrade BISAC-versie 2024 | |
ResourceVersion - Online leesfragment EPUB en PDF | Inkijkexemplaren e-books Per 31 mei is CB gestopt met het generen van inkijkexemplaren voor e-books. Per 23 juli worden de online lees links voor de inkijkbestanden niet meer opgenomen in de ONIX-berichten van CB naar uitgever en retailer. Dit betreft het Online Leesfragment EPUB en Online Leesfragment PDF. De links naar de daadwerkelijke inkijkbestanden blijven bestaan en blijven in de ONIX-berichten opgenomen worden. Zie voor het complete overzicht: SupportingResource - ResourceVersion | |
ProductContact | General Product Safety Regulation (GPSR) Vanaf 13 december 2024 is in de Europese Unie de verordening General Product Safety Regulation (GPSR) in werking getreden. Deze vervangt de bestaande productveiligheidsrichtlijnen en vereist voor het eerst dat fysieke boeken een ‘verantwoordelijke marktdeelnemer’ toewijzen om aan productveiligheidsnormen te voldoen. Ten behoeve van de registratie van de contactgegevens is het ProductContact composite op 9 december 2024 al toegevoegd om organisatienaam, contactpersoon, telefoonnummer en e-mailadres te registreren. Per 23-07-2025 wordt dit uitgebreid met fysieke adresgegevens: P.19.22 straatnaam, P.19.23 locatie/woonplaats , P.19.24 postcode en P.19.25 landcode | |
| 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> |
ProductFormFeature composite | EU Deforestation Regulation (EUDR) is door de EU met een jaar uitgesteld naar 30 december 2025 - Due Diligence Statement(DDS) kan al voorkomen De EU Deforestation Regulation (EUDR), die op 30 december 2025 ingaat, verplicht uitgevers en boekverkopers in de EU om bij te dragen aan ontbossingsvrije toeleveringsketens. Deze wet geldt voor allerlei producten gemaakt of afgeleid van hout en aanverwante grondstoffen. Papieren boeken en drukwerken vallen hierdoor ook onder de wetgeving. Ten behoeve van de EUDR https://environment.ec.europa.eu/topics/forests/deforestation is codelist 79 waarde 50 - Due Diligence Statement referentie toegevoegd aan P.3.4 ProductFormFeatureType. Het EU-portaal waarin het Due Diligence Statement door de uitgever geregistreerd kan worden is beschikbaar. De DDS referentie kan dan voorkomen in het Product xml | |
Inleiding
Dit document beschrijft het assortimentsbericht bestemd voor eigenaren die hun artikelen laten distribueren via CB, dit betreft zowel fysieke artikelen én e-books. Het bericht is gebaseerd op de internationale ONIX standaard die wordt beheerd door EDItEUR.
"Eigenaren" is de term die bij CB in gebruik is voor uitgevers die een contract hebben met CB om hun titels te laten distribueren. Deze uitgevers ontvangen het volledige Product record van hun titels terug ontvangen in ONIX formaat. Dit bericht bevat alle titels die op de datum van aanmaak een commerciële aanmelding hebben in het actuele CB assortiment.
Het doel van het bericht
Statusoverzicht van de titels van de uitgever in het CB assortiment (titels die alleen zijn aangemeld bij Bureau ISBN worden niet opgenomen in het bericht). Het bericht is de ONIX equivalent van CB Online Uitgever 'Uw titel bij de boekhandel' en bevat enkel de gegevens die de retail ontvangt. Het bericht is een momentopname van de titelgegevens zoals die op het tijdstip van het genereren van het bericht in het CB assortiment staan. De uitgever kan mogelijk nog nieuwe aanmeldingen of mutaties op bestaande titels hebben ingediend die nog in het verwerkingsproces zitten. Deze zijn dan nog niet opgenomen in het ONIX bericht van die dag.
In de Product records worden o.a. de volgende gegevens niet opgenomen in het ONIX bericht wat de retail ontvangt en welke dan ook niet opgenomen zijn in dit bericht:
- Price composite bij titels met een SalesRestriction (Informatie- en Bestelrestrictie)
- Actieprijzen van platforms
- PriceStatus 02 (Vrijgave akkoord)
- OrderTime bij titels met een SalesRestriction (Informatie- en Bestelrestrictie)
- TitleSource (Recensies) recensies die niet voor komen op gedefinieerde lijst
- Prizes (Literaire prijzen/onderscheidingen) die niet voor komen op gedefinieerde lijst
- THEMA coderingen die door retail als niet specifiek genoeg bestempeld zijn
Wel opgenomen in het bericht is een url naar cover opgenomen. De door de uitgever aangeleverde covers worden opgeslagen daarvan worden voor verschillende doeleinden andere formaten gemaakt.
De originele door de uitgever aangeleverde (back)cover afbeeldingen worden door CB opgeslagen. In diverse processen worden de beelden gebruikt, daartoe converteert CB de origineel ontvangen afbeelding ook naar andere formaten om een ideale afmeting te hebben voor het proces waarin deze getoond worden. In het ONIX bericht wat de uitgever en de retail van CB ontvangt wordt voor e-books en fysieke artikelen het formaat met 800 pixels op de lange zijde opgenomen.
Gebruik document
De volledige ONIX berichtdefinitie is zo opgebouwd dat de geneste structuur, met blocks, composites en elementen (tags), zichtbaar is in de inhoudsopgave. Hiermee wordt tevens de volgorde van de composites en elementen weergegeven. Vanuit de inhoudsopgave kan eenvoudig worden doorgeklikt naar het betreffende onderdelen.
Zoekadvies
Zoeken kan het best vanuit de inhoudsopgave op hoofd- en sub-pagina of door gebruik te maken van de functietoets F3 of CTRL + F op de betreffende pagina en niet het zoekveld rechts bovenaan in het CB Wiki scherm (zie onderstaande schermprint). Het document is opgebouwd uit diverse componenten, bij zoeken via het zoekveld wordt er gezocht in de componenten database en verlaat u het document en daarmee ook het overzicht op de structuur van de gebruikershandleiding en berichtdefinitie.
Beschikbaarstelling van het bericht
Als de uitgever hiervoor een afspraak heeft, wordt op alle werkdagen rond 03:15 uur een zip file geplaatst in de out-map van het FTP account wat voor de uitgever is ingericht.
De structuur van de bestandsnaam is: ONIX3ieigyyyymmdd_ini_xvanx.zip (tot en met 21-05-2025 is dat ONIX30ieigyyyymmdd_ini_xvanx.zip). De zip file bevat 1 of meerdere bestanden met Product records, maximaal 2.500 per bestand. De bestandsnaam van de deelbestanden is:
Bij 2 deelbestanden is de bestandsnaam bijvoorbeeld:
- ONIX3ieig20180815_ini_1van2.onx
- ONIX3ieig20180815_ini_2van2.onx
Opbouw Product record
Een Product record bestaat uit 1 of meerdere blokken en bevat :
<Product> | ||
Record metadata | Group P.1 | Deze blokken geven aan wat het type wijziging is er over welk ISBN de volgende gegevens uit het ProductRecord betrekking hebben |
Product numbers | Group P.2 | |
<DescriptiveDetail> ...............</DescriptiveDetail> | Block 1 | Bevat de verschijningsvorm van het ISBN en de basistitelgegevens zoals titel, reeks, auteursvermeldingen, druk/editievermeldingen, de taal waarin de publicatie is uitgegeven, de omvang, en de verschillende onderwerpcoderingen zoals NUR, BISAC en AVI leesniveau (voor kinderboeken) |
<CollateralDetail> ...............</CollateralDetail> | Block 2 | Bevat vermeldingen van cover, backcover, flapteksten en andere promotionele teksten, verwijzingen naar bestanden met leesfragmenten, filmpjes, gesproken teksten die gerelateerd zijn aan de publicatie |
<ContentDetail> ...............</ContentDetail> | Block 3 | Bevat vermeldingen over individuele hoofdstukken uit een publicatie, wordt volgens de afspraken van de ONIX Werkgroep niet gebruikt in Nederland/Vlaanderen. |
<PublishingDetail> ............... </PublishingDetail> | Block 4 | Bevat gegevens over de imprints, de eigenaar, het stadium levenscyclus en de verschijningsdatum van het artikel in de markt. |
<RelatedMaterial> ............... </RelatedMaterial> | Block 5 | Bevat gegevens over NSTC, vervangende ISBN’s en ISBN’s van een fysiek boek, waarvan een ebook is afgeleid |
<ProductSupply>............... </ProductSupply> | Block 6 | Bevat alle commerciële gegevens rondom de dienstverlening van de distributeur, zoals stadium dienstverlening, prijsgegevens, BTW en boeksoorten . |
</Product> |
Beschrijving van een Data element
Ieder Block is opgedeeld in één of meer composites, een composite is een groepering van verwante velden (data elements). Een composite kan ook andere onderliggende composites bevatten. Elk veld (data element/composite) wordt als volgt beschreven:
Element of composite - de naam van het veld | |
---|---|
Uitleg - beschrijving waarvoor het veld dient. | |
Format/Posities | Alfanumeriek of Numeriek. Voor de individuele velden wordt verklaard welke gegevens deze moeten bevatten en het formaat van het veld, numeriek, alfanumeriek. In Onix zelf worden slechts zeer beperkt veldtypes gedefinieerd; binnen CB gelden hierop echter wel bepaalde beperkingen. Wanneer CB afwijkt van een richtlijn wordt dat opgemerkt bij het veld. In velden waar getallen worden ingevuld mogen in ONIX geen 0-waardes of negatieve getallen meer voorkomen. Als die er wel staan, dan is het ONIX bericht niet XSD valid. |
Reference name | Naam van het veld/element zoals gebruikt binnen het bericht |
Short tag | De codering van het veld/element zoals gebruikt binnen het bericht |
Code list | Verwijziging naar een waarde uit Code list nummer in 'ONIX Book Product Code Lists' van Editeur |
ONIX M/O | Verplicht (Mandatory) of optioneel (Optioneel) volgens ONIX |
CB M/O | Verplicht (Mandatory) of optioneel (Optioneel) volgens CB Verplichtheid geldt op twee niveaus; een composite kan zelf optioneel zijn, maar indien toegevoegd in het bericht, moeten specifieke velden binnen die composite wel ingevuld worden. Daarom staat bij deze composite een ‘O’, maar voor velden binnen de composite een ‘M’. Ditzelfde geldt voor de waarden 'M' en 'O' van het CB. |