
BL Reliquat – Bon de livraison avec reliquat
Documentation du module · version 23.0.0 · éditeur NSINFO
Sommaire
1. Présentation
BL Reliquat est un modèle de document PDF pour les bons de livraison (expéditions) de Dolibarr. Il reprend tous les produits de la commande et indique, pour chacun, ce qui reste à livrer après l’expédition en cours.
- Le bon de livraison affiche la quantité commandée, la quantité à expédier et la quantité reliquat (reste à livrer).
- Sur demande, une colonne Qté déjà livrée affiche ce qui a déjà été expédié.
- Les réglages permettent d’adapter les colonnes, les couleurs et un cadre de signature.
- Le module est un modèle de document : il n’exige aucune modification du cœur de Dolibarr.
Documents pris en charge
| Document | Modèle |
|---|---|
| Expéditions (bons de livraison) | BL Reliquat, au format PDF |
2. Prérequis et installation
2.1 Prérequis
| Élément | Version |
|---|---|
| Dolibarr | 20.0 à 24.0 |
| PHP | 7.4 à 8.3 |
| Framework NSINFO (module NSINFO) | 23.8.0 ou plus, installé et activé (gratuit) |
| Module Expédition | Activé |
| Module DPersoPlus | Facultatif, nécessaire seulement pour le cadre de signature |
Le framework NSINFO est obligatoire. Si le module NSINFO n’est pas installé et activé dans une version suffisante, l’activation de BL Reliquat est refusée avec un message d’erreur qui le rappelle.
2.2 Installation
- Installer et activer le module NSINFO (version 23.8.0 ou plus).
- Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive ZIP du module BL Reliquat, puis cliquer sur « ENVOYER FICHIER ».
- Dans la liste des modules installés, activer « BL Reliquat ».
- Ouvrir la configuration du module Expédition et choisir le modèle BL Reliquat pour les bons de livraison.
- Vérifier la configuration du module (roue crantée du module BL Reliquat).
3. Configuration
Page de réglages : Configuration > Modules, roue crantée du module BL Reliquat. La page comporte les onglets Réglages, Couleurs, ainsi que ChangeLog et À propos, fournis par le framework NSINFO. Les réglages sont réservés aux administrateurs et sont enregistrés dès qu’ils sont modifiés.
3.1 Options (onglet Réglages)
| Option | Description | Défaut |
|---|---|---|
| Nom du modèle PDF | Nom affiché pour ce modèle dans la liste des modèles de bons de livraison. | « BL Reliquat » |
| Largeur de la colonne référence | Largeur de la colonne Réf. dans le PDF. | 25 |
| Ajouter un cadre de signature | Affiche le cadre de signature sur le bon. Ce cadre n’apparaît que si le module DPersoPlus est activé (voir 4.2). | Non |
Le lien Ouvrir la page de configuration du module Expédition ouvre directement les réglages des expéditions.

3.2 Affichage du PDF (onglet Réglages)
| Option | Effet dans le PDF | Défaut |
|---|---|---|
| Masquer la colonne Poids / Volume | Commande la présence de la colonne Poids / Volume. | Non |
| Afficher la colonne des produits déjà expédié | Ajoute la colonne Qté déjà livrée. | Non |
| Cacher les descriptions | Masque les descriptions des produits sous leur désignation. | Non |
| Cacher la colonne référence | Retire la colonne Réf. du bon. | Non |

3.3 Couleurs (onglet Couleurs)
Chaque section de l’onglet correspond à un élément du bon :
- Information entreprise : Remplissage (couleur de fond) et Contour (couleur du cadre).
- Quantité commandée, Quantité à expédier, Quantité reliquat : pour chacune, une Couleur et une case Gras.
- Poids / Volume : mêmes réglages, pour la colonne Poids / Volume.
Les couleurs du cadre Information entreprise s’appliquent lorsque ni DPersoPlus ni Docperso ne sont activés. Sinon, c’est la mise en forme de ces modules qui s’applique au cadre.
4. Utilisation
4.1 Générer un bon de livraison
- Ouvrir l’expédition (bon de livraison) dont on veut le PDF.
- Dans la zone des documents, choisir le modèle BL Reliquat, puis lancer la génération.
- Le PDF reprend les produits de la commande, avec les quantités décrites dans la section 5.

4.2 Cadre de signature
Le cadre de signature s’affiche en bas du bon, côté droit, si les deux conditions suivantes sont réunies :
- le module DPersoPlus est activé ;
- l’option Ajouter un cadre de signature est cochée (onglet Réglages, sous-onglet Options).
Le cadre contient les mentions Reçu à et Le (à compléter à la main), Nom du signataire et Cachet.
5. Impression PDF
Le bon de livraison présente les colonnes suivantes, dans cet ordre :
| Colonne | Contenu | Affichage |
|---|---|---|
| Réf. | Référence du produit. | Masquée si « Cacher la colonne référence » est coché. Largeur réglée dans les Options. |
| Désignation | Libellé du produit, suivi de sa description. | La description disparaît si « Cacher les descriptions » est coché. |
| Qté commandée | Quantité commandée au client. | Suit l’option Dolibarr qui masque les quantités commandées sur les expéditions. |
| Qté déjà livrée | Quantité déjà expédiée lors des livraisons précédentes. | Si « Afficher la colonne des produits déjà expédié » est coché. |
| Qté à expédier | Quantité portée sur ce bon de livraison. | Toujours affichée. |
| Qté reliquat | Quantité restant à livrer après ce bon. | Toujours affichée. |
| Poids / Volume | Poids et volume des produits. | Présente selon l’option « Masquer la colonne Poids / Volume ». |

Les intitulés des colonnes et les couleurs se règlent comme indiqué dans la section 3. Le nom du modèle dans la liste des modèles est celui saisi dans « Nom du modèle PDF ».
6. Limites connues et FAQ
Le module refuse de s’activer.
- Le framework NSINFO doit être installé et activé, en version 23.8.0 ou plus.
- Dolibarr doit être en version 20 ou plus, et PHP en version 7.4 ou plus.
Le modèle BL Reliquat n’apparaît pas dans la liste des modèles.
- Vérifier que le framework NSINFO et le module BL Reliquat sont activés.
- Vérifier que le module Expédition est activé.
Le cadre de signature n’apparaît pas.
- Le module DPersoPlus doit être activé.
- L’option Ajouter un cadre de signature doit être cochée.
Les couleurs du cadre Information entreprise ne changent pas.
Ces couleurs ne s’appliquent que si DPersoPlus et Docperso ne sont pas activés (voir la note de la section 3.3).
La colonne Qté commandée ou Qté déjà livrée est absente.
Ces colonnes suivent l’option de Dolibarr qui masque les quantités commandées sur les bons de livraison. La colonne Qté déjà livrée doit aussi être cochée dans les Options d’affichage.
Autres limites
- Le modèle n’est pertinent que pour les expéditions (bons de livraison) : il ne traite pas les autres documents.
- Si le module NSINFO est désactivé après coup, la page de réglages de BL Reliquat n’est plus utilisable.