Dashboard
Répartition par type de relevé
Top 10 clients
| Client | Nb EAN |
|---|
| Client | Société | EAN | Nom | Type de relevé | Commodité |
|---|
Résultats
Importer de nouveaux EAN
Téléchargez le template, remplissez-le avec vos EAN, puis importez-le. Le test de validité se lance automatiquement.
Résultats du test
| Statut | EAN | Client | Site | EAN Engie trouvé |
|---|
11e Puissance mensuelle
| Client | Site | EAN | Type de relevé | Commodité |
|---|
Résultats
| EAN | Mois | Donnée | Valeur |
|---|
Profil Metering — HP / HC
| Client | Site | EAN | Type de relevé | Commodité |
|---|
Profil Mensuel HP / HC
| EAN | Client | Mois | Conso HP (MWh) | Conso HC (MWh) | Conso Totale (MWh) | Pic HP (kW) | Pic HC (kW) | Ratio HP (%) |
|---|
Bilan EAN — Test API Engie
| Statut | Client | Site | EAN | Commodité | Type de relevé |
|---|
Inventaire Marché Public
| Client | Site | EAN | Type de relevé | Commodité |
|---|
Résultats Inventaire
| Statut | EAN | Client | Commodité | Type |
|---|
Documentation
1. API Engie B2B — Vue d'ensemble
L'application se connecte a l'API Engie GEMS B2B pour recuperer les donnees de consommation, facturation et metering des points de livraison (EAN) du portefeuille Act Energy.
https://api.business.engie.be/engie/gems/Authentification : OAuth2 Client Credentials (token renouvele automatiquement toutes les 5 minutes)
Portail Engie :
https://business.engie.be/en/api-portal/home
2. Endpoints API Engie disponibles
| Endpoint | Methode | Description | Periode max |
|---|---|---|---|
/b2b-billing/v1/private/installations/{ean}/consumption-data |
GET | Donnees de consommation agregees (PEAK / OFFPEAK / NORMAL) | 3 ans |
/b2b-billing/customer-app/v1/installations/{ean}/invoiced-data |
GET | Donnees de facturation completes (montants, details par composant) | 3 ans |
/b2b-premises/v1/private/installations/{ean}/metering-data |
GET | Donnees quart-horaires (elec) ou horaires (gaz) | 6 mois |
EAN_ID1 (ex: 541456700000000842_ID1). Le suffixe _ID1, _ID2 ou _ID3 est teste automatiquement par la plateforme.
3. Parametres de requete
| Parametre | Type | Description |
|---|---|---|
ean | path | Identifiant unique du point de livraison (18 chiffres + suffixe) |
dateFrom | query | Date de debut (YYYY-MM-DD) |
dateTo | query | Date de fin (YYYY-MM-DD) |
profileType | query | Metering uniquement : ACTIVE (defaut), CAPACITIVE, INDUCTIVE |
meteringDirection | query | Metering uniquement : CONSUMPTION (defaut), INJECTION, LOCALPRODUCTION |
4. Modules de la plateforme
Dashboard
Vue d'ensemble du portefeuille : nombre d'EAN, repartition electricite/gaz, types de releve, top 10 clients.
Exporter
Export en masse des donnees pour les EAN selectionnes. Trois types disponibles :
- Factures — Donnees de facturation completes (montants HTVA, consommation, composants de facturation)
- Consommation — Donnees de consommation agregees par mois (HP/HC)
- Metering — Donnees quart-horaires brutes (decoupe automatique par tranche de 6 mois)
Filtrez par client, site, EAN, type de releve ou commodite. L'export genere un fichier Excel.
Bilan EAN
Teste chaque EAN du perimetre via l'API Engie pour verifier s'il est accessible. Resultat : OK (donnees trouvees) ou KO (pas de donnees / EAN non reconnu).
Importer
Elargir le perimetre en ajoutant de nouveaux EAN :
- Telecharger le template Excel
- Remplir les colonnes EAN, Client, Site
- Importer le fichier — le test se lance automatiquement
- Les doublons sont detectes et marques en orange
- Confirmer l'import pour les EAN valides uniquement
11e Puissance
Calcule la 11e plus grande puissance quart-horaire de chaque mois pour les EAN AMR Electricite. Utilise dans le cadre des marches publics pour determiner la puissance de reference.
Profil Metering
Analyse detaillee du profil de consommation avec repartition Heures Pleines / Heures Creuses :
- HP (Heures Pleines) : lundi a vendredi, 7h a 22h
- HC (Heures Creuses) : 22h a 7h + samedi et dimanche
L'export Excel contient 3 onglets : donnees brutes avec tarif HP/HC, profil mensuel agrege, et un graphique combine consommation + pic de puissance.
Inventaire
Genere un inventaire complet au format marche public avec 2 onglets :
- Electricite HT — EAN AMR/MMR elec : infos generales, consommation HP/HC mensuelle, PMAX mensuelle
- Gaz HP — EAN AMR/MMR gaz : infos generales, consommation mensuelle (pas de HP/HC ni PMAX)
Le fichier respecte le format template avec bande bleue, logo Act Energy, et mise en forme professionnelle.
5. Types de releve
| Code | Signification | Frequence | Donnees disponibles |
|---|---|---|---|
| AMR | Automatic Meter Reading | Quart-horaire (elec) / Horaire (gaz) | Metering, Consumption, Invoiced |
| MMR | Monthly Meter Reading | Mensuelle | Consumption, Invoiced (metering partiel) |
| SMR | Smart Meter Reading | Variable | Consumption, Invoiced |
| YMR | Yearly Meter Reading | Annuelle | Consumption, Invoiced |
| YMR | Yearly Meter Reading | Annuelle | Consumption uniquement |
6. Securite
- Authentification : Google Sign-In via Firebase, restreint aux adresses @act-energy.be
- Token : JWT Firebase verifie cote backend (certificats Google publics, RS256). Renouvellement automatique toutes les 50 minutes
- HTTPS : Certificat Let's Encrypt, redirection HTTP automatique
- Headers : HSTS, X-Frame-Options DENY, CSP, XSS Protection
- CORS : Restreint aux domaines Act Energy
- Rate Limiting : 60 requetes/minute par IP
7. Limites et contraintes
- L'API Engie metering est limitee a 6 mois par requete — la plateforme decoupe automatiquement les periodes plus longues
- Seuls les EAN actives dans le perimetre API Engie retournent des donnees — certains EAN du portefeuille Act Energy ne sont pas encore actives cote Engie
- Les exports volumineux (155 EAN x 12 mois de metering) peuvent prendre plusieurs minutes — la parallelisation (5 workers) accelere le processus
- Les donnees sont recuperees en temps reel depuis l'API Engie — aucun cache local