Bon de livraison groupé

Le module produit un seul document pour plusieurs expéditions validées d’un même client. Il lit les expéditions et ne les modifie jamais.

La création

1. Dans ProduitsExpéditionsListe, cochez les expéditions du client.
2. Choisissez l’action de masse « Bon de livraison groupé (un seul PDF) ».
3. Un écran rappelle le client et les expéditions retenues : commande, référence client, date prévue de livraison, nombre de lignes, état. Ajoutez si besoin une note, imprimée sur le document, puis « Créer le bon de livraison groupé ».

Le PDF est créé aussitôt. Avant cela, le module vérifie trois points :

• au moins une expédition est sélectionnée ;
• aucune n’est en brouillon — sinon le message indique sa référence ;
• toutes concernent le même client.

Si un point manque, rien n’est créé et la raison s’affiche.

Le document

• En-tête : logo de votre société (sinon son nom), titre « Bon de livraison groupé », référence BLGaamm-NNNN, date, nombre d’expéditions et numéro de page.
• Bloc « Émetteur » avec l’adresse de votre société ; bloc « Adresse de livraison » avec le contact de livraison de la première expédition, sinon l’adresse du client.
• Un bloc par expédition, dans l’ordre des dates de livraison prévues (date de création à défaut) : « Expédition – Commande (Réf. client) – date ».
• Pour chaque ligne : référence, désignation, quantité commandée, quantité expédiée et poids (poids du produit × quantité expédiée).
• En bas : quantité totale livrée, poids total quand des lignes ont un poids, votre note, puis un cadre « Reçu en bon état le : / Nom et signature : ».

Sur plusieurs pages, l’en-tête de page et l’en-tête du tableau sont répétés, et l’expédition coupée par le saut de page est rappelée avec la mention « (suite) ».

La langue du PDF

Le document est rédigé dans la langue renseignée sur la fiche du client, sinon dans celle de l’utilisateur. Les libellés propres au module — titre, totaux, zone de signature — existent en français, anglais et allemand ; pour les autres langues, ils sont en anglais.

Retrouver un bon

• La fiche du bon groupé affiche le client, la date, la note, le lien vers le PDF et les expéditions, avec les boutons « Télécharger le PDF », « Régénérer le PDF » (après la modification d’une expédition) et « Supprimer ».
• ProduitsExpéditionsBons de livraison groupés : la liste de tous les bons.
• Sur la fiche de chaque expédition, une ligne « Bon de livraison groupé » renvoie au ou aux bons qui la contiennent.

Le PDF produit pour trois expéditions d’une épicerie fictive : un bloc par expédition, avec sa commande, sa référence client et sa date, puis les quantités et les poids. En bas, la quantité totale livrée (116), le poids total (71,6 kg), la note « Livraison hebdomadaire - quai 2 » et la zone de signature.

Dans la liste des expéditions, sous Dolibarr 24.0.1, les trois expéditions du client sont cochées. L’action « Bon de livraison groupé (un seul PDF) » s’ajoute aux actions de Dolibarr, sous « Fusion PDF ».

La fiche du bon BLG2610-0009 : client, date, note, lien vers le PDF, les trois expéditions avec leur commande, leur référence client et leur date prévue de livraison, et les boutons Télécharger, Régénérer et Supprimer.

Aucun : le module n’a pas de page de configuration. Le PDF reprend le logo et l’adresse de votre société, le format de papier et les marges définis dans Dolibarr.

• Deux droits dédiés : « Voir et télécharger les bons de livraison groupés » et « Créer, régénérer et supprimer les bons de livraison groupés ».
• Sans le second droit, l’action de masse n’apparaît pas dans la liste des expéditions, et la fiche d’un bon n’affiche que le bouton de téléchargement. Création, régénération et suppression sont refusées.
• Le droit de Dolibarr en plus : la liste, la fiche d’un bon et son PDF demandent aussi le droit de consulter les expéditions.
• Commerciaux limités à leurs clients : sans le droit Dolibarr de voir tous les tiers, un utilisateur ne voit, ne télécharge et ne crée que les bons des clients dont il est commercial attitré, comme dans les listes de Dolibarr ; un lien forgé vers un autre bon est refusé.
• Expéditions en lecture seule : le module ne modifie aucune expédition, aucune commande.
• Suppression confirmée : supprimer un bon demande une confirmation ; le bon, ses lignes et son PDF sont supprimés, les expéditions restent intactes.
• L’enregistrement d’un bon et de ses expéditions se fait dans une transaction : si l’écriture en base échoue, rien n’est enregistré.

• Le dossier du module, dolixblgroupe, à déposer dans htdocs/custom/ ou à installer depuis le zip.
• Trois langues : français (fr_FR), anglais (en_US) et allemand (de_DE).
• Un README.md et un journal des versions (ChangeLog.md) dans le dossier du module.
• Licence GPL v3 ou ultérieure, code source complet et lisible.

• Deux tables sont ajoutées : llx_dolixblg (un bon groupé : référence, client, note, utilisateur, date de création, entité) et llx_dolixblg_exp (les expéditions de chaque bon, dans l’ordre d’impression).
• Le PDF est rangé dans documents/dolixblgroupe/, dans un dossier au nom de la référence du bon.
• Les expéditions, leurs lignes et les commandes sont seulement lues. Aucun fichier de Dolibarr n’est modifié.
• À la désactivation, le menu, l’action de masse et le rappel sur la fiche expédition disparaissent. Les tables llx_dolixblg et llx_dolixblg_exp et les PDF déjà créés ne sont pas supprimés.