Home Assistant Integration

Verbinde Restlos mit deinem Smart Home und nutze deine Inventardaten für Automationen, Dashboards und mehr.

Übersicht

Die Home Assistant Integration ermöglicht es dir, deine Restlos-Daten in dein Smart Home einzubinden. Die App sendet automatisch Sensordaten an Home Assistant, die du für Dashboards, Automationen und Benachrichtigungen nutzen kannst.

Automatische Synchronisation

Deine Daten werden automatisch an Home Assistant gesendet

Umfangreiche Sensoren

Anzahl Artikel, Inventarwert, ablaufende Items und mehr

Home Assistant vorbereiten

Access Token erstellen

Öffne dein Home Assistant
Gehe zu Profil (unten links auf deinen Benutzernamen klicken)
Scrolle nach unten zu "Langzeit-Zugriffstoken"
Klicke auf "Token erstellen"
Gib einen Namen ein (z.B. "Restlos") und klicke auf "OK"
Kopiere das angezeigte Token (wichtig: es wird nur einmal angezeigt!)

⚠️ Wichtig: Bewahre das Token sicher auf. Es wird nur einmal angezeigt!

Restlos App konfigurieren

Öffne die Restlos App auf deinem iPhone/iPad
Gehe zu Einstellungen → "Home Assistant"
Aktiviere "Home Assistant aktivieren"
Gib deine Home Assistant URL ein:
- http://192.168.1.100:8123 (lokales Netzwerk)
- https://ha.deinedomain.de (extern)
Füge dein Access Token ein
Tippe auf "Verbinden"

💡 Tipp: Bei Problemen mit der Verbindung prüfe, ob du die richtige URL verwendest und ob Home Assistant vom iPhone aus erreichbar ist.

Verfügbare Sensoren

Nach erfolgreicher Verbindung werden automatisch folgende Sensoren erstellt:

Ab Version 2.2

`sensor.iphone_restlos_gesamt`

Gesamtanzahl aller Artikel im Inventar

`sensor.iphone_restlos_produkte`

Anzahl einzigartiger Produkte

`sensor.iphone_restlos_standorte`

Anzahl verwendeter Lagerorte

`sensor.iphone_restlos_inventarwert`

Geschätzter Gesamtwert des Inventars in €

`sensor.iphone_restlos_heute`

Anzahl heute ablaufender Artikel (mit Produktliste als Attribut)

`sensor.iphone_restlos_morgen`

Anzahl morgen ablaufender Artikel (mit Produktliste als Attribut)

`sensor.iphone_restlos_ablaufend`

Anzahl diese Woche ablaufender Artikel (mit Produktliste als Attribut)

`sensor.iphone_restlos_nachstes_ablaufdatum`

Nächstes ablaufendes Produkt mit Details als Attribute

Sensor-Namen für App Version 2.1 (Legacy)

`sensor.iphone_restlos_total_items`

`sensor.iphone_restlos_unique_products`

`sensor.iphone_restlos_locations`

`sensor.iphone_restlos_total_value`

`sensor.iphone_restlos_expiring_today`

`sensor.iphone_restlos_expiring_tomorrow`

`sensor.iphone_restlos_expiring_week`

Dashboard erstellen

Erstelle ein Dashboard um deine Restlos-Daten zu visualisieren.

Dashboard für App Version 2.2+

type: vertical-stack
cards:
  # Inventar Übersicht
  - type: glance
    title: 📦 Inventar
    columns: 4
    entities:
      - entity: sensor.iphone_restlos_gesamt
        name: Gesamt
        icon: mdi:package-variant-closed
      - entity: sensor.iphone_restlos_produkte
        name: Produkte
        icon: mdi:food-apple
      - entity: sensor.iphone_restlos_standorte
        name: Orte
        icon: mdi:map-marker-multiple
      - entity: sensor.iphone_restlos_inventarwert
        name: Wert
        icon: mdi:cash-multiple

  # Ablaufende Artikel
  - type: glance
    title: ⏰ Ablaufende Artikel
    columns: 3
    entities:
      - entity: sensor.iphone_restlos_heute
        name: Heute
        icon: mdi:calendar-alert
      - entity: sensor.iphone_restlos_morgen
        name: Morgen  
        icon: mdi:calendar-clock
      - entity: sensor.iphone_restlos_ablaufend
        name: Diese Woche
        icon: mdi:calendar-week

  # Details - Heute (nur wenn Produkte vorhanden)
  - type: conditional
    conditions:
      - entity: sensor.iphone_restlos_heute
        state_not: "0"
    card:
      type: markdown
      content: |
        ### 🔴 Heute ablaufend ({{ states('sensor.iphone_restlos_heute') }})
        {% set items = state_attr('sensor.iphone_restlos_heute', 'items') %}
        {% if items %}
        {% for item in items %}
        - **{{ item.name }}** ({{ item.location }}) - {{ item.quantity }}x
        {% endfor %}
        {% endif %}

  # Details - Morgen (nur wenn Produkte vorhanden)
  - type: conditional
    conditions:
      - entity: sensor.iphone_restlos_morgen
        state_not: "0"
    card:
      type: markdown
      content: |
        ### 🟠 Morgen ablaufend ({{ states('sensor.iphone_restlos_morgen') }})
        {% set items = state_attr('sensor.iphone_restlos_morgen', 'items') %}
        {% if items %}
        {% for item in items %}
        - **{{ item.name }}** ({{ item.location }}) - {{ item.quantity }}x
        {% endfor %}
        {% endif %}

  # Details - Diese Woche (nur wenn Produkte vorhanden)
  - type: conditional
    conditions:
      - entity: sensor.iphone_restlos_ablaufend
        state_not: "0"
    card:
      type: markdown
      content: |
        ### 🟡 Diese Woche ablaufend ({{ states('sensor.iphone_restlos_ablaufend') }})
        {% set items = state_attr('sensor.iphone_restlos_ablaufend', 'items') %}
        {% if items %}
        {% for item in items %}
        - **{{ item.name }}** ({{ item.location }}) - {{ item.quantity }}x - in {{ item.days_until_expiry }} Tagen
        {% endfor %}
        {% endif %}

