Libellés des bons de livraison

NsUpdateLibShipping – Mise à jour libellés expédition

Documentation du module · version 23.0.0 · éditeur NSINFO

1. Présentation

Dans Dolibarr, le bon de livraison ne conserve pas ses propres textes : le libellé et la description de chaque ligne sont relus dans la commande (ou dans la fiche produit) à chaque affichage et à chaque impression. Une commande corrigée après coup, un produit renommé ou une traduction du produit modifient donc un bon de livraison déjà établi.

NsUpdateLibShipping donne au bon de livraison ses propres libellés et descriptions :

• à la création du bon de livraison, la référence produit, le libellé et la description de chaque ligne de la commande sont copiés et conservés avec la ligne du bon de livraison ;
• la fiche et le PDF du bon de livraison affichent ces textes conservés ;
• sur un bon de livraison en brouillon, le crayon de modification d’une ligne permet de modifier le libellé et la description sans toucher à la commande ;
• en option, les lignes du bon de livraison se déplacent comme sur une commande ;
• une facture créée depuis le bon de livraison reprend ces libellés, descriptions et cet ordre.

Le module ne modifie pas le Core de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

2.2 Installation

1. Installer et activer le framework NSINFO (gratuit, version 23.4.0 ou supérieure).
2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive module_nsupdatelibshipping-X.Y.Z.zip.
3. Dans la liste des modules, famille NSINFO, activer « Mise à jour libellés expédition ».
4. Si besoin, activer l’option de déplacement des lignes (roue crantée du module).

À l’activation, le module crée la table où sont conservés les textes des lignes de bons de livraison. Aucune saisie n’est nécessaire : les bons de livraison existants sont pris en charge automatiquement (voir 5.4).

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactiver puis réactiver le module : c’est cette opération qui enregistre les évolutions de la table et des écrans. Les textes conservés et les réglages ne sont pas perdus.

3. Configuration

Page de réglages : Configuration > Modules, roue crantée du module (onglets Réglages, ChangeLog et À propos fournis par le framework NSINFO). Réservée aux administrateurs.

La copie des textes, leur affichage, leur modification et leur reprise dans la facture fonctionnent sans réglage.

4. Droits d’accès

Le module n’ajoute pas de permission : il s’appuie sur celles des expéditions.

5. Utilisation

5.1 Création du bon de livraison

Rien ne change dans la façon de créer un bon de livraison depuis une commande. Au moment de la création, pour chaque ligne, le module conserve :

• la référence du produit ;
• le libellé : celui de la ligne de commande s’il a été personnalisé, sinon celui du produit ;
• la description de la ligne de commande.

Une ligne ajoutée plus tard au bon de livraison en brouillon est copiée de la même façon. Modifier ensuite la commande ou le produit ne change plus le bon de livraison.

5.2 Affichage sur la fiche

Sur la fiche du bon de livraison, la colonne de description de chaque ligne affiche la référence et le libellé conservés (lien vers le produit), suivis de la description conservée. Les titres et commentaires du module de sous-totaux et les lignes libres restent affichés comme d’habitude.

5.3 Modifier le libellé et la description

1. Ouvrir un bon de livraison en brouillon.
2. Cliquer sur le crayon de la ligne.
3. Les champs « Libellé » et « Description » apparaissent, préremplis avec les textes conservés du bon de livraison (et non ceux de la commande). La description se saisit en texte enrichi, comme sur une commande.
4. Modifier les textes et, si besoin, les quantités, puis Enregistrer.

L’enregistrement met à jour les textes du bon de livraison et, comme d’habitude, les quantités et entrepôts de la ligne. La commande n’est pas modifiée. La référence produit n’est pas modifiable.

5.4 Bons de livraison existants

Les bons de livraison créés avant l’installation du module sont copiés depuis leur commande à leur première ouverture (ou à la première génération de leur PDF, ou à la création d’une facture depuis eux). À partir de ce moment, ils conservent leurs propres textes.

6. Ordre des lignes

Avec l’option « Permettre de déplacer les lignes dans le bon de livraison (comme sur une commande) », sur un bon de livraison en brouillon :

• chaque ligne affiche la poignée de déplacement utilisée sur les commandes : il suffit de la saisir et de faire glisser la ligne à sa nouvelle place ;
• les titres et commentaires du module de sous-totaux et les lignes libres du module NsFreeLine se déplacent aussi ;
• l’ordre est conservé sur la fiche, dans le PDF et dans la facture créée depuis le bon de livraison ;
• l’ordre de la commande n’est pas modifié.

Le déplacement n’est pas proposé sur un bon de livraison validé, pendant la modification d’une ligne, ni sur l’affichage pour téléphone.

7. Facturation depuis le bon de livraison

Lorsqu’une facture est créée depuis un bon de livraison validé, par le bouton « Créer Facture » de la fiche ou par l’action groupée « Créer factures » de la liste des expéditions :

• chaque ligne de la facture reprend le libellé et la description du bon de livraison ;
• si l’option de déplacement est activée, les lignes sont dans l’ordre du bon de livraison ; les autres lignes déjà présentes dans la facture ne bougent pas ;
• les titres et commentaires du module de sous-totaux sont repris comme d’habitude.

Les textes de la facture se modifient ensuite librement, comme pour toute facture.

8. Impression PDF

• Tous les modèles PDF de bon de livraison (modèles standards de Dolibarr et modèles personnalisés comme DPersoPlus) impriment les libellés et descriptions conservés.
• Lorsque Dolibarr est réglé pour imprimer les textes des produits dans la langue du client, le PDF du bon de livraison imprime quand même les textes du bon de livraison, et non la traduction du produit.
• Si l’option de déplacement est activée, les lignes sont imprimées dans l’ordre du bon de livraison.

9. Limites connues et FAQ

J’ai corrigé la commande, le bon de livraison n’a pas changé.

C’est le but du module : le bon de livraison garde les textes copiés à sa création. Corriger la ligne avec le crayon sur le bon de livraison en brouillon.

Les champs « Libellé » et « Description » n’apparaissent pas au crayon.

Le bon de livraison doit être en brouillon et l’utilisateur doit avoir la permission « Créer/modifier les expéditions ».

Le PDF de la facture affiche la traduction du produit.

Si les textes des produits sont imprimés dans la langue du client et que le libellé repris est identique à celui du produit, le PDF de la facture peut afficher la traduction du produit : l’impression des factures n’est pas modifiée par le module.

Autres limites

• Les modèles de documents ODT (OpenOffice / LibreOffice) ne sont pas concernés : seuls les modèles PDF impriment les textes conservés.
• Les titres et commentaires du module de sous-totaux ne se modifient pas par le module : ils gardent leur fonctionnement habituel.
• Si le module « NSINFO » est désactivé après coup, la page de réglages du module n’est plus utilisable.
• Si le module est désactivé, Dolibarr affiche de nouveau les textes de la commande ; les textes conservés restent en base et sont de nouveau utilisés à la réactivation.