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
**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 plateforme de support](https://support.altairis.fr). 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** Actuellement, le module Gestion des prix est compatible avec Dolibarr à partir de la version 14. Pour pouvoir utiliser la méthode d'association de champs de l'import qui est apparue avec la V16, vous devez avoir au minimum cette version. À tout moment vous pouvez revenir à l'ancienne méthode d'association de champ, quelle que soit votre version via une constante cachée (cf. plus bas). #### **1.2.3- Mises à jour** Les dernières versions de nos modules sont mises à disposition sur notre [site internet](https://www.altairis.fr/boutique/) et le [Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis). 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 ou sur notre boutique avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement 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.**! Important !** 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ézippez 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 : **A**ccueil > **C**onfiguration > **M**odules/**A**pplications, onglet **D**éployer un module externe. #### **1.3.2- Activation** Activez le module en affichant la liste des modules depuis les menus : **A**ccueil > **C**onfiguration > **M**odules/**A**pplications, onglet **M**odules/**A**pplications installés. Il sera affiché dans le tableau Altairis. [](https://doc.altairis.fr/uploads/images/gallery/2024-07/P00s57JpPw3n1UNP-configuration-2024-07-30-17-14-57.png)| **Prix catalogue** | **Prix de revient ** |
| correspond au prix de vente public du fournisseur | correspond au prix de vente public du fournisseur |
| **incluant **les charges liées à l'achat du produit concerné, les remises fournisseurs appliqués |
**Note : **Si vous utilisez le module Multi-devise, le coût réel du produit est dans la monnaie locale.
#### **2.1.2- Gérer les coefficients par devise** Permet d'attribuer des coefficients d'achat et de vente différents selon la devise. Cette option vous donne la possibilité de gérer et actualiser les prix si vous achetez en différentes devises en plus de la devise locale. Disponible depuis le menu "Outils" du module.**Note : **Le module multi-devise doit être actif. Une permission est disponible pour cette option ([liste des permissions](https://doc.altairis.fr/books/gestion-des-prix-prices/page/13-mise-en-route#bkmrk-permissions)).
#### **2.1.3- Enlever l'onglet des prix clients (prix de vente et prix d'achat)** Donne la possibilité de ne pas afficher l'onglet "**Prix de vente**" (prix client) disponible à partir de la fiche produit. Par défaut à l'activation du module l'onglet est désactivé (cas d'usage le plus courant).**Important **Tout changement sur cet onglet "prix de vente" ne sera pas répercuté sur sur les tarifs calculés par le module de gestion des prix. Vous pouvez par contre modifier les prix de vente directement sur l'onglet "Gestion des prix" des fiches produits et répercuter votre changement sur l'onglet "prix de vente".
#### **2.1.4- Ajouter l'onglet du catalogue de prix** Donne la possibilité d'afficher l'onglet "**Gestion des prix**" sur la fiche produit. Permet de **visualiser ce qui a été importé via le module de gestion des prix**. Si cet onglet est activé vous pouvez choisir de retirer les onglets "**Prix de vente**" (prix client) et "**Prix d'achat**" (prix fournisseur) ou de définir les permissions de visibilité par utilisateur ou groupe sur ces deux onglets. #### **2.1.5- Une seule catégorie par produit** Permet d'avoir chaque produit dans **une seule catégorie**. Cochez cette case si vous voulez que chaque produit soit dans une seule catégorie. Lorsque vous importez une catégorie pour un produit, s'il était auparavant dans une catégorie différente : il sera supprimé de l'ancienne catégorie et ajouté à la nouvelle indiquée dans l'import. #### **2.1.6- Une seule référence par fournisseur** Un produit ne peut avoir qu'une seule référence chez un même fournisseur.| **Option cochée** | **Option non cochée** |
| Si le produit est déjà enregistré avec sa référence fournisseur et que vous faites un import sur ce produit même avec une nouvelle référence, alors la référence fournisseur sera remplacée par la nouvelle. | Vous allez créer un deuxième prix d'achat avec la nouvelle référence fournisseur du produit. |
**ATTENTION** : le temps de validation du catalogue est considérablement rallongé en cas de nombreux niveaux de prix et de fichier CSV volumineux.
Liste des champs cibles Dolibarr pour 2 niveaux de prix : [](https://doc.altairis.fr/uploads/images/gallery/2024-03/image.png) Comme indiqué dans le tableau des [correspondances des champs](https://doc.altairis.fr/books/en-cours-prices/page/26-limport-du-catalogue#bkmrk-2.7.2.4--corresponda) qu'il est possible d'importer, vous renseignez au moins les éléments qui ne se calculent pas (comme le prix de vente minimum ou encore éventuelle une remise client). Concernant le coefficient de vente, il semble logique d'en avoir un par niveau de prix. Vous devez donc dans ce cas l'inclure obligatoirement dans votre CSV (pour chaque niveau de prix) et ne pas utiliser le menu de mise à jour des coefficients. Les autres champs se calculent automatiquement. # 2.4- Gestion des coefficients en masse et mise à jour des prix **Rappelons qu'il y a deux manières de gérer des coefficients d'achat et de vente : soit de manière globale à tout votre catalogue - et cette page détaille ce cas - soit en important vos coefficients en même temps que vos catalogues - et dans ce cas, vous n'utiliserez pas ce qui est détaillé ici.** #### **2.4.1- Accéder aux Coefficients** Pour pouvoir **modifier vos coefficients de vente et d'achat** par défaut ou par devise**,** allez dans le module **Gestion des prix** depuis le menu du haut de votre Dolibarr et choisissez via le menu de gauche **Mise à jour des coefficients**. Cet écran va apparaître et vous permettra de modifier les coefficients par défaut. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/h6Scoefficient-par-defaut-et-devise.png)**Note : **La mise à jour des coefficient affectera l'intégralité de vos produits.
#### **2.4.2- Exemples d'utilisation des coefficients** **Calcul automatique des prix à partir des devises d'achat en fonction des cours de la monnaie** Déterminez vos coefficients en tenant compte du cours des devises étrangères et des frais liés à cette gestion des devises. Modifiez simplement les coefficients lors de l'évolution des devises pour actualiser les prix. **Calcul automatique des prix de vente selon la marge souhaitée** Appliquez votre marge aux prix fournisseurs pour calculer automatiquement tous les prix de vente en fonction de ce critère **Mettez dans vos coefficients tous les éléments de prix qui sont communs à vos produits** Taux de change, frais de change pour la gestion des devises, coûts d'approche, de transport, d'emballage, etc... Si vous le souhaitez, vous pouvez en faire un forfait appliqué à tous les produits, votre marge pour la vente, ...**Note :** **Il s'agit d'un coefficient et non d'un pourcentage. **Par exemple, si vous voulez **une marge de 50 %**, indiquez dans votre **coefficient de vente : 1,5**
# 2.5- Attributs supplémentaires (extrafields) ##### Gestion des attributs supplémentaires de produit que vous pouvez mettre à jour via Prices **Si vous avez créé** un ou plusieurs **attributs supplémentaires** sur les produits comme par exemple ajouter un délai de disponibilité d'un produit, la durée de garantie, le nom d'une marque... ET que vous souhaitez que ces attributs supplémentaires soient mis à jour lors de vos imports via Prices, vous devrez déclarer ces extrafields dans une constante cachée.**ATTENTION Lors de l'étape de correspondance des champs, vous allez systématiquement voir les extrafields créés. MAIS ils ne se mettront à jour QUE SI vous les avez déclarés dans la constante cachée.
Rendez-vous dans l'onglet Configuration > Divers. En haut de la page, vous pouvez ajouter des constantes (si elles n'existent pas encore). [](https://doc.altairis.fr/uploads/images/gallery/2024-04/image.png) [](https://doc.altairis.fr/uploads/images/gallery/2024-04/tB7image.png) Dans la colonne "Nom", renseignez le nom de la constante (telle qu'écrite ici, en majuscule) : PRICES\_EXTRAFIELDS\_USED Dans la colonne "Valeur", vous devez indiquer le code de l'attribut supplémentaire qui doit être mis à jour par le module Gestion des prix. Si vous en avez plusieurs, séparez-les par des virgules, sans espace. Enfin, n'oubliez pas de cliquer sur le bouton "Ajouter" pour créer votre constante. Pour modifier la liste de vos attributs : revenez sur cette page, trouvez votre constante dans la liste, modifiez la "valeur" selon vos besoins. À droite de la ligne, la case à cocher doit être automatiquement cochée. Une fois la correction faite, allez tout en bas de la page et cliquez sur le bouton "Modifier" pour valider vos changements. Vous pouvez trouver le code d'un attribut supplémentaire dans Configuration > Modules > Produits > Onglet Attribut supplémentaire. Vous pourrez **inclure ces attributs supplémentaires** dans votre **fichier d'import**.Tous les attributs supplémentaires de produit qui ne sont pas déclarés dans cette constante ne seront PAS mis à jour via les imports de Prices.
##### Suppression ou modification d'un attribut supplémentaire sur les produits Les attributs supplémentaires se gèrent depuis la configuration du module Produits, onglet Attributs supplémentaires. # 3- Avant l'import # 3.1- Initialiser le catalogue #### **3.1.0 - Pourquoi une procédure d'initialisation ?** **Le module de Gestion des prix travaille avec des tables intermédiaires durant toute la phase d'import jusqu'à la validation des prix. Ces tables sont vides à l'installation du module. Il va falloir "prendre une image" de votre base produits pour l'initialiser.** **Cette procédure d'initialisation n'est accessible qu'une seule fois. Par la suite, elle est désactivée pour éviter tout problème. Par ailleurs, pour pouvoir l'utiliser, il faut avoir la permission correspondante d'active sur le profil de l'utilisateur qui va s'en servir.** #### **3.1.1- Avant de lancer la procédure d'initialisation** La procédure d'initialisation vous permet de partir de votre base produits Dolibarr déjà renseignée et utilisée. Elle suppose que votre base produits / services soit renseignée avec : - des libellés, descriptions, prix de vente ET prix d'achat - les prix fournisseurs doivent comporter : - le nom du fournisseur (qui doit exister dans votre Dolibarr) - la référence fournisseur pour ce produit - les différents éléments de prix pour ce produit et ce fournisseur Le module de gestion des prix se** base sur la présence d'un fournisseur **et **d'une référence fournisseur sur les produits** pour fonctionner. Toute entrée n'ayant pas ces deux informations ne sera donc pas prise en compte par la procédure d'initialisation.**IMPORTANT Vous devez impérativement faire le tour de votre base de produits/services** pour vous assurer que toutes ces informations sont bien présentes.
**Il est très fortement recommandé de faire une sauvegarde de votre base de données en l'état**, afin de pouvoir éventuellement la remettre en place en cas de problème ou bien travailler sur un clone de votre Dolibarr.**Note** : Si vous avez les moindres modifications à faire à ce niveau sur votre base existante, par exemple : parce que vous vous rendez-compte, au vu des fichiers des fournisseurs, que vous avez des classifications à modifier – évaluez bien comment ce travail peut être fait avant ou après l'initialisation.
#### **3.1.2- Lancer la procédure d’initialisation** Une fois le module Gestion des prix activé dans la configuration des modules, **il faut activer les droits d'utilisation** de cette fonctionnalité pour la ou les personnes de votre choix. Si vous n'utilisez pas cette fonctionnalité (cas d'une installation neuve sans produits/services déjà renseignés), il vous suffit de ne pas donner de droits d'utilisation de cette fonctionnalité. Après activation des droits, la procédure d'initialisation est disponible depuis le menu **Outils** du module de Gestion des prix. Cliquer sur le menu **Initialiser le catalogue** (à gauche) pour afficher la fenêtre d'explications et avertissements et le bouton **Initialiser le catalogue**. Pour lancer l'initialisation du catalogue cliquez sur le bouton **Initialiser le catalogue**, la procédure ce lancera par la suite. **Elle peut être très longue selon le nombre de produits / services** que vous avez déjà en base de données. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/initialisation-catalogue.png) #### **3.1.3- Valider le catalogue** **Une fois la procédure d'initialisation terminée**, cliquez sur le menu **Valider le catalogue** (à gauche) et laissez vous guider pour terminer l'initialisation des données du module.Prend en compte tous les produits ayant déjà un prix d'achat existant sur votre Dolibarr ; tient compte de tous les prix d'achat que possède un produit.
# 4- Import de listes de prix Gérer l'import proprement dit, à partir du ou des fichiers que vous préparez. # 4.1- Préparation du fichier d'import #### **4.1.1- Conseils de mise en forme** La préparation requiert un certain travail de récupération des informations des fichiers des fournisseurs et de remise en forme, bien souvent. La plupart du temps, les fichiers utilisés sont travaillés dans un tableur dans lesquels on a tendance à jouer d'effets de forme ou d'affichage. Or *pour votre import, vous avez besoin du texte et des nombres, et uniquement cela*. Heureusement, les fournisseurs qui ont de bons systèmes de gestion informatisés sont capables de fournir des fichiers de très bonne qualité. Il y en a de plus en plus, tant mieux. **En particulier, soyez vigilants sur les points suivants :** - Sauts de lignes dans les cellules des tableaux - à bannir absolument, cela génère un saut de ligne du fichier CSV et fausse vos données à importer (si vous avez un nombre de lignes dans le CSV qui ne correspond pas au nombre de ligne de votre fichier tableur, c'est probablement à cause de cela) - vous pouvez au choix : ne pas faire de sauts de ligne (et gérer cela à la main au cas par cas en éditant les fiches produits), ou ajouter dans vos fichiers le code HTML de saut de ligne - Virgules ou points-virgules - il s'agit du séparateur de champ du fichier CSV : c'est ce caractère qui va déterminer les données qui vont être enregistrées dans le premier champ, puis le deuxième champ... dans la base de données. - En français, vous aurez probablement moins de problèmes à gérer avec le point-virgule (moins courant dans les textes) que la virgule - Les prix formatés avec l'affichage de la monnaie - à bannir, ils ne seront pas reconnus, vous aurez une erreur. - vous devez avoir une colonne (= un champ) avec le prix uniquement, et une autre pour la devise (monnaie) - de même n'appliquez aucun effet de mise en forme des nombres (par ex. le séparateur des milliers…) - Le séparateur de décimales à privilégier est le point. Bien que, globalement, la virgule soit reconnue, il y a des cas (par exemple dans les attributs supplémentaires) où elle ne l'est pas. Vous perdrez tout ce qui vient après la virgule lors de l'import. - D'une manière générale, vous ne devez avoir **aucun formatage de texte ni de nombre**. Une fois votre enregistrement CSV terminé à partir du tableur, ouvrez votre fichier dans un éditeur de texte\* et vérifiez le nombre de lignes que vous avez pour repérer d'éventuel saut de lignes non voulu. Si votre fichier tableur comporte 10 lignes et une ligne d'en-tête, soit 11 lignes, vous devez avoir également 11 lignes dans votre fichier ouvert avec l'éditeur de texte. Si ce n'est pas le cas, vous avez un problème de retour à la ligne qu'il faut trouver et supprimer. \* un éditeur de texte n'est pas un logiciel de traitement de texte ! c'est un logiciel dédié à l'édition de texte "pur" - sans aucun formatage de texte. Vous en trouverez normalement un sur votre système d'exploitation (Notepad pour windows, TextEdit sous Mac. Il y en a au moins un (si ce n'est plus) nativement sous linux). #### **4.1.2- Attributs supplémentaires (extrafield) sur les produits** ##### Ajout ou modification d'un attribut supplémentaire sur les produits Le module Gestion des prix peut tout à fait importer des attributs supplémentaires. Pour cela, rajouter simplement une colonne dans votre fichier d'import. Attention cependant à bien vérifier que les attributs supplémentaires soient bien pris en compte dans la configuration de votre Dolibarr. Configuration > Divers > onglet attributs supplémentaires. Pour plus d'informations, consulter la partie dédiée à la [configuration d'attributs supplémentaires](https://doc.altairis.fr/books/gestion-des-prix-prices/page/25-attributs-supplementaires-extrafields) de cette documentation. #### **4.1.2- Formats du fichier** Vous devez importer votre fichier en format .CSV (Coma Separated Value). Le format CSV vous permet de rapidement repérer les erreurs de mise en forme (renseignées plus haut). Le format CSV est le seul format avec lequel vous êtes sûrs de pouvoir choisir votre caractère de séparateur de champs pour vous assurer que c'est bien le point virgule. #### **4.1.4- Les champs à importer** ##### Informations à connaître sur les champs à importer En pratique, **en configurant vos coefficients de vente et d'achat**, **tous les prix intermédiaires sont calculés automatiquement**, ce qui limite fortement la liste des données de prix à importer. **Les produits n'existant pas dans votre Dolibarr**, mais que vous **indiquez dans votre fichier d'import seront créés automatiquement**. En conséquence, afin que les fiches produits soient utilisables correctement, pensez à importer la description du produit et toutes les informations qui vous seront utiles au quotidien sur vos fiches produits. Vous pouvez **importer plusieurs catalogues de fournisseurs différents d'un coup** si vous le voulez. Il vous faudra alors avoir le champ **Code fournisseur** obligatoirement renseigné dans votre fichier d'import. **Le fournisseur devra déjà exister **dans votre Dolibarr puisque vous devrez **indiquer le code fournisseur **de votre Dolibarr **dans votre fichier**. De même, vous pouvez **importer des produits de plusieurs catégories** : pour cela le champ **catégorie devra être rempli** dans votre fichier d'import. **Les catégories** indiquées dans votre fichier d'import et **n’existant pas **dans votre Dolibarr **seront crées à la phase de validation** après l'import. **Attention **: si vous reprenez des **catégories existantes**, vous devrez **libeller vos catégories dans votre fichier d'import exactement comme elles le sont dans votre Dolibarr** (sinon, elles seront considérées comme nouvelles catégories et seront donc créées). **La référence interne est le code produit** que vous utilisez dans votre Dolibarr. Il peut être configuré pour s’auto-incrémenter ou être librement choisi, selon la configuration du module Produits. **Renseignez ce champ si vous utilisez des codes librement choisis**. **Sinon, n'importez pas ce champ**, le module utilisera l'auto-incrémentation définie dans la configuration.**Note :** Si vous disposez d'un fichier CSV qui contient plus de champs que requis, il n'est pas nécessaire des les supprimer : il suffira dans l'étape 2 de l'import de ne pas tenir compte des champs en trop.
##### Les champs à importer Voici les champs et leur explication que vous retrouverez sur le fichier d'exemple :| **Champs** | **Explications** | **Champ obligatoire** |
| Code fournisseur | C'est celui qui se trouve sur votre Dolibarr, le fournisseur doit déjà exister | **Oui** surtout si plusieurs fournisseurs dans le même CSV |
| Statut | Ce champ doit toujours être rempli par 0 | **Oui à partir de la version ** |
| Réf. Produit fournisseur | La référence produit fournisseur doit être unique pour ce fournisseur | **Oui** |
| Libellé | Libre à vous de choisir le libellé **255 caractères maximum** | **Oui** |
| Description | Libre à vous de choisir la description **Pas de limite de caractères** | Non |
| Référence interne | Référence du produit dans votre Dolibarr **32 caractères maximum** Ce champ peut être automatiquement rempli et auto-incrémenté si vous avez choisi cette méthode dans le **module Produits. **Ne pas importer ce champ dans ce cas. | **Oui Si **vous gérez des références manuelles **Non** si vous utilisez des références auto-incrémentées |
| Produit / Service (0/1) | Indiquez ici si la ligne importée est une ligne de produit (0) ou de service (1) | **Oui Si **vous gérez des produits et des services **Non** si vous importez uniquement des produits. |
| Catégorie | Catégorie du produit Si elle est inexistante elle sera créée dans Dolibarr | Non |
| Quantité | Quantité du produit pour le prix considéré (en cas d'achat en nombre) **Ce n'est pas le stock ** | Non Par défaut, si vous n'indiquez pas de quantité d'achat pour le prix indiqué, ce sera 1 |
| Prix catalogue | Le prix (pour la quantité) du fournisseur uniquement (pas de monnaie) **Ex : 23.12 ou 23,12** | Non Si vous n'indiquez pas de prix d'achat, toute la chaîne de calcul de prix sera à 0 |
| Devise (Monnaie) | Code monnaie du prix fournisseur sur trois lettres (ex : pour l'euro = EUR) ** Obligatoire si les prix sont en devise différente de votre monnaie par défaut** dans Dolibarr Liste détaillée dans : Configuration > Dictionnaires > Monnaies. | **Oui ****Si **vous gérez les coefficients par devise. **Non **si vous ne gérez pas d'achat en devise. Si non renseigné, ce sera la monnaie de votre Dolibarr. |
| Taux TVA | Taux de TVA sur les ACHATS **Ex : pour une TVA de 19,6 % : 19.6** | **Oui Si **différent de 0 |
| Remise fournisseur | Taux de remise fournisseur pour le produit **Ex : indiquez 10 pour 10%** | Non Vous pouvez indiquer le prix public de votre produit et votre remise fournisseur, ou bien indiquer directement dans le champ "prix catalogue" votre prix net (et dans ce cas, pas de remise fournisseur) |
| Prix de base | Prix catalogue remisé pour la quantité achetée (pour les achats en nombre) | Non **Calcul automatique** |
| Prix unitaire | Prix catalogue remisé unitaire ** ** | Non **Calcul automatique** |
| Coefficient coût | Coefficient d'achat à appliquer au prix catalogue remisé pour calculer le prix de revient. Il s'agit du Coefficient d'achat défini et modifiable dans la configuration du module. Normalement il n'est pas importé à ce stade sauf si vous avez des coefficients différents selon vos produits ; dans ce cas, ne pas utiliser le menu **Mise à jour des coefficients** | **Oui SI **vous utilisez plusieurs niveaux de prix |
| Prix de revient | Prix fournisseur catalogue remisé x coefficient d'achat + charges pour les achats en nombre | Non **Calcul automatique** |
| Prix de revient unitaire | Prix catalogue fournisseur remisé x coefficient d'achat | Non **Calcul automatique** |
| Code-barres | Alimente et met à jour le champ "Code barre" des fiches produits de Dolibarr | Non |
| Pays | Alimente et met à jour le champ "Pays d'origine" des fiches produits de Dolibarr | Non |
| Notes | Alimente et met à jour le champ "Notes" des fiches produits de Dolibarr | Non |
| Fournisseur préféré | **À utiliser si vous avez plusieurs fournisseurs pour un produit** et que vous souhaitez que ce fournisseur précis soit utilisé pour calculer le prix de vente, quels que soient les imports futurs venant des autres fournisseurs. Par défaut, **sans information** sur ce champ **ou s'il n'existe pas dans le CSV**, le dernier prix fournisseur importé met à jour le prix de vente du produit | **Oui** Mettre 1 si ce fournisseur est le fournisseur préféré pour ce produit |
| Poids | Indiquer le chiffre, sans unité | Non |
| Unité de poids | Les unités suivantes sont prises en compte, **à libeller de cette manière **: mg ; g ; kg ; tonne ; pound... | **Oui ****Si **vous importez un poids |
| Longueur | Indiquer le chiffre, sans unité | Non |
| Unité de longueur | Les unités suivantes sont prises en compte ** à libeller de cette manière **:** mm **; **cm** ; **dm** ; **m** ; **foot** ; **inch** | **Oui ****Si **vous importez une longueur |
| Surface | Indiquer le chiffre, sans unité | Non |
| Unité de surface | Les unités suivantes sont prises en compte **à libeller de cette manière **: **m2 ; dm2 ; cm2 ; mm2 ; foot2 ; inch2** | **Oui ****Si **vous importez une surface |
| Volume | Indiquer le chiffre, sans unité | Non |
| Unité de volume | Les unités suivantes sont prises en compte **à libeller de cette manière **: **m3 ; dm3 ou l (litre) ; cm3 ou ml ; mm3 ou µl ; foot3 ; inch3** | **Oui ****Si **vous importez un volume |
| Champs personnalisés | Vous retrouverez dans la procédure d'import tout champ supplémentaire personnalisé que vous aurez créé via Configuration > Modules > Produits > onglet "Attributs supplémentaires" Vous pouvez donc ajouter à votre fichier d'import les colonnes correspondantes pour alimenter ces champs N'oubliez pas de déclarer dans la constante cachée le ou les codes des champs qui doivent être mis à jour | Non ATTENTION à déclarer dans la constante cachée le ou les champs supplémentaires qui doivent être mis à jour. |
| URL | Lien vers une page web si elle existe | Non |
| Statut (toujours à 0) | Information technique destinée à gérer correctement l'information relative aux statuts des articles importés (produits ou services). **OBLIGATOIRE et TOUJOURS À 0** | **Oui ** **Cette colonne ne doit jamais être vide et ne comporte que la valeur 0** |
| Coefficient Vente | Coefficient de vente à appliquer au prix catalogue ou au prix de revient (selon la configuration) pour calculer le prix de vente. Il s'agit du coefficient. de vente défini et modifiable dans la configuration du module. Normalement il n'est pas importé à ce stade sauf si vous avez des coefficients différents selon les produits ; dans ce cas, ne pas utiliser le menu " mise à jour des coefficients" | **Oui Si** les coefficients sont différents selon les produits **Oui ****Si **plusieurs niveaux de prix et dans ce cas : 1 colonne par niveau de prix |
| Prix de vente minimum non remisé | Permet de définir un prix minimum de vente. Doit être importé via CSV **Ne se calcule pas automatiquement** | **Oui ****Si **vous l'utilisez 1 colonne / niveau de prix |
| Prix de vente non remisé | Prix de revient unitaire x coeff. de vente ou Prix catalogue unitaire x coeff. de vente selon la configuration | **Non** si vous utilisez les coefficients de vente. **Calcul automatique ** **Oui ****Si **vous n'utilisez pas les coefficients de vente. Dans ce cas vous importez vos prix de vente dans cette colonne. |
| Remise client | Taux de remise accordée aux clients Valable pour tous les clients (l'information est stockée au niveau du prix du produit) **Ex : une opération promotionnelle** | Si import : 1 colonne / niveau de prix |
| Prix de vente | Prix de vente remisé pour les clients | Non **Calcul automatique** |
| TVA vente | Taux de TVA à appliquer pour la vente | **Oui ****Si **différent de 0 |
**Note** : Si vous calculez des coefficients de vente ou d'achat différents selon les marques de vos produits, les fournisseurs, ou encore les niveaux de prix, vous devrez alors les intégrer à vos fichiers d'import. En effet, passer par la configuration du module pour gérer les coefficients implique d'appliquer le même coefficient à tous les produits, que ce soit de manière globale ou par devise, ce qui ne convient pas dans ces cas précis.
# 4.2- L'import du catalogue #### **4.2.1- Importer un catalogue** Pour importer votre catalogue allez sur le module** Gestion des prix** via le menu du haut de votre Dolibarr, puis sur le menu de gauche cliquez sur le menu **Importer un catalogue**.**Note :** Lors des étapes de l'import veuillez retenir que **le choix du fournisseur** et/ou de la** catégorie produits **ne sert **que** si vous importez le catalogue d'un seul fournisseur et ou d'une seule catégorie produit. Si vous avez plusieurs fournisseurs ou plusieurs catégories à importer, vous laisserez le ou les champs correspondant vides et vous devrez avoir les champs code fournisseur et ou catégorie renseignée dans votre fichier source.
**Le fournisseur doit impérativement être renseigné** soit dans le fichier d’import soit lors de l'étape 1,2 et 3, sans quoi l'import échouera. **La catégorie** produit **n'est pas obligatoire** pour réaliser l'import.
##### **Étape 1 : **Choix du fichier d'import Cette première étape vous permet de **choisir votre fichier d'import** et éventuellement d'**indiquer à quel fournisseur et quelle catégorie produit** vont être attribuée les produits importés. **Le choix du fournisseur et de la catégorie** est optionnel et **est utile** **si vous importez un catalogue de produits correspondant à un seul fournisseur, et / ou une seule catégorie** de produits. Si ce n'est pas le cas, ne renseignez rien ici. Sur cette étape vous aurez la possibilité de voir tous les fichiers CSV que vous importerez sous forme de liste au fur et à mesure que vous réaliserez des imports. Vous avez également la possibilité de télécharger un exemple de fichier CSV à importer. Une fois votre fichier CSV ajoutée cliquez sur cette icône [](https://doc.altairis.fr/uploads/images/gallery/2024-02/R2Eimage.png) pour **passer à l'étape 2**. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/etape-1-copie.png) ##### **Étape 2 : **Correspondance des champs ##### Séparateur, délimiteur de champs Sur cette étape **vous pouvez choisir de garder ou de modifier le séparateur et le délimiteur de champs,** cliquez sur **modifier si vous le ou les changez**. Vous pouvez également indiquer un fournisseur et une catégorie produit, le choix que vous aurez fait à l'étape 1 sera ici sauvegardé et donc affiché. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/etape-2-a-copie.png) ##### Choix profil d'import Vous** pouvez choisir un profil d'import prédéfini** que vous aurez **réalisé en amont de cet import**. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/etape-2-b-copie.png) ##### Sauvegarder le profil d'import À la fin de cette page **il vous sera possible de sauvegarder ce profil d'import** pour pouvoir le réutiliser plus rapidement les prochaines fois que vous ferez un import similaire. Indiquer le nom que vous souhaitez donner au profil et sauvegardez-le. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/MXJimage.png) ##### Correspondance des champs **Le plus important** à cette étape est **le choix des correspondances entre vos champs et ceux de Dolibarr**, avec **une première zone** (Champs dans le fichier source) **pour les champs que vous souhaitez importer** et une **deuxième zone** (Champs du fichier source non importés) en dessous **avec les champs que vous ne souhaitez pas importer**. Dans un premier temps vous pouvez exclure des champs que vous ne souhaitez pas importer et ensuite vérifier que les champs que vous gardez correspondent bien aux champs cibles de Dolibarr se trouvant en face à droite. Déplacer les champs en vous positionnant sur cette icône  système de drag & drop **Les champs qui ne seront plus** dans la liste des **Champs dans le fichier source**, car vous **les aurez mis **dans la liste des **Champs du fichier source non importés** seront **marqués comme ceci **[](https://doc.altairis.fr/uploads/images/gallery/2024-02/eytimage.png)**Note : ****Si la mention "Aucun champ" ne s'est mise par défaut** est décale donc vos champs à importer par rapport aux champs cible de Dolibarr, veuillez mettre manuellement [](https://doc.altairis.fr/uploads/images/gallery/2024-02/eytimage.png)en allant le prendre à la fin de votre liste de champs non importés.
| **Exemple ** | |
| **Champs dans le fichier source à importés et les champs cibles ** | **Champs du fichier source non importés** |
| [](https://doc.altairis.fr/uploads/images/gallery/2024-02/etape-2-d.png) | [](https://doc.altairis.fr/uploads/images/gallery/2024-02/0jnetape-2-d.png) |
**Note :** C'est un outil de mémorisation de cette correspondance de champs qui vous permettra de ne pas refaire le travail de mise en correspondance des champs à chaque fois que vous ferez un import basé sur le même type de fichier (c'est à dire avec les mêmes champs, dans le même ordre, quel que soit le contenu).
##### **Étape 3 :** Test et import Sur cette étape vous avez** toujours la possibilité de définir** un **fournisseur** et une **catégorie produits** si cela n'a pas était fait en amont, vous pouvez laisser ces deux champs vide, si du moins le fournisseur est indiqué dans votre fichier d'import. Vous avez aussi **la possibilité de choisir de ne pas importer la première ligne de votre fichier CSV**, s'il contient des entêtes de colonne. Cela évitera que l'import ne prenne les entêtes de colonne pour un produit (et génère une erreur). Vous aller cliquez sur **lancer la simulation d'import** vous permettant de déceler la moindre erreur qui serait présente dans l'import en cours. **Si des erreurs sont rencontrées** vous allez en être averti par des messages d'erreur. Corrigez les éventuelles erreurs et recommencez jusqu'à ce qu'il n'y ait plus d'erreurs de détectées. **Si il ****n'y a pas d'erreur** là aussi vous en serez averti et vous pourrez cliquer sur **Importer les données** pour terminer l'étape 3.| **Exemple erreur ** | |||
| **Si le fournisseur et référence fournisseur (produit) ne sont pas renseignés** | **Correction fournisseur** | **Correction référence fournisseur (du produit)** | **Si aucune erreur** |
| **[](https://doc.altairis.fr/uploads/images/gallery/2024-02/7xtimage.png)** | **Si oubli du fournisseur dans le CSV**, corrigez le fichier et recommencer l'import **Si oubli d'indiquer le fournisseur depuis ces étapes** d'import car non présent dans votre CSV, rajoutez le sur cette même étape et relancez | **Si l'erreur provient de votre CSV** car manquant ou erroné, corriger votre fichier et recommencer les étapes **L'erreur peut aussi venir des correspondances** entre les champs de votre fichier et les champs cible de Dolibarr | [](https://doc.altairis.fr/uploads/images/gallery/2024-02/FgNimage.png) |
**Note :** Les données sont stockées dans une table de la base de données spécialement prévue à cet effet pour que vous puissiez contrôler votre import avant une écriture définitive dans Dolibarr. Cette table reste alimentée par vos imports successifs (et garde la dernière mise à jour des prix). À cette étape donc, votre base produit n'a absolument pas été modifiée.
#### **4.2.2- Valider le catalogue** Maintenant que vous avez fini les étapes de l'import vous devez **valider le catalogue**. Cela vous permet de contrôler précisément les données avant l'import définitif dans Dolibarr qui rendra vos produits disponibles. Pour cela cliquez à gauche sur **Valider le catalogue**. [](https://doc.altairis.fr/uploads/images/gallery/2024-02/menu-de-gauche-copie.png)**Note :** Si pour une raison quelconque vous devez arrêter votre progression, prenez en compte que votre avancement sera gardé en mémoire vous pourrez toujours revenir dessus.
##### **Explication de l'écran** ##### Les éléments visuels 1. 1. 1. 1. 1. choix du nombre d'éléments à afficher 2. bouton d'action 3. nom du champ avec les données par colonne 4. la description de la catégorie si il y en a une 5. les boutons créent catégorie et supprimé catégorie ##### Les boutons d'action Vous permettant de faire les actions : - - - - - copier (pour coller sur n’importe quel fichier de votre choix l'intégralité du tableau) - créer un fichier CSV - imprimer le tableau dans son intégralité Les éléments de sélection suivants sont là pour vous aidez visuellement à vous repérer, vous pouvez aussi cliquer directement sur les lignes que vous souhaitez voir en surbrillance ou choisir une action et cliquez ensuite : - - - - - sélection - sélection seule - sélectionner tout - désélectionner tout - sélectionner telle ligne - sélectionner telle colonne - sélectionner telles cellules ##### **Création catégorie et produit ** ##### Création catégorie Il s'agit ici de **valider la création ou la suppression** (qui serait potentiellement une erreur non vue lors de votre vérification de votre fichier CSV) des champs concernant **la catégorie **de votre fichier CSV. Faites la création et ou la suppression catégorie en cliquant sur **Créer** ou** Supprimer catégorie** et de **confirmer votre choix**. Les messages que vous verrez apparaître à la fin de cette manipulation selon la configuration de votre fichier CSV et de vos choix lors de l'import et de la validation de la catégorie sont les suivants : - - - - - Les lignes sans catégories ont été supprimées de l'import - Les lignes ont été affectées à la catégorie \[code catégorie\] - Les lignes sans catégories ont été acceptées - Les (x) catégories ont été créées - Toutes les lignes ont été supprimées**Note :** Vous ne passerez pas par cet écran **si vous avez défini une catégorie lors de l'import** via la liste déroulante. **Si vous n'avez pas affecté de catégorie à vos produits** dans votre fichier CSV ni pendant les étapes de votre import.
| **Exemple d'écran pour la validation de la catégorie ** |
| **Vous avez indiqué une nouvelle catégorie dans votre fichier CSV :** |
| Création de la ou les catégories [](https://doc.altairis.fr/uploads/images/gallery/2024-03/ifKimage.png) |
| **Des produits non pas de catégorie dans votre fichier CSV **n'y pendant **les étapes de votre import : ** |
| Vous pouvez toujours choisir de ne pas avoir de catégorie ; dans ce cas vous aurez directement l'écran de la création des produits**.** [](https://doc.altairis.fr/uploads/images/gallery/2024-03/Hquimage.png) |
| **Vous avez indiqué une nouvelle catégorie lors de l'import ** |
| Vous aurez directement l'écran de la création des produits [](https://doc.altairis.fr/uploads/images/gallery/2024-03/z9timage.png) |
**Note :** À partir du moment où vous créez les produits, ils sont créés dans votre base produits / services. Ils seront hors vente et hors achat, sans éléments de prix, tant que vous n'avez pas validé les prix.
#### **4.2.3- Produits qui ne sont plus au catalogue ** Vous pouvez gérer les nouveaux produits et les produits supprimés du catalogue, même si vous importez plusieurs fournisseurs d'un coup.ATTENTION Le seul cas qui n'est pas géré par cette fonctionnalité concerne le cas où vous supprimez totalement un fournisseur de vos listes. En effet, le module s'appuie sur les codes fournisseurs pour parcourir la base de données et vous dire si des produits de ces fournisseurs sont présents dans votre Dolibarr, mais pas dans votre liste nouvellement importée. À des fins d'allègement de traitement (pour le programme et pour vous !), le module ne va donc pas s'occuper de vous lister tous les produits de tous les fournisseurs qui ne seraient pas dans votre import ! De ce fait, il ne sera pas possible de mettre en évidence les produits d'un fournisseur qui aurait « disparu » de votre liste. Vous devrez traiter ce cas manuellement.
##### Fonctionnement : Le module va détecter les nouveaux produits et vous demander d'en valider la création, comme vu ci- dessus. Il va également détecter, sur la base des références fournisseur, si des produits existant dans votre base Dolibarr ne sont plus présents dans le nouvel import. Cela peut supposer que ces produits ne sont plus distribués, et vous devez les mettre hors achat, voire hors vente si vous ne les avez plus en stock. En tout état de cause il n'y a pas d'automatisation : c'est à vous de décider. Le module de gestion des prix vous présente la liste de ces produits pour vous permettre de gérer les cas à la main et selon votre situation. La liste présentée propose les éléments suivants pour vous y retrouver : • Gestion des prix et catalogues fournisseurs • Nom du fournisseur • Réf. Produit fournisseur • Référence interne du produit (la référence Dolibarr pour ce produit) • Libellé • Catégorie si existante #### **4.2.4- Export du tableau « Produit qui ne sont plus au catalogue » ** Depuis cette nouvelle version du module, vous pouvez exporter directement vos tableaux au format de votre choix avec l'un des boutons d'export présents au dessus du tableau : • copier dans votre presse-papier • Excel : sortie d'un fichier au format csv • PDF : sortie d'un fichier pdf • Print : prépare dans le navigateur les informations pour impression. Utiliser ensuite les fonctions d'impression du navigateur. À partir de ces informations, vous devez faire à la main les opérations de mise hors achat des produits (sauf à les trouver ailleurs, ils ne sont plus disponibles chez votre fournisseur) voire hors vente selon que vous les avez en stock ou pas. Vous pouvez bien sûr terminer votre validation des prix avant de réaliser ces opérations manuelles de correction de votre base de données produits. Si vous ne faites pas ces opérations, les produits listés ici seront toujours présents dans votre base produits de Dolibarr et pourront être normalement utilisés ! Ceci pouvant vous conduire à des difficultés, soyez vigilant et ne négligez pas cette étape. Dans le futur, le module devrait permettre de cliquer sur les références pour accéder directement aux fiches produit concernées. La désactivation directe des produits n'est pour l'heure pas envisagée, car cela dépend beaucoup de l'activité de chacun : on peut avoir d'autres fournisseurs pour ce produit, ou l'avoir en stock et continuer à le vendre. Encore une fois, c'est à vous de décider. #### **4.2.5- Validation des prix** Il s'agit ici de **valider la création ou la suppression** (qui serait potentiellement une erreur non vue lors de votre vérification de votre fichier CSV) **des prix **de votre fichier CSV. Les **lignes éventuellement supprimées en amont **ne seront pas présentes sur cet écran. Sur cet écran il à un champ **Rechercher **qui apparaît à gauche des boutons d'actions, il vous permet de rechercher dans toutes vos ligne par : - - - Réf. - Libellé - Description - Fournisseur - Nom - Réf.produit fournisseur - Tag / Catégorie Tapez une référence produit et attendez un léger moment pour voir votre recherche apparaître automatiquement sans autre action de votre part. Il vous reste plus qu'à cliquer sur **Valider **ou **Supprimer **les prix en bas à droite de votre écran et de **confirmer votre choix**. Si votre **fichier et volumineux** vous pouvez **utiliser **l'option "**Nombre de prix à valider**" directement disponible sur votre écran. **Par exemple** : votre fichier comporte 122 lignes, notez 61 puis cliquez sur Valider les prix, les soixante et une premières lignes seront validées. Notez de nouveau 61 puis validez de nouveau et ce sont les lignes qui sont après les soixante et une premières lignes validées qui seront validées est ainsi de suite. [](https://doc.altairis.fr/uploads/images/gallery/2024-03/bouton-valide-prix.png) Une fois votre choix confirmé vous verrez apparaître l'un des messages suivants : - - (x) prix ont été créés - (x) prix ont été modifiés (dans le cas d'une mise à jour) - Toutes les lignes ont été supprimées Une fois les prix validés vous verrez ce message d'information apparaître : [](https://doc.altairis.fr/uploads/images/gallery/2024-03/QCiimage.png)**Note : La validation du catalogue peut devenir très longue** si vous avez **un fichier CSV trop volumineux** (beaucoup de lignes de prix à importer, beaucoup de niveaux de prix) dans le même fichier CSV. Il est donc** préférable de découper votre fichier CSV en plusieurs imports** distincts.
#### **4.2.6- Interruption volontaire de la validation ** Si vous remarquez des erreurs à corriger lors de l'une des étapes de la validation du catalogue, vous pouvez interrompre l'opération pour corriger votre fichier d'import et recommencer à partir de l'étape 1 de l'import. Toutefois, il est **impératif** d'**interrompre proprement** la procédure en vidant totalement les informations enregistrées à cette étape de validation. ##### **IMPORTANT**Supprimez systématiquement les lignes qui vous sont proposées à la validation jusqu'à ce qu'il n'y ai plus rien à valider. Si vous avez déjà créé les produits ou en cas de mauvaise interruption de la procédure de mise à jour via la gestion des prix; vous allez avoir des produits dans Dolibarr hors vente et hors achat, qui n'ont pas d'information de prix et qu'il vous faudra aller supprimer un par un (cette étape peut vite devenir longue en fonction du nombre important de produit qui seront créés). Et si vous oubliez de le faire, le prochain import vous remontera des erreurs en vous disant que les références que vous importez existent déjà (ce sont ces produits hors vente et hors achat sans informations de prix). Vous gagnerez donc un temps précieux en interrompant proprement la procédure d'import.
# 4.3- Affichage du catalogue Une fois votre catalogue importé vous pouvez le retrouver en intégralité via le menu de gauche **Afficher le catalogue**. Vous y trouverez des filtres pour mieux rechercher un produit par : - le fournisseur - sa catégorie - son état de vente ou achat ou les deux Et par mot-clé dans la zone de recherche filtrant sur les colonnes : - - Réf. - Libellé - Description - Fournisseur - Nom - Réf.produit fournisseur - Tag / Catégorie Vous retrouverez aussi les boutons d'actions vues pendant la validation des produits, vous permettant de faire les actions suivantes : - copier pour coller sur n’importe quel fichier de votre choix l'intégralité du tableau - créer un fichier CSV - imprimer le tableau dans son intégralité Les éléments de sélection suivant sont là pour vous aidez visuellement à vous repérez, vous pouvez aussi cliquer directement sur les lignes que vous souhaitez voir en surbrillance ou choisir une action et cliquez ensuite : - sélection - sélection seule - sélectionner tout - désélectionner tout - sélectionner telle ligne - sélectionner telle colonne - sélectionner telle cellules Ce catalogue de prix se mettra à jour au fur et à mesure de vos imports catalogue futur.**Note :** Ce catalogue de prix n'est pas modifiable manuellement même si vous modifiez le produit depuis sa fiche.
# 5- Après l'import # 5.1- Onglet Gestion des prix sur les fiches produits Sur les fiches produits, vous pouvez via l'option "Ajouter l'onglet du catalogue de prix" et ayant mis la permission "Afficher l'onglet de gestion des prix sur la fiche produit" afficher l'onglet Gestion des prix qui selon votre préférence peut tout à fait remplacer les onglets Prix de vente (prix clients) et Prix d'achat (prix fournisseur) là aussi configurable dans le module et les permissions. **Toutes les informations de prix** que vous avez renseigné dans votre import catalogue **se retrouvent ici** et **sont modifiables ou supprimables**. #### **5.1.1- L'écran** **La partie du haut** de l'écran présente les informations sur le fournisseur tel que : - le prix d'achat minimum avec sa monnaie - la TVA - le prix de vente minimum HT - le prix de vente non remisé avec sa monnaie HT - la remise client remise client en pourcentage - le prix de vente **La partie du bas **de l'écran** ** présente l'ensemble des éléments de prix pour ce produit tel qu'il ont été importés. Ce tableau est modifiable, très utile si vous souhaitez modifier quelques produits sans repasser par un import catalogue. Cette partie est divisée en trois couleurs vous permettant de mieux vous repérer : 1. le fournisseur et la quantité 2. tout ce qui concerne l'achat fournisseur 3. tout ce qui concerne la vente au client [](https://doc.altairis.fr/uploads/images/gallery/2024-03/mwlimage.png) #### **5.1.2- Modification unitaire d'un prix produit** Si l'import en masse des prix ou la modification des coefficients d'achat et de vente nécessitent des permissions adéquates dans Dolibarr, l'édition au cas par cas des prix d'un produit importé via la gestion des prix reste accessible à tout utilisateur ayant le droit d'accéder aux produits et services. Modifiez une ou plusieurs données de prix, en gardant à l'esprit que **les calculs en cascade seront faits à nouveau**. **Changez uniquement ce dont vous avez besoin** et **les autres prix seront automatiquement recalculés** (si vous changez par exemple le coefficient de vente, le taux de TVA ou le prix de base, les prix qui en découlent seront recalculés). 1. Rendez vous sur la fiche du produit 2. Cliquez sur l'onglet « GESTION DES PRIX » pour afficher le tableau des prix importés et calculés, tels qu'ils sont enregistrés et appliqués actuellement. 3. Cliquez sur l'icône d'édition [](https://doc.altairis.fr/uploads/images/gallery/2024-03/W3bimage.png) en bout de ligne. 4. Modifiez le ou les éléments de prix ayant changé. 5. Cliquez sur le symbole vert [](https://doc.altairis.fr/uploads/images/gallery/2024-03/aA8image.png)en fin de ligne pour valider votre opération. Vous aurez à confirmer votre action. Pour quitter la modification sans enregistrer vos modifications, cliquez sur la croix rouge [](https://doc.altairis.fr/uploads/images/gallery/2024-03/tGyimage.png) en fin de ligne. Pour supprimer, cliquez sur la poubelle. [ ](https://doc.altairis.fr/uploads/images/gallery/2024-03/8pDimage.png)**Note : Cette modification n'est pas répercutée sur le catalogue** tel qu'il est accessible dans la **G**estion des prix > **A**fficher le catalogue. En effet, ce catalogue est celui enregistré dans la table spécifique à l'import et ne bouge pas tant qu'il n'y a pas de nouvel import. Il peut alors servir de référence.
# 5.2- Prise en compte des produits créés manuellement Si vous créez manuellement des produits entre deux imports catalogue, vous pourrez quand même les mettre à jour lors du prochain import, le module saura les retrouver et traiter ce cas. Pour cela : 1. vous devez avoir activé, au moins temporairement, dans la configuration du module l'affichage des onglets "prix clients" et "prix fournisseur" sur les fiches produits (sinon vous ne pourrez pas remplir correctement toutes les informations de prix pour ce produit). 2. Vous avez renseigné au moins un fournisseur pour ce produit, avec des informations de prix correspondantes. Dès lors, vous pourrez mettre à jour ce produit en renseignant dans votre fichier d'import le code fournisseur et la référence produit pour ce fournisseur pour que le module puisse retrouver le produit et la référence fournisseur dont les éléments de prix sont à modifier. # 6- Les options du module Les différentes options du modules # 6.1- Les constantes cachées qui peuvent vous être utiles Ici il s'agit de **constantes dite cachées**, car elles ne sont pas une option intégrée à la configuration du module. Il s'agit principalement de paramètres réservés pour les développeurs et paramétrage avancé uniquement. Si l'une d’elles vous convient dans votre utilisation du module, vous pouvez aller dans **Accueil** > **C**onfiguration > **D**ivers. **Indiquez** le nom de la constante et mettez sa 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ées à l'utilisation du module en général** | ||
| **Nom de la constante** | **Valeur à noter** | **Ce que ça fait** |
| PRICES\_KEEP\_REF\_FOURN | 1 ou 0 | Garde la réf fournisseur |
| PRICES\_DONT\_UPDATE\_STATUS | 1 ou 0 | Permet de ne pas toucher au statut (en vente, en achat) des produits mis à jour. V2024-02-13 |
| PRICES\_VALIDATE\_EMPTY\_BUYPRICE | 1 ou 0 | Valider le prix d'achat vide mais un prix de vente non nul (le prix de vente est à importer explicitement dans le champ "prix de vente non remisé"). |
| PRICES\_USE\_PREFERRED\_SUPPLIER | 1 ou 0 | Utiliser un fournisseur préféré |
| PRICES\_FORCE\_EMPTY\_PRICE | 1 ou 0 | Permet d'importer un prix à 0 |
| PRICES\_CATALOG\_INIT\_DONE | 1 ou 0 | L'initialisation ne peut se faire qu'une fois. À la suite de quoi, cette constante est à 1 dans la base de données. Passez la à 0 si vous devez refaire la procédure d'initialisation. Pensez à la remettre à 1 ensuite (ou la supprimer de la liste) **Attention** : la réinitialisation et l'usage de cette variable doit se faire avec le contrôle du contenu des tables de données propres au module. |
| PRICES\_EXTRAFIELDS\_USED | 1 ou 0 | Lister ici les extrafields que vous souhaitez pouvoir mettre à jour avec vos imports de catalogue en indiquant le code de l'extrafield. Séparez plusieurs extrafields par une virgule (sans espace après la virgule). |
| PRICES\_UPDATE\_COSTPRICE | 1 ou 0 | Mettre à jour le prix de revient |
| PRICES\_FORCE\_MIN\_RESELL\_PRICE | 1 ou 0 | Force le prix minimum de revente |
| PRICES\_UPDATE\_MULTILANGS | 1 ou 0 | Met à jour le multilangs |
| PRICES\_ONE\_CATEGORY\_PER\_PRODUCT | 1 ou 0 | Implique qu'un produit ne sera quand dans une seule catégorie. Le produit sera ajouté à la catégorie spécifiée à l'import. S'il était déjà dans d'autres catégories, il sera supprimé de ses autres catégories (sauf si utilisation de la constante PRICES\_SPECIAL\_CATEGORIES). |
| PRICES\_SPECIAL\_CATEGORIES | ..,..,... | Liste, séparée par des virgules, des catégories dont l'association avec les produits ne sera pas supprimée si PRICES\_ONE\_CATEGORY\_PER\_PRODUCT est activé |
| PRICES\_INIT\_MULTIPRICES | 1 ou 0 | **Attention** : constante temporaire à 0 lors de l'installation du module : elle passe à 1 une fois l'initialisation de la partie multi-prix réalisée. L'usage de cette constante doit se faire avec le contrôle du contenu des tables de données propres au module. |
| **Lié à l'utilisation de Pricebox** | ||
| PRICES\_PRICEBOX\_QUICKSEARCH\_ON\_FIELDS | 1 ou 0 | Recherche rapide sur les champs (impacte très fortement les performances si le nombre de produits est important) |
**Note :** Pour ne pas modifier toute la colonne de remise client vous pouvez filtrer et modifier seulement les lignes filtrées ou modifier par ligne produit. Pour modifier cliquez sur le crayon et utilisez le point comme séparateur et pas la virgule. Ces modifications seront prises en compte sur la fiche du produit au niveau du stock et de l'onglet gestion des prix pour la remise client.
#### **6.3.5- Choisir les colonnes à afficher** Vous pouvez** choisir quelle colonne afficher** via le menu "burger" se trouvant à droite du tableau. **Cocher** les colonnes a afficher, **décocher** les colonnes que vous ne voulez pas afficher (**cet affichage est propre à chaque utilisateur**). [](https://doc.altairis.fr/uploads/images/gallery/2024-03/pricebox-menu-burger.png)**Note : Activer la permission **pour voir le tableau. Les champs supplémentaires (extrafields) que vous aurez éventuellement ajoutés à vos produits seront pas gérés automatiquement sur ce tableau, ils ne seront donc pas visibles.
# 7- Pour finir Question fréquentes, bonnes pratiques Licence, crédit et historique des modification # 7.1- Question fréquentes / Informations pratiques #### **7.1.1- Question fréquentes** ##### 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.](https://support.altairis.fr/) 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. ##### Autres difficultés Aucune difficulté connue à ce jour. #### **7.1.2- Informations pratiques** ##### Liens directs Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous : - - - Gestion des prix sur [notre site](https://www.altairis.fr/boutique/produits-associes/) => changer le lien - Le forum français ##### Support Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de [support ](https://support.altairis.fr/)est à votre disposition pour signaler un bug rencontré. Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de [nos forfaits de support](https://www.altairis.fr/assistance/). ##### Crédit et historique des modifications Pour la présente documentation du module Gestion de prix pour Dolibarr :| **Version** | **Auteurs** | **Date** | **Licence** |
| 1 | Gebeer Lehnid - Sarl ALTAIRIS | [GFDL](https://www.gnu.org/licenses/fdl-1.3.html "Gnu Free Documentation License") | |
| 2 | Agnès Rambaud | [GFDL](https://www.gnu.org/licenses/fdl-1.3.html "Gnu Free Documentation License") | |
| 3 | Mélina Joum | Mars 2024 | [GFDL](https://www.gnu.org/licenses/fdl-1.3.html "Gnu Free Documentation License") |