La méthode d'expédition n'apparaît pas sur le PDF

Vous avez choisi une méthode d'expédition, mais le PDF Espadon ne l'affiche pas. Elle n'est imprimée que s'il y a un numéro de suivi. Deux façons de l'obtenir.

Versions concernées
Dolibarr 20 à 24.0.2 · testé en 20.0.4 et 24.0.1 · corrigé seulement dans la branche de développement (25.0.0-alpha)
Ce qui a été vérifié
Testé le 4 octobre 2026 sur des instances 20.0.4 et 24.0.1, PDF Espadon réellement générés et lus : méthode absente sans numéro de suivi (avec ou sans note publique), imprimée dès qu'un numéro est saisi. Copie du modèle avec le correctif, placée dans un module personnel et activée par l'écran de configuration : méthode imprimée sans numéro. Modèle pdf_espadon.modules.php comparé dans le code officiel de 20.0.4 à 24.0.2, dans les branches 22.0, 23.0, 24.0 et de développement.

Sur une expédition, vous avez choisi la méthode d’expédition : transporteur, retrait, coursier. Vous générez le bon d’expédition avec le modèle Espadon, et la méthode n’y figure nulle part.

Il n’y a ni réglage caché ni module manquant. Le modèle n’imprime la méthode que dans un cas précis.

La règle du modèle Espadon

Dans le modèle, la méthode d’expédition est écrite à l’intérieur du bloc du numéro de suivi. Trois conditions s’enchaînent :

  1. le bloc ne s’ouvre que s’il y a une note publique ou un numéro de suivi ;
  2. la partie suivi ne s’affiche que s’il y a un numéro de suivi ;
  3. la méthode ne s’écrit que si un lien de suivi a pu être construit, et qu’une méthode est choisie.

La troisième condition est remplie dès qu’il y a un numéro : si la méthode n’a pas d’adresse de suivi, Dolibarr utilise le numéro lui-même comme lien. Tout se joue donc sur le numéro de suivi. Sans lui, la méthode n’est jamais imprimée, même avec une note publique.

Les solutions

  1. Renseigner un numéro de suivi. Sans toucher au code, la méthode apparaît alors sous le numéro, avec la mention « Méthode d’expédition ».
  2. Utiliser une copie modifiée du modèle si vous voulez la méthode même sans suivi. Il faut changer deux endroits : ajouter la méthode à la condition d’entrée du bloc, puis ajouter un affichage de la méthode quand il n’y a pas de numéro. Ce changement a été accepté par le projet Dolibarr dans la branche de développement (n° 40198). Il n’est dans aucune version publiée, ni dans les branches 22, 23 et 24.

Pour la solution 2, ne modifiez pas le fichier du cœur : une mise à jour l’écraserait. Copiez le modèle sous un autre nom dans un module personnel (dossier custom/, module qui déclare fournir des modèles de documents), faites les deux changements dans cette copie, puis activez-la dans la configuration du module Expéditions.

Comment cela a été vérifié

  • Sur des instances 20.0.4 et 24.0.1 de test, avec la méthode « transport générique » : sans numéro de suivi, la méthode est absente du PDF, même avec une note publique ; avec un numéro, « Méthode d’expédition » apparaît sous le numéro. En 24.0.1, même résultat avec UPS, qui a une adresse de suivi.
  • En 24.0.1 : copie du modèle avec les deux changements, placée dans un module personnel, activée dans la configuration des expéditions et générée depuis la fiche de l’expédition : la méthode apparaît sans numéro de suivi.
  • Dans le code officiel, les trois conditions imbriquées sont les mêmes de la 20.0.4 à la 24.0.2 ; seule la branche de développement contient le correctif.

Si vos documents ne montrent pas ce qu’il faut

Si votre bon d’expédition doit afficher d’autres informations, le forfait Documents PDF sur mesure reprend le modèle et le teste sur votre version. Pour un premier avis, le diagnostic à 90 € consiste à regarder votre cas avec vous pendant une heure, puis à vous remettre par écrit ce que coûterait la modification.

Dolibarrexpéditionméthode d'expéditionEspadonPDFnuméro de suivi