In dit document wordt het bericht Beschikbaarheid artikelen voor 24-uurslevering t.b.v. boekverkopers beschreven.
Niet alle beschikbare artikelvoorraad is beschikbaar voor de 24-uursdienstverlening. Het BHDART bericht geeft een overzicht van de artikelen welke wel beschikbaar zijn voor 24-uurslevering. Aan de hand van dit bericht kan op de website van de boekverkoper, bij de in het bericht opgenomen titels, worden aangegeven dat een bestelling voor deze titel de volgende werkdag afgeleverd kan worden, via de website of in de winkel.
Het BHDART bericht is een aanvulling op de dagelijks aangeboden ONIX artikelmutatie berichten. Uw artikeldatabase dient up-to-date gehouden te worden met deze dagelijkse artikelmutatieberichten. Enkel het BHDART bericht gebruiken om de artikeldatabase van de website te vullen zonder daarbij gebruik te maken van de assortimentsgegevens, inclusief artikelstadia en leverbaarheid, uit de ONIX artikelmutatieberichten leidt tot een incompleet assortiment op de website van de webwinkel/boekhandel.
Webservice voor artikelbeschikbaarheid
Om de beschikbaarheid van een artikel op te vragen, beschikt CB ook over een webservice getStockAvailability. De websevice geeft actuele informatie over de artikelbeschikbaarheid.
Het bericht wordt beschikbaar gesteld in Digicom formaat.
Digicom
De berichten van digitale communicatie, Digicom, hebben als voornaamste kenmerk de gelaagde opbouw en de gebruikte veld identificatie (attributen). Gegevens worden gegroepeerd rondom de diverse transactiegegevens. Op deze wijze wordt de informatie in een logische combinatie gepresenteerd en worden zo min mogelijk gegevens herhaald. Verder is er sprake van een opbouw die controle op compleetheid en uniekheid van het bericht mogelijk maakt door middel van een header, footer en unieke berichtidentificatie.
Tekenset
De tekenset is ISO 8859-1.
Veld identificatie - CB-id
In de berichten worden de attributen gespecificeerd door middel van attribuut nummers (4-cijferig). Ter herkenning wordt ieder attribuutnummer (CB-id) vooraf gegaan door een #. Dit teken kan of zal op geen enkele andere wijze in het bericht worden gebruikt.
Veld met decimale scheiding
In velden met een decimale scheiding (bij valuta en korting) wordt als scheiding een punt gebruikt.
Verplicht of Optioneel
In de berichtdefinitie is aangegeven of een veld Verplicht of Optioneel is, dit wordt aangeduid door opname van een V of O in kolom V/O.
Format
In de berichtdefinitie is aangegeven wat het format van een veld is, dit wordt als volgt aangeduid:
| Mogelijke waarde | Toelichting |
|---|---|
| N | Numeriek |
| AN | Alfanumeriek |
Levering van het bericht
Het bericht wordt dagelijks 7 heer per dag op vaste tijdstippen in de out map van het FTP account geplaatst.
De inhoud van het bericht is een momentopname van de situatie op het moment van aanmaken van het bericht. Het kan voorkomen dat door een grote vraag een artikel alsnog niet beschikbaar is voor 24-uurslevering op het moment van klaarmaken van de zending. In dat geval zal de order op een later moment nog geproduceerd worden, in sommige gevallen kan dit dan leiden tot een levering binnen 48 uur. Terugkoppeling hierover wordt gegeven in de berichttypen UITOPD, uitgevoerde opdrachten, of NUITOP, niet of niet tijdig uitgevoerde opdrachten.
Gedurende de dag vindt er herbevoorrading plaats van de magazijnen om de hierboven beschreven situatie zoveel mogelijk te voorkomen.
Berichttype, bestandsnaam en extensie
| Berichttype | BHDART |
| Bestandsnaam | prefix relatie nummer u 4-cijferige codering datum notatie yyyymmdd |
| Extensie | .bhd (kleine letters) |
Berichtdefinitie
Header informatie
Partij specificatie afzender
Partij specificatie ontvanger
Informatie artikelbeschikbaarheid
Footer informatie
| Headerinformatie | ||||||
|---|---|---|---|---|---|---|
| CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 0 | Recordtype |
0002 | Bericht_type | V | AN | 6 | BHDART | Berichttype |
0003 | Versie_nr | V | AN | 5 | 0608 | Versie van het bericht |
0004 | Verzend_dat | V | N | 8 | yyyymmdd | Datum van verzenden |
0005 | Verzend_tijd | V | N | 4 | uu24mm | Tijdstip van verzenden |
0006 | Bericht_referentie | V | AN | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. | |
0007 | Acknowledgement_ind | V | N | 1 | 0 | Verzendbevestiging t.b.v. controle CB |
0008 | Test_ind | V | N | 1 | 0 | Geeft aan of het om een testbericht gaat, altijd waarde 0. Testen wordt niet op de productieomgeving gedaan. |
| Partijspecificatie - Bij communicatie betrokken partijen | ||||||
| CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 1 | Recordtype |
0009 | Partij_type | V | AN | 4 | AFZ | De afzender van het bericht |
0010 | Partij_id | V | N | 13 | 8894126 | Het relatie id wat bij CB is vastgelegd |
0011 | Partij_id_type | V | AN | 3 | CB | |
| CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 1 | Recordtype |
0009 | Partij_type | V | AN | 4 | ONTV | De ontvanger van het bericht |
0010 | Partij_id | V | N | 13 | Het relatie id wat bij CB is vastgelegd | |
0011 | Partij_id_type | V | A | 3 | CB | Het type van de betrokken partij |
| Informatie artikelbeschikbaarheid | ||||||
| CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 2 | Recordtype |
0200 | EAN_artikel_kd | V | N | 13 | Het EAN of ISBN van het artikel. | |
0500 | Peil_dat | O | N | 8 | yyyymmdd | Datum van bepalen voorraadstand |
0281 | Mutatie_dat | O | N | 8 | yyyymmdd | Datum waarop een mutatie heeft plaatsgevonden |
0521 | Top_titel_ind | V | N | 1 | Een indicatie ten behoeve van de logistieke verwerking bij CB, betreft een locatie in het magazijn | |
Unable to render {include} The included page could not be found. | Aant_beschikbaar_24h | V | N | 6 | Aantal exemplaren beschikbaar voor 24-uurslevering. Dit aantal heeft een maximum van 698 expl. Dus zijn er meer dan 698 exemplaren op voorraad dan wordt er een waarde van 698 getoond. | |
| Footerinformatie | ||||||
| CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 9 | Recordtype |
0015 | Aant_detail_2 | V | N | 6 | Totaal aantal regels van recordtype 2 in dit bericht | |
0006 | Bericht_referentie | V | AN | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. | |
#00010#0002BHDART#00030608#000420161219#00050458#000624160030#00070#00080 #00011#0009AFZ#00108894126#0011CB #00011#0009ONTV#00109999999#0011CB #00012#02009789881892331#028120150420#0521N#052219 #00012#02009789881961037#028120150420#0521N#05228 #00012#02009789881961082#028120150420#0521N#052210 #00012#02009789889978792#028120160509#0521N#052214 #00012#02009789944833820#028120150420#0521N#0522135 #00012#02009789944833844#028120150420#0521N#05222 #00012#02009789944835596#028120150703#0521N#05225 #00012#02009789990413052#028120150420#0521N#05226 #00012#02009789990418620#028120150420#0521N#052218 #00012#02009789990419559#028120161026#0521N#05228 #00012#02009789990460742#028120161210#0521N#052227 #00012#02009789990463088#028120160310#0521N#052263 #00012#02009789990463446#028120160318#0521N#05225 #00012#02009789995790004#028120161129#0521N#0522177 #00012#02009791092599053#028120160416#0521N#05221 #00019#001515#000624160030