Aanleveren Artikelgegevens in Onix 2.1. aan Boekenbank

Aanleveren Artikelgegevens in Onix 2.1. aan Boekenbank Versie 3.7 | 31 januari 2013

Aanleveren artikelgegevens in Onix 2.1. aan Boekenbank v. 3.7

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 O

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

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

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

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

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

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

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

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

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

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

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

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