Capfile API Pro : intégrez directement les données Enedis dans vos applications

Vous développez un CRM, un logiciel de suivi énergétique, un outil de dimensionnement photovoltaïque ou une application destinée à analyser la consommation de vos clients ?

Capfile Pro met à disposition une API REST permettant d’intégrer directement les données des compteurs dans vos propres outils.

L’objectif est simple : vous éviter d’avoir à gérer vous-même la complexité des différents flux Enedis et vous fournir des données structurées, homogènes et directement exploitables.

Une API conçue pour les professionnels

L’API Capfile est réservée aux comptes Capfile Professionnels.

Elle s’adresse notamment :

aux bureaux d’études photovoltaïques ;
aux consultants et courtiers en énergie ;
aux éditeurs de logiciels ;
aux intégrateurs ;
aux exploitants de parcs photovoltaïques ;
aux gestionnaires multisites ;
aux collectivités ;
aux entreprises souhaitant intégrer leurs données énergétiques dans leur SI, leur CRM ou leurs outils de supervision.

Capfile assure la collecte et la standardisation des données. Votre application peut ainsi se concentrer sur son véritable métier : analyse, optimisation, simulation, supervision ou conseil.

⚡ Consommation et production dans une même API

L’API distingue naturellement les deux sens d’énergie :

soutirage : énergie consommée ;
injection : énergie produite et injectée sur le réseau.

Cette distinction permet d’utiliser la même interface pour un simple site consommateur, une installation photovoltaïque ou un site combinant consommation et production.

Votre application peut automatiquement déterminer les données réellement disponibles pour chaque compteur.

📋 Accéder aux informations techniques du compteur

L’API permet de récupérer les informations techniques et contractuelles – ITC – disponibles pour un PRM.

On peut notamment y retrouver, selon le compteur :

l’état du point ;
son segment ;
les caractéristiques du raccordement ;
les caractéristiques du compteur ;
les informations de soutirage et d’injection ;
les grandeurs physiques disponibles ;
la puissance de raccordement en injection lorsqu’elle est disponible.

La structure retournée permet à votre application de s’adapter automatiquement aux caractéristiques réelles de chaque point.

C’est particulièrement utile pour un bureau d’études : le PRM devient la clé d’entrée permettant d’identifier et de caractériser automatiquement une installation.

📊 Récupérer les index de consommation et de production

Capfile permet d’interroger l’historique des index du compteur.

Pour chaque journée, l’API peut fournir :

l’index cumulé relevé sur le compteur ;
la différence par rapport au relevé précédent ;
les différents cadrans disponibles ;
le total journalier.

Les index peuvent être interrogés aussi bien en soutirage qu’en injection.

Selon les caractéristiques du compteur, différentes grandeurs physiques peuvent être disponibles :

énergie active ;
énergie réactive ;
puissance maximale ;
durées ou dépassements ;
autres grandeurs fournies par le compteur.

L’application n’a pas besoin de supposer à l’avance quelles données existent : l’endpoint d’information du compteur indique les grandeurs effectivement disponibles.

📈 Exploiter directement les courbes de charge

Pour les analyses plus fines, l’API donne accès aux courbes de charge.

Chaque mesure contient notamment :

la date et l’heure ;
le pas de mesure ;
l’énergie correspondante.

Selon le compteur, le pas disponible peut être de :

5, 10, 15, 30 ou 60 minutes.

La récupération est possible séparément pour :

la consommation ;
l’injection.

Ces données permettent par exemple de construire :

un profil de consommation ;
une étude d’autoconsommation photovoltaïque ;
un dimensionnement de stockage ;
une détection de talon de consommation ;
une recherche de dérives ;
une analyse des périodes de forte consommation ;
une simulation énergétique.

Capfile fournit la donnée brute : vous restez entièrement libre d’appliquer vos propres algorithmes et votre propre logique métier.

🔄 Des données actualisées automatiquement

L’intérêt de Capfile ne se limite pas à donner accès à un historique.

Les données des compteurs sont également actualisées automatiquement.

