Notice du module Pack produits / services

Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

N° DoliStore493155
Modes de prix3 (Parent / Sum / Auto)
Documents pris en chargeDevis, commandes et factures clients
Compatibilité Dolibarrv18 à v24

1. Présentation du module

Le module Packs de produits et services permet de regrouper plusieurs produits ou services existants dans un seul « pack » (aussi appelé forfait ou lot) que l'on vend comme un tout. Un pack est en réalité un produit Dolibarr à part entière, reconnaissable à son préfixe de référence (« PK- » par défaut), auquel on rattache une liste de composants avec, pour chacun, une quantité, un taux de TVA, un prix unitaire HT et TTC, une remise et une description. L'intérêt se mesure surtout sur les documents commerciaux : il suffit d'ajouter le pack en une seule ligne dans un devis, une commande ou une facture, et le module se charge de le « déplier » en affichant le détail de tous les composants qu'il contient. Vous gagnez du temps à la saisie tout en remettant au client un document clair et détaillé. En arrière-plan, le module tient à jour la fiche du produit-pack (prix, taux de TVA, description du contenu) et l'enregistre comme produit composé de Dolibarr. Tout repose sur les objets natifs — produits, services, catégories, devis, commandes, factures — sans jamais dupliquer votre catalogue.

  • Vendre un ensemble de produits et de services comme une offre unique : pack, forfait ou lot
  • Composer un pack à partir d'articles déjà présents dans votre catalogue, avec quantité, TVA, prix et remise pour chaque composant
  • Insérer un pack en une seule action dans un devis, une commande ou une facture, et le voir se détailler automatiquement
  • Choisir la présentation commerciale : prix porté par le pack, porté par les composants, ou pack aligné sur la somme de ses composants
  • Laisser le module tenir à jour le produit-pack : prix de vente, taux de TVA moyen, description du contenu et sous-produits
  • Rester dans Dolibarr : le pack est un produit du catalogue et ses composants sont vos articles, sans aucune donnée dupliquée

2. Créer et composer un pack

L'entrée « Créer un pack » du menu Produits/Services ouvre un formulaire unique : il crée le produit-pack dans le catalogue et enregistre ses composants dans la même validation.

  • La référence est proposée avec le préfixe des packs (« PK- » par défaut) ; si vous l'effacez, le module le remet en place à l'enregistrement.
  • Le libellé est obligatoire ; la description, le statut (actif ou inactif) et le type (produit ou service) alimentent la fiche du produit-pack créé dans le catalogue.
  • Chaque composant se saisit sur une ligne : produit ou service existant, description, TVA, prix unitaire HT, prix unitaire TTC, quantité et remise en pourcentage.
  • Les boutons « + » et « - » ajoutent ou retirent des lignes de composant à la volée, sans quitter l'écran.
  • Dès qu'un article est choisi dans la liste, sa TVA, ses prix HT et TTC et sa description se remplissent d'eux-mêmes, et la quantité est initialisée à 1.
  • Un raccourci ouvre la fiche de création de produit de Dolibarr dans un nouvel onglet, puis ramène sur le pack en cours de saisie.
  • Une ligne sans article ou sans quantité est signalée en rappelant son numéro ; rien n'est enregistré tant qu'une ligne reste incomplète.
  • Deux cases à cocher déterminent si les descriptions des composants restent visibles sur les fiches Dolibarr et sur les documents PDF ; ce choix s'applique à l'ensemble des packs.

3. Transformer un article existant en pack

Il n'est pas obligatoire de passer par le formulaire de création : le module reconnaît un pack à sa référence, directement depuis le catalogue.

  • Tout produit ou service dont la référence commence par le préfixe des packs est pris en charge dès sa création, sa modification ou sa duplication.
  • L'article est automatiquement rattaché à la catégorie de produits « Pack-Cat », créée si elle n'existe pas encore.
  • Une entête de pack est créée pour lui, ce qui le fait apparaître dans la liste des packs ; il ne reste plus qu'à lui ajouter ses composants.
  • Les packs créés depuis le formulaire du module rejoignent la même catégorie : tous les packs se retrouvent donc d'un seul coup dans le catalogue.

4. Consulter la liste des packs

L'entrée « Packs / Forfaits » du menu Produits/Services affiche l'ensemble des packs existants.

  • Chaque ligne indique la référence du pack, son libellé, son total HT et son total TTC, calculés à partir des composants et de leurs remises.
  • La liste se trie par référence ou par libellé.
  • Les actions proposées dépendent de vos droits : ouvrir le détail du pack, le modifier, le supprimer.
  • La suppression demande confirmation, puis retire le pack, ses composants, ses sous-produits et le produit-pack lui-même du catalogue.

5. Modifier un pack et ses composants

La fiche d'un pack réunit son entête, ses totaux et le tableau complet de ses composants : tout s'y modifie sans repartir de zéro.

  • Le bouton de modification ouvre l'entête en saisie : référence, libellé, description, statut, type et affichage des descriptions des composants.
  • À l'enregistrement de l'entête, les prix HT et TTC, la TVA et les descriptions de tous les composants sont réalignés sur les fiches des articles correspondants.
  • Un bloc de saisie, en bas du tableau, ajoute un ou plusieurs composants avec le même remplissage automatique et les mêmes boutons « + » et « - ».
  • Chaque composant se modifie directement dans le tableau, ou se supprime d'un clic.
  • Le tableau affiche pour chaque composant la TVA, les prix unitaires HT et TTC, la quantité, la remise et les totaux de la ligne ; les totaux du pack sont recalculés à chaque changement.
  • La fiche conserve les onglets habituels du produit Dolibarr : vous passez directement au stock, aux prix ou aux documents liés.
  • Le produit associé au pack reste accessible en un clic depuis la fiche.

6. Ajouter un pack dans un devis, une commande ou une facture

Sur les devis, les commandes clients et les factures clients, le module ajoute un bloc d'insertion au-dessus des lignes du document.

  • La liste déroulante présente les packs disponibles avec leur référence et leur libellé.
  • Indiquez la quantité de packs souhaitée, puis validez : le pack est ajouté, puis immédiatement détaillé en ses composants.
  • Un message confirme l'ajout en rappelant la référence du pack.
  • Le bloc n'apparaît que si au moins un pack existe et si vous disposez du droit de création des packs.
  • Un produit-pack saisi comme un article ordinaire dans les lignes du document est lui aussi détaillé, dès que le document est régénéré.

7. Déplier automatiquement le pack en lignes détaillées

C'est le cœur du module : une ligne de pack devient un ensemble formé d'une ligne principale et d'une ligne par composant, et cet ensemble reste cohérent tant que le document est en préparation.

  • Une ligne « parent » porte le pack, suivie d'une ligne « enfant » rattachée pour chaque composant, que Dolibarr présente en retrait.
  • La quantité de chaque composant est calculée automatiquement : quantité définie dans le pack multipliée par la quantité de packs demandée.
  • Le libellé de la ligne de pack reprend la référence et le libellé du produit-pack, la quantité lorsqu'elle dépasse 1, puis la description du pack.
  • À chaque régénération du document — ce que Dolibarr fait après chaque modification de ligne — le module contrôle les composants et les reprend si une quantité, une TVA, un prix, une remise ou une description a changé.
  • La suppression de la ligne de pack retire ses composants dans le même mouvement.
  • Les totaux du document sont recalculés après chaque dépliage.
  • Ces écritures ne concernent que les documents au brouillon : dès qu'un document est validé, le module ne réécrit plus aucune ligne ni aucun total, afin de ne jamais modifier un document déjà consigné.

8. Choisir le mode d'affichage des prix

Trois façons de répartir les montants entre la ligne de pack et ses composants. Le choix se fait une fois pour toutes dans la configuration et s'applique de la même manière à la saisie et au document imprimé.

  • « SUM », retenu par défaut : les montants sont portés par les composants, et la ligne de pack devient une ligne de texte qui sert de titre, sans montant.
  • « PARENT » : le prix du produit-pack reste sur la ligne de pack, et les composants sont listés à titre informatif, sans montant ni remise.
  • « AUTO_SUM_TO_PARENT » : la ligne de pack est valorisée à la somme de ses composants, remises comprises, et les composants sont listés sans montant.
  • Quel que soit le mode, les composants restent de véritables lignes d'articles du document, rattachées à la ligne du pack.

9. Ce que le module tient à jour sur le produit-pack

Chaque fois que les composants d'un pack changent, le module remet à jour la fiche du produit-pack dans le catalogue.

  • Le prix de vente HT et TTC du produit-pack devient le total de ses composants, remises comprises, et le prix minimum suit la même valeur.
  • Le taux de TVA du produit-pack est recalculé comme le taux moyen de ses composants.
  • Le prix de revient et le prix moyen pondéré sont alignés sur le total HT des composants, lorsque ces champs existent.
  • La description du produit-pack est complétée par un bloc « Contenu du pack : » qui énumère chaque composant avec sa quantité, sa référence et son libellé ; le texte saisi avant ce bloc est conservé.
  • Le nouveau prix est inscrit dans l'historique des prix du produit, comme pour n'importe quel article.
  • Les composants sont également enregistrés comme sous-produits du produit-pack, afin que le pack se comporte comme un produit composé de Dolibarr.

10. Mise en forme sur les documents et les PDF

Le module soigne la lecture des lignes de pack, à l'écran comme sur les documents PDF générés par Dolibarr.

  • À l'écran, la ligne de pack s'affiche en noir avec sa référence en gras italique, et ses composants dans une teinte plus discrète.
  • La description de chaque composant est rappelée sous son libellé dans les lignes du document.
  • Sur les PDF, la ligne de pack et ses composants reçoivent le même traitement visuel : pack mis en évidence, composants en retrait et en gris.
  • Si l'affichage des descriptions des composants est décoché, les lignes enfants sont réduites sur le PDF à leur référence et à leur libellé.

11. Configurer le module

L'écran de configuration, réservé aux administrateurs, rassemble trois réglages et deux outils d'entretien.

  • Le préfixe qui identifie un pack dans le catalogue (« PK- » par défaut) : c'est lui qui déclenche la reconnaissance automatique des packs.
  • Le mode de prix : « PARENT », « SUM » (valeur par défaut) ou « AUTO_SUM_TO_PARENT ».
  • Un réglage d'impact sur le stock des composants, positionné à « YES » par défaut.
  • Un bouton de reconstruction : il recrée au besoin les tables du module, réenregistre ses menus, ses hooks et ses déclencheurs, remet les réglages absents à leur valeur par défaut, puis resynchronise tous les packs (sous-produits, catégorie, prix et description du produit-pack) ; un compte-rendu chiffré s'affiche à l'issue.
  • Un bouton de mise à jour en masse : il reprend, pour tous les packs, les prix HT et TTC, la TVA et les descriptions des composants depuis les fiches des articles, et indique le nombre de packs traités, réussis ou en échec, ainsi que le nombre de lignes contrôlées et mises à jour.
  • À l'installation comme à la reconstruction, le module active l'option native des sous-produits de Dolibarr, nécessaire pour que le pack se comporte comme un produit composé.

12. Droits d'accès, portée et langues

Le module s'appuie sur la gestion des permissions de Dolibarr, groupe par groupe et utilisateur par utilisateur.

  • Trois droits sont proposés : consulter les packs, créer et modifier les packs, supprimer les packs.
  • Le droit de consultation est accordé par défaut ; la création et la suppression doivent être attribuées explicitement.
  • Sans droit de consultation, ni le menu ni les écrans du module ne sont accessibles ; sans droit de création, le bloc d'insertion de pack n'apparaît pas sur les documents.
  • L'écran de configuration et les outils d'entretien sont réservés aux administrateurs.
  • Packs et composants sont cloisonnés par entité : en environnement multi-société, chaque entité ne voit que ses propres packs.
  • Les libellés du module sont fournis en cinq langues : français, anglais, allemand, espagnol et italien.

13. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

  • Produits et services : Fondation du module : un pack est un produit Dolibarr natif et chaque composant est un produit ou un service existant du catalogue. Prix, TVA et descriptions sont repris des fiches articles, sans doublon ni catalogue parallèle.
  • Catégories de produits : Chaque produit-pack est rattaché automatiquement à la catégorie de produits « Pack-Cat », créée si elle n'existe pas encore. Elle permet de retrouver et de filtrer tous les packs depuis le catalogue habituel.
  • Devis, commandes et factures clients : Le module y ajoute le bloc d'insertion de pack, déplie les composants sous la ligne du pack, met les lignes en forme et retire les composants lorsque la ligne du pack est supprimée. Ces opérations n'ont lieu que sur un document au brouillon.
  • Achats fournisseurs : Le dépliage automatique sait également traiter une ligne de pack sur une demande de prix fournisseur : il s'applique à la génération du document, tant que celui-ci est au brouillon. Le bloc d'insertion de pack, lui, reste propre aux devis, commandes et factures clients.
  • Produits composés / sous-produits (kits) : Les composants d'un pack sont recopiés dans les sous-produits natifs du produit-pack, et l'option correspondante de Dolibarr est activée par le module : le pack se comporte comme un produit composé, en cohérence avec le catalogue.
  • Prix des produits : Le prix de vente, le prix minimum et le taux de TVA du produit-pack sont recalculés à partir des composants, et chaque recalcul est enregistré dans l'historique des prix natif du produit.
  • Gestion du stock : Les composants étant de véritables lignes d'articles sur le document, ils suivent les mécanismes de stock habituels de Dolibarr. Un réglage du module accompagne par ailleurs l'enregistrement des sous-produits du pack.
  • Génération des documents PDF : C'est la génération du document qui rejoue le dépliage des packs lorsque le document est au brouillon ; le module profite du même mécanisme pour mettre en forme les lignes du pack sur le PDF, pack en évidence et composants en retrait.
Besoin d'aide ? WhatsApp Téléphone: 07 45 15 75 87 Téléphone: 07 43 52 58 29 Email Ouvrir le formulaire