Mein Paperless-ngx-Archiv ist auf 694 Dokumente angewachsen \u2013 Rechnungen, Vertr\u00e4ge, Krankenkassen-Belege, Steuerformulare. Bislang lebte das Ganze in einer separaten Welt. Mit der offiziellen Paperless-ngx-Integration in Home Assistant 2025.6 \u00e4ndert sich das: Paperless wird zu einer normalen Datenquelle in HA, mit Sensoren, Events und Ausl\u00f6sern. Das \u00f6ffnet die T\u00fcr f\u00fcr Automationen, die das Papier-Chaos in den Griff bekommen \u2013 und die mit anderen Smart-Home-Bausteinen vernetzen.<\/p>\n
Die Paperless-ngx-Integration legt nach der Einrichtung mehrere Sensoren an. Der wichtigste ist Voraussetzungen sind Paperless-ngx ab Version 2.15 und ein API-Token mit Leserechten auf Dokumente, Tags, Dokumenttypen und Korrespondenten. Das Token erstellt man im Paperless-Frontend unter \u00abMein Profil \u2192 API-Token\u00bb.<\/p>\n In Home Assistant unter Einstellungen \u2192 Ger\u00e4te & Dienste \u2192 Integration hinzuf\u00fcgen<\/strong> \u00abPaperless-ngx\u00bb ausw\u00e4hlen. Im Setup-Dialog werden URL der Paperless-Instanz und der API-Token abgefragt. Mehr braucht es nicht \u2013 die Sensoren erscheinen automatisch.<\/p>\n Das obige Snippet ist n\u00fctzlich, wenn die offizielle Integration die \u00abInbox\u00bb-Tag-Logik nicht so abbildet, wie man sich das w\u00fcnscht. Tag-ID Sobald ein neues Dokument im Paperless-Posteingang landet, soll die Tolomeo-Leselampe orange aufblinken \u2013 als unaufdringlicher Hinweis, dass etwas zu sichten ist.<\/p>\n Die Template-Bedingung pr\u00fcft, ob der Wert wirklich gestiegen ist \u2013 damit das Lichtsignal nicht auch beim Verschieben aus dem Inbox ausl\u00f6st. Die Zeitbedingung verhindert n\u00e4chtliches Blinken.<\/p>\n Spannender wird es, wenn man neue Dokumente nach Korrespondent filtert. Beispiel: Sobald ein Dokument vom Korrespondent \u00abKrankenkasse\u00bb auftaucht, kommt eine Push-Nachricht aufs iPhone mit Link direkt zur Paperless-Vorschau.<\/p>\n Das Ein letzter Klassiker: Wer Paperless-ngx selbst hostet, sollte regelm\u00e4ssig backupen. Der Update-Sensor und ein einfaches Cron-Trigger zusammen ergeben einen w\u00f6chentlichen Hinweis im Mobile-App-Banner \u2013 inklusive der Information, wie viele neue Dokumente seit dem letzten Backup dazugekommen sind. Das spart Diskussionen mit dem inneren Schweinehund.<\/p>\n Mit der nativen Paperless-ngx-Integration wird das Dokumenten-Archiv endlich Teil des Smart Homes. Drei Automationen reichen, um den Workflow sp\u00fcrbar zu beschleunigen: Lichtsignal bei neuem Posteingang, gezielte Push-Nachrichten pro Korrespondent und ein Backup-Reminder. Wer schon ein bestehendes Setup mit Sensoren f\u00fcr andere Bereiche hat \u2013 etwa mein Setup mit Shelly Plus 1 PM<\/a> zum Energie-Monitoring \u2013 kann Paperless mit derselben Logik in Dashboards einbauen. Die Mushroom-Card auf dem Wohnzimmer-Tablet zeigt jetzt zwei Zahlen nebeneinander: Stromverbrauch heute und Inbox-Dokumente. Das f\u00fchlt sich an wie eine Mini-Mission-Control \u2013 nur ohne Mission.<\/p>\n","protected":false},"excerpt":{"rendered":" Mein Paperless-ngx-Archiv ist auf 694 Dokumente angewachsen \u2013 Rechnungen, Vertr\u00e4ge, Krankenkassen-Belege, Steuerformulare. Bislang lebte das Ganze in einer separaten Welt. Mit der offiziellen Paperless-ngx-Integration in Home Assistant 2025.6 \u00e4ndert sich das: Paperless wird zu einer normalen Datenquelle in HA, mit Sensoren, Events und Ausl\u00f6sern. Das \u00f6ffnet die T\u00fcr f\u00fcr Automationen, die das Papier-Chaos in den … Weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-497","post","type-post","status-publish","format-standard","hentry","category-ha"],"_links":{"self":[{"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/posts\/497","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/comments?post=497"}],"version-history":[{"count":1,"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/posts\/497\/revisions"}],"predecessor-version":[{"id":502,"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/posts\/497\/revisions\/502"}],"wp:attachment":[{"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/media?parent=497"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/categories?post=497"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.coremind.ch\/wordpress\/wp-json\/wp\/v2\/tags?post=497"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}sensor.paperless_gesamt<\/code>, der die Gesamtanzahl der Dokumente zeigt. Bei mir steht der auf 694. Dazu kommen Sensoren f\u00fcr offene Aufgaben (Inbox-Tag), Speicherauslastung, Letztes-Dokument-Datum sowie ein Update-Sensor, der meldet, wenn eine neue Paperless-Version verf\u00fcgbar ist. Wer Admin-Rechte im Paperless vergibt, bekommt zus\u00e4tzlich diagnostische Sensoren f\u00fcr Worker-Status und Queue-L\u00e4nge.<\/p>\nSchritt f\u00fcr Schritt: Integration einrichten<\/h2>\n
\r\n# configuration.yaml \u2013 optionaler manueller Sensor als Backup\r\n# (nur falls die Integration einmal hakt)\r\nsensor:\r\n - platform: rest\r\n name: paperless_inbox\r\n resource: https:\/\/paperless.local\/api\/documents\/?tags__id=2\r\n headers:\r\n Authorization: \"Token DEIN_TOKEN_HIER\"\r\n Accept: \"application\/json\"\r\n value_template: \"{{ value_json.count }}\"\r\n scan_interval: 600\r\n<\/code><\/pre>\n2<\/code> muss durch die eigene ID des Inbox-Tags ersetzt werden.<\/p>\nAutomation 1: Hue-Lampe als Inbox-Lichtsignal<\/h2>\n
\r\n# automations.yaml\r\n- alias: Paperless Inbox \u2013 Lichtsignal\r\n trigger:\r\n - platform: state\r\n entity_id: sensor.paperless_inbox\r\n condition:\r\n - condition: template\r\n value_template: >\r\n {{ trigger.from_state.state | int(0) < trigger.to_state.state | int(0) }}\r\n - condition: time\r\n after: \"08:00:00\"\r\n before: \"21:00:00\"\r\n action:\r\n - service: light.turn_on\r\n target:\r\n entity_id: light.tolomeo\r\n data:\r\n color_name: orange\r\n brightness_pct: 60\r\n - delay: \"00:00:05\"\r\n - service: light.turn_off\r\n target:\r\n entity_id: light.tolomeo\r\n<\/code><\/pre>\nAutomation 2: Push-Benachrichtigung f\u00fcr Rechnungen<\/h2>\n
\r\n- alias: Paperless \u2013 neue Krankenkassen-Rechnung\r\n trigger:\r\n - platform: event\r\n event_type: paperless_document_added\r\n event_data:\r\n correspondent: Krankenkasse\r\n action:\r\n - service: notify.mobile_app_iphone_17_pro\r\n data:\r\n title: \"Neue Krankenkassen-Rechnung\"\r\n message: \"{{ trigger.event.data.title }}\"\r\n data:\r\n url: \"https:\/\/paperless.local\/documents\/{{ trigger.event.data.id }}\/\"\r\n<\/code><\/pre>\npaperless_document_added<\/code>-Event wird von der HA-Integration ausgel\u00f6st, sobald ein neues Dokument indexiert wurde. Damit f\u00e4llt das aufw\u00e4ndige Polling weg.<\/p>\nAutomation 3: W\u00f6chentlicher Backup-Reminder<\/h2>\n
Fazit<\/h2>\n