Capfile met régulièrement à jour :

les index ;
les courbes de charge ;
les informations techniques et contractuelles.

Votre application peut donc conserver automatiquement ses propres données à jour sans avoir à gérer directement les échanges avec Enedis.

🔔 Webhook : votre application est avertie dès que de nouvelles données arrivent

Il n’est pas nécessaire d’interroger continuellement l’API pour savoir si de nouvelles données sont disponibles.

Capfile propose un système de webhook.

Vous déclarez simplement une URL de votre application. Lorsqu’une nouvelle donnée est intégrée, Capfile appelle automatiquement cette URL.

La notification précise notamment :

le PRM concerné ;
le nom du compteur ;
le type de données mises à jour ;
la période concernée.

Trois grandes catégories de notifications sont actuellement disponibles :

info : informations techniques ;
index : index ;
loadcurve : courbe de charge.

Votre application peut alors récupérer uniquement les nouvelles données dont elle a besoin.

Exemple

Une nouvelle courbe de charge est disponible pour un client.

Capfile prévient votre CRM par webhook.

Votre CRM appelle l’API pour la période indiquée.

Les nouvelles données sont intégrées automatiquement au dossier du client.

Aucune intervention manuelle n’est nécessaire.

🔐 Des webhooks authentifiés

Chaque notification envoyée par Capfile peut être contrôlée par votre serveur.

Les appels sont signés en HMAC-SHA256 à l’aide d’un secret partagé.

La signature est transmise dans l’en-tête :

X-Signature

Votre serveur peut donc vérifier que :

la notification provient bien de Capfile ;
son contenu n’a pas été modifié pendant le transport.

Une fonction de test permet également de déclencher une notification fictive afin de valider votre intégration avant sa mise en production.

🔑 Une authentification simple par clé API

L’accès aux données utilise une clé API propre au compte professionnel.

Elle est transmise dans l’en-tête :

x-api-key

La clé peut être consultée depuis l’API et renouvelée à tout moment.

En cas de renouvellement, l’ancienne clé est immédiatement révoquée.

Cette architecture permet notamment de séparer les identifiants du compte Capfile utilisés par une personne des identifiants techniques utilisés par vos serveurs.

🤖 Une API particulièrement facile à intégrer avec les outils d’IA

Capfile fournit une description complète de son API au format OpenAPI 3.

Cela permet :

de consulter l’API dans Swagger ;
de tester directement les appels ;
de générer automatiquement un client dans de nombreux langages ;
de générer les modèles de données ;
et désormais d’utiliser très facilement un assistant de développement ou une IA pour créer l’intégration.

Un développeur peut ainsi fournir directement la spécification OpenAPI à son environnement de développement ou à son assistant IA et lui demander, par exemple :

« Crée un client PHP pour récupérer la liste des compteurs Capfile et télécharger les courbes de charge. »

ou :

« Intègre les données Capfile dans mon CRM Python et mets le dossier à jour lorsqu’un webhook est reçu. »

La structure standardisée de l’API réduit considérablement le temps nécessaire pour réaliser une première intégration.

🧱 Des réponses JSON homogènes

Toutes les réponses de l’API utilisent le format JSON et suivent une structure commune :

success
code
message
data

L’intégration est donc prévisible quel que soit le type de données demandé.

Les erreurs utilisent également les codes HTTP standards : mauvaise requête, authentification incorrecte, absence de droit, quota dépassé, etc.

📡 Une seule interface pour des compteurs très différents

L’un des objectifs de Capfile est de masquer une partie de la complexité des données énergétiques.

Une application peut commencer par interroger les informations du PRM pour savoir :

s’il dispose d’un flux de soutirage ;
s’il dispose d’un flux d’injection ;
quelles grandeurs physiques sont disponibles ;
quelles caractéristiques techniques lui sont associées.

Elle adapte ensuite automatiquement ses appels.

Un même développement peut ainsi traiter aussi bien :

un consommateur → un producteur photovoltaïque → un site en autoconsommation avec injection.

