REST API

Documentatie


Verzendkosten

De verzendkosten en handling van een bestelling zijn afhankelijk van de bestelde producten en het land. Deze hoef je niet zelf te berekenen: je kunt voordat je een bestelling aanmaakt de verzendkosten en handling al opvragen uit de API.

TIP: Je kunt een indicatie vinden van de verzendkosten en handling tarieven in onze productenlijst.

Voorbeeld
Request:
POST /v2/shipping/quote HTTP/1.1
Authorization: Bearer TOKEN
Accept: application/json
Content-Type: application/json

{
    "country": "NL",
    "items": [
        {"productId": "canvas_30x20", "quantity": 5}
    ]
}
Velden met bijzonderheden:
Naam Toelichting
"country" Een ISO 3166-1 alpha 2 landcode
"state" Alleen voor adressen in de V.S.: een ISO 3166-2:US state code
item["productId"] Te vinden in je productenlijst
item["pageCount"] Alleen nodig voor boeken, fotoprints en kaarten

De API-response bevat de kostprijzen voor verzending en handling, exclusief BTW. Indien je het white-label betaalscherm gebruikt, kun je het te betalen bedrag vinden in het veld payment: dit zijn de verzendkosten + handling inclusief BTW, afgerond naar een nette consumentenprijs.

Response:
HTTP/1.1 200 OK                 
Content-Type: application/json;charset=UTF-8
Content-Length: 109

{
    "shipping": 1.38,
    "handling": 0.40,
    "method": "Brief (50 g)",
    "payment": 2.15,
    "taxRate": 0.21
}
Velden met bijzonderheden:
Naam Toelichting
"shipping" De kostprijs voor verzending, exclusief BTW.
"handling" De kostprijs voor handling, exclusief BTW.
"method" De voorkeursmethode van deze zending.
"payment" Het te betalen bedrag in het betaalscherm, inclusief BTW.
Volgende