Skip to main content
Toimituslaskennan API:n avulla oman verkkokauppasi kassa voi näyttää asiakkaillesi Zippendossa määrittämäsi toimitusvaihtoehdot ja hinnat. Lähetät ostoskorin ja toimitusosoitteen, ja Zippendo vastaa yhdellä hinnalla jokaisesta toimitussäännöstäsi, joka sopii kyseiseen ostoskoriin.

Milloin sitä käytetään

  • Mukautettu tai headless-verkkokauppa, jolla on oma kassa
  • Sovellus, joka tarvitsee toimitushinnat ennen lähetyksen luomista
  • Kassa, jossa yksi kiinteä hinta ei riitä
Shopify ja WooCommerce eivät tarvitse tätä API:a: Zippendo tarjoaa niiden kassahinnat puolestasi. Katso Toimitushinnat. Käytä API:a, kun oma kassasi tarvitsee hinnat.

Pyyntö

Lähetä ostoskori ja määränpää osoitteeseen POST /orgs/{orgId}/shipping-quote:
price on yksikköhinta pienimmässä valuuttayksikössä (øre DKK:lle, sentti EUR:lle), ja grams on yksikön paino. Lisää totalPriceCents ostoskorin alennusten jälkeisellä loppusummalla, jos toimitussääntösi katsovat tilauksen arvoa.

Vastaus

Zippendo tarkistaa jokaisen toimitussäännön, jonka Vastaanottajamaat sisältävät destination.country-arvon. Jokaisesta säännöstä, jonka Säännön ehdot sopivat ostoskoriin, tulee yksi hinta, joka nimetään säännön mukaan ja hinnoitellaan sopivan ehdon mukaan (alhaisin hinta, jos useampi sopii). totalPrice on pienimmässä valuuttayksikössä merkkijonona. Kun mikään sääntö ei sovi, saat { "rates": [] }, joten näytä kassalla tällöin varavaihtoehto. Täydellinen kenttäluettelo on sivulla Toimitushinnat ja API-viitteessä.

Vaatimukset

  • Vähintään yksi yhdistetty kuljetusyhtiö
  • Vähintään yksi toimitussääntö maille, joihin lähetät. Säännöt päättävät, mitkä hinnat näkyvät ja mitä ne maksavat.
  • API-token, jolla on oikeus read:shipping_rules. Katso REST API -pikaopas.

Seuraavat vaiheet

Toimitussäännöt

Valitse, mitkä kuljetuspalvelut tarjotaan painon, arvon ja maan mukaan.

API-viite

Täydelliset pyynnön ja vastauksen tiedot, leikkikentän kanssa.