Devis et tarifs

Marge par jour

margeparjour · version 1.0.0

Vous voyez ce que rapporte une journée de travail avant d'accepter le devis.

Prix: 19 € HT
Dolibarr: 19.0 minimum
Version: 1.0.0
Licence: GPL v3+
Langues: Français, anglais

En validation sur le DoliStore

Il n’est pas achetable aujourd’hui. La vente, l’encaissement, la facture et le téléchargement se feront sur le DoliStore, jamais sur ce site. Pour être prévenu de sa mise en vente, écrivez à contact@dolix.fr.

Support et contact

Fiche d'un devis en brouillon sous Dolibarr 24.0.0 : la ligne « Marge par jour » affiche 45,00 €, avec le détail « marge totale 90,00 € / 2 j », juste au-dessus du champ « Journées prévues ». — Fiche d'un devis en brouillon sous Dolibarr 24.0.0 : la ligne « Marge par jour » affiche 45,00 €, avec le détail « marge totale 90,00 € / 2 j », juste au-dessus du champ « Journées prévues ».

Ce que fait le module

Ajoute un champ « Journées prévues » sur le devis, décimales acceptées.
Affiche « Marge par jour » sur la fiche du devis, avec le détail : marge totale et nombre de journées.
Ajoute une colonne « Marge / jour » triable dans la liste des devis, ainsi que la colonne « Journées prévues ».
Reprend le calcul officiel de Dolibarr (FormMargin::getMarginInfosArray) : mêmes chiffres que le bloc « Marges » de la fiche.
Tant que les journées ne sont pas renseignées, la fiche affiche « Renseignez Journées prévues pour obtenir la marge par jour » au lieu d'un chiffre faux.
Ne crée aucune table dans votre base.

À qui ça sert

Vous acceptez une affaire sans savoir si elle rapporte plus ou moins qu'une autre à durée égale.

Deux devis, deux montants proches. Le premier tient en une journée, le second en trois. Dolibarr vous donne la marge totale de chaque devis, mais pas la marge rapportée à la durée. Vous décidez donc sans le chiffre qui compte : ce que la journée rapporte réellement.

À qui ça sert : Toute entreprise qui vend du temps en même temps que des fournitures et qui veut comparer deux devis à durée égale : artisans, bureaux d'études, prestataires de services.

Ce que le module ne fait pas

Ce bloc figure sur les six fiches, sans exception.

Ne traite que les propositions commerciales. Ni les commandes, ni les factures, ni les projets.
La marge dépend des prix d'achat saisis sur les lignes du devis. Sans prix d'achat, la marge affichée est le montant vendu.
Le nombre de journées est saisi à la main. Le module ne le déduit ni des tâches, ni du temps consommé, ni des quantités.
Aucun droit dédié : quiconque peut ouvrir un devis voit la marge par jour.
N'ajoute pas la marge par jour aux documents PDF.

Comment ça marche

Le module ajoute un champ « Journées prévues » sur la fiche du devis. Il divise la marge totale des lignes par ce nombre et affiche le résultat à deux endroits : sur la fiche du devis, et dans une colonne triable de la liste des devis.

Le calcul de marge n’est pas réinventé : le module appelle la fonction du cœur de Dolibarr qui alimente le bloc « Marges » de la fiche. Les chiffres affichés sont donc les mêmes que ceux que vous lisez déjà, main-d’œuvre comprise dès lors que le module Services est activé et que les prix d’achat sont renseignés sur les lignes.

Tant que « Journées prévues » est vide, la fiche affiche « Renseignez Journées prévues pour obtenir la marge par jour » plutôt qu’un chiffre qui ne voudrait rien dire.

La colonne « Marge / jour » se trie comme les autres. Deux affaires de montants presque identiques ne rapportent pas la même chose : 2 850 € sur 3 jours valent 665 €/jour, 2 880 € sur 8 jours n'en valent que 108. — La colonne « Marge / jour » se trie comme les autres. Deux affaires de montants presque identiques ne rapportent pas la même chose : 2 850 € sur 3 jours valent 665 €/jour, 2 880 € sur 8 jours n'en valent que 108.

Tant que les journées ne sont pas saisies, le module ne calcule rien et le dit. Il ne fabrique pas de chiffre.

Ce qui est livré

