Documentation KSIDol > Modules KSIDol > Pack produits / services
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 / Somme / Auto)
Documents pris en chargeDevis, commandes, factures, interventions
Compatibilité Dolibarrv18 à v24
1. Presentation 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, identifié par un préfixe de référence (par défaut « PK- »), auquel on rattache une liste de composants avec leur quantité, leur TVA, leur prix et une éventuelle remise.
L'intérêt principal apparaît 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 automatiquement de le « déplier » en affichant le détail de tous les composants qu'il contient. Vous gagnez du temps à la saisie tout en conservant un document clair et détaillé pour le client. Le module s'appuie entièrement sur les objets natifs de Dolibarr (produits, services, catégories, devis, commandes, factures) sans dupliquer votre catalogue.
- Vendre un ensemble de produits/services comme une offre unique (pack, forfait, lot)
- Composer un pack à partir de produits et services déjà présents dans votre catalogue
- Insérer un pack en un clic dans un document et le voir se détailler automatiquement
- Choisir la façon dont les prix s'affichent (sur le pack ou sur chaque composant)
- Rester 100 % dans Dolibarr : le pack est un produit, ses composants sont vos articles
2. Créer et composer un pack
Depuis le menu Produits/Services, l'entrée « Créer un pack » ouvre un formulaire qui crée le produit-pack et permet de définir ses composants dans la foulée.
- Renseigner la référence du pack (le préfixe « PK- » est proposé et complété automatiquement), un libellé, une description, un statut (actif/inactif) et le type (produit ou service)
- Ajouter autant de composants que nécessaire : chaque ligne pointe vers un produit ou service existant, avec quantité, TVA, prix unitaire HT, prix unitaire TTC, remise (%) et description
- Ajouter ou retirer des lignes de composant à la volée grâce aux boutons « + » et « - »
- Bénéficier du remplissage automatique du prix, de la TVA et de la description dès qu'un produit est sélectionné dans la liste
- Créer directement un nouveau produit/service à intégrer au pack via un raccourci, sans quitter l'écran
3. Consulter et gérer la liste des packs
L'entrée « Packs / Forfaits » du menu Produits/Services affiche l'ensemble des packs déjà créés et donne accès à leur gestion.
- Voir chaque pack avec sa référence, son libellé, son total HT et son total TTC (calculés à partir des composants)
- Trier la liste par référence ou par libellé
- Ouvrir le détail d'un pack, le modifier ou le supprimer directement depuis la liste
- Accéder à la fiche d'un pack qui récapitule le produit lié, les totaux et le tableau complet des composants
4. Modifier les composants d'un pack
Sur la fiche d'un pack, un tableau liste tous les composants et permet de les faire évoluer sans repartir de zéro.
- Ajouter un nouveau composant (produit/service, quantité, TVA, prix HT, prix TTC, remise, description)
- Modifier une ligne existante directement dans le tableau
- Supprimer une ligne de composant
- Voir se recalculer automatiquement le total HT et le total TTC du pack à chaque changement
- Réactualiser en un clic les prix, TVA et descriptifs de tous les composants à partir des fiches produits (mise à jour en masse depuis la configuration)
5. Ajouter un pack dans un devis, une commande ou une facture
Sur les écrans de devis, de commande et de facture (ainsi que sur les contrats), le module ajoute un bloc dédié pour insérer un pack.
- Choisir un pack dans une liste déroulante et indiquer une quantité
- Insérer le pack en une seule action grâce au bouton « Ajouter »
- Le pack est ajouté comme une ligne, puis automatiquement détaillé sur le document
- Un message confirme que le pack a bien été ajouté au document
6. Déplier automatiquement le pack en lignes détaillées
C'est le cœur du module : dès qu'une ligne « pack » est présente sur un document, le module la transforme en un ensemble ligne principale + composants, et maintient cet ensemble à jour.
- Une ligne « parent » représente le pack, suivie d'une ligne « enfant » pour chaque composant
- La quantité de chaque composant est calculée automatiquement (quantité du composant × quantité de pack commandée)
- Si vous modifiez la quantité du pack, les composants sont recalculés en conséquence
- Si vous supprimez la ligne du pack, tous ses composants sont retirés en même temps
- Les totaux du document sont recalculés automatiquement après le dépliage
7. Choisir le mode d'affichage des prix
Le module propose trois façons de répartir les montants entre la ligne du pack et ses composants, selon la présentation commerciale souhaitée.
- Parent : le prix reste sur la ligne du pack et les composants sont affichés à titre informatif (montants à zéro)
- Somme (Sum) : les montants sont portés sur chaque composant et la ligne du pack est remise à zéro
- Auto (Auto sum to parent) : les composants gardent leurs montants et la ligne du pack est automatiquement alignée sur leur somme
- Le mode retenu s'applique de la même manière à la saisie et au document imprimé
8. Configurer le module
L'écran de configuration (réservé à l'administrateur) rassemble les réglages d'adaptation et deux outils de maintenance.
- Définir le préfixe qui identifie un produit comme pack (par défaut « PK- »)
- Choisir le mode de prix (Parent, Somme ou Auto)
- Activer ou non l'impact sur le stock des composants
- Reconstruire le fonctionnement du module (schéma, réglages, packs) et lancer la mise à jour en masse de tous les packs
- À l'installation et lors d'une reconstruction, le module active automatiquement les sous-produits natifs de Dolibarr (option PRODUIT_SOUSPRODUITS), nécessaires au dépliage des packs.
- Note : le dépliage des packs sur les contrats existe (via les déclencheurs Dolibarr) mais n'est pas activable depuis l'écran de configuration ; l'affichage ou non des descriptions des composants (fiches et PDF) se règle, lui, sur la fiche du pack elle-même, pas dans l'administration.
9. Mise en forme sur les documents et les PDF
Le module soigne le rendu des lignes de pack, à l'écran comme sur les documents PDF générés par Dolibarr.
- La ligne du pack est mise en évidence et sa référence apparaît en gras
- Les lignes des composants sont présentées de façon plus discrète, en retrait sous le pack
- Selon la configuration, la description détaillée des composants peut être affichée ou masquée sur les PDF
10. 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 service existant du catalogue. Les prix et TVA sont repris des fiches articles, sans doublon.
- Catégories de produits : Chaque produit-pack est automatiquement rangé dans une catégorie « Pack » (créée si elle n'existe pas), ce qui permet de retrouver et filtrer facilement les packs dans le catalogue.
- Devis, commandes et factures : Le module ajoute un bloc d'insertion de pack et déplie automatiquement les composants sur les propositions commerciales, les commandes clients et les factures clients.
- Achats fournisseurs : Le dépliage des packs fonctionne aussi sur les demandes de prix, commandes et factures fournisseurs, pour gérer des lots côté approvisionnement.
- Fiches d'intervention : Un pack ajouté sur une fiche d'intervention est détaillé en ses composants, utile pour les prestations combinant plusieurs produits/services.
- Contrats : Les packs sont également dépliés sur les lignes de contrat, via les déclencheurs Dolibarr (comportement non exposé dans l'écran de configuration).
- Produits composés / sous-produits (kits) : Le module se synchronise avec la fonction native des sous-produits de Dolibarr afin que le pack se comporte comme un produit composé (kit), en cohérence avec le catalogue.
- Gestion du stock : Une option permet d'activer ou de désactiver l'impact des composants sur le stock lors de leur utilisation dans un pack.
- Prix des produits : Le prix du produit-pack peut être synchronisé avec le total de ses composants dans l'historique de prix natif du produit.
- Génération des documents PDF : Via le mécanisme d'impression de Dolibarr, le module met en forme les lignes du pack sur les PDF (pack en évidence, composants en retrait, descriptions affichées ou masquées).
