• +33 6 25 73 43 68
  • contact@ns-info.fr
Facebook-f Linkedin

Outils pour Dolibarr

ChangeLog
Installation
Activation et Paramètres
Dolistore

Outils pour Dolibarr

Documentation du module
Sommaire
  1. Présentation
  2. Prérequis et installation
    1. Prérequis
    2. Installation
    3. Mise à jour / réactivation
  3. Configuration
    1. Onglet Réglages
    2. Onglets Clients et Fournisseurs
  4. Droits d'accès
  5. Masquer les descriptions des lignes
  6. Modifier les lignes en une fois
    1. Champs modifiables
    2. Enregistrer les lignes
    3. Contrôles
  7. Supprimer plusieurs lignes
  8. Particularités par document
  9. Impression PDF
  10. Limites connues et FAQ

1. Présentation

NsDTools facilite le travail sur les lignes des documents de Dolibarr, en particulier sur les documents longs :

  • Masquer les descriptions des lignes d'un document, pour ce document seulement : la liste des lignes devient compacte, les descriptions restent visibles dans l'info-bulle du produit.
  • Modifier les lignes en une fois : quand les descriptions sont masquées sur un document brouillon, les colonnes choisies (libellé, TVA, prix, quantité, unité, remise, prix d'achat) deviennent des champs de saisie, enregistrés ensemble par un seul bouton.
  • Supprimer plusieurs lignes à la fois, avec une case à cocher devant chaque ligne.
  • Le module ne modifie pas le Core de Dolibarr.

Documents pris en charge

ClientsFournisseurs
Propositions commercialesDemandes de prix
CommandesCommandes
FacturesFactures

2. Prérequis et installation

2.1 Prérequis

ÉlémentVersion
Dolibarr19.0.0 ou supérieur (testé sur 22.0)
PHP7.1 ou supérieur (testé en 7.4)
Framework NSINFO (module « NS INFO »)23.4.0 ou supérieur, installé et activé
Module MargesFacultatif : nécessaire pour modifier le prix d'achat des lignes
Le framework NSINFO est obligatoire. Si le module « NS INFO » n'est pas installé et activé, l'activation de NsDTools est refusée avec le message :
« Le framework NSINFO est obligatoire : le module « NS INFO » (nsinfo) doit être installé et activé avant d'activer le module « Outils pour Dolibarr ». »

2.2 Installation

  1. Installer et activer le module NS INFO (version 23.4.0 ou supérieure).
  2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l'archive module_nsdtools-X.Y.Z.zip.
  3. Dans la liste des modules, famille NS INFO, activer « Outils pour Dolibarr ».
  4. Régler le module (roue crantée) : voir Configuration.

À la première activation, le module active pour les propositions commerciales le bouton « Masquer les descriptions des lignes » et la modification des quantités. Les autres documents et options sont désactivés : activez-les selon vos besoins.

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactiver puis réactiver le module : cette opération enregistre les nouveaux documents pris en charge. Les réglages sont conservés.

3. Configuration

Page de réglages : Configuration > Modules, roue crantée du module. Réservée aux administrateurs. Onglets : Réglages, Clients, Fournisseurs, ChangeLog et À propos (ces deux derniers fournis par le framework NSINFO).

3.1 Onglet Réglages

Options communes à tous les documents.

Boutons des fiches (communs à tous les objets)

OptionDescriptionDéfaut
Libellé du bouton « Masquer les descriptions des lignes »Texte du bouton.« Masquer les descriptions des lignes »
Couleur du bouton « Masquer les descriptions des lignes »Couleur de fond du bouton.Couleur des boutons du thème
Libellé du bouton « Affichage normal »Texte du bouton qui fait réapparaître les descriptions.« Affichage normal »
Couleur du bouton « Affichage normal »Couleur de fond du bouton.Couleur des boutons du thème
Libellé du bouton « Enregistrer les lignes »Texte du bouton qui enregistre les lignes modifiées.« Enregistrer les lignes »
Couleur du bouton « Enregistrer les lignes »Couleur de fond du bouton.Couleur des boutons du thème
  • Un libellé vide affiche le libellé standard, traduit dans la langue de chaque utilisateur. Le bouton Valeur par défaut remet ce libellé standard.
  • Le texte du bouton s'affiche en noir ou en blanc selon la couleur choisie, pour rester lisible. Valeur par défaut remet la couleur du thème.
  • Les boutons ont une icône : œil barré pour masquer, œil ouvert pour l'affichage normal, disquette pour enregistrer.

Options générales (tous les objets)

OptionDescriptionDéfaut
Suppression groupée des lignesAjoute une case à cocher devant chaque ligne des documents brouillons et une corbeille pour supprimer les lignes cochées (voir section 7).Désactivée

3.2 Onglets Clients et Fournisseurs

L'onglet Clients contient un sous-onglet par document client (Propositions commerciales, Commandes, Factures), l'onglet Fournisseurs un sous-onglet par document fournisseur (Demandes de prix, Commandes, Factures). Un sous-onglet n'apparaît que si le module Dolibarr du document est activé.

Premier bloc : bouton Masquer les descriptions des lignes

OptionDescription
Activer le bouton « Masquer les descriptions des lignes »Affiche le bouton sur la fiche de ce type de document (voir section 5).

Second bloc : champs des lignes modifiables quand les descriptions sont masquées (brouillon)

OptionDescription
Libellé de la ligneChamp sous le produit, dans la colonne Description. Non proposé pour les commandes et factures fournisseurs.
Taux de TVAListe des taux de TVA (de vente ou d'achat selon le document).
Prix unitaire HTPrix unitaire hors taxes.
Prix unitaire TTCPrix unitaire toutes taxes comprises, si la colonne est affichée sur le document.
QuantitéQuantité de la ligne.
UnitéUniquement si les unités sont utilisées sur les produits (réglages des produits).
Remise (%)Remise de la ligne, entre 0 et 100.
Prix d'achatDocuments clients seulement, avec le module Marges et pour les utilisateurs autorisés à modifier les marges.
« Enregistrer les lignes » repasse en « Affichage normal »Après un enregistrement réussi, le document revient à l'affichage normal. Sinon, il reste en saisie.

4. Droits d'accès

Le module n'ajoute pas de permission. Il utilise le droit Dolibarr de créer/modifier le document concerné (par exemple « Créer/modifier les propositions commerciales ») pour :

  • masquer les descriptions des lignes et revenir à l'affichage normal ;
  • modifier et enregistrer les lignes ;
  • supprimer plusieurs lignes à la fois.

Sans ce droit, les boutons sont affichés grisés, et les champs de saisie et les cases à cocher des lignes ne sont pas proposés. La modification du prix d'achat demande en plus le droit de modifier les marges.

5. Masquer les descriptions des lignes

Sur la fiche d'un document au statut brouillon (ou repassé en brouillon avec le bouton Modifier), le bouton Masquer les descriptions des lignes masque les descriptions des lignes de produits et de services, pour ce document seulement.

  • Les descriptions restent consultables dans l'info-bulle du produit, comme lorsque l'option « Afficher les descriptions de produits dans les lignes d'articles » des réglages des produits est désactivée.
  • Le bouton n'apparaît que si cette option des produits est activée : sinon, les descriptions sont déjà masquées dans tous les documents.
  • Le choix est enregistré sur le document : il est conservé d'une visite à l'autre et ne concerne pas les autres documents.

Tant que les descriptions sont masquées :

  • le formulaire d'ajout de lignes n'est pas affiché ;
  • les boutons Valider, Cloner et Supprimer du document sont désactivés (une info-bulle indique de repasser en affichage normal) ;
  • les champs des lignes peuvent être modifiés en une fois (voir section 6).

Le bouton Affichage normal fait réapparaître les descriptions et rétablit le fonctionnement habituel de la fiche. Il reste disponible tant que les descriptions sont masquées, quel que soit le statut du document.

6. Modifier les lignes en une fois

6.1 Champs modifiables

Quand les descriptions sont masquées sur un document brouillon, les colonnes activées dans l'onglet du document (3.2) deviennent des champs de saisie, directement dans la liste des lignes.

  • Lignes concernées : les lignes de produits et de services.
  • Lignes non concernées : remises, lignes en option, titres et sous-totaux, et autres lignes spéciales.
  • Le libellé est proposé avec le libellé personnalisé de la ligne ou, à défaut, celui du produit. Le vider revient au libellé du produit. La description de la ligne n'est pas modifiée.

6.2 Enregistrer les lignes

  1. Modifier les champs voulus, sur autant de lignes que nécessaire.
  2. Cliquer sur Enregistrer les lignes, ou appuyer sur la touche Entrée dans un champ.
  3. Le message « Lignes enregistrées (N ligne(s) modifiée(s)) » s'affiche : les totaux du document sont recalculés et le PDF est régénéré, comme lors de la modification d'une ligne dans Dolibarr (voir section 9).
  • Seules les lignes modifiées sont enregistrées ; les autres valeurs des lignes sont conservées.
  • Si le prix HT et le prix TTC d'une même ligne sont modifiés, le prix HT est pris en compte.
  • Un prix d'achat saisi n'est plus lié à un prix fournisseur.
  • Selon l'option du document, le document revient ensuite à l'affichage normal.

6.3 Contrôles

L'enregistrement est tout ou rien : si une valeur est refusée, aucune ligne n'est modifiée et le message indique les lignes en erreur (« Ligne n° X : valeur invalide pour … »).

ContrôleRègle
Valeurs numériquesPrix, quantités, remises et prix d'achat doivent être des nombres.
RemiseEntre 0 et 100 %.
Prix minimumDocuments clients : le prix remisé ne peut pas être inférieur au prix minimum de vente du produit, comme sur la fiche du document.
Quantité 0Propositions et demandes de prix : la ligne passe en option, comme dans Dolibarr. Commandes fournisseurs : refusée.

7. Supprimer plusieurs lignes

Avec l'option Suppression groupée des lignes (onglet Réglages), la fiche d'un document brouillon affiche, que les descriptions soient masquées ou non :

  • en première colonne, une case à cocher et le numéro de chaque ligne ;
  • dans l'en-tête de cette colonne, une case pour tout cocher ou décocher et une corbeille, affichée dès qu'une ligne est cochée.
  1. Cocher les lignes à supprimer (ou toutes les lignes avec la case de l'en-tête).
  2. Cliquer sur la corbeille et confirmer : « Supprimer les N ligne(s) cochée(s) ? Le document sera recalculé. »
  3. Les lignes sont supprimées, le document est recalculé et le PDF régénéré (voir section 9). En cas d'erreur, aucune ligne n'est supprimée.

8. Particularités par document

DocumentParticularité
Propositions, commandes et factures clientsTous les champs sont disponibles, y compris le prix d'achat (module Marges) ; contrôle du prix minimum de vente. Sauf factures de situation (voir ci-dessous).
Demandes de prixListe des TVA d'achat ; pas de prix d'achat ni de contrôle du prix minimum. Le code de TVA n'est pas conservé par Dolibarr sur ces lignes, seul le taux l'est.
Commandes et factures fournisseursListe des TVA d'achat ; pas de prix d'achat, de contrôle du prix minimum ni de libellé de ligne. Commandes fournisseurs : quantité 0 refusée.
Factures de situationLa modification groupée des lignes n'est pas proposée.

9. Impression PDF

  • Le masquage des descriptions ne concerne que l'affichage à l'écran : les documents PDF ne sont pas modifiés et impriment les descriptions comme d'habitude.
  • Après un enregistrement ou une suppression de lignes, le PDF du document est régénéré automatiquement, sauf si la mise à jour automatique des PDF est désactivée dans Dolibarr.

10. Limites connues et FAQ

Le bouton « Masquer les descriptions des lignes » n'apparaît pas.

  • Le document doit être en brouillon et contenir au moins une ligne.
  • Le bouton doit être activé dans l'onglet du document (3.2).
  • L'option « Afficher les descriptions de produits dans les lignes d'articles » des réglages des produits doit être activée.
  • Après une mise à jour du module, il faut le désactiver puis le réactiver.

Les champs de saisie n'apparaissent pas.

  • Les descriptions doivent être masquées et le document doit être en brouillon.
  • Au moins un champ doit être activé dans l'onglet du document.
  • L'utilisateur doit avoir le droit de créer/modifier ce document.

Je ne peux pas valider, cloner ou supprimer le document.

Les descriptions sont masquées : cliquer sur Affichage normal, puis utiliser les boutons habituels.

Je ne peux plus ajouter de lignes.

Le formulaire d'ajout est masqué avec les descriptions : cliquer sur Affichage normal.

La nouvelle mise en forme de la colonne des cases à cocher n'apparaît pas.

Le navigateur garde la feuille de style en mémoire quelques heures : recharger la page avec Ctrl + F5.

Autres limites

  • Si le module « NS INFO » est désactivé après coup, la page de réglages de NsDTools n'est plus utilisable.
  • Le module « Outils pour Dolibarr » ne gère pas les modèles de factures ni les expéditions.