👥 Gérer plusieurs compteurs

L’endpoint dédié aux compteurs permet de récupérer l’ensemble des PRM accessibles au compte professionnel.

Chaque compteur est identifié par :

son PRM ;
son nom dans Capfile.

L’API prend également en charge les compteurs partagés avec le compte professionnel, dans la limite des droits accordés par leur propriétaire.

Cette fonction permet de construire simplement des outils :

multisites ;
multi-clients ;
multi-bâtiments ;
multi-installations photovoltaïques.

🚦 Des quotas contrôlables directement par API

Les accès API sont protégés par des quotas journaliers, hebdomadaires et mensuels adaptés au compte.

Un endpoint spécifique permet de connaître à tout moment :

le quota disponible ;
le nombre d’appels déjà réalisés ;
le nombre d’appels restant.

Une application peut donc surveiller elle-même son utilisation et adapter ses appels si nécessaire.

☀️ Exemple : automatiser une étude photovoltaïque

Prenons le cas d’un bureau d’études photovoltaïque utilisant son propre CRM.

Après autorisation du client, le compteur est ajouté dans Capfile.

Le CRM peut ensuite automatiquement :

identifier le PRM et ses caractéristiques ;
récupérer les index ;
récupérer l’historique de consommation ;
télécharger la courbe de charge ;
récupérer l’injection lorsqu’elle existe ;
intégrer les nouvelles données à chaque actualisation ;
lancer les calculs de dimensionnement photovoltaïque.

Le bureau d’études peut alors déterminer à partir des consommations réelles :

la puissance photovoltaïque pertinente ;
le potentiel d’autoconsommation ;
les périodes de consommation ;
la quantité prévisible de surplus ;
l’intérêt d’une batterie ou d’un pilotage des usages.

L’intégralité du parcours peut être intégrée dans le logiciel métier du professionnel.

🏢 Et de nombreux autres usages

La même API peut servir à construire des solutions de :

Supervision multisite
Centralisation des consommations de dizaines ou centaines de bâtiments.

Gestion énergétique
Détection de dérives et comparaison des profils de consommation.

Conseil en énergie
Analyse automatique des données avant intervention du consultant.

Suivi photovoltaïque
Comparaison consommation, production et injection.

Contrôle de facturation
Exploitation des index réels dans un outil interne.

Maintenance
Détection automatique d’une évolution anormale de consommation ou de production.

Reporting
Alimentation automatique d’un ERP, CRM, outil BI ou tableau de bord interne.

💶 Capfile Pro, une facturation au fil de l’eau

L’accès à l’API est réservé aux utilisateurs professionnels de Capfile.

La formule professionnelle permet de connecter vos compteurs à Capfile et d’exploiter leurs données directement depuis vos propres outils.

Seuls les compteurs actifs dans le mois sont facturés.

Vous pouvez ainsi adapter le nombre de compteurs suivis à votre activité.

🚀 Démarrer avec l’API Capfile Pro

Vous disposez déjà d’un compte professionnel ?

La documentation technique de l’API Pro v1.1 est disponible ici :

https://api.capfile.com/pro/v1.1/doc

Vous y trouverez :

la procédure d’authentification ;
les endpoints disponibles ;
des exemples de réponses JSON ;
Swagger UI ;
la spécification OpenAPI ;
la configuration des webhooks ;
la vérification de leur signature ;
les quotas ;
les codes d’erreur.

Vous souhaitez intégrer les données Enedis dans votre logiciel, votre CRM ou votre application métier ?

Contactez-nous pour activer Capfile Pro et étudier votre intégration.

Capfile : la donnée énergétique comme composant de votre application

Avec l’API Capfile Pro, les données du compteur ne sont plus limitées à une interface de consultation.

Elles deviennent une brique directement intégrable dans votre système d’information.

Capfile prend en charge l’accès, la collecte et la standardisation des données ; votre entreprise peut se concentrer sur ce qu’elle sait faire : les analyser, les valoriser et créer ses propres services.