Zum Hauptinhalt springen

Gaz de Bordeaux Smart-Home-Integration, kostenlos und Open Source

Gaz de Bordeaux-Integration für Gladys Assistant

Gas- und Stromverbrauch samt Kosten aus Ihrem Gaz de Bordeaux Kundenkonto.

Auf GitHub ansehenAlle Integrationen

Diese Integration verbindet Gladys mit Ihrem Gaz de Bordeaux Kundenkonto (life.gazdebordeaux.fr). Sie liest dort Ihren Gas- und Stromverbrauch samt Kosten, um sie in Gladys anzuzeigen, als Diagramm darzustellen und Szenen auszulösen.

Sie arbeitet über das Internet (Abzeichen Cloud): nichts zu Hause zu installieren, kein Modul am Zähler.

Bevor Sie beginnen​

  • Sie brauchen ein Konto auf life.gazdebordeaux.fr, das Ihren Verbrauch anzeigt. Melden Sie sich einmal im Browser an, um es zu prüfen.
  • Gaz de Bordeaux veröffentlicht den Verbrauch eines Tages ein bis zwei Tage später (so lange braucht der Gazpar- oder Linky-Zähler). Gladys zeigt daher immer den letzten gelesenen Tag, nicht heute.
  • Gladys 5.2 oder neuer ist erforderlich.

Konfiguration​

  1. Öffnen Sie den Reiter Konfiguration der Integration.
  2. Geben Sie E-Mail und Passwort Ihres Kundenkontos ein.
  3. Bei Bedarf anpassen:
    • Aktualisierungsintervall (Stunden): wie oft das Kundenkonto gelesen wird, standardmäßig alle 6 Stunden (1 bis 24). Die Werte ändern sich nur einmal am Tag: kürzer bringt nichts.
    • Zu importierende Tage: vergangene Tage, die beim Anlegen eines Geräts an Gladys gesendet werden, standardmäßig 30 (bis 90), damit die Diagramme nicht leer beginnen.
    • Gas-/Strom-Warnschwelle (kWh/Tag): darüber wird der Auslöser „Hoher Tagesverbrauch“ ausgelöst. 0 schaltet ihn ab.
  4. Speichern. Die Schaltfläche Verbindung testen prüft E-Mail und Passwort und listet die gefundenen Verträge.
  5. Öffnen Sie den Reiter Entdeckung: pro Vertrag wird ein Gerät angeboten („Gaz de Bordeaux – Gaz“, „Gaz de Bordeaux – Électricité“). Fügen Sie die gewünschten hinzu.

Das Passwort ist ein geheimes Feld: es wird nie in die Logs geschrieben.

Was Sie erhalten​

Jedes „Vertrag“-Gerät trägt schreibgeschützte Sensoren:

FunktionEinheitVertragWert
Verbrauch des gelesenen TageskWhalleein Wert pro Tag, auf diesen Tag datiert
Kosten des gelesenen Tages€alleein Wert pro Tag, auf diesen Tag datiert
Gasvolumen des gelesenen Tagesm³Gasein Wert pro Tag, auf diesen Tag datiert
MonatsverbrauchkWhalleseit dem 1. des Monats
Monatskosten€alleseit dem 1. des Monats
JahresverbrauchkWhalleJahressumme laut Gaz de Bordeaux
Jahreskosten€alleJahressumme laut Gaz de Bordeaux
TagesverbrauchkWhStroman das Energie-Modul von Gladys gesendet

Tageswerte sind auf den Tag datiert, den sie beschreiben, nicht auf den Zeitpunkt des Lesens: das Diagramm zeigt den Verbrauch vom Montag am Montag, auch wenn er am Mittwoch ankam.

Beim Anlegen eines Geräts werden die letzten Tage importiert (siehe Zu importierende Tage). Sie werden nie doppelt gesendet, auch nicht nach einem Neustart.

