Versandpreis abfragen

Mit einer Versandpreisabfrage kann dein Onlineshop deinen Kunden im Checkout Live-Versandpreise anzeigen, basierend auf deinen Versandregeln. Zippendo hostet keinen eigenen Checkout: Die Preise erscheinen in deinem Onlineshop, über Zippendo Shipping von Shopify, das Plugin Zippendo for WooCommerce oder einen Aufruf der Versandpreis-API aus deinem eigenen Shop. Jeder Preis, den dein Kunde sieht, stammt aus einer deiner Versandregeln. Ohne eine Versandregel für ausgehende Sendungen in das Land des Kunden zeigt der Checkout keine Zippendo-Preise. Schritt-für-Schritt-Anleitung (Onlineshop verbinden, Regeln wählen, im Shop testen): Checkout. Es werden keine Preise angezeigt: Versandpreisabfrage liefert keine Preise.

Die Schaltfläche Testen bei einer Versandregel prüft, ob die Regel zu einem Warenkorb passen würde. Sie fragt den Versanddienstleister nicht nach einem Preis. Zippendo hat keine Vorschau deines Checkouts.

Was du zuerst brauchst

Onlineshop verbinden oder einen API-Token erstellen

Verbinde Shopify oder WooCommerce unter Verkaufskanäle. Für deinen eigenen Shop erstellst du einen API-Token mit Versandregeln ansehen.

Deine Versanddienstleister verbinden

Siehe Zugangsdaten des Versanddienstleisters. Jede Versandregel nutzt ein Versandprodukt eines verbundenen Versanddienstleisters.

Versandregeln für ausgehende Sendungen hinzufügen

Benenne jede Regel so, wie deine Kunden sie im Checkout lesen sollen. Lege die Länder fest, in die sie versendet, und eventuelle Preis- oder Gewichtsgrenzen. Siehe Felder der Versandregel.

Liste der Versandregeln mit ausgehenden Regeln für GLS und PostNord — Deine Versandregeln sind die Versandoptionen, die der Checkout anzeigt

Shopify: Versandpreise im Checkout

Öffne deinen Shopify-Verkaufskanal unter Verkaufskanäle. Scrolle auf dem Tab Bestellungen & Checkout zu Versandpreise im Checkout. Alle Shopify-Einstellungen: Shopify-Einstellungen. Die App installieren: Shopify verbinden. Die Karte sagt: Wähle, welche Versandregeln deine Kunden im Shopify-Checkout auswählen können. Wählst du keine, wird jede Versandregel genutzt, die zum Land des Empfängers passt. Eine Versandregel mit Zustellung an Paketshops zeigt jeden Paketshop als eigenen Versandpreis.

Feld	Was du tun kannst
Versandregeln	Hake die Regeln an, die Shopify anbieten soll. Jede Zeile zeigt den Namen der Regel, ihren Versanddienstleister und ihre Länder sowie ihre Beschreibung. Gibt es noch keine Regeln, sagt die Karte Noch keine Versandregeln. Erstelle eine im Menü unter „Versandregeln“.
Paketshops im Checkout	Wie viele Paketshops der Checkout insgesamt anzeigt. Sie werden gleichmäßig auf die Versandregeln mit Zustellung an Paketshops aufgeteilt. Eine Zahl von 1 bis 20. Der Standardwert ist 6.
Änderungen speichern	Speichert deine Auswahl. Die Schaltfläche ist ausgegraut, bis du etwas änderst.

Mehr zu Paketshops im Checkout: Paketshops.

Versandpreise im Checkout mit Kontrollkästchen für Versandregeln und Paketshops im Checkout auf 6 — Versandpreise im Checkout: Hake die Regeln an, die Shopify anbieten soll, und lege Paketshops im Checkout fest

Zippendo Shipping bei Shopify registrieren

Öffne den Tab Verbindung & Integration. Auf der Karte Versandpreis-Dienst:

Bedienelement	Was es bewirkt
Versandpreis-Dienst prüfen → Status prüfen	Prüft, ob Zippendo bei Shopify für Live-Versandpreise registriert ist. Du siehst „1 Versandpreis-Dienst gefunden“ oder Kein Versandpreis-Dienst registriert. Im Checkout werden keine Versandpreise angezeigt.
Versandpreis-Dienst registrieren	Registriert Zippendo bei Shopify oder registriert es erneut. Nötig für Live-Versandpreise im Checkout.

Die Karte erinnert dich auch: Geh nach dem Registrieren zu Shopify admin → Settings → Shipping and delivery und füge in deinen Versandzonen „Zippendo Shipping“ als Anbieter für Versandpreise hinzu.

