Aanleveren Artikelgegevens in Onix 2.1. aan Boekenbank Versie 3.6 | 11 december 2012
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Inhoudsopgave
1. OVER DIT DOCUMENT _____________________________________________________ 4 1.1
Uitgangsdocumentatie ________________________________________________________________________ 4
1.2
Toepassingsveld _____________________________________________________________________________ 4
1.3
Algemene vereisten van het Onix-bericht _________________________________________________________ 4
1.4
Gebruik van dit document _____________________________________________________________________ 5
2. MESSAGE HEADER ________________________________________________________ 6 2.1 Sender identifier composite _____________________________________________________________________ 6 2.2 Sender company name | contact | email ___________________________________________________________ 6 2.3 Addressee identifier composite ___________________________________________________________________ 7 2.4 Addressee company name _______________________________________________________________________ 7 2.5 Message sequence number ______________________________________________________________________ 7 2.6 Message creation date/time _____________________________________________________________________ 7 2.7 Default price type code _________________________________________________________________________ 7
3. PRODUCT RECORD _______________________________________________________ 8 3.1 Record reference number, type and source _________________________________________________________ 8 3.1.1 Record reference number ___________________________________________________________________ 8 3.1.2 Notification or update type code______________________________________________________________ 8 3.1.3 Record source type code ____________________________________________________________________ 8 3.1.4 Product identifier composite _________________________________________________________________ 9 3.2 Product form ________________________________________________________________________________ 10 3.2.1 Product form code ________________________________________________________________________ 10 Nieuwe werkwijze voor e-boeken: ________________________________________________________________ 13 Draft: Nieuwe werkwijze voor luisterboeken _______________________________________________________ 13 3.2.2 Product Form Description __________________________________________________________________ 15 3.2.3 Number of Pieces _________________________________________________________________________ 15 3.3 Series composite _____________________________________________________________________________ 16 3.3.1 Series title _______________________________________________________________________________ 16 3.3.2 Number within series ______________________________________________________________________ 16 3.4 Set _________________________________________________________________________________________ 17 3.4.1 Product identifier composite ________________________________________________________________ 17 3.4.3 Set part title _____________________________________________________________________________ 17 3.4.4 Set Item title _____________________________________________________________________________ 17 3.5 Title ________________________________________________________________________________________ 18 2 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.6 Authorship __________________________________________________________________________________ 19 3.6.1 Contributor composite _____________________________________________________________________ 19 3.7 Edition _____________________________________________________________________________________ 20 3.8 Language ___________________________________________________________________________________ 20 3.9 Extents and other content ______________________________________________________________________ 21 3.9.1 Number of pages (Roman) __________________________________________________________________ 21 3.9.2 Number of pages (Arabic) __________________________________________________________________ 21 3.9.3 Illustrations and other content composite _____________________________________________________ 21 3.10 Subject ____________________________________________________________________________________ 22 3.10.1 Main subject composite ___________________________________________________________________ 22 3.10.2 Additional subject composite ______________________________________________________________ 22 3.11 Audience ___________________________________________________________________________________ 23 3.12 Descriptions and other supporting text __________________________________________________________ 24 3.12.1 Other text composite _____________________________________________________________________ 24 3.13 Link to image/audio/video files ________________________________________________________________ 25 3.14.1 Imprint of brand composite ________________________________________________________________ 26 3.14.2 Publisher composite ______________________________________________________________________ 26 3.15 Publishing status and dates and copyright ________________________________________________________ 27 3.16 Territorial rights and other sales restrictions ______________________________________________________ 29 3.17 Dimensions ______________________________________________________________________________ 29 3.18 Related products ____________________________________________________________________________ 30 3.18.1 Product identifier composite _______________________________________________________________ 30 3.19 Supplier, availability and prices _________________________________________________________________ 31 3.19.1 Supplier identifier composite ______________________________________________________________ 31 3.19.3 Expected Availability Date _________________________________________________________________ 34 3.19.4 Audience restriction flag __________________________________________________________________ 35 3.19.5 Price composite _________________________________________________________________________ 35
3 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
1. Over dit document 1.1 Uitgangsdocumentatie Dit document beschrijft de opbouw van het Onix-bericht voor uitwisseling van titelinformatie zoals gebruikt door Boekenbank. Deze berichtstructuur gaat in van 9 juni 2008. De uitgangsdocumentatie voor de ontwikkeling van deze berichtstructuur zijn de documenten:
ONIX for Books, release 2.1 (revision 03), January 2006 ONIX Code lists, Issue 13, March 20011
Beide documenten en meer specifieke Onix-documentatie kan u terugvinden op www.editeur.org.
1.2 Toepassingsveld De beschrijving van de verschillende velden in het Boekenbank Onix-bericht is een document dat is samengesteld en goedgekeurd door de Onix werkgroep, Nederland en Vlaanderen (www.onixwerkgroep.org). Deze tekst vormt ook een aanvulling op de brochure ‘Digitale Communicatie. Artikelgegevens via Onix’ van het Centraal Boekhuis. We hernemen in deze tekst niet de verschillende toelichtingen die in dat document zijn opgenomen.
1.3 Algemene vereisten van het Onix-bericht Onix-bestanden aangeleverd aan Boekenbank hebben een beperking in fysieke grootte. Dit in functie van een optimale verwerkingssnelheid van deze berichten. Daarom mag: -
1
1
Een onix-bericht naar Boekenbank maximaal 5000 records bevatten.
Eventuele bijkomende beperkingen in fysieke bestandsgrootte worden nog onderzocht en gecommuniceerd naar de leden 4 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
1.4 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 2.1 (revision 03), January 2006. Voor elk besproken veld (data element) van het bestand worden in een tabel volgende punten aangegeven: DATA ELEMENT
FIELD
XML REFERENCE NAME
M/O ONIX
M/O BB
M/O CB
LIST
A|N
POS.
Waarbij: DATA ELEMENT FIELD XML REFERENCE NAME M/O ONIX M/O BB M/O CB LIST A|N POS
Naam van het veld (data element) 2 Referentiecode gebruikt in Onix-documentatie Naam van het veld zoals gebruikt binnen het bericht Verplicht of optioneel (Mandatory / Optional) volgens Onix Verplicht of optioneel volgens Boekenbank Verplicht of optioneel volgens Centraal Boekhuis Gebruikte Code-list (indien van toepassing) Alfanumeriek of Numeriek Aantal posities
Indien een composite herhaald kan worden, staat achter het data element een (R) (repeatable). Niet elk veld (data element) moet worden opgenomen in het Onix-bericht. Per veld wordt aangeduid of het al dan niet verplicht is volgens de standaarden van Onix, Boekenbank of Centraal Boekhuis. Zie de velden M/O Onix, M/O BB en M/O CB in de tabel hierboven. 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 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
Onix for Books, release 2.1 (revision 03), January 2006 5 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
2. 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 Message Header data elements Header composite Sender Identifier Composite (R) Sender Identifier Type Code Identifier Value End of Sender Identifier Type Code Sender Company Name Sender Contact Sender Email Addressee Identifier Composite (R) Addressee Identifier Type Code Identifier Value End of Addressee Identifier Composite Addressee Company Name Message Sequence Number Message Creation date/time Default Price Type End of Header Composite
M/O Onix
M/O BB
M/O CB
LIST
A|N
POS.
<SenderIdentifier> <SenderIDType>
O M M
M M M
M M M
44
N N
7
O O O O M M
M M O M M M
M M O M M M
A A A
80 40 255
MH.11 MH.13
N N
7
MH.14 MH.16 MH.18 MH.21
<MessageNumber> <SentDate>
O O M O
M M M M
M M M
A N N
14 12
FIELD
MH.3 MH.5 MH.6 MH.7 MH.8
XML REFERENCE NAME
44
58
2.1 Sender identifier composite 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. [Boekenbank neemt een overzicht op van alle gekende CB Relatie_ID’s op onder de online module ‘Lijsten’. Uitgevers/distributeurs die nog geen CB Relatie_ID hebben, kunnen deze bekomen via Boekenbank ([email protected])] MH.3 <SenderIdentifierTypeCode> MH.5
: waarde ‘10’ uit Code-list 44 duidt aan dat het een CB Relatie_ID betreft. : hier wordt het Relatie_ID geplaatst
2.2 Sender company name | contact | email Deze drie vrije tekstvelden geven informatie over de afzender. MH.6 MH.7 MH.8
: Bedrijfsnaam van de afzender : Naam van de contactpersoon : Emailadres van de contactpersoon
6 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
2.3 Addressee identifier composite In de composite wordt de geadresseerde van het bericht geïdentificeerd aan de hand van het Relatie_ID bij het Centraal Boekhuis. Voor berichten aan Boekenbank gericht wordt het Relatie_ID van Boekenbank ingevuld, nl. 9540439. MH.11 MH.13
: waarde ‘10’ uit Code-list 44 duidt aan dat het om een CB Relatie_ID gaat. : hier wordt het Relatie_ID geplaatst, nl. 9540439 voor Boekenbank.
2.4 Addressee company name In dit vrije tekstveld wordt de naam van het geadresseerde bedrijf geplaatst (bijv. Boekenbank).
2.5 Message sequence number 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: jaar, maand, dag, uur, minuten en seconden. YYYYMMDDHHMMSS
(bijv. 20080120130025)
2.6 Message creation date/time Dit is de datum waarop het bericht verstuurd werd, samengesteld uit jaar, maand, dag, uur en minuten (ahv 24 uurs klok). YYYYMMDDHHMM
(bijv. 200801201300)
2.7 Default price type code 3
Boekenbank accepteert in het Onix-bericht drie verschillende prijstypes . De Onix-standaard vereist echter dat, indien verschillende prijstypes mogelijk zijn, er een standaard prijstype gedefinieerd wordt in de Header van het bericht. Het veld MH.21 dient daarom gevuld te worden met waarde ‘02’ (RRP including sales or valueadded tax if applicable) uit Code-list 58.
3
zie 3.24.5.1 Price type code, pag. 27 7 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3. Product record 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.
3.1 Record reference number, type and source DATA ELEMENT Record reference number, type and source Record Reference Number Notification or Update Code Record Source Type Code Product Identifier Composite (R) Product Identifier Type Code Identifier Value
FIELD
PR.1.1 PR.1.2 PR.1.5 PR.2.7 PR.2.9
XML REFERENCE NAME
M/O Onix
M/O BB
M/O CB
M M O M M M
M M M M M M
M M M M M M
LIST
A|N
POS.
A
13
N
13
1 3 5
3.1.1 Record reference number Een record met titelgegevens wordt geïdentificeerd aan de hand van de EAN.UCC13. Dit is een referentienummer voor het record, niet voor de titel die in dit record is opgenomen. Echter, voor interne verwerking in Boekenbank wordt hier ook het EAN gebruikt.
3.1.2 Notification or update type code Deze code geeft aan wat de status is van de informatie die voor dit record wordt doorgestuurd. Dit veld is verplicht binnen een Onix-bericht en wordt gevuld ahv Code-list 01. Let op: Alle waarden uit Code-list 01 worden door Boekenbank geaccepteerd, maar waarde ‘05’ (Code-list 01 ‘delete’) verwijst de titel naar het historische bestand. Zodra u een andere waarde dan waarde ‘05’ gebruikt, wordt het record in het basisbestand van Boekenbank bewaard. Bevond het artikel zich al in het historische bestand, zal het terug in het actuele bestand worden geplaatst. Let op: Als u een artikel doorstuurt naar het historisch bestand moet u de ProductAvailability steeds aanpassen. Een titel kan pas in het historische bestand terechtkomen met één van de volgende artikelstatussen: CSV-CODE 4 5 6 7 9
OMSCHRIJVING Uitverkocht Zal niet verschijnen Te bestellen bij uitgever In prijs opgeheven Printing on Demand
ONIX-CODE 1 1 44 46 48
OMSCHRIJVING Cancelled Cancelled Apply Direct Withdrawn from sale Out of print, replaced by POD
NB: Als u een artikel uit het historisch bestand terugplaatst naar het actuele bestand, dan moet u steeds de artikelstatus wijzigen naar een andere (correcte) status. Zoniet zal u een foutmelding krijgen en wordt de titel niet aangepast.
3.1.3 Record source type code Dit veld duidt aan of het titelrecord werd aangeleverd door een uitgever, dan wel een distributeur. Dit veld wordt opgevuld aan de hand van Code-list 03 waarbij de waarde ‘01’ Publisher en ‘02’ Publisher’s Distributor worden geaccepteerd. 8 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.1.4 Product identifier composite De Product identifier composite wordt gebruikt om het EAN van de titel op te nemen in het Onix-bericht. Deze composite kan ook herhaald worden om, indien beschikbaar, het wettelijke depotnummer aan te leveren. Het meegeven van het EAN is een verplicht aan te leveren veld om de titel te kunnen identificeren. In PR.1.1 wordt deze EAN reeds opgenomen, maar daar gaat om een (uniek) referentienummer voor het record. Deze composite is echter belangrijk voorde bibliografische identificatie van de titel. Let op: Indien het aangeleverde artikel een boek is, moet de leverancier in PR.2.9 het ISBN-13 opnemen. In uitzonderlijke gevallen kan dit ISBN-13 verschillen van het EAN. Waarbij: PR.2.7 PR.2.9
: waarde ‘03’ uit Code-list 05 duidt aan dat het om een EAN.UCC13 gaat. : het eigenlijke EAN/ISBN-13 van de titel (ISBN-13 ingeval het artikel een boek is en het EAN verschilt van het ISBN-13).
En indien de composite herhaald wordt, geldt: PR.2.7 PR.2.9
: waarde ‘17’ uit Code-list 05 duidt aan dat het om een wettelijk depotnummer gaat. : het wettelijke depotnummer van de titel
Let op: Binnen de verwerking van Boekenbank wordt het formaat van het wettelijke depotnummer gecontroleerd. Dit moet voldoen aan het schema: D/YYYY/ … / … Na het initieel aanleveren van een wettelijk depotnummer wordt dit bovendien geblokkeerd en kan het enkel nog gewijzigd worden in de online admin-module van de betrokken distributeur/uitgever.
9 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.2 Product form Deze composite geeft de uitvoering van de titel aan en bijkomende informatie over de bijlage/begeleidend materiaal indien aanwezig: DATA ELEMENT Product Form Product Form Code Product Form Description Number of Pieces
FIELD
XML REFERENCE NAME
PR.3.1 PR.3.8 PR.3.9
M/O Onix
M/O BB
M/O CB
M O O
M O O
M O O
LIST
A|N
POS.
A A
255 10
7
3.2.1 Product form code Het veld PR.3.1 geeft aan de hand van Code-list 07 een aanduiding van de uitgavesoort en uitvoering van het product. In het oude CSV-formaat werd dit door twee aparte velden bepaald, nl. de ‘uitgavesoort’ en ‘uitvoering’ van de titel. Deze werkwijze wordt vereenvoudigd door binnen Onix enkel het veld PR.3.1 te gebruiken. Alle waarden uit de Code-list 07 worden bij het importeren geaccepteerd. Echter, bij het importeren van een CSV-bestand en bij het exporteren van titels uit de database naar een CSV-bestand, wordt er een vertaalslag gedaan volgens onderstaande tabellen.
Vertaalslag Uitgavesoort bij import CSV CSV CODE
UITGAVESOORT
ONIX PRODUCTFORM CODE
OMSCHRIJVING
B
Boek
Zie tabel hieronder
K
Kaart
CA
Sheet map
D
Diverse
00
Undefined
C
CD-Rom
DB
CD-Rom
V
Video
VA
Video
A
Audiocassette
AB
Audio Cassette
Z
DVD
DD
DVD
P
CD-I
DC
CD-I
S
Software
DA
Digital
I
Internetpublicatie
DH
Online Resource
E
CD (audio)
AC
CD Audio
X
Display/promotiemateriaal
XA
Trade-only material
Vertaalslag Uitvoering bij import van CSV voor Uitgavesoort B GB
Gebonden
BB
Hardback
PB
Paperback
BC
Paperback
PK
Pocket
BC
Paperback
LB
Losbladig
BD
Loose-leaf
GL
Garenloos
BZ
Other Book Format
SP
Spiraalband
BE
Spiral Bound
AA
Andere
BA
Book
10 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Code List 7: Vertaalslag bij export naar CSV: CODE
Algemene Vertaling
PRODUCTFORM CODE
WORDT UITGAVESOORT
WORDT UITVOERING
AA
Audio
Audio
A Audiocassette
AA Andere
AB
Audio cassette
Audiocassette
A Audiocassette
AA Andere
AC
CD-Audio
Audio-CD
E Cd (audio)
AA Andere
AI
DVD Audio
Audio DVD
Z DVD
AA Andere
AJ
Downloadable audio file
Downloadbaar audiobestand
I Internetpublicatie
AA Andere
BA
Book
Boek
B Boek
AA Andere
BB
Hardback
Hardback
B Boek
GB Gebonden
BC
Paperback
Paperback
B Boek
PB Paperback
BD
Loose-leaf
Losbladig
B Boek
LB Losbladig
BE
Spiral bound
Spriaalband
B Boek
SP Spiraalband
BG
Leather / fine binding
Lederband
B Boek
AA Andere
BH
Board book
Kartonboek
B Boek
AA Andere
BI
Rag book
Stofboek
B Boek
AA Andere
BJ
Bath book
Badboek
B Boek
AA Andere
BK
Novelty book
Novelle
B Boek
AA Andere
BL
Slide bound
Slideband
B Boek
AA Andere
BM
Big book
Boek grootformaat
B Boek
AA Andere
BN
Part-work (fascículo)
Boek (fasciculo)
B Boek
AA Andere
BO
Leporello (folded)
Boek Gevouwen
B Boek
AA Andere
BZ
Other book format
Andere boekformaten
B Boek
AA Andere
CA
Sheet map
Kaart
K Kaart
AA Andere
CB
Sheet map, folded
Kaart, gevouwen
K Kaart
AA Andere
CC
Sheet map, flat
Kaart, vlak
K Kaart
AA Andere
CD
Sheet map, rolled
Kaart, opgerold
K Kaart
AA Andere
CE
Globe
Wereldbol
K Kaart
AA Andere
CZ
Other cartographic
Andere kaartformaten
K Kaart
AA Andere
DA
Digital
Digitaal
S Software
AA Andere
DB
CD-ROM
CD-ROM
C CD-rom
AA Andere
DC
CD-I
CD-I
P CD-I
AA Andere
DD
DVD
DVD
Z DVD
AA Andere
DE
Game Cartridge
Game Cartridge
S Software
AA Andere
DF
Diskette
Diskette
S Software
AA Andere
DG
Electronic book text
E-Boek
D Diverse
AA Andere
DH
Online resource
Internetpublicatie
I Internetpublicatie
AA Andere
DI
DVD-ROM
DVD-Rom
Z DVD
AA Andere
PC
Calender
Kalender
D Diverse
AA Andere
PD
Cards
Ansichtkaarten
D Diverse
AA Andere
PH
Kit
Kit
D Diverse
AA Andere
PI
Sheet Music
Bladmuziek
D Diverse
AA Andere
11 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
PJ
Postcard book or pack
Postkaartboek /- pakket
B Boek
AA Andere
PK
Poster
Poster
D Diverse
AA Andere
VA
Video
Video
V Video
AA Andere
VB
Video, VHS, PAL
Video, VHS, PAL
V Video
AA Andere
VC
Video, VHS, NTSC
Video, VHS, NTSC
V Video
AA Andere
VD
Video, Betamax, PAL
Video, Betamax, PAL
V Video
AA Andere
VE
Video, Betamax, NTSC
Video, Betamax, NTSC
V Video
AA Andere
VF
Videodisk
Videodisk
V Video
AA Andere
VG
Video, VHS, SECAM
Video, VHS, SECAM
V Video
AA Andere
VH
Video, Betamax, SECAM
Video, Betamax, SECAM
V Video
AA Andere
VI
DVD video
DVD video
Z DVD
AA Andere
VJ
VHS video
VHS video
V Video
AA Andere
VK
Betamax video
Betamax video
V Video
AA Andere
VZ
Other video format
Andere videoformaten
V Video
AA Andere
XA
Trade-only material
Display of promotiemateriaal
X Display/promotiemateriaal
AA Andere
XD
Counterpack – empty
Display (leeg)
X Display/promotiemateriaal
AA Andere
XE
Counterpack – filled
Display (vol)
X Display/promotiemateriaal
AA Andere
XF
Poster, promotional
Poster (promotie)
X Display/promotiemateriaal
AA Andere
XG
Shelf strip
Kaststrip
X Display/promotiemateriaal
AA Andere
XH
Window piece
Raamdecoratie
X Display/promotiemateriaal
AA Andere
XI
Streamer
Banner
X Display/promotiemateriaal
AA Andere
XJ
Spinner
spinner
X Display/promotiemateriaal
AA Andere
XK
Large book display
Display grote boeken
X Display/promotiemateriaal
AA Andere
XL
Shrink-wrapped pack
Verpakkingsmateriaal
X Display/promotiemateriaal
AA Andere
XZ
Other point of sale
Ander POS
X Display/promotiemateriaal
AA Andere
ZD
Toy
Speeltje
D Diverse
AA Andere
ZE
Game
Game
D Diverse
AA Andere
ZF
T-shirt
T-shirt
D Diverse
AA Andere
00
ondefined
Diverse
D Diverse
AA Andere
12 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Nieuwe werkwijze voor e-boeken: Sinds kort kan ook waarde DG (=e-boek) aangeleverd worden voor de aanmelding van e-boeken. Hiervoor geldt echter een aparte werkwijze. Bij het aanmelden van een e-boek met Productvorm DG moet er nader worden gespecificeerd wat het e-Boek-formaat is ,welke DRM er van toepassing is en hoe het e-boek beschikbaar wordt gesteld om de verschijningsvorm van het e-boek exact te kunnen bepalen. Dit gebeurt aan de hand van composite PR.4. Epublication Detail: DATA ELEMENT Epublication Detail Epublication Type Code Epublication Type Version Number Epublication Type Description
FIELD
PR.4.1. PR.4.2. PR.4.3.
XML REFERENCE NAME
<EpubType> <EpubTypeVersion> <EpubTypeDescription>
M/O Onix
M/O BB
M/O CB
LIST
M* O O
M* O O
M* O O
10 144 150
A|N
POS.
Bij keuze voor waarde DG in de dient ook PR.4.1. <EpubType> voor het vastleggen van het formaat, PR.4.2. <EpubTypeversion> voor het vastleggen van de DRM en PR.4.3. <EpubTypeDescription> voor het vastleggen van de beschikbaarheid, ingevuld te zijn in het Onix-bericht. PR.4 Epublication Detail wordt dus een verplichte composite zodra waarde ‘DG’ in PR.3.1. wordt ingeschreven*. De toegelaten waarden voor PR.4.1., PR.4.2. en PR.4.3. zijn beperkt. In het onderstaande schema wordt de toegelaten selectie opgesomd. Zichtbaar in detailpagina op Boekenbank
Vertaling in CSV-waarden
Vertaling in ONIX-waarden Epubtype EpubtypeVersion EpubTypeDescription Uitvoering PR.4.1. PR.4.2. PR.4.3. ED EAD 029 3 ED EZD 029 0 ED EDD 029 2 EB EAB 029 3 EB EDB 029 2 EB EZB 029 0 EB BUB 000 PA 002 3 PZ 002 0 PD 002 2 BL 043 0 ED BUD 000 AK 031 1 ER 010 1 HT 001 0 MB 022 1 NL 007 0
Eboek productvorm Epub met Adobe DRM, Download Epub zonder Adobe DRM, Download Epub met digitaal watermerk, Download Epub met Adobe DRM, Download/Online Epub met digitaal watermerk, Download online Epub zonder Adobe DRM, Download/online Bundel, download/online PDF met Adobe DRM PDF zonder DRM PDF met digitaal watermerk Blio Bundel, Download Amazon Kindle formaat met Kindle DRM eReader formaat met DRM HTML formaat Mobipocket met DRM Netlibrary formaat
Uitgavesoort DG DG DG DG DG DG DG DG DG DG DG DG DG DG DG DG DG
Deze wijziging heeft ook voor het CSV-formaat van Boekenbank consequenties: De Productvorm in Onix wordt in CSV vervangen door de velden uitvoering en uitgavesoort. Voor een e-publicatie nemen we een nieuwe waarde in gebruik, namelijk DG. Het veld ‘Uitvoering’ wordt uitgebreid naar 17 waardes die de combinatie van PR4.1., PR.4.2. en PR.4.3. samenvatten. Deze nieuwe waarden binnen het veld Uitvoering zorgen ervoor dat u ook met het CSV-formaat extra e-boek-informatie kan meegeven. Draft: Nieuwe werkwijze voor luisterboeken Dit voorstel moet bekrachtigd worden op het volgende Gebruikersoverleg van Meta4Books. Boekenbank geeft standaard bij code AC (Audio-CD) en AJ (Downloadable Audio File), productFormDetail A101, en ProductContentType 01 mee. Dit kan uitgebreid worden met de volgende waardes:
13 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Luisterboek op cd ProductForm AC (CD-Audio) (codelist 7) ProductFormDetail A101 (cd audio), A103 (mp3) of A2xx (Daisy formaten) (codelist 78) ProductContentType 01 (audiobook), 02 (performance, spoken word), 13 (other speech content) of 21 (partial performance) (codelist 81) Luisterboek download Productform AJ (Downloadable audio file) (codelist 7) ProductFormDetail A103 (mp3) (codelist 78) ProductContentType 01 (audiobook), 02 (performance, spoken word), 13 (other speech content) of 21 (partial performance) (codelist 81) Een mogelijke vertaling naar CSV ziet er als volgt uit. Deze vertaling werd niet verder uitgewerkt voor alle DAISYformaten.
Luisterboek CD - standaard CD - Performance, gesproken woord CD - andere gesproken inhoud CD - Deel van performance MP3-CD, standaard MP3-CD, Performance, gesproken woord MP3-CD, andere gesproken inhoud MP3-CD, Deel van performance Daisy-CD (zie inhoud waardes), standaard Daisy-CD (zie inhoud waardes), Performance, gesproken woord Daisy-CD (zie inhoud waardes), andere gesproken inhoud Daisy-CD (zie inhoud waardes), deel van een performance Download, standard Download, Performance – gesproken woord Download, andere gesproken inhoud Download, Deel van een performance MP3 - Downloadfile, standard MP3 - Downloadfile,
Vertaling in Onix-waarden Productform ProductFor mDetail AC A101 AC A101
ProductContentType
Vertaling in CSV-waarden Uitgavesoort Uitvoering
01 02
AC AC
ST SG
AC
A101
13
AC
SA
AC
A101
21
AC
SD
AC AC
A103 A103
01 02
AC AC
MS MG
AC
A103
13
AC
MA
AC
A103
21
AC
MD
AC
A2xx
01
AC
DS
AC
A2xx
02
AC
DG
AC
A2xx
13
AC
DA
AC
A2xx
21
AC
DD
AJ AJ
A101 A101
01 02
AJ AJ
ST SG
AJ
A101
13
AJ
SA
AJ
A101
21
AJ
SD
AJ
A103
01
AJ
MS
AJ
A103
02
AJ
MG 14 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Performance, gesproken woord MP3 - Downloadfile, andere gesproken inhoud MP3 - Downloadfile, deel van een performance DAISY-Download, standaard DAISY-Download, Performance, gesproken woord DAISY-Download, andere gesproken inhoud DAISY-Download, deel van een performance
AJ
A103
13
AJ
MA
AJ
A103
21
AJ
MD
AJ
A2xx
01
AJ
DS
AJ
A2xx
02
AJ
DG
AJ
A2xx
13
AJ
DA
AJ
A2xx
21
AJ
DD
3.2.2 Product Form Description Om informatie over een bijlage/begeleidend materiaal op te nemen in het Onix-bericht kan extra informatie in het veld PR.3.8 worden geplaatst. Dit is een vrij tekstveld van 255 posities.
3.2.3 Number of Pieces Indien het een meerdelig werk betreft, dan in het veld PR.3.9 het totale aantal delen worden geplaatst. Dit veld is alfanumeriek en 10 posities lang.
15 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.3 Series composite Deze composite wordt gebruikt om reeksnamen en reekscodes mee te geven. De gebruikte velden zijn: DATA ELEMENT Series Series Composite (R) Series Title Number Within Series End of Series Composite
FIELD
PR.5.6 PR.5.7
XML REFERENCE NAME
<Series> <TitleOfSeries>
M/O Onix
M/O BB
M/O CB
O M O
O M O
O M O
LIST
A|N
POS.
A A
255 20
3.3.1 Series title Indien de titel deel uitmaakt van een reeks, kan u de reeksnaam ingeven in het veld PR.5.6 <TitleOfSeries>. 3.3.2 Number within series Het nummer van de titel binnen de reeks vult u in het veld , dit is een alfnumeriek veld. Let op: de .csv export van Boekenbank ondersteunt voor het veld ‘Nummer in Reeks’ enkel numerieke gegevens. Indien alfanumerieke gegevens werden ingelezen in de database voor bepaalde titel(s), dan wordt dit veld in de .csv export leeg gelaten. Let op: Boekenbank controleert het veld reeksnaam op inhoud indien een reeksnummer wordt aangeleverd. Het veld ‘reeksnaam’ kan dus niet leeg zijn als er een reeksnummer aanwezig is. Het is wel mogelijk een reeksnaam aan te leveren zonder een reeksnummer. BELANGRIJK: Eenzelfde reeksnaam moet steeds met dezelfde schrijfwijze doorgegeven worden aan Boekenbank. Indien dat niet het geval is, zal de titel terechtkomen op de foutenlijst van Boekenbank. Als deze lijst niet wordt nagekeken en de reeksnamen niet worden gecorrigeerd, dan wordt maandelijks een administratieve kost aangerekend.
16 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.4 Set De set composite wordt gebruikt om gegevens rond Set, sectietitel en deeltitel mee te geven. De gebruikte velden zijn: DATA ELEMENT Set Set Composite (R) Product Identifier Composite (R) Product Identifier Type Code Identifier Value Title of Set End of Product Identifier Composite Set Part Title Set Item Title End of Set Composite
M/O Onix
M/O BB
M/O CB
O O M M M
O M M M M
O O
PR.6.3 PR.6.5 PR.6.6
<Set> <TitleOfSet>
PR.6.8 PR.6.11
<SetPartTitle> <SetItemTitle>
O O
O O
FIELD
XML REFERENCE NAME
LIST
A|N
POS.
M
A A
13 2000
O O
A A
2000 50
5
3.4.1 Product identifier composite Indien de titel deel uitmaakt van een Set, wordt het ISBN-13 van de Set meegegeven in de Product Identifier Composite waarbij: PR.6.3 PR.6.4
: waarde ‘03’ uit Code-list 05 duidt aan dat het hier een EAN.UCC-13 betreft : het EAN van de Set
3.4.2 Title of set Een vrij tekst veld van 2000 posities om de titel van de Set mee te geven. 3.4.3 Set part title Dit veld wordt gebruikt om de Sectietitel mee te geven. Het is een vrij tekstveld van maximaal 2000 posities.
3.4.4 Set Item title In dit vrije tekstveld van max. 50 posities wordt de Deeltitel meegegeven. Deze geeft aan over welk deel het record gaat (bijv. 4b).
17 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.5 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
Title Composite (R) Title Type Title Text Subtitle End of Title Composite
FIELD
PR.7.8 PR.7.11 PR.7.14
XML REFERENCE NAME Title <Title> <TitleType> <TitleText> <SubTitle>
M/O Onix
M/O BB
M/O CB
O M O O
M M M O
M M M O
LIST
A|N
POS.
A A
2000 2000
15
De velden van deze composite worden als volgt ingevuld: PR.7.8 <TitleType>
: waarde ‘01’ uit Code-list 15 duidt aan dat het de hoofdtitel betreft zoals vermeld op het titelblad van het werk. waarde ‘03’ uit Code-list 15 duidt aan dat het de hoofdtitel in de oorspronkelijke taal betreft (indien het een vertaald werk is). waarde ‘05’ uit Code-list 15 duidt aan dat het een verkorte titel betreft
PR.7.11 <TitleText> PR.7.14 <Subtitle>
: de hoofdtitel | oorspronkelijke titel | verkorte titel : de ondertitel | oorspronkelijke ondertitel
Let op: De verkorte titel wordt bij export naar (zowel in Onix als in.CSV) in kapitalen gezet om problemen met diakritische tekens te vermijden.
18 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.6 Authorship Binnen de verzameling composites onder ‘Authorship’ wordt informatie meegegeven over bijdragers aan de titel en de aard van hun betrokkenheid; maw. auteurs, redacteurs, samenstellers, etc… De gebruikte velden zijn: DATA ELEMENT
FIELD
Authorship Contributor Composite (R) Contributor Role Code Contributor Sequence number within role Person Name Part 2 Person Name Part 3 Person Name Part 4 Corporate Contributor Name End of Contributor Composite
XML REFERENCE NAME
M/O Onix
M/O BB
M/O CB
LIST
A|N
POS.
PR.8.2
O M
O M
O M
PR.8.4
<SequenceNumberWithinRole>
O
M
M
N
2
PR.8.8 PR.8.9 PR.8.10 PR.8.26
O O O O
O O M O
O O M O
A A A A
255 255 255 255
17
3.6.1 Contributor composite De verschillende soorten bijdragen aan een titel worden meegegeven in de Contributor composite; deze kan herhaald worden om meerdere voorkomens (bijv. verschillende auteurs) én meerdere soorten betrokkenheid mee te geven aan een titel. De betrokkenheid van een bijdrager kan verschillende hoedanigheden aannemen; deze staan opgelijst in Code-list 17. De volgende waarden worden door Boekenbank geaccepteerd: Auteur Illustrator
: A01 : A12
Redacteur/samensteller Bewerker Vertaler
: B01 : B05 : B06
By (author) Author of a textual work Illustrated by Artist when named as the creator of artwork which illustrates as text Edited by Adapted by Translated by
Indien er meerdere personen op een zelfde wijze betrokken zijn, wordt de volgorde van betrokkenheid vastgesteld ahv het veld PR.8.4 <SequenceNumberWithinRole>. Op deze wijze kunnen bijvoorbeeld meerdere auteurs worden toegevoegd waarbij de auteur met <SequenceNumberWithinRole> 1, als hoofdauteur wordt beschouwd en de volgende als co-auteurs. Let op: Voor auteur (A01) kunnen maximaal 4 betrokkenen worden aangeleverd. Voor illustrator (A12), redacteur/samensteller (B01), bewerker (B05) en vertaler (B06) maximaal 3 betrokkenen. De velden worden als volgt gebruikt: PR.8.2 PR.8.4 <SequenceNumberWithinRole> PR.8.8 PR.8.9 PR.8.10 PR.8.26
: waarde uit Code-list 17 duidt type betrokkenheid aan : indien er meerdere betrokkenen van hetzelfde type zijn, wordt in dit veld de volgorde van betrokkenheid vastgelegd : de voorletters van de betrokkenen (voornaam of initialen) : het voorvoegsel : achternaam of naam van niet natuurlijk persoon : Indien de bijdrager een bedrijf betreft en geen natuurlijke persoon, kan de naam van het bedrijf in worden geplaatst.
19 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.7 Edition In deze velden wordt het bibliografische en commerciële druknummer meegegeven. De bibliografische druk wordt in PR.10.2 geplaatst, de commerciële druk in PR.10.3. DATA ELEMENT
FIELD
Edition Number Edition Version Number Edition Statement
PR.10.2 PR.10.3 PR. 10.4.
XML REFERENCE NAME <EditionNumber> <EditionVersionNumber> <EditionStatement>
M/O Onix
M/O BB
M/O CB
O O O
M O O
M O M
LIST
A|N
POS.
A
30 3 2
Let op: Boekenbank hanteert in haar logica enkel het commerciële druknummer. Daarom heeft 10.3 <EditionVersionNumber> prioriteit boven 10.2 <EditionNumber>. Dus enkel indien het commerciële druknummer niet wordt aangeleverd, en het bibliografische druknummer wel, zal <EditionNumber> worden ingelezen als druknummer. Centraal Boekhuis gebruikt voor registratie van de editie een bijkomende code (alfanumeriek, 2 posities) in het veld Edition Statement. Hier zijn de volgende waardes mogelijk: 01 Nieuw boek (NB) 02 Heruitgave (HU) 03 Nieuwe druk (ND) Boekenbank maakt geen gebruik van dit veld. Op uitdrukkelijke vraag van gebruikers die dit veld kunnen en willen aanleveren, zullen we in boekenbank het veld ook voorzien. Dit veld zal niet worden meegegeven in het CSV-formaat. 3.8 Language Deze composite wordt gebruikt om de taal en oorspronkelijke taal van de titel mee te geven. De gebruikte velden zijn: DATA ELEMENT Language Language Composite (R) Language Role Language Code End of Language Composite
FIELD
PR.11.3 PR.11.4
XML REFERENCE NAME
M/O Onix
M/O BB
O M M
M M M
M/O CB
LIST
A|N
POS.
22 74
Boekenbank accepteert twee soorten taalcodes: de taal van de uitgave en de oorspronkelijke taal van de uitgave. Deze codes zijn opgenomen in Code-list 22 met: 01 02
: Language of Text : Original Language of a translated text
Taal van de uitgave Oorspronkelijke taal van de uitgave
Enkel de taal van de uitgave is verplicht aan te leveren; de oorspronkelijke taal is facultatief. Om beide aan te leveren, kan de Language Composite herhaald worden. De velden worden als volgt gebruikt: PR.11.3 PR.11.4
: waarde ‘01’ of ‘02’ uit Code-list 22 : waarde uit Code-list 74 (ISO 639-2/B, waarbij wordt aangegeven dat de taalcodes steeds in kleine letters worden genoteerd. In bijlage wordt de hele taalcodelijst opgenomen).
20 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.9 Extents and other content De extents composite wordt gebruikt voor informatie over illustraties en het aantal pagina’s. De gebruikte velden zijn: DATA ELEMENT Number of Pages (Roman) Number of Pages (Arabic) Illustrations and Other Content Composite (R) Illustration or other content type code Illustration of other content type description Number of Illustrations End of Illlustrations and Other Content Composite
FIELD PR.12.2 PR.12.3 PR.12.9 PR.12.10 PR.12.11
XML REFERENCE NAME <PagesRoman> <PagesArabic>
M/O Onix
M/O BB
M/O CB
O O O O M O
O O O M M O
O O M M M M
LIST
A|N
POS.
A A
10 6
25 N
3.9.1 Number of pages (Roman) Het aantal pagina’s in het boek met Romeinse nummering is, maximaal 10 posities lang.
3.9.2 Number of pages (Arabic) Het aantal pagina’s in het boek met Arabische nummering, maximaal 6 posities lang. Merk op dat indien zowel het aantal Romeins genummerde als Arabisch genummerde pagina’s wordt aangeleverd, er niet wordt aangeduid welke nummering in het boek eerst, en welke laatst komt. 3.9.3 Illustrations and other content composite Informatie over type en hoeveelheid illustraties is facultatief. Indien deze composite niet wordt aangeleverd, gaat Boekenbank ervan uit dat de titel geen illustraties bevat. Het type illustraties in de titel kan worden gedefinieerd ahv Code-list 25; Boekenbank accepteert echter enkel de code: 00
: unspecified
De velden worden als volgt gebruikt: PR.12.9 PR.12.10 PR.12.11
: waarde ‘00’ Unspecified uit Code-list 25 : is verplicht vanuit Onix maar wordt in verwerking genegeerd : aantal illustraties waarbij de waarde ‘0’ aanduidt dat de titel geen illustraties bevat, alle andere waarden worden geïnterpreteerd als zijnde dat de titel wel illustraties bevat
Let op: In de Onix-export vanuit Boekenbank worden enkel de waarden ‘0’ en ‘1’ gehanteerd; waarbij 0 : de titel bevat geen illustratie 1 : de titel bevat wel illustraties
21 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.10 Subject De subject composite wordt gebruikt om de NUR-codes van de titel mee te geven. NUR staat voor Nederlandstalige Uniforme Rubrieksindeling en is een driecijferige code die het onderwerp van een boek weergeeft. Boekenbank biedt de mogelijkheid om 2 NUR-codes in het Onix-bericht op te nemen om een uitgebreide indeling op basis van NUR mogelijk te maken. De gebruikte velden zijn: DATA ELEMENT Main-Subject Composite (R) Main Subject Scheme Identifier Subject Code End of Main-Subject Composite Additional Subject Composite (R) Additional Subject Scheme Identifier Additional Subject Code End of Additional Subject Composite
FIELD
XML REFERENCE NAME
M/O Onix
M/O BB
M/O CB
LIST
O M M
26
PR.13.5 PR.13.7
<MainSubject> <MainSubjectSchemeIdentifier> <SubjectCode>
O M M
M M M
PR.13.9 PR.13.12
<Subject> <SubjectSchemeIdentifier> <SubjectCode>
O M M
O M M
A|N
POS.
A
10
A
10
27
Bureau ISBN in Nederland laat echter maar één NUR-code toe. Indien u nieuwe titels via het Onix-bericht aanlevert, raden wij u aan om steeds de belangrijkste NUR-code onder de Main-Subject Composite te plaatsen, zodat de juiste NUR-code aan Centraal Boekhuis wordt aangeleverd. 3.10.1 Main subject composite Deze composite is verplicht en wordt gevuld met de hoofd-NUR-code waar de titel toe behoort. De velden worden als volgt gebruikt: PR.13.5 <MainSubjectSchemeIdentifier> PR.13.6 <SubjectCode>
: waarde ‘32’ uit Code-list 26 duidt aan dat het een NUR-code betreft : de NUR-code
3.10.2 Additional subject composite Om een tweede NUR-code mee te geven, wordt deze composite gebruikt. Ze is echter facultatief. De velden worden conform 3.10.0 Main Subject Composite gebruikt.
22 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.11 Audience De Audience Composite wordt gebruikt om het AVI-niveau mee te geven. De gebruikte velden zijn: DATA ELEMENT Audience Composite (R) Audience Code Type Audience Code Value End of Audience Composite
FIELD
PR.14.2 PR.14.4
XML REFERENCE NAME
M/O Onix
M/O BB
O M M
O M M
M/O CB
LIST
A|N
POS.
A
50
29
Waarbij: PR.14.2 PR.14.4
: waarde ‘09’ uit Code-list 29 duidt aan dat het hier een AVI niveau betreft : het AVI-niveau (1 t/m 9)
Deze composite is niet verplicht en wordt gebruikt om het AVI-niveau van de titel mee te geven. Het AVI-niveau is een systeem waarmee de technische leesvaardigheid van kinderen en het leestechnische niveau van teksten wordt 4 gemeten .
4
Analyse van Individualiseringsnormen. Meer informatie over AVI vindt u op http://nl.wikipedia.org/wiki/AVI_(onderwijs) 23 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.12 Descriptions and other supporting text Binnen het Onix-bericht bestaat de mogelijkheid om extra content aan te leveren in de vorm van teksten die betrekking hebben op de titel (bijv. recensies, flapteksten,e d). Deze worden opgenomen in de Other Text Composite. De volgende velden worden hiervoor gebruikt: DATA ELEMENT Descriptions and Other Supporting Text Other Text Composite (R) Other Text Type Code Other Text Format Other Text Other Text Link Type Other Text Link Author of other Text Text valid from date Text valid until date End of Other-text Composite
FIELD
PR.15.3 PR.15.4 PR.15.5 PR.15.6 PR.15.7 PR.15.8 PR.15.12 PR.15.13
XML REFERENCE NAME
<StartDate> <EndDate>
M/O Onix
M/O BB
M/O CB
O O O O O O O O O
O M M O O O O O O
O M M O O O
LIST
A|N
POS.
A
4000
A A N N
300 300 8 8
33 34 35
3.12.1 Other text composite Het type content dat wordt aangeleverd wordt bepaald ahv Code-list 33. Een waarde uit deze lijst wordt in het veld PR.15.3 geplaatst, waarbij Boekenbank de volgende waarde accepteert: 18 24
: Back Cover Copy : First Chapter
Flaptekst Inkijktekst of eerste hoofdstuk
In het veld PR.15.4 wordt het formaat van de tekst meegegeven ahv een waarde uit Code-list 34. Voor de flaptekst gebruiken we tekst of HTML, voor de inkijktekst of het eerste hoofdstuk gebruiken we PDF 02 : HTML 06 : Tekst 04 : PDF De feitelijke flaptekst wordt in PR.15.5 geplaatst, een vrij tekstveld met maximaal 4000 posities. Voor de inkijktekst of het eerste hoofdstuk worden PR 15.6, CodeList 35, waarde 06 ‘Filename’ en PR 15.7 met de eigenlijke bestandsnaam ingevuld.
OPMERKING: Als de bestanden ingelezen worden vanuit Onix, worden ze in Boekenbank opgeslagen op de gebruikelijke werkwijze. Voor flapteksten betekent dat dat een tekst-bestand met als bestandsnaam ISBN.txt in de database wordt bijgehouden en geëxporteerd bij de eerstvolgende, dagelijkse ‘content-export’ op de FTP-server van Boekenbank. In het uitgaande Onix-bericht van Boekenbank wordt deze composite niet gebruikt voor de export van content. Wie de Boekenbankcontent wil afnemen, kan dit uitsluitend via zijn toegang tot de afzonderlijke content-map op de FTP-server.
24 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.13 Link to image/audio/video files Naast content in tekstvorm (zie 3.12) kan binnen het Onix-bericht ook andere digitale content worden aangeleverd. Deze wordt opgenomen in de ‘MediaFile’ of ‘Link to image/audio/video-file’ Composite. Boekenbank accepteert momenteel enkel coverafbeeldingen binnen het Onix-bericht. Naarmate de mogelijkheden en toepassingen rond andere digitale media worden uitgebreid, kunnen deze ook binnen het Onix-bericht worden opgenomen. De volgende velden worden gebruikt: DATA ELEMENT Link to image/audio/video files Image/audio/video-file Composite (R) Image/audio/video-file Type Code Image/audio/video-file Format Code Image Resolution Image/audio/video-file Link Type Code Image/audio/video-file Link Media File Date End of image/audio/video-file Composite
FIELD
PR.16.4 PR.16.5 PR.16.6 PR.16.7 PR.16.8 PR.16.14
XML REFERENCE NAME
<MediaFile> <MediaFileTypeCode> <MediaFileFormatCode> <MediaFileLinkTypeCode> <MediaFileLink> <MediaFileDate>
M/O Onix
M/O BB
M/O CB
O O O O O O O
O M M M M M M
O M M O M M
LIST
A|N
POS.
A
6
N
8
38 39 40
Het type digitale media, dat wordt doorgestuurd, wordt bepaald ahv het veld PR.16.4 <MediaFileTypeCode> waarin een waarde uit de Code-list 38 wordt geplaatst. Boekenbank accepteert de waardes ‘04’ Front Cover, ‘06’ Front Cover, high quality en ‘07’ Front Cover thumbnail; en ‘24’ Back Cover, ‘25’ Back Cover, high quality en ‘26’ Back Cover thumbnail om coverafbeeldingen door te sturen, waarbij een hiërarchie in het aanvaarden van de beelden gehanteerd wordt. Voor frontcovers en backcovers geldt dat de waardes in volgorde van voorkomen, voorrang hebben op de volgende waardes: - 06 (niet aanwezig?) => 04 (niet aanwezig ?)=> 07 - 25 (niet aanwezig?) => 24 (niet aanwezig ?)=> 26
Het formaat waarin de coverafbeelding wordt doorgestuurd, wordt ingegeven in veld PR.16.5 <MediaFileFormatCode>. Uit de Code-list 39 accepteert Boekenbank enkel de waarden ‘02’ GIF en ‘03’ JPEG. De resolutie van de coverafbeelding wordt in het veld PR.16.6 geplaatst in dpi (dots per inch); standaard dpi voor een coverafbeelding is 72 dpi (schermresolutie). De waarde in het veld wordt daarmee standaard ‘72’. De link naar het bestand met coverafbeelding wordt meegegeven in PR.16.8 <MediaFileLink>. IN PR. 16.7 wordt aangeduid over wat voor soort link het gaat; Boekenbank accepteert zowel URL’s als FTP-adressen om coverafbeeldingen mee te geven. Dit zijn respectievelijk de waarden ‘01’ URL en ‘05’ FTP-address. Om overbodig bestandsverkeer te vermijden, wordt aan een coverafbeelding ook een datum van laatste aanpassing meegegeven in PR.16.14 <MediaFileDate> in de vorm YYYYMMDD. Indien de afbeelding niet meer gewijzigd is, wordt ze ook niet opnieuw door Boekenbank opgehaald en de database ingeladen. OPMERKING: Als de bestanden ingelezen worden vanuit Onix, worden ze in Boekenbank opgeslagen op de gebruikelijke werkwijze. Voor covers en achterflappen betekent dat dat een jpg- of gif-bestand met als bestandsnaam ISBN(a).jpg of gif in de database wordt bijgehouden en geëxporteerd bij de eerstvolgende, dagelijkse ‘content-export’ op de FTP-server van Boekenbank. Ook hier geldt de opgenomen hiërarchie waarbij steeds het grootste bestand wordt opgenomen. In het uitgaande Onix-bericht van Boekenbank wordt deze composite niet gebruikt voor de export van content. Wie de Boekenbank-content wil afnemen, kan dit uitsluitend via zijn toegang tot de afzonderlijke content-map op de FTPserver.
25 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.14 Publisher Gegevens over imprint en de identificatie van de uitgever worden opgenomen binnen de composite Publisher, waaronder de Imprint of Brand Composite en Publisher Composite vallen. De volgende velden worden gebruikt: DATA ELEMENT Publisher Imprint or Brand Composite (R) Imprint or Brand Name End of imprint or brand composite Publisher Composite (R) Publishing Role Code Name Code Type Name Code Type Name Name Code Value Publisher Name End of Publisher Composite
FIELD
XML REFERENCE NAME
M/O Onix
M/O BB
M/O CB M O
PR.19.5
O O
O O
PR.19.7 PR.19.8 PR.19.9 PR.19.10 PR.19.11
O O M O M O
O O M M M O
LIST
A|N
POS.
A
80
A N A
50 50 100
45 44
3.14.1 Imprint of brand composite De imprintnaam wordt opgenomen in PR.19.6 in functie van branding. Als de imprintnaam die wordt meegegeven al bestaat, wordt de titel toegevoegd aan de lijst van titels onder deze imprint.
3.14.2 Publisher composite Met het oog op internationale berichtenuitwisseling, uitwisseling van titelgegevens met andere marktpartijen en de standaarden zoals vooropgesteld door Editeur, werd het identificeren van de uitgever uitgebreid met de Publisher Composite. Deze composite is facultatief. Met ‘uitgever’ wordt de exploitant/eigenaar van de titel bedoeld. De velden worden als volgt gebruikt: De Publisher composite kan gebruikt worden om de ‘uitgeversprefix’ en/of het Centraal Boekhuis Relatie_ID aan te leveren. Indien beide worden aangeleverd, kan de composite herhaald worden. De volgende velden worden gebruikt: Voor ‘uitgeversprefix’ PR.19.7 PR.19.8 PR.19.9 PR.19.10 PR.19.11
: waarde ‘01’ Publisher uit Code-list 45 geeft aan dat het een uitgever betreft (niet verplicht) : waarde ‘02’ uit Code-list 44 duidt een ‘proprietary’ of eigen schema aan : ‘uitgeversprefix’ duidt dat het om een uitgeversprefix gaat : het eigenlijke uitgeversprefix : de naam van de uitgever (maximaal 100 posities)
Voor Centraal Boekhuis Relatie_ID PR.19.8 PR.19.10 PR.19.11
: waarde ‘10’ uit Code-list 44 duidt een Centraal Boekhuis Relatie_ID aan : het eigenlijke CB Relatie_ID : de naam van de uitgever (maximaal 100 posities)
26 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.15 Publishing status and dates and copyright In de composite Publishing status worden verschijningsdatum en jaar van eerste verschijnen meegegeven. De volgende velden worden gebruikt: DATA ELEMENT Publishing status and dates and copyright Publishing Status Publication Date Year First Published
FIELD
XML REFERENCE NAME
PR.20.1 PR.20.5 PR.20.13
M/O Onix
M/O BB
M/O CB
O O O
O M O
O O
LIST
A|N
POS.
N N
8 4
64
De geeft het stadium aan van de titel in zijn levenscyclus. De volgende waarden uit Code-list 64 worden door Boekenbank geaccepteerd: PUBLISHING STATUS 01 Cancelled 02 Forthcoming 04 Active 07 Out of print 09 Unknown 10 Remaindered
STADIUM LEVENSCYCLUS Zal niet verschijnen (Aangeboden, maar verschijnt niet) Aangekondigd (Nog niet verschenen) Verschenen of In herdruk Uitverkocht Teruggetrokken (Niet in depot, probeer bij uitgever) of i.g.v. ISBN dat niet in CB-assortiment is opgenomen of i.g.v. titel van een depot-uitgever die inmiddels passief is In prijs opgeheven
Let op: Deze waarden kunnen worden aangeleverd naar Boekenbank, maar worden momenteel niet ingelezen. Voor geldt: PR.20.5 PR.20.13
: verschijningsdatum YYYYMMDD : jaar waarin de titel voor het eerst verscheen (of zal verschijnen) YYYY
Let op: De interne verwerking van Boekenbank controleert de correlatie tussen de verschijningsdatum PR.20.5 en de artikelstatus in PR.24.22 (zie p. 27), waarbij Indien de =
20 (verschenen) de datum in PR.20.5 < PublicationDate> in het verleden moet liggen.
Let op: Indien de titel nog niet is verschenen (aangekondigd) of in herdruk is, is de uitgevers verplicht een ‘verwachte verschijningsdatum’ mee te geven. Dit volgt de in Onix gedefinieerde logica dat eenzelfde ISBN geen twee keer kan verschijnen. We nemen de verwachte verschijningsdatum op als <ExpectedShipDate> PR.24.34. (p.29). Met andere woorden: Indien de =
10 (in productie) 12 (POD, aangekondigd) 32 (in bijdruk/herdruk) 33 (herdruk in overweging) wordt de (verwachte) verschijningsdatum in PR.24.34 <ExpectedShipDate> opgenomen.
27 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.15.1. Correlatie tussen verschijningsdatum en artikelstatus Zoals in 3.15 reeds werd vermeld controleert Boekenbank in de aangeleverde titelbestanden de correlatie tussen de artikelstatus en de verschijningsdatum of <ExpectedShipDate>) waarbij: PO 1 10 12 20 21 22 23 30 31 32 33
OMSCHRIJVING Zal niet verschijnen Not yet available Printing on demand, aangekondigd Verschenen In voorraad Speciale bestelling Printing on demand Tijdelijk niet verkrijgbaar Verschenen, niet voorradig In herdruk Herdruk in overweging
ARTIKELSTATUS Zal niet verschijnen In productie Printing on demand Verschenen Verschenen Verschenen Printing on demand Verschenen Verschenen In herdruk Herdruk in overweging
40 41 43 44 46 47 48 99
Uitverkocht Vervangen door nieuwe uitgave Niet langer door ons geleverd Bestellen bij uitgever In prijs opgeheven Remaindered Uitverkocht, verkrijgbaar als POD Onzeker
Uitverkocht Uitverkocht Uitverkocht Bestellen bij uitgever In prijs opgeheven Uitverkocht Printing on demand Bestellen bij uitgever
VERSCHIJNINGSDATUM Leeg Leeg of in de toekomst Leeg of in de toekomst Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Leeg of in de toekomst Leeg, toekomst , verleden of vandaag Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden Vandaag of in het verleden
Indien de correlatie niet volgens bovenstaande tabel kan gevalideerd worden bij het inlezen van het titelbestand, worden de betreffende records geweigerd en opgelijst in het foutenrapport.
28 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.16 Territorial rights and other sales restrictions Indien de uitgever/distributeur geen rechten heeft om de titel in een bepaald land (in casu België of Nederland) te verkopen, dient dit te worden meegeven in de Not For Sale Composite. De volgende velden worden gebruikt: DATA ELEMENT
FIELD
Territorial rights and other sales restrictions Not-for-Sale Composite (R) Rights Country (R) End of Not-for-Sale Composite
PR.21.5
XML REFERENCE NAME
M/O Onix
M/O BB
O M
O M
M/O CB
LIST
A|N
POS.
91
In PR.21.5 wordt de landcode ingevuld van de het land waar de titel niet verkocht mag worden. Indien de uitgever BE invult, kan de titel dus niet via Boekenbank besteld worden. De Code-list 91 bevat alle landcodes waarbij België = BE en Nederland = NL. Als titels op deze manier worden aangemeld in Boekenbank, verplaatsen we de titel steeds naar het historische bestand van Boekenbank, waarbij we de artikelstatus op ‘onzeker’ zetten en de voorraadcode op ‘informatieve titel’. 3.17 Dimensions Deze composite wordt gebruikt om de afmetingen van het product mee te geven. Aangezien een product meerdere afmetingen heeft, kan de volledige composite herhaald worden. De gebruikte velden zijn: DATA ELEMENT Dimensions Measure Composite (R) Measure Type Code Measurerement Measure Unit Code End of Measure Composite
FIELD
PR.22.1 PR.22.2 PR.22.3
XML REFERENCE NAME
<Measure> <MeasureTypeCode> <Measurement> <MeasureUnitCode>
M/O Onix
M/O BB
O M M M
O M M M
M/O CB
LIST
A|N
POS.
N
3.2
48 50
In het veld PR.22.1 <MeasureTypeCode> wordt ahv Code-list 48 het type afmeting meegegeven, waarbij Boekenbank de volgende waarden accepteert: 01 Height 02 Width 03 Thickness 08 Weight
Hoogte Breedte Dikte Gewicht
(max. 999 cm)
5
In het veld PR.22.2 <Measurement> wordt de eigenlijke waarde van de afmeting meegegeven met 3.2 posities . De eenheid waarin de afmeting uit PR.22.2 <measurement> staat wordt aangeduid in het veld PR.22.3 <MeasureUnitCode>. Boekenbank accepteert de eenheden cm centimeter, mm millimeter en gr gram. Intern slaat Boekenbank alle afmetingen op in mm; in de Onix export van titelgegevens wordt ook enkel mm aangeleverd. Op de website www.boekenbank.be echter, worden afmetingen in cm weergegeven (met decimalen indien van toepassing). Let op: Aangezien de .csv export enkel afmetingen in cm ondersteunt worden waarden kleiner van 1 cm, als 0 (nul) geëxporteerd.
5
Drie posities voor decimaal punt en 2 posities achter decimaal punt (bijv. 123.12) 29 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.18 Related products Indien de titel een co-editie of substituut is, wordt de composite Related Product gebruikt. De gebruikte velden zijn: DATA ELEMENT Related products Related Product Composite (R) Relation Code Product Identifier Composite (R) Product Identifier Type Code Identifier Value End of Product Identifier Composite End of Related product composite
FIELD
PR.23.7 PR.23.10 PR.23.12
XML REFERENCE NAME
M/O Onix
M/O BB
M/O CB
O O M M M
O M M M M
O M M M M
LIST
A|N
POS.
N
13
51 5
In het veld PR.23.7 wordt ahv Code-list 51 aangeduid welke relatie het meegegeven EAN in PR.23.12 heeft met het record, waarbij: 03 05
: Replaces : Replaced by
Co-editie Substituut
3.18.1 Product identifier composite Product Identifier Composite identificeert de substituut of co-editie ahv het ISBN-13. De velden worden als volgt gebruikt: PR.23.10 PR.23.12
: waarde ‘03’ uit Code-list 05 duidt aan dat het een EAN.UCC-13 Betreft (het ISBN-13 wordt ingevuld) : het EAN
Let op: In tegenstelling tot de werkwijze met het CSV-bestand worden orders niet automatisch gecapteerd op een titel die in het co-editieveld wordt vermeld. Om de orders te capteren, moet ook de Not for sale composite ingevuld worden (zie 3.16 pag. 22 Territorial rights and other sales restrictions). Toelichting: Indien waarde 03 wordt meegegeven, geldt in Boekenbank de volgende regel: Bestellingen op het ISBN uit PR.23.12 zullen steeds worden doorgestuurd naar de leverancier van het ISBN van het totale record. Indien waarde 05 wordt meegegeven, geldt in Boekenbank de volgende regel: Bestellingen voor het ISBN van het totale record worden steeds doorgestuurd naar de leverancier van het ISBN uit PR.23.12. Let op: Een co-editie-ISBN of een substituut-ISBN kan slechts één keer in de ‘doorverwijzingsketen’ tussen beide ISBN-nummers voorkomen. Zodra een derde ISBN aan één van beide ISBN’s gekoppeld wordt in Boekenbank, zal een foutmelding voor de titel volgen.
30 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.19 Supplier, availability and prices De composite Supplier, availability and prices geeft informatie weer over beschikbaarheid, prijzen, BTW-tarieven en gegevens eigen aan Boekenbank, zoals fondscode en distributeurcode. De volgende velden worden gebruikt (de onder deze composite opgenomen Price composite wordt verder besproken in 3.19.5 pag. 28): DATA ELEMENT Supply Detail Composite (R) Supplier Identifier Composite (R) Supplier Identifier Type Code Identifier Value End of Supplier Identifier Composite Product Availabilty Expected Availability Date Audience Restriction Flag
M/O Onix
M/O BB
PR.24.3 PR.24.5
<SupplyDetail> <SupplierIdentifier> <SupplierIDType>
O O M M
M M M M
PR.24.22 PR.24.34 PR.24.45
<ExpectedShipDate>
M M O
M M O
FIELD
XML REFERENCE NAME
M/O CB
LIST
A|N
POS.
A
3
92
M M O
65 8 56
3.19.1 Supplier identifier composite Deze composite wordt binnen het Onix-bericht van/naar Boekenbank gebruikt om de distributeurcode en de fondscode op te geven. Hiertoe wordt de composite herhaald en 2x aangeleverd. Beide codes zijn verplicht voor de correcte verwerking van het bericht door Boekenbank. Indien de uitgever/distributeur niet over een van beide codes beschikt, kan deze aangevraagd worden via Boekenbank ([email protected]). De velden worden als volgt gebruikt: PR.24.3 <SupplierIDType> PR.24.5
: waarde ‘12’ uit Code-list 92 duidt aan dat het een Boekenbank distributeurcode betreft : de distributeurcode (3 posities)
De fondscode is een door Boekenbank gebruikte code van 6 posities die verplicht voor elke titel moet worden doorgegeven in het Onix-bericht. Hiervoor wordt de <SupplierIdentifier> composite herhaald met in volgende velden: PR.24.26 <SupplierIDType> PR.24.28
: waarde ‘13’ uit Code-list 92 duidt aan dat het een Boekenbank fondscode betreft : de fondscode
3.19.2 Product availability Het veld PR.24.22 wordt gebruikt om zowel een artikelstatus als een voorraadcode van het product mee te geven. Deze code is verplicht.
31 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.19.2.1 Vertaling van de codes De Onix-waarden uit Code-list 65 die in het veld PR.24.22 kunnen worden opgenomen stemmen niet volledig overeen met de artikelstatus zoals die door Boekenbank in het verleden werd gebruikt. Bovendien biedt Onix enkel de Engelse codes aan. Om het gebruik van deze codes te verduidelijken, worden ze op www.boekenbank.be als volgt naar het Nederlands vertaald voor gebruik bij het wijzigen van een titel. Bij het zoeken is een vereenvoudigde vertaling overgenomen: ONIX CODE 1 10 12 20 21 22 23 30 31 32 33 40 41 43 44 46 47 48 99
OMSCHRIJVING Cancelled Not yet available Not yet available, will be POD Available In Stock To Order Manufactured on Demand Temporarily unavailable Out of Stock Reprinting Awaiting Reissue Not available Replaced by new product No longer supplied by us Apply direct Withdrawn from sale Remaindered Out of print, replaced by POD Uncertain
VERTALING AANPASSEN TITEL Zal niet verschijnen In productie POD, aangekondigd Verschenen In voorraad Speciale bestelling Printing on Demand Tijdelijk niet verkrijgbaar Niet voorradig In herdruk Herdruk in overweging Niet verkrijgbaar Vervangen door nieuwe uitgave Niet langer door ons geleverd Bestellen bij uitgever In prijs opgeheven Uitverkocht Uitverkocht, verkrijgbaar als POD Bestellen bij uitgever
VERTALING ZOEKEN Zal niet verschijnen In productie Printing on Demand Verschenen Verschenen Verschenen Printing on Demand Verschenen Verschenen In herdruk Herdruk in overweging Uitverkocht Uitverkocht Uitverkocht Bestellen bij uitgever In prijs opgeheven Uitverkocht Printing on Demand Bestellen bij uitgever
32 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.19.2.2 Boekenbank voorraadcode De voorraadcode wordt in Boekenbank gebruikt (onder meer binnen de Open Markt Module) om aan te geven of een titel al dan niet in voorraad is bij de leverancier. Hoewel ‘voorraadcode’ in de database van Boekenbank een afzonderlijk veld is, worden deze beide gegevens samengevoegd in het veld PR.24.22 in het Onix-bericht. Om titelgegevens aangeleverd in het CSV-formaat (dat nog wel een veld ‘voorraadcode’ bevat) in te lezen in de database is er daarom een vertaalslag nodig; en ook indien er vanuit de database naar een CSV-bestand wordt geëxporteerd. De waarden die in het veld gebruikt kunnen worden komen uit Code-list 65. Onderstaande tabel geeft aan welke waarden worden geaccepteerd in het veld 24.22 en hoe deze vertaald worden naar het veld ‘voorraadcode’ in de database: ONIX CODE 1 10 12 20 21 22
Zal niet verschijnen In productie POD, aangekondigd Verschenen In voorraad Speciale bestelling
N O O V V S
23
Printing on Demand
V
30
Tijdelijk niet verkrijgbaar
T
31
Niet voorradig
T
32
In herdruk Herdruk in overweging Niet verkrijgbaar Vervangen door nieuwe uitgave Niet langer door ons geleverd Bestellen bij uitgever In prijs opgeheven Uitverkocht Uitverkocht, verkrijgbaar als POD Bestellen bij uitgever
O
OMSCHRIJVING VOORRAADCODE Niet leverbaar Nog niet leverbaar Nog niet leverbaar Leverbaar Leverbaar Speciale bestelling Leverbaar uit voorraad Tijdelijk niet verkrijgbaar Tijdelijk niet leverbaar Nog niet leverbaar
O
Nog niet leverbaar
N
Niet leverbaar
N
Niet leverbaar
N
Niet leverbaar
I N N
Informatieve titel Niet leverbaar Niet leverbaar
P
POD
N
Niet leverbaar
33 40 41 43 44 46 47 48 99
VERTALING
VOORRAADCODE
33 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.19.2.3 Vertaling naar het CSV-bericht Indien er vanuit de database een export wordt gedaan naar een CSV-bericht wordt het veld ‘Artikelstatus’ en ‘Voorraadcode’ in dit CSV-bericht opgevuld met een vertaling van de Onix-code aanwezig in de database. Dit gebeurt als volgt: ONIX CODE
ARTIKELVERTALING
STATUS
ARTIKELSTATUS
VOORRAADCODE
OMSCHRIJVING VOORRAADCODE
1 10 12 20 21 22
Zal niet verschijnen In productie POD, aangekondigd Verschenen In voorraad Speciale bestelling
CSV 5 1 9 2 2 2
23
Printing on Demand
9
Printing on Demand
V
30
Tijdelijk niet verkrijgbaar
2
Verschenen
T
31
Niet voorradig
2
Verschenen
T
32
In herdruk Herdruk in overweging Niet verkrijgbaar Vervangen door nieuwe uitgave Niet langer door ons geleverd Bestellen bij uitgever In prijs opgeheven Uitverkocht Uitverkocht, verkrijgbaar als POD Bestellen bij uitgever
3
In bijdruk/herdruk
O
Niet leverbaar Nog niet leverbaar Nog niet leverbaar Leverbaar Leverbaar Speciale bestelling Leverbaar uit voorraad Tijdelijk niet verkrijgbaar Tijdelijk niet leverbaar Nog niet leverbaar
8
Herdruk in overweging
O
Nog niet leverbaar
4
Uitverkocht
N
Niet leverbaar
4
Uitverkocht
N
Niet leverbaar
4
Uitverkocht
N
Niet leverbaar
6 7 4
Te bestellen bij uitgever In prijs opgeheven Uitverkocht
I N N
Informatieve titel Niet leverbaar Niet leverbaar
9
Printing on Demand
P
POD
6
Te bestellen bij uitgever
N
Niet leverbaar
33 40 41 43 44 46 47 48 99
Zal niet verschijnen In productie Printing on Demand Verschenen Verschenen Verschenen
N O O V V S
3.19.3 Expected Availability Date In Expected Availability Code of <ExpectedShipDate> wordt de verwachte verschijningsdatum geplaatst. De uiteindelijke, effectieve verschijningsdatum wordt in PR.20.5 gezet (p.23). Met andere woorden, indien de titel nog niet is verschenen (aangekondigd) of in herdruk is, is de uitgevers verplicht een ‘verwachte verschijningsdatum’ mee te geven. Dit volgt de in Onix gedefinieerde logica dat eenzelfde ISBN geen twee keer kan verschijnen. Binnen de verwerking van Boekenbank wordt bovendien gecontroleerd op de correlatie tussen en <ExpectedShipDate> waarbij: Indien de =
10 (in productie) 12 (POD, aangekondigd) 32 (in bijdruk/herdruk) 33 (herdruk in overweging) de (verwachte) verschijningsdatum in PR.24.34 <ExpectedShipDate> in de toekomst moet liggen
34 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
3.19.4 Audience restriction flag Indien de titel niet bestelbaar mag staan in de database van Boekenbank, wordt het veld PR.24.45 met waarde ‘R’ uit Code-list 56 gevuld. Deze code vervangt de Boekenbank-codes ‘Netwerkcode’ en ‘Bestellen boekhandel’; die op inactief worden geplaatst. Als titels op deze manier worden aangemeld in Boekenbank, verplaatsen we de titel steeds naar het historische bestand van Boekenbank, waarbij we de artikelstatus op ‘onzeker’ zetten en de voorraadcode op ‘informatieve titel’.
3.19.5 Price composite Informatie over prijs, btw-tarieven, kortingscodes en minimale bestelhoeveelheden worden opgenomen in de Price composite. Deze composite is verplicht op te nemen in elk bericht. De gebruikte velden zijn: DATA ELEMENT Price Composite (R) Price Type Code Minimum Order Quantity Discount Code Composite Discount Code Type Code Discount Code Value End of Discount Code Composite Price Amount Currency Code Tax Rate 1, coded Amount of Price taxable at tax rate 1 Tax Rate 2, coded Aount of price taxable at tax rate 2 Price effective from Price effective until End of Price Composite
M/O Onix
M/O BB
M/O CB
O O O M M M
M M O M M M
M
PR.24.58 PR.24.60
<MinimumOrderQuantity>
PR.24.63 PR.24.64 PR.24.66 PR.24.68 PR.24.70 PR.24.72 PR.24.74 PR.24.75
M O O O O O O O
M M O O O O O O
M M O O O O M O
FIELD
PR.24.49 PR.24.53
XML REFERENCE NAME
LIST
A|N
POS.
N
4
N
12
N
6.2
N N
8 8
58 M M M
100
96 62 62
3.19.5.1 Price type code In Boekenbank is het mogelijk om drie prijstypes door te geven; nl. de verkoopprijs (inclusief btw), een aangekondigde prijswijziging, een actieprijs en een introductieprijs. Het type prijs dat in het bericht wordt opgenomen, wordt bepaald ahv het veld PR.24.49 . De waarden uit Code-list 58 die door Boekenbank worden geaccepteerd zijn als volgt: CODE
OMSCHRIJVING
VERTALING
2
RRP including Sales or value-added taxi if applicable
Standaardprijs
12
Special sale RRP including sales or value-added tax if applicable
Actieprijs
22
Pre-publication RRP including sales of value-added tax if applicable
Introductieprijs
Let op: Deze toevoeging is nog niet vastgelegd door de werkgroep Onix. Zodra deze door de werkgroep wordt bekrachtigd zal dit naar de dataleveranciers worden gecommuniceerd. Indien de toevoeging niet wordt bekrachtigd vervalt 3.19.5.1 Price type code en 2.7 Default price type code (pag. 7).
3.19.5.2 Minimum Order Quantity
35 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Indien er sprake is van een minimum bestelhoeveelheid voor een bepaalde titel, kan deze meegegeven worden in het veld PR.24.53 <MinimumOrderQuantity>. De waarde moet numeriek zijn en maximaal 4 posities. Indien niet ingevuld wordt default waarde ‘1’ in de database geplaatst. 3.19.5.3 Discount Code Coded De Discount Code Composite wordt gebruikt om de AWS-code mee te geven. Waarbij: PR.24.58 PR.24.60
: waarde ‘03’ uit Code-list 100 aanduidt aan dat het hier een AWS-code betreft (of Boeksoort-code) : de AWS-code (A | O | S | W)
Deze code duidt aan over welk type uitgave het gaat: A O S W
: : : :
Algemene Boeken Overig Schoolboeken Wetenschappelijke Boeken
3.19.5.4 Price amount De verkoopprijs van de titel; inclusief btw wordt opgenomen in PR.24.63 .
3.19.5.5 Currency code De munteenheid waarin de prijs wordt doorgegeven, is een verplicht veld in het Onix-bericht. Boekenbank accepteert (momenteel) enkel prijzen in euro (€). De waarde ‘EUR’ uit Code-list 96 moet daarom in veld PR.24.64 opgenomen worden.
3.19.5.6 Tax rate 1, coded | Tax amount | Tax rate 2, coded | Tax amount Het btw-tarief van toepassing op het product wordt meegegeven in PR.24.66 ; ahv een waarde uit Code-list 62. Het netto bedrag exclusief btw wordt bovendien in PR.24.68 geplaatst. Onix voorziet ook de mogelijkheid om producten met een samengesteld btw-tarief door te geven. De velden PR.24.66 en PR.24.70 worden daarvoor gevuld met waarden uit Code-list 62 waarbij: CODE
OMSCHRIJVING
OPMERKINGEN
BTW-TARIEF
H
Higher rate
Specifies that tax is applied at a higher rate than standard
21%
R
Lower rate
Specifies that tax is applied at a lower rate than standard
6%
S
Standard rate
21%
Z
Zero-rated
zonder btw
Let op: Bij Centraal Boekhuis is op basis van oudere Onix-lijsten de waarde ‘S’ vastgelegd voor hogere btw (21%). Boekenbank behoudt deze waarde, maar adviseert de leveranciers van titelgegevens om waar mogelijk de waarde ‘H’ mee te geven voor btw-tarief van 21%. De velden PR.24.68 en PR.24.72 worden gevuld met het netto bedrag exclusief btw respectievelijk onderhevig aan de btw-tarieven meegegeven in PR.24.66 en PR.24.70.
36 / 37
Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.6
Let op: Bij producten met een gemengde btw dient men in veld PR.24.66 steeds de waarde ‘R’ uit Code-list 62 te gebruiken, zodat fouten op tarieven worden uitgesloten.
3.19.5.7 Price effective from Indien het prijstype meegegeven in PR.24.49 verschilt van de standaardprijs (waarde ‘02’ uit Code-list 58), dient het veld PR.24.74 te zijn ingevuld met de datum waarop de prijs ingaat. Het datumformaat is YYYYMMDD. Ook bij waarde ‘02’ in PR 24.49 kan PR.24.74 worden ingevuld. In dat geval wordt de prijs gezien als een prijswijziging die ingaat op de datum die in dit veld is aangegeven.
3.19.5.8 Price effective until Indien het prijstype meegegeven in PR.24.49 gelijk is aan de waarde ‘14’ (Actieprijs) of ‘22’ (Introductieprijs) uit Code-list 58, dient ook het veld PR.24.75 te worden ingevuld met de einddatum waarop de meegegeven prijs van toepassing is. Het datumformaat dat wordt gehanteerd is YYYYMMDD. Hier moet nog een aanpassing komen in de handleiding (te bevestigen door onze IT-partner) AANPASSING: ook voor standaardprijs ingangsdatum en einddatum bijhouden. Indien geen ingangsdatum = verschijningsdatum?
37 / 37
