GRDF Tiers Direct
Le connecteur GRDF Tiers Direct prend place dans un contexte où le parcours Client Connect se complexifie et rend l'accès à la donnée trop compliqué pour nos utilisateurs.
Le parcours "Tiers Direct" vise à déléguer cette complexité en laissant la gestion du consentement et de son périmètre au tiers (Métropole de Lyon).
Processus détaillé
- L'utilisateur renseigne ses informations dans Ecolyo
- Son consentement à partager ses données est enregistré dans le backoffice Ecolyo
- Ses droits d'accès sont créés/consultés chez GRDF
- La récupération des données est effectuée
1. Parcours utilisateur
Le parcours utilisateur est défini sur les maquettes.
2. Preuve de consentement backoffice
La récupération des données de consommation de gaz auprès de GRDF nécessite le recueil du consentement auprès de nos utilisateurs, nous devons donc en collecter la preuve. Ce processus est réalisé grâce au parcours d'onboarding de l'application.
Un appel API est ensuite réalisé à notre serveur backoffice. Cet appel est enregistré et sert notamment de preuve lors des contrôles a posteriori effectués par GRDF.
https://ecolyo-agent.apps.grandlyon.com/consents/grdf
3. Création du consentement GRDF
- Numéro de PCE
- Nom
- Adresse
- Code postal
Création d'un droit accès
Méthode PUT sur la route https://api.grdf.fr/adict/v2/pce/:id_pce/droit_acces
L'appel de cette route envoie un email à l'adresse renseignée. Cet email requiert une action de l'utilisateur afin qu'il accepte/refuse la demande générée.
L'email envoyé par GRDF est envoyé par batch de 15 minutes tous les quarts d'heures.
Exemple : Un utilisateur crée sa demande à 9h31. Il va recevoir son mail à 9h45.
Statut des droits accès (consentements)
Un utilisateur peut avoir plusieurs consentements. Chaque consentement peut avoir différents états (voir schéma GRDF)
Capture d'écran issue de la documentation fonctionnelle GRDF (https://sites.grdf.fr/web/portail-api-grdf-adict/documentation_fonctionnelle)
Le connecteur se base sur l'état des consentements pour déterminer l'accès à la donnée.
L'accès à la donnée est réalisable avec le statut "Active"
La révocation se traduit par une action explicite de l'utilisateur. C'est à dire lorsque l'utilisateur clique sur "Refuser" dans l'interface GRDF.
Cette action va marquer le consentement comme "Révoquée"
❌ Cette action va notamment bloquer la création d'un nouveau consentement. Pour débloquer cette révocation, il faut contacter le support GRDF (https://sites.grdf.fr/web/portail-api-grdf-adict/support2).
Extrait documentation GRDF :
En cas de changement de données contractuelles, un Droit d'accès se met à l'état "A revérifier" pendant quelques jours, le temps de procéder à une mise à jour.
C'est un processus automatique, vous n'aurez rien à intervenir ou lancer un autre appel. Au bout de quelques jours au plus, le Droit d'accès revient automatiquement à l'état "Active" si le Titulaire est toujours le même, ou "Obsolète" si le Titulaire a changé.
Par contre, si l'état "A revérifier" est bloqué pendant un temps anormalement long (plusieurs semaines au moins), il faut nous prévenir pour analyse & correction.
Extrait documentation GRDF :
Il est tout à fait possible de refaire immédiatement une nouvelle déclaration après que le Droit d'accès soit passé à "Obsolète". Cela vaut aussi pour un Droit d'accès à l'état "Refusé".
Seul l'état "Révoqué" entraîne le blocage de déclaration.
Si l'utilisateur n'a pas validé son consentement, l'état "Refusée" est obtenu. Le connecteur va supprimer le consentement backoffice.
Lors d'un lancement manuel, cet état n’arrête pas le connecteur et créé un consentement.
Liens
Documentation fonctionnelle GRDF
Support GRDF
Divers
FAQ
Client Connect + Tiers Direct
Si une personne possède un consentement client connect "Validée", elle n'a pas besoin de créer un nouveau consentement Tiers Direct, elle peut accéder à sa donnée.
Si une personne possède un consentement client connect "Révoquée" sur la même période qu'un consentement "Validée", il est impossible pour elle de créer un nouveau consentement Tiers Direct.
Il ne s'agit pas du comportement attendu, GRDF est en cours de résolution de ce bug (à la date du 16/04/2024).
A noter, la suppression du connecteur dans Ecolyo - utilisant alors le parcours Client Connect - entraînait la suppression du consentement (= Passage au statut "Révoquée" pour GRDF). Cette suppression du consentement était nécessaire pour pouvoir redonner un consentement dans le parcours Client Connect. Des utilisateurs pourraient donc avoir dans leurs droits d'accès sur la période des consentements "Révoquée"
Erreurs 429
En raison des quotas stipulés dans l'atelier technique et fonctionnel, il arrive que des requêtes échouent et renvoient une erreur non métier error : { reasons: [], details: { msgId: 'Id-262fca65f174f4019691ee56' } } ce type de retour se produit dans les cas d'erreurs 429. Ce quota peut-être dépassé si nous faisons plus de 6000 appels par jours ou plus d'1 appel/seconde.
BAS
GRDF dispose d'un Bac À Sable pour réaliser des tests. Au moment des développements du connecteur, ce BAS est statique et ne reflète pas l'environnement de production. Il n'est pas utilisable pour des tests de connexion, tests les plus utiles à la mise en production du nouveau connecteur gaz Tiers Direct.
Contrat échu
Pouvez-vous nous confirmer qu'il est impossible (blocage technique opéré de votre côté) d'ouvrir un consentement sur un contrat expiré ?
Réponse GRDF :
Effectivement, quand on essaie d'ouvrir un Droit d'accès sur un compteur mis hors service (c'est à dire qu'il n'y a aucun Contrat gaz dessus), on reçoit le message d'erreur "Le Contrat de fourniture est échu".
Il n'est donc pas possible d'ouvrir le Droit d'accès sur un compteur mis hors service, nos systèmes le bloquent automatiquement.
Données historiques
Est-il possible, sur un contrat expiré, de consulter les données historiques (jusqu'à la date d'expiration du contrat) ?
Réponse GRDF :
Au moment où le Compteur a été mis hors service (c'est à dire que le Contrat est résilié) alors que le Tiers dispose encore d'un Droit d'accès sur ce compteur, alors l'accès deviendra automatiquement obsolète et il n'est plus possible de consulter toute donnée, que ce soit le suivi ou l'historique.
Il faut que le Droit d'accès soit à l'état "actif" afin de récupérer les Consommations, que ce soit le suivi ou l'historique.
Profondeur des données
Sur un compteur Gazpar (c'est à dire 1M), la profondeur maximale d'historique de données de consommations quotidiennes est de 3 ans.
Si la date de mise en service du compteur est plus récente que 3 ans, alors l'historique va s'arrêter à cette date. (Par exemple, si la date de MES d'un compteur Gazpar est en 01/01/2023, alors nous n'aurons les consommations quotidiennes que jusqu''à cette date).
Changement de titulaire
En résumé, quels risques/conflits dans la récupération des données existe-t-il (et sont pris en charge de votre côté) lors du changement de titulaire de PCE (= Situation : changement de locataire par exemple)
Le changement de Titulaire se traduit par la mise hors service puis la remise en service du compteur. Dès que nos systèmes détectent une mise hors service du compteur, alors ils couperont tout accès aux données. En langage "ADICT", l'état du Droit d'accès passera automatiquement de "Active" à "Obsolète".
De plus, si on essaie de refaire un nouveau Droit d'accès après le changement de Titulaire, on aura certes l'accès aux consommations du nouveau Titulaire mais l'historique des consommations sera automatiquement limité à la date de Mise en Service du compteur.
Ainsi les Consommations de l'ancien Titulaire ne seront plus accessibles.
Une autre risque mais qui n'est pas de notre côté est que les Fournisseurs doivent faire correctement leur déclaration de changement de Fournisseur. En effet, il peut arriver qu'un Fournisseur fasse la déclaration de changement de Titulaire au lieu d'un Changement de Fournisseur alors que le Titulaire est bien toujours le même.
Dans ce cas, nos systèmes ont noté le changement de Titulaire alors que c'est faux et limitent automatiquement l'historique à la date de ce changement (empêchant ainsi le Titulaire d'accéder à l'historique plus loin)