> ## 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.

# Schnellstart: Versandpreise

> Zeige Versandpreise aus deinen Zippendo-Versandregeln im Checkout deines eigenen Onlineshops an, mit der Versandpreis-API.

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](/docs/de/settings/shipping-rules), 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](/docs/de/how-to/shipping-quotes). Nutze die API, wenn **dein eigener** Checkout die Preise braucht.

## Anfrage

Sende den Warenkorb und das Ziel an `POST /orgs/{orgId}/shipping-quote`:

```bash theme={null}
curl -X POST https://api.zippendo.com/orgs/{orgId}/shipping-quote \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": {
      "country": "DK",
      "postalCode": "2100",
      "city": "Copenhagen"
    },
    "items": [
      {
        "name": "T-shirt",
        "quantity": 1,
        "grams": 250,
        "price": 29900
      }
    ],
    "currency": "DKK"
  }'
```

`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

```json theme={null}
{
  "rates": [
    {
      "serviceName": "Standard DK",
      "serviceCode": "postnord:PNL13:rule_01HZX9K2QF",
      "totalPrice": "3900",
      "currency": "DKK",
      "carrierName": "PostNord",
      "carrierSlug": "postnord",
      "productId": "PNL13",
      "shippingRuleId": "rule_01HZX9K2QF"
    }
  ]
}
```

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](/docs/de/how-to/shipping-quotes) und in der [API-Referenz](/docs/api-reference/overview).

## 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](/docs/de/quickstarts/rest-api).

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Versandregeln" icon="route" href="/docs/de/settings/shipping-rules">
    Lege fest, welche Versandprodukte nach Gewicht, Wert und Land angeboten werden.
  </Card>

  <Card title="API-Referenz" icon="code" href="/docs/api-reference/overview">
    Alle Details zu Anfrage und Antwort, mit Playground.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.