Intégration externe : Stock pellets

Je chauffe au poêle à pellets, et j’en avais assez d’aller compter les sacs au garage pour savoir s’il fallait recommander. J’ai donc développé une intégration externe pour Gladys : Stock de pellets.

Elle suit votre stock de granulés : livraisons, consommation, consommation moyenne par jour, autonomie restante et, si vous indiquez le prix d’une palette, la valeur du stock et le coût par mois. Il n’y a aucun matériel à installer ni aucun compte en ligne à créer. L’intégration tient simplement un registre des mouvements de sacs et calcule tout le reste à partir de là.

Tout se passe dans un widget sur le tableau de bord. Vous y voyez votre stock (vert, puis orange sous le seuil de stock bas, rouge à zéro), votre autonomie en jours, la date à laquelle commander et un graphique de l’évolution du stock ou des sacs utilisés par jour. Au quotidien, il suffit d’appuyer sur « −1 sac » à chaque remplissage du poêle et sur « Palette livrée » à chaque livraison.

L’intégration s’utilise aussi dans les scènes. Par exemple, un bouton Zigbee posé à côté du poêle peut retirer un sac à chaque appui, et Gladys peut vous envoyer un message quand le stock devient bas. Si vous avez une résidence secondaire, vous pouvez suivre plusieurs stocks séparément.

Actions de scène

  • Utiliser des sacs de pellets : retire des sacs du stock. Par exemple, un bouton Zigbee à côté du poêle retire un sac à chaque appui.
  • Ajouter des sacs de pellets : ajoute des sacs, pour une livraison ou des sacs achetés à l’unité.
  • Corriger le stock de pellets : remplace le stock par le nombre de sacs que vous avez comptés.
  • Lire le stock de pellets : ne modifie rien et transmet les chiffres à la suite de la scène, par exemple pour un message hebdomadaire.

Chaque action transmet aux actions suivantes les sacs restants, l’autonomie, les sacs par jour, les jours avant de commander et le poids restant.

Déclencheurs

  • Stock de pellets bas : le stock atteint le seuil de stock bas. Il se déclenche une seule fois, au moment où le stock passe le seuil, et pas à chaque sac en dessous.
  • Stock de pellets épuisé : le dernier sac a été utilisé.
  • Palette de pellets livrée : une livraison de plusieurs sacs a été enregistrée.

N’hésitez pas si vous avez des retours ou des idées !

Super @Will_71 , c’est exactement ce que je recherchais :star_struck:
Et je l’ai même installé avant que tu en parles en le voyant dans les nouveautés :wink:
Pépite question par rapport au coût : si tu mets un tarif, il s’applique à ton stock ?
Si tu ajoutes une autre palette avec un autre tarif, comment c’est géré : le tarif ne s’applique que pour ce nouvel ajout ou sur la totalité du stock ; abouchiez + nouveau) ?

Ce que je cherche à savoir une fois terminé une palette au tarif A ça passe tout seul à la seconde palette avec son tarif B.
:face_with_raised_eyebrow: pas sûr d’être très clair, dis-moi si besoin de reformuler.

Oui, j’avais un truc bricolé de mon côté, alors quand les widgets sont apparus, c’était le moment de basculer et faire l’intégration.

Pour le coût, pour l’instant, si tu changes le prix, ça s’applique à tout le stock. C’était pas ma priorité pour l’instant, donc je n’ai pas trop développé, mais c’est un point à améliorer. Je voulais aussi pouvoir mettre un prix au sac, mais je suis embêté avec les décimales dans le formulaire.

Là, je finis la PR sur le thermostat et je ferai des modifications pour améliorer la gestion des coûts.

@mutmut, j’ai réfléchi pour mettre à jour le prix de la palette et pour l’instant je n’ai pas trouvé de solution qui me plaît. Si jamais tu as une idée.

Pour faire le calcul, pas de problème, mais c’est pour renseigner le prix de la palette. Pour le prix au sac, il faut qu’on fasse une modification des formulaires car je ne peux pas mettre de décimal.

Ce qui me dérange actuellement, c’est que je ne peux pas mettre de formulaire dans le widget pour indiquer le nouveau prix et aller dans les configurations pour changer le prix avant de cliquer sur le bouton prévu sur le widget. Je trouve cela plutôt chiant.

Si tu as des idées, je suis preneur.

J’y réfléchis cette semaine, pas eu le temps ce WE.

Salut @Will_71 ,

j’ai vu que tu avais avancé sur le bouton « form » que PG a mis en place sur le dev, ça me plaît beaucoup et c’est un peu à ça que je pensais.

J’ai vu la valeur du stock et poids restants, c’est bien.
On pourrait aussi avoir le nombre de sacs restants.
Par contre il faudrait avoir une variable complémentaire qui est le poids d’un sac lors d’une livraison :

  • nombre de sacs (ou en vrac par camion pour ceux qui ont des chaudières à bois en alimentation continu)
  • poids d’un sac (15kg, 8kg, autre…) ou de la livraison (en vrac avec 3 tonnes par ex)
  • coût de la livraison
    → Ça permettrait d’avoir le coût au kg ou par sac

