Heeft u nog geen gebruikersnaam en/of wachtwoord? Neem dan contact op met uw accountmanager.
Er kan op 3 manieren worden ingelogd.
https://webservice.kruitbosch.nl/auth(https://webservice.kruitbosch.nl/auth?Provider=KCU&Username=..&Password=..) Er wordt een Sessie ID (token) terug gegeven die 24 uur geldig is, het kan alleen gebeuren dat door updates, aanpassingen en onderhoud dit id eerder komt te vervallen.
CSV Voorbeeld:
https://webservice.kruitbosch.nl/auth/kcu?username=..&password=..&continue=%2fproducts%2fstocks%3fformat%3dcsv
De beschikbare webservices zijn onder het kopje metadata te vinden.
Data is beschikbaar in de volgende formaten;
Voor het ophalen van de voorraad kan de volgende service gebruikt worden;
CSV Voorbeeld:
https://webservice.kruitbosch.nl/products/stocks?format=csv
De voorraad kan ook voor een specifiek aantal producten worden opgevraagd
CSV Voorbeeld:
https://webservice.kruitbosch.nl/products/als10,vls10/stocks?format=csv
bij het ophalen van productinformatie zijn er een aantal aandachtspunten;
Voorbeeld:
https://webservice.kruitbosch.nl/products?ExcludeBlocked=true
Ook voor het toevoegen van de kenmerken in het databestand kan een parameter worden meegegeven: IncludeAttributes=true Standaard staat deze op false.
CSV Voorbeeld:
https://webservice.kruitbosch.nl/products?IncludeAttributes=true&format=csv
Veel artikelen zijn niet geschikt voor webshops. Denk hierbij aan werkplaats verpakkingen, of promotiemateriaal.
Deze zijn in de aanvraag al te filteren door de parameter ConsumerProducts=1 mee te geven.
CSV Voorbeeld:
https://webservice.kruitbosch.nl/products?ConsumerProducts=1&format=csv
De dropshipment webservice is niet beschikbaar in CSV, het heeft de voorkeur om JSON te gebruiken.
Bij het plaatsen van een dropshipmentorder moet de bron, het veld "source" altijd worden gevuld met 1.
Dropshipment is alleen mogelijk naar landen binnen de Europese Unie.
JSON Voorbeeld:
"Source": 1
Bijzonderheden per veld;
CountryCode
In het veld CountryCode dient de 2 letterige ISO code voor het land ingegeven te worden.
DeliveryMode
Voor het veld deliveryCode zijn de opties DHL en DPD verzendmethodes beschikbaar.
DHL
Voor alle zendingen naar landen anders dan Nederland, geldt de opbouw "DFY_S" met daar de 2 letterige ISOCodering van het land.
DFY_SEL is de DeliveryMode voor standaard zendingen naar Nederland. De DeliveryMode DFY_SL 1 t/m 7 zijn voor het gebruik van aanvullende diensten voor zendingen naar Nederland
DFY_SEL Standaard pakket dienst
DFY_SL1 Standaard + Handtekening voor ontvangst
DFY_SL2 Standaard + Niet bij de buren
DFY_SL3 Standaard + Directe avond service
DFY_SL4 Standaard + Handtekening + Niet bij de buren
DFY_SL5 Standaard + Handtekening + Niet bij de buren + Directe avond service
DFY_SL6 Standaard + Handtekening + Directe avond service
DFY_SL7 Standaard + Niet bij de buren + Directe avond service
Binnen de Benelux kunnen zendingen ook worden afgeleverd bij een DHL ParcelShop.
Voor een ParcelShop in Nederland wordt de verzendmethode DFY_PSEL
Voor een ParcelShop in Belgie wordt de verzendmethode DFY_PSBE
Voor een ParcelShop in Luxemburg wordt de verzendmethode DFY_PSLU
Wordt in van deze 3 levermethodes gebruikt, dan wordt het veld DeliveryServicePointID verplicht.
De servicepoint ID's zijn bij DHL op te halen.
Zie hiervoor de DHL site https://api-gw.dhlparcel.nl/docs/ en kies voor Find Service point locations
In het antwoord staat een "harmonisedId", dit Id moet dan gevuld worden als DeliveryServicePointID
Bij het plaatsen van een dropshipmentorder wordt de voorraad van de regels gecontroleerd.
Wanneer er geen voorraad is van 1 van de regels uit de order wordt de volledige order geannuleerd.
De order zal dan opnieuw aangeboden moeten worden zonder de betreffende regel als deze alsnog geplaatst moet worden.
Alleen artikelen van het type IsBike = false kunnen gedropshipped worden.
Wanneer een dropshipmentorder opnieuw wordt uitgeleverd vanwege een mancomelding en/of beschadiging van het product,
wordt het originele ordernummer opnieuw gebruikt met de code '-1' toegevoeging {ordernummer}{-1} als orderreferentie.