BOEKENBANK ALS REFERENTIEDATABANK VOOR DE GEREGLEMENTEERDE BOEKENPRIJS (GBP)

Transcriptie

1 BOEKENBANK ALS REFERENTIEDATABANK VOOR DE GEREGLEMENTEERDE BOEKENPRIJS (GBP) AFNEMEN VAN PRIJSINFORMATIE DOOR BOEKHANDELS (Laatste wijziging op 22/06/207)

2 . Wijzigingsoverzicht Inleiding Voor wie is dit document? Doel van dit document Prijzen downloaden als CSV-bestand Waar het CSV-bestand downloaden? Welk formaat heeft dit CSV-bestand? Prijzen downloaden als ONIX-bestand Waar het ONIX-bestand uit Boekenbank downloaden? ONIX via de API Waarden voor tag <PriceType> / <PriceTypeCode> Waarden voor de nieuwe <PriceQualifier> tag Gebruik van de nieuwe <PriceTypeDescription> tag De start- en einddatum van speciale prijzen Voorbeelden ONIX 2. price composite Gereglementeerde boekenprijs Actieprijs binnen GBP-termijn Ledenprijs binnen GBP-termijn Voorbeelden ONIX 3.0 price composite Gereglementeerde boekenprijs Actieprijs binnen GBP-termijn Ledenprijs binnen GBP-termijn Wanneer kan de GBP nog veranderen? Appendix Overzicht van de ONIX 2. price composite Overzicht van de ONIX 3.0 price composite Overzicht van de verschillende prijzen in Boekenbank

3 . Wijzigingsoverzicht Versie Omschrijving wijzigingen Datum Door.0 Eerste versie 22/03/207 Olivier Fuchs. Eerste revisie 04/04/207 Olivier Fuchs.2 Tweede revisie 29/05/207 Olivier Fuchs.3 Enkele bijkomende verduidelijkingen 22/06/207 Olivier Fuchs 3

4 2. Inleiding 2. Voor wie is dit document? Dit document is voor de Vlaamse boekhandels die boeken uitgeven of verdelen die vallen onder de regelgeving van de Gereglementeerde Boekenprijs én die als betalend lid van Meta4Books data afnemen via Boekenbank of via de API. Zij kunnen dit als leidraad gebruiken om hun systeem aan te passen in het kader van de Gereglementeerde Boekenprijs. 2.2 Doel van dit document Vanaf juli 207 geldt in Vlaanderen een Gereglementeerde Boekenprijs (GBP) voor algemene publicaties gelden in de eerste 6 maanden nadat het boek aan de consument is aangeboden. Boekenbank is de referentiedatabank voor de GBP. Voor meer informatie over de GBP, zie Dit document beschrijft hoe boekhandels de gereglementeerde boekenprijs en afwijkende prijzen binnen de GBP-termijn (b.v. actieprijzen, ledenprijzen, ) kunnen afnemen van Boekenbank in de vorm van CSV- of ONIX-bestanden. Ook het afnemen van deze gegevens via de API wordt kort beschreven. Dit document beschrijft vooral de nieuwe functionaliteiten in Boekenbank als referentiedatabank voor de Gereglementeerde Boekenprijs. Alle overige documentatie is terug te vinden in de handleidingen van Boekenbank. BELANGRIJK: Aangezien het uitvoeringsbesluit én de softwarematige aanpassingen in Boekenbank nog in ontwikkeling zijn, is het mogelijk dat hier nog kleine dingen aan veranderen. U kunt altijd de laatste versie van dit document downloaden op: 4