Solange Zippendo Shipping in Shopify nicht zu deinen Versandzonen hinzugefügt ist, sehen deine Kunden keine Zippendo-Preise, auch wenn Status prüfen den Versandpreis-Dienst findet und deine Regeln angehakt sind.

Shopify-Tab Verbindung & Integration mit der Karte Versandpreis-Dienst, Status prüfen und Versandpreis-Dienst registrieren — Versandpreis-Dienst: Status prüfen und Versandpreis-Dienst registrieren

Shopify-Shops ohne berechnete Versandpreise können stattdessen die Namen ihrer eigenen Shopify-Versandarten mit Versandregeln verknüpfen. Das zeigt keine Live-Preise, sondern setzt nur beim Import die richtige Regel auf jede Bestellung. Siehe die Zuordnung der Versandarten unter Shopify-Einstellungen.

WooCommerce: Checkout-Token

WooCommerce zeigt Live-Preise über das Plugin Zippendo for WooCommerce und einen Checkout-Token (er beginnt mit zck_). Verbinde zuerst den Onlineshop: WooCommerce verbinden. Öffne deinen WooCommerce-Verkaufskanal. Suche auf dem Tab Bestellungen & Checkout die Karte Checkout-Token: Das Plugin Zippendo for WooCommerce zeigt Live-Versandpreise und Paketshops in deinem Checkout. Installiere das Plugin und füge diesen Token in seine Einstellungen ein.

Bedienelement	Was es bewirkt
Plugin herunterladen	Lädt das neueste Plugin als `.zip`-Datei herunter, die du in WordPress installierst.
Token generieren	Erstellt deinen ersten Token und zeigt ihn einmal an.
Kopieren	Kopiert den Token. Du siehst Token in die Zwischenablage kopiert.
Token ersetzen	Ersetzt den Token. Zippendo fragt: Checkout-Token ersetzen? Dein aktueller Token funktioniert sofort nicht mehr, und du musst den neuen im Plugin einfügen.
Widerrufen	Schaltet den Token ab. Zippendo fragt: Checkout-Token widerrufen? Das Plugin funktioniert erst wieder, wenn du einen neuen Token generierst. Du siehst dann Checkout-Token widerrufen.

Direkt nach dem Generieren oder Ersetzen des Tokens warnt die Karte: Kopiere diesen Token jetzt. Später kannst du ihn nicht mehr sehen, weil Zippendo keine lesbare Kopie speichert. Füge ihn in die Einstellungen des Plugins in WordPress ein. Sobald ein Token existiert, zeigt die Karte, wann er erstellt wurde. Wenn etwas fehlschlägt, siehst du Der Checkout-Token konnte nicht generiert werden oder Der Checkout-Token konnte nicht widerrufen werden. Das Plugin fragt Zippendo mit diesem Token nach Preisen, sowohl für Versandoptionen als auch für Paketshops in der Nähe, wenn der Kunde die PLZ ändert. Es nutzt keinen API-Token. Verbindung testen auf dem Tab Verbindung prüft nur die WooCommerce-Schlüssel, mit denen Bestellungen importiert werden.

Karte Checkout-Token mit dem Einmal-Hinweis, dem zck_-Token, Kopieren, Widerrufen und Token ersetzen — Checkout-Token: Kopiere den zck_-Token einmal und füge ihn dann im Plugin ein

Dein eigener Shop: die Versandpreis-API

Ein eigener Verkaufskanal sendet Bestellungen an Zippendo, zeigt aber keine Preise in deinem Checkout an. Um Live-Preise in einem Shop zu zeigen, den du selbst baust, rufst du auf:

POST /orgs/{orgId}/shipping-quote
Authorization: Bearer zipp_YOUR_TOKEN

{orgId} ist die ID deiner Organisation, nicht der Name in der Adresszeile der App. Der Token braucht Versandregeln ansehen: API-Token erstellen. Fertige Clients: SDKs. Probiere es in der API-Referenz aus.

Anfragekörper

