> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Versandpreis abfragen
> Zeige im Checkout Live-Versandpreise aus deinen Versandregeln - Versandpreise im Checkout bei Shopify, der Checkout-Token für WooCommerce und die Versandpreis-API für deinen eigenen Shop.
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](/docs/de/how-to/shipping-rule-fields). 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](/docs/de/tutorials/checkout). Es werden keine Preise angezeigt: [Versandpreisabfrage liefert keine Preise](/docs/de/knowledge-base/shipping-quote-no-rates).
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
Verbinde Shopify oder WooCommerce unter **Verkaufskanäle**. Für deinen eigenen Shop erstellst du einen [API-Token](/docs/de/how-to/create-an-api-token) mit **Versandregeln ansehen**.
Siehe [Zugangsdaten des Versanddienstleisters](/docs/de/how-to/carrier-credentials). Jede Versandregel nutzt ein Versandprodukt eines verbundenen Versanddienstleisters.
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](/docs/de/how-to/shipping-rule-fields).
## 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](/docs/de/how-to/shopify-settings). Die App installieren: [Shopify verbinden](/docs/de/tutorials/connect-shopify).
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](/docs/de/how-to/drop-point-and-service-points).
### 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-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](/docs/de/how-to/shopify-settings).
## 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](/docs/de/how-to/connect-woocommerce).
Ö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.
## 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](/docs/de/how-to/create-an-api-token). Fertige Clients: [SDKs](/docs/de/sdks/overview). Probiere es in der [API-Referenz](/docs/api-reference/overview) 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. |
```json theme={null}
{
"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](/docs/de/quickstarts/shipping-quotes).
## 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.
## Siehe auch
* [Checkout](/docs/de/tutorials/checkout): Anleitung
* [Shopify-Einstellungen](/docs/de/how-to/shopify-settings) / [WooCommerce verbinden](/docs/de/how-to/connect-woocommerce)
* [Felder der Versandregel](/docs/de/how-to/shipping-rule-fields)
* [API-Token erstellen](/docs/de/how-to/create-an-api-token)
* [Paketshop auswählen](/docs/de/how-to/pick-a-service-point)
* [Versandpreisabfrage liefert keine Preise](/docs/de/knowledge-base/shipping-quote-no-rates)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.