CustomLine

This Module improves the entry of detail lines of Dolibarr elements. By selecting a single type of entry By filtering the list of products according to their category By defining the enterable fields for the entry lines (quantity, discount, amount excluding tax, ...) By allowing the mass modification of the entered lines and their deletion By importing a file or a product/service reference series directly into the element

Presentation

CustomLine allows you to improve and simplify the entry of lines for the different parts of Dolibarr

Elements	row blocking	row field blocking	mass editing	File import	Category filtering
Customer sales proposal	X	X	X	X	X
Customer order	X	X	X	X	X
Customer invoice	X	X	X	X	X
Supplier order	X		Partial*	Partial*
Supplier invoice	X
Intervention sheet			X
Warehouse				X
Bom			X

Module configuration

The module configuration is done from the modules administration page accessible via the Home > Configuration > Modules menus by clicking on the icon at the end of the line.

Main module configuration page

The administration allows you to configure the input modes of the native element lines in multiple ways: Standard operation (native) Only free input of products and services Only selection of predefined products and services Only free input of products Only free input of services Free input of products by default Free input of services by default It also allows you to place the creation of a new line at the beginning of the list by activating the switch at the end of the line It is also possible to activate the filtering function by category of the product list with the associated switch

Determining the sale price according to the margin

If the native margin module of dolibarr is activated, it is possible to activate a function to update the calculation of the sale price from the cost price. The calculation is carried out from several values:

• the purchase price or cost price excluding tax (noted here PAHT)
• the discount rate if it is entered (noted here DISCOUNT)
• the VAT rate (noted here VAT)
• an entered or predetermined value (noted here PCTMARGE)

We can configure 3 calculation modes:

• Use of the Mark rate:

Sale price = (- PAHT / ((PCTMARGE / 100) -1)) / DISCOUNT

• Use of margin coefficient

Sale price = (PCTMARGE * PAHT) / DISCOUNT * TXVAT

• Using a margin percentage

Selling price = PAHT * (1 + PCTMARGE/100) / DISCOUNT

The value used for the calculation is determined from

• the values ​​already entered for each line and inverse calculation
• the value contained in the additional attribute associated with the selected product

Once this value has been modified, it is possible to keep or not the new sales price determined either for all customers or according to each customer.

Management of access authorizations

CustomLine allows you to manage access authorizations when entering line fields.

For each user or group, it is possible to define the presence or absence of the mass entry tab the access authorizations to the entry fields of the lines of the elements, namely: The amount excluding tax The quantity The VAT rate The discount

Configuration de l'importation

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 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 Il faut saisir dans le paramétrage de l'importation le nom du champs dans le fichier à importer.

Basé sur la position du champ 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 :

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

Filtrage par catégories de produits

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

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)

Une fois vos produits/services ajoutés à un document commercial, cliquez sur l'onglet Édition en masse

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.

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

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'

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 :

	Permissions par défaut 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...
	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.
	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.
	Si la permission est désactivée, les fiches des documents afficheront les données de marge