Que votre installation soit en vente totale, autoconsommation ou vente surplus, BDPV peut récupérer automatiquement la production photovoltaïque grâce à plusieurs dispositifs (Linky, Enphase, Solax, SolarEdge, Huawei, APsystems, Domotique, Jeedom, domotique, …).
Cela permet de bénéficier gratuitement des notifications d’alertes de perte de production et de l’analyse de performance de votre installation.
Pour envoyer votre production journalière via notre API, il suffit d’appeler l’API tous les matins :
L’url est la suivante : https://www.bdpv.fr/webservice/majProd/expeditionProd_v3.php?util=&apiKey=&source=&typeReleve=&index=
Exemple : https://www.bdpv.fr/webservice/majProd/expeditionProd_v3.php?util=bidule&apiKey=65454564cd544564&source=WebBox&typeReleve=onduleur&index=1235487
Plusieurs éléments à prendre en compte :
– Pour que le calcul de la production du jour puisse être réalisé (et que les alertes associés marchent), il faut envoyer l’index le matin tôt avant le levé du soleil (idéalement à 4h30).
– Pour que le changement de mois soit bien pris en compte, il faut envoyer entre 02h00 et 6h00 (et surtout le 1er du mois).
– Pour ne pas surcharger le serveur, merci de ne pas envoyer trop régulièrement votre production pour ne pas surcharger le serveur (Une fois par jour ce sera parfait)
– Si vous avez un historique des données de production journalière, vous pouvez nous l’envoyer au format excel ou csv
IMPORTANT : Afin que le rapport de performance soit généré, il faut que vous décriviez plus précisément votre installation et la localisation des panneaux sur cette page.
Arguments de l’URL :
- Nom d’utilisateur : Nom de votre fiche BDPV
- ApiKey : Information que vous pouvez retrouver sur la page « Compte utilisateur«
- Source : le matériel utilisé pour appeler l’url. Nous contacter en nous indiquant le matériel utilisé pour récupérer l’index et qui appellera l’url.
- Type releve : onduleur ou compteur (suivant où vous récupérer l’index)
- Index : l’index en Wh (et pas kWh) de la production totale depuis le démarrage de l’installation
Le retour est au format JSON :
- En cas d’erreur ==> {« codeRetour » : « 3 », »texteRetour » : « Le nouvel index (4391479) est égal à celui déjà stocké : 4391479 »}
- En cas de réussite ==> {« prodMoisKwh » : « 999 », »prodJourWh » : « 999 », »prodJourKwh » : « -1″, »codeRetour » : « 4 », »texteRetour » : « OK – Mise à jour de la production. »}
Sachant que la prodMoisKwh ou prodJourWh pourront être à -1 si le calcul n’est pas possible.
Le code retour pourra prendre les valeurs suivantes :
1 : OK – nouveau mois pour l’utilisateur.
2 : OK – nouveau mois pour l’utilisateur – Mois précédent mis à jour.
3 : Le nouvel index (99999999) est égal à celui déjà stocké : 999999999
4 : OK – Mise à jour de la production.
-1 : Erreur, il n’y a pas le nom de l’utilisateur
-2 : Erreur, il n’y a pas l’index du compteur
-3 : Erreur, il n’y a pas l’apiKey
-4 : Erreur, il n’y a pas la source de la donnée
-5 : Erreur, la source de données est incorrecte
-6 : Erreur, sur le type de relevé (onduleur ou compteur)
-7 : Erreur, il n’y a pas d’utilisateur ayant ce numéro et étant en état OK
-8 : Erreur, la puissance crête de l’installation est mauvaise.
-9 : Erreur, l’apiKey est incorrect
-10 : Erreur, le numéro d’utilisateur : 999999999999 est différent de celui en paramêtre : 99999999999
-11 : Le nouvel index (99999) est inférieur celui déjà stocké : 999999999;
-12 : OK – Index déjà connu.
Inférieur à -100 ==> Erreur interne
Plusieurs utilisateurs ont postés du code pour automatiser depuis python, zzzt, ….
Les messages sont ici :
– Sheevaplug (5W!) + SMA pour automatiser suivi prod PV
– Home Assistant : Forum Photovoltaïque ou Forum Home Assistant
– Envoyer depuis sa box eedomus sa production vers BDPV
2
2