Feld	Erforderlich	Hinweise
`destination.country`	Ja	Zweistelliger Ländercode (ISO 3166-1 alpha-2), zum Beispiel `DK`
`destination.postalCode`	Nein	Zum Beispiel `1620`
`destination.province`	Nein	Code des Bundesstaats oder der Provinz
`destination.city`	Nein	Zum Beispiel `København`
`destination.address1` / `address2`	Nein	Adresszeilen
`items`	Ja, mindestens eine	Die Zeilen des Warenkorbs
`items[].name`	Ja	Zum Beispiel `Uld trøje`
`items[].quantity`	Ja	Ganze Zahl, 1 oder mehr
`items[].grams`	Ja	Gewicht in Gramm, 0 oder mehr
`items[].price`	Ja	Stückpreis in Cent (øre), 0 oder mehr
`items[].sku` / `productId` / `variantId`	Nein
`currency`	Ja	Dreistelliger Währungscode (ISO 4217), zum Beispiel `DKK`
`totalPriceCents`	Nein	Die Summe des Warenkorbs nach Rabatten, in Cent. Damit nutzen Regeln mit einer Grenze für den Bestellwert die rabattierte Summe.

{
  "destination": {
    "country": "DK",
    "postalCode": "2100",
    "city": "Copenhagen"
  },
  "items": [
    {
      "name": "T-shirt",
      "quantity": 1,
      "grams": 250,
      "price": 29900
    }
  ],
  "currency": "DKK"
}

Zippendo addiert grams × quantity und price × quantity über die Zeilen und prüft dann jede Versandregel, die in destination.country versendet. Jede passende Regel wird zu einem Preis. Passt keine Regel, erhältst du { "rates": [] } mit Status 200, keinen Fehler.

Preisobjekt

Feld	Was es ist
`serviceName`	Der Name der Regel, so wie dein Kunde ihn sehen soll
`serviceCode`	`{carrierSlug}:{productId}:{shippingRuleId}`
`totalPrice`	Versandpreis in Cent, als Zeichenfolge
`currency`	Dreistelliger Währungscode
`description`	Die Beschreibung der Regel, falls sie eine hat
`carrierName` / `carrierSlug` / `productId`	Der Versanddienstleister und das Versandprodukt der Regel
`shippingRuleId`	Die Regel, die den Preis erzeugt hat
`minDeliveryDate` / `maxDeliveryDate`	Voraussichtliche Zustelldaten, falls die Regel sie hat

Ein ungültiges Land oder ein ungültiger Körper liefert 400 mit { error, message }, zum Beispiel Invalid destination country. Eine unbekannte Organisation liefert 404. Beispielcode: Schnellstart Versandpreise.

So testest du

Zippendo hat keine Vorschau deines Checkouts. Teste in deinem Onlineshop:

Onlineshop	In Zippendo	In deinem Onlineshop
Shopify	Hake die Regeln an, lege die Anzahl der Paketshops fest, klicke auf Status prüfen	Gehe durch den Checkout, sobald Zippendo Shipping in deiner Versandzone ist
WooCommerce	Token generieren	Füge den Token in die Einstellungen des Plugins ein und fülle einen Warenkorb
Dein eigener Shop	Testen bei einer Versandregel (prüft nur die Regel)	Rufe die Versandpreis-API mit einem Beispielwarenkorb auf

Fehlt ein Preis, prüfe die Zielländer der Regel, ihre Grenzen für Gewicht und Bestellwert und ihre übrigen Einstellungen, bevor du den Versanddienstleister verdächtigst.

Du bist fertig, wenn bei Shopify Versandpreise im Checkout die gewünschten Regeln enthält (und Zippendo Shipping in deiner Versandzone ist), oder WooCommerce einen aktiven Checkout-Token hat, der im Plugin eingefügt ist, oder die Versandpreis-API für einen Beispielwarenkorb rates liefert.

Überblick

Sendungen

Bestellungen & Verkaufskanäle

Versanddienstleister

Versanddienstleister verbinden

Integration verbinden

Drucken

Automatisierung

Konto

Suche & Dashboard

API & Ereignisse

Versandpreis abfragen

Was du zuerst brauchst

Shopify: Versandpreise im Checkout

Zippendo Shipping bei Shopify registrieren

WooCommerce: Checkout-Token

Dein eigener Shop: die Versandpreis-API

Anfragekörper

Preisobjekt

So testest du

Siehe auch

​Was du zuerst brauchst

​Shopify: Versandpreise im Checkout

​Zippendo Shipping bei Shopify registrieren

​WooCommerce: Checkout-Token

​Dein eigener Shop: die Versandpreis-API

​Anfragekörper

​Preisobjekt

​So testest du

​Siehe auch

Was du zuerst brauchst

Shopify: Versandpreise im Checkout

Zippendo Shipping bei Shopify registrieren

WooCommerce: Checkout-Token

Dein eigener Shop: die Versandpreis-API

Anfragekörper

Preisobjekt

So testest du

Siehe auch