SWITCHGRID
DOCS

v0

Guide
AuthentificationRechercher un contratCollecter le consentement
GRDF
Récupérer les données
EnedisGRDFStrasbourg (ESR)
WebhooksRate-limits de l'APIPoints importants
Migrer vers l'API v0OpenAPI SpecRelease NotesFAQ

Strasbourg Électricité Réseaux (ESR)#

Endpoints#

POST/integration/esr/contract#

Objectif : Métadonnées détaillées du contrat associé au point de livraison ESR, incluant le statut du contrat et les identifiants contractuels.

Utilisation

Appelez cet endpoint pour récupérer les détails du contrat d'un client une fois que l'Ask de consentement est actif.

{
  "rtpl": "..."
}
Réponse
{
    "rtpl": "...",
    "usagePoint": {
        "usagePointId": "...",
        "usagePointStatus": "COM",
        "meterType": "compteur communicant bleu"
    },
    "contract": {
        "segment": "C5",
        "subscribedPower": "6 kVA",
        "lastActivationDate": "2024-09-12",
        "distributionTariff": "CU ADT 4 postes",
        "contractType": "Contrat unique",
        "contratStatus": "Actif",
        "lastDistributionTariffChangeDate": "2024-09-12",
        "offpeakHours": "23:00-07:00"
    }
}

POST/integration/esr/maximum-powers#

Objectif : Récupère les valeurs de puissance maximale enregistrées pour le RTPL sur des périodes définies.

Utilisation
{
    "rtpl": "...",
    "since": "2023-02-23",
    "until": "2023-02-24"
}
Réponse
{
    "rtpl": "...",
    "since": "2026-02-23",
    "until": "2026-02-24",
    "count": 1096,
    "data": [
        {
            "value": 2915,
            "pas": null,
            "libelle": null,
            "timestamp": "2026-02-23T08:25:00.000+00:00",
            "timestampStorage": "2026-02-23T08:25:33.409+00:00"
        }
    ]
}

POST/integration/esr/meter-readings#

Objectif : Récupère les relevés bruts du compteur (valeurs d'index) pour le RTPL.

Utilisation
{
    "rtpl": "...",
    "since": "2026-02-23",
    "until": "2026-02-24",
    "type": "fournisseur"
}
Réponse
{
    "rtpl": "...",
    "since": "2026-02-23",
    "until": "2026-02-24",
    "count": 4384,
    "data": [
        {
            "value": 77818,
            "measureType": "NETWORK_INDEX_02",
            "libelle": "GRD HP BASSE",
            "timestamp": "2026-02-23T00:00:00.000+00:00",
            "timestampStorage": "2026-02-23T00:41:02.079+00:00"
        },
        {
            "value": 37820,
            "measureType": "NETWORK_INDEX_03",
            "libelle": "GRD HC HAUTE",
            "timestamp": "2026-02-23T00:00:00.000+00:00",
            "timestampStorage": "2026-02-23T00:41:02.079+00:00"
        },
        {
            "value": 927210,
            "measureType": "NETWORK_INDEX_01",
            "libelle": "GRD HC BASSE",
            "timestamp": "2026-02-23T00:00:00.000+00:00",
            "timestampStorage": "2026-02-23T00:41:02.079+00:00"
        },
        {
            "value": 289763,
            "measureType": "NETWORK_INDEX_04",
            "libelle": "GRD HP HAUTE",
            "timestamp": "2026-02-23T00:00:00.000+00:00",
            "timestampStorage": "2026-02-23T00:41:02.079+00:00"
        }
    ]
}

POST/integration/esr/average-powers#

Objectif : Retourne la courbe de charge pour le RTPL, la direction et l'intervalle de temps demandés.

❗

Activation de la courbe de charge C5 / C6

Pour les segments C5 et C6, la courbe de charge n'est pas activée par défaut lors du consentement. Nous demandons l'activation de la courbe de charge durant le processus de consentement (Ask), mais cela peut prendre jusqu'à une semaine avant que les données soient disponibles. En attendant :

  • Les appels à cet endpoint peuvent retourner une erreur indiquant que la courbe de charge n'est pas encore disponible.
  • Les clients doivent implémenter une stratégie de retry ou de vérification de statut en attendant que les données soient activées.
Utilisation
{
    "rtpl": "....",
    "since": "2026-01-22T23:00:00.000+00:00",
    "until": "2026-02-23T23:00:00.000+00:00",
    "type": "soutirage"
}
Réponse
{
    "rtpl": "...",
    "count": 31,
    "since": "2026-01-22T23:00:00.000+00:00",
    "until": "2026-02-23T23:00:00.000+00:00",
    "data": [
        ...
    ]
}

RTPL de test pour l'intégration#

Les RTPL suivants sont disponibles pour tester différents types de contrats et scénarios de courbes de charge. Ces RTPL simulent le comportement réel d'ESR et vous permettent de valider votre intégration avec différentes configurations contractuelles.

Pour tous les cas de test suivants, vous devez d'abord créer un Ask pour le RTPL donné avec switchgrid-test-env à true, puis signer l'Ask vous-même. L'adresse de l'Ask doit être à Strasbourg, au code postal 67000 : avec un autre code postal, le contrat est NOT_VALID (voir Tester la création d'un Ask).

1. C5 – Courbe de charge déjà activée#

Utilisez le RTPL suivant pour simuler un contrat C5 où la courbe de charge est déjà activée :

  • RTPL : ESR00000C50001

Comportement attendu :

Ce scénario représente un point de livraison C5 pleinement opérationnel.

2. C5 – Courbe de charge en attente d'activation#

Utilisez le RTPL suivant pour simuler un contrat C5 où la courbe de charge doit être activée :

  • RTPL : ESR00000C50002

Comportement attendu :

  • L'appel à POST/integration/esr/average-powers retourne une erreur indiquant qu'ESR a été sollicité pour activer la courbe de charge, et que le processus d'activation peut prendre jusqu'à une semaine.

Ce scénario vous permet de valider la gestion des erreurs et la logique de retry pendant que la courbe de charge est en cours d'activation.

3. C4 – Contrat standard#

Utilisez le RTPL suivant pour simuler un contrat C4 :

  • RTPL : ESR00000C40001

Comportement attendu :

Ce scénario représente un point de livraison C4 pleinement opérationnel.

SWITCHGRID
© 2024 - 2026 Switchgrid