Intégration API Mondial Relay
Nous développons votre connecteur Mondial Relay
Nous branchons Mondial Relay à votre site ou votre OMS : le client choisit un Point Relais dans votre tunnel, l'étiquette sort à la préparation, le suivi et les retours restent dans votre plateforme.
- Équipe produit senior
- connecteurs transporteurs en production
- du cadrage au monitoring
À quoi sert l'API Mondial Relay et pourquoi l'intégrer dans votre plateforme ?
Mondial Relay est le réseau de livraison en points relais le plus dense en France, Belgique et Espagne. Son API permet à votre application d'afficher les Points Relais, de créer l'expédition, de générer l'étiquette et de suivre le colis jusqu'à la remise. On l'intègre pour que tout cela vive dans votre produit : checkout natif sans widget externe, étiquette créée depuis l'OMS à la préparation, retours lancés depuis l'espace compte et reliés au SAV, export européen Dual Carrier depuis le même SI.
Ce que Mondial Relay change dans votre plateforme
Checkout natif, sans widget externe
Le client choisit son Point Relais dans votre tunnel. Poids et gabarit du panier filtrent les relais éligibles : la livraison reste dans votre parcours, pas sur un site tiers.
Étiquette créée depuis l'OMS
Quand la commande passe en préparation, votre outil génère l'étiquette Dual Carrier. L'entrepôt imprime et expédie, sans ouvrir le portail Mondial Relay.
Retour branché sur le SAV
Le client lance le retour depuis son espace compte : QR ou étiquette, dépôt en relais, et le dossier SAV se met à jour dès que le colis est pris en charge.
Export européen depuis le même SI
Allemagne, Autriche, Espagne : une seule étiquette Dual Carrier depuis votre plateforme. Le partenaire (Hermes, Correos…) est déjà dessus, sans second process logistique.
Ce que ça change dans votre produit
La technique au service d'un résultat mesurable : checkout natif, étiquette depuis l'OMS, retour relié au SAV.
Le tunnel ne bascule plus vers un site tiers
Le Point Relais se choisit dans votre checkout, filtré par le panier. Le client reste dans votre parcours jusqu'à la validation.
L'entrepôt n'ouvre plus le portail Mondial Relay
L'OMS crée l'étiquette Dual Carrier à la préparation. L'équipe imprime et expédie depuis l'outil qu'elle utilise déjà.
Le SAV voit le retour sans relancer le client
Le retour part de l'espace compte : QR ou étiquette, dépôt en relais, et le dossier se met à jour quand le colis est pris en charge.
L'export européen reste dans le même SI
Allemagne, Autriche, Espagne : Dual Carrier porte Mondial Relay et le partenaire sur une seule étiquette. Pas de second process parallèle.
Comment nous livrons votre connecteur Mondial Relay
Cadrage
Où Mondial Relay entre dans votre produit : checkout, packing, SAV, export. On cartographie les flux, on sépare API1 et API2, on écarte toute lib qui crée encore l'étiquette en SOAP.
Développement
Connecteur branché sur votre checkout, votre OMS et vos retours. Deux clients API distincts, Dual Carrier sur le sandbox, idempotence, étiquette stockée et jamais transformée.
Recette
Parcours réel : choix de relais au checkout, étiquette au packing, retour depuis le compte. Sandbox Dual Carrier, 24L multi-colis, XOH refusé sans EDI, suivi plafonné.
Monitoring
Alertes sur échec Dual Carrier, suivi borné par colis, file morte inspectable. Vous voyez un incident avant qu'il casse le checkout ou le packing.
Ce que l'API apporte à votre plateforme
- Alimenter le checkout en Points Relais
- 10 à 30 points éligibles autour du panier, filtrés par poids et gabarit. De quoi peupler votre sélecteur natif, sans exposer tout le réseau.
- Créer l'expédition depuis l'OMS
- Dual Carrier crée l'aller ou le retour depuis votre outil de préparation. Collecte REL ou CCC, livraison 24R, 24L, HOM, LCC, XOH.
- Imprimer depuis l'entrepôt
- PDF, ZPL ou IPL pour l'imprimante déjà en place. QR pour certains retours REL : le parcours retour peut vivre dans l'espace compte.
- Remonter le suivi dans le compte client
- Cinq étapes jusqu'à la remise, affichables dans votre produit. Rythme borné (4 à 6 appels par colis et par jour), puis stop au statut terminal.
Le vocabulaire de l'API Mondial Relay
- Dual Carrier
- API2 REST XML : une URL, aller et retour, XSD Request/Response. C'est le seul chemin supporté pour créer une étiquette, y compris Hermes ou Correos Express.
- API1 / API2
- Deux secrets incompatibles. API1 : code enseigne + clé privée MD5. API2 : Login et Password Connect, menu « API Version V2.0 ». Un plugin qui demande les deux n'est pas redondant.
- 24L
- Point Relais XL, seul mode multi-colis (LD1/LDS). Un parcelCount > 1 sur 24R est une erreur 100xx, pas un warning.
- XOH
- Express D+1. La spec Dual Carrier exige une action EDI en plus de l'API. Oublier l'EDI, c'est un colis express non annoncé au réseau.
- Hash MD5
- Signature API1 : paramètres concaténés dans l'ordre imposé, souvent en majuscules, clé privée en fin. Un caractère en trop, et toute recherche échoue avec un code opaque.
- LCC
- Mode retour Dual Carrier. Couplé au QR (évolution v2.6) pour certains retours REL, il aligne Mondial Relay sur l'attente e-commerce actuelle.
Les contraintes réelles de l'API Mondial Relay
Créer l'étiquette en API1 est mort
La phrase officielle d'avril 2025 : les méthodes de création d'expédition API1 « are no longer maintained and should not be used ». Un audit de plugin commence là.
Pas de sandbox magique sur API1
Dual Carrier a un hôte -sandbox. L'API1, elle, n'en a pas d'équivalent documenté ici. On ne teste jamais une création d'étiquette API1 « pour voir ».
Le suivi n'est pas un cron de flotte
4 à 6 interrogations par colis et par jour, répartition sur la journée, stop dès le statut terminal. La présentation dit « should not be called in batch mode ».
COD arrêté, étiquette intouchable
Le contre-remboursement a disparu en v2.7 (février 2023). Redimensionner le PDF Dual Carrier casse le flux partenaire : imprimer tel quel.
Mondial Relay ou Colissimo pour vos expéditions ?
Le Point Relais natif dans votre plateforme d'un côté, la densité La Poste (domicile inclus) de l'autre. Les deux se branchent à votre SI, avec un contrat d'erreur différent.
| Critère | Mondial RelayCette page | ColissimoDensité La Poste |
|---|---|---|
| Cœur de réseau | Point Relais / consignes | Domicile, bureau, consigne, relais |
| Protocoles | SOAP API1 + REST API2, deux secrets | SOAP et REST v2, un contrat SLS |
| Création d'étiquette | Dual Carrier uniquement | generateLabel (préavis inclus) |
| Transfrontalier | Dual Carrier (Hermes, Correos…) | Produits internationaux SLS, CN23 |
| Suivi | 4 à 6 appels/j/colis, pas de batch | WS de suivi côté espace entreprise |
| Recette | Sandbox Dual Carrier, pas API1 | Étiquettes de test SLS documentées |
| Le bon cas | Relais natif dans checkout / OMS / SAV | Checkout France domicile + relais |
Les deux se combinent derrière une abstraction interne (créer, suivre, annuler) dans votre plateforme. Un plugin qui crée encore l'étiquette Mondial Relay en API1 est à remplacer, pas à « mettre à jour ». C'est un arbitrage de cadrage.
Ce que nous mesurons sur une intégration Mondial Relay
Les autres API transporteurs
Si le Point Relais n'est pas le cœur de votre parcours client, ces options se discutent au cadrage.
Mondial RelayNous développons votre connecteur Mondial RelayCette page
ChronopostExpress SOAP : étiquette, tarif, enlèvement, suivi skybill.
Colissimo & La PosteDensité France : domicile, relais, consigne, retours boîte aux lettres.On combine Mondial Relay avec
La stack autour de Mondial Relay quand on le branche dans un site ou un OMS.
Intégration Mondial Relay : vos questions
On la branche sur vos touchpoints produit : sélecteur de relais au checkout, création d'étiquette depuis l'OMS, suivi et retours dans le compte client ou le SAV. Techniquement, deux clients distincts : l'API1 SOAP pour la recherche et le suivi, l'API2 Dual Carrier pour créer l'expédition. On persiste le numéro avant de marquer la commande, on stocke PDF ou ZPL sans le transformer, on borne le suivi à 4 à 6 appels par colis et par jour. Toute lib qui crée encore l'étiquette en API1 est écartée dès le cadrage.
Un premier flux utile, typiquement le sélecteur de relais dans votre checkout et l'étiquette Dual Carrier depuis l'OMS, se livre en trois à quatre semaines. Une chaîne complète avec retours reliés au SAV, multi-colis 24L, Dual Carrier transfrontalier, XOH + EDI et suivi dans le compte client demande plutôt six à huit semaines. La durée dépend surtout des touchpoints à brancher, de l'accès Connect et de la séparation API1/API2. Nous cadrons le périmètre en amont et donnons une estimation ferme avant de commencer.
Parce que les méthodes historiques de création d'expédition API1 restent dans des libs et des tutos. La présentation des WebServices d'avril 2025 est explicite : elles ne sont plus maintenues et ne doivent pas être utilisées. La création passe par Dual Carrier REST. Garder l'API1 pour la recherche et le suivi, l'API2 pour l'étiquette. Mélanger les secrets, ou tester une création API1 « pour voir », produit de vrais colis et de vraies factures. C'est le premier filtre d'un audit.
Mondial Relay est un réseau de Points Relais, avec deux API (SOAP recherche/suivi, REST Dual Carrier pour l'étiquette) et des contraintes transfrontalières (partenaire dans la même étiquette). Colissimo est la densité La Poste, domicile inclus, avec un contrat SLS unique en SOAP et REST, checkGenerateLabel, et des retours boîte aux lettres. Mondial Relay borne le suivi à 4 à 6 appels par jour. Colissimo documente un WS de suivi derrière l'espace entreprise. On choisit Mondial Relay quand le relais est le produit. On choisit Colissimo quand le checkout doit aussi vendre le domicile La Poste. Les deux se combinent.
Non. La règle officielle est de ne pas appeler le suivi en batch. 4 à 6 interrogations par envoi et par jour, réparties, et un colis terminé ne se re-interroge plus. Au-delà, on monopolise le WS et on se fait couper. Pour un volume réel, la présentation mentionne EDI ou webhook comme alternatives, sans spec dans le PDF lu ici : le contrat exact se demande au compte, on ne l'invente pas. En attendant, une file bornée et un arrêt sur statut terminal tiennent la production.
Un projet d'intégration Mondial Relay ?
Parlons-en. 30 minutes pour cadrer où Mondial Relay entre dans votre plateforme (checkout, OMS, SAV) et vous dire franchement ce qui est faisable.
Parler de mon projet Mondial Relay