Utilisation

Utilisation

Depuis la liste des contrats

  1. Allez dans Contrats - Liste.
  2. Sélectionnez les contrats à regrouper (ils doivent appartenir au même tiers).
  3. Dans le menu d'actions groupées, choisissez Créer une facture à partir de ces contrats.

Le module génère une facture unique contenant une section et un sous-total par contrat, puis vous redirige vers la facture créée.

Si les contrats sélectionnés appartiennent à des tiers différents, la facturation est refusée : sélectionnez des contrats d'un seul tiers.

Depuis la fiche d'un contrat groupé

Sur la fiche d'un contrat portant un code de regroupement :

  • Une pastille d'avertissement indique que le contrat partage sa facturation avec d'autres contrats du même tiers.
  • Le bouton Créer la facture regroupée génère la facture pour l'ensemble du groupe.
  • Au clic sur le bouton Facturer standard, une confirmation propose d'abord la facture groupée (Annuler = facturer ce contrat seul).

Via la consolidation automatique

Une fois la tâche planifiée activée (voir Configuration), la consolidation mensuelle génère automatiquement une facture par groupe (tiers + code), pour les lignes de service actives et non déjà facturées sur la période.

Lancement manuel (CLI)

Pour déclencher la consolidation en ligne de commande (utile pour un test ou un rattrapage) :

# Tous les groupes :
DOL_DOCUMENT_ROOT=/chemin/vers/dolibarr/htdocs php run_consolidation.php

# Un groupe précis (tiers + code) :
DOL_DOCUMENT_ROOT=/chemin/vers/dolibarr/htdocs php run_consolidation.php <socid> <code>

Idempotence

Chaque ligne facturée est enregistrée dans la table de suivi dédiée, afin qu'une consolidation relancée sur la même période ne facture pas deux fois les mêmes lignes.

Actualisation des quantités (OBAPI)

Si un contrat est lié à un serveur OBAPI (champ Serveur OBAPI (conso)), ses quantités sont automatiquement actualisées depuis la consommation réelle du mois au moment de la facturation — quel que soit le mode de déclenchement (mass action, bouton Facturer, cron). Un résumé de consommation est ajouté à la description des lignes concernées et à la note publique de la facture.

Configuration et détails : Consommation via OBAPI.

Consommation via OBAPI FAQ