Connecter Chronopost à votre logiciel métier : services web, modules et retour de projet

Quelles portes d'entrée Chronopost ouvre-t-il à un logiciel ?

Chronopost ouvre trois portes à un logiciel d'entreprise : ses services web, ses modules pour plateformes e-commerce et son outil d'expédition en ligne. Les pages professionnelles de chronopost.fr consultées en octobre 2026 présentent les modules et l'outil en ligne, mais pas d'espace développeurs public : nous n'y avons pas trouvé la documentation des services web en libre accès, et les questions de contrat passent par le service commercial.

Identifiants, offres, étiquettes : ce que couvrent les services web

Faute de documentation développeur trouvée en libre accès, les guides des modules officiels, qui s'appuient sur les services web, décrivent le mieux ce qu'un programme peut demander à Chronopost : c'est le cas du guide WooCommerce (version 4.4.1) et du guide Magento (version 2.4.0).

• Identifiants : le numéro de compte est le numéro de contrat Chronopost à 8 chiffres ; un sous-compte facultatif sépare des centres de coûts et il est pris en compte à l'impression des étiquettes ; le mot de passe est le code Chronotrace à 6 chiffres reçu dans l'e-mail de bienvenue. Plusieurs contrats peuvent être déclarés.
• Offres : Chrono 10, Chrono 13 et Chrono 18 en France, avec option samedi ; Chrono Classic et Chrono Express à l'international ; Chrono Relais, Relais Europe et Relais DOM ; 2Shop Direct et 2Shop Europe ; Chrono Sameday ; Chrono Precise, livré sur un créneau de 2 heures.
• Étiquettes : un fichier PDF, sans impression directe, en trois formats (laser avec preuve de dépôt, laser sans preuve de dépôt, imprimante thermique) ; réédition et annulation possibles.
• Tarifs : la fonction QuickCost interroge le contrat pour récupérer les prix ; le guide Magento précise qu'elle ne tient pas compte des options et suppléments.
• Points relais : recherche autour de l'adresse de l'acheteur ; le module Magento affiche la liste des cinq relais les plus proches de l'adresse saisie, avec une carte OpenStreetMap activable.
• Suivi : dans le module Magento, une tâche tourne toutes les heures sur les commandes des 30 derniers jours pour repérer les colis livrés ; dans WooCommerce, la commande passe à « terminée » quand les services web voient le colis livré.

Ce que nous avons appris en branchant Chronopost pour APARO

YMHB Web a intégré les services web Chronopost à la boutique de pièces Peugeot Motocycles d'APARO, distributeur de pièces détachées d'origine pour deux-roues. Trois services tournent en production : Chrono 13H, Chrono Relais 13H et Chrono Classic. L'acheteur choisit son point relais pendant la commande, l'étiquette se génère en un clic, sans ressaisie, le suivi part seul chez le client, et le port est calculé sur le poids réel.

L'étape qui surprend le plus une entreprise est la recette du transporteur. Avant toute expédition réelle, des étiquettes d'essai ont été soumises à Chronopost pour chacun des trois services, et les identifiants de production n'ont été activés qu'après son feu vert. Ce contrôle se fait au rythme du transporteur : il figure au planning dès le cadrage.

Deuxième enseignement : un tarif juste exige un poids juste. Une fiche article sans poids fausse le prix affiché au panier comme le prix facturé ensuite.

Cinq flux entre votre logiciel et Chronopost, étape par étape

1. De la commande validée à la lettre de transport. Une PME de consommables d'atelier valide la commande dans sa gestion. Le service d'intégration transmet destinataire, poids et offre (par exemple Chrono 13), reçoit le numéro de lettre de transport et le PDF, puis envoie l'étiquette à l'imprimante thermique du poste d'emballage.
2. Du panier au point relais. L'adresse saisie sur le site déclenche une recherche des relais proches ; l'identifiant du relais retenu suit la commande jusqu'à l'étiquette Chrono Relais.
3. Du suivi à la clôture. Une tâche planifiée relit le statut des colis en cours. Dès que Chronopost voit un colis livré, la commande passe à « livrée » et la confirmation part au client, sans recherche manuelle sur le site du transporteur.
4. Du retour accepté à l'étiquette retour. Le SAV accepte un retour : le logiciel crée la lettre de retour et l'adresse au client. Selon le guide WooCommerce de Chronopost, l'étiquette retour du module part avec un poids nul et le retour est facturé au poids réel pesé en agence : prévoyez-le dans le coût de vos retours.
5. De la fin de journée au chauffeur. Avant le passage du chauffeur, l'entrepôt imprime le bordereau de fin de journée, en deux exemplaires signés selon le guide Magento, dont l'un est remis lors de l'enlèvement ou du dépôt.

