---
title: "Utilisation"
weight: 30
description: "Créer une facture regroupée depuis la liste des contrats, depuis la fiche d'un contrat, ou via la consolidation automatique."
---

# 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](/multicontractsoneinvoice/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) :

```sh
# 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](/multicontractsoneinvoice/consommation-obapi).