Gestion des prix (Prices)

Idéal pour la gestion des catalogues fournisseurs : importer et gérez vos catalogues de prix en une opération de masse avec création des nouveaux produits, désactivation des produits qui ne sont plus au catalogue si pas de stock, coefficients d'achat et de vente pour calcul automatique des prix.


1- Le module Gestion des prix

Présentation générale, installation, activation

1- Le module Gestion des prix

1.1- Présentation

Le module de gestion des prix offre une méthode rapide de gestion des catalogues de prix fournisseurs et d'actualisation des prix des produits.

image.png

1.1.1- Fonctionnalités 

Le module dispose de deux fonctions principales qui sont les suivantes :

L'opération permet d'importer les prix actualisés des catalogues fournisseurs, ainsi que tous les éléments relatifs à la gestion des prix d'achat et de vente ; y compris des remises clients / fournisseurs et les taux de TVA. Vous pouvez importer les produits de plusieurs fournisseurs en même temps si besoin et attribuer à vos produits les catégories de votre choix. 

Bien que vous puissiez mettre dans votre import les prix de vente, le module Gestion des prix vous permet aussi de calculer automatiquement les prix finaux de revient et de vente par la prise en compte d'un coefficient de vente et un coefficient d'achat. Ces coefficients sont soit paramétrables dans la configuration du module - et appliqués à tous vos produits importés, soit - et c'est à utiliser si vos coefficients peuvent varier - indiqués dans vos fichiers d'import.
Les coefficients globaux peuvent être actualisés à n'importe quel moment, les prix de revient et de vente sont alors automatiquement recalculés en fonction des nouveaux coefficients indiqués. Bien sûr, vous n'utiliserez pas cette options si vos coefficients sont variables en fonction des produits.

Les coefficients d'achat permettent par exemple de prendre en compte des taux de change, des frais d'approche ou de douane...
Les coefficients de vente quant à eux permettent de générer des prix de vente en fonction de votre marge.

À tout moment, vous pouvez décider de juste importer les prix d'achat et les prix de vente (sans utiliser les coefficients, donc) : tous les prix "intermédiaires" seront automatiquement calculées par le module (prix de revient, prix unitaire si vous avez un prix pour une quantité supérieure à 1) .

La PriceBox vous liste les produits gérés par votre module (et donc également dans votre base de produits). Les équipes marketing pourront ici filtrer sur une marque, un fournisseur, ou d'autres critères et avoir des opérations de masse pour par exemple modifier des remises clients au coup par coup, pour une promotion, une opération spéciale...

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 le module Multi-société.

Par ailleurs, il est conforme à la loi de finances 2016. 

1.1.3- Cible

Le module s'adresse à tous les utilisateurs de Dolibarr. Il est nécessaire de savoir utiliser un tableur et maîtriser la conversion de fichier en format .csv

1.1.4- Licence 

Tous nos modules sont distribués sur notre boutique en ligne et 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 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- Plateforme de support

Si vous rencontrez un problème avec le module, vous pouvez ouvrir un ticket sur notre page de support. Notez que nous offrons une maintenance seulement corrective qui n'inclut pas d'aide à l'utilisation ou de support utilisateur, mais seulement la correction des bogues, sous réserve de la bonne utilisation du module et dans le cadre de la compatibilité avec la version utilisée de Dolibarr.
Si vous avez une demande de formation, d'évolution, ou d'ajustement personnalisé, vous pouvez prendre un forfait support sur notre site.

1.1.5.4- 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 plateforme de support. Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet sur le forum.

1- Le module Gestion des prix

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 et le Dolistore.

 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- Le module Gestion des prix

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 :

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.

Module Prices dans la configuration de dolibarr

  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 dispose des permissions suivantes :

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 image.png.

2- Configuration

2- Configuration

2.1- Les options générales

2.1.1- Base de calcul du prix de vente

Détermine si le coefficient de vente est appliqué sur le prix catalogue ou le prix de revient.

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).

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.

2.1.7- Ne pas mettre à jour les prix de vente à la validation