Das Verbindungsabzeichen​

  • Cloud: das letzte Lesen war erfolgreich.
  • Cloud mit orangem Punkt: das Kundenkonto antwortet, aber der letzte Wert ist älter als 4 Tage. Der Zähler meldet vielleicht nicht mehr: prüfen Sie ihn auf der Website von Gaz de Bordeaux.
  • Nicht erreichbar: das letzte Lesen ist fehlgeschlagen (siehe „Fehlerbehebung“).

Aktionen​

  • Verbindung testen: meldet sich mit der eingegebenen E-Mail und dem Passwort an und listet die gefundenen Verträge.
  • Jetzt aktualisieren: liest das Kundenkonto sofort und nennt den letzten gelesenen Tag.
  • Meine Vertragspreise: zeigt die aktuellen Preise Ihrer Verträge, wie espaceclient.gazdebordeaux.fr sie angibt (siehe „Energieverträge“).

Szenen​

Die Integration fügt ihre Karten dem Szenen-Editor hinzu, unter Integrationen.

Auslöser​

  • Neuer Tageswert: Gaz de Bordeaux hat einen neuen Tag veröffentlicht. Optional auf einen Vertrag oder eine Energie filtern. Die folgenden Aktionen können {{triggerEvent.data.date}}, {{triggerEvent.data.kwh}}, {{triggerEvent.data.cost}} und {{triggerEvent.data.volume}} (Gas) lesen.
  • Hoher Tagesverbrauch: der neue Tag liegt über der in der Konfiguration eingestellten Warnschwelle. Variablen: date, kwh, threshold.
  • Kundenkonto nicht erreichbar: das Lesen ist fehlgeschlagen, nachdem es funktioniert hatte. Auf die Ursache filtern (Anmeldung abgelehnt, Anfrage blockiert, Netzwerk, unerwartete Antwort, kein Vertrag). Variablen: reason, message.
  • Vertragspreise geändert: ein aktueller Preis auf espaceclient.gazdebordeaux.fr hat sich geändert (kWh, HT/NT oder Grundgebühr, brutto). Optional auf die Energie filtern. Variablen: offer, kwh_price, peak_price, off_peak_price, subscription und der bisherige Wert von jedem (previous_kwh_price…). Die Preise werden bei jeder Aktualisierung gelesen und so verglichen, wie die Website sie angibt: kein Fehlalarm durch Rundung. Die Meldung kommt, sobald die Website den neuen Preis zeigt.

Ein Tag oder eine Preisänderung wird nur einmal gemeldet, auch nach einem Neustart. Beim allerersten Lesen wird nichts gemeldet: nur die folgenden Änderungen.

Beispiel: Vertragspreise geändert, dann Nachricht senden „Neuer Preis Gaz de Bordeaux: {{triggerEvent.data.kwh_price}} €/kWh (vorher {{triggerEvent.data.previous_kwh_price}}), Grundgebühr {{triggerEvent.data.subscription}} €/Monat“. Legen Sie dann einen neuen Gladys-Energievertrag an (siehe „Wenn sich Ihre Preise ändern“).

Aktionen​

  • Gaz de Bordeaux Werte aktualisieren: liest das Kundenkonto sofort. Ausgaben: success und contracts (Anzahl gelesener Verträge).
  • Gaz de Bordeaux Verbrauch abrufen: Vertrag und Zeitraum wählen (letzter gelesener Tag, dieser Monat, dieses Jahr). Ausgaben: kwh, cost, volume, date und available (falsch, wenn keine Daten). Praktisch für eine Nachricht „Gestern: 42 kWh, 5,10 €“.

Beispiel: jeden Morgen um 8 Uhr Verbrauch abrufen (letzter gelesener Tag), dann Nachricht senden „Gas am {{date}}: {{kwh}} kWh, {{cost}} €“.

Dashboard​

