Intégration d'une API transporteur
L'étiquette est un objet métier, pas un PDF du portail
Nous intégrons Chronopost, Colissimo ou Mondial Relay à la préparation de commande. Suivi en désordre, points relais qui expirent, étiquettes jamais dupliquées : le contrat transporteur précède l'API.
- Connecteurs transporteur en production
- étiquette idempotente
- tracking cadré
Qu'est-ce qu'une API transporteur et quand la faire intégrer ?
Une API transporteur permet à votre application de créer un envoi, d'obtenir une étiquette, de suivre le colis et, selon le réseau, de proposer un point relais. Les espaces transporteur tenus à la main tiennent un temps. On fait développer le connecteur quand l'étiquette doit sortir à la validation de commande, quand le statut de livraison doit revenir dans le dossier client, ou quand le choix du relais fait partie du tunnel. Sans ça, logistique et produit s'ignorent, et le SAV répond « on ne sait pas où est le colis ».
Ce qui part sans étiquette ni suivi
Le transporteur expédie. Tant que l'adresse se retape dans son espace, le client n'a pas de suivi et le relais choisi n'est plus le bon.
On recopie les adresses dans l'espace transporteur
La commande pousse l'expédition. L'étiquette sort, le tracking revient. Plus de double saisie le matin en logistique.
Le client demande le suivi, on n'a rien
Les événements de tracking alimentent le dossier. Le SAV lit le même statut que le transporteur.
Le relais choisi n'est plus le bon à l'expédition
Le point relais est une donnée de la commande, revalidée à l'expédition. Un relais fermé se voit avant l'étiquette.
Une étiquette en double, un colis en trop
Idempotence sur la création d'expédition. Un rejeu ne produit pas une seconde étiquette, ni un second enlèvement.
Ce que chaque API transporteur implique concrètement
Chronopost
ExpressUn réseau express. Sans routes inventées : l'intégration se juge sur la création d'expédition, l'étiquette, le tracking. Le cadrage fixe les produits (domicile, relais), les comptes transporteur et le traitement des anomalies. Un espace web Chronopost n'est pas un connecteur.
- Étiquette à la validation
- Tracking dans le dossier
- Anomalies traitées, pas ignorées
Colissimo & La Poste
La PosteColissimo et plus largement La Poste. Utile dès que le volume passe par ce réseau. Le cadrage fixe le contrat, les options (signature, relais) et le retour de statut. « api la poste » est dans le cluster : on reste au besoin d'expédition, sans inventer un catalogue d'API groupe.
- Commande vers étiquette
- Suivi côté client et SAV
- Options cadrées avec le contrat
Mondial Relay
Points relaisLe cas relais : le choix du point fait partie du tunnel, l'identifiant du relais voyage jusqu'à l'expédition. Un relais fermé ou hors zone se gère avant l'étiquette. Sans fiche détaillée : le cadrage confirme l'accès et le parcours de sélection.
- Relais choisi dans le tunnel
- Identifiant porté jusqu'à l'étiquette
- Fermeture de relais gérée
Quatre flux que l'entrepôt et le SAV reconnaissent
Étiquette à la préparation
La commande prête crée l'étiquette une fois. Un double clic ne crée pas un colis en trop.
Tracking dans le compte client
Les événements arrivent dans le désordre. Le statut affiché est recalculé, pas collé.
Relais choisi dans le tunnel
Le point relais a une durée de vie. À l'expédition, on revérifie, on ne réutilise pas un id mort.
Anomalie qui bloque le dossier
Retour, avarie, relais saturé : le dossier logistique s'arrête. Le SAV répond avec un statut, pas une hypothèse.
Entrepôt, SAV, client, finance : l'abstraction multi-carriers
Nous ne « branchons pas Chronopost ». Nous posons une couche transporteur et l'idempotence de l'étiquette.
L'entrepôt arrête de recoller les adresses
La préparation imprime. Le portail transporteur sort du rituel quotidien.
Le SAV répond avec un statut
Le tracking est dans le dossier. Moins de « on va demander au transporteur ».
Le client reçoit le relais qu'il a choisi
Nous revérifions à l'expédition. Un relais fermé est un cas, pas une surprise en tournée.
La finance lit le coût d'expédition
Poids, offre, surcoût : le connecteur les ramène. Le portail n'est plus la seule vérité tarifaire.
Ce que nous avons livré, et qui s'applique ici
Ce qu'une API transporteur force comme méthode
Contrat transporteur
Contrat, codes d'offre, sandbox, qui parle au commercial transporteur.
Livrable : accès API confirméAbstraction multi-carriers
Objet expédition interne, mapping par carrier, champs communs.
Livrable : modèle d'expéditionTracking désordonné
Déduplication, machine d'états, événements en retard.
Livrable : machine de trackingValidité du relais
TTL relais, recontrôle, offre de repli.
Livrable : règle de relaisCe que personne ne vous dit avant de signer
Le contrat transporteur précède l'API
Sans compte, sans offre, pas d'étiquette. Le cadrage confirme l'accès réel et la sandbox, pas une documentation publique. Commencer le connecteur avant le contrat, c'est coder à blanc.
L'étiquette est un objet métier, pas un PDF
Sans idempotence, un retry crée un second envoi. Le numéro de tracking est la clé métier, pas le PDF. L'étiquette se stocke comme un objet, avec son statut, pas comme un fichier jetable.
Le tracking arrive en désordre
Un statut « livré » peut précéder « en tournée » selon le réseau. On déduplique et on relit l'état, on ne suppose pas une séquence.
Le relais a une durée de vie
Un point choisi à J-10 peut être fermé à l'expédition. Revalider n'est pas optionnel : TTL, offre de repli, et un cas métier si le relais a disparu.
Ce que nous mesurons sur un projet transporteur
Intégration d'une API transporteur : vos questions
Trois étapes. D'abord figer le moment d'étiquette (validation, préparation, enlèvement) et les produits (domicile, relais, express). Ensuite construire un connecteur idempotent, qui crée l'expédition, stocke le tracking et traite les événements. Enfin recetter adresse incomplète, relais fermé, anomalie. La difficulté n'est pas d'obtenir un PDF, c'est de ne pas expédier deux fois.
Une étiquette plus un tracking se chiffre bien plus bas qu'un tunnel relais, multi-réseaux, avec notifications client. Le contrat transporteur et les cas d'anomalie pèsent autant que le code. Nous cadrons le périmètre en amont et donnons une estimation ferme.
Oui, et c'est fréquent : express d'un côté, relais de l'autre. Nous posons un modèle interne d'expédition, indépendant du réseau, avant d'atteindre la logistique. Sans cette couche, chaque transporteur duplique le dossier et le SAV.
La catégorie porte l'expédition, pas un WMS. Le stock reste dans votre ERP ou votre outil métier. Le connecteur transporteur consomme une commande à expédier, il ne calcule pas l'inventaire. Si le stock est le sujet, voir la page ERP.
En portant l'identifiant du relais dès le tunnel, en le revalidant à l'expédition, et en traitant la fermeture comme une exception métier (nouveau choix, report, contact). Un relais « au jugé » au moment de l'étiquette est la première cause d'instance.
Le contrat transporteur est-il déjà signé ?
30 minutes pour voir comptes, sandbox, multi-carriers, et ce qu'une étiquette en double coûterait en entrepôt.
Parler de mon projet transporteur