Aanleveren Artikelgegevens in Onix 3.0 Handleiding Onix-werkgroep Versie 1.5. - 26 april 2012
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
Inhoudsopgave
1. Over dit document 1.1 Gebruik van dit document Een standaard Onix-bericht is opgedeeld in composites. Een composite is een groepering van verwante velden (data elements). Een composite kan ook andere, onderliggende composites bevatten. Dit document volgt de groepering van verwante velden en composites zoals beschreven in ONIX for Books, release 3.0, April 2009. Voor elk besproken veld (data element) van het bestand worden in een tabel volgende punten aangegeven: DATA ELEMENT
SPEC
XML REFERENCE NAME
TAG
LA
TC
TF
HX
OPM.
Waarbij: DATA ELEMENT SPEC XML REFERENCE NAME TAG LA TC TF HX OPM
Naam van het veld (data element) Refereert naar de betrokken sectie in “Onix for books Product Information Format” Naam van het veld zoals gebruikt binnen het bericht XML-tag: verkorte code zoals gedefinieerd in schema en DTD Duidt aan of het element een language attribuur bevat Duidt aan of het element een textcase attribuut bevat Duidt aan of het element een textformat attribuut bevat Duidt aan of het element een inhoud in XHTML kan bevatten Opmerkingen over het data-element
Niet elk veld (data element) moet worden opgenomen in het Onix-bericht. Het al dan niet verplicht opnemen van een veld 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 een dergelijke composite een „O‟, maar voor velden binnen de composite een „M‟. Voor de individuele velden wordt verklaard welke gegevens deze moeten bevatten en het formaat van het veld (numeriek, alfanumeriek en aantal posities). In Onix zelf worden slechts zeer beperkt veldtypes en lengtes gedefinieerd; binnen Boekenbank en Centraal Boekhuis gelden hierop echter wel bepaalde beperkingen met het oog op interne verwerking van het bericht.
2/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
1.2 Onix 3.0 Belangrijkste wijzigingen t.o.v. Onix 2.n De voornaamste aanpassingen aan de nieuwe Onix-standaard zijn de schrapping van alle deprecated elements in Onix 2.n, de betere beschrijving van digitale producten (waar Onix 2.1 vaak nog te kort schoot), de consistentere beschrijving van sets en series en de indeling van de berichtstructuur in blocks. Dit laatste biedt de mogelijkheid om slechts een gedeeltelijke uitwisseling van een volledige titelbeschrijving te communiceren. Zo kunnen initieel enkel bibliografische blocks worden doorgestuurd, waarop later enkel blocks betreffende prijs- en leverbaarheidsgegevens worden gemuteerd. Dit maakt de berichtstructuur duidelijker en bovendien eenvoudiger te hanteren; niet alle velden dienen bij elke transactie terug verzonden, gevalideerd en ingelezen te worden. De volgende indeling in blocks is als volgt: Message Header Product Descriptive Detail Collateral Detail Content Detail Publishing Detail Related Material Product Supply
dit wordt niet als een block beschouwd aangezien deze én verplicht is voor elke berichttransactie én uniek moet zijn binnen een bericht omvat de verschillende blocks voor één product in het bericht, deze bevat volgende blocks: data-elementen P.3 tot P.13 beschrijven de eigenlijke vorm en inhoud van een product data-elementen P.14 tot P.17 hebben betrekking op informatie die bruikbaar is voor de marketing van het product data-element P.18; gebruikt om delen van de inhoud van een product door te sturen indien deze delen afzonderlijk dienen beschreven te data-elementen P.19 tot P.21 beschrijven de publicatiestatus en rechten verbonden aan het product data-elementen P.22 en P.23 beschrijven verhoudingen tot gerelateerde werken en/of producten data-elementen P.24 tot P.26 specificeren een markt en de publicatie- en beschikbaarheidstatus van een product in die markt
worden
1.3 Gebruik van het document Volgende kleurencodes worden in het overzicht gebruikt: Donkerblauw gekleurde lijnen duiden het begin van een „block‟ aan Lichtroze gekleurde lijnen duiden het begin van een sectie aan Geel gekleurde lijnen duiden nieuwe composites of data-elementen aan (t.o.v. Onix 2.1) Lichtblauw gekleurde lijnen duiden data-elementen aan die van naam gewijzigd zijn, meestal in functie van samenhang Violet gekleurde lijnen duiden elementen aan die een nieuwe plaats hebben gekregen Donkerroze gekleurde lijnen duiden elementen aan wiens inhoud verder in het document wordt toegelicht (zie “Onix for books Product Information Format”)
1.4 Longtags / Shorttags In het Onix 3.0-bericht zullen niet enkel LongTags gebruikt worden, maar moeten ook ShortTags aanvaard worden. Zowel bestanden in LongTags als in ShortTags moeten gelijkwaardig behandeld worden door de systemen die de bestanden zullen verwerken (Titelbank, CB Online, Boekenbank, enz.).
3/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
1.5 Gebruik velden in Nederland en Vlaanderen Onderstaand document werd opgesteld door de Onix-werkgroep Nederland-Vlaanderen, op basis van de documenten van EDItEUR, „ONIX_Books_Data_Elements_3.0.pdf‟ en „ONIX_Books_Format_Specification_3.0.pdf‟. Op basis van de huidige werkwijze rond titeluitwisseling in Vlaanderen en Nederland werden voor het Onix 3.0-bericht beslissingen genomen over het gebruik van de aanwezige velden in het document van EDItEUR. Dit document geldt als een richtlijn. Voor bepaalde velden in een compsosite of waarden uit een CodeList zal in onderstaand document aangegeven zijn dat die niet worden overgenomen / gebruikt. Voor die velden / waarden geldt dat ze bij het inlezen door Centraal Boekhuis en Boekenbank en in de desbetreffende uitgaande Onix-berichten niet verwerkt worden. In de uitgaande berichten beperken beide partijen zich immers tot de opgenomen waarden en velden in het onderstaande document. In uw eigen Onix-bericht beslist u echter zelf of u toch nog andere velden of waarden opneemt. Bij het doorsturen van uw Onix-bericht naar Boekenbank of Centraal Boekhuis zullen deze velden / waarden evenwel niet verwerkt worden. Wijzigingshistorie Datum 03-10-2010 11-10-2011
Wie Nicole van Wijhe, Centraal Boekhuis Annika Buysse, Meta4Books
22-03-2012
Margot Kersaan, Centraal Boekhuis
20-04-2012
Annika Buysse, Meta4Books
Wat Aan Product Availability - Publishing Status tabel waarden 04/48 toegevoegd t.b.v. POD. Aan Message sequence number (M); Stock quantity coded composite (ingebruikname); Productform, ProductFormDetail en PrimaryContentType t.b.v. luisterboeken; SalesRestrictionComposite t.b.v. informatie- en bestelrestrictie; *In gebruikname RecordSourceIdentifier t.b.v. onderscheid tussen uitgever en bibliographic agency; * in gebruikname ProductIdType 23 voor het vastleggen van het PPN van het ProductRecord, * in gebruikname ProductFormDescription, * toevoegen BTW ProductClassificatie bij ProductClassification Codes, * in gebruikname NumberOfItemsOfThisForm bij Product Part, * In gebruikname PrimaryNameType voor het vastleggen van het PPN van gethesaureerde auteursnamen, * toevoegen BISAC en BIC codes bij MainSubject, * in gebruikname Imprintidentifier t.b.v. vastleggen commerciële imprint, * in gebruikname RelationCode 13 om het fysieke boek aan te geven waarop een eboek is gebaseerd, * in gebruik nemen aantal artikelen in bindersverpakking, * in gebruikname SupplierName, * in gebruikname DiscountPercentage, PriceTypeCode 42 voor externe distributieplatforms eboeken en in gebruikname PriceStatus voor het verlenen van het vrijgaveakkoord * Tabel Product Availability – Publishing Status: Toevoeging waarde 16 van List 64 en waarde 34 van List 65 t.b.v. POD en e-boeken (zie hiervoor ook
en <SupplyDateRole>). * List 178 – Supporting resource file format: toevoeging waarde E115 (XPS= XMLPaper specification) aan aanbevolen waardes * List 5 – Product identifier type: toevoeging waarde 26 (ISBN-A) * List 158 – Resource content type: toevoeging waarde 28 (full content) en waarde 29 (full cover) * Toevoeging optionele tag <SequenceNumber> binnen <TitleElement> 4/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
* Toevoeging optionele tag <TitleStatement> binnen P.5 Collection en P.6 Title * Toevoeging optionele tag binnen P.5 Collection * Wijziging herhaalbaarheid van de volgende tags (<MessageNote>, , , , , , <WebsiteDescription>, , , <EditionStatement>, , , , , , , , , , <SalesRestrictionNote>, <MarketPublishingStatusNote>, )
26-04-2012
Margot Kersaan, Centraal Boekhuis
* Verwijdering composite (deprecated) * Ingebruikname P.22 Related works i.f.v. het ISTC-agentschap * Toevoeging nieuwe waardes voor Sales Restriction i.f.v. informatie- en bestelrestrictie bij CB. In gebruikname Market composite en Territory composite t.b.v. eboeken
5/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
Message header In de header worden zowel de afzender als de geadresseerde van het bericht geïdentificeerd. Er wordt ook een unieke code aan het volledige bericht meegegeven in functie van de verwerking. Een overzicht van de gebruikte composites en velden. DATA ELEMENT
SPE C
XML REFERENCE NAME
TAG
OPMERKING | OMSCHRIJVING
O|M
O|M
BESLISSING W ERKGROEP OVER GEBRUIK VELD
Message header Header composite
Sender composite
<Sender>
Sender identifier composite
Wordt overgenomen
1 Identificatie van de afzender van het bericht
1
<SenderIdentifier>
M M
De volledige Sender Composite wordt overgenomen, behalve H2 (Identifier type name). Wordt overgenomen
0-n Sender identifier type code, List H.1 44 Identifier type name H.2
<SenderIDType>
<m379 Code 10 duidt CB-Relatie ID aan > -
Identifier value
H.3
CB-Relatie ID
Sender name
H.4
<SenderName>
0-1
-
Mandatory; In H1 duidt code 10 het CB-relatie ID aan, het relatie-ID zelf komt in H3 Gebruiken we niet
1
M
Wordt overgenomen
M
Mandatory; In H4, Sender name, wordt telkens de instantie opgenomen die het bericht verstuurd bv. Titelbank, Titelive, Boekenbank….
O
Gebruiken we niet
O
Gebruiken we niet
O
De Adressee Composite is volledig optioneel
O
Gebruiken we niet
O
Gebruiken we niet
0-1
-
Gebruiken we niet
1
O
Gebruiken we niet
O
Gebruiken we niet
O
Gebruiken we niet
O
Gebruiken we niet
M
Het opnemen van de „Lastdatetime‟ wordt aanbevolen door de Onix-werkgroep Nederland-
1
<x298> Naam van de afzender
M
0-1 Sender contact
H.5
Sender email
H.6
<EmailAddress>
Addressee composite
<x299> Verantwoordelijke voor de samenstelling van het bericht <j272> E-mailadres van de verantwoordelijke in <x299> Identificeert de ontvanger
Addressee identifier composite Addressee identifier type code, List 44
H.7
Identifier type name
H.8
-
Identifier value
H.9
CB-Relatie ID
Addressee name
H.10
0-1 0-n 0-n
0-1
<m380 >
Code 10 duidt CB-Relatie ID aan 1
<x300> Code 10 duidt CB-Relatie ID aan 0-1
Addressee contact
H.11
Addressee email
H.12
<EmailAddress>
Message sequence number
H.13
<MessageNumber>
<x299> Verantwoordelijke voor ontvangst bericht <j272> E-mailadres van de verantwoordelijke in <x299> <m180 Lastsenddatetime: > YYYYMMDDTHHMMSS:
0-1 0-1 0-1
6/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Message repeat number
H.14
<MessageRepeat>
Message creation date/time
H.15
<SentDateTime>
Message note
H.16
<Messagenote>
Default language of text, List 74 H.17 Default price type, List 58
H.18
Default currency
H.19
April 2012
Message Sequence Number bevat een datum en tijdstempel, namelijk “Lastsenddatetime”, waarbij T als letter wordt opgenomen om de overgang tussen datum en tijd aan te geven. Het veld is optioneel. -
<m181 > <x307> Datumstempel (YYYYMMDD) <m183 > <m184 > <x310> -
<m186 >
-
0-1 1 0-n 0-1 0-1 0-1
O M
Vlaanderen omdat het de volgorde van verwerking van het bestand vooruithelpt! Anderzijds wordt ook aangeraden om in de bestandsnaam van de Onix-berichten deze informatie (Lastsenddatetime, in formaat YYYYMMDDTHHMMSS‟) op te nemen. Gebruiken we niet
O
Message creation date/time, bevat een gewone timestamp. Het veld is mandatory Gebruiken we niet
O
Gebruiken we niet
O
Gebruiken we niet
O
Gebruiken we niet
Verschil Onix 2.1: Verzender van het bericht kan in Onix 3.0 ook worden geïdentificeerd door middel van het veld <SenderName> en In de Sender Identifier Composite wordt de afzender van het bericht geïdentificeerd door middel van het Relatie_ID bij Centraal Boekhuis. Dit is een uniek identificatienummer gebruikt door het Centraal Boekhuis om zowel leveranciers als boekhandels te identificeren. Uitgevers/distributeurs die nog geen CB Relatie_ID hebben, kunnen deze bekomen via Centraal Boekhuis of Boekenbank. H.1 <SenderIdentifierTypeCode> H.3 H.4 <SenderName>
: waarde „10‟ uit Code-list 44 duidt aan dat het een CB Relatie_ID betreft. : hier wordt het Relatie_ID geplaatst : vrij tekstveld voor de naam van de afzender
In de Addressee Composite wordt de geadresseerde van het bericht geïdentificeerd aan de hand van het Relatie_ID bij het Centraal Boekhuis. De composite is volledig optioneel Het Message Sequence Number is een uniek nummer om mogelijke dubbele verwerking van het bericht uit te sluiten. Dit nummer wordt gegenereerd door middel van een datumstempel, namelijk de Lastsenddatetime: jaar, maand, dag, uur, minuten en seconden; YYYYMMDDHHMMSS (bijv. 20080120130025) De Message creation date/time is de datum waarop het bericht verstuurd werd, samengesteld uit jaar, maand, dag, uur en minuten (ahv 24 uurs klok). YYYYMMDDHHMM
(bijv. 200801201300)
7/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
B. Product Het product record bevat de eigenlijke informatie per titel en bevat voor het Boekenbankbericht 19 composites. Een overzicht van de gebruikte velden (data elements) en composites. OPMERKING | OMSCHRIJVING: includes all of P.1 to P.26
1-n
O|M
P.1 Record reference number and type Record reference number
BESLISSING W ERKGROEP OVER GEBRUIK VELD Composite P.1 wordt overgenomen zoals in Onix 2.1. Bijkomende velden in Onix3.0 worden niet overgenomen
P.1.1
GTIN-12 (voorheen EAN) of DOI
1
M
Alle codes worden geaccepteerd. Mandatory Notification or update type code, List 1
P.1.2
Reason for deletion text
P.1.3
Record source type code, List 3
P.1.4
01 (Publisher) / (02) Publisher‟s distributor / (04) Bibliographic
Wordt overgenomen
1
M
0-n
O
De Onix-werkgroep raadt aan om altijd waarde 03 te gebruiken bij nieuwe records. Bij het inlezen van deze records wordt de bestaande informatie in de database volledig overschreven. Waarde 04 wordt uitsluitend gebruikt bij updates, zodat bij inlezen van het record enkel de geüpdatete velden overschreven worden . Gebruiken we niet
0-1
O
Wordt overgenomen
Agency
P.1.2. Notification or update type code: -
03 wordt gebruikt hoofdzakelijk om nieuwe titels aan te bieden. Het is echter nog steeds mogelijk om updates door te geven mbv 03. Het record bevat dan alle laatste informatie mbt een titel en is daarmee „de nieuwe waarheid‟: alle oude gegevens zullen worden overschreven. Indien er gegevens verwijderd moeten worden, worden deze simpelweg niet opgenomen in het nieuwe record.
-
04 kan gebruikt worden om Block updates door te geven. Dit betekent dat alleen het Block/ de blocken waar zich een wijziging in bevindt doorgegeven moeten worden. Hierbij geldt hetzelfde principe als bij 03: er wordt een nieuwe waarheid doorgegeven: het hele Block zal vervangen worden door de nieuwe informatie. Op deze manier zullen dan ook verwijderingen doorgegeven kunnen worden.
P.1.4 Record Source type code - In P.1.4. geeft waarde „04‟ aan (in het inkomende Onix 3.0-bericht) dat het bestand afkomstig is van een bibliografisch agentschap (en dus niet van een uitgever). Dit kan bv. de KB zijn, het ISBN-agentschap, Bibnet, …
8/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Record source identifier composite
Record source identifier type, List 44 Identifier type name
April 2012
P.1.5
Een herhaalbare groep dataelementen die samen de organisatie idntificeren die de bron is van het Onix-record. <x311>
0-n
-
1
-
Gebruiken we niet
Gebruiken we niet
P.1.6
-
0-1
-
Gebruiken we niet
Identifier value
P.1.7
1
-
Gebruiken we niet
Record source name
P.1.8
-
0-1
-
Gebruiken we niet
Product identifier composite wordt overgenomen zoals in Onix 2.1. Bijkomende velden in Onix3.0 worden niet overgenomen.
P.2 Product numbers Product identifier composite Product identifier type code, List 5 Identifier type name
P.2.1
P.2.2
Identifier value
P.2.3
Barcode composite
1-n 03 (GTIN-13) / 17 (legal deposit)/23 OCLC / 26 ISBN-A GTIN-13 / wettelijk depotnummer / PPN / ISBN-A -
Wordt overgenomen
1
M
Wordt overgenomen
0-1
O
Gebruiken we niet
1
M
Wordt overgenomen
0-n
-
Barcode composite wordt niet overgenomen. Deze composite heeft in Nederland en Vlaanderen geen nut (wegens geen barcode met prijs zoals in USA). Gebruiken we niet
Barcode indicator, List 141
P.2.4
<x312>
-
1
-
Position of barcode on product, List 142
P.2.5
<x313>
-
0-1
-
Gebruiken we niet
De Product identifier composite wordt gebruikt om de identificatie van de titel op te nemen in het Onix-bericht. Deze composite kan herhaald worden om, indien beschikbaar, verschillende types identificatie aan te geven (bijv. ISBN, GTIN-13, Wettelijk Depot, PPN, ISBN-A, etc…). Het meegeven van het GTIN-13 is een verplicht aan te leveren veld om de titel te kunnen identificeren
Verschil Onix 2.1: EAN is gewijzigd in GTIN-13; GS1 Global Trade Item Number, formerly known as EAN article number (13 digits)
9/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
C. Descriptive Detail
OPMERKING | OMSCHRIJVING: includes sections P.3 to P.13
0-1
O|M
BESLISSING W ERKGROEP OVER GEBRUIK VELD
P.3 Product form Deze composite geeft de uitvoering van de titel aan en bijkomende informatie over bijlage/begeleidend materiaal indien aanwezig: P.3 Product form
Product composition, List 2
P.3.1
Duidt aan of het een enkelvoudig product is dan wel meerdere items <x314> (bijlagen/begeleidend materiaal) bevat of een trade-only product betreft.
1
M
Product form code, List 150
aanduiding van de uitgavesoort van het product
P.3.2
Product form detail, List 175
P.3.3
Product form detail, List 175
P.3.3
<EpubTechnicalProtection >
een verdere omschrijving van het product
Product form feature composite Product form feature type, List P.3.4 79 Product form feature value: see P.3.5 List 98, List 99, List 76, List 143 Product form feature description Product packaging type code, List 80
M
0-n
O
0-n
O
0-n
O
1
O
0-1
O
P.3.6
0-n
O
P.3.7
0-1
O
0-1
O
0-1
O
Product form description
P.3.8
Trade category code, List 12
P.3.9
Primary content type code, List 81
1
P.3.10
Geeft aan wat het hoofdbestanddeel is als het digitale <x416> product uit meerdere onderdelen bestaat of als het slechts uit 1 onderdeel bestaat
Codelist 2 wordt volledig aanvaard
Digitale producten. Hele lijst wordt aanvaard. Codelist 150 wordt volledig aanvaard. Voor de digitale producten worden de codes LA, LB en LC voor de e-boek-vouchers gebruikt. EA, EB, ED en EC kunnen gebruikt worden voor digitale downloads. Alleen EA kan gebruikt worden als er geen extra specificaties van het product zijn. Aan de codelist moet wel een code voor de dwarsligger toegevoegd worden. Voorlopig is hier echter geen consensus over. Ook voor luisterboeken is een afzonderlijke werkwijze, zie onder voor de verduidelijking. Voor CB en Titelbank is een gereduceerde codelijst uitgewerkt.. Voor CB en Titelbank is een gereduceerde codelijst uitgewerkt. Gebruiken we niet Gebruiken we niet Gebruiken we niet Gebruiken we niet Gebruiken we niet Wordt overgenomen Gebruiken we niet Wordt overgenomen
0-1
O
10/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Product content type code, List 81
P.3.11
April 2012
Geeft aan wat de secundaire onderdelen zijn van het digitale product
Wordt overgenomen, o.a. voor luisterboeken 0-n
O
P.3.1
Product Composition:
Dit veld duidt aan of het een enkelvoudig product is of uit meerdere producten (bijlagen/begeleidend materiaal) bestaat dat als een enkel product in de handel wordt gebracht. Indien het een trade-only product betreft kan dit ook worden aangeduid (bijv. dumpbin of counterpack). Indien het product geen single-item product is, moet de Part composite worden toegevoegd om bijlagen/begeleidend materiaal te omschrijven.
P.3.2 P.3.3
Product form Product Form Details
geeft aan de hand van Code-list 150 een aanduiding van de uitgavesoort van het product geeft aan de hand van Code-list 175 een verdere omschrijving van het product
Specifieke werkwijze voor luisterboeken: combinatie van Productform, ProductFormDetail en PrimaryContentType. Luisterboek op cd Productform ProductFormDetail PrimaryContentType (codelist 81)
AC (CD-Audio) (codelist 150) A101 (cd audio), A103 (mp3) of A2xx (Daisy formaten) (codelist 175) 01 (audiobook), 02 (performance, spoken word), 13(other speech content) of 21 (partial performance)
Luisterboek download ProductForm ProductFormDetail PrimaryContentType (codelist 81)
AJ (Downloadable audio file) (codelist 150) A103 (mp3) of A2xx (Daisy formaten) (codelist 175) 01 (audiobook), 02 (performance, spoken word), 13 (other speech content) of 21 (partial performance)
P.3.8
Centraal Boekhuis gebruikt ProductFormDescription om vrije teksten op te nemen m.b.t. begeleidend materiaal.
11/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
Measure composite <Measure> Measure type code, List 48
P.3.12
<MeasureType>
<x315>
Measurement
P.3.13
<Measurement>
Measure unit code, List 50
P.3.14
<MeasureUnitCode>
<EpubTechnicalProtection > <EpubUsageConstraint>
<x316>
Country of manufacture, List 91 P.3.15 Epub technical protection, List P.3.16 144 Epub usage constraint composite Epub usage type code, List 145 P.3.17 Epub usage limit composite
<EpubUsageType>
Deze composite biedt de mogelijkheid om afmetingen van het product mee te geven. duidt het type afmeting aan (bijv. hoogte, breedte,dikte) de waarde van de afmeting duidt de eenheid van de afmeting aan (bijv. centimeter, gram, pixels) -
<x317>
0-n
O
Measure Composite wordt overgenomen zoals in Onix 2.1
1
M
Wordt overgenomen
1
M
Wordt overgenomen
1
M
0-1
-
Country of Manufacture wordt niet overgenomen
0-n
O
Alle waarden worden aanvaard
0-n <x318>
1
<EpubUsageLimit>
O
Wordt overgenomen
Wordt overgenomen
M O
Alle waarden worden aanvaard
0-n
Wordt overgenomen
Wordt overgenomen
Maximum permitted quantity
P.3.19
<x320>
1
M
Epub usage unit code, List 147
P.3.20
<EpubUsageUnit>
<x321>
1
M
Alle waarden worden aanvaard
Map scale Product classification composite
P.3.21
0-n
O
Gebruiken we niet
<MapScale>
-
Product classification type code, List 9
P.3.22
Product classification code,
P.3.23
Percentage
P.3.24
0-n 07 Sender‟s product category (CB BTW productclassificatie); 06 Fondsgroep Tekst die de waarde 07 of 06 uit Product classification type specifieert Zie onderstaande lijst
Wordt overgenomen
1
O
Wordt gebruikt voor CB fondsgroep en BTW product Classificatie
1
M
Wordt gebruikt voor CB fondsgroep en BTW product Classificatie
0-1
O
Wordt overgenomen bij BTW productclassificatie
Deze composite biedt de mogelijkheid om afmetingen van het product mee te geven. Gebruik als volgt: P.3.12 <MeasureType> P.3.13 <Measurement> P.3.14 <MeasureUnitCode>
: code-list 48 duidt het type afmeting aan (bijv. hoogte, breedte,dikte) : de waarde van de afmeting : code-list 50 duidt de eenheid van de afmeting aan (bijv. centimeter, gram, pixels)
Product Classification Composite: Specifiek voor Centraal Boekhuis wordt de Product Classification Composite in gebruik genomen. We verduidelijken hieronder: Om ervoor te zorgen dat Centraal Boekhuis de juiste BTW kan bepalen op artikelfacturen tussen uitgevers en afnemers, moeten artikelen ingedeeld worden in een Product BTW Classificatie. Met behulp van deze classificatie kan onder andere worden bepaald welk BTW-tarief geldt in een bepaald land. Dat geldt ook voor artikelen die uit meerdere onderdelen bestaan (gemengd BTW), zoals een boek met een CD. Een artikel mag uit maximaal 3 classificaties bestaan, maar moet minimaal in één classificatie zijn ingedeeld. 12/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
De toegestane Product BTW Classificaties zijn: Omschrijving Boeken Kinderboeken Studieboeken Wetenschappelijke boeken Luisterboeken op digitale gegevensdrager Non-boeken Periodieke uitgaven Naslagwerken op digitale gegevensdrager Uitgaven op digitale gegevensdrager Downloads E-boeken
Nederlands BTW-tarief Laag Laag Laag Laag Laag Hoog Laag Laag Hoog Hoog Hoog
Code Product BTW Classificatie BK_ALG BK_KIND BK_STUDIE BK_WET DG_LUISTERBOEK NB PU DG_NASLAG DG DL DL_EBOEK
Bij de classificatie wordt een percentage doorgegeven dat aangeeft voor hoeveel procent het artikel uit de betreffende classificatie bestaat. Met dit percentage en de totale prijs wordt vervolgens de deelprijs berekend. Om hierin zo min mogelijk afrondingsverschillen te krijgen, kan het percentage met 5 decimalen worden doorgegeven. Bij een artikel met meerdere classificaties moet de optelsom van de percentages gelijk zijn aan 100%. Een percentage moet tussen 0 en 100 liggen. Een voorbeeld : 06 100 07 DL_EBOEK 100
13/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
P.4 Product part Indien in werd aangeduid dat het product uit meerdere producten (bijlagen/begeleidend materiaal) bestaat, verplicht Onix de beschrijving van deze bijlagen/begeleidend materiaal in de . Verschil Onix 2.1 Om een bijlagen/begeleidend materiaal te beschrijven wordt de nieuwe Product Part composite gebruikt in tegenstelling tot Onix 2.1 waar de Contained Item Composite werd gebruikt en voorheen het veld PR.3.9 Number of Pieces en PR.3.8 Product Form Description.
OPMERKING | OMSCHRIJVING: includes sections P.3 to P.13
0-1
O|M
0-n
O
BESLISSING W ERKGROEP OVER GEBRUIK VELD
P.4 Product part Product part composite
Primary part flag
P.4.1
Product identifier composite Product identifier type code, List 5 Identifier type name Identifier value Product form code, List 150
Product form detail, List 175
<x457/ >
Wordt overgenomen
0-1
0-n
O
O
Wordt overgenomen
P.4.2
1
M
Wordt overgenomen
P.4.3
0-1
O
Wordt overgenomen
P.4.4
1
M
Wordt overgenomen
de beschrijving van de uitgavesoort van het product (conform P.3.2)
1
M
Wordt overgenomen
0-n
O
Wordt overgenomen
P.4.5
P.4.6
Product form feature composite Product form feature type, List 79
een leeg XML-element waarbij kan aangeduid worden dat het volgende beschreven deel van het product een hoofdbestanddeel is (bv. bij een boek + cd-combinatie kan het boek als hoofdelement worden aangeduid). de identificatie van het product (conform P.2.1 t/m P 2.3)
Wordt overgenomen
de detaillering van de beschrijving van het product (conform P.3.3)
-
Gebruiken we niet
-
0-n
-
1
-
-
0-1
-
Gebruiken we niet
-
Gebruiken we niet
cription> n>
-
0-n
-
0-1
-
Gebruiken we niet
-
0-n
-
Gebruiken we niet
Gebruiken we niet P.4.7
Product form feature value: see P.4.8 List 98, List 99, List 76, List 143 Product form feature description
P.4.9
Product form description
P.4.10
Content type code, List 81
P.4.11
14/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Number of pieces of specified form
P.4.12
Number of copies of specified item
P.4.13
Country of manufacture, List 91 P.4.14
April 2012
<x322> Bv. flapboekjes
0-1
O
Wordt overgenomen
<x323>
0-1
O
Wordt overgenomen
<x316>
-
0-1
-
Gebruiken we niet
15/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
P.5 Collection Part Indien de opgenomen titel deel uitmaakt van een reeks, dient informatie over deze reeks te worden opgenomen in Collection composite. Verschil Onix 2.1 Reeksinformatie werd in Onix 2.1 opgenomen in de Series Composite. Deze composite is volledig vervangen door Collection composite en de hieronder beschreven werkwijze. Verschil Onix 2.1 Setinformatie werd in Onix 2.1 opgenomen in de Set Composite. Deze composite is volledig vervangen door Collection composite en de hieronder beschreven werkwijze. DATA ELEMENT
SPEC
XML REFERENCE NAME
TAG
OPMERKING / OMSCHRIJVING
O|M
WERKGROEP
P.5 Collection Collection composite Collection type code, List 148
P.5.1
Source of ascribed collection
0-n
P.5.2
<SourceName>
<x329>
1
<x330>
0-1 0-n
O
duidt het type van reeks aan volgens List 48; waarde 10 (Publisher‟s collection) duidt aan dat het een bibliografische reeks betreft. 10 (Publisher collection)
M
-
O
De standaard waarde die ingevuld wordt onder Collection Type zal steeds waarde 10 zijn, omdat de partijen die Onix aanleveren geen andere waardes definiëren in de eigen database. Wordt niet gebruikt omdat er geen partijen zijn die een ascribed collection kunnen aanleveren.
O
Optioneel voor ISSN Waarde 02
Collection identifier composite Collection identifier type code, List 13
P.5.3
<x344>
1
Waarde 02
M
Identifier type name
P.5.4
0-1
ISSN
M
ISSN
Identifier value
P.5.5
1 0-n
M
ISSN-waarde
O
Wordt overgenomen
<x479>
1
O
Wordt overgenomen
<x480>
0-1
O
Wordt overgenomen
<x481>
1
ISSN-waarde Informatieve groep dataelementen die de positive van een product binnen een collectie aanduiden. Herhaalbaar. 01 Proprietary; 02 Title Order; 03 Publication order of products within the collection; 04 Temporal/narrative order; 05 Original publication order Een term die de volgorde aangeeft volgens de bovenstaande waarde. Enkel op te nemen indien binnen waarde 01 is aangegeven. Een getal dat de volgorde van een product binnen een collective aangeeft: getal (1ste, 2de, 3de, enz.) of multilevel getal (als er een collectie en subcollectie is). Een herhaalbare groep data-elementen die samen de volledige titel weergeven, en het type specificeren. Optioneel, maar verplicht tenzij beschreven in P.6
M
Wordt overgenomen
O
Wordt overgenomen indien bibliografische reeks 16/69
Collection Sequence Composite
P.5.5a
Collection Sequence, List 197
P.5.5b
Collection Sequence Type Name
P.5.5c
Collection Sequence Number
0-n
Title detail composite
<TitleDetail>
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
waarde 01 uit List 15 duidt aan dat het de titel betreft zoals op de cover van het werk Title type, List 15
Title element composite Sequence Number
P.5.6
<TitleType>
1 1-n
<TitleElement> P.5.6a
<SequenceNumber>
0-1
Title element level, List 149
(01 Distinctive title, Cover title, Title on item) Een herhaalbare groep data-elementen die samen een onderdeel van de titel weergeven. Ten minste één van de volgende elementen moet aanwezig zijn: <PartNumber>; ; <TitleText>; or <TitlePrefix> together with <TitleWithoutPrefix>. Niveau: product level, collection level, or subcollection level
M
Wordt overgenomen indien bibliografische reeks. Enkel waarde 01 is relevant.
M
Wordt overgenomen indien bibliografische reeks
Informatieve volgorde-aanduiding
O
Wordt overgenomen
duidt het niveau binnen een reeks aan (bijv. ingeval van sub-reeksen) 02 (Collection) / 03 (Subcollection)
M
Wordt overgenomen indien bibliografische reeks. Enkel waarde 02 en 03 is relevant.
O O
Ingevuld indien bibliografische reeks Gebruiken we niet
O
Wordt overgenomen indien bibliografische reeks
P.5.7
<TitleElementLevel>
<x409>
1
Part number
P.5.8
<PartNumber>
<x41 0>
0-1
Year of annual
P.5.9
0-1
Nummer in de reeks (bijv. Deel 4) -
Title text
P.5.10
<TitleText>
0-1
Naam van de titel van de reeks
Title prefix
P.5.11
<TitlePrefix>
0-1
-
O
Gebruiken we niet
O
Gebruiken we niet
Title text without prefix
P.5.12
<TitleWithoutPrefix>
0-1
-
Subtitle
P.5.13
<Subtitle>
0-1
-
O
Gebruiken we niet
0-1 0-n
-
O
Gebruiken we niet
-
O
Gebruiken we niet
O
Gebruiken we niet
Title Statement Contributor composite “No series” indicator (empty element)
P.5.13a
<TitleStatement>
<x478>
P.5.62
<x411/>
0-1
-
17/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
P.6 Title Deze composite wordt gebruikt voor het meegegeven van de hoofdtitel en ondertitel. Deze composite kan herhaald worden om ook de verkorte titel mee te geven en/of de oorspronkelijke hoofdtitel en/of ondertitel indien het een vertaald werk betreft. Met „hoofdtitel‟ wordt de titel bedoeld zoals die voorkomt op het titelblad. De verkorte titel kan worden aangeleverd/geëxporteerd in functie van systemen met velden met beperkte ruimte (bijv. boekhoudpakketten, facturen en pakbonnen etc…) De volgende velden worden gebruikt: DATA ELEMENT
SPEC
XML REFERENCE NAME
TAG
OPMERKING / OMSCHRIJVING
O|M
WERKGROEP
P.6 Title Title detail composite
Title type, List 15
1-n
<TitleDetail>
P.6.1
<TitleType>
<TitleElement>
1 1-n
M
Wordt overgenomen
M
Wordt overgenomen
M
Wordt overgenomen
Informatieve volgorde-aanduiding
O
Wordt overgenomen
M O
Ingevuld indien meerdelig werk
duidt aan dat het de hoofdtitel betreft zoals: 01 (zoals op cover) / 03 (originele titel) / 05 (verkorte titel)
Title element composite Sequence Number
P.6.1a
<SequenceNumber>
0-1
Title element level, List 149
P.6.2
<TitleElementLevel>
<x409>
1
Part number
P.6.3
<PartNumber>
<x410>
0-1
01 (Product) / 02 (Collection) / 03 (Subcollection) Nummering van meerdelig werk
Year of annual
P.6.4
0-1
-
O
Gebruiken we niet
Title text
P.6.5
<TitleText>
0-1
P.6.6
<TitlePrefix>
0-1
M O
Wordt overgenomen
Title prefix
Hoofdtitel -
Title text without prefix
P.6.7
<TitleWithoutPrefix>
0-1
-
O
Gebruiken we niet
Subtitle
P.6.8
<Subtitle>
0-1
O
Wordt overgenomen indien aanwezig in record
Title Statement
P.6.8a
O
Wordt overgenomen (optioneel)
Wordt overgenomen
Gebruiken we niet
<x478>
0-1
Ondertitel Informatieve tag voor de opname van de volledige collectie en hoofdtitel in de volgorde en met de interpunctie zoals gewenst door de uitgever
0-1
-
O
Gebruiken we niet
<TitleStatement>
Thesis type code, List 72 Thesis presented to
P.6.9
P.6.10
0-1
-
O
Gebruiken we niet
Year of thesis
P.6.11
0-1
-
O
Gebruiken we niet
18/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
Afspraken rond gebruik Collection Composite en Title Detail Composite in functie van bibliografische reeksen en meerdelige werken: Omdat de variaties oneindig zijn bij het gebruik van de Collection Composite en Title Detail Composite met alle mogelijke uitzonderingen voor bibliografische reeksen en meerdelige werken, besluit de Onix-werkgroep om een eenduidige afspraak hiervoor vast te leggen. Deze afspraak voor het gebruik van de Composites is een vereenvoudigde interpretatie van de adviezen van EDItEUR, en zorgt er daardoor voor dat voor afnemers en leveranciers van titelinformatie in Onix 3.0 in Vlaanderen en Nederland alles strikt geregeld is. We zijn ervan uitgegaan dat er drie richtlijnen moesten worden opgesteld, namelijk voor bibliografische reeksen, voor meerdelige werken en voor sets. De richtlijnen nemen we hieronder op.
Algemeen: -
De Distinctive Title wordt niet langer volledig in een veld opgenomen zoals in Onix 2.1, maar wordt in Onix 3.0 geconcateneerd vanuit de opgesplitste velden op Title Detail Niveau. Als aanduiding onder <TitleType> P.6.1. wordt steeds Title Type 01 gebruikt. Het PartNumber wordt op twee manieren gebruikt. o Bij Bibliografische reeksen wordt het PartNumber op het niveau van de Collection Composite geplaatst, in P.5.8 o Bij meerdelige werken wordt het PartNumber op het niveau van de Title Detail Composite geplaatst, in P.6.3
Bibliografische reeksen: - Indien de Collection Composite gevuld is, is het artikel een onderdeel van een bibliografische reeks. Ook als titel van de reeks gelijk is aan de hoofdtitel van het werk, dan wordt de titel van de reeks toch opgenomen in de Collection Composite. Op Title Detail-niveau wordt deze aan de reeks gelijk zijnde titel als hoofdtitel opgenomen. In geval van een bibliografische reeks wordt de bibliographic collection detail gevuld met de reeksnaam en de gegevens over reekstitel Meerdelige werken: - In geval van een meerdelig werk wordt alleen product title gevuld (geen bibliographic collection detail) met hoofdtitel, sectietitel en deeltitel. Hierbij nemen we maximaal 3 niveaus op. Wijziging t.o.v. Sets en Series in Onix 2.1 - In geval van sets nemen we product parts op om de inhoud van de samenstelling aan te geven. Daarnaast zal bibliographic collection detail gevuld worden met de naam van de set en product title met gegevens van de hoofdtitel van de set. Bij het individuele artikel wordt niet gebruik gemaakt van related products voor het aangeven van de relatie van de individuele titel met de set.
Voorbeeld Bibliografische reeks (Memoire en Images 2 – L’Entité de Nivelles, Baulers, Bornival, Monstreux, Thines) Product Identifier Identifier of product 03 9789076684949 Product form 00 BC
GTIN-13 / ISBN
Single-item product Paperback book 19/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Bibliographic collection detail 10 <TitleDetail> <TitleType>01 <TitleElement> <TitleElementLevel>02 <PartNumber>III <TitleText> Memoire en Images Product title <TitleDetail> <TitleType>01 <TitleElement> <TitleElementLevel>01 <TitleText> L‟Entité de Nivelles, Baulers, Bornival, Monstreux, Thines
April 2012
Publisher collection
Collection level Publisher‟s series title
Product level Product title
Voorbeeld meerdelig werk: (Percent - 2 Economie Bovenbouw HAVO – Antwoordenboek) Product Identifier Identifier of product 03 9789042538818 Product form 00 BC Product title <TitleDetail> <TitleType>01 <TitleElement> <TitleElementLevel>02 <TitleText>Percent <TitleElement> <TitleElementLevel>03 <PartNumber>2 <TitleText>Economie bovenbouw Havo <TitleElement> <TitleElementLevel>01 <TitleText>Antwoordenboek <TitleDetail>
GTIN-13 / ISBN
Single-item product Paperback book
Collection Level
Subcollection Level
Product Level
20/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
April 2012
P.7 Authorship Part 7 „Authorship‟ bevat alle informatie over bijdragers aan de titel en de aard van hun betrokkenheid; maw. auteurs, redacteurs, samenstellers, etc… Deze composite kan herhaald worden om meerdere bijdragers op te nemen voor een enkel product. DATA ELEMENT
SPEC
XML REFERENCE NAME
TAG
OPMERKING / OMSCHRIJVING
O|M
WERKGROEP
P.7 Authorship Contributor composite
Contributor sequence number
P.7.1
<SequenceNumber>
0-n
0-1
Contributor role code, List 17
P.7.2
1-n
Language from which translated, List 74
P.7.3
<x412>
0-n
Language into which translated, List 74
P.7.4
<x413>
0-n
Primary name type, List 18
P.7.5
<x414>
0-1
Name identifier composite Name ID type code, List 44
P.7.6 Identifier type name
P.7.7
M O
Zie onder voor de volledige lijst van aanbevolen waarden. CB heeft waarde Z99 toegevoegd tbv secundaire auteur Gebruiken we niet
-
O
Gebruiken we niet
02 (authority-controlled)
O
Wordt overgenomen voor gethesaureerde auteursnamen
O
O
0-n
<x415>
Herhalen voor elke betrokken bijdrager indien er meerdere betrokkenen zijn, wordt in dit veld de volgorde van betrokkenheid vastgelegd. Indien verschillende betrokkenen de waarde 01 By (author) krijgen, bepaalt deze rangorde wie als hoofd- en wie als co-auteur zal worden beschouwd: Volgnummer Type betrokkenheid A01 (auteur);A12 (Illustrator); A24 (Voorwoord) ; B01 (redacteur/samensteller); B05 (Bewerker); B06 (Vertaler); E07 (Voorlezer); Z99 (Andere) -
01 (Proprietary)
O
Gebruikt voor de uitwisseling met een vaste identifier, bv. PPN.
- Bv. PPN
O
Wordt overgenomen
- Bv. PPN-waarde
O
Wordt overgenomen
1 0-1
Identifier value
P.7.8
1
Person name
P.7.9
0-1
-
O
Gebruiken we niet
0-1
-
O
Gebruiken we niet
0-1
-
O
Gebruiken we niet
O
Overgenomen indien aanwezig
Person name, inverted Person name part 1
P.7.10 P.7.11
<TitlesBeforeNames>
Person name part 2
P.7.12
0-1
Voornaam
Person name part 3
P.7.13
0-1
Tussenvoegsels
O
Overgenomen indien aanwezig
0-1
Achternaam
O
Overgenomen indien aanwezig
O
Gebruiken we niet
Person name part 4
P.7.14
Person name part 5
P.7.15
0-1
-
Person name part 6
P.7.16
<SuffixToKey>
0-1
-
O
Gebruiken we niet
0-1
-
O
Gebruiken we niet
O
Gebruiken we niet
O
Overgenomen indien aanwezig
Person name part 7
P.7.17
Person name part 8
P.7.18
<TitlesAfterNames>
0-1
-
Corporate name
P.7.19
0-1
Naam bedrijf
21/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Alternative name composite Alternative name type, List 18
P.7.20
Name identifier composite Name ID type code, List 44
April 2012
O
Gebruiken we niet
M
Gebruiken we niet
0-n
-
O
Gebruiken we niet
1
-
M
Gebruiken we niet
-
O
Gebruiken we niet
-
M
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
-
O
Gebruiken we niet
Geboorte- / Sterfdatum toevoegen voor uniciteit -
O
Gebruiken we niet
M
Gebruiken we niet
-
M
Gebruiken we niet
-
M
Gebruiken we niet
Link met professionele bezigheden
O
Gebruiken we niet
0-n <x414>
P.7.21
bv. Bij pseudonym, kan hier link met ware naam gemaakt worden -
<x415>
1
Identifier type name
P.7.22
0-1
Identifier value
P.7.23
1
Person name
P.7.24
0-1
Person name, inverted
P.7.25
0-1
Person name part 1
P.7.26
<TitlesBeforeNames>
0-1
Person name part 2
P.7.27
0-1
Person name part 3
P.7.28
0-1
Person name part 4
P.7.29
0-1
Person name part 5
P.7.30
0-1
Person name part 6
P.7.31
<SuffixToKey>
0-1
Person name part 7
P.7.32
0-1
Person name part 8
P.7.33
<TitlesAfterNames>
0-1
Corporate name
P.7.34
0-1
Contributor date composite Contributor date role code, List 177
P.7.35
Date format, List 55
Date Professional affiliation composite
P.7.36
P.7.37
0-n <x417> <j260>
1 1
1 0-n
22/69
Aanleveren artikelgegevens in Onix 3.0 - v 1.4 ONIX Werkgroep
Professional position
P.7.38
Affiliation
P.7.39
Biographical note
P.7.40
Contributor website composite
April 2012
0-1
0-n
<Website>
0-n
Website role, List 73
P.7.41
<WebsiteRole>
Website description
P.7.42
<WebsiteDescription>
Website link - URI format
P.7.43
Contributor description Unnamed persons, List 19
P.7.44
P.7.45
<WebsiteLink>