Fügen Sie das Widget Gaz de Bordeaux Verbrauch einem Dashboard hinzu. Es zeigt:

  • Verbrauch und Kosten des letzten gelesenen Tages und des Monats;
  • ein Balkendiagramm der letzten 30 Tage;
  • die Energie, den letzten gelesenen Tag, das Gasvolumen, den aktuellen Preis (von espaceclient), die Jahressumme, die Uhrzeit des letzten Lesens und den Verbindungszustand;
  • eine Schaltfläche Aktualisieren.

Wählen Sie in den Widget-Einstellungen den anzuzeigenden Vertrag; leer gelassen ist es der erste.

Energieverträge (Strom)​

Die Integration fügt dem Vertragsassistenten von Gladys (Energie → Vertrag des Zählers) Vertragsvorlagen hinzu, damit Gladys die Kosten Ihres Stroms zu den Preisen von Gaz de Bordeaux berechnet. Eine Vorlage pro Angebot und Option:

AngebotPreiseVorlagen
NovaFixe Élec3 Jahre ab Vertragsabschluss fest, 10 % unter dem regulierten TarifBase, HT/NT
NovaFixe Bonus Élecwie NovaFixe, plus 100 € Bonus im ersten JahrBase, HT/NT
NovaFlex Élecan den regulierten Tarif (TRV) gebunden, kWh ohne Steuern 5 % darunterBase, HT/NT

Ihr Angebot ist nicht in der Liste? (zum Beispiel Ecodigo Elec oder ein älteres, nicht mehr verkauftes Angebot): Wählen Sie die Vorlage Mein Vertrag (unten), sie passt zu jedem Angebot. Ihr Angebot steht in Ihrem Kundenkonto, Zeile „Votre tarif“.

Am einfachsten: die Vorlagen „Mein Vertrag“​

Die Vorlagen Gaz de Bordeaux – Mein Vertrag – Base und – HT/NT nehmen Ihre eigenen Preise, für jedes Angebot (Ecodigo, NovaFixe, NovaFlex…). Es sind die Ihres Kundenkontos (espaceclient.gazdebordeaux.fr, Zeile „Votre prix actuel“), die die Schaltfläche Meine Vertragspreise nennt:

  1. Auf Meine Vertragspreise klicken (Reiter Konfiguration der Integration).
  2. In Gladys Energie → Vertrag des Gaz de Bordeaux Stromzählers, die Vorlage Mein Vertrag Ihrer Option wählen (Base oder HT/NT).
  3. Die Preise der Schaltfläche eingeben: kWh-Preis (HT/NT: HT- und NT-Preis und die Niedertarifzeiten) und Grundgebühr pro Monat.

Die Preise stehen im Vertrag, wie bei den anderen Vorlagen: der Assistent und das JSON des Vertrags zeigen sie. Gladys erlaubt einer Integration nicht, den Assistenten auszufüllen: sie werden also einmal eingegeben. Ändern sie sich, meldet es der Szenen-Auslöser Vertragspreise geändert: legen Sie einen neuen Vertrag an (siehe „Wenn sich Ihre Preise ändern“).

Ihre Preise: die Schaltfläche „Meine Vertragspreise“​

Ein Festpreisangebot behält den Preis des Abschlusstages, ein indexiertes Angebot (Ecodigo Elec) ändert sich mit Steuern und Markt: Ihr Preis ist nicht unbedingt der der heutigen Preisliste. Die Schaltfläche Meine Vertragspreise (Reiter Konfiguration) liest Ihre aktuellen Preise auf espaceclient.gazdebordeaux.fr (gleiche E-Mail und gleiches Passwort), Zeile „Votre prix actuel“ der Seite Ihres Vertrags, und gibt sie unverändert an, ohne Berechnung. Beispiel:

Strom, OFFRE ECODIGO ELEC 100% ÉLECTRICITÉ VERTE (BASE, 6 kVA): 0.160164 €/kWh, Grundgebühr 15.87 €/Monat.

