Skip to main content
Met de API voor verzendoffertes kan je eigen checkout je klanten de verzendkeuzes en prijzen tonen die je in Zippendo hebt ingesteld. Je stuurt de winkelwagen en het bezorgadres; Zippendo antwoordt met één tarief voor elk van je verzendregels dat bij die winkelwagen past.

Wanneer gebruik je het

  • Een maatwerk- of headless webshop met een eigen checkout
  • Een app die verzendprijzen nodig heeft voordat er een zending wordt aangemaakt
  • Een checkout waar één vast tarief niet genoeg is
Shopify en WooCommerce hebben deze API niet nodig: Zippendo levert hun checkouttarieven voor je. Zie Verzendoffertes. Gebruik de API wanneer je eigen checkout de prijzen nodig heeft.

Aanvraag

Stuur de winkelwagen en de bestemming naar POST /orgs/{orgId}/shipping-quote:
price is de stukprijs in de kleinste valuta-eenheid (øre voor DKK, cent voor EUR) en grams is het gewicht per stuk. Voeg totalPriceCents toe met het totaal van de winkelwagen na kortingen als je verzendregels naar de bestelwaarde kijken.

Antwoord

Zippendo controleert elke verzendregel waarvan de Bestemmingslanden destination.country bevatten. Elke regel waarvan de Verzendvoorwaarden bij de winkelwagen passen, wordt één tarief, genoemd naar de regel en geprijsd volgens de bijbehorende voorwaarde (de laagste prijs als er meerdere passen). totalPrice staat in de kleinste valuta-eenheid, als tekenreeks. Als er geen regel past, krijg je { "rates": [] }, toon in dat geval dus een alternatief in de checkout. De volledige lijst met velden staat in Verzendoffertes en de API-referentie.

Vereisten

  • Minstens één gekoppelde vervoerder
  • Minstens één verzendregel voor de landen waarnaar je verzendt. De regels bepalen welke tarieven verschijnen en wat ze kosten.
  • Een API-token met het recht read:shipping_rules. Zie de quickstart voor de REST API.

Volgende stappen

Verzendregels

Kies welke verzendproducten worden aangeboden op basis van gewicht, waarde en land.

API-referentie

Alle details van aanvraag en antwoord, met een playground.