Capfile HA

• Version minimale : 2024.1.0
• Le composant intégré recorder doit être actif (il l'est par défaut dans toute installation standard)
• Une connexion Internet sortante vers api.capfile.com et capfile.com

• Un compte actif sur capfile.com avec vos identifiants (e-mail + mot de passe)
• Au moins un compteur Linky C5 ou P4 associé à votre compte (en propre ou partagé par un autre utilisateur)

Le script s'exécute dans un terminal sur votre machine Home Assistant. Si vous n'avez pas encore accès à un terminal, installez l'add-on officiel :

1. Allez dans Paramètres → Modules complémentaires → Boutique
2. Recherchez Terminal & SSH et installez-le
3. Activez l'option "Afficher dans la barre latérale" pour y accéder facilement
4. Démarrez l'add-on, puis ouvrez son interface Web

Dans l'interface Web du terminal, collez la commande suivante avec Shift + Insert puis appuyez sur Entrée :

curl -fsSL https://capfile.com/capfile/ha/install.sh | bash

Le script télécharge la dernière version du composant, l'installe dans config/custom_components/capfile/ et vous indique la suite à suivre.

Le script redémarre Home Assistant automatiquement en fin d'installation. Une fois HA de retour :

1. Allez dans Paramètres → Appareils et services → Ajouter une intégration et recherchez Capfile
2. Suivez l'assistant de configuration

Option A — Terminal sur l'hôte (recommandée) : accédez via SSH ou localement au serveur qui héberge le conteneur. Le répertoire de configuration HA est monté en volume (chemin défini dans votre docker-compose.yml).

Option B — Shell dans le conteneur :

docker exec -it homeassistant bash

Dans le terminal (hôte ou conteneur), collez et exécutez :

curl -fsSL https://capfile.com/capfile/ha/install.sh | bash

Le script installe les fichiers dans /config/custom_components/capfile/.

Redémarrez le conteneur pour charger le composant :

docker restart homeassistant

Ou depuis l'interface HA : Paramètres → Système → Redémarrer.

Une fois HA de retour, allez dans Paramètres → Appareils et services → Ajouter une intégration et recherchez Capfile.

1. Téléchargez la dernière version depuis capfile.com
2. Copiez le dossier capfile dans le répertoire config/custom_components/ de votre installation Home Assistant
3. Redémarrez Home Assistant, puis ajoutez l'intégration via Paramètres → Appareils et services

La liste déroulante affiche tous les compteurs accessibles avec leur nom et leur PRM. Les compteurs partagés par d'autres utilisateurs sont indiqués avec le suffixe [partagé].

Les champs sont pré-remplis avec les prix fournis par l'API Capfile. Vous pouvez les ajuster librement avant de valider.

• Modification des prix par cadran (en €/kWh) et de l'abonnement mensuel (en €/mois)
• Activation / désactivation de la mise à jour automatique des prix depuis l'API
• Après validation, les capteurs mensuels sont recalculés immédiatement

Si vous avez désactivé cette option, configurez manuellement le tableau de bord via Énergie → Configurer :

1. Consommation réseau : ajoutez chaque statistique capfile:conso_{cadran} et associez-lui la statistique de coût correspondante capfile:cost_{cadran}
2. Production / retour réseau (compteurs P4) : ajoutez chaque statistique capfile:inj_{cadran}

• Vérifiez que la première synchronisation s'est bien terminée (consultez les logs HA en mode debug pour le domaine capfile)
• Attendez quelques minutes après le redémarrage de HA — l'injection dans le recorder est asynchrone
• Si l'option "Configurer automatiquement le dashboard Énergie" n'était pas cochée lors de la configuration, ajoutez manuellement les statistiques capfile:conso_* dans la configuration Énergie ; sinon, patientez quelques instants — la configuration automatique se fait après la première injection de données dans le recorder

C'est normal. Enedis transmet les relevés à Capfile avec environ 48 heures de délai. La donnée la plus récente disponible correspond toujours à J-2 environ.

Les quotas journaliers, hebdomadaires ou mensuels de l'API Capfile Free ont été atteints. Attendez la réinitialisation (minuit pour les quotas journaliers) avant de réessayer.

• Vérifiez et ajustez les tarifs via Paramètres → Appareils et services → Capfile → Configurer
• Pour les abonnements, saisissez le montant TTC de votre abonnement mensuel

Ajoutez dans votre configuration.yaml :

logger:
  default: warning
  logs:
    custom_components.capfile: debug

Redémarrez Home Assistant. Les logs détaillés de chaque appel API et de chaque injection de statistique seront visibles dans Paramètres → Journaux.