Skip to main content
Interfejs API do wycen wysyłki pozwala Twojemu własnemu koszykowi pokazywać klientom opcje dostawy i ceny, które ustawiono w Zippendo. Wysyłasz koszyk i adres dostawy, a Zippendo odpowiada jedną stawką dla każdej Twojej reguły wysyłki, która pasuje do tego koszyka.

Kiedy z niego korzystać

  • Sklep internetowy na zamówienie lub headless z własnym koszykiem
  • Aplikacja, która potrzebuje cen wysyłki, zanim utworzy przesyłkę
  • Koszyk, w którym jedna stała stawka nie wystarcza
Shopify i WooCommerce nie potrzebują tego API: Zippendo podaje ich stawki w koszyku za Ciebie. Zobacz Wyceny wysyłki. Użyj API, gdy ceny są potrzebne Twojemu własnemu koszykowi.

Zapytanie

Wyślij koszyk i miejsce docelowe na POST /orgs/{orgId}/shipping-quote:
price to cena jednostkowa w najmniejszej jednostce waluty (øre dla DKK, centy dla EUR), a grams to waga jednej sztuki. Dodaj totalPriceCents z wartością koszyka po rabatach, jeśli Twoje reguły wysyłki uwzględniają wartość zamówienia.

Odpowiedź

Zippendo sprawdza każdą regułę wysyłki, której Kraje docelowe obejmują destination.country. Każda reguła, której Warunki wysyłki pasują do koszyka, staje się jedną stawką. Nosi nazwę reguły, a cenę wyznacza pasujący warunek (najniższa cena, jeśli pasuje kilka). totalPrice jest podane w najmniejszej jednostce waluty, jako ciąg znaków. Gdy żadna reguła nie pasuje, otrzymasz { "rates": [] }, więc w takim przypadku pokaż w koszyku opcję zastępczą. Pełną listę pól znajdziesz w Wycenach wysyłki i w dokumentacji API.

Wymagania

  • Co najmniej jeden połączony przewoźnik
  • Co najmniej jedna reguła wysyłki dla krajów, do których wysyłasz. Reguły decydują, jakie stawki się pojawią i ile kosztują.
  • Token API z uprawnieniem read:shipping_rules. Zobacz Szybki start z REST API.

Następne kroki

Reguły wysyłki

Wybierz, które produkty przewoźnika są oferowane według wagi, wartości i kraju.

Dokumentacja API

Pełne szczegóły zapytań i odpowiedzi, z piaskownicą do testów.