Description produit commande fournisseur

1. Présentation

Dans Dolibarr, chaque prix d’achat d’un produit peut avoir une description fournisseur : la désignation exacte du fournisseur, sa référence technique, son conditionnement… NsLibProductCmdeFrn place cette description sur les lignes de vos commandes fournisseur, à la place de la description destinée à vos clients.

• Automatiquement, à la création d’une commande fournisseur et à chaque ajout de ligne (option) ; le texte ajouté à la main sur la ligne est conservé, sauf sur les lignes reprises d’une commande client.
• D’un clic, avec le bouton « Appliquer les descriptions fournisseur » sur une commande fournisseur en brouillon (option, avec une permission dédiée).
• Le module ne modifie pas le Core de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

Élément	Version
Dolibarr	19.0 à 24.0 (testé sur 22.0)
PHP	7.4 à 8.3 (testé en 7.4)
Framework NSINFO (module « NSINFO »)	23.3.1 ou supérieur, installé et activé (page de réglages)
Module Commandes fournisseurs	Activé
Option du module Produits « Ajouter une fonctionnalité pour définir la description produit définie par les vendeurs (pour chaque référence vendeur) en plus de la description pour les clients »	Activée (voir 3.1)

2.2 Installation

1. Installer et activer le module NSINFO (version 23.3.1 ou supérieure).
2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive module_nslibproductcmdefrn-X.Y.Z.zip.
3. Dans la liste des modules, famille NSINFO, activer « Description produit commande fournisseur ».
4. Attribuer la permission du bouton aux utilisateurs ou groupes concernés.
5. Ouvrir la configuration (roue crantée du module) et choisir les options.

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactiver puis réactiver le module : c’est cette opération qui enregistre la permission et les points d’extension du module. Les réglages sont conservés.

Après la réactivation, seul l’administrateur qui a réactivé le module reçoit automatiquement la permission du bouton : pensez à l’attribuer aux autres utilisateurs ou groupes.

3. Configuration

Page de réglages : Configuration > Modules, roue crantée du module (onglets Réglages, ChangeLog et À propos fournis par le framework NSINFO). Réservée aux administrateurs.

3.1 Alerte sur les descriptions fournisseur

Le module ne peut fonctionner que si les descriptions fournisseur sont activées dans Dolibarr. Si ce n’est pas le cas, la page de réglages affiche en rouge, au-dessus des options :

« Attention : les descriptions produit fournisseur ne sont pas activées, ce module ne peut pas fonctionner.
Pour les activer : Accueil > Configuration > Modules/Applications > Produits > Configuration, option « Ajouter une fonctionnalité pour définir la description produit définie par les vendeurs (pour chaque référence vendeur) en plus de la description pour les clients ». »

Le lien « Ouvrir la configuration du module Produits » mène directement à cette page : activer l’option, puis revenir aux réglages du module. Le message disparaît dès que l’option est activée.

3.2 Alerte sur l’enregistrement du module

Le remplacement automatique repose sur des points d’extension que Dolibarr enregistre à l’activation du module. S’ils ne sont pas enregistrés (par exemple après une mise à jour sans réactivation), la page de réglages affiche en rouge :

« Attention : les triggers du module ne sont pas enregistrés, la description fournisseur n’est pas forcée à la création des lignes de commande fournisseur.
Pour les enregistrer : désactiver puis réactiver le module (les réglages sont conservés). »

Le lien « Ouvrir la liste des modules » mène à la liste des modules : désactiver puis réactiver « Description produit commande fournisseur ».

3.3 Options

Option	Description	Défaut
Forcer automatiquement la description fournisseur (si elle n’est pas vide) à la création de la commande fournisseur et à l’ajout d’une ligne	Remplacement automatique sur chaque nouvelle ligne de commande fournisseur (voir 5.2).	Non
Afficher le bouton « Appliquer les descriptions fournisseur » sur les commandes fournisseur brouillon	Affiche le bouton sur la fiche des commandes fournisseur en brouillon (voir 5.3).	Non
Libellé du bouton (texte ou clé de traduction)	Texte du bouton, ou clé de traduction d’un fichier de langue (le bouton est alors traduit dans la langue de chaque utilisateur). Si le champ est vide, le libellé par défaut est utilisé.	« Appliquer les descriptions fournisseur »
Couleur du bouton	Couleur de fond du bouton. La couleur du texte (noir ou blanc) s’adapte automatiquement pour rester lisible.	Rouge

Aperçu du bouton par défaut : Appliquer les descriptions fournisseur

4. Droits d’accès

Action	Droits nécessaires
Remplacement automatique à l’ajout des lignes	Aucun droit propre au module : il s’applique à toute ligne ajoutée par un utilisateur autorisé à créer des commandes fournisseur, dès que l’option est activée.
Bouton « Appliquer les descriptions fournisseur »	Permission du module « Utiliser le bouton « Appliquer les descriptions fournisseur » sur les commandes fournisseur » et droit Dolibarr de créer les commandes fournisseur.
Page de réglages	Administrateur.