Ce que le module écrit dans votre installation
Tables créées en base	Aucune table. Le dossier du module ne contient pas de répertoire sql/. À l'activation, le module crée un attribut supplémentaire « Journées prévues » (code mpj_journees) sur les propositions commerciales : la valeur est stockée dans la table d'attributs supplémentaires des devis, déjà présente dans Dolibarr.
Permissions	Le descripteur déclare rights = array() : le module n'ajoute aucune permission. La ligne « Marge par jour » est visible par toute personne qui peut ouvrir le devis.
Désinstallation	Désactiver le module dans ConfigurationModules/Applications. La ligne et la colonne disparaissent. L'attribut « Journées prévues » et les valeurs déjà saisies restent en base : rien n'est effacé. Pour tout retirer : ConfigurationModulesPropositions commercialesAttributs supplémentairessupprimer mpj_journees. Cette suppression efface les valeurs saisies.

Le dossier margeparjour complet, en clair : rien n’est chiffré, rien n’est obfusqué.
Les traductions française et anglaise.
Un fichier README.md et un ChangeLog.md.

Aucune table n’est créée. Le dossier du module ne contient pas de répertoire sql/.
Le module ajoute un attribut supplémentaire sur les devis, mpj_journees. Sa valeur est rangée dans la table d’attributs supplémentaires que Dolibarr gère déjà.
Le module ne modifie aucune donnée existante. Il lit les lignes du devis et affiche un calcul.
Aucune connexion sortante : rien n’est envoyé nulle part.

Compatibilité

Le descripteur du module ne déclare qu’une version minimale. Aucune borne haute n’est inscrite dans le code : les versions ci-dessous sont celles sur lesquelles le module a réellement été exécuté.

Compatibilité du module Marge par jour
Versions de Dolibarr	Dolibarr 19.0 minimum. Exécuté sur 19.0.4, 23.0.4 et 24.0.0.
PHP minimum	7.4
Modules Dolibarr à activer	Propositions commerciales
Licence	GPL v3 ou ultérieure, code source complet
Langues	Français, anglais
Menu	Aucune entrée de menu. Le module s'affiche dans la fiche et dans la liste des devis.

Installation

Récupérer le module sur le DoliStore et télécharger le fichier zip.
Dans Dolibarr : AccueilConfigurationModules/Applicationsonglet « Déployer/installer un module externe », puis envoyer le zip. Sinon, décompresser le dossier margeparjour dans htdocs/custom/.
Dans la liste des modules, activer « Marge par jour ». L'attribut supplémentaire « Journées prévues » est créé à ce moment-là.
Ouvrir un devis, renseigner « Journées prévues » : la marge par jour s'affiche.

Le détail — droits du dossier custom, hébergement mutualisé, mise à jour, désinstallation — est sur la page Installation et mise à jour.

Questions fréquentes

Sur quelles versions de Dolibarr ce module fonctionne-t-il ?

Le descripteur exige Dolibarr 19.0 au minimum et PHP 7.4 au minimum. Le module a été exécuté sur 19.0.4, 23.0.4 et 24.0.0. Il utilise une seule fonction du cœur, FormMargin::getMarginInfosArray, présente sur toute cette plage. Si vous êtes sur une version intermédiaire et que vous avez un doute, écrivez avant d'acheter.

Est-ce que ça touche ma base de données ?

Le module ne crée aucune table. Il ajoute un attribut supplémentaire « Journées prévues » sur les devis, c'est-à-dire une colonne dans la table d'attributs supplémentaires que Dolibarr gère déjà. Il ne modifie aucune donnée existante : il lit les lignes du devis et affiche un calcul.

Et si je désinstalle ?

Désactiver le module fait disparaître la ligne et la colonne. L'attribut « Journées prévues » et les valeurs saisies restent : vous les retrouvez si vous réactivez. Pour les supprimer, il faut retirer l'attribut mpj_journees à la main dans la configuration du module Propositions commerciales.

Le chiffre affiché est-il le même que celui du bloc « Marges » ?

Oui, c'est le même calcul : le module appelle la fonction du cœur qui alimente ce bloc. Une conséquence à connaître : si le module Services n'est pas activé, le bloc « Marges » n'affiche pas la ligne des services, donc pas votre main-d'œuvre. Activez-le pour voir la marge complète.

Qui répond au support ?

La personne qui a écrit le module. Écrivez à support@dolix.fr avec votre version de Dolibarr, la version du module et ce que vous observez.

Comment se passent le paiement et les mises à jour ?

La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore. Les nouvelles versions y sont publiées, et le journal des versions de cette page est mis à jour à chaque publication.