Permet de valider le catalogue suite à votre import sans mettre à jour les prix de vente (mais bien les prix d'achat).

2.1.8- Ne pas forcer les coefficients de vente lors de la validation des prix

Permet de valider le catalogue suite à votre import incluant des coefficients de vente ou des prix de vente sans mettre à jour le coefficient de vente et le prix de vente.

2- Configuration

2.3- Plusieurs niveaux de prix et prix minimum

Le module gère plusieurs niveaux de prix de vente pour un même produit. Le choix du nombre de niveau de prix se fait dans Configuration > Modules > Produits. Vous choisissez le nombre de niveaux de prix que vous souhaitez gérer.

Un nombre limité de champs de l'import sont liés aux niveaux de prix :

Si vous gérez plusieurs niveaux de prix, vous retrouverez cette séquence autant de fois que de niveaux de prix sur chaque ligne de votre fichier CSV.
Vous pouvez importer sans distinction : 

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 :

image.png

Comme indiqué dans le tableau des correspondances des champs 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- Configuration

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.

coefficient par défaut 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- Configuration

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). 

image.png

image.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- 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 : 

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.

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- Import de listes de prix

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 : 

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 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 2024.07-168-g483f718
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

4.1.5- Fournisseur multiples pour un même produit

Vous pouvez gérer plusieurs prix fournisseur pour un même produit. Pour cela dans votre fichier CSV vous devez mentionner la référence interne du produit. 

Donc si dans votre import vous disposez d'au moins deux prix fournisseurs nouveaux pour un nouveau produit ; nous importons les deux fournisseurs (même code fournisseur), les références fournisseur pour le produit (qui sont différentes), le libellé (qui doit être identique), la description (de préférence identique également, le module n'en prendra qu'une), les éléments de prix (prix base fournisseur, TVA achat et vente, éventuelles remises, quantité et prix pour la quantité, éventuelles charges...). 

Dans ce cas précis, lors de la procédure de validation du catalogue, le module va mentionner deux nouveaux produits à créer, avec les deux lignes correspondant aux deux prix fournisseurs. Mais à la création du produit, vous aurez une ligne d'erreur disant qu'un produit a été créé, puis l'erreur : "le produit existe déjà pour la deuxième ligne". C'est normal puisque dès le traitement de la première ligne de prix, le produit est créé et du coup le deuxième n'est pas vraiment une création. Nous n'avons pas encore traité dans cette version une procédure plus explicite, mais le produit est bien créé et vous pourrez ensuite valider les deux lignes de prix pour les deux fournisseurs, tout à fait normalement. 

Bien entendu, si vous importez vos prix fournisseurs pour le même produit dans deux fichiers séparés, vous n'aurez pas ce problème.

4.1.6 - "Fournisseur préféré" pour le calcul du prix de vente

Si vous avez plusieurs fournisseurs pour un même produit, vous avez peut-être besoin d'un prix d'achat de référence pour calculer votre prix de vente : quels que soient les autres prix fournisseurs, c'est sur ce prix-là que vous basez votre calcul du prix de vente. Or par défaut, le dernier import modifie les prix et donc le prix de vente : donc par défaut, les derniers prix fournisseurs importés vont déterminer les prix de vente.

Le module Gestion des prix vous permet d'indiquer lorsqu'un fournisseur doit être considéré comme la référence à conserver pour le calcul des prix de vente d'un produit, via la notion de "fournisseur préféré". Ainsi, les imports futurs d'autres prix fournisseurs pour ce produit n'affecteront pas le prix de vente du produit. 

Pour cela, ajoutez dans votre CSV une colonne "fournisseur préféré" et mettez 1 pour chaque ligne de prix pour laquelle c'est ce tarif qui doit servir de référence pour le calcul du prix de vente.

Si pas de colonne dans le CSV ou 0 est indiqué dans la colonne : le prix de vente du produit est mis à jour avec chaque nouvel import pour ce produit, quel que soit le fournisseur.

Si 1 est indiqué dans le CSV : les imports futurs avec d'autres prix venant d'autres fournisseurs n'affecteront pas les prix de vente qui resteront ceux du fournisseur indiqué comme "fournisseur préféré".

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- Import de listes de prix

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 image.png pour passer à l'étape 2.

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é. 

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.

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.

