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

# Démarrage rapide des devis d'expédition

> Affichez en caisse, dans votre propre boutique en ligne, les prix d'expédition issus de vos règles d'expédition Zippendo, grâce à l'API de devis d'expédition.

L'API de devis d'expédition permet à votre propre caisse d'afficher à vos clients les choix et les prix d'expédition que vous avez configurés dans Zippendo. Vous envoyez le panier et l'adresse de livraison ; Zippendo répond avec un tarif pour chacune de vos [règles d'expédition](/docs/fr/settings/shipping-rules) qui correspond à ce panier.

## Quand l'utiliser

* Une boutique en ligne personnalisée ou headless avec sa propre caisse
* Une application qui a besoin des prix d'expédition avant de créer une expédition
* Une caisse pour laquelle un tarif unique ne suffit pas

Shopify et WooCommerce n'ont pas besoin de cette API : Zippendo fournit lui-même les tarifs à leur caisse. Voir [Devis d'expédition](/docs/fr/how-to/shipping-quotes). Utilisez l'API lorsque **votre propre** caisse a besoin des prix.

## Requête

Envoyez le panier et la destination à `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` est le prix unitaire dans la plus petite unité monétaire (øre pour la DKK, centimes pour l'EUR), et `grams` est le poids unitaire. Ajoutez `totalPriceCents` avec le total du panier après remises si vos règles d'expédition tiennent compte de la valeur de la commande.

## Réponse

```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 vérifie chaque règle d'expédition dont les **Pays de destination** incluent `destination.country`. Chaque règle dont les **Conditions d'expédition** correspondent au panier devient un tarif, nommé d'après la règle et tarifé selon sa condition correspondante (le prix le plus bas, si plusieurs correspondent). `totalPrice` est exprimé dans la plus petite unité monétaire, sous forme de chaîne. Lorsqu'aucune règle ne correspond, vous obtenez `{ "rates": [] }` : prévoyez donc une solution de repli en caisse dans ce cas.

La liste complète des champs figure dans [Devis d'expédition](/docs/fr/how-to/shipping-quotes) et dans la [référence de l'API](/docs/api-reference/overview).

## Prérequis

* Au moins un **transporteur connecté**
* Au moins une **règle d'expédition** pour les pays vers lesquels vous expédiez. Les règles déterminent quels tarifs apparaissent et combien ils coûtent.
* Un **jeton d'API** avec l'autorisation `read:shipping_rules`. Voir le [démarrage rapide de l'API REST](/docs/fr/quickstarts/rest-api).

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Règles d'expédition" icon="route" href="/docs/fr/settings/shipping-rules">
    Choisissez quelles offres transporteur sont proposées selon le poids, la valeur et le pays.
  </Card>

  <Card title="Référence de l'API" icon="code" href="/docs/api-reference/overview">
    Détails complets des requêtes et des réponses, avec un playground.
  </Card>
</CardGroup>


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