CustomLine : Différence entre versions

De Documentations Patas-monkey
Sauter à la navigation Sauter à la recherche
(e)
 
(75 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 4 : Ligne 4 :
 
| Ce Module améliore la saisie des lignes de détails des éléments de Dolibarr.
 
| Ce Module améliore la saisie des lignes de détails des éléments de Dolibarr.
 
* En sélectionnant un seul type de saisie
 
* En sélectionnant un seul type de saisie
* En définissant les champs saisisable pour les lignes de saisie (quantité, remise, montant HT, ...)
+
* en filtrant la liste des produits selon leur catégorie
* En permettant la modification en masse des lignes saisies
+
* En définissant les champs saisissable pour les lignes de saisie (quantité, remise, montant HT, ...)
 +
* En permettant la modification en masse des lignes saisies et leur suppression
 
* En important un fichier ou une suite de référence produit/service directement dans l'élément
 
* En important un fichier ou une suite de référence produit/service directement dans l'élément
 
|}
 
|}
Ligne 18 : Ligne 19 :
 
! style="vertical-align:top;width: 100px" |modification en masse
 
! style="vertical-align:top;width: 100px" |modification en masse
 
! style="vertical-align:top;width: 100px" |Importation de fichier
 
! style="vertical-align:top;width: 100px" |Importation de fichier
 +
! style="vertical-align:top;width: 100px" |Filtrage par catégorie
 
|-
 
|-
 
| Proposition commerciale client  
 
| Proposition commerciale client  
 +
| X
 
| X
 
| X
 
| X
 
| X
Ligne 26 : Ligne 29 :
 
|-
 
|-
 
| Commande client  
 
| Commande client  
 +
| X
 
| X
 
| X
 
| X
 
| X
Ligne 32 : Ligne 36 :
 
|-
 
|-
 
| Facture client  
 
| Facture client  
 +
| X
 
| X
 
| X
 
| X
 
| X
Ligne 42 : Ligne 47 :
 
| Partiel*
 
| Partiel*
 
| Partiel*
 
| Partiel*
 +
|
 
|-
 
|-
 
| Facture fournisseur
 
| Facture fournisseur
 
| X
 
| X
 +
|
 
|
 
|
 
|  
 
|  
Ligne 54 : Ligne 61 :
 
| X
 
| X
 
|  
 
|  
 
+
|
 
|-
 
|-
 
| Entrepôt
 
| Entrepôt
Ligne 61 : Ligne 68 :
 
|  
 
|  
 
| X
 
| X
 +
|
 +
|-
 +
| Bom
 +
|
 +
|
 +
| X
 +
|
 +
|
 +
|}
  
 +
== Paramétrage du module ==
 +
{| class="wikitable"
 +
|- style="vertical-align:top;"
 +
| [[File:CustomLine_Config1.png |850px]]
 +
| La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus Accueil > Configuration > Modules en cliquant sur l'icône en bout de ligne.
 
|}
 
|}
 
==Paramétrage==
 
La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus Accueil > Configuration >
 
Modules en cliquant sur l'icône en bout de ligne.
 
 
 
===Page principale de configuration du module===
 
===Page principale de configuration du module===
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|- style="vertical-align:top;"  
 
|- style="vertical-align:top;"  
| [[File:CustomLine-Main-Configuration.png|500px]]
+
| [[File:CustomLine-Main-Configuration.png|800px]]
| Cette page d'administration permet de paramétrer Le mode des saisie des lignes des éléments natif de Dolibarr de 5 manières :
+
| L'administration permet de paramétrer les modes de saisie des lignes d'éléments natif de multiples manières :
 +
[[File:CustomLine-Configuration-modeselection.png|400px]]
 
* Le Fonctionnement standard (natif)
 
* Le Fonctionnement standard (natif)
 
* Seulement la saisie libre des produits et services
 
* Seulement la saisie libre des produits et services
 +
* Seulement la sélection des produit et service prédéfinis
 
* Seulement la saisie libre des produits  
 
* Seulement la saisie libre des produits  
 
* Seulement la saisie libre des services
 
* Seulement la saisie libre des services
* Seulement la sélection des produit et service prédéfinis
+
* Saisie libre des produits par défaut
Elle permet aussi de placer la création d'une nouvelle ligne en début de liste (et non en bas comme par défaut) en activant le switch en bout de ligne
+
* Saisie libre des services par défaut
  
 +
Elle permet aussi de placer la création d'une nouvelle ligne en début de liste en activant le switch en bout de ligne
  
