GRDF
Un PCE n'est interrogeable qu'une fois son contrat en statut GRANTED. Chez GRDF, cela suppose que le titulaire ait confirmé la demande par e-mail ou SMS — voir la confirmation du titulaire.
Terminologie :
Ici nous utilisons le terme pce au lieu de deliveryPointId car ces endpoints sont spécifiques à GRDF, et c'est le vocabulaire de GRDF.
Quatre endpoints interrogent GRDF pour un PCE. Tous prennent un corps JSON avec le pce :
| Endpoint | Données | Période |
|---|---|---|
donnees-informatives | Consommations journalières (index journaliers) | since / until |
donnees-publiees | Consommations publiées par GRDF, celles qui servent à la facturation | since / until |
donnees-techniques | Adresse et caractéristiques du compteur, PITD, régime de propriété | — (situation actuelle) |
donnees-contractuelles | Tarif d'acheminement, profil, CAR, CJA, modulation | — (situation actuelle) |
Endpoints
POST/integration/grdf-adict/donnees-informatives
Objectif : les index journaliers du PCE — les données les plus fines que GRDF fournisse.
{
"pce": "00000000000001"
}
Sans since / until, la réponse couvre tout l'historique servi par GRDF : les 3 dernières années. Pour la borner, passez-les sous forme de dates calendaires (AAAA-MM-JJ, bornes incluses). Chacune est facultative : since vaut par défaut aujourd'hui − 3 ans, et until aujourd'hui.
{
"pce": "00000000000001",
"since": "2026-09-08",
"until": "2026-09-11"
}
La réponse contient le pce, la periode couverte et la liste des consommations, chacune avec son relevé de début et de fin (releve_debut, releve_fin).
POST/integration/grdf-adict/donnees-publiees
Objectif : les consommations publiées par GRDF, sur leur pas de relève — ce sont les données utilisées pour la facturation.
Le corps est le même que pour donnees-informatives : pce, et since / until facultatifs (dates calendaires, bornes incluses). Sans since, la période commence à aujourd'hui − 5 ans ; sans until, elle s'arrête aujourd'hui.
{
"pce": "00000000000001",
"since": "2025-01-01",
"until": "2025-12-31"
}
La réponse a la même forme que celle de donnees-informatives : pce, periode, et consommations avec releve_debut / releve_fin. Si GRDF n'a publié aucune donnée sur la période, consommations est une liste vide.
POST/integration/grdf-adict/donnees-techniques
Objectif : les caractéristiques techniques du point de livraison.
{
"pce": "00000000000001"
}
La réponse contient, en plus du pce :
situation_compteur: adresse du compteur (rue, code postal, commune) ;caracteristiques_compteur: fréquence de relève, calibre, débit, pression de livraison, matricule du compteur ;pitd: point d'interface transport-distribution (identifiant et libellé) ;regime_propriete: régime de propriété du compteur, du convertisseur, du poste et de l'enregistreur.
POST/integration/grdf-adict/donnees-contractuelles
Objectif : les données contractuelles du point de livraison.
{
"pce": "00000000000001"
}
Réponse
{
"pce": { "id_pce": "00000000000001" },
"date_mes": "2016-10-20",
"tarif_acheminement": "T2",
"date_publication": "2026-01-10",
"consommation_journaliere_plafond": null,
"car": { "car_actuelle": "73704", "car_future": "55601" },
"cja": { "cja": null, "cja_journaliere": null, "cja_mensuelle": null },
"profil": {
"date_debut_profil_type_actuel": "2022-04-01",
"date_fin_profil_type_actuel": "9999-12-31",
"profil_type_actuel": "P012",
"profil_type_futur": "P012"
},
"modulation": {
"modulation_n_1": null,
"modulation_n_2": null,
"modulation_n_3": null,
"assiette": null
}
}
car est la consommation annuelle de référence, cja la capacité journalière d'acheminement (pour les PCE qui en ont une) et date_mes la date de mise en service.
PCE de test
Avec le header switchgrid-test-env: true, les PCE de test (Tester le parcours) n'appellent pas GRDF : ils servent des données fictives au format d'un compteur Gazpar résidentiel, chauffé au gaz. Chaque PCE a sa propre courbe, les mêmes paramètres renvoient toujours les mêmes données, et les bornes par défaut comme les refus (400) sont ceux de la production.