Installation
Déposez les sources décompressés du module dans les répertoires de Dolibarr (htdocs/custom conseillé ou htdocs).
Activez le module dans la gestion des modules de Dolibarr.
Activez les méthodes d’expédition que vous souhaitez utiliser dans le dictionnaire des méthodes d’expéditions de Dolibarr.
Configuration de l’expéditeur
La première étape consiste à compléter les données d’expédition, adresse, téléphone et mail de l’expéditeur.
Il faut renseigner les champs de l’onglet Configuration. Indiquez les données à utiliser pour identifier l’expéditeur sur vos étiquettes. En général, on y indique les coordonnées de votre service d’expédition.
Ensuite il faut configurer les accès aux différents services que vous allez utiliser. Si l’onglet de configuration du transporteur n’apparaît pas, vérifiez que vous avez activé les méthoides d’expédition correspondantes dans le dictionnaire Dolibarr.
Nouveauté version 2026 (version 1.2.3 +) : ll est possible de configurer un compte transporteur lié à un entrepôt. Le compte utilisé serra ensuite déterminé depuis l’entrepôt de départ de l’expédition.
Définissez d’abord les entrepôts de départ en renseignant pour chacun les éléments demandés. Puis dans l’onglet du transporteur, saisissez les comptes pour chaque entrepôt de départ (voir pour Chronopost).
Configuration des services
Colissimo
Il faut indiquer le login et mot de passe reçu de Colissimo ainsi que l’url des webservices (indiquée à côté du champ).
Colissimo propose deux formats d’étiquettes A4 : une étiquette A5 avec une partie reçu à conserver et 10x15 mm. Choisissez le format que vous allez utiliser.
Nouveauté version 2026 (version 1.2.3 +)
Vous pouvez créer des étiquettes Colissimmo de retour à joindre à vos colis.
GLS
Depuis juillet 2023, GLS propose un nouveau service d’étiquetage nommé SHIPIT. Renseignez-vous auprès de GLS quel service doit être utilisé.
Pour les services de GLS il faut indiquer (infos disponibles auprès de GLS) :
- Les paramètres du compte GLS Code client et contactid
- Le dépôt d’origine
- le code pays (250 pour la France)
- l’url de l’API GLS ainsi que le login et le mot de passe
Nouveauté version 2026 : Choisir un point relais GLS il est possible de choisir un point relais GLS depuis une commande livrée en GLS Point relais. A la création de l’étiquette GLS, vous obtiendrez ainsi l’étiquette pour le Point Relais.
Remarques :
- L’url doit correspondre au service utilisé : se renseigner auprès de GLS. pour le service SHIPIT elle est du type https://shipit-wbm-fr01.gls-group.eu:8443/backend/ShipmentProcessingService/ShipmentProcessingPortType/
- Pour la nouvelle API SHIPIT, le port 8443 indiqué par GLS peut être remplacé par 443, si ce port n’est pas ouvert sur l’hébergement de votre Dolibarr. Choisir le format d’étiquettes GLS propose plusieurs formats (A4, A5 ou A6)
UPS
Pour pouvoir utiliser les services en ligne UPS, il faut créer un compte sur le site d’UPS. La procédure est décrite sur la page https://developer.ups.com/get-started?loc=fr_FR.
L’étape importante est la création d’une application dans votre compte qui définira les services auxquels vous souhaitez accéder (pour le module Dolibarr il faut les applications de shipping et de tracking).
Dans l’application vous trouverez les informations nécessaires à la configuration du module shippinglabels : le compte de facturation, l’iD client et le mot de passe du client.
Ces informattions sont à reporter dans la page de configuration de l’onglet UPS de shippinglabels.
UPS vous permet de tester la demande d’étiquettes sur un serveur d’intégration (url https://wwwcie.ups.com/api/shipments/v2409/ship) avant de passer en production (url https://onlinetools.ups.com/api/shipments/v2409/ship).
TNT
A venir
Chronopost
Chronopost fournit les informations de connexions aux services d’étiquetage (login et mot de passe ). A demander auprès de votre interlocuteur Chronopost.
Ces informations sont à enregistrer dans la configuration du module sur l’onglet Chronopost.
Il faut aussi indiquer des horaires de fermeture et de ramassage au format hh:mm:ss.
Enfin, une option vous permet de forcer des dimensions standard de vos colis, si ces informations ne figurent pas sur l’expédition (conseillé pour permettre l’automatisation de la création d’étiquettes)..
Nouveauté version 2026
Pour Chronopost, vous pouvez définir un compte d’envoi lié à un entrepôt (si vous avez configuré cette opttion à l’étape ci-dessus). Par exemple, vous expédiez depuis un dépôt situé au siège à Lille (collecte par Chroopost Lille), et aussi depuis un dépôt situé à Marseille (collecte par Chronopost Marseille).
Mondial Relay
Renseignez les données de votre compte Mondial Relay à savoir login, mot de passe fournis par Mondial Relay. renseignez le type d’envois selon votre contrat (les valeurs possibles sont indiquées). Vérifiez auprès de votre interlocuteur Mondial Relay
Choisir le format d’étiquettes
DPD
Renseignez les données de connexion reçues de DPD pour chaque méthode utilisée (il arrive que les données soient différentes) : login, mot de passe, centre, numéro de client. L’url d’appel des webservices est transmise par DPD. Elle doit se terminer par ?WSDL. Indiquez les paramètres de l’étiquette (format, poids maxi …).
Choisir un point relais DPD
Depuis la commande ou l’expédition Dolibarr, vous pouvez choisir un point relais pour la livraison depuis l’onglet « contacts ». Définissez un contact de livraison et indiquez la date de livraison prévue puis choisissez le point relais où livrer la commande.
Obtenir une étiquette
Lorsque la méthode d’expédition choisie le permet, un formulaire apparaît sur la fiche de l’expédition qui permet de créer une ou plusieurs étiquettes et leq n° de tracking associés. Les informations utilisée pour créer l’étiquette proviennent du contact de livraison ou du tiers associé à l’expédition.
l’étiquettes est stockée avec le Bon de Livraison (fichier pdf)
Il n’y a plus qu’à préparer le colis…
Traiter les erreurs
Si le service du transporteur ne peut pas créer l’étiquette, un message d’erreur vous indique la donnée à corriger. Selon la méthode d’expédition, certains éléments sont obligatoires (téléphone portable, email par exemple).
Erreur sur le poids du colis
Le poids du colis est calculé d’après les produits expédiés. Vous pouvez aussi le modifier sur l’expédition.
Erreur dans l’adresse expéditeur
Vérifier le paramétrage de l’expéditeur dans la configuration du module.
Erreur dans l’adresse de destination
Certains services font une vérification de l’adresse de destination que le module lui transmet. Cette adresse est soit l’adresse du contact de livraison, soit l’adresse du tiers (s’l n’y a pas de contact de livraison) de la commande liée à l’expédition, Certains services nécessitent un téléphone portable ou un e-mail.
La correction doit donc se faire directement sur le contact de livraison ou le tiers. Il est conseillé de définir un contact de livraison dès la création de la commande.