Elle permet enfin de définir le type de calcul pour le prix de vente selon la marge (utilisée pour la modification en masse, cf plus bas)
+
Il est aussi possible d'activer la fonction de filtrage par catégorie de la liste des produits avec le switch associé
 
|}
 
|}
 +
 +
==== Détermination du prix vente selon la marge ====
 +
Si le module marge natif de dolibarr est activé, il est possible d'activer une fonction de mise à jour du calcul du prix de vente à partir du prix de revient.
 +
Le calcul s'effectue à partir de plusieurs valeurs :
 +
* le prix d'achat ou de revient HT (noté ici PAHT)
 +
* le taux de remise si il est saisie (noté ici REMISE)
 +
* le taux de TVA (noté ici TVA)
 +
* une valeur saisie ou prédéternminée (noté ici PCTMARGE)
 +
On peut paramétrer 3 modes de calcul :
 +
* Utilisation du taux de Marque :
 +
Prix de vente  =  (- PAHT / ((PCTMARGE / 100) -1)) / REMISE
 +
 +
* Utilisation du coefficient de marge
 +
Prix de vente  =  (PCTMARGE * PAHT) / REMISE * TXTVA
 +
 +
* Utilisation d'un pourcentage de marge
 +
Prix de vente =  PAHT * (1 + PCTMARGE/100) / REMISE
 +
 +
La valeur utilisée pour le calcul est déterminée à partir
 +
* des valeurs déjà saisie pour chaque ligne et calcul inverse
 +
* de la valeur contenu dans l'attribut supplémentaire associé au produit sélectionné
 +
 +
Une fois cette valeur modifié, il est possible de conserver ou non le nouveau prix de vente déterminé soit pour tout les clients soit en fonction de chaque client.
 +
 
===Gestion des habilitations d'accès===
 
===Gestion des habilitations d'accès===
 
CustomLine permet de gérer par habilitation l'accès lors de la saisie aux champs des lignes.
 
CustomLine permet de gérer par habilitation l'accès lors de la saisie aux champs des lignes.
 
{| class="wikitable"  
 
{| class="wikitable"  
 
|- style="vertical-align:top;"  
 
|- style="vertical-align:top;"  
| [[File:CustomLine-habilitation-right.png|500px]]
+
| [[File:CustomLine-habilitation-right.png|600px]]
 
| Pour chaque utilisateur ou groupe, il est possible de définir  
 
| Pour chaque utilisateur ou groupe, il est possible de définir  
 
* la présence ou non de l'onglet de saisie en masse
 
* la présence ou non de l'onglet de saisie en masse
Ligne 96 : Ligne 139 :
 
** La remise
 
** La remise
 
|}
 
|}
[[File:CustomLine-habilitation-field.png|800px]]
+
[[File:CustomLine-habilitation-field.png|600px]]
  
===Page de configuration des importations (wip)===
+
===Configuration de l'importation===
 +
{| class="wikitable"
 +
|- style="vertical-align:top;"
 +
| [[File:CustomLine_Config2.png |600px]]
 +
| <strong>Paramètres</strong><br>ImportCsvSeparator (ByDefault) - Dans ce champ, vous devez indiquer le type de séparateur qui sera accepté dans le document CSV.
 +
 
 +
<strong>Élément</strong><br>Choisir le type d'élément dans lequel les données seront importées (Propositions Commerciales, Orders, Factures, Commandes Fournisseurs).
 +
 
 +
<strong>Paramétrage d'import</strong><br>Choisissez le paramétrage à définir pour l'importation.
 +
* Autorise l'importation - (Oui / Non)
 +
* Mode d'identification des colonnes
 +
** Basé sur le libellé du champ
 +
** Basé sur le nom du champ
 +
** Basé sur l'ordre des champs
 +
* Ligne où se trouve les nom de colonne - indique la lignes ou se trouve les colonnes (habituellement 1 dans un csv)
 +
* Séparateur utilisé dans le fichier CSV - Vous pouvez utiliser le séparateur par défaut ou le modifier spécifiquement pour cette importation.
 +
* Encadrement des chaînes de caractères - Utilisez généralement des guillemets, des guillemets simples, etc.
 +
* Format des dates importées - Choisir la représentation des dates (JJ/MM/AA, JJ/MM/AAAA, AAAA/MM,JJ, ...)
 +
 
 +
<strong>Paramètre des champs importés</strong><br>Sélection des champs qui seront importés, sachant que certains champs sont déjà obligatoires.
 +
|}
 +