Beispiel-Dashboard (Version 2.2)

Home Assistant Dashboard mit Restlos Integration Version 2.2

Dashboard mit Produktlisten und automatischer Anzeige ablaufender Artikel

Dashboard YAML für App Version 2.1 (Legacy)

type: vertical-stack
cards:
  - type: horizontal-stack
    cards:
      - type: entity
        entity: sensor.iphone_restlos_total_items
        name: Artikel gesamt
        icon: mdi:package-variant
      - type: entity
        entity: sensor.iphone_restlos_unique_products
        name: Produkte
        icon: mdi:food-apple
      - type: entity
        entity: sensor.iphone_restlos_locations
        name: Lagerorte
        icon: mdi:home-group

  - type: entity
    entity: sensor.iphone_restlos_total_value
    name: Inventarwert
    icon: mdi:currency-eur

  - type: glance
    title: Ablaufende Artikel
    entities:
      - entity: sensor.iphone_restlos_expiring_today
        name: Heute
      - entity: sensor.iphone_restlos_expiring_tomorrow
        name: Morgen
      - entity: sensor.iphone_restlos_expiring_week
        name: Diese Woche

💡 So verwendest du das YAML:

Öffne Home Assistant
Gehe zu Übersicht → "Dashboard bearbeiten"
Klicke auf "+ Karte hinzufügen"
Wähle "Manuell"
Füge das YAML ein und klicke "Speichern"

Beispiel-Automationen

Benachrichtigung bei ablaufenden Artikeln

Erhalte eine Benachrichtigung, wenn Artikel heute ablaufen:

alias: Restlos - Ablaufende Artikel Benachrichtigung
description: Benachrichtigung wenn Artikel heute ablaufen
trigger:
  - platform: time
    at: "08:00:00"
condition:
  - condition: numeric_state
    entity_id: sensor.iphone_restlos_expiring_today
    above: 0
action:
  - service: notify.mobile_app_iphone
    data:
      title: "⏰ Artikel laufen heute ab!"
      message: >-
        {{ states('sensor.iphone_restlos_expiring_today') }} 
        Artikel laufen heute ab. Schau in Restlos nach!
mode: single

LED-Warnung bei vielen ablaufenden Artikeln

Ändere die Farbe einer Lampe, wenn diese Woche viele Artikel ablaufen:

alias: Restlos - Wochenwarnung LED
description: LED rot wenn viele Artikel diese Woche ablaufen
trigger:
  - platform: numeric_state
    entity_id: sensor.iphone_restlos_expiring_week
    above: 5
action:
  - service: light.turn_on
    target:
      entity_id: light.kuechenlampe
    data:
      rgb_color:
        - 255
        - 0
        - 0
      brightness: 100
mode: single

Fehlerbehebung

🔴 Sensoren erscheinen nicht

Prüfe ob die URL korrekt ist (mit http:// oder https://)
Stelle sicher, dass das Access Token gültig ist
Überprüfe die Netzwerkverbindung
Warte ein paar Minuten - die erste Synchronisation kann etwas dauern

🔴 Verbindungsfehler

Bei externer URL: Prüfe ob HTTPS korrekt konfiguriert ist
Bei lokaler URL: Stelle sicher dass du im selben Netzwerk bist
Firewall-Regeln überprüfen

🔴 Daten werden nicht aktualisiert

Die App synchronisiert automatisch bei Änderungen
Prüfe ob die Integration in den Einstellungen noch aktiv ist
Öffne die App und warte kurz - die Synchronisation sollte starten

Brauchst du Hilfe? Kontaktiere uns über Support