De beschikbare webservices zijn onder het kopje metadata te vinden.

Data is beschikbaar in de volgende formaten;

• CSV
• JSON
• XML
• WEB (browser)

Voor het ophalen van de voorraad kan de volgende service gebruikt worden;

CSV Voorbeeld:
https://webservice.kruitbosch.nl/products/stocks?format=csv

Het veld AvailabilityId geeft de voorraad status van een product weer.

1. voldoende voorraad
2. beperkt voorradig
3. niet voorradig
4. niet meer leverbaar
5. alleen leverbaar op bestelling

Indien het artikel niet voorradig is wordt in de kolom DateAvailable een verwachte, weer beschikbare voorraad datum weergegeven.

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;

Producten

• Afbeelding: er wordt verwezen naar een url, het advies is om de afbeelding op te slaan, de url kan veranderen.
• Adviesprijs:
  het kan voorkomen dat de adviesprijs lager is dan de inkoopprijs, dit komt doordat de adviesprijs per stuk is en de inkoopprijs per verpakkingseenheid is.
  indien er geen adviesprijs is, is deze 0.
• Inkoopprijs: deze is altijd excl. BTW.
• Blocked:
  het veld Blocked geeft aan of een artikel nog leverbaar is (hoeft niet voorradig te zijn), of dat het artikel niet meer leverbaar is.
  Om alleen de actieve producten op te halen kan de volgende parameter worden toegevoegd:

  Voorbeeld:
  https://webservice.kruitbosch.nl/products?ExcludeBlocked=true

  
  
• Inkoopprijs: deze is altijd excl. BTW.
• AvailabilityId: deze is altijd excl. BTW.

Product kenmerken

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

Webshop producten

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

Velden

Bijzonderheden per veld;

CountryCode
In het veld CountryCode dient de 2 letterige ISO code voor het land ingegeven te worden.

NL
BE
DE
etc..

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

DFY_SEL
DFY_SAT
DFY_SBE
DFY_SCZ
DFY_SDE
DFY_SDK
DFY_SEE
DFY_SES
DFY_SFI
DFY_SFR
DFY_SGB
DFY_SHU
DFY_SIE
DFY_SIT
DFY_SL1
DFY_SL2
DFY_SL3
DFY_SL4
DFY_SL5
DFY_SL6
DFY_SL7
DFY_SLT
DFY_SLU
DFY_SPL
DFY_SPT
DFY_SRO
DFY_SSE
DFY_SSK

DeliveryInstruction is een veld waarin een korte opmerking voor het afleveren van de zending gezet kan worden.
Dit kan een aanvulling zijn op het adres, zoals "Unit 38", of "Flat 1B", maar ook een opmerking voor de chauffeur zoals "Onder de carport zetten".

DPD
Voor alle zendingen geldt de opbouw "DPD_D" met daarachter de 2 letterige ISOCodering van het land, naar Nederland is dit bijvoorbeeld "DPD_DNL".
Binnen de Benelux kunnen zendingen ook worden afgeleverd bij een DPD ParcelShop.
Voor een ParcelShop in Nederland wordt de verzendmethode DPD_PDNL
Voor een ParcelShop in Belgie wordt de verzendmethode DPD_PDBE
Voor een ParcelShop in Luxemburg wordt de verzendmethode DPD_PDLU

Wordt 1 van deze 3 levermethodes gebruikt, dan wordt het veld DeliveryServicePointID verplicht.
De servicepoint ID's zijn bij DPD op te halen.
Zie hiervoor de DPD site https://www.dpd.com/nl/nl/support/techniek/ en kies voor Plugins, via deze plugin kan het parcelshop nummer worden opgehaald via een locator

DPD_DAT
DPD_DBE
DPD_DCZ
DPD_DDE
DPD_DDK
DPD_DEE
DPD_DNL
DPD_DES
DPD_DFI
DPD_DFR
DPD_DHU
DPD_DIE
DPD_DIT
DPD_DLT
DPD_DLU
DPD_DPL
DPD_DPT
DPD_DRO
DPD_DSE
DPD_DSK

Orderverwerking

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.