=== Gestion du mode d'identification des colonnes ===
 +
Il est possible de définir 3 méthodes pour définir le contenu des colonnes à importer :
 +
{| class="wikitable"
 +
|- style="vertical-align:top;"
 +
|<strong>Basé sur le libellé du champ</strong>
 +
 
 +
[[File:CustomLine_param_import_libelle.png |300px]]
 +
 
 +
Il faut utiliser le nom des colonnes dans le fichier d'import et de définir les champs présents dans celui-ci
 +
 
 +
Attention, certains champs sont obligatoire.
 +
|<strong>Basé sur le nom du champ</strong>
 +
 
 +
[[File:CustomLine_param_import_champs.png |300px]]
 +
 
 +
Il faut saisir dans le paramétrage de l'importation le nom du champs dans le fichier à importer.
 +
|<strong>Basé sur la position du champ</strong>
 +
 
 +
[[File:CustomLine_param_import_position.png |300px]]
 +
 
 +
Il faut ici définir la position du champ dans la liste, le nom de la colonne n'est pas utilisé
 +
|}
  
 
==Fonctionnement==
 
==Fonctionnement==
 +
=== mode prédéfinis des sélections ===
 
En fonction de paramètres appliqués (voir section "Configuration des fonctionnalités du module" plus bas), pour chacun des éléments, vous aurez :
 
En fonction de paramètres appliqués (voir section "Configuration des fonctionnalités du module" plus bas), pour chacun des éléments, vous aurez :
 
{| class="wikitable"
 
{| class="wikitable"
Ligne 116 : Ligne 202 :
 
Sélection des produits/services prédéfinis et libres - fonctionnement natif de Dolibarr
 
Sélection des produits/services prédéfinis et libres - fonctionnement natif de Dolibarr
 
|}
 
|}
 +
 +
=== Filtrage par catégories de produits ===
 +
 +
[[file:customline_categorie_filter.png|700px]]
 +
 +
Une fois la fonction activé, une icone en forme de filtre apparait pour sélectionner ou non une ou plusieurs catégories produits.
 +
 +
[[file:customline_categorie_filter_made.png|700px]]
 +
 +
Une fois la sélection validée, la liste des produits est alors limité aux produits associés, il est possible de sélectionner plusieurs catégories à la fois
 +
 +
Une vidéo est disponible expliquant le fonctionnement du filtrage
 +
 +
<youtube>LDDi8TxupJA</youtube>
  
 
==Modification en masse des lignes des documents commerciaux==
 
==Modification en masse des lignes des documents commerciaux==
Ligne 141 : Ligne 241 :
  
 
==Importation des lignes des documents commerciaux==
 
==Importation des lignes des documents commerciaux==
===Configuration de l'importation(wip)===
+
L'importation s'effectue en deux étapes :
===Lancement d'une importation de ligne(wip)===
+
1 D'abord la récupération du fichier de données sur le serveur
 +
2 Ensuite le lancement de l'importation des données du fichier
 +
 
 +
Ses deux étapes se réalisent au niveau du meme onglet de l'élément 'Impport en masse'
 +
 
 +
{| class="wikitable"
 +
| [[file:customline_importation.png|600px]]
 +
| style="vertical-align:top;" |
 +
La récupération du fichier s'effectue sur la première partie de l'écran. Il faut sélectionner un fichier puis valider l'importation
 +
 
 +
Le lancement de l'import s'effectue en appuyant sur l'icone en bout de ligne. Une fois l'importation des lignes réalisées.
 +
 
 +
Il est possible de supprimer le fichier importé du serveur en appuyant sur l'icone en forme de poubelle.
 +
|}
  
 
==autres fonctionnalités==
 
==autres fonctionnalités==
Ligne 152 : Ligne 265 :
 
|
 
|
 
Permissions par défaut
 
Permissions par défaut
 +
{{Note|
 +
le fait de cacher le tableau des marges, enlève aussi l'accès au champ permettant de saisir (et visualiser) le prix de revient du produit...
 +
|warn}}
 +
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
 
| [[file:customline_Permission-utilisateurs.png|600px]]
 
| [[file:customline_Permission-utilisateurs.png|600px]]

Version actuelle datée du 12 août 2024 à 14:16

CustomLine250x250.png Ce Module améliore la saisie des lignes de détails des éléments de Dolibarr.
  • En sélectionnant un seul type de saisie
  • en filtrant la liste des produits selon leur catégorie
  • En définissant les champs saisissable pour les lignes de saisie (quantité, remise, montant HT, ...)
  • En permettant la modification en masse des lignes saisies et leur suppression
  • En important un fichier ou une suite de référence produit/service directement dans l'élément

