Logo du module BL Reliquat

BL Reliquat – Bon de livraison avec reliquat

Documentation du module · version 23.0.0 · éditeur NSINFO

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

DocumentModèle
Expéditions (bons de livraison)BL Reliquat, au format PDF

2. Prérequis et installation

2.1 Prérequis

ÉlémentVersion
Dolibarr20.0 à 24.0
PHP7.4 à 8.3
Framework NSINFO (module NSINFO)23.8.0 ou plus, installé et activé (gratuit)
Module ExpéditionActivé
Module DPersoPlusFacultatif, 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

  1. Installer et activer le module NSINFO (version 23.8.0 ou plus).
  2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive ZIP du module BL Reliquat, puis cliquer sur « ENVOYER FICHIER ».
  3. Dans la liste des modules installés, activer « BL Reliquat ».
  4. Ouvrir la configuration du module Expédition et choisir le modèle BL Reliquat pour les bons de livraison.
  5. 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)

OptionDescriptionDéfaut
Nom du modèle PDFNom affiché pour ce modèle dans la liste des modèles de bons de livraison.« BL Reliquat »
Largeur de la colonne référenceLargeur de la colonne Réf. dans le PDF.25
Ajouter un cadre de signatureAffiche 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.

Configuration du module, onglet Paramètres > Options : nom du modèle PDF, largeur de la colonne référence et cadre de signature.
Configuration du module, onglet Paramètres > Options : nom du modèle PDF, largeur de la colonne référence et cadre de signature.

3.2 Affichage du PDF (onglet Réglages)

OptionEffet dans le PDFDéfaut
Masquer la colonne Poids / VolumeCommande 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 descriptionsMasque les descriptions des produits sous leur désignation.Non
Cacher la colonne référenceRetire la colonne Réf. du bon.Non
Configuration du module, onglet Paramètres > Affichage du PDF : masquage du poids et du volume, colonne des produits déjà expédiés, descriptions et colonne référence.
Configuration du module, onglet Paramètres > Affichage du PDF : masquage du poids et du volume, colonne des produits déjà expédiés, descriptions et colonne référence.

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

  1. Ouvrir l’expédition (bon de livraison) dont on veut le PDF.
  2. Dans la zone des documents, choisir le modèle BL Reliquat, puis lancer la génération.
  3. Le PDF reprend les produits de la commande, avec les quantités décrites dans la section 5.
Bas de la fiche d'expédition : lignes de produits, bloc « Modèle de document : BL Reliquat » avec le bouton Générer, et PDF généré dans les fichiers joints.
Bas de la fiche d’expédition : lignes de produits, bloc « Modèle de document : BL Reliquat » avec le bouton Générer, et PDF généré dans les fichiers joints.

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 :

ColonneContenuAffichage
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ésignationLibellé du produit, suivi de sa description.La description disparaît si « Cacher les descriptions » est coché.
Qté commandéeQuantité commandée au client.Suit l’option Dolibarr qui masque les quantités commandées sur les expéditions.
Qté déjà livréeQuantité 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édierQuantité portée sur ce bon de livraison.Toujours affichée.
Qté reliquatQuantité restant à livrer après ce bon.Toujours affichée.
Poids / VolumePoids et volume des produits.Présente selon l’option « Masquer la colonne Poids / Volume ».
PDF « BL Reliquat » généré : colonnes Réf., Désignation, Qté commandée, Qté à expédier et Qté Reliquat (expédition soldée : la colonne reliquat est vide).
PDF « BL Reliquat » généré : colonnes Réf., Désignation, Qté commandée, Qté à expédier et Qté Reliquat (expédition soldée : la colonne reliquat est vide).

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.

Un projet Dolibarr ? Parlons-en.

Développement d’un module, paramétrage, migration ou simple question : nous vous répondons rapidement.

Powered by Joinchat