Skip to main content
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 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. Utilisez l’API lorsque votre propre caisse a besoin des prix.

Requête

Envoyez le panier et la destination à POST /orgs/{orgId}/shipping-quote :
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

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 et dans la référence de l’API.

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.

Étapes suivantes

Règles d'expédition

Choisissez quelles offres transporteur sont proposées selon le poids, la valeur et le pays.

Référence de l'API

Détails complets des requêtes et des réponses, avec un playground.