Marge par jour
margeparjour · v1.0.0
Vous voyez ce que rapporte une journée de travail avant d'accepter le devis.
Logistique
Étiquettes Mondial Relay (Sendcloud)
dolixmondialrelay · version 1.0.0
Vous choisissez le Point Relais® ou le Locker du destinataire sur l'expédition, et le module crée l'étiquette Mondial Relay avec votre compte Sendcloud.
79 € hors taxes.
La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore.
01
Ce que fait le module
- Sur la fiche expédition, une ligne « Point Relais® Mondial Relay » : recherche des Points Relais et Lockers autour du code postal de livraison, avec le nom, l'adresse, la distance et les horaires d'ouverture. Le point choisi est relu chez Sendcloud avant d'être enregistré.
- « Créer l'étiquette Mondial Relay » sur une expédition validée : le module retient l'option Mondial Relay qui correspond au point (Point Relais, Locker, ou domicile si vous l'autorisez), la moins chère que propose votre compte Sendcloud, et jamais une option sans étiquette imprimée.
- L'étiquette PDF est rangée dans les documents de l'expédition. Le numéro de suivi et le mode d'expédition « Mondial Relay » s'inscrivent sur l'expédition.
- Statut Sendcloud du colis à la demande, et annulation de l'étiquette avec une demande de confirmation.
- Dans la liste des expéditions, l'action de masse « Étiquettes Mondial Relay » crée une étiquette par expédition prête et réunit les PDF dans un fichier zip.
- Contrôles avant tout appel à Sendcloud : expédition validée, poids (celui de l'expédition, sinon la somme des produits, 10 g minimum), adresses de l'expéditeur et du destinataire, téléphone pour la livraison à domicile.
- Destinataire : le contact « livraison » de l'expédition ou de sa commande, sinon le tiers. Expéditeur : l'adresse de votre société dans Dolibarr.
- Mode test, coché par défaut : des étiquettes de test Sendcloud gratuites, sans transporteur, pour essayer tout le parcours. Rien n'est envoyé à Mondial Relay et le numéro de suivi n'est pas écrit sur l'expédition.
02
À qui ça sert
Dolibarr ne connaît pas Mondial Relay : pas de mode d'expédition à ce nom, pas de recherche de Point Relais, pas d'étiquette. L'étiquette se prépare hors de Dolibarr, et le numéro de suivi est à recopier à la main dans l'expédition.
Depuis 2026, le « Créer un compte » professionnel de mondialrelay.fr mène à une inscription Sendcloud. Ce compte ne donne pas d’identifiants pour les API directes de Mondial Relay : pour créer des étiquettes depuis Dolibarr, il faut passer par l’API de Sendcloud. C’est ce que fait le module.
À qui ça sert : Les boutiques et entreprises qui envoient des colis en Point Relais ou en Locker Mondial Relay et qui gèrent leurs commandes et leurs expéditions dans Dolibarr.
03
Ce que le module ne fait pas
Ce bloc figure sur les 21 fiches, sans exception.
- Mondial Relay uniquement, par Sendcloud : il faut un compte Sendcloud (le compte professionnel ouvert sur mondialrelay.fr en est un) et ses clés d'API.
- Les vraies étiquettes sont facturées par Sendcloud, aux tarifs de votre compte, et demandent un moyen de paiement enregistré chez Sendcloud. Le module n'affiche pas le prix avant la création.
- Un colis par expédition. Pas de retours, pas d'envoi en plusieurs colis.
- Le Point Relais est choisi dans Dolibarr, pas par le client sur votre site web.
- Les étiquettes d'un lot sont réunies dans un zip, pas fusionnées dans un seul PDF.
- Une étiquette annulée n'est remboursée que si Sendcloud accepte l'annulation avant la date limite du transporteur.
- Les essais ont porté sur des envois de France vers la France.
- Version 1.0.0 : quand Mondial Relay transmet une apostrophe doublée dans le nom ou l'adresse d'un point (« ROUTE D''ALTENHEIM »), elle s'affiche telle quelle.
04
Comment ça marche
Tout se passe sur la fiche expédition de Dolibarr, et dans la liste des expéditions.
Le choix du point
Une ligne « Point Relais® Mondial Relay » s’ajoute à la fiche expédition. Le crayon ouvre la recherche autour du code postal de livraison : les Points Relais et les Lockers, avec le nom, l’adresse, la distance et les horaires d’ouverture. Le point choisi est relu chez Sendcloud avant d’être enregistré, avec son type : commerce ou Locker.
L’étiquette
Sur une expédition validée, « Créer l’étiquette Mondial Relay » :
- le module demande à Sendcloud les options d’envoi Mondial Relay pour ce poids, du pays de l’expéditeur vers celui du destinataire ;
- il retient celle qui correspond au point — Point Relais, Locker, ou livraison à domicile si vous l’avez autorisée —, la moins chère que propose votre compte, et jamais une option sans étiquette imprimée ;
- il crée l’envoi chez Sendcloud et range l’étiquette PDF dans les documents de l’expédition ;
- il écrit le numéro de suivi et le mode d’expédition « Mondial Relay » sur l’expédition.
Ensuite, « Actualiser le statut » affiche le statut Sendcloud du colis, et « Annuler l’étiquette » demande l’annulation à Sendcloud, après confirmation.
Plusieurs colis d’un coup
Dans la liste des expéditions, l’action de masse « Étiquettes Mondial Relay » liste les expéditions sélectionnées (« À faire », « Déjà créée »), crée une étiquette pour chaque expédition prête, puis propose « Télécharger les étiquettes (zip) ».
Les contrôles avant tout appel
Rien n’est envoyé à Sendcloud tant que l’un de ces points manque :
| Contrôle | Détail |
|---|---|
| Expédition validée | l’expédition doit être validée avant de créer l’étiquette |
| Point Relais choisi | sauf si la livraison à domicile est autorisée |
| Poids | celui de l’expédition, sinon la somme des produits, 10 g minimum |
| Adresse de l’expéditeur | l’adresse de votre société dans Dolibarr : adresse, code postal, ville, pays |
| Adresse du destinataire | le contact « livraison » de l’expédition ou de sa commande, sinon le tiers |
| Téléphone | obligatoire pour la livraison à domicile |
Le mode test
Coché par défaut, il crée des étiquettes de test Sendcloud gratuites et sans transporteur, pour essayer tout le parcours avant le premier colis. Rien n’est envoyé à Mondial Relay, le numéro de suivi n’est pas écrit sur l’expédition, et un badge TEST le rappelle. Décoché, le module crée de vraies étiquettes Mondial Relay, facturées par Sendcloud aux tarifs de votre compte.
Ce qui a été essayé en vrai
Le 14 octobre 2026, sur Dolibarr 24.0.1, en mode réel, le module a créé l’étiquette Mondial Relay n° 73988975 : un colis de 1 kg vers un Point Relais de Strasbourg. Le PDF a rejoint les documents de l’expédition, le numéro de suivi et le mode d’expédition ont été écrits sur l’expédition. L’annulation a été demandée depuis le module le jour même.
Les trois captures viennent de l’essai réel du 14 octobre 2026, sous Dolibarr 24.0.1, avec l’interface en anglais.
L’expédition après la création de la vraie étiquette : à droite, « Shipping method : Mondial Relay » et « Tracking number : 73988975 », écrits par le module ; à gauche, le Point Relais NEUSHOP STRASBOURG, le numéro de suivi avec le lien vers l’étiquette PDF, et le statut Sendcloud « Ready to send ».
Le choix du point pour le code postal 67100 : deux commerces et un Locker, avec l’adresse, la distance et les horaires d’ouverture.
05
Réglages
La page de configuration est réservée aux administrateurs.
| Réglage | Défaut | Effet |
|---|---|---|
| Clé publique Sendcloud | vide | Clé de l’intégration « Sendcloud API » de votre compte. |
| Clé secrète Sendcloud | vide | Chiffrée en base. Une fois enregistrée, elle n’est jamais réaffichée : le champ indique « enregistré (laisser vide pour le garder) ». |
| Mode test (étiquettes gratuites) | coché | Étiquettes de test Sendcloud, gratuites et sans transporteur. Décoché : vraies étiquettes Mondial Relay, payantes. |
| Autoriser la livraison à domicile | non | Sans Point Relais choisi, l’étiquette est créée en livraison à domicile. Le téléphone du destinataire est alors obligatoire. |
Le bouton « Tester la connexion » cherche les Points Relais près de l’adresse de votre société et affiche combien il en trouve.
06
Sécurité et garde-fous
- Deux droits dédiés : « Voir les informations Mondial Relay des expéditions » et « Choisir le Point Relais, créer et annuler les étiquettes Mondial Relay ». Avec le premier seul, la ligne Mondial Relay est visible, sans aucun bouton.
- Le droit de Dolibarr en plus : les pages de choix du point et d’étiquettes en masse demandent aussi le droit de lire les expéditions.
- Clé secrète chiffrée en base, jamais réaffichée dans la page de configuration.
- Jeton anti-CSRF dans chaque formulaire. Sur la fiche expédition, le module vérifie lui-même le jeton des actions créer, actualiser et annuler.
- Annulation confirmée : une fenêtre rappelle que l’étiquette n’est remboursée que si l’annulation est acceptée avant la date limite du transporteur.
- Appels sortants limités à panel.sendcloud.sc et servicepoints.sendcloud.sc, sans suivre de redirection. Le proxy réglé dans Dolibarr est utilisé s’il existe.
- Configuration réservée aux administrateurs.
07
Ce qui est livré
| Tables créées en base | Une table : llx_dolixmr_envoi, une ligne par expédition (Point Relais choisi, envoi Sendcloud, numéro de suivi, fichier de l'étiquette, statut, mode test ou réel). Un mode d'expédition « Mondial Relay » est ajouté au dictionnaire s'il n'existe pas. Les réglages sont des constantes Dolibarr : DOLIXMR_SC_PUBLIC, DOLIXMR_SC_SECRET (chiffrée), DOLIXMR_MODE_TEST et DOLIXMR_DOMICILE. |
|---|---|
| Permissions | Deux droits : « Voir les informations Mondial Relay des expéditions » et « Choisir le Point Relais, créer et annuler les étiquettes Mondial Relay ». Avec le premier seul, la ligne Mondial Relay de l'expédition est visible, sans aucun bouton. Les pages de choix du point et d'étiquettes en masse demandent aussi le droit Dolibarr de lire les expéditions. La page de configuration est réservée aux administrateurs. |
| Désinstallation |
|
Le dossier dolixmondialrelay, en PHP lisible, sous licence GPL v3 ou ultérieure : le descripteur
du module, la classe d’appel à Sendcloud, la classe des envois, les crochets de la fiche et de la
liste des expéditions, la page de choix du point, la page d’étiquettes en masse, la page de
configuration, le script SQL de la table, les icônes.
- Langues : français (
fr_FR), anglais (en_US) et allemand (de_DE). - Un
README.mdqui décrit le fonctionnement et les limites. - Un
ChangeLog.md.
- Une table est ajoutée :
llx_dolixmr_envoi. Elle garde une ligne par expédition : Point Relais choisi, envoi Sendcloud, numéro de suivi, nom du fichier de l’étiquette, statut, mode test ou réel. - Ce qui est écrit sur l’expédition, pour une vraie étiquette : le numéro de suivi et le mode d’expédition « Mondial Relay ». L’étiquette PDF est rangée dans ses documents.
- Ce qui est envoyé à Sendcloud : les noms, adresses, téléphones et e-mails de l’expéditeur et du destinataire quand ils sont renseignés, le poids, la référence de l’expédition, l’option d’envoi et le point choisi ; pour la recherche de points, le pays, le code postal et le poids.
- Un mode d’expédition « Mondial Relay » est ajouté au dictionnaire s’il n’existe pas.
- Aucun fichier de Dolibarr n’est modifié.
08
Compatibilité
Le descripteur du module ne déclare qu’une version minimale. Aucune borne haute n’est inscrite dans le code : les versions ci-dessous sont celles sur lesquelles le module a réellement été exécuté.
| Versions de Dolibarr | Dolibarr 19.0 minimum. Installé et exécuté sur 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 et 24.0.1. |
|---|---|
| PHP minimum | 7.4 |
| Modules Dolibarr à activer | Expéditions |
| Licence | GPL v3 ou ultérieure, code source complet |
| Langues | Français, anglais, allemand |
| Menu | Pas d'entrée de menu. Ligne « Point Relais® Mondial Relay » et boutons sur la fiche expédition ; action de masse « Étiquettes Mondial Relay » dans la liste des expéditions. |
09
Installation
- Récupérer le module sur le DoliStore et télécharger le fichier zip.
- Dans Dolibarr : AccueilConfigurationModules/Applicationsonglet « Déployer/Installer un module externe », puis envoyer le zip. Sinon, décompresser le dossier dolixmondialrelay dans htdocs/custom/.
- Activer « Étiquettes Mondial Relay (Sendcloud) ». Dolibarr active aussi le module Expéditions s'il ne l'est pas. La table est créée et le mode d'expédition « Mondial Relay » ajouté.
- Dans Sendcloud : RéglagesIntégrations« Sendcloud API »Se connecter, pour obtenir la clé publique et la clé secrète. Pour de vraies étiquettes, enregistrer un moyen de paiement dans Sendcloud (RéglagesFacturation).
- Dans la page de configuration du module : saisir les deux clés, laisser le mode test coché pour les premiers essais, autoriser ou non la livraison à domicile, puis cliquer sur « Tester la connexion ».
- Vérifier l'adresse complète de la société (AccueilConfigurationSociété/Organisation) : c'est l'adresse de l'expéditeur. Attribuer les deux droits aux utilisateurs concernés.
Le détail — droits du dossier custom, hébergement mutualisé, mise à jour, désinstallation — est sur la page Installation et mise à jour.
10
Questions fréquentes
Sur quelles versions de Dolibarr ce module fonctionne-t-il ?
Le descripteur exige Dolibarr 19.0 au minimum et PHP 7.4 au minimum. Le module a été installé et exécuté sur 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 et 24.0.1. Si vous êtes sur une autre version et que vous avez un doute, écrivez avant d'acheter.
De quel compte ai-je besoin ?
D'un compte Sendcloud, avec ses clés d'API. En créant un compte professionnel sur mondialrelay.fr, on arrive sur une inscription Sendcloud : c'est le même compte. Les essais ont été faits avec un compte Sendcloud à l'offre gratuite. Pour de vraies étiquettes, un moyen de paiement doit être enregistré dans Sendcloud.
Combien coûte une étiquette ?
Le prix est celui de votre compte Sendcloud : c'est Sendcloud qui facture l'étiquette, pas Dolix. Le module n'affiche pas ce prix avant la création. En mode test, les étiquettes sont gratuites.
Le module a-t-il déjà créé une vraie étiquette Mondial Relay ?
Oui. Le 14 octobre 2026, sur Dolibarr 24.0.1 et en mode réel, il a créé l'étiquette Mondial Relay n° 73988975, pour un colis de 1 kg vers un Point Relais de Strasbourg : PDF rangé dans les documents de l'expédition, numéro de suivi et mode d'expédition écrits sur l'expédition. L'annulation a été demandée depuis le module le jour même. Les autres essais ont utilisé le mode test de Sendcloud.
Point Relais ou Locker : comment le module choisit-il l'option d'envoi ?
Sendcloud indique pour chaque point s'il s'agit d'un commerce ou d'un Locker, et chaque type a sa propre option d'expédition. Le module enregistre le type du point choisi et retient l'option qui lui correspond, la moins chère proposée par votre compte. Les options sans étiquette imprimée (code QR) sont écartées : le module produit un PDF à imprimer.
Et si je désinstalle ?
La ligne Mondial Relay, les boutons et l'action de masse disparaissent. Rien n'est supprimé : la table, les réglages et le mode d'expédition restent, comme les étiquettes PDF et les numéros de suivi déjà écrits sur les expéditions.
Qui répond au support, et comment se passent les mises à jour ?
Le support est assuré par la personne qui a écrit le module, à support@dolix.fr. La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore, où les nouvelles versions sont publiées.
11
Journal des versions
Repris du fichier ChangeLog.md du module : une seule source.
1.0.014 octobre 2026
Première version, par l'API Sendcloud : choix du Point Relais® ou du Locker, étiquette PDF rangée dans les documents de l'expédition, option Mondial Relay choisie selon le point, numéro de suivi et mode d'expédition « Mondial Relay » écrits sur l'expédition. Statut à la demande, annulation avec confirmation, action de masse avec zip des étiquettes. Mode test gratuit. Contrôles avant tout appel. Clé secrète chiffrée en base. Interface en français, anglais et allemand.
12
Support de ce module
Écrivez à support@dolix.fr. C’est la personne qui a écrit le module qui répond.
Réponse sous deux jours ouvrés. Ce n’est pas un service d’astreinte.
À joindre à votre message
- La version exacte de Dolibarr.
- Le module concerné et sa version — ici dolixmondialrelay 1.0.0.
- Ce que vous avez fait, et ce que vous attendiez.
- Le message d’erreur recopié tel quel, ou une capture d’écran.
- Comment Dolibarr est installé, si vous le savez.
Ce module est en vente sur le DoliStore.
La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore.
Aussi
Les autres modules
Changement de domaine email
dolixdomaine · v1.0.5
Un client change de nom : ses adresses passent au nouveau domaine en une opération.
Modification en masse
dolixmasse · v1.0.5
Vous changez un champ sur une série de fiches sans écrire une requête SQL.
Déplacer des tâches
dolixtaches · v1.0.3
Une tâche a été créée dans le mauvais projet : vous la déplacez, avec ses sous-tâches, son temps passé et ses documents.
Détection de doublons
dolixdoublons · v1.1.5
Vous retrouvez les fiches saisies deux fois, et vous les fusionnez : tiers, contacts et adhérents.
Actualiser les prix
dolixprix · v1.1.2
Vos devis brouillons et vos factures modèles reprennent les prix du catalogue, un par un ou tous d'un coup.
Frais d'approche
dolixapproche · v1.0.2
Vous répartissez le transport, la douane et les autres frais d'un arrivage sur le coût des produits et leur PMP.
Reste à facturer
dolixresteafacturer · v1.0.1
Vous voyez ce qui reste à facturer sur chaque commande client, ligne par ligne, en quantité et en montant HT.
Prêt pour la mise à jour
dolixmaj · v1.0.2
Avant de mettre à jour Dolibarr, vous savez ce qui bloquera, ce qui cassera et quoi faire avant. Le module ne modifie rien.
Mentions TVA Europe
dolixtva · v1.0.0
La mention de TVA obligatoire s'imprime seule sur vos factures : franchise, livraison intracommunautaire, autoliquidation, export.
Justificatifs dans les notes de frais
dolixjustif · v1.0.0
Le PDF de la note de frais contient aussi ses justificatifs, photos et PDF, page par page : un seul document à transmettre.
Porte-monnaie TakePOS
dolixportemonnaie · v1.0.2
Vos clients ou adhérents versent une somme à l'avance, et TakePOS la consomme à chaque passage en caisse, jusqu'à épuisement.
Alertes DLC et DMD des lots
dolixdlc · v1.0.0
Vous voyez à temps les lots en stock dont la DLC ou la DMD/DLUO approche ou est dépassée, et vous pouvez empêcher la validation d'une expédition qui contient un lot à la DLC dépassée.
Habillage TakePOS
dolixhabillage · v0.3.0
Donnez à TakePOS l'allure d'une caisse moderne : catégories en onglets, grande grille de produits, panier à droite, bouton Encaisser, ambiances par métier ou couleurs de votre logo.
Tags en colonne dans les listes
dolixtags · v1.0.0
Les tags de vos devis, commandes, factures, tiers, contacts, produits et projets s'affichent en couleur dans une colonne de la liste, sans ouvrir chaque fiche.
Cotisations en masse
dolixcotisations · v1.0.0
Un montant de cotisation propre à chaque adhérent, et le renouvellement de toutes les cotisations en une fois, avec facture, paiement et email.
Emballages consignés
dolixconsignes · v1.0.1
Vous voyez combien de fûts, caisses ou palettes consignés chaque client détient, ce que valent ces consignes, et ceux qui ne sont pas revenus dans le délai.
Dépôt-vente
dolixdepotvente · v1.0.2
Pour chaque déposant, vous voyez ce qui a été vendu et votre commission, et le relevé prépare les factures en brouillon.
Bon de livraison groupé
dolixblgroupe · v1.0.1
Un seul bon de livraison PDF pour plusieurs expéditions d'un même client, à signer une seule fois.
Dernier prix client
dolixdernierprix · v1.0.0
Vous choisissez un produit sur un devis, une commande ou une facture : le dernier prix et la remise accordés à ce client s'affichent, et s'appliquent en un clic.