Calculer les frais de livraison avec l’API FRED

FRED organise la livraison et calcule ses frais pour chaque devis. Le fabricant déclare ses coûts de production ; il ne saisit pas les frais de port dans sa grille. Le point de départ est l’atelier qui fabrique l’objet, pas l’adresse de votre boutique.

Vous connaissez déjà la destination

Envoyez le pays et le code postal lors du devis. Chaque option contient directement price.shipping_cents, price.total_cents et transit_hours. Vous pouvez afficher une ligne « Livraison » dans votre panier sans demander un second calcul.

La destination arrive plus tard

Après un devis sans code postal, ou si votre client change d’adresse :

curl https://api.fredpod.com/v1/storefront/quotes/est_abc123/shipping \
  -H "X-API-Key: $FRED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: livraison-panier-1042-v2" \
  -d '{"country":"FR","postal_code":"34000"}'

La réponse est un nouveau devis, avec son propre id et les frais de port de chaque fabricant. Conservez ce nouvel identifiant pour commander. Le précédent prix n’est pas modifié. Si la réponse vaut 202, attendez le résultat à poll_url.

Ce que le prix couvre

Les nouveaux tarifs couvrent la livraison à domicile standard. Le calcul utilise le poids estimé de l’objet, une provision d’emballage et l’enveloppe de colis autorisée. L’atelier renseigne ensuite le poids et les dimensions mesurés avant la création de l’étiquette.

Cette version ne propose pas le choix d’un point relais ni d’un service express. Les conditions historiques déjà convenues conservent leurs prix enregistrés.

Sans adresse d’origine complète, destination valable ou service disponible, le transport est indisponible. Affichez ce résultat comme tel : null n’est pas un prix de zéro euro. Aucune commande ne doit être passée avec un total livré inconnu.

Votre application reçoit le suivi du colis dans les webhooks d’expédition. FRED et l’atelier gèrent les étiquettes et la remise au transporteur.