Skip to main content
Mit der Versandpreis-API kann dein eigener Checkout deinen Kunden die Versandoptionen und Preise zeigen, die du in Zippendo eingerichtet hast. Du sendest den Warenkorb und die Lieferadresse; Zippendo antwortet mit einem Preis für jede deiner Versandregeln, die zu diesem Warenkorb passt.

Wann du sie nutzt

  • Ein eigener oder Headless-Onlineshop mit eigenem Checkout
  • Eine App, die Versandpreise braucht, bevor sie eine Sendung erstellt
  • Ein Checkout, bei dem ein Pauschalpreis nicht reicht
Shopify und WooCommerce brauchen diese API nicht: Zippendo liefert ihre Checkout-Preise für dich. Siehe Versandpreise. Nutze die API, wenn dein eigener Checkout die Preise braucht.

Anfrage

Sende den Warenkorb und das Ziel an POST /orgs/{orgId}/shipping-quote:
price ist der Stückpreis in der kleinsten Währungseinheit (øre bei DKK, Cent bei EUR), und grams ist das Stückgewicht. Füge totalPriceCents mit dem Warenkorbwert nach Rabatten hinzu, wenn deine Versandregeln den Bestellwert berücksichtigen.

Antwort

Zippendo prüft jede Versandregel, deren Zielländer destination.country enthalten. Jede Regel, deren Versandbedingungen zum Warenkorb passen, wird zu einem Preis, benannt nach der Regel und bepreist durch die passende Bedingung (den niedrigsten Preis, falls mehrere passen). totalPrice steht in der kleinsten Währungseinheit, als Zeichenkette. Passt keine Regel, erhältst du { "rates": [] }. Zeige in diesem Fall im Checkout eine Ersatzlösung an. Die vollständige Feldliste findest du unter Versandpreise und in der API-Referenz.

Voraussetzungen

  • Mindestens ein verbundener Versanddienstleister
  • Mindestens eine Versandregel für die Länder, in die du versendest. Die Regeln bestimmen, welche Preise erscheinen und was sie kosten.
  • Ein API-Token mit der Berechtigung read:shipping_rules. Siehe die Schnellstartanleitung zur REST-API.

Nächste Schritte

Versandregeln

Lege fest, welche Versandprodukte nach Gewicht, Wert und Land angeboten werden.

API-Referenz

Alle Details zu Anfrage und Antwort, mit Playground.