Présentation

CustomLine permet d'améliorer et simplifier la saisie des lignes des différentes pièces de Dolibarr

Eléments blocage des lignes blocage des champs de lignes modification en masse Importation de fichier Filtrage par catégorie
Proposition commerciale client X X X X X
Commande client X X X X X
Facture client X X X X X
Commande fournisseur X Partiel* Partiel*
Facture fournisseur X
Fiche d'intervention X
Entrepôt X
Bom X

Paramétrage du module

CustomLine Config1.png La configuration du module s'effectue depuis la page d'administration des modules accessible par les menus Accueil > Configuration > Modules en cliquant sur l'icône en bout de ligne.

Page principale de configuration du module

CustomLine-Main-Configuration.png L'administration permet de paramétrer les modes de saisie des lignes d'éléments natif de multiples manières :

CustomLine-Configuration-modeselection.png

  • Le Fonctionnement standard (natif)
  • Seulement la saisie libre des produits et services
  • Seulement la sélection des produit et service prédéfinis
  • Seulement la saisie libre des produits
  • Seulement la saisie libre des services
  • Saisie libre des produits par défaut
  • Saisie libre des services par défaut

Elle permet aussi de placer la création d'une nouvelle ligne en début de liste en activant le switch en bout de ligne

Il est aussi possible d'activer la fonction de filtrage par catégorie de la liste des produits avec le switch associé

Détermination du prix vente selon la marge

Si le module marge natif de dolibarr est activé, il est possible d'activer une fonction de mise à jour du calcul du prix de vente à partir du prix de revient. Le calcul s'effectue à partir de plusieurs valeurs :

  • le prix d'achat ou de revient HT (noté ici PAHT)
  • le taux de remise si il est saisie (noté ici REMISE)
  • le taux de TVA (noté ici TVA)
  • une valeur saisie ou prédéternminée (noté ici PCTMARGE)

On peut paramétrer 3 modes de calcul :

  • Utilisation du taux de Marque :

Prix de vente = (- PAHT / ((PCTMARGE / 100) -1)) / REMISE

  • Utilisation du coefficient de marge

Prix de vente = (PCTMARGE * PAHT) / REMISE * TXTVA

  • Utilisation d'un pourcentage de marge

Prix de vente = PAHT * (1 + PCTMARGE/100) / REMISE

La valeur utilisée pour le calcul est déterminée à partir

  • des valeurs déjà saisie pour chaque ligne et calcul inverse
  • de la valeur contenu dans l'attribut supplémentaire associé au produit sélectionné

Une fois cette valeur modifié, il est possible de conserver ou non le nouveau prix de vente déterminé soit pour tout les clients soit en fonction de chaque client.

Gestion des habilitations d'accès

CustomLine permet de gérer par habilitation l'accès lors de la saisie aux champs des lignes.

CustomLine-habilitation-right.png Pour chaque utilisateur ou groupe, il est possible de définir
  • la présence ou non de l'onglet de saisie en masse
  • les habilitations d'accès au champs de saisie des lignes des éléments à savoir :
    • Le montant HT
    • La quantité
    • Le taux de TVA
    • La remise

CustomLine-habilitation-field.png

Configuration de l'importation

CustomLine Config2.png Paramètres
ImportCsvSeparator (ByDefault) - Dans ce champ, vous devez indiquer le type de séparateur qui sera accepté dans le document CSV.

Élément
Choisir le type d'élément dans lequel les données seront importées (Propositions Commerciales, Orders, Factures, Commandes Fournisseurs).

Paramétrage d'import
Choisissez le paramétrage à définir pour l'importation.

  • Autorise l'importation - (Oui / Non)
  • Mode d'identification des colonnes
    • Basé sur le libellé du champ
    • Basé sur le nom du champ
    • Basé sur l'ordre des champs
  • Ligne où se trouve les nom de colonne - indique la lignes ou se trouve les colonnes (habituellement 1 dans un csv)
  • Séparateur utilisé dans le fichier CSV - Vous pouvez utiliser le séparateur par défaut ou le modifier spécifiquement pour cette importation.
  • Encadrement des chaînes de caractères - Utilisez généralement des guillemets, des guillemets simples, etc.
  • Format des dates importées - Choisir la représentation des dates (JJ/MM/AA, JJ/MM/AAAA, AAAA/MM,JJ, ...)