Après est-ce que l’on pourrait faire une analyse de coût sur une période ?
Mon besoin : du 1/10/26 au 1/06/27, je veux connaître le coût de mon chauffage sachant que j’ai utilisé 40 sacs à un coût X achetés en 2025 et que j’ai mis en plus 60 sacs à un tarif Y.
Tu penses que c’est possible ?
Dans ma tête c’est attribuer à chaque sac un coût mais la solution est peut-être bien plus simple (Claude, Claude, t’es là ? :joy: ).

Oui, tes remarques sont pertinentes. Pour le poids du sac, c’est prévu, mais comme il y avait un bug avec les décimales, c’est pour cela que j’avais mis le poids de la palette pour l’instant. Mais je le rajouterai, c’est obligatoire.

Pour la gestion des prix, pour l’instant, je ne sais pas encore trop comment je vais gérer cela.

Je demanderai à Claude comment gérer cela au mieux. Je te tiendrai au courant.

Merci Will pour cette intégration, c’est exactement ce que je voulais me bricoler sur Excel :wink:

La version 1.3.0 de l’intégration Stock de pellets est disponible. Elle reprend une bonne partie de vos retours, notamment ceux de @mutmut sur les prix et le poids des sacs.

Ce qui change

  • Livraison avec son prix : « Palette livrée » ouvre un formulaire avec le nombre de sacs, le prix payé et le poids d’un sac. « Ajouter sac(s) » demande le prix au sac.
  • Coût premier entré, premier sorti : chaque sac utilisé coûte le prix auquel il a été acheté. Le widget affiche le coût de la saison, et l’action « Analyser le coût » donne les sacs, les kg et le coût sur une période (par exemple du 01/10/2026 au 01/06/2027).
  • Un stock par maison : « Ajouter un stock » propose les maisons de Gladys, et « Régler un stock » donne à un stock ses propres réglages (sacs de 10 kg au chalet, par exemple).
  • Silo de pellets en vrac, compté en kg, avec son widget (livraison, relevé de niveau en kg ou en %) et son appareil.
  • Allemand et espagnol, en plus du français et de l’anglais, et un réglage « Langue des noms d’appareils » pour les noms proposés dans l’onglet Découverte.
  • Les deux widgets se rafraîchissent dès qu’un stock ou un appareil est ajouté.

Actions requises

  • Gladys 5.2.0 minimum (au lieu de 5.1.0) : les formulaires des boutons du widget et la liste des maisons en ont besoin. Sur Gladys 5.1, l’intégration reste en 1.2.0 et la mise à jour ne sera pas proposée.
  • Aucun appareil à recréer : les appareils, l’historique, les scènes et les widgets existants restent tels quels.
  • Si vous aviez ajouté un stock avec un nom, vous pouvez le rattacher à une maison avec « Rattacher un stock à une maison ». Il garde son appareil et son historique.
  • Les noms d’appareils proposés dans Découverte restent en anglais tant que vous ne choisissez pas une autre langue dans la configuration.

La nouvelle version apparaîtra dans le store dans la journée, le temps de l’indexation.

Pour un retour ou un bug

Une issue sur GitHub (Issues · William-De71/gladys-pellet-stock · GitHub) ou une réponse ici, avec :

  • la version de Gladys et celle de l’intégration ;
  • les logs du conteneur de l’intégration, idéalement avec la variable d’environnement DEBUG=gladys-integration-sdk.

La version 1.4.0 de l’intégration Stock de pellets est disponible.

Ce qui change

  • Nouveau widget « Prix des pellets », pour un stock de sacs ou un silo (en € la tonne) :
    • le dernier prix payé et son évolution sur un an (orange s’il monte, vert s’il baisse) ;
    • la courbe du prix au sac d’une livraison à la suivante, sur 1, 3 ou 5 ans ;
    • une ligne par saison de chauffe, jusqu’à cinq saisons, pour comparer d’une année sur l’autre : ce qu’ont coûté les sacs utilisés (premier entré, premier sorti), leur nombre et le prix moyen d’un sac. La saison commence en octobre par défaut, c’est réglable dans le widget.
  • Noms d’appareils dans votre langue : Gladys ne donne la langue de l’utilisateur à une intégration que lorsqu’il affiche un widget. Par défaut, les noms proposés dans l’onglet Découverte suivent donc la langue du dernier utilisateur qui a affiché un widget de l’intégration. Le réglage « Langue des noms d’appareils » permet toujours d’imposer une langue.
  • La documentation montre maintenant les widgets dans les quatre langues (illustrations générées à partir du code de l’intégration).

Actions requises

  • Aucune : rien à recréer, les appareils, l’historique, les scènes et les widgets existants restent tels quels.
  • Le widget « Prix des pellets » s’ajoute comme les autres (modifier le tableau de bord → ajouter une boîte). Il ne montre des chiffres qu’une fois au moins une livraison saisie avec son prix.
  • Si vous aviez enregistré la configuration en 1.3.0, le réglage de langue est resté sur « Anglais » : choisissez « Langue de l’utilisateur » pour en profiter.

Gladys 5.2.0 minimum, comme pour la 1.3.0. La nouvelle version apparaîtra dans le store dans la journée, le temps de l’indexation.

Pour un retour ou un bug

Une issue sur GitHub (Issues · William-De71/gladys-pellet-stock · GitHub) ou une réponse ici, avec :

  • la version de Gladys et celle de l’intégration ;
  • les logs du conteneur de l’intégration, idéalement avec la variable d’environnement DEBUG=gladys-integration-sdk.