MAJ Tarifs Fournisseur – Bibliothèque de tarifs grossistes (EDOX / TD SYNNEX / ALSO / ITANCIA / EXERTIS)

1. Présentation

MAJ Tarifs Fournisseur tient à jour dans Dolibarr une bibliothèque des tarifs de vos grossistes informatiques et s’en sert pour créer ou mettre à jour vos produits en un clic, directement depuis vos devis, commandes et factures.

• Chaque jour, une tâche planifiée télécharge le catalogue tarifaire de chaque grossiste activé (connexion SFTP avec les identifiants fournis par le grossiste) et l’enregistre dans la bibliothèque du module.
• Dans un document en brouillon, le bouton MAJ tarif fournisseurs ouvre une fenêtre : vous saisissez la référence du grossiste ou la référence fabricant, le produit est créé (ou mis à jour) avec son libellé, sa description, son code-barres, son prix de vente et son prix d’achat, puis la ligne est ajoutée au document.
• Sur la fiche produit, l’onglet « Tarif Fournisseur » compare le produit avec le catalogue de chaque grossiste et permet de reprendre, champ par champ, les nouvelles valeurs.

Grossistes pris en charge

Grossiste	Catalogue téléchargé	Particularités
EDOX	Articles, tarifs et informations articles	Image du produit reprise du catalogue
TD SYNNEX	Articles, tarifs et taxes	Lien vers la fiche produit TD SYNNEX
ALSO	Liste de prix et fiches produits	Image du produit ; fiches constructeur avec un abonnement 1WORLDSYNC
ITANCIA	Fichier d’import dont vous indiquez le nom	–
EXERTIS	Catalogue standard	–

Documents pris en charge

Clients	Fournisseurs
Propositions commerciales	Commandes fournisseurs
Commandes clients
Factures clients

2. Prérequis et installation

2.1 Prérequis

Élément	Version
Dolibarr	19.0.0 ou supérieur (testé sur 23.0)
PHP	7.4 à 8.3 (testé en 8.3)
Framework NSINFO (module « NSINFO »)	Installé et activé (testé avec la version 23.1.1)
Accès aux catalogues	Identifiants SFTP fournis par chaque grossiste (compte revendeur)
Module Tâches planifiées de Dolibarr	Activé, avec l’exécution automatique des tâches configurée sur le serveur

Accès aux grossistes : des accès auprès de ces fournisseurs sont à demander, et il faut être client de ceux-ci. Attention : toutes les sociétés ne peuvent pas y accéder.

Le framework NSINFO est obligatoire. Si le module « NSINFO » n’est pas installé et activé, l’activation de MAJ Tarifs Fournisseur est refusée avec le message :
« Le framework NSINFO est obligatoire : le module « NSINFO » (nsinfo) doit être installé et activé avant d’activer le module « MAJ Tarifs Fournisseur EDOX / TD SYNNEX ». »

2.2 Installation

1. Installer et activer le module NSINFO (framework NSINFO, gratuit).
2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive module_majtariffrn-X.Y.Z.zip (voir installer un module).
3. Dans la liste des modules, famille NSINFO, activer « MAJ Tarifs Fournisseur EDOX / TD SYNNEX ».
4. Ouvrir la configuration (roue crantée du module), activer vos grossistes et saisir leurs identifiants de connexion.

À l’activation, le module crée :

• la bibliothèque de tarifs (un catalogue par grossiste) et les dossiers de téléchargement ;
• deux champs complémentaires sur les produits : « Réf. Constructeur » (référence fabricant, qui relie le produit aux catalogues des grossistes) et « produit Edox » ;
• cinq tâches planifiées, une par grossiste (« Mise à jour base tarif EDOX », « Mise à jour base tarif TD SYNNEX »…) ;
• l’onglet « Tarif Fournisseur » sur les fiches produits et le bouton dans les documents.

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactiver puis réactiver le module : cette opération enregistre les nouveaux éléments (feuille de style du logo, tâches planifiées, onglets). Les réglages et les identifiants de connexion sont conservés.

3. Configuration

Page de réglages : Configuration > Modules, roue crantée du module (voir activation et paramètres). Elle est réservée aux administrateurs et comporte l’onglet Réglages, un onglet « Réglages <grossiste> » par grossiste activé, puis les onglets ChangeLog et À propos fournis par le framework NSINFO.

3.1 Grossistes à activer

Bloc « Liste des fournisseurs à activer » : un interrupteur par grossiste (EDOX, TD SYNNEX, ALSO, ITANCIA, EXERTIS), tous désactivés au départ. Activer un grossiste :

• ajoute son onglet de réglages (connexion) ;
• le propose dans la fenêtre du bouton des documents ;
• ajoute son sous-onglet dans l’onglet « Tarif Fournisseur » des produits ;
• autorise sa tâche planifiée à télécharger son catalogue.