Un utilisateur qui n’a pas la permission du bouton ne le voit pas.

5. Utilisation

5.1 Saisir la description fournisseur d’un produit

1. Ouvrir la fiche du produit, onglet Prix d’achat.
2. Ajouter ou modifier le prix d’achat du fournisseur.
3. Renseigner le champ Description du fournisseur du produit (visible une fois l’option du module Produits activée, voir 3.1), puis enregistrer.

Chaque prix d’achat (fournisseur + référence fournisseur) a sa propre description : un même produit peut donc avoir une description différente chez chacun de ses fournisseurs.

5.2 Remplacement automatique

Avec l’option « Forcer automatiquement la description fournisseur… » activée :

• à la création d’une commande fournisseur depuis une commande client, toute la description de chaque ligne est remplacée par la description fournisseur : la description reprise de la commande client, souvent modifiée à la main pour le client, n’est pas destinée au fournisseur ;
• à la création de la commande fournisseur, quelle que soit son origine, la description fournisseur remplace la description du produit sur toutes ses lignes ; le texte ajouté à la main est conservé ;
• à chaque ajout de ligne de produit sur une commande fournisseur, la description fournisseur remplace la description du produit ; le texte ajouté à la main sur la ligne (avant ou après la description du produit) est conservé ;
• si la description fournisseur est vide, la ligne reste telle qu’elle a été saisie.

5.3 Bouton « Appliquer les descriptions fournisseur »

1. Ouvrir une commande fournisseur au statut brouillon.
2. Cliquer sur le bouton Appliquer les descriptions fournisseur (avec les autres boutons d’action de la fiche). Le survol du bouton rappelle son effet.
3. Le message « N ligne(s) mise(s) à jour avec la description fournisseur » indique le nombre de lignes modifiées.

Le bouton remplace toute la description de chaque ligne : le texte ajouté à la main sur ces lignes est supprimé. Les lignes dont le produit n’a pas de description fournisseur ne sont pas modifiées.

Le bouton n’est plus affiché dès que la commande est validée.

6. Règles de remplacement

Situation de la ligne	Remplacement automatique	Bouton
Ligne sans produit (ligne libre)	Inchangée	Inchangée
Pas de description fournisseur pour ce fournisseur et cette référence	Inchangée	Inchangée
Description de la ligne vide	Description fournisseur	Description fournisseur
Description du produit + texte ajouté	Description du produit remplacée, texte ajouté conservé	Toute la description remplacée
Ligne créée depuis une commande client	Toute la description remplacée	Toute la description remplacée
Description fournisseur déjà présente	Inchangée	Toute la description remplacée
Description réécrite à la main (ne contient plus la description du produit)	Inchangée	Toute la description remplacée

• La description fournisseur utilisée est celle du prix d’achat correspondant au fournisseur de la commande et à la référence fournisseur de la ligne. Si cette référence est vide ou n’existe plus (commande créée depuis une commande client, une proposition fournisseur…), c’est la description du dernier prix d’achat du produit chez ce fournisseur qui est utilisée. En revanche, si la référence existe mais que sa description fournisseur est vide, la ligne reste inchangée.
• Si les produits sont traduits et que l’option Dolibarr « descriptions dans la langue du tiers » est activée, la description du produit dans la langue du fournisseur est aussi reconnue et remplacée.

7. Impression PDF

Le module modifie la description enregistrée sur les lignes : tous les modèles PDF de commande fournisseur impriment donc la description fournisseur, sans réglage particulier. Pensez à régénérer le PDF après avoir utilisé le bouton.

8. Limites connues et FAQ

Le bouton « Appliquer les descriptions fournisseur » n’apparaît pas.

• L’option « Afficher le bouton… » doit être activée (3.3).
• La commande doit être en brouillon.
• L’utilisateur doit avoir la permission du bouton et le droit de créer des commandes fournisseur.
• Après une mise à jour du module, il faut le désactiver puis le réactiver, puis attribuer la permission.

La description n’est pas remplacée.

• Vérifier que la description fournisseur est renseignée sur le prix d’achat du fournisseur de la commande, pour la référence fournisseur de la ligne.
• Vérifier que l’option du module Produits sur les descriptions fournisseur est activée (3.1).
• Le remplacement automatique ne concerne que les lignes ajoutées après l’activation de l’option : pour une commande existante, utiliser le bouton.
• Si la page de réglages affiche l’alerte sur les triggers (3.2), désactiver puis réactiver le module.

Une ligne modifiée à la main est-elle réécrite ?

Non pour le remplacement automatique, qui n’agit qu’à l’ajout de la ligne. Oui avec le bouton, qui remplace toute la description.

Autres limites

• Seules les commandes fournisseur sont concernées (pas les demandes de prix ni les factures fournisseur).
• Si le module « NSINFO » est désactivé après coup, la page de réglages du module n’est plus utilisable.

Une question ? Assistance NSINFO au 03 70 999 730 ou sur la page Assistance.