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

# Quickstart verzendoffertes

> Toon verzendprijzen uit je Zippendo-verzendregels in de checkout van je eigen webshop met de API voor verzendoffertes.

Met de API voor verzendoffertes kan je eigen checkout je klanten de verzendkeuzes en prijzen tonen die je in Zippendo hebt ingesteld. Je stuurt de winkelwagen en het bezorgadres; Zippendo antwoordt met één tarief voor elk van je [verzendregels](/docs/nl/settings/shipping-rules) dat bij die winkelwagen past.

## Wanneer gebruik je het

* Een maatwerk- of headless webshop met een eigen checkout
* Een app die verzendprijzen nodig heeft voordat er een zending wordt aangemaakt
* Een checkout waar één vast tarief niet genoeg is

Shopify en WooCommerce hebben deze API niet nodig: Zippendo levert hun checkouttarieven voor je. Zie [Verzendoffertes](/docs/nl/how-to/shipping-quotes). Gebruik de API wanneer **je eigen** checkout de prijzen nodig heeft.

## Aanvraag

Stuur de winkelwagen en de bestemming naar `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` is de stukprijs in de kleinste valuta-eenheid (øre voor DKK, cent voor EUR) en `grams` is het gewicht per stuk. Voeg `totalPriceCents` toe met het totaal van de winkelwagen na kortingen als je verzendregels naar de bestelwaarde kijken.

## Antwoord

```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 controleert elke verzendregel waarvan de **Bestemmingslanden** `destination.country` bevatten. Elke regel waarvan de **Verzendvoorwaarden** bij de winkelwagen passen, wordt één tarief, genoemd naar de regel en geprijsd volgens de bijbehorende voorwaarde (de laagste prijs als er meerdere passen). `totalPrice` staat in de kleinste valuta-eenheid, als tekenreeks. Als er geen regel past, krijg je `{ "rates": [] }`, toon in dat geval dus een alternatief in de checkout.

De volledige lijst met velden staat in [Verzendoffertes](/docs/nl/how-to/shipping-quotes) en de [API-referentie](/docs/api-reference/overview).

## Vereisten

* Minstens één **gekoppelde vervoerder**
* Minstens één **verzendregel** voor de landen waarnaar je verzendt. De regels bepalen welke tarieven verschijnen en wat ze kosten.
* Een **API-token** met het recht `read:shipping_rules`. Zie de [quickstart voor de REST API](/docs/nl/quickstarts/rest-api).

## Volgende stappen

<CardGroup cols={2}>
  <Card title="Verzendregels" icon="route" href="/docs/nl/settings/shipping-rules">
    Kies welke verzendproducten worden aangeboden op basis van gewicht, waarde en land.
  </Card>

  <Card title="API-referentie" icon="code" href="/docs/api-reference/overview">
    Alle details van aanvraag en antwoord, met een playground.
  </Card>
</CardGroup>


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