3.2 Fournisseur par défaut et TVA

Option	Description	Défaut
Fournisseur par défaut	Grossiste présélectionné dans la fenêtre du bouton (parmi les grossistes activés).	–
Taux de TVA pour les ventes	Taux de TVA appliqué au prix de vente des produits créés par le module.	20
Taux de TVA pour les achats	Taux de TVA appliqué au prix d’achat fournisseur enregistré par le module.	20

3.3 Libellé et couleur du bouton

Option	Description	Défaut
Libellé	Texte du bouton affiché dans les documents.	« MAJ tarif fournisseurs »
Couleur	Couleur de fond du bouton.	Noir

3.4 Réglages de chaque grossiste

Chaque onglet « Réglages <grossiste> » contient :

Option	Description
Sélectionner la société <grossiste>	Tiers fournisseur Dolibarr qui correspond au grossiste. Il reçoit les prix d’achat des produits créés et détermine sur quelles commandes fournisseurs le bouton apparaît. Obligatoire pour utiliser le grossiste.
Adresse SFTP	Adresse du serveur SFTP du grossiste.
Port	Port du serveur (voir FAQ).
Nom de connexion / Mot de passe	Identifiants fournis par le grossiste (le mot de passe est masqué à la saisie).
Prendre la réf. fabricant comme réf. produit	Les produits créés depuis ce grossiste prennent la référence fabricant comme référence Dolibarr, au lieu de la référence du grossiste.

Référence fabricant : même choix chez tous les grossistes. Si l’option n’est activée que chez certains grossistes, un même article acheté chez deux grossistes peut être créé deux fois sous deux références différentes.

Options propres à certains grossistes :

Grossiste	Option	Description
TD SYNNEX	URL des fiches produits	Adresse de la fiche produit sur le site TD SYNNEX ; %1 est remplacé par la référence. Elle devient l’URL publique des produits créés.
ALSO	Fiche constructeur – Code SCI	Code fourni avec l’abonnement 1WORLDSYNC – MERCHANT DATA SERVICE : il complète le lien vers la fiche constructeur des produits.
ITANCIA	Nom complet du fichier d’import	Nom du fichier tarifaire à télécharger sur le serveur ITANCIA.

Boutons de la page :

• Test de connexion : vérifie l’accès au serveur SFTP avec les identifiants saisis.
• TEST XML (EDOX) : relit les fichiers EDOX déjà téléchargés et met à jour la bibliothèque, sans nouveau téléchargement.

4. Bibliothèque de tarifs (tâches planifiées)

Le module crée une tâche planifiée par grossiste, exécutée une fois par jour (menu Outils > Tâches planifiées) :

Tâche	Action
Mise à jour base tarif EDOX	Télécharge les fichiers articles, tarifs et informations articles d’EDOX et met à jour la bibliothèque.
Mise à jour base tarif TD SYNNEX	Télécharge les fichiers articles, tarifs et taxes de TD SYNNEX.
Mise à jour base tarif ALSO	Télécharge la liste de prix et les fiches produits d’ALSO (fichiers compressés décompressés automatiquement).
Mise à jour base tarif ITANCIA	Télécharge le fichier indiqué dans « Nom complet du fichier d’import ».
Mise à jour base tarif EXERTIS	Télécharge le catalogue EXERTIS.

• Une tâche ne fait rien si son grossiste n’est pas activé dans les réglages.
• À chaque exécution, le catalogue du grossiste est entièrement rechargé : il reflète toujours le dernier fichier fourni par le grossiste.
• Les tâches ne modifient pas vos produits : elles alimentent seulement la bibliothèque. Les produits sont créés ou mis à jour à la demande, depuis un document ou depuis l’onglet « Tarif Fournisseur ».

5. Droits d’accès

• Bouton des documents : visible pour les utilisateurs qui ont le droit Dolibarr « Créer/modifier les produits », sur un document au statut brouillon.
• Onglet « Tarif Fournisseur » : accessible à tout utilisateur qui peut consulter la fiche produit.
• Configuration : réservée aux administrateurs.
• Les permissions « Lire », « Ecrire » et « Supprimer » du module apparaissent dans la liste des permissions mais ne limitent aucune fonction à ce jour.

6. Utilisation dans les documents

6.1 Ajouter ou mettre à jour un produit

Sur une proposition commerciale, une commande client ou une facture client :

1. Ouvrir le document au statut brouillon.
2. Cliquer sur le bouton MAJ tarif fournisseurs (avec les autres boutons d’action).
3. Dans la fenêtre « Ajout/Mise à jour d’un produit » :
   • Sélectionner le fournisseur : grossiste à interroger (le fournisseur par défaut est présélectionné) ;
   • Référence : référence du produit chez le grossiste, ou référence fabricant ;
   • Quantité : quantité de la ligne (1 si vide) ;
   • Utiliser les numéros de lots/série : le produit sera géré par lot / numéro de série ;
   • Service : le produit sera créé comme un service.
