Actualiser les prix

Sur un devis en brouillon, le module ajoute un bouton « Actualiser les prix ». Sur une facture modèle, le même bouton. Il montre d’abord, pour chaque ligne rattachée à un produit : le prix actuel, le prix à jour, la TVA, la remise et l’écart en euros. L’écart tient compte de la remise, si bien que la somme des écarts correspond exactement à la variation du total — le pied du tableau affiche d’ailleurs le total HT tel qu’il serait après application. Vous décochez les lignes à laisser tranquilles, puis vous appliquez. Le document existant est modifié : sa référence, son historique et ses liens ne bougent pas.

Pour toutes les factures modèles d’un coup, le menu Facturation › Liste des modèles › Actualiser les prix des modèles ouvre un écran qui liste chaque modèle dont au moins une ligne n’est plus au prix du catalogue : le client, la date de la prochaine facture, le nombre de lignes concernées, le total actuel, le total à jour et l’écart. Vous filtrez par client ou par produit, vous incluez si besoin les modèles suspendus, vous décochez ceux à exclure, et vous actualisez tout en une fois. Seules les prochaines factures générées portent les nouveaux prix : les factures déjà émises ne sont jamais touchées.

Le prix retenu

Le module reprend exactement l’ordre de priorité du cœur de Dolibarr lors d’un clonage de devis avec l’option « Mise à jour des prix avec les prix connus actuels » :

1. le prix de base du produit ;
2. si les multiprix sont activés et que le tiers a un niveau de prix, le prix de ce niveau ;
3. si les prix par client sont activés, le prix spécifique au client — à partir de Dolibarr 22, celui dont la période de validité couvre la date du jour.

Le jeu de tests du module compare son résultat à celui d’un clonage réel du cœur, sur la même donnée, et vérifie que les deux chiffres sont identiques.

Les remises

Par défaut, les remises saisies sur les lignes sont conservées. C’est un choix plus prudent que celui du clonage de Dolibarr, qui les remplace par la remise par défaut du tiers : une remise négociée serait perdue. Le comportement du clonage reste disponible dans la configuration du module, si vous le préférez.

Le bouton apparaît avec les autres actions, sur la fiche d’un devis en brouillon ou d’une facture modèle, si vous avez le droit du module et le droit de modifier ce type de document, et si le document contient au moins une ligne rattachée à un produit. Sinon, aucun bouton inutile n’est ajouté.

L’écran d’un document est un tableau à huit colonnes : sélection, produit, quantité, prix actuel, prix à jour, TVA, remise, écart. Les lignes non modifiables y figurent aussi, avec la raison en clair entre parenthèses : « ligne libre, non modifiée », « produit introuvable », « déjà à jour ».

L’écran des factures modèles affiche une ligne par modèle, avec un lien Détail vers l’écran ligne par ligne, pour n’actualiser qu’une partie d’un modèle. Dans les deux écrans, le total du bas suit les cases cochées : ce qui est annoncé est exactement ce qui sera écrit.

• Un droit dédié, « Utiliser l’actualisation des prix (devis et factures modèles) ».
• Le droit standard de Dolibarr en plus : modifier les propositions commerciales pour les devis, créer et modifier les factures pour les factures modèles.
• Le contrôle d’accès habituel de Dolibarr, ce qui couvre le multi-société.
• Utilisateurs externes : un compte rattaché à un tiers ne peut agir que sur les documents de son propre tiers, à l’aperçu comme à l’écriture, y compris dans l’écran des factures modèles.
• Commerciaux limités à leurs clients : sans le droit Dolibarr de voir tous les tiers, l’écran des factures modèles ne liste, n’ouvre et n’actualise que les modèles des tiers dont l’utilisateur est commercial attitré, comme dans les listes de Dolibarr, y compris en masse.
• Aucun prix venu du formulaire n’est utilisé. À l’application, chaque ligne est recalculée côté serveur ; seuls les identifiants sont lus, et tout identifiant étranger au document est ignoré.
• Écriture transactionnelle : pour un document, à la première erreur, rien n’est enregistré. En masse, chaque modèle a sa propre transaction, et un échec est signalé sans défaire les autres.
• Jeton anti-CSRF sur les formulaires, et refus d’agir sur un devis qui n’est plus en brouillon.

• Aucune table n’est créée, aucun attribut supplémentaire non plus.
• Le module enregistre deux réglages dans les constantes de Dolibarr.
• Les seules données modifiées sont les lignes des devis et des factures modèles que vous avez sélectionnées, puis leurs totaux, recalculés par Dolibarr. Les factures déjà émises ne sont jamais touchées.
• Chaque opération est écrite dans les journaux de Dolibarr.
• Aucune connexion sortante : rien n’est envoyé nulle part.