Paramètre des champs importés
Sélection des champs qui seront importés, sachant que certains champs sont déjà obligatoires.

Gestion du mode d'identification des colonnes

Il est possible de définir 3 méthodes pour définir le contenu des colonnes à importer :

Basé sur le libellé du champ

CustomLine param import libelle.png

Il faut utiliser le nom des colonnes dans le fichier d'import et de définir les champs présents dans celui-ci

Attention, certains champs sont obligatoire.

Basé sur le nom du champ

CustomLine param import champs.png

Il faut saisir dans le paramétrage de l'importation le nom du champs dans le fichier à importer.

Basé sur la position du champ

CustomLine param import position.png

Il faut ici définir la position du champ dans la liste, le nom de la colonne n'est pas utilisé

Fonctionnement

mode prédéfinis des sélections

En fonction de paramètres appliqués (voir section "Configuration des fonctionnalités du module" plus bas), pour chacun des éléments, vous aurez :

Customline Selection-predefinis.png

Sélection des produits/services prédéfinis seulement

Customline Selection-libre.png

Sélection des produits/services libres seulement

Customline Selection-native.png

Sélection des produits/services prédéfinis et libres - fonctionnement natif de Dolibarr

Filtrage par catégories de produits

Customline categorie filter.png

Une fois la fonction activé, une icone en forme de filtre apparait pour sélectionner ou non une ou plusieurs catégories produits.

Customline categorie filter made.png

Une fois la sélection validée, la liste des produits est alors limité aux produits associés, il est possible de sélectionner plusieurs catégories à la fois

Une vidéo est disponible expliquant le fonctionnement du filtrage

Modification en masse des lignes des documents commerciaux

CustomLine ajoute l'onglet Édition en masse aux fiches des documents commerciaux listés dans les paramétrages du module. L'accès à ces onglets se fait par la gestion des habilitations natives de dolibarr (voir plus haut)

Customline Edition-masse.png Une fois vos produits/services ajoutés à un document commercial, cliquez sur l'onglet Édition en masse
Customline Edition-masse-modifie.png CustomLine vous offre alors la possibilité de modifier tous les éléments constitutifs des lignes du document tels que le libellé des produits/services, leur prix, leur quantité et une réduction. Aussi, vous pouvez modifier le taux de TVA pour chacun des produits ou encore les supprimer.
Info-icon.png
  • Les cases à cocher à coté des taux de TVA permettent d'appliquer une TVA à toutes les lignes en un seul clic ! Il en est de même pour la suppression.
  • Pour avoir accès aux fonctionnalités de l'onglet Édition en masse, votre document commercial doit être à un statut permettant sa modification.
  • si vous avez de nombreuses lignes à modifier, vous pouvez arriver à une limite de champs de php, il faudra alors augmenter la variable max_input_vars
Customline Facture-modifie.png Cliquez sur le bouton Valider pour enregistrer vos modifications. La fiche de votre document commercial affichera alors les données modifiée

Importation des lignes des documents commerciaux

L'importation s'effectue en deux étapes : 1 D'abord la récupération du fichier de données sur le serveur 2 Ensuite le lancement de l'importation des données du fichier

Ses deux étapes se réalisent au niveau du meme onglet de l'élément 'Impport en masse'

Customline importation.png

La récupération du fichier s'effectue sur la première partie de l'écran. Il faut sélectionner un fichier puis valider l'importation

Le lancement de l'import s'effectue en appuyant sur l'icone en bout de ligne. Une fois l'importation des lignes réalisées.

Il est possible de supprimer le fichier importé du serveur en appuyant sur l'icone en forme de poubelle.

autres fonctionnalités

Masquage du tableau de marges des fiches des documents

CustomLine ajoute des permissions d'accès aux informations de marges présentes sur les fiches des documents :

Customline Permission-defaut.png

Permissions par défaut

Info-icon.png

le fait de cacher le tableau des marges, enlève aussi l'accès au champ permettant de saisir (et visualiser) le prix de revient du produit...

Customline Permission-utilisateurs.png

Les permissions par défaut s'appliquent à tout utilisateur créé ultérieurement à l'installation du module s'il n'est pas ajouté à un groupe dont les permission sont déjà définies.

Customline Permission-accordee.png

Si la permission est activée, les fiches des documents n'afficheront pas les données de marges. Seules les informations de total et de règlement du document seront accessibles.

Customline Permission-refusee.png

Si la permission est désactivée, les fiches des documents afficheront les données de marge