image.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 image.png 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 image.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 image.pngen 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
etape 2 - D.png

etape 2 -D.png

Pour finir cette étape cliquez sur Étape suivante.

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

 

image.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

 

 

 

image.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.

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. 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 :

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 :

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 :

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

image.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.

image.png
Vous avez indiqué une nouvelle catégorie lors de l'import

Vous aurez directement l'écran de la création des produits

image.png
Création produit

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 le produit fournisseur de votre fichier CSV.

Faites la création et ou la suppression produit en cliquant sur Créer ou Supprimer produit 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 produit fournisseur sont les suivants :

image.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 :

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.

bouton validé prix.png

Une fois votre choix confirmé vous verrez apparaître l'un des messages suivants :

Une fois les prix validés vous verrez ce message d'information apparaître :

image.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- Import de listes de prix

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 :

Et par mot-clé dans la zone de recherche filtrant sur les colonnes :

Vous retrouverez aussi les boutons d'actions vues pendant la validation des produits, vous permettant de faire les actions suivantes :

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 :

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- 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 :

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

image.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 image.png en bout de ligne.
  4. Modifiez le ou les éléments de prix ayant changé.
  5. Cliquez sur le symbole vert image.pngen 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 image.png en fin de ligne.
Pour supprimer, cliquez sur la poubelle. image.png

 

Note : Cette modification n'est pas répercutée sur le catalogue tel qu'il est accessible dans la Gestion des prix > Afficher 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- Après l'import

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- Les options du module

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 > Configuration > Divers.

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)

  

6- Les options du module

6.2- Mise à jour des prix à partir d'une liste de prix

Pour procéder à la mise à jour de vos prix, vous procédez de la même manière que précédemment, par un import de votre fichier CSV où vous avez mis à jour les prix fournisseurs.

L'étape de mise à jour des prix existant dans Dolibarr se fait dans la deuxième partie du module : la validation du catalogue.

Quels champs sont mis à jour ? 

Tous les champs sauf la reférénce produit (référence interne dans votre dolibarr) peuvent être mis à jour. 

Il y a un impératif à respecter : le module doit avoir au moins un champ qui sert de référence pour savoir s'il doit mettre un produit à jour (et donc mettre à jour le bon produit de votre base de données) ou s'il doit créer un nouveau produit.

C'est la référence interne de Dolibarr qui sert de point de repère au module pour savoir quel produit mettre à jour (que ce soit une référence automatique ou une référence librement construite). Ce sera le cas par exemple si l'on met à jour le libellé, les prix, ou si l'on ajoute un nouveau fournisseur à un produit existant. 

Cas particulier: les catégories 

Lors de l'import, s'il y a une catégorie renseignée pour un produit, le produit sera alors associé à la catégorie correspondante de Dolibarr. Si la catégorie n'existait pas dans Dolibarr, elle sera créée.

Lors d'un import ultérieur, si vous changez la catégorie de ce produit, alors le produit sera associé à cette nouvelle catégorie. Mais il ne sera pas détaché de la première catégorie : il n'y a pas de remplacement, juste un ajout.

Pourquoi ? Cela permet tout simplement de gérer plusieurs catégories pour un même produit. Il suffit alors d'avoir une ligne par catégorie associée dans votre fichier d'import (les autres champs étant strictement identiques).

6- Les options du module

6.3- Pricebox

Sur le menu à gauche du module vous trouvez un menu intitulé "Pricebox", il s'agit là d'une vue vous permettant de consulter sous forme de tableau tous vos produits et d'y effectuer des modifications sans repasser par un import.

6.3.1- Les éléments du tableau

6.3.2- Les filtres de recherche

Vous pouvez utiliser les filtres de recherche suivant (au-dessus du tableau) :

6.3.3- Les colonnes triables

Les colonnes sont toutes triables par ordre croissant / décroissant ou alphabétique en cliquant sur l'intitulé de la colonne.

6.3.4- Modifier des éléments

Vous pouvez modifier :

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).

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- Pour finir

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. 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 :

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 :

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.

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
2

Agnès Rambaud
GFDL
3

Mélina Joum

 Mars 2024
 GFDL