Ventes par catégorie — module Dolibarr

Module externe minimal pour Dolibarr 23.x et TakePOS. Il affiche le chiffre d'affaires HT et les quantités vendues par catégorie sur une période configurable.

Installation

1. Décompresser ventescategories dans le répertoire htdocs/custom/ de Dolibarr.
2. Vérifier que le serveur web peut lire les fichiers.
3. Dans Accueil > Configuration > Modules/Applications, activer VentesCategories.
4. Donner le droit de lecture « Consulter les statistiques de ventes par catégorie » aux utilisateurs concernés.
5. Ouvrir le menu TakePOS > Ventes par catégorie.

Périmètre

• Sources : factures dont module_source = 'takepos'.
• Statuts retenus : factures validées ou payées (fk_statut IN (1, 2)).
• Les brouillons et factures abandonnées sont exclus.
• Les avoirs validés sont soustraits.
• Période basée sur la date de facture (datef).
• Montants HT basés sur facturedet.total_ht.

Attention aux catégories multiples

Si un produit est associé à plusieurs catégories, sa vente est incluse dans chaque catégorie. Le total des lignes par catégorie peut donc être supérieur au chiffre d'affaires global. Pour une analyse où chaque vente ne doit être attribuée qu'une seule fois, il faut définir une règle de catégorie principale.

Vérifications avant production

Tester sur une copie de la base :

• comparer quelques tickets TakePOS avec leurs factures Dolibarr ;
• vérifier le comportement des avoirs utilisés dans votre instance ;
• vérifier les droits utilisateurs et l'accès au menu ;
• vérifier le calcul des dates sur le fuseau horaire de l'instance.

Le module n'ajoute aucune table et ne modifie ni le cœur Dolibarr ni TakePOS.