Aiswei ou Solplanet

Connecter votre compte Solplanet à EnergyID

Pour intégrer vos données solaires photovoltaïques Solplanet avec EnergyID, vous devez récupérer trois informations spécifiques de votre compte Solplanet. Ce guide vous explique comment faire.

Étape préliminaire importante ! Activation de l'API
Avant de trouver toutes les clés nécessaires, l'accès à votre API Solplanet doit être activé. La manière la plus simple est d'envoyer un e-mail au support Solplanet à service.nl@solplanet.net. Mentionnez l'e-mail de votre compte Solplanet ou votre numéro de téléphone enregistré et demandez l'activation de l'API pour votre compte. Ils confirmeront une fois que ce sera fait et pourront vous fournir certaines clés directement.

Cette étape est obligatoire pour trouver toutes les informations nécessaires dans votre compte !

Informations requises

Vous devez trouver les trois clés suivantes :

  1. AppKey du compte (un numéro à 9 chiffres)
  2. Clé API du compte (Secret) (une chaîne alphanumérique)
  3. Clé API de l'installation (une chaîne alphanumérique, spécifique à votre installation)

Étape 1 : Trouver votre AppKey de compte et votre Clé API de compte (Secret)

Une fois l'accès à votre API activé par le support Solplanet, vous trouverez les deux premières clés dans les paramètres de votre compte Solplanet :

  1. Connectez-vous à votre portail Solplanet (par ex., cloud.solplanet.net).
  2. Allez sur votre profil de compte ou la section des paramètres. Cliquez sur votre profil en haut à droite, puis sur "Compte et sécurité".
  3. Naviguez ensuite vers "Paramètres du compte".
  4. Ici, vous trouverez une entrée pour les clés API (si activées au préalable par le service client !).
  5. Identifiez et copiez/notez quelque part les 2 clés sur cette page :
    • L'AppKey : C'est le numéro à 9 chiffres. (Dans la configuration de votre intégration EnergyID, entrez-le dans le champ "AppKey").
    • La Clé API (Secret) : C'est la chaîne alphanumérique la plus longue. Elle se trouve à côté de la clé plus courte. (Dans la configuration de votre intégration EnergyID, entrez-la dans le champ "ApiKey").

Étape 2 : Trouver votre Clé API d'installation

Cette clé est spécifique à l'installation solaire (votre système) que vous souhaitez connecter à EnergyID.

  1. Connecté au portail Solplanet, naviguez vers la section "Installation" ("Plant") ou votre liste d'installations.
  2. Sélectionnez l'installation spécifique à intégrer avec EnergyID. Vous arriverez au tableau de bord de cette installation.
  3. Sur la page d'aperçu de l'installation, cherchez une section ou un bouton comme "Voir les détails" ("View details").
    Étape info clé API installation
  4. Cliquer dessus ouvre une nouvelle section avec les "Informations sur l'installation" détaillées.
  5. Vous y trouverez la Clé API pour votre installation. Elle ressemble à la clé précédente mais les caractères sont différents.
    Clé API installation
  6. Copiez cette Clé API d'installation. (Dans la configuration de votre intégration EnergyID, entrez-la dans le champ "ID de l'emplacement du service" ("Service Location Id")).

Étape 3 : Configuration de l'intégration dans EnergyID

Une fois que vous avez les trois clés :

  1. Connectez-vous à votre compte EnergyID.
  2. Naviguez vers "Intégrations" et cliquez sur "Ajouter une nouvelle intégration".
  3. Sélectionnez "Solplanet" dans la liste des services.
  4. Ou cliquez ici.
  5. Il vous sera demandé d'entrer les clés collectées :
    • AppKey : Entrez l'AppKey de compte à 9 chiffres de l'Étape 1.
    • ApiKey : Entrez la longue Clé API de compte (Secret) alphanumérique de l'Étape 1.
    • ID de l'emplacement du service : Entrez la longue Clé API d'installation alphanumérique de l'Étape 2.
  6. Sélectionnez le dossier EnergyID ou le relevé auquel vous souhaitez lier les données Solplanet.
  7. Enregistrez l'intégration.

Après l'enregistrement, EnergyID tentera de se connecter à votre installation Solplanet. Vous pourrez alors activer une "Synchronisation des données historiques" pour importer les données de production quotidiennes passées, et une "Synchronisation des nouvelles données" (ou attendre la synchronisation automatique) pour les mises à jour continues.

Si vous rencontrez des problèmes, vérifiez que les trois clés sont correctement copiées et que l'accès à l'API a été entièrement activé par le support Solplanet. Vous pouvez également consulter le statut de la "Dernière requête" sur votre page d'intégration dans EnergyID pour d'éventuels messages d'erreur.