Mise à jour des factures modèles

1. Présentation

Mise à jour des factures modèle permet de remettre à jour d’un seul geste les prix d’achat et les prix de vente des lignes de vos factures modèle clients (factures récurrentes), à partir des prix actuels de vos produits. Il ajoute aussi, sur les factures créées depuis un modèle, un picto qui reporte dans la Réf. client la valeur d’un attribut supplémentaire du modèle.

• Une liste des modèles dans le menu Facturation, avec filtres, tri, colonnes au choix et actions de masse.
• Mise à jour des prix d’achat (prix de revient, prix d’achat moyen pondéré ou meilleur prix d’achat) et des prix de vente des modèles cochés.
• Un bouton sur la fiche produit pour mettre à jour tous les modèles qui contiennent ce produit.
• Un picto « Réf. client » sur les factures issues d’un modèle.
• Le module ne modifie pas le Core de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

Élément	Version
Dolibarr	20.0.0 à 24 (la compatibilité est à confirmer sur les versions autres que celle de l’instance de développement)
PHP	7.4 à 8.3
Framework NSINFO (module « NSINFO »)	23.8.3 ou supérieur, installé et activé

Le framework NSINFO est obligatoire. S’il n’est pas installé et activé, l’activation du module est refusée avec un message d’explication.

2.2 Installation

1. Installez le module (voir Installer un module).
2. Activez le module « NSINFO » (framework NSINFO, gratuit) s’il ne l’est pas déjà.
3. Activez le module « Mise à jour des factures modèle » dans Accueil > Configuration > Modules (voir activation et paramètres).

2.3 Mise à jour / réactivation

Après une mise à jour du module, désactivez puis réactivez-le : le menu et les emplacements où le module ajoute ses boutons sont enregistrés à l’activation.

3. Configuration

Accueil > Configuration > Modules, puis la roue des réglages du module. Réservé aux administrateurs. Chaque réglage est enregistré dès que vous le modifiez, sans cliquer sur un bouton.

3.1 Prix d’achat à utiliser

Le réglage « Sélection du prix d’achat à mettre à jour » indique d’où vient le prix d’achat reporté dans les modèles :

Choix	Prix d’achat repris
Prix de revient	Le prix de revient de la fiche produit.
Prix d’achat moyen pondéré	Le prix d’achat moyen pondéré enregistré sur la fiche produit (il n’est pas recalculé).
Meilleurs prix d’achat	Le tarif fournisseur le plus bas enregistré pour le produit ; le fournisseur de la ligne est alors remplacé par ce fournisseur.

Si le prix choisi est vide ou nul pour un produit, ou si aucun choix n’est fait, le prix d’achat de la ligne est conservé.

3.2 Prix de vente supérieur au prix produit

Par défaut, la mise à jour des prix de vente ne baisse jamais un prix : si le prix de vente du produit est inférieur à celui déjà présent dans le modèle, le prix du modèle est conservé. Activez l’option « Mettre à jour les prix de vente du modèle même si son prix de vente est supérieur au prix de vente produit (fiche produit) » pour que le prix du produit s’applique dans tous les cas.

3.3 Attribut reporté dans la Réf. client

Le réglage « Attribut supplémentaire de la facture modèle à reporter dans la Réf. client » propose la liste des attributs supplémentaires des factures modèle (libellés traduits). Laissez-le vide pour ne pas utiliser la fonction (le picto n’apparaît alors jamais).

4. Droits d’accès

Fonction	Droit nécessaire
Voir le menu et la liste des modèles	Lire les factures
Supprimer des modèles en masse (liste)	Supprimer les factures
Bouton de mise à jour sur la fiche produit	Créer/modifier des produits et créer/modifier les factures
Picto « Réf. client » d’une facture	Créer/modifier les factures
Réglages du module	Administrateur

Le module ne déclare aucun droit propre.

5. Utilisation

5.1 La liste des modèles

Menu Facturation / Paiements > Factures clients > Liste des modèles +.

• Colonnes (à afficher ou masquer) : référence, tiers, montants HT / TVA / TTC avec totaux, conditions et mode de règlement, récurrence, fréquence, nombre de générations faites et maximum, dernière et prochaine génération (« En retard » si la date est dépassée), auteur, dates, statut, et le lien « Créer la facture » quand la date est atteinte.
• Filtres sur toutes ces colonnes ; tri en cliquant sur les titres (référence décroissante par défaut).
• Actions de masse sur les modèles cochés : « MAJ des prix de vente », « MAJ des prix d’achat » et « Supprimer ».

5.2 Mise à jour en masse des prix

1. Cochez les modèles à mettre à jour.
2. Choisissez l’action « MAJ des prix de vente » ou « MAJ des prix d’achat », puis validez.
3. Confirmez : la fenêtre rappelle le nombre de modèles sélectionnés.

Action	Effet sur chaque ligne des modèles cochés
MAJ des prix de vente	Le prix de vente HT devient le prix de vente actuel du produit (voir 3.2). Le prix d’achat n’est pas modifié.
MAJ des prix d’achat	Le prix d’achat devient celui du réglage choisi (voir 3.1). Le prix de vente n’est pas modifié.

5.3 Mise à jour depuis la fiche produit

Sur la fiche d’un produit, le bouton « Mise à jour des prix dans les factures modèles » ouvre une confirmation avec les cases « Mettre le prix de vente » (décochée par défaut, absente si l’option de la section 3.2 est activée) et « Mettre le prix d’achat ». Après confirmation, toutes les lignes de tous les modèles qui contiennent ce produit sont mises à jour, et un message indique le nombre de mises à jour.

5.4 Réf. client d’une facture issue d’un modèle

Sur une facture client créée depuis une facture modèle, quand la Réf. client est vide et que l’attribut choisi en 3.3 est renseigné sur le modèle, un petit picto (flèche vers le bas) apparaît à côté du crayon de la Réf. client. Son infobulle indique la valeur qui sera reportée.

1. Cliquez sur le picto.
2. La valeur de l’attribut du modèle est enregistrée comme Réf. client de la facture, et un message le confirme.

Pour un attribut de type liste, c’est le libellé affiché qui est repris.

6. Limites connues et FAQ

Le picto de la Réf. client n’apparaît pas.

• La facture doit avoir été créée depuis une facture modèle, sa Réf. client doit être vide.
• Un attribut doit être choisi dans les réglages et renseigné sur la facture modèle.
• Vous devez avoir le droit de créer/modifier les factures, et le crayon de modification de la Réf. client doit être visible.
• Après une mise à jour du module, il faut le désactiver puis le réactiver.

Le prix de vente d’un modèle n’a pas changé.

Si le prix du produit est inférieur à celui du modèle, le prix du modèle est conservé tant que l’option de la section 3.2 n’est pas activée.

Le prix d’achat d’une ligne n’a pas changé.

Le prix choisi (prix de revient, prix moyen pondéré, meilleur prix d’achat) est vide ou nul pour ce produit, ou aucun choix n’est fait dans les réglages.

Autres limites

• Les mises à jour de prix ne sont pas annulables : aucune sauvegarde des anciens prix n’est conservée par le module.
• Le nombre affiché après une mise à jour depuis la fiche produit compte des lignes modifiées.
• La correspondance entre une ligne de modèle et un produit se fait par la référence du produit.
• Si le module « NSINFO » est désactivé après coup, la page de réglages n’est plus utilisable.

Une question ? Assistance NSINFO au 03 70 999 730 ou sur la page Assistance.