Energy Community Billing

The Energy Community Billing module automates the invoicing of Energy Community members (consumers and/or producers) directly in Dolibarr, based on CSV files provided periodically by the distribution network operator.

Key features:

• Import up to 12 pairs of CSV files (consumption + production) in a single operation
• Automatic identification of members via their EAN meter code, stored in a custom field on the third-party record
• Global energy balance check: if total consumption does not match total production (within 1 kWh), the operation is blocked
• Billing period automatically detected and displayed before confirmation
• Three invoice types supported depending on configuration: standard customer invoice, negative customer invoice, or supplier self-invoice
• For members who are both consumers and producers, the module calculates the net balance and generates a single invoice showing both lines (consumption and production) for full transparency
• Pre-generation validation: checks that each third party has the correct Customer / Supplier status in Dolibarr before any invoice is written to the database
• Full preview step before any data is written: summary table and detailed line-by-line breakdown, with the Confirm button disabled if any blocking error is detected
• Transactional SQL generation: if any single invoice fails, the entire batch is rolled back — no partial generation
• Optional automatic validation of generated invoices (Draft vs. Unpaid)
• Direct links to each generated invoice at the end of the process

Important notice — File format compatibility:
This module was developed specifically for Walloon Energy Communities (Belgium) and relies exclusively on the CSV file format provided by the ORES distribution network operator. It is not guaranteed to be compatible with files from other network operators (e.g. Fluvius, or operators outside Belgium) without prior adaptation of the file parsing code.