5 3. Prijzen downloaden als CSV-bestand Om de gereglementeerde boekenprijs (en speciale prijzen die vallen binnen de termijn van zes maanden waarin de GBP geldig is) te downloaden via CSV, gebruiken we de bestaande Boekenbankfunctionaliteit CSV speciale prijzen. Wat nieuw is tegenover de bestaande functionaliteit, is aangeduid met. OPGELET: Deze functionaliteit voor speciale prijzen via CSV-bestand staat in Boekenbank apart van het downloaden van de titelmutaties als CSV47-bestand (met daarin de gewone adviesprijs) op de FTP-server onder de download\titels_csv folder. Met de module Speciale prijzen opladen kan de uitgever 8 soorten prijzen opladen: 3 soorten prijzen die gelden buiten de GBP-termijn (bestaan reeds in Boekenbank):. een prijswijziging die vooraf wordt doorgegeven met de startdatum waarop de wijziging ingaat. 2. een actieprijs met begin- en einddatum van de actieperiode. 3. een introductieprijs met begin- en einddatum van de actieperiode. 5 soorten prijzen die gelden binnen de GBP-termijn:. de gereglementeerde boekenprijs: dit is altijd verplicht voor boeken die vallen onder de GBP 2. een actieprijs: een speciale actie die maximaal 3 maanden mag gelden 3. een serieprijs: een speciale prijs omdat de titel deel uitmaakt van een serie 4. een combinatieprijs: een speciale prijs omdat het wordt verkocht in combinatie met een ander product 5. een ledenprijs: een speciale prijs omdat men lid is van een bepaalde vereniging 3. Waar het CSV-bestand downloaden? U heeft twee mogelijkheden om het CSV-bestand te downloaden.. Online in de applicatie onder Titelbestand > GBP en speciale Prijzen raadplegen : 2. Op de FTP-server onder de folder download > prijzen : 5

6 3.2 Welk formaat heeft dit CSV-bestand? Kolom nr. ISBN-3 Omschrijving 2 Prijs in euro (maximaal 2 decimalen gescheiden door een komma) 3 Begindatum: datumformaat (d)dmmjjjj vb Einddatum: datumformaat (d)dmmjjjj vb Prijstype: mogelijkheden: Prijstypes buiten GBP-termijn: A = actieprijs W= prijswijziging I = introductieprijs Prijstypes binnen GBP-termijn: G = gereglementeerde boekenprijs P = actieprijs binnen GBP-termijn S, S2 en S3 = maximaal 3 serieprijzen C, C2 en C3 = maximaal 3 combinatieprijzen L, L2 en L3 = maximaal 3 ledenprijzen Omschrijving: omschrijving van de speciale prijs. Deze bestaat uit maximaal 255 karakters. BELANGRIJK:. Prijzen vandaag opgeladen door de uitgever zijn pas de volgende dag downloadbaar. 2. Een leeg datumveld wordt in het CSV-bestand weergegeven als Zolang voor een ISBN de einddatum van de Gereglementeerde Boekenprijs (prijstype G) nog niet bereikt is, zullen ALLE speciale prijzen van types G, P, S(x), C(x) en L(x) in het CSV exportbestand zitten, ook al hebben sommige van deze prijzen hun eigen einddatum al bereikt. 4. Zodra echter de GBP-termijn is verlopen voor dat ISBN, zullen voor dat ISBN GEEN speciale prijzen van types G, P, S(x), C(x) en L(x) nog meekomen in het CSV exportbestand. 5. Als een uitgever een speciale prijs verwijdert in Boekenbank, geven we deze niet mee met een speciale code in het CSV-bestand. Deze speciale prijs verdwijnt gewoon uit de export. Daarom raden we aan om voor elk ISBN bij import van de CSV met speciale prijzen, de bestaande speciale prijzen in uw eigen systeem te wissen en opnieuw te vullen met de speciale prijzen uit het laatste CSV bestand. Zo zitten speciale prijzen die verwijderd zijn Boekenbank, ook niet meer uw eigen systeem. 6. Door de combinatie van punt 2 en 3, zult u voor uw eigen systeem moeten kiezen of u: a. Alle speciale prijzen van types G, P, S(x), C(x) en L(x) verwijdert in uw eigen systeem zodra de GBP-termijn is bereikt (omdat ze niet meer in de CSV-export zitten), -OF- b. Of u deze speciale prijzen op het einde van de GBP-termijn wilt archiveren. 6