Es sind Bruttopreise (inkl. MwSt. und Abgaben: CTA in der Grundgebühr, Verbrauchsteuer im kWh-Preis), wie in den Verträgen von Gladys. Übernehmen Sie sie in den Vertragsassistenten von Gladys (Vorlage Mein Vertrag oder die Ihres Angebots). Geben Sie sie mit Punkt ein (15.87), wie die Schaltfläche sie schreibt: ein eingefügtes Komma kann vom Feld entfernt werden (15,87 wird 1587, eine Grundgebühr von etwa 51 € pro Tag im Energiediagramm). Ist das passiert, korrigieren Sie den Preis im Vertrag: das ist ein Tippfehler, keine Preisänderung.

Für einen Stromvertrag gibt die Schaltfläche diese Preise auch als Gladys-Tarif (JSON) an, bereit zum Einfügen, wo Gladys den Tarif eines Vertrags verlangt. Es ist der Tarif, den ein Vertrag Mein Vertrag erhält. Bei HT/NT kommt eine Niedertarif-Regel mit Ihren Zeiten hinzu (wenn espaceclient sie angibt).

{
  "tariff_version": 1,
  "components": [
    { "key": "energy", "kind": "consumption", "rules": [], "fallback": { "price": 0.160164 } },
    { "key": "subscription", "kind": "fixed", "amount": 15.87, "per": "month" }
  ]
}

Kann das Kundenkonto nicht gelesen werden, sagt die Schaltfläche es: Übernehmen Sie die Preise dann von der Seite Ihres Vertrags auf espaceclient.gazdebordeaux.fr.

Wenn sich Ihre Preise ändern​

Lassen Sie das Enddatum Ihres Gladys-Vertrags leer, solange sich Ihre Preise nicht ändern. Sie können sich unterwegs ändern: neue Preisliste (NovaFlex, Ecodigo Elec, Ende einer Festpreisperiode) oder eine Steuer (Verbrauchsteuer, MwSt.), die den Bruttopreis ändert. Gaz de Bordeaux informiert Sie, ebenso der Szenen-Auslöser Vertragspreise geändert; die Schaltfläche Meine Vertragspreise gibt dann die neuen Preise an.

  1. Setzen Sie beim aktuellen Vertrag das Enddatum auf den Tag vor der Änderung.
  2. Legen Sie einen neuen Vertrag an, der am Tag der Änderung beginnt, mit den neuen Preisen.

So behalten die vergangenen Tage ihre alten Preise. Ändern Sie nicht die Preise des bestehenden Vertrags: Gladys würde die gesamte Historie seit Vertragsbeginn mit dem neuen Preis neu berechnen.

Die Standardpreise: die offiziellen Preislisten​

Die vorgeschlagenen Standardwerte sind die der offiziellen Preislisten von Gaz de Bordeaux (brutto, hier die vom 1. Oktober 2026). Sie werden jeden Monat von gazdebordeaux.fr geladen: ändert sich ein Preis, bietet eine neue Version der Integration die neuen Preise für danach angelegte Verträge an. Ein bereits angelegter Vertrag behält seine Preise: siehe Wenn sich Ihre Preise ändern.

LeistungGrundgebühr / MonatNovaFixe: kWh BaseNovaFixe: HT / NTNovaFlex: kWh BaseNovaFlex: HT / NT
3 kVA12,130,18373–0,19190–
6 kVA15,870,183730,19648 / 0,146690,191900,20536 / 0,15280
9 kVA19,880,182330,19648 / 0,146690,190420,20536 / 0,15280
12 kVA23,760,182330,19648 / 0,146690,190420,20536 / 0,15280
15 kVA27,400,182330,19648 / 0,146690,190420,20536 / 0,15280
18 kVA31,14–0,19648 / 0,14669–0,20536 / 0,15280
24 kVA39,13–0,19648 / 0,14669–0,20536 / 0,15280
30 kVA46,46–0,19648 / 0,14669–0,20536 / 0,15280
36 kVA53,88–0,19648 / 0,14669–0,20536 / 0,15280

