webservices-enedis
webservices-enedis est une API permettant de communiquer avec les webservices d'Enedis via des messages SOAP.
Table des matières
Services disponibles
Actuellement, neuf services sont disponibles, chacun étant défini dans le projet via une classe dédiée contenant les méthodes nécessaires pour communiquer avec les webservices d'Enedis. Les objets à passer en paramètre des méthodes sont décrits dans le chapitre consacré au sous-module webservices_enedis_common.
-
ConsulterDonneesTechniquesContractuelles
Permet de consulter les données techniques d'un point. Utilisez la méthodeconsultation_donnees_techniques_contractuelles(point)en passant un objet de typePointen argument. -
ConsulterMesures
Permet de consulter l'historique des consommations d'un point. Utilisez la méthodeconsulter_mesures(donnees_consulter_mesures)en passant un objet de typeDonneesConsulterMesuresen argument. -
ConsulterMesuresDetaillees
Permet de consulter les données détaillées d'un point. Utilisez la méthodeconsulter_mesures_detaillees(demande)en passant un objet de typeDemandeConsulterMesuresDetailleesen argument. -
RecherchePoint
Permet de rechercher un point dans le système d'Enedis. Utilisez la méthoderecherche_point(criteres)en passant un objet de typeCriteresen argument. -
CommanderCollectePublicationMesures
Permet de collecter des données ou de demander une transmission récurrente de données sur le point concerné. Utilisez la méthodecommander_collecte_publication(demande_collecte)en passant un objet de typeDemandeCollecteen argument. -
RechercheServicesSouscritsMesures
Permet de récupérer les données des services souscrits sur un point. Utilisez la méthoderechercher_services_souscrit_mesures(prm_id)en passant une chaîne de caractères de 14 caractères correspondant à l'identifiant PRM du point concerné. -
CommanderArretServiceSouscritMesures
Permet d'arrêter un service de collecte ou de transmission de mesures récurrente. Utilisez la méthodecommander_arret_service_souscrit_mesures(demande_arret)en passant un objet de typeDemandeArreten argument. -
CommandeAccesDonneesMesures
Permet de demander l'accès à des données de mesures sur un point. Utilisez la méthodecommande_acces_donnees_mesures(demande)en passant un objet de typeDemandeAccesDonneesMesuresen argument. -
M023InformationsTechniquesEtContractuelles
Permet de demander les données techniques et contractuelles d'un ou plusieurs sites. Utilisez la méthodem023(demande)en passant un objet de typeDemandeInformationsTechniquesEtContractuellesen argument. -
M023HistoriqueMesuresFines
Permet de demander les données fines de consommation ou de production. Utilisez la méthodem023(demande)en passant un objet de typeDemandeHistoriqueMesuresFinesen argument. -
M023MesuresFacturantes
Permet de demander les mesures facturantes des sites. Utilisez la méthodem023(demande)en passant un objet de typeDemandeHistoriqueDonneesFacturantesen argument.
Variables d'environnement
Pour fonctionner correctement, le projet nécessite que plusieurs variables d'environnement soient spécifiées :
WS_ENEDIS_LOGIN: Identifiant auprès des webservices d'Enedis. Ne jamais stocker ou afficher cette information en clair !WS_ENEDIS_CONTRAT_ID: Identifiant du contrat entre le Client et Enedis, utilisé pour identifier l'entreprise sur certains webservices. Ne pas stocker ou afficher cette information en clair !WS_ENEDIS_URL: Partie commune de l'URL d'appel aux webservices d'Enedis.ENVIRONNEMENT_EXECUTION: Doit contenir soitdevpour l'environnement de développement, soitprodpour le déploiement en production. Sert à gérer l'activation de Gunicorn.DJANGO_SECRET: Clé secrète Django. Ne pas stocker ou afficher cette information en clair !PYTHONUNBUFFERED: Doit contenir"1"si vous êtes en développement.DJANGO_SETTINGS_MODULE: Spécifie le module de configuration de Django.DEBUG: Doit absolument être renseigné àFalseen environnement de production.HOMOLOGATION: Indiquant si le système est déployé pour l'homologation Enedis (ne rien mettre si c'est la prod)
Production only
KEY_PRIVATE_CLIENT_CERTIFICATE: Chemin/clé S3 de la clé privée du ClientBUCKET_NAME: Nom du bucket S3 dans lequel est placée la clé publique du client (.crt)KEY_PUBLIC_CLIENT_CERTIFICATE: Chemin/clé S3 du certificat public (exemple : test/certificat.crt)
Connexion avec Imposter
Imposter est un outil de simulation qui permet de reproduire le comportement des webservices d'Enedis. Il est utilisé dans ce projet pour disposer d'un environnement de test accessible rapidement et en local.
Pour qu'Imposter simule un service, il faut lui fournir les fichiers .xsd et .wsdl qui définissent la structure des messages attendus par le service, ainsi qu'un fichier de configuration se terminant par -config.yaml.
Important : Les fichiers .wsdl doivent avoir leur champ targetNamespace modifié pour commencer par http://imposter:8080/.
Exemple de fichier de configuration :
plugin: soap
wsdlFile: RecherchePoint-v2.0.wsdl
resources:
- binding: RecherchePointBinding
operation: rechercherPoint
response:
content: |
<!-- Votre réponse SOAP ici -->
const.py
Le fichier const.py contient l'ensemble des enum et des constantes du système.
Certificats Enedis
Développement
Les certificats peuvent être placés dans le dossier :
./certificats/client_public.crtpour le certificat public./certificats/server.keypour le certificat privé
Production
Le certificat public doit être situé dans le bucket paramètrable via la variable BUCKET_NAME et dont la clé est KEY_PUBLIC_CLIENT_CERTIFICATE
Le certificat privé doit être injecté via une variable d'env dénommée KEY_PRIVATE_CLIENT_CERTIFICATE
Metadata
Release files for wsenedis 0.6.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| wsenedis-0.6.3.tar.gz | 78.0 kB | With provenance | Details for wsenedis-0.6.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wsenedis-0.6.3-py3-none-any.whl | Python 3 | none | any | Details for wsenedis-0.6.3-py3-none-any.whl |
Total release size: 199.1 kB
Release files / wsenedis-0.6.3.tar.gz
| Download URL | wsenedis-0.6.3.tar.gz |
|---|---|
| Size | 78.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6754723f1bc59157753a93950ae4e803c9f7f87220d4ac75d2a778a6ee382cd
|
|
BLAKE2b-256 checksum How to use checksums |
e03f89817e75bdc84788cdbde4f8f22ff9e059e7e530bc1f44bade23d4fcba66
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 29, 2026.
Transparency logRelease files / wsenedis-0.6.3-py3-none-any.whl
| Download URL | wsenedis-0.6.3-py3-none-any.whl |
|---|---|
| Size | 121.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9efc170236305ca046b5d9b3f27025b8c3e14f6310238389ba9bc083c81bb099
|
|
BLAKE2b-256 checksum How to use checksums |
59c04ec66532a091c92ab361e42896ac72d74af15fe9f41c2d1fc2c3c7f9ed86
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 29, 2026.
Transparency logSecurity for wsenedis 0.6.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for wsenedis-0.6.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 29, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.