7 4. Prijzen downloaden als ONIX-bestand Zie 5. en 5.2 in de appendix op pagina 3 voor een overzicht van respectievelijk de ONIX 2. en ONIX 3 price composite. 4. Waar het ONIX-bestand uit Boekenbank downloaden? De dagelijkse titelmutaties in ONIX-formaat vindt je op de FTP-server onder de folder download > titels_onix : 4.2 ONIX via de API Als je data afneemt via de API, haal je data op uit onze DANTE database. Voor sommige titels is deze database gevoed zowel rechtstreeks door CB als door Boekenbank. Voor die titels ga je meer dan één <SupplyDetail> composite hebben in de output van de API. De informatie van de gereglementeerde prijzen, moet je altijd ophalen van de <SupplyDetail> composite uit Boekenbank. Deze heeft source BB. Bijvoorbeeld: <SupplyDetail source="bb">. 4.3 Waarden voor tag <PriceType> / <PriceTypeCode> Vroeger vond je voor de <PriceTypeCode> (ONIX 2.) / <PriceType> (ONIX 3) (List 58) enkel de volgende waarden: 02: Standaardprijs (inclusief BTW) 2: Actieprijs (inclusief BTW) 22: Introductieprijs (inclusief BTW) Hier komen de volgende waarden bij: 04: Gereglementeerde boekenprijs (inclusief BTW) 4: Speciale prijzen binnen GBP-termijn (inclusief BTW). Dit vind je steeds terug in combinatie met de tag <PriceQualifier> 7

8 4.4 Waarden voor de nieuwe <PriceQualifier> tag PriceQualifier (List 59) nemen we in gebruik om speciale prijzen binnen de GBP-termijn uit te splitsen. Als bij <PriceTypeCode> (ONIX 2.) / <PriceType> (ONIX 3) waarde 4 wordt opgegeven, dan moet de <PriceQualifier> ingevuld zijn. De volgende waarden nemen we in gebruik: 0: Ledenprijs (meerdere per ISBN toegelaten) 03: Serieprijs (meerdere per ISBN toegelaten) 08: Actieprijs (slechts één per ISBN toegelaten) 09: Combinatieprijs (meerdere per ISBN toegelaten) 4.5 Gebruik van de nieuwe <PriceTypeDescription> tag Als bij <PriceTypeCode> (ONIX 2.) / <PriceType> (ONIX 3) waarde 4 is meegegeven en de <PriceQualifier> is 0 (ledenprijzen), 03 (serieprijzen) of 09 (combinatieprijzen), is ook altijd de <PriceTypeDescription> ingevuld. Met andere woorden: de price description is verplicht voor alle speciale prijzen binnen de GBP-termijn behalve de actieprijs. Dit veld geeft meer informatie over de speciale prijs binnen de GBP-termijn (b.v. voor welke vereniging een ledenprijs geldt, in combinatie met welk product een combinatieprijs geldt enzovoort). De <PriceTypeDescription> is een vrij tekstveld met maximaal 255 karakters. 4.6 De start- en einddatum van speciale prijzen In ONIX 2. geven we de start- en einddatum mee aan de hand van respectievelijk de <PriceEffectiveFrom> en <PriceEffectiveUntil> tags. In ONIX 3 gebeurt dit aan de hand van de composite. Met de <PriceDateRole> tag geven we weer of het om een start- (4) of einddatum (5) gaat. Bijvoorbeeld: <PriceDateRole>4</PriceDateRole> <Date dateformat="00">207022</date> <PriceDateRole>5</PriceDateRole> <Date dateformat="00">207042</date> Zowel in ONIX 2 als in ONIX 3 is de formaat van de datum altijd JJJJMMDD, bijvoorbeeld OPMERKINGEN: Als de uitgever voor leden-, combinatie- of serieprijzen geen einddatum heeft meegegeven, zal Boekenbank deze automatisch zetten op de einddatum van de gereglementeerde boekenprijs (price type 04). 8