Die Grundgebühr ist bei allen drei Angeboten gleich. NovaFixe Bonus Élec hat die Preise von NovaFixe Élec.

Gut zu wissen​

  • Base funktioniert mit dem Tagesverbrauch, den diese Integration an das Energie-Modul sendet.
  • HT/NT braucht einen halbstündlichen Verbrauch (ein Linky-Zähler, der von einer anderen Integration alle 30 Minuten gelesen wird). Mit dem Tagesverbrauch allein kann Gladys nicht wissen, welche kWh im Niedertarif lagen: verwenden Sie diese Vorlage dann nicht.
  • Gas ist nicht betroffen: die Energieverträge von Gladys gelten nur für Strom. Die Gaskosten bleiben die von Gaz de Bordeaux gelieferten (Funktionen „Kosten des gelesenen Tages“, „Monatskosten“…).

Fehlerbehebung​

Die Statusmeldung im Reiter Konfiguration sagt, was nicht stimmt:

  • Anmeldung abgelehnt: E-Mail oder Passwort falsch. Verwenden Sie die von life.gazdebordeaux.fr und prüfen Sie die Anmeldung im Browser.
  • Die Website hat die Anfrage blockiert: die Website von Gaz de Bordeaux filtert manchmal automatische Anfragen. Die Integration versucht es bei der nächsten Aktualisierung erneut; hält es an, eröffnen Sie ein Issue im GitHub-Repository.
  • Nicht erreichbar: Gladys hat keinen Internetzugang oder die Website ist ausgefallen.
  • Kein Vertrag: das Konto hat keinen sichtbaren Gas- oder Stromvertrag.

Die Logs der Integration (Gladys → Integrationen → Gaz de Bordeaux → Logs) geben Details. Sie enthalten nie das Passwort oder das Sitzungs-Token.

Diese Integration wird nicht von Gaz de Bordeaux herausgegeben: sie liest dieselben Daten wie Ihr Kundenkonto. Ändert sich die Website, kann sie bis zu einem Update ausfallen.

Konfigurationseinstellungen​

Diese Einstellungen fragt Gaz de Bordeaux in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinGeben Sie die E-Mail-Adresse und das Passwort Ihres Gaz de Bordeaux Kundenkontos ein (die der Website life.gazdebordeaux.fr). Die Integration liest dort mehrmals täglich Ihren Verbrauch: Gaz de Bordeaux veröffentlicht den Wert eines Tages ein bis zwei Tage später. Pro Vertrag (Gas, Strom) wird ein Gerät angeboten.
E-MailstringJaDie E-Mail-Adresse, mit der Sie sich bei Ihrem Gaz de Bordeaux Kundenkonto anmelden.
PasswortsecretJa
Aktualisierungsintervall (Stunden)numberNeinWie oft das Kundenkonto gelesen wird. Die Werte ändern sich einmal am Tag: alle 6 Stunden genügt.
Zu importierende TagenumberNeinTageswerte, die beim Anlegen eines Geräts in Gladys importiert werden, damit seine Diagramme nicht leer beginnen.
Gas-Warnschwelle (kWh/Tag)numberNeinDer Szenen-Auslöser „Hoher Tagesverbrauch“ wird ausgelöst, wenn ein Gastag darüber liegt. 0 schaltet ihn ab.
Strom-Warnschwelle (kWh/Tag)numberNeinDer Szenen-Auslöser „Hoher Tagesverbrauch“ wird ausgelöst, wenn ein Stromtag darüber liegt. 0 schaltet ihn ab.

So installierst du Gaz de Bordeaux in Gladys​

  1. Öffne in Gladys Integrationen: Gaz de Bordeaux erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-gazdebordeaux:1.0.10) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-gazdebordeaux.

Gaz de Bordeaux benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Gaz de Bordeaux ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am