Oorspronkelijk doel
Deze handleiding beschrijft het bestand met het e-book assortiment wat dient om de webshop te voorzien van de e-book artikelgegevens. Het bestand wordt dagelijks in de ochtend klaargezet in de out map van het FTP account wat voor u is ingericht. De eerste keer dat dit bestand voor u wordt klaargezet zal dit een initieel bestand zijn en bevat het alle, op dat moment voor u aanwezige, e-books. Daarna worden er mutatiebestanden aangeboden met daarin opgenomen enkel de gewijzigde e-books. Zodra er iets is gewijzigd aan het e-book, dan zal alle informatie van het e-book in het bestand worden opgenomen. Wijzigt er niets, dan zal het e-book niet meer in het mutatiebestand staan.
Om de webshop up-to-date te houden is het van belang dagelijks de mutatiebestanden te verwerken
Overgangssituatie - Start met e-books in webshop of upgrade/vernieuwing van de e-book artikeldatabase webshop
Op het moment dat CB gestart is met het verkopen van e-books bestond alleen nog dit webshop specifieke e-books bericht waarin doorgegeven wordt welke e-books er door uitgevers beschikbaar gesteld zijn aan de betreffende webshop. Het nadeel van enkel het webshop specifieke bericht is dat de webshop geen zicht heeft op het volledig aanwezige e-book assortiment en dan ook niet weet welke titels er wellicht ook interessant zijn voor de webshop, waarover eventueel nog afspraken gemaakt kunnen worden met de uitgever. Het is de bedoeling dat dit webshop specifieke e-book bericht op termijn uitgefaseerd wordt en in de loop van de tijd steeds verder uitgekleed zal gaan worden.
De volledige metadata wordt doorgegeven in het ONIX30 e-book assortimentsbericht voor de bepaling welke e-books op te nemen in de webshop dienen beide berichten als volgt gebruikt te worden.
| Bericht | bestandsnaam | Doel |
|---|---|---|
| ONIX30 | onix30mebyyyymmdd-mut-1van1.zip bij aanvang initieel bestand onix30iebyyyymmdd-ini-1van73.zip | Aanleggen van de e-book artikeldatabase, deze up-to-date houden met de dagelijkse mutatieberichten. Bevat alle metadata van het e-book ongeacht of deze door de uitgever beschikbaar gesteld zijn aan de webshop. Voor uitgevers geldt dat e-books opgenomen zijn in het ONIX30 bericht voor eigenaren. Als op de webshop enkel de e-books van de uitgever worden opgenomen volstaat het ONIX30 voor eigenaren. |
| webshop specifiek e-book | yyyymmdd-eboeken.csv initieel en mutatiebestand hebben dezelfde bestandsnaam | Bevat de e-books welke de uitgever beschikbaar heeft gesteld aan de webshop of wil terugtrekken bij de webshop en de korting die daarbij is vastgelegd. De volgende velden geven de korting aan en welke e-books opgenomen kunnen worden of teruggetrokken dienen te worden van de webshop
De overige velden uit het bericht kunnen genegeerd worden |