Zippendo

Développeurs

Une API d'expédition que votre équipe aura vraiment plaisir à utiliser

Une API REST pour les étiquettes, le suivi et les points relais de tous vos transporteurs. Utilisez-la en complément de l'application Zippendo, ou seule lorsque votre système n'a besoin que des connexions transporteurs. Des SDK en sept langages, un webhook signé pour chaque événement, et un serveur MCP pour qu'un agent IA puisse lui aussi réserver un colis.

Lire la documentation
Obtenir un jeton d'API

Du jeton à l'étiquette en quatre étapes.

Créez un jeton, installez un SDK ou utilisez cURL, puis envoyez une expédition par POST. La règle d'expédition que vous indiquez choisit le transporteur et le service. Envoyez l'expédition, et l'étiquette vous revient sous forme de document à imprimer ou à envoyer à Zippendo Printer.

Ouvrir la référence de l'API

  1. Créer un jeton d'API

    Ouvrez les paramètres de l'API dans le tableau de bord. Les jetons commencent par zipp_, ne s'affichent qu'une fois et peuvent être limités à une seule marque.

    Paramètres de l'API

  2. Installez un SDK, ou pas

    npm, pip, Composer, go get, gem, Maven ou NuGet. Chaque SDK est généré à partir de la spécification OpenAPI publique et couvre tous les endpoints. cURL fonctionne tout aussi bien.

    Présentation des SDK

  3. Créer une expédition

    Envoyez le destinataire, les colis et l'id d'une règle d'expédition. La règle fournit le transporteur, le service et l'adresse de l'expéditeur. Envoyez ensuite l'expédition : le transporteur renvoie l'étiquette et le numéro de suivi.

    Les expéditions dans la référence

  4. Écouter les événements

    Faites pointer un webhook vers votre serveur. Chaque livraison est un POST signé en HMAC-SHA256 du corps brut, tenté jusqu'à 5 fois, avec chaque tentative consignée dans le journal de livraison.

    Démarrage rapide des webhooks
curl https://api.zippendo.com/orgs/org_8f3kd92ld0/shipments \  -H "Authorization: Bearer $ZIPPENDO_API_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "reference": "ORDER-1042",    "type": "outbound",    "shippingRuleId": "rule_3c4d5e6f",    "parties": [{      "type": "receiver",      "name": "Anna Jensen",      "address1": "Vesterbrogade 12",      "postalCode": "1620",      "city": "København V",      "countryCode": "DK",      "email": "[email protected]"    }],    "parcels": [{      "weight": 2.5,      "weightUnit": "kg",      "dimensions": { "length": 30, "width": 20, "height": 10 },      "orderLines": []    }]  }'

Chaque erreur comporte un code lisible par machine à côté du message. Un webhook renvoyé conserve le même X-Webhook-Id : ignorer les doublons tient en une seule recherche.

Étiquettes, suivi et points relais, depuis votre propre code.

Lire la documentation

MCP, webhooks et intégrations dans un seul catalogue

Connectez Claude, Cursor ou ChatGPT via OAuth, ou envoyez les événements d'expédition vers Klaviyo, Slack, Zapier et Make sans écrire de code d'intégration.

SDK

7

langages, générés à partir de la spécification

Les événements que vous pouvez écouter

  • order.created
  • shipment.created
  • shipment.dispatched
  • tracking.updated
  • shipment.error

Une requête en entrée, tous les événements en sortie

Créez une expédition avec l'id d'une règle d'expédition, et le transporteur, le service et l'adresse de l'expéditeur sont choisis pour vous. Ensuite, chaque changement arrive sur votre endpoint sous forme de webhook signé.

Un serveur MCP pour les agents

Faites pointer Claude, Cursor ou ChatGPT vers api.zippendo.com/mcp : il crée des expéditions, suit des colis et lit vos commandes avec les autorisations que vous accordez.

Vous n'avez besoin que des transporteurs ?

  • Étiquettes
  • Suivi
  • Points relais
  • Devis d'expédition

Accès à l'API

100%

des offres, Free compris

Nouveaux transporteurs

1 semaine

c'est le délai habituel pour connecter celui dont vous avez besoin

Pour aller plus loin

  • Référence de l'API

    Chaque endpoint, corps de requête et réponse, avec un bac à sable.

    Ouvrir la référence

  • SDK

    TypeScript, Python, PHP, Go, Ruby, Java et C#, générés à partir de la même spécification.

    Choisir un langage

  • Canaux de vente personnalisés

    Votre propre boutique ou ERP comme source de commandes, poussées vers l'API ou récupérées par elle.

    Créer un canal

  • Serveur MCP

    Connectez Claude, Cursor ou ChatGPT à votre compte via OAuth.

    Connecter un agent

Guides

  • Intégration d'API transporteur

    Ce que demande l'intégration directe des transporteurs, et quand une seule API d'expédition est plus simple.

    Lire le guide

  • codes SH

    Trouver le bon code tarifaire pour chaque produit et savoir où l'indiquer sur les documents douaniers.

    Lire le guide