4. Confirmer (« Êtes-vous sûr de vouloir ajouter ou mettre à jour cette référence ? »).

Le module cherche alors :

1. un produit Dolibarr portant cette référence : il est mis à jour depuis le catalogue du grossiste ;
2. sinon, la référence dans le catalogue du grossiste (référence fabricant ou référence grossiste) : le produit est créé ;
3. sinon, le message « La référence saisie n’est pas une référence connue chez le fournisseur » s’affiche.

Le produit est ensuite ajouté comme ligne du document, au prix de vente du produit, avec le prix d’achat du grossiste comme prix de revient. Le message « Produit ajouté ou mis à jour » confirme l’opération.

6.2 Depuis une commande fournisseur

Le bouton apparaît sur une commande fournisseur en brouillon uniquement si son fournisseur est la société d’un grossiste activé (option « Sélectionner la société <grossiste> »). La fenêtre est la même, sans le choix du fournisseur : c’est le grossiste de la commande qui est interrogé. La ligne est ajoutée au prix d’achat du grossiste.

6.3 Données reprises du grossiste

Donnée du produit	Création	Mise à jour
Référence	Référence grossiste, ou référence fabricant selon l’option	Inchangée
Libellé	Désignation courte (ou longue si la courte est vide)	Oui (désignation courte)
Description	Désignation longue	Oui
Code-barres (EAN)	Oui (EDOX : si le module Codes-barres est activé)	Oui
URL publique	Lien vers la fiche produit du grossiste	Oui
Poids	Oui	Inchangé
Prix de vente HT	Prix de vente conseillé du catalogue	Oui
TVA de vente	« Taux de TVA pour les ventes »	Inchangée
Prix d’achat fournisseur	Prix d’achat du catalogue, sur la société du grossiste, TVA « Taux de TVA pour les achats »	Oui
Réf. Constructeur	Référence fabricant	Oui
Image	EDOX et ALSO : image du catalogue	EDOX et ALSO
En vente / en achat	Oui / oui	Inchangé
Écotaxe DEEE	Si le module DEEE est activé et que le catalogue indique un montant	Idem

7. Onglet « Tarif Fournisseur » du produit

Sur la fiche d’un produit, l’onglet « Tarif Fournisseur » contient un sous-onglet par grossiste activé (EDOX, TD SYNNEX, ALSO, ITANCIA, EXERTIS).

• Le produit est retrouvé dans le catalogue du grossiste grâce à son champ « Réf. Constructeur ». Si ce champ est vide ou inconnu du grossiste, le message « Pas de tarif pour ce grossiste » s’affiche.
• Sinon, un tableau présente les valeurs du grossiste : libellé, code-barres, description, URL publique, poids, Prix de vente HT et Prix d’achat HT, chacune avec une case à cocher.
• Cocher les valeurs à reprendre puis cliquer sur Modifier : seules les valeurs cochées sont copiées sur le produit (le prix d’achat est enregistré sur la société du grossiste).

8. Limites connues et FAQ

Le bouton « MAJ tarif fournisseurs » n’apparaît pas.

• Le document doit être en brouillon et l’utilisateur doit avoir le droit « Créer/modifier les produits ».
• Au moins un grossiste doit être activé (3.1).
• Sur une commande fournisseur, le fournisseur de la commande doit être la société choisie pour un grossiste (6.2).

« La référence saisie n’est pas une référence connue chez le fournisseur ».

• Vérifier le grossiste choisi et la référence (référence grossiste ou référence fabricant).
• Vérifier que la tâche planifiée du grossiste s’est bien exécutée (Outils > Tâches planifiées) : un article nouvellement référencé n’est connu qu’après le téléchargement suivant.

La tâche planifiée échoue.

• Utiliser le bouton Test de connexion de l’onglet du grossiste pour vérifier l’adresse et les identifiants.
• La connexion se fait sur le port SFTP standard (22) : le champ « Port » n’est pas pris en compte à ce jour.
• ITANCIA : vérifier le « Nom complet du fichier d’import ».

L’onglet « Tarif Fournisseur » affiche « Pas de tarif pour ce grossiste ».

Le champ « Réf. Constructeur » du produit doit contenir la référence fabricant connue du grossiste. Il est rempli automatiquement pour les produits créés par le module ; pour vos autres produits, saisissez-le sur la fiche produit.

Autres limites

• Le prix de vente repris est le prix de vente conseillé du catalogue : le module n’applique pas de coefficient de marge.
• Les libellés des tâches planifiées, des champs complémentaires et des grossistes dans la fenêtre sont en français quelle que soit la langue de l’utilisateur.
• 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.