Contrat de test, recette, production : le calendrier à prévoir

Une intégration Chronopost démarre sur un contrat de test, mais ne peut pas expédier avec. Les guides des modules indiquent qu'un contrat de test est préconfiguré, que l'édition de lettres de transport valides suppose un contrat avec Chronopost, et, pour Magento, que QuickCost ne fonctionne pas avec ce contrat de test. Comptez donc cinq temps :

1. Rassembler le numéro de contrat, les sous-comptes éventuels et le code Chronotrace.
2. Lister les offres réellement vendues : inutile de développer Chrono Precise si aucun client ne l'achète.
3. Construire les flux un par un sur le contrat de test, en journalisant chaque appel et chaque réponse.
4. Faire contrôler par Chronopost les étiquettes de chaque service, puis obtenir l'ouverture des accès de production.
5. Basculer, puis surveiller de près les premiers jours d'envoi.

Les pièges propres à une intégration Chronopost

• L'annulation tardive : le guide Magento est explicite, une lettre de transport ne s'annule plus une fois l'enlèvement effectué. Le logiciel bloque donc une seconde édition pour la même commande et propose la réédition.
• L'écart de frais de port : QuickCost ignore options et suppléments. Prévoyez une marge (le module WooCommerce l'accepte en euros ou en pourcentage) ou une grille issue du contrat.
• L'assurance : le module ne calcule ni ne répercute le coût de l'assurance ad valorem ; si vous la vendez, la règle se code dans votre logiciel.
• Le code Chronotrace : il donne accès au contrat. Il se range dans un coffre de secrets, jamais dans le code source.
• La reprise : si Chronopost ne répond pas, la demande attend dans une file et repart seule, avec une alerte si l'attente dure.
• Les données des destinataires : n'envoyez que les champs utiles à la livraison et fixez une durée de conservation des journaux, comme le détaille notre guide RGPD et logiciel métier.

Module officiel, plateforme ou développement : que choisir ?

Le module officiel suffit quand la boutique tourne sur Magento, PrestaShop, WooCommerce ou Shopify et que les colis se préparent depuis son administration. Il se télécharge depuis chronopost.fr (depuis l'App Store Shopify pour Shopify), et Chronopost indique continuer à maintenir et enrichir les versions récentes ; les anciennes versions restent proposées, mais sans support.

Un développement devient pertinent quand les commandes naissent dans un logiciel métier ou un ERP sans module, quand plusieurs sites partagent un contrat découpé en sous-comptes, ou quand l'étiquette doit sortir au poste d'emballage plutôt que dans l'administration du site. Si vous combinez l'express de Chronopost avec l'économique de Colissimo, comparez avant de coder deux connexions séparées : une plateforme multi-transporteurs comme Sendcloud peut en remplacer une partie, à condition que vos services Chronopost figurent à son catalogue.

Ce que YMHB Web livre à la fin d'une intégration Chronopost

Nous construisons l'intégration comme un service à part, par exemple en Node.js, avec une base PostgreSQL qui garde pour chaque commande son numéro de lettre de transport, ses appels et ses réponses. Le contrat, les sous-comptes et le code Chronotrace restent au nom de votre entreprise ; le code est déposé chez vous et vous appartient au paiement intégral.

Vous recevez une documentation des flux, de la recette Chronopost et de la procédure en cas de panne, plus un écran des envois en erreur. Le cadrage précède le chiffrage, comme pour toutes nos intégrations entre logiciels, avec un but : que plus personne ne recopie une adresse d'un écran à l'autre (voir éliminer les doubles saisies).