9 4.7 Voorbeelden ONIX 2. price composite 4.7. Gereglementeerde boekenprijs <Price> <PriceTypeCode>04</PriceTypeCode> <DiscountCoded> <DiscountCodeType>03</DiscountCodeType> <DiscountCode>A</DiscountCode> </DiscountCoded> <PriceAmount>24.95</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>6.00</TaxRatePercent> <TaxableAmount>23.54</TaxableAmount> <PriceEffectiveFrom>20703</PriceEffectiveFrom> <PriceEffectiveUntil> </PriceEffectiveFrom> </Price> Actieprijs binnen GBP-termijn <Price> <PriceTypeCode>4</PriceTypeCode> <PriceQualifier>08</PriceQualifier> <PriceTypeDescription>De lente is in het land promotie</pricetypedescription> <DiscountCoded> <DiscountCodeType>03</DiscountCodeType> <DiscountCode>A</DiscountCode> </DiscountCoded> <PriceAmount>9,66</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>6.00</TaxRatePercent> <TaxableAmount>8.55</TaxableAmount> <PriceEffectiveFrom>207022</PriceEffectiveFrom> <PriceEffectiveUntil>207042</PriceEffectiveFrom> </Price> Ledenprijs binnen GBP-termijn <Price> <PriceTypeCode>4</PriceTypeCode> <PriceQualifier>0</PriceQualifier> <PriceTypeDescription>Korting leden van Natuurpunt</PriceTypeDescription> <DiscountCoded> <DiscountCodeType>03</DiscountCodeType> <DiscountCode>A</DiscountCode> </DiscountCoded> <PriceAmount>9.66</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>6.00</TaxRatePercent> <TaxableAmount>8.55</TaxableAmount> <PriceEffectiveFrom> </PriceEffectiveFrom> <PriceEffectiveUntil> </PriceEffectiveFrom> </Price> 9

10 4.8 Voorbeelden ONIX 3.0 price composite 4.8. Gereglementeerde boekenprijs <Price> <PriceType>04</PriceTypeCode> <DiscountCoded> <DiscountCodeType>03</DiscountCodeType> <DiscountCode>A</DiscountCode> </DiscountCoded> <PriceAmount>24.95</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <Tax> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>6.00</TaxRatePercent> <TaxableAmount>23.54</TaxableAmount> </Tax> <PriceDateRole>4</PriceDateRole> <Date dateformat="00">20703</date> <PriceDateRole>5</PriceDateRole> <Date dateformat="00"> </date> </Price> Actieprijs binnen GBP-termijn <Price> <PriceType>4</PriceTypeCode> <PriceQualifier>08</PriceQualifier> <PriceTypeDescription>De lente is in het land promotie</pricetypedescription> <DiscountCoded> <DiscountCodeType>03</DiscountCodeType> <DiscountCode>A</DiscountCode> </DiscountCoded> <PriceAmount>9.66</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <Tax> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>6.00</TaxRatePercent> <TaxableAmount>8.55</TaxableAmount> </Tax> <PriceDateRole>4</PriceDateRole> <Date dateformat="00">207022</date> <PriceDateRole>5</PriceDateRole> <Date dateformat="00">207042</date> </Price> 0

11 4.8.3 Ledenprijs binnen GBP-termijn <Price> <PriceType>4</PriceTypeCode> <PriceQualifier>0</PriceQualifier> <PriceTypeDescription>Korting leden van Natuurpunt</PriceTypeDescription> <DiscountCoded> <DiscountCodeType>03</DiscountCodeType> <DiscountCode>A</DiscountCode> </DiscountCoded> <PriceAmount>8,5</PriceAmount> <CurrencyCode>EUR</CurrencyCode> <Tax> <TaxRateCode>R</TaxRateCode> <TaxRatePercent>6.00</TaxRatePercent> <TaxableAmount>7,2</TaxableAmount> </Tax> <PriceDateRole>4</PriceDateRole> <Date dateformat="00"> </date> <PriceDateRole>5</PriceDateRole> <Date dateformat="00"> </date> </Price>

12 4.9 Wanneer kan de GBP nog veranderen? Zodra een uitgave is verschenen (op basis van artikelstatus met een artikelstatus verschillend van In productie, POD, aangekondigd of Zal niet verschijnen ) én de GBP-termijn reeds is ingegaan, mag de uitgever bepaalde gereglementeerde prijzen niet meer wijzigen of verwijderen. In Boekenbank zal je in de zoekresultaten kunnen zien of de GBP-gegevens nog gewijzigd kunnen worden aan de hand van een slot-icoontje: = gereglementeerde boekenprijs kan nog gewijzigd worden = gereglementeerde boekenprijs kan niet meer gewijzigd worden BELANGRIJK:. Voor een ISBN worden ALLE speciale prijzen (price types 04, 2 en 4) altijd geëxporteerd in het ONIX titelmutatiebestand, ongeacht of deze speciale prijzen al verlopen zijn of niet. 2. Als een uitgever een speciale prijs verwijdert in Boekenbank, geven we deze niet mee met een speciale code in het ONIX-bestand. Deze speciale prijs verdwijnt gewoon uit de export. Daarom raden we aan om voor elk ISBN in het ONIX titelmutatiebestand de bestaande speciale prijzen in uw eigen systeem te wissen en opnieuw te vullen met de speciale prijzen uit het laatste CSV bestand. Zo zitten speciale prijzen die verwijderd zijn Boekenbank, ook niet meer in uw eigen systeem. 2

13 5. Appendix 5. Overzicht van de ONIX 2. price composite DATA ELEMENT FIELD XML REFERENCE NAME M/O Onix M/O BB LIST A N POS. Price Composite (R) <Price> O M Price Type Code PR <PriceTypeCode> O M 58 Price Type Qualifier PR <PriceQualifier> O O 59 Price Description PR.24.5 <PriceTypeDescription> O O 255 Minimum Order Quantity PR <MinimumOrderQuantity> O O N 4 Discount Code Composite <DiscountCoded> M M Discount Code Type Code PR <DicsountCodeType> M M 00 Discount Code Value PR <DiscountCode> M M End of Discount Code Composite Price Amount PR <PriceAmount> M M N 2 Currency Code PR <CurrencyCode> O M 96 Tax Rate, coded PR <TaxRateCode> O M 62 Amount of Price taxable at tax rate PR <TaxableAmount> O M N 6.2 Tax Rate 2, coded PR <TaxRateCode2> O O 62 Amount of price taxable at tax rate 2 PR <TaxableAmount2> O O Price effective from PR <PriceEffectiveFrom> O O N 8 Price effective until PR <PriceEffectiveUntil> O O N 8 End of Price Composite 3

14 5.2 Overzicht van de ONIX 3.0 price composite DATA ELEMENT FIELD XML REFERENCE NAME M/O Onix M/O BB LIST A N POS. Price Composite (R) <Price> O M Price Type Code P <PriceType> O M 58 N Price Type Qualifier P <PriceQualifier> O O 59 N Price Description P <PriceTypeDescription> O O A 255 Minimum Order Quantity P.26.5 <MinimumOrderQuantity> O M N Discount Code Composite <DiscountCoded> Discount Code Type Code P <DiscountCodeType> M M 00 N Discount Code Value P <DiscountCode> M M A End of Discount Code Composite Price Amount P <PriceAmount> M M N 2 Tax Composite <Tax> Tax type, coded P <TaxType> O O 7 N Tax rate; coded P <TaxRateCode> O M 62 N Tax rate, percent P <TaxRatePercent> O M Amount of price taxable at this rate P <TaxableAmount> O M N Tax Amount at this rate P <TaxAmount> O O End of Tax composite Currency Code P.26.7 <CurrencyCode> O M 96 A Price date composite Price date role P <PriceDateRole> O O 73 N 2 Price date P <Date format> O O N 8 End of Price date composite End of Price Composite 4

15 5.3 Overzicht van de verschillende prijzen in Boekenbank Prijstype GBP? Aantal Gewone adviesprijs Prijswijziging Gereglementeerde boekenprijs Actieprijs binnen GBP Serieprijs Combinatieprijs Ledenprijs CSV Code ONIX Price Type ONIX Price Qualifier Wijzigen toegelaten? Omschrijving Startdatum Einddatum / / 02 / Altijd Alleen bij nulprijs Geen of in het verleden Nooit 0-n W 02 / Altijd Nee Verplicht & in de toekomst Altijd 0- G 04 / Business rules Nee Verplicht & in de toekomst Altijd 0- P 4 08 Business rules Optioneel Verplicht & in de toekomst Nooit Leeg (=00000 in CSV of tag weglaten in ONIX) Optioneel, altijd automatisch berekend Verplicht, max 3 maanden na startdatum Altijd 0-3 S[x] 4 03 Business rules Verplicht Verplicht Optioneel. Gelijk aan einddatum GBP indien leeg Altijd 0-3 C[x] 4 09 Business rules Verplicht Verplicht Optioneel. Gelijk aan einddatum GBP indien leeg Altijd 0-3 L[x] 4 0 Business rules Verplicht Verplicht Optioneel. Gelijk aan einddatum GBP indien leeg Actieprijs Nooit 0-n A 2 / Altijd Nee Verplicht Verplicht Introductieprijs Nooit 0- I 22 / Altijd Nee Verplicht Verplicht Waarbij [x] gelijk is aan, 2 of 3. 5