Intégration API Chronopost
Nous développons votre connecteur Chronopost
Nous connectons votre ERP ou votre boutique aux web services Chronopost pour éditer l'étiquette au packing, coller le skybill sur la commande et ramener le suivi dans le dossier, sans Excel ni espace client.
- Équipe produit senior
- connecteurs transporteurs en production
- du cadrage au monitoring
À quoi sert l'API Chronopost et pourquoi l'intégrer dans un logiciel métier ?
Chronopost est le transporteur express du groupe La Poste pour les envois express en France et à l'international. Son API permet à votre application de créer un colis, générer l'étiquette d'expédition et suivre la livraison directement depuis votre logiciel. On l'intègre pour sortir l'étiquette de l'espace client Chronopost et la générer automatiquement à l'expédition, coller le numéro de suivi sur la commande ou le dossier client, et afficher le statut de livraison en temps réel sans que l'équipe consulte le portail manuellement.
Ce que nos clients construisent sur l'API Chronopost
Étiquette au packing
La commande passe en préparation, shippingV7 crée le colis, le skybill est collé sur le BL. L'entrepôt imprime, il ne recopie plus l'adresse.
Tarif et délai avant validation
quickCostV3 et calculateDeliveryTime alimentent le checkout. Chrono 10, 13, 18 ou Relais cessent d'être un menu décoratif.
SAV avec preuve de livraison
Le dernier événement trackSkybillV2 s'affiche dans le ticket. searchPOD attache la POD au dossier, plus un e-mail du transporteur.
Enlèvement du soir depuis le WMS
Une fois le dernier carton pesé, creerEnlevementNational part. Plus de formulaire web pour un entrepôt qui expédie tous les jours.
Ce que ça change dans votre logistique
La technique au service d'un résultat mesurable : l'étiquette au packing, le suivi dans le dossier, zéro double colis.
L'étiquette sort du métier
Plus de PDF téléchargé à la main dans l'espace client. Le skybill est une donnée de la commande, imprimée au bon moment.
Le support lit le même statut
Le suivi vit dans l'ERP. On arrête d'ouvrir Chronotrace pour répondre « où est le colis ».
Un timeout ne crée pas deux colis
Le skybill est persisté avant de marquer la commande expédiée. Un rejeu relit la table, il n'appelle pas shippingV7 une seconde fois.
Le contrat existant suffit
Chronopost est souvent déjà le transporteur du client. L'intégration n'ajoute pas un réseau, elle enlève Excel.
Comment nous livrons votre connecteur Chronopost
Cadrage
Quels produits (Chrono 10, 13, 18, Relais), mono ou multi-colis, enlèvement, retours. On fige les opérations SOAP avant de générer le client.
Développement
Client SOAP régénéré depuis les WSDL live, opérations figées (shippingV7, trackSkybillV2, quickCostV3), table d'idempotence, file d'impression découplée.
Recette
Jeux d'adresses accentuées, timeout rejoué sans second colis, étiquette PDF ou ZPL selon le contrat, suivi borné sur colis ouverts.
Monitoring
Alertes sur échec SOAP, file morte inspectable, job de suivi limité aux colis non livrés. Vous voyez un WSDL cassé avant l'entrepôt.
Ce que permet l'API Chronopost
- Expédition et étiquette
- shippingV7 crée le colis, shippingMultiParcelV7 gère les commandes éclatées. L'étiquette PDF ou ZPL sort ensuite, sans recréer le skybill.
- Suivi et preuve de livraison
- trackSkybillV2 interroge le colis, searchPOD ramène la POD. Pas de webhook : un job borné, pas un scan de tout l'historique.
- Tarif et délai au checkout
- quickCostV3 et calculateDeliveryTime affichent un prix et une date avant validation, sur le contrat réel, pas sur une grille figée.
- Enlèvement sur demande
- faisabiliteESD puis creerEnlevementNational : un flux séparé du shipping, avec contraintes d'agence. Les mélanger est une erreur de métier.
Le vocabulaire de l'API Chronopost
- skybillNumber
- Numéro de colis Chronopost. C'est la clé à persister avant de marquer la commande expédiée : sans lui en base, un timeout suivi d'un rejeu crée un second colis.
- shippingV7
- Opération SOAP courante de création d'expédition. Le WSDL conserve shipping, shippingV2 jusqu'à shippingV6 : appeler « la dernière du fichier » sans la figer est un piège de bibliothèque.
- reservationNumber
- Identifiant de réservation d'étiquette, à stocker avec le skybill. Il sert à récupérer le document sans relancer la création.
- ESD
- Enlèvement sur demande. faisabiliteESD puis creerEnlevementNational, avec contraintes d'agence (hla, hlp, codeAgence). Ce n'est pas un paramètre de shippingV7.
- Chronotrace
- Espace de suivi et source du mot de passe d'API, obtenu auprès du commercial. Sans contrat ni mot de passe Chronotrace, le WSDL répond mais n'expédie rien.
- quickCostV3
- Opération de tarif au contrat. Couplée à calculateDeliveryTime, elle rend le choix Chrono 10 / 13 / 18 / Relais réellement chiffré dans le tunnel.
Les contraintes réelles de l'API Chronopost
Pas d'idempotence documentée
Relancer shippingV7 après un timeout crée un second colis. La clé est à vous : persister skybillNumber avant de considérer l'appel réussi, et n'appeler l'opération qu'une fois par commande.
Pas de REST public ni de webhook
L'intégration native passe par les WSDL. Le suivi s'interroge (trackSkybillV2) ou se lit dans Chronotrace. Un connecteur « transporteur générique » qui attend du JSON signé produit des suivis muets.
Le versionnage est dans le nom
Sept versions de shipping* coexistent dans un seul WSDL. Une lib générée en 2022 peut appeler une opération encore listée mais périmée. On régénère depuis le WSDL live, et on fige V7.
Les quotas ne sont pas publiés
Rien de chiffré n'est affiché sur chronopost.fr. Recette, sandbox et débit se négocient avec le commercial. Un devis qui commence par « on prend une clé d'API » est faux.
Chronopost ou Colissimo pour vos expéditions ?
Deux réseaux La Poste, deux contrats d'API. L'express d'un côté, la densité domicile et relais de l'autre. Le bon dépend du délai que vous vendez.
| Critère | ChronopostCette page | ColissimoDensité La Poste |
|---|---|---|
| Protocole | SOAP uniquement, WSDL publics | SOAP et REST v2, même contrat SLS |
| Réseau | Express Chrono 10 / 13 / 18 / Relais | Domicile, bureau, consigne, relais |
| Étiquette | shippingV7 puis getSkybill | generateLabel : préavis et PDF ensemble |
| Validation sans colis | Aucune méthode équivalente documentée | checkGenerateLabel, sans numéro ni pdfUrl |
| Suivi temps réel | Interrogation, pas de webhook documenté | WS de suivi côté espace entreprise |
| Idempotence | À construire dans votre base | À construire dans votre base |
| Le bon cas | Express B2B, délai vendu au checkout | Checkout France à densité, retours BAL |
Les deux se combinent derrière une abstraction interne (créer, suivre, annuler). Chronopost et Colissimo n'ont pas le même contrat d'erreur. C'est un arbitrage de cadrage, pas un choix définitif.
Ce que nous mesurons sur une intégration Chronopost
Les autres API transporteurs
Si l'express n'est pas le produit que vous vendez, ces options se discutent au cadrage.
ChronopostNous développons votre connecteur ChronopostCette page
Colissimo & La PosteDensité France : domicile, relais, consigne, retours boîte aux lettres.
Mondial RelayPoints relais et Dual Carrier, y compris les flux partenaires transfrontaliers.On combine Chronopost avec
La stack qui entoure Chronopost sur nos projets.
Intégration Chronopost : vos questions
Trois étapes. Obtenir le numéro de contrat et le mot de passe Chronotrace auprès du commercial : sans ça, les WSDL répondent mais n'expédient rien. Générer un client SOAP depuis les WSDL live (shipping, tracking, quickcost) et figer shippingV7, trackSkybillV2 et quickCostV3, plutôt que d'appeler une opération ancienne encore listée. Puis poser une table commande vers skybillNumber, écrite avant de marquer l'expédition, et une file d'impression d'étiquettes découplée de l'appel SOAP. La partie sensible n'est pas le WSDL : c'est l'idempotence, parce qu'un timeout suivi d'un rejeu crée un second colis.
Un premier flux utile, typiquement l'étiquette au packing avec skybill collé sur la commande, se livre en trois à quatre semaines. Une chaîne complète avec tarif au checkout, multi-colis, enlèvement ESD, POD dans le SAV et job de suivi borné demande plutôt six à huit semaines. La durée dépend moins du SOAP que de l'accès au contrat, de l'environnement de recette négocié avec le commercial, et du format d'étiquette (PDF ou ZPL). Nous cadrons le périmètre en amont et donnons une estimation ferme avant de commencer.
Pas de REST public documenté par Chronopost, ni de webhook de suivi sur les WSDL publics. L'intégration native passe par SOAP : ShippingServiceWS, TrackingServiceWS, QuickcostServiceWS. Le suivi se fait par interrogation trackSkybillV2, ou via Chronotrace. Les modules PrestaShop, WooCommerce, Shopify ou Magento sont un raccourci boutique, pas un connecteur ERP. Si votre architecture suppose un JSON signé et une clé d'API self-service, le cadrage doit le dire tout de suite : ce n'est pas le contrat Chronopost.
Chronopost est l'express (Chrono 10, 13, 18, Relais) en SOAP uniquement, avec tarif et délai exposés avant validation. Colissimo est la densité La Poste (domicile, bureau, consigne, relais) avec un contrat SLS unique en SOAP et REST v2, et checkGenerateLabel pour valider sans consommer de numéro. Les deux exigent un contrat, les deux n'offrent pas d'idempotence native. On choisit Chronopost quand le délai vendu est de l'express. On choisit Colissimo quand le checkout doit offrir le réseau le plus dense, y compris les retours boîte aux lettres. Il arrive que la réponse soit les deux, derrière la même abstraction interne.
En ne faisant pas confiance au réseau. shippingV7 n'a pas d'en-tête d'idempotence documenté. Nous persistons skybillNumber et reservationNumber avant de marquer la commande comme expédiée. Un timeout relit cette table, il ne rappelle pas l'opération. L'impression (PDF ou ZPL) est une file à part : un échec d'imprimante réimprime le document stocké, il ne recrée pas le colis. Le job de suivi ne porte que sur les skybills ouverts. C'est la même discipline que pour Colissimo et Mondial Relay, avec un contrat d'erreur différent à chaque fois.
Un projet d'intégration Chronopost ?
Parlons-en. 30 minutes pour cadrer vos flux, vérifier ce que les WSDL permettent vraiment et vous dire franchement ce qui est faisable.
Parler de mon projet Chronopost