[Beta] Paket Tracker – DHL, DPD, GLS, Hermes, UPS, Amazon & eBay in einer Karte – Tester gesucht

[SoerenKaiser99]

Hallo zusammen,

ich war es leid, ständig in verschiedenen Apps Zustelltage und -zeiten zu checken. Also habe ich mir eine Integration gebaut, die mir die Frage „Kommt heute was, und wann?“ direkt in Home Assistant beantwortet. Seit ein paar Tagen testen die ersten mit, und ich suche weitere Tester.

!([Screenshot der Karte einfügen: docs/images/karte-hell.png aus dem Repo])

**Was sie kann**

- **Sendungsnummer eintragen, fertig:** DHL, DPD, GLS, Hermes und UPS. Der Carrier wird meist automatisch erkannt.

- **Amazon und eBay ohne Login:** Pakete entstehen von selbst aus den Versandmails. Damit tauchen auch Amazon-Lieferungen auf, für die es sonst keine Sendungsverfolgung gibt.

- **Eigene Dashboard-Karte:** Liefertag, Zeitfenster, letzter Ort, Fortschrittsbalken und Verlauf zum Aufklappen. Oben drei Felder: „heute“, „möglich“ und „zugestellt“. Die Eingabe versteckt sich hinter einem kleinen Plus-Knopf.

- **Push aufs Handy:** „ Druckerpatronen (DHL) ist in Zustellung – heute 14–16 Uhr“ und „ … wurde zugestellt“. Ziel und Ereignisse einfach anklicken, ohne Automation. Geht mit der HA-App, Telegram, Pushover und allem, was HA als Benachrichtigungsziel kennt.

- **Für Automationen:** ein Sensor pro Paket, `sensor.pakete_heute`, ein Kalender, ein Event bei jeder Statusänderung und ein Blueprint.

- **Optional 17track** auf Knopfdruck für Carrier, die nicht direkt unterstützt werden.

- **Lokal:** kein Cloud-Konto, kein fremder Tracking-Dienst nötig.

**Wie der Mail-Import funktioniert**

Die Integration liest nicht euer Hauptpostfach. Ihr legt ein eigenes kleines Paket-Postfach an und leitet per Filterregel nur die Versandmails dorthin weiter. Home Assistant kennt nur dieses Postfach. Der Mail-Import ist optional – Nummern von Hand eintragen geht genauso.

**Was ihr wissen solltet**

- **Für Deutschland gebaut:** deutsche Carrier, deutsche Mails. DHL, UPS und 17track funktionieren auch im Ausland. Für Österreich und die Schweiz bräuchte ich anonymisierte Beispielmails von euch.

- **Beta:** DHL, DPD, der Mail-Import und die Benachrichtigungen laufen im Alltag. Die Live-Abfragen für GLS, Hermes und UPS sind eingebaut, hatten aber noch kein echtes Paket.

- **DHL** braucht einen kostenlosen API-Key (Anleitung in der README), **DPD** liefert nur den Status ohne Ort, **UPS** live nur mit eigenem kostenlosem Entwicklerzugang, sonst aus Mails.

**Installation**

Über HACS als benutzerdefiniertes Repository (Typ: Integration), danach Neustart und unter „Geräte & Dienste“ die Integration „Paket Tracker“ hinzufügen. Schritt für Schritt, auch ohne HACS, steht es in der README:

GitHub - SoerenKaiser99/parcel_tracker: Paket Tracker für Home Assistant (DHL, DPD) mit...

**Wobei ich Hilfe brauche**

1. Funktioniert es mit euren Paketen? Vor allem GLS, Hermes und UPS.

2. Werden eure Mails erkannt? Amazon und die Carrier verschicken je nach Konto leicht andere Formate.

3. Wenn etwas nicht klappt: bitte ein Issue auf GitHub mit der Vorlage. In der README steht ein kleines Skript, das Beispielmails anonymisiert. Bitte keine Original-Mails posten.

Ich freue mich über jede Rückmeldung, auch über „läuft einfach“.

Viele Grüße

Sören

[jayjojayson]

Interessanter Ansatz und mal etwas was die deutschen Dienste vereint, sogar mit Option für 17track. Gefällt mir, werde ich die Tage mal testen und berichten.

[SoerenKaiser99]

@jayjojayson Freut mich wenn es dir gefällt. Ich bastel grad an 0.3.11 mit einer Erweiterung zur Sichtbarkeit:

1. Ein neuer Sensor „Pakete unterwegs“ (sensor.pakete_unterwegs) mit der Zahl aller noch nicht zugestellten Pakete. Damit kannst du die Karte genau so über die Sichtbarkeits-Bedingung steuern wie bei deinen Abfuhrterminen und der Waschmaschine. Dazu kommen eigene Sensoren für „heute möglich“ und „heute zugestellt“.

2. Wer keine Bedingung bauen möchte, bekommt eine Kartenoption show: Die Karte blendet sich dann selbst aus, wenn nichts unterwegs ist (oder heute nichts kommt, je nach Einstellung).

[jayjojayson]

Top, show würde mir ausreichen, mache ich aktuell auch so, dass die Card nur sichtbar ist, wenn eine Lieferung ansteht. Nutze aktuell noch 17track, daher schön zu sehen und werde deine Integration nachher mal installieren.

Ach und wo sind meine Manieren, herzlich willkommen in der Community.

[MarzyHA]

Willkommen! Sehr gute Idee. Vor allem dass es direkt mit den Diensten kommuniziert und nicht auf den Email-Import angewiesen ist, ist super!
Du sprichst die ganze Zeit von einer HA-Card - ist das nur eine Card oder mit einer Integration dafür? Ist es nicht besser, solche Data-Fetching-Sachen auf Backend-Ebene in einer Integration zu nutzen?

Edit: Frage hat sich mit Blick aufs Repo erledigt Sieht soweit ganz gut aus

[SoerenKaiser99]

Danke dir @MarzyHA, und gute Frage! Es ist beides: eine richtige Integration (Backend) plus eine dazu passende Karte.

Das ganze Abrufen passiert in der Integration, also auf dem Home-Assistant-Server: die Abfragen bei DHL, DPD, GLS, Hermes und UPS, der optionale Mail-Import, das Speichern der Pakete, Benachrichtigungen. Daraus entstehen ganz normale Entitäten – ein Sensor pro Paket, Sensoren wie „Pakete heute“ und „Pakete unterwegs“, ein Kalender – und ein Event bei jeder Statusänderung. Das funktioniert alles auch komplett ohne die Karte, z. B. in Automationen oder mit eigenen Karten.

Die Karte ist nur die Anzeige obendrauf: Sie liest diese Entitäten und ruft zum Hinzufügen oder Umbenennen die Dienste der Integration auf. Sie selbst holt keine Daten bei den Carriern.

Der Titel „in einer Karte“ ist da etwas missverständlich, stimmt – gemeint war: alle Carrier auf einen Blick.

[SoerenKaiser99]

Danke @jayjojayson danke fürs Willkommen!

Dann passt es ja gut: Die Option show ist seit eben mit v0.3.11 draußen. Mit show: active blendet sich die Karte von selbst aus, solange kein Paket unterwegs ist – ganz ohne Bedingung drumherum. Wer es feiner mag, nimmt today oder today_possible.

Ich habe die Beta bewusst klein gehalten, nur hier, in einem anderen Forum und in einer Facebook-Gruppe. Der Wunsch, die Karte nur bei anstehenden Lieferungen zu zeigen, kam trotzdem gleich von mehreren – offenbar machen das viele so wie du ähnlich der Trash-Karten.

Da du von 17track kommst: Die großen deutschen Carrier fragt die Integration direkt ab, ohne den Umweg und ohne die Verzögerung. 17track gibt es nur noch optional auf Knopfdruck für alles andere. Ich bin gespannt, wie es bei dir im Vergleich läuft – sag gern Bescheid, was dir auffällt.

[MarzyHA]

Sehr gut, danke für die Antwort. Das ist echt genial! Werde ich demnächst austesten! Du hast zum Glück auch alle meine Lieferdienste abgedeckt

[SoerenKaiser99]

kein Problem, sehr gern!

[Smartzeug]

Sören, das ist genau so ein Projekt, bei dem man sich fragt, warum man dafür eigentlich fünf verschiedene Apps braucht
Gerade die Kombination aus den klassischen Paketdiensten und Amazon bzw. eBay über die Versandmails finde ich richtig stark.

Dass jetzt auch noch ein Sensor für „Pakete unterwegs“ kommt und sich die Karte automatisch ausblenden kann, wenn nichts ansteht, macht das fürs Dashboard richtig alltagstauglich
Bin gespannt, wie zuverlässig der Mail Import mit den unterschiedlichen Versandmail Formaten läuft.

[MarzyHA]

DHL Dev-Account Anfrage ist raus… dann warten wir mal ab

[SoerenKaiser99]

Danke dir, @Smartzeug das freut mich sehr – das war der Auslöser für mich… fünf Apps für ein und dieselbe Frage.

Zum Mail-Import ganz offen: Da steckt die größte Unbekannte. Ich bekomme, dank miner Frau, nicht unendlich viele Pakete Erkannt werden also bisher nur die Formate, die ich selbst zum Testen hatte – Amazon (Bestellt, Versendet, In Zustellung, Zugestellt), DHL, Hermes, UPS, GLS und eBay. Die Shops und Carrier verschicken aber je nach Konto und Zeitpunkt leicht andere Varianten, und die kenne ich erst, wenn sie jemand hat.

Deshalb ist es so gebaut, dass nichts still verloren geht: Was die Integration nicht einordnen kann, landet im Postfach im Ordner „Paket-Tracker-Nicht-erkannt“. Für solche Fälle gibt es ein kleines Skript, das die Mail anonymisiert (Name, Adresse, Nummern werden ersetzt), und eine Issue-Vorlage auf GitHub.

Nutzt nur bisher niemand Damit kann ich dann aber ein neues Format schnell nachziehen, ohne dass jemand private Daten herausgeben muss.

Der Sensor „Pakete unterwegs“ und das automatische Ausblenden sind übrigens schon da (seit v0.3.11), inzwischen sind wir bei v0.3.13. Wenn du es ausprobierst, bin ich auf deine Mails besonders gespannt – je mehr unterschiedliche Formate zusammenkommen, desto zuverlässiger wird es für alle.

[SoerenKaiser99]

Kurze Erklärung zum DHL-API-Key, weil die Frage jetzt mehrfach kam

Einige von euch haben den DHL-Key beantragt und eine Ablehnung bekommen. Das liegt nicht an euch und nicht an der Integration: DHL prüft jeden Antrag selbst, verlangt einen Firmennamen mit passender E-Mail-Domain und lehnt Privatpersonen – vor allem mit GMX, Gmail oder web de – häufig ab.

Mein Rat: nicht darauf versteifen. Der Key ist optional. Ohne ihn geht es genauso über die DHL-Mails:

1. Im kostenlosen DHL-Kundenkonto die E-Mail-Benachrichtigungen zu Sendungen einschalten.
2. Die DHL-Absender noreply@dhl. de und paketankuendigung@dhl .de per Filterregel an euer Paket-Postfach weiterleiten.
3. Fertig. Die Integration legt die DHL-Pakete aus den Mails an und führt den Status mit.

Das hat sogar einen Vorteil: Ihr müsst keine Sendungsnummern eintippen, die Pakete erscheinen von selbst. Mit Key kämen nur der aktuelle Ort und der genaue Verlauf dazu.

Warum ich keinen anderen Weg einbaue:

• DHL erlaubt automatische Abfragen nur über die offizielle Schnittstelle. Die Sendungsverfolgung der Webseite ist laut DHL ausdrücklich nur für Menschen gedacht, automatisches Auslesen ist untersagt und wird geblockt. Das umgehe ich nicht.
• Eine Anmeldung mit dem DHL-Kundenkonto gibt es bewusst nicht: Dafür existiert keine offizielle Schnittstelle, es würde bei jeder Änderung von DHL ausfallen, und in Home Assistant läge dann ein Zugang zu eurem ganzen DHL-Konto.

DPD, GLS und Hermes brauchen übrigens gar keinen Key, und Amazon und eBay kommen ohnehin über die Mails. Die Anleitung steht in der README unter „Kein Key? Dann die DHL-Mails“.

Wer DHL-Mails hat, die nicht erkannt werden: bitte anonymisiert einschicken (Skript in der README). Je mehr Formate ich sehe, desto besser wird die Erkennung.

[jayjojayson]

Hi, ich habe das jetzt mal über die E-Mail nach deiner Anleitung für DHL angelegt.
Jetzt muss nur noch eine passende Mail im Hauptkonto ankommen und an das Paketpostfach weitergereicht werden. Das DHL es wieder so kompliziert machen muss, geht doch bei den anderen Anbietern auch easy und ich bekomme halt leider oft etwas von DHL. Es wäre schon schön, dafür keinen api key anlegen zu müssen und wollte deswegen erstmal den E-Mail Weg testen.

Beim Hermes Paket war es echt easy, Paketnummer eingetragen und fertig.

Die Card gefällt mir übrigens sehr gut, einfach und doch schön übersichtlich gestaltet.

[SoerenKaiser99]

Dank dir und auch für das Lob zur Karte! Und danke für die Rückmeldung zu Hermes: Du bist der Erste, der die Hermes-Abfrage mit einem echten Paket bestätigt, das stand bisher noch als „ungetestet“ in der Roadmap.

Zu DHL: Ja, da macht es DHL allen schwerer als die anderen. Der Mail-Weg ist dafür gedacht, und du musst dafür keinen Key anlegen. Zwei Tipps, damit es auf Anhieb klappt:

1. DHL verschickt von mehreren Adressen (noreply@dhl.de, paketankuendigung@ dhl. de, zustellung@ dhl. de). Am einfachsten leitest du in der Filterregel alles von der Domain dhl. de weiter.
2. Bitte auf die aktuelle Version aktualisieren (v0.3.16). Seit gestern ist die DHL-Mail-Erkennung deutlich besser: Der Shop aus dem Betreff wird zum Paketnamen, „kommt heute“ setzt den Liefertag, und auch von Hand weitergeleitete Mails werden jetzt wie das Original erkannt.

Wenn eine DHL-Mail bei dir nicht oder falsch erkannt wird, landet sie im Ordner „Paket-Tracker-Nicht-erkannt“. Dann gern anonymisiert als Issue schicken (Skript in der README), so sind die letzten Verbesserungen entstanden.

• v0.3.16: Von Hand weitergeleitete Mails werden jetzt wie das Original erkannt (Outlook, Apple Mail, Gmail, Thunderbird, auch „als Anhang weiterleiten“). Der eigene Text und die Signatur über dem weitergeleiteten Teil werden dabei nie ausgewertet.

Und als letztes Update… Eben hat mich ein API Entwickler von DHL kontaktiert… Mal schauen was da kommt

[jayjojayson]

Na super, dann konnte ich wenigstens eine kleine Bestätigung geben wegen dem Hermes Paket.

Danke für den Hinweis, hatte schon alle drei E-Mails im Filter hinterlegt.
Wie das bei manueller Weiterleitung gemacht wird, hatte ich mich schon gefragt, aber hast du ja jetzt mit der neuen Version implementiert. Das ist ein wichtiger Punkt, dass auch manuelle Weiterleitungen erkannt werden. Danke dafür.

Habe ich auch gleich mal mit einem abgelaufenem DHL Paket getestet. E-Mail an Paket-Email weitergeleitet und kurz danach wurde in der Card das Paket aufgeführt.

@SoerenKaiser99

Eben hat mich ein API Entwickler von DHL kontaktiert

Da bin ich sehr gespannt.

[MarzyHA]

Mein Access wurde heute leider auch rejected - Ich habe leider keine eigene Email-Domain
Der Umweg über die E-Mails ist nicht so praktikabel - der Vorteil wäre ja, dass die Integration automatisch den Status checked und man nicht dauernd selbst gucken muss. Wenn ich das richtig verstehe, ist es bei amazon das gleiche? Das ist natürlich sehr schade!

[SoerenKaiser99]

Hallo Marzy,

ärgerlich mit dem Key – aber da liegt ein Missverständnis vor: Der Weg über die Mails läuft genauso automatisch. Du musst nichts selbst nachsehen.

So funktioniert es:

1. Du richtest einmal eine Filterregel ein, die alle Mails von dhl.de an ein eigenes kleines Paket-Postfach umleitet.
2. Die Integration liest dieses Postfach von selbst.
3. Aus den DHL-Mails entstehen die Pakete und ihr Status: angekündigt, „kommt heute“, zugestellt – inklusive Karte, „Pakete heute“ und Push aufs Handy.

Ohne Key fehlt dir nur zweierlei:

• Ort und Verlauf zwischen den Mails („im Paketzentrum …“).
• Der Status für Nummern, die du von Hand einträgst und zu denen keine Mail kommt.

Bei Amazon ist es derselbe Weg, und dort gibt es auch keinen anderen: Amazon bietet für Privatkunden gar keine Schnittstelle. Die Bestell- und Versandmails reichen aber für Liefertag und Status, ebenfalls automatisch.

Zum Key noch zwei Tipps, falls du es noch mal versuchen magst – eine eigene Domain brauchst du nicht:

• E-Mail-Adresse: Laut einem Hinweis aus dem DHL-API-Team gehen GMX und web.de durch, Gmail und Hotmail werden oft abgelehnt.
• Zweck: „I want to track my own shipments“ angeben.

Die genaue Anleitung steht in der README unter „DHL-API-Key anlegen“.

Und wenn du für einzelne DHL-Nummern doch den Live-Verlauf willst: Mit einem kostenlosen 17track-Key kannst du ein Paket per Knopfdruck dort nachschlagen lassen. Das Konto hat ein einmaliges Kontingent von 200 Nummern.

Viele Grüße
Sören

[MarzyHA]

Oh, danke für die ausführliche Antwort!
Die automatische E-Mail Weiterleitung ist eine gute Idee.
Der Tipp mit der E-Mail-Adresse ist ebenfalls gut, habe es jetzt nochmal mit einer GMX-Adresse probiert.
Der Tipp mit 17Track ist ebenfalls gut! Das werde ich dann ggf. in Betracht ziehen

[jayjojayson]

@MarzyHA die automatische E-Mail Weiterleitung funktioniert gut, hatte das heute schon mit der neuen Version einmal manuell versucht und funktionierte. Hatte nur kein Paket mehr was aktuell ist, wurde trotzdem korrekt erkannt.

E-Mail für die Weiterleitung hatte ich mir bei gmx eingerichtet.

Da ich schon ein Pseudokonto für 17track hatte, habe ich mal die neue api eingerichtet, geht easy und schnell und habe dann auch gleich mal wieder den Test mit einem bereits erhaltenem Paket gemacht. Die Integration hat die Abfrage korrekt gestartet und im Api Konto wurde eine Sendung abgezogen. Sollte also funktionieren und korrekt eingerichtet sein.

Card schaut nach ein, zwei Minuten auch top aus.

Ein einfacher Zugang zu DHL wäre mir trotzdem lieber. Vielleicht ergibt sich ja etwas mit dem API Entwickler bei DHL. 17track Integration habe ich gerade jedenfalls erstmal deinstalliert.