Produits associés

• 1- Le module Produits associés
• 1.1- Présentation
• 1.2- Avant de commencer
• 1.3- Mise en route
• 2- Utilisation
• 2.1- Explication de l’écran d’affichage
• 2.2- Associer le produit courant à un autre
• 2.3- Associer des produits au produit courant
• 2.4- Les produits requis
• 2.5- Copier des liaisons entre produits
• 2.6- Les produits associés dans une pièce commerciale
• 2.7- Catégories de produits associés
• 2.8- Produits associés et remise client
• 3- Les options du module
• 3.1- Définir l'ordre des catégories des produits associés (enfants)
• 3.2- Regrouper les produits associés requis par catégorie
• 3.3- Regrouper les produits associés optionnels (non requis) par catégorie
• 3.4- Ne pas afficher les champs supplémentaires (extrafields) dans la liste des produits associés
• 3.5- Mettre en fin de liste les produits dont la catégorie n'est pas ordonnée
• 3.6- Constantes cachées
• 3.7- API pour récupération des associations de produits
• 4- Pour finir
• 4.1- Question fréquentes / Informations pratiques

1- Le module Produits associés

1.1- Présentation

1.1.1- Fonctionnalités 

Le module Produits associés permet la définition de produits et services complémentaires à un autre et la suggestion automatisée de leur ajout dans les propositions commerciales, commandes et factures clients lors de la sélection d'un produit principal.

L'utilisateur garde la main sur la destination des produits associés que ce soit sur la confirmation ou non de leur ajout, modification de leur quantité, remise, etc.

1.1.2- Compatibilité et conformité du module 

Le module est compatible avec Dolirent, notre solution de gestion de la location de matériel avec Dolibarr. Il fonctionne aussi avec les modules Sous-total et Multi-société. 

Par ailleurs, il est conforme à la Norme NF 525 - loi de finances 2016. 

1.1.3- Cible

Le module s'adresse à tous les utilisateurs de Dolibarr. Son utilisation ne nécessite aucune connaissance technique ou d'administration.

1.1.4- Licence 

Tous nos modules sont distribués sur notre boutique en ligne et sur le Dolistore sous licence GPL v3.

1.1.5- Ressources

1.1.5.1- La présente documentation

Nos guides utilisateurs sont là pour vous accompagner sérieusement dans l'utilisation de nos modules. Certains contiennent de nombreuses pages, mais leur lecture est essentielle pour la bonne compréhension des fonctionnalités des modules.

1.1.5.2- Notre site de démonstration

Le module est installé sur notre environnement de démonstration. Connectez-vous avec l'identifiant demo et le mot de passe demo. 

1.1.5.3- Forum

Consultez toutes les informations sur le module dans les discussions des forums Français.

Nous créons pour chacun de nos modules une discussion sur le forum dolibarr. Ces discussions contiennent de nombreuses informations. Aussi, si vous avez des commentaires et suggestions, pour une réponse plus rapide, il est préférable de continuer sur cette même conversation.

Note

Le forum est un lieu d'échange autour de l'utilisation et des fonctionnalités de nos modules. En cas de difficultés d'utilisation ou pour toute remontée de bogue, vous pouvez créer un ticket sur notre intérface de support. Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet sur le forum.

1.2- Avant de commencer

1.2.1- Avertissement

Nous assurons le bon fonctionnement de nos modules sur les environnements natifs de Dolibarr. Nous ne pouvons pas en garantir le bon fonctionnement suite à des modifications effectuées sur les fichiers du noyau de Dolibarr ou en cas d'utilisation d'autres modules additionnels.

1.2.2- Pré-requis techniques

Le module Produits associés est compatible avec Dolibarr à partir de la version 10. Pour une utilisation sur des versions antérieures de Dolibarr, reportez-vous au module Produits associés – OLD.

1.2.3- Mises à jour

Les dernières versions de nos modules sont mises à disposition sur le Dolistore et sur notre site internet.

 L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de leur date d'achat.

Avant toute mise à jour, assurez-vous que le module est officiellement compatible avec la version de Dolibarr sur laquelle vous souhaitez l'installer.

Pour mettre à jour un module, téléchargez-le à nouveau sur le Dolistore avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement sur le Dolistore les dernières versions de nos modules.

Dézippez les fichiers de la dernière version du module dans le répertoire custom de votre environnement et confirmez le remplacement de ceux déjà présents.

Note

Pour le bon déroulement d'une mise à jour, désactivez le module avant de lancer le remplacement de ses fichiers puis de le réactiver. À l'issue de la mise à jour, il est conseillé de répéter l'opération de désactivation/activation pour être sûr du bon déroulement d'une éventuelle mise à jour de votre base de données. Vérifiez enfin que de nouveaux paramétrages ne soient pas nécessaires.

1.3- Mise en route

1.3.1- Procédure d'installation

Si vous avez accès aux fichiers de votre Dolibarr, dézipper l'archive du module dans le dossier custom de son arborescence.

Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page :

Accueil > Configuration > Modules/Applications, onglet Déployer un module externe. 

1.3.2- Activation 

Activez le module en affichant la liste des modules depuis les menus :

Accueil > Configuration > Modules/Applications, onglet Modules/Applications installés. Il sera affiché dans le tableau Altairis.

1. Activez le module en cliquant sur la pastille pour quelle devienne verte
2. Pour désactiver le module cliquer de nouveau sur la pastille pour quelle devienne blanche 

1.3.3- Permissions

Le module ne permet pas la limitation d'accès à ses fonctionnalités par utilisateur ou groupes. Toutes les fonctionnalités du module sont donc accessibles à tous les utilisateurs ayant accès aux produits / services.

1.3.4- Paramétrage

La page de configuration du module est accessible depuis la liste des modules installés (Accueil > Configuration > Modules/Applications) en cliquant sur son icône .

2- Utilisation

2.1- Explication de l’écran d’affichage

Le module fonctionne aussi bien pour les produits que pour les services, pour de la vente et pour de la location. Pour la suite de cette documentation, par simplicité, nous utiliserons le terme produit. Le module ajoute aux fiches des produits l'onglet Produits associés, dont voici en exemple plus bas le fonctionnement.

2.1.1- Cette page se compose de deux parties

2.1.1.1- Première partie : gestion du produit courant en tant que produit associé à un autre

1. 1. 1. La liste des produits auxquels le produit courant est associé : Le produit courant sera donc proposé à l'ajout lors de la sélection dans une pièce commerciale des produits listés ici.
      2. La liste de sélection d'un produit auquel associer le produit courant à un autre : Il s'agit de la création d'une nouvelle association entre le produits courant et un autre produit principal.
      3. Le bouton copier des produits principaux du produit courant vers un autre qui ne s'affiche que si le produit est associé à au moins un produit.

2.1.1.2- Deuxième partie : gestion des produits associés au produit courant 

1. 1. 1. La liste des produits associés au produit courant : Les produits associés seront donc proposés à l'ajout lors de la sélection dans une pièce commerciale des produits listés ici.
      2. La liste de sélection pour associer un produit au produit courant : Cette liste permet de créer l'association.
      3. Le bouton copier des produits associés au produit courant vers un autre qui ne s'affiche que si le produit a au moins un produit associé.

Note

Les figures de ce chapitre portent sur une imprimante à laquelle nous allons associer des cartouches d’encre, un câble d’alimentation, une assurance et qui se verra elle-même associait à des ordinateurs : dans les faits, lorsque vous ajouterez l’imprimante dans un devis, une commande ou une facture, il vous sera proposé de lui ajouter les cartouches d’encre, un câble d’alimentation et une assurance. Lorsque vous ajouterez à un autre document un ordinateur, alors l’imprimante vous sera proposée.

2.2- Associer le produit courant à un autre

Depuis le tableau "Liste des produits auxquels ce produit est associé", tapez la première lettre où plusieurs lettres pour voir apparaître une liste déroulante et sélectionner le produit souhaitez ou tapez simplement son nom en entier et il s’affichera automatiquement.

Indiquez ensuite la QUANTITÉ souhaitée pour la vente du produit associé et si le produit est REQUIS coché la case.

Les produits principaux auxquels le produit courant est associés sont listés dans la partie supérieure.

NOTE

Si vous avez notre module de Gestion de location activé et que le produit sur lequel vous vous trouver est un produit de vente et de location, vous aurez la possibilité d'associé un produits en choisissant si c'est une association pour la location ou la vente.

2.3- Associer des produits au produit courant

Depuis le tableau "Produits associés", tapez la première lettre où plusieurs lettres pour voir apparaître une liste déroulante et sélectionner le produit souhaitez ou tapez simplement son nom en entier et il s’affichera automatiquement.

Indiquez ensuite la QUANTITÉ souhaitée pour la vente du produit associé et si le produit est REQUIS coché la case.

Les produits associé aux le produit courant sont listés dans la partie supérieure.

NOTE

Si vous avez notre module de Gestion de location activé et que le produit sur lequel vous vous trouver est un produit de vente et de location, vous aurez la possibilité d'associé un produits en choisissant si c'est une association pour la location ou la vente.

2.4- Les produits requis

Si un produit associé est indiqué comme REQUIS il sera pré-coché lors de l’ajout du produit principal dans un document commercial.

Les utilisateurs restent libres de décocher un produit marqué comme requis. Et de sélectionner l’option vente si le produit est en vente et l’option location si le produit ou le service est en location .

Exemple indiquant les produits requis dans la liste des produits associés :

Note

Pour supprimer les produits associés à un autre, utilisez l'icône en bout de chaque ligne à droite (la suppression est alors immédiate sans message de confirmation), ou, cochez une ou plusieurs cases en bout de ligne à gauche avant de cliquer sur le bouton SUPPRIMER.

2.5- Copier des liaisons entre produits

Pour ne pas refaire une saisie manuelle, les boutons copier permettent de reprendre une liste de produits associés d'un produit vers un autre ou d'ajouter à un autre produit tous les produits principaux du produit courant.

Les associations du produit source sont copiées dans les mêmes conditions, c’est à dire quantité et produit requis.

Selon votre objectif, tapez la première lettre où plusieurs lettres pour voir apparaître une liste déroulante et sélectionner le produit souhaitez ; puis cliquez sur copier. 

Exemple :

Exemple :

NOTE

Si vous avez notre module de Gestion de location activé et que le produit sur lequel vous vous trouver est un produit de vente et de location, vous aurez la possibilité de copier les produits en choisissant si c'est une association pour la location ou la vente.

2.6- Les produits associés dans une pièce commerciale

Une fois les produits associés liés au produit principal, vous pourrez dans une pièce commerciale ajouter le produit principal (l'imprimante), cliquer sur ajouter. Une fenêtre (popup) avec les produits associés s'affiche pour vous invitez à sélectionner les produits que vous souhaitez ajouter.

Cette fenêtre (popup) affiche en liste déroulée les produits requis que vous pouvez décocher si vous ne souhaitez pas les ajouter.

Les produits non requis sont en dessous et il vous faut cliquer sur "ouvrir" pour afficher la liste et cocher les produits que souhaiter ajouter.

 Vous pouvez également via cette fenêtre (popup) :

• modifier la quantité
• le prix unitaire hors taxes
• modifier la remise Produits requis avec liste des non requis fermés : "Options" concerne les produits non requis.

2.6.1- Produits requis avec liste des non requis fermés 

"Options" concerne les produits non requis.

2.6.2- Produits requis avec liste des non requis ouverte

"Options" concerne les produits non requis.

2.6.3- Après validation

Après avoir VALIDÉ les modifications apportées aux produits associés, ils seront ajoutés dans le document commercial en plus du produit initial et aux conditions juste définies.

2.7- Catégories de produits associés

2.8- Produits associés et remise client

3- Les options du module

3.1- Définir l'ordre des catégories des produits associés (enfants)

Il est possible d’afficher les produits associés au produit courant selon l’ordre des catégories.

3.1.1- Affichage sans avoir défini un ordre pour les catégories

3.1.2- Affichage après avoir défini un ordre pour les catégories

3.1.3- Affichage des produits associés ayant une catégorie et n’ayant pas de catégorie après avoir défini un ordre pour les catégories

Ici on voit les catégories des produits associés, trier comme on le souhaite par leur catégorie et les produits n’ayant pas de catégories sont triés par ordre alphabétique du nom du produit.

3.1.4- Comment définir l’ordre des catégories des produits associées 

Pour pouvoir trier les produits associés par leurs catégories, il vous faut aller sur la catégorie du produit courant.

3.1.4.1- Soit par le produit courant 

3.1.4.2- Soit par le sous menu du menu "Produits"

3.1.5- Dans le menu Tags/Catégories

3.1.5.1- Trier les catégories

Maintenant que vous êtes sur la catégorie cliquer sur modifier.

C’est ici que vous pourrez trier les catégories des produits associés au produit courant.

Cliquez dans "l’espace blanc" ou taper les premières lettres pour voir apparaître une liste déroulante de toutes les catégories dont certaines avec leurs sous-catégories existantes.

Choisissez la première catégorie (la disposition pourra être changée après) et cliquer sur le signe "plus" pour l’ajouter et ainsi de suite ; une fois fini cliquer sur modifier.

3.1.5.2- Pour supprimer ou modifier la disposition des catégories utiliser les deux boutons à droite de la liste.

Exemple :

3.2- Regrouper les produits associés requis par catégorie

Option à activer depuis la configuration du module.

Cette option permet depuis une pièce commerciale d’afficher les catégories liées aux produits requis dans la fenêtre (popup).

En cliquant sur la catégorie cela via déplier et replier la liste des produits requis se trouvant dans cette catégorie.

3.3- Regrouper les produits associés optionnels (non requis) par catégorie

Option à activer depuis la configuration du module.

Cette option permet depuis une pièce commerciale d’afficher les catégories liées aux produits optionnels (non requis).

En cliquant sur la catégorie cela via déplier et replier la liste des produits requis se trouvant dans cette catégorie.

3.4- Ne pas afficher les champs supplémentaires (extrafields) dans la liste des produits associés

Option à activer depuis la configuration du module.

Elle permet de ne pas afficher les champs supplémentaires (extrafields) dans la liste des produits associés dans la fenêtre (popup) ouverte quand on ajoute un produit à une pièce commerciale.

3.5- Mettre en fin de liste les produits dont la catégorie n'est pas ordonnée

Option à activer depuis la configuration du module.

Elle permet de placer à la fin de la liste au lieu du début les catégories des produits associés qui n'ont pas étés définies dans un ordre particulier lié à la catégorie du produit courant. Liste d’un ordre définie via les catégories de la catégorie du produit courant:

Liste d’un ordre définie via les catégories de la catégorie du produit courant, exception faite sur le produit CABL catégorie Cable :

3.6- Constantes cachées

Ici il s'agit de constante dite cachée, car elle ne sont pas une option intégré à la configuration du module.

Il s'agit principalement de paramètres réservés pour les développeurs et dépannage avancé uniquement.

Si l'une d’elle vous convient dans votre utilisation du module, vous pouvez aller dans Accueil > Configuration > Divers.

Indiquez le nom de la constante ça valeur 1 pour l'activer 0 pour la désactiver, vous pouvez mettre un commentaire (optionnel) puis cliquez sur Ajouter.

Pour modifier une valeur de la constante, il faut suffit de changer la valeur et de cliquer en bas à droite en bas du tableau sur modifier (la case de droite se coche automatiquement).

Pour supprimer une constante, coché la case de droite et cliquer à droite en bas du tableau sur Supprimer.

Les constantes cachées Lié à l'utilisation du module en général
Nom de la constante	Valeur à noter	Ce que ça fait
RELATEDPRODUCTS_MILESTONE_CATEGORY_LABEL	Label, 0 Description, 1 Label + Description, 2  Ne marquer que le chiffre.	Vous pouvez choisir d’afficher soit le label, soit la description soit les deux.
RELATEDPRODUCTS_ADD_MILESTONE_CATEGORY	1 ou 0	Permet de rajouter la catégorie (des produits associés) en tant que ligne titre dans les documents pour les clients (propositions commerciale, commandes, et factures).
RELATED_PRODUCTS_REMOVE_EOL	1 ou 0	Permet de supprimer automatiquement les produits qui ne sont plus en achat de la liste des produits associés quand il n'y a plus de stock ou qu'il ne sont plus en vente. Agit a la validation d'une commande Dolibarr et TakePos, sur les mouvements de stock et sur la modification du produit.

3.7- API pour récupération des associations de produits

4- Pour finir

4.1- Question fréquentes / Informations pratiques

4.1.1- Question fréquentes

4.1.1.1- Bonnes pratiques 

Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.

Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :

1. 1. 1. désactivez et réactivez le module
      2. vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr
      3. ré-installez/mettez à jour le module
      4.  vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée ; le cas échéant, suivez nos préconisations

Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant notre interface de support.

 Pour plus d’efficacité dans l’étude de votre demande, précisez :

• • • le nom et la version du module
    • la version de Dolibarr
    •  la liste des modules additionnels activés
    •  tous les éléments nécessaires à la meilleure des prises en charge de votre demande, comme le contexte, les étapes successives pour reproduire l'erreur, captures d'écran, etc.

4.1.1.2- Autres difficultés

Aucune difficulté connue à ce jour.

4.1.2- Informations pratiques 

4.1.2.1- Liens directs

Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous :

• • • Produits associés sur notre site
      
    • Le forum français

4.1.2.2- Support

Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de support est à votre disposition pour signaler un bug rencontré. 

Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de nos forfaits de support.

4.1.2.3- Crédit et historique des modifications

Pour la présente documentation du module Produits associés pour Dolibarr : 

Version	Auteurs	Date	Licence
1	Cloé Thévenon - Sarl ALTAIRIS	05/2024	GFDL
2	Mélina Joum	12/2023	GFDL