v0.3.44

Was sich ändert

• Neues Event parcel_tracker_parcel_added: Es kommt einmal pro neuem Paket, ob aus einer Mail, per Dienst oder auf der Karte, mit number, name, carrier, owner, gift und entry_id. Bei Geschenken steht nur der Geschenk-Name drin. Damit lässt sich zum Beispiel per Push nachfragen: „Ist das ein Geschenk?“ Ein Beispiel steht in der Doku unter Sensoren (#64).
• Kartenoption gifts:
  • show zeigt alles wie bisher (Standard).
  • hide_for_others blendet Geschenke für alle aus, die sie nicht sehen dürfen: keine Zeile, kein Schild, keine Mitzählung.
  • hide zeigt nie Geschenke, etwa auf einem gemeinsamen Wandtablet (#64).
• gift in den Listen: Das Kennzeichen steht jetzt auch je Eintrag in den parcels-Listen der Zählsensoren, für eigene Anzeigen und Templates.
• UPS-Doku: Eine App auf developer.ups.com braucht immer ein UPS-Konto mit Abrechnung. Ohne Konto kommen UPS-Pakete aus den Mails oder über 17track (#63).

Die Option blendet nur auf der Karte aus. Sensoren und Zähler sehen alle Benutzer gleich. Zähler ohne Geschenke und eine Zielgruppe pro Geschenk stehen auf der Roadmap.

Nicht live geprüft: die Kartenoption auf einem echten Wandtablet mit eigenem Benutzer.

v0.3.43

Was sich ändert

• Einfuhrabgaben (Zoll) bei DHL: Nennt die DHL-Mail am Zustelltag Einfuhrabgaben, zeigt die Karte den Betrag als Schild und als Zeile im Paket, dazu, ob bar zu zahlen ist. Die Benachrichtigung „in Zustellung“ nennt den Betrag ebenfalls.
• Neue Attribute: customs_amount, customs_currency und customs_cash. Sie werden nicht im Verlauf gespeichert und nach der Zustellung gelöscht.
• Geschenke: Bei Geschenken bleibt der Betrag sichtbar, weil er an der Tür bezahlt werden muss.

Beitrag von @Sven242 (#53, Idee #36), danke!

Nicht live geprüft: eine echte Zoll-Mail. Getestet wurde mit einer anonymisierten Beispielmail.

v0.3.42

Was sich ändert

Diese Version setzt die Anmerkungen aus der Prüfung für den HACS-Standardkatalog um und erkennt mehr DHL-Sendungen.

• Karte: Die Integration kopiert die Karte nicht mehr nach /config/www. Sie läuft jetzt immer über /parcel_tracker/parcel-tracker-card.js. Eine alte Dashboard-Ressource unter /local/parcel_tracker/… stellt die Integration selbst um und löscht danach die alte Kopie. Bei Dashboards im YAML-Modus zeigt ein Reparatur-Hinweis, welcher Eintrag zu ersetzen ist.
• Zustell-Code (Breaking Change): Das Attribut delivery_code gibt es nicht mehr, neu ist has_delivery_code (true/false). Die Karte zeigt den Code wie bisher verdeckt und holt ihn erst beim Aufdecken. Wer den Code in einer Automation oder Vorlage aus dem Attribut gelesen hat, bekommt ihn dort nicht mehr.
• IMAP-Server: Es gibt keinen voreingestellten Server mehr. Bei eingeschaltetem Mail-Import ist er ein Pflichtfeld. Bestehende Einrichtungen mit leerem Feld laufen weiter, weil beim Update einmalig imap.mailbox.org eingetragen wird, der bisher stillschweigend genutzt wurde. Ein nie gewählter mailbox.org-Eintrag ohne Mail-Import wird entfernt.
• DHL eCommerce: 20-stellige Sendungsnummern, die mit „00“ beginnen (Versand aus den Niederlanden, z. B. Kipling oder Harman), werden in DHL-Mails und hinter Etiketten wie „DHL Trackingnummer“ erkannt, wenn die Prüfziffer stimmt. Rücksendenummern zählen nicht. Neuer Absender noreply@dhlecommerce.nl, bitte in die Filterregel aufnehmen. Vermutlich ist damit auch #62 behoben.
• Anonymisier-Skript: Namen im Impressum (Geschäftsführer, Inhaber, Vorstand) werden ersetzt (#60, danke @benep). DHL-eCommerce-Nummern behalten „00“ und eine gültige Prüfziffer, damit eingesandte Beispiele erkannt werden.

Nach dem Update: Home Assistant neu starten. Zeigt ein Dashboard direkt nach dem Neustart „Custom element doesn't exist“, die Seite neu laden.

Nicht live geprüft: die Umstellung eines YAML-Dashboards und eine echte Kipling-Mail. Die Erkennung wurde mit anonymisierten Mails getestet.

v0.3.41

Pakete Personen zuordnen (#39)

Pakete können jetzt einer Person aus Home Assistant gehören. Benachrichtigungen gehen dann nur an diese Person, und die Karte kann nur ihre Pakete zeigen.

Einrichten: Einstellungen → Geräte & Dienste → Paket Tracker → Konfigurieren → Personen. Für jede Person trägst du ihre Mailadressen ein (die eigene Adresse reicht oft, sonst eine Plus-Adresse wie pakete+name@…) und ihre Benachrichtigungs-Ziele.

• Erkennung: Die Integration liest die Empfänger-Kopfzeilen der Mail (Delivered-To, X-Original-To, To, Cc, X-Forwarded-…, Resent-…). Passt genau eine Person, gehört ihr das Paket. Passt keine, passen mehrere oder steht eine gemeinsame Adresse drin, gilt Unklare Pakete gehören (Standard: allen).
• Benachrichtigungen: gehen nur an die Ziele des Besitzers, wenn für ihn Ziele eingetragen sind; sonst wie bisher an die allgemeinen Ziele.
• Karte: Auswahl „Gehört“ im aufgeklappten Paket und beim Hinzufügen. Neue Optionen person: person.name und include_unassigned.
• Dienste und Daten: Neuer Dienst parcel_tracker.set_owner, add_parcel nimmt optional owner. Neue Attribute owner und owner_detected am Paket, persons und default_owner an „Pakete heute“, Feld owner im Event parcel_tracker_status_changed.
• Geschenkmodus: Den Besitzer eines Geschenks ändern nur Geschenk-Seher.

Ohne eingerichtete Personen ändert sich nichts.

Außerdem: Das Anonymisier-Skript behält die Empfänger-Kopfzeilen mit erfundenen Adressen, damit sich die Erkennung an eingesandten Mails prüfen lässt. Die Doku zum DHL-Key ist korrigiert: Freemail-Adressen sind nicht gesperrt, Wegwerf-Adressen werden abgelehnt.

Noch nicht im Alltag geprüft: die Erkennung bei Weiterleitungen über Gmail und Outlook und bei Alias-Adressen von GMX und web.de. Rückmeldungen dazu bitte in #39, gern mit einer anonymisierten Mail.

Doku: https://soerenkaiser99.github.io/parcel_tracker/mail-import/#pakete-personen-zuordnen

v0.3.40

Neu: Geschenkmodus

Für die Weihnachtszeit: Pakete, die im Geschenkmodus ankommen, verraten auf dem Dashboard nicht, was drin ist. Anleitung: Die Karte → Geschenkmodus

• Geschenkmodus: ein Schalter neben „Pakete“ auf der Karte. Pakete, die im Modus entstehen, heißen „Geschenk · …“ und zeigen keinen Namen, keinen Mail-Titel und keine Links, auch nicht im Kalender, in Sensoren und in Benachrichtigungen. Wer Geschenke sehen darf, legst du unter Konfigurieren fest; nur diese Personen schalten den Modus aus und sehen den echten Namen. Wähle sie zuerst, sonst lässt sich der Modus nur per Automation ausschalten. Wandtablets und Kinder-Handys brauchen einen eigenen Benutzer.
• Neuer Dienst parcel_tracker.set_gift, um Pakete (auch alle offenen) als Geschenk zu kennzeichnen oder wieder sichtbar zu machen.
• Der Recorder zeichnet die Attribute name, tracking_url und amazon_shipment und die Listen der Zusammenfassungen nicht mehr auf. Der Anzeigename der Entität und der Kalendereintrag bleiben im Verlauf: Ein später gekennzeichnetes Geschenk behält dort seinen früheren Namen. Schalte den Modus am besten vor dem Bestellen ein.
• Storniert: Stornierte Bestellungen bei Amazon, eBay und AliExpress schließen sich als „Storniert“ (#23).
• Amazon: Sendungen einer Bestellung werden nach Sendungs-ID getrennt (#49).
• Die Postfach-Abfrage lässt sich auf bis zu 1440 Minuten einstellen (vorher 60).
• Anonymisier-Skript: erkennt mehr Namen und Adressen, darunter eBay-Kaufbestätigungen (#58, #59).

Gut zu wissen

• Zuerst festlegen, wer Geschenke sehen darf (Konfigurieren → „Wer darf Geschenke sehen?“). Ohne Auswahl lässt sich der Modus nur per Automation wieder ausschalten.
• Automationen, die den Modus ausschalten, kann jeder Benutzer von Hand starten. Die Datumsprüfung gehört deshalb in die Aktionen, siehe Automationen.
• Zurück auf eine ältere Version: v0.3.39 und älter kennen „Storniert“ und das Geschenk-Kennzeichen nicht. Stornierte Einträge werden dann verworfen, und Geschenke zeigen wieder ihren Namen.

Nicht live geprüft

Der Geschenkmodus ist mit Tests und in der Demo geprüft, nicht in einem echten Haushalt mit mehreren Benutzern. Rückmeldungen: Wie ihr helfen könnt

v0.3.39

Danke an @Sven242 für seinen ersten Beitrag und an @benep!

Neu

• Option „Absendernamen aus DHL-Mails ohne Firmenprüfung übernehmen“ (#52, #35): Unter Konfigurieren → E-Mail-Import. Eingeschaltet heißt ein Paket nach dem Namen aus dem DHL-Betreff „Ihre … Sendung“, auch bei kleinen Shops wie „voelkner“. Achtung: Dann können auch Namen von Privatpersonen auf Karte, Kalender und in Benachrichtigungen landen. Deshalb ist die Option standardmäßig aus. „Namen ausblenden“ gilt weiterhin.
• eBay: Kaufbestätigung (#47): „Bestellung bestätigt: …“ legt die Bestellung schon als „Bestellt“ an, mit Artikel und Lieferzeitraum. Bisher begann sie erst mit der Versandmail.
• DHL: Abholort aus der Abholmail (#48): Liegt ein Paket in einer Filiale oder Packstation, steht sie mit Straße als Abholort auf der Karte (ohne Postleitzahl und Ort). Neuer Absender abholung@dhl.de – bitte in die Filterregel aufnehmen.

Korrekturen

• Amazon, Versand durch Verkäufer (#50): Eine DHL- oder Hermes-Mail „von Amazon“ landet nicht mehr bei einer Bestellung, die der Verkäufer selbst verschickt.

Für Mitwirkende

• Anonymisier-Skript (#45): Erkennt jetzt auch Namen und Straßen, an die der Absender das nächste Wort klebt („Herr MeierIhre Bestellung“). Wer schon Beispielmails eingereicht hat: Bitte die Dateien vor dem Hochladen wie immer selbst durchlesen.

Bitte bestätigen

Die neuen Mails sind mit den Mails der Beitragenden geprüft. Was gesucht wird: Wie ihr helfen könnt

v0.3.38

Diese Version besteht fast ganz aus Beiträgen von @benep. Danke!

Neu

• Symbole statt Knöpfe auf der Karte (#43): „Sendung verfolgen“ und „Bestellung“ sind jetzt kleine Symbole direkt hinter der Sendungs- bzw. Bestellnummer im aufgeklappten Paket. Die Knopfzeile darunter bleibt damit einzeilig („Erhalten“, „Umbenennen“, „Löschen“).
• Amazon: „Sendung verfolgen“ führt zu Amazon (#40): Solange keine Mail die Nummer eines Paketdienstes genannt hat, führt der Link zu Amazons eigener Sendungsverfolgung. Der Link geht immer zu amazon.de.
• DHL Express (#38): Die Mails „DHL On Demand Delivery“ von noreply.odd@dhl.com werden gelesen: unterwegs (mit Zustelltag), heute in Zustellung, zugestellt mit Uhrzeit.
• AliExpress, letzte Meile (#42): „Paket … ist versandbereit“, „Paket … wird zugestellt“, „Paket … wurde zugestellt“ und „Lieferprobleme für Packstück …“.

Korrekturen

• Spät gelesene Mails stufen nicht mehr zurück (#44): Eine Mail, die eine Zustellung verschiebt (z. B. die Ankündigung vom Vorabend), nimmt ein Paket nicht mehr aus „In Zustellung“ zurück, wenn sie erst nach einer neueren Mail gelesen wird. Mit DHL-Key gab es in diesem Fall eine zweite Meldung „ist in Zustellung“, die entfällt. Echte Zustellversuche in der richtigen Reihenfolge wirken wie bisher.
• Zustellzeit bleibt beim Paketdienst (#42): Eine spätere „zugestellt“-Mail eines Shops verschiebt die Zustellzeit nicht mehr nach hinten. Bisher konnte ein Paket so fälschlich als „heute zugestellt“ zählen, etwa wenn die Shop-Mail erst nach Mitternacht kam.

Für Mitwirkende

• Anonymisier-Skript: Option --salt (#41) für wiederholbare Ergebnisse beim Prüfen von Regeländerungen. Das Skript erzeugt den Salt selbst. Wer Beispielmails einreicht, braucht die Option nicht.

Bitte bestätigen

Die neuen Mails sind mit den Mails von benep geprüft, aber noch von niemandem sonst. Was gesucht wird: Wie ihr helfen könnt

v0.3.37

Korrektur

DHL-Importsendungen mit ausländischer Sendungsnummer (#34, danke an @Sven242 für die genaue Analyse): Kommt ein Paket aus dem Ausland, nennt die DHL-Mail oft eine internationale Nummer mit dem Ländercode des Absenders, z. B. LE…BE (Belgien) oder LW…NL (Niederlande). Bisher kannte der Import nur Nummern mit „DE“ am Ende, und es entstand gar kein Paket. Jetzt wird die Nummer aus DHL-Mails gelesen. Mit DHL-API-Key fragt die Integration das Paket bei DHL ab.

Bewusst unverändert: Trägst du so eine Nummer von Hand mit „Automatisch“ ein, gilt sie nicht als DHL-Nummer. Dieselben Formate nutzen die Österreichische Post, die Schweizer Post, PostNL und andere. Mit DHL-Key wird DHL wie bei jeder unbekannten Nummer einmal gefragt.

Geprüft

Alle 92 Beispielmails ergeben genau dasselbe wie in v0.3.36. Neu erkannt werden nur die internationalen Nummern in DHL-Mails.

v0.3.36

Neu: Amazon-Abholmail

Liegt eine Amazon-Bestellung in einem PaketShop, einer Abholstation oder an einem Counter, schickt Amazon eine Mail von pickup-point@amazon.de („Paket zur Abholung bereit“). Die wird jetzt erkannt (#33, danke an Phantomkommander für die Beispielmail):

• Die Bestellung springt auf „Abholbereit“. Sie zählt bei sensor.pakete_abholbereit, und die Benachrichtigung „abholbereit“ kommt mit.
• Abholort und letzter Abholtag stehen aufgeklappt auf der Karte und in der Benachrichtigung, z. B. „… liegt zur Abholung bereit – Hermes PaketShop … bis 24.10.“ Übernommen wird nur der Name der Abholstelle, ohne Postleitzahl und Ort.
• Kennt die Bestellung die Sendungsnummer des Paketdienstes, bleiben Abholort und Frist erhalten, solange der Paketdienst weiter „abholbereit“ meldet und selbst keinen Ort nennt.
• Kommt die Mail zu einer noch unbekannten Bestellung, wird sie angelegt und nach dem Artikel benannt.

Für die Filterregel: pickup-point@amazon.de in die Liste der Absender aufnehmen, falls du die Paketmails per Regel in ein eigenes Postfach leitest. Die aktuelle Liste steht unter Filterregel anlegen.

Nebenbei

• Meldet ein Paketdienst (z. B. DHL) erneut „abholbereit“ per Mail, bleibt der schon bekannte Abholort stehen, statt zu verschwinden.

Nicht mit echten Mails geprüft

Getestet ist die Mail für einen Hermes PaketShop. Amazon Locker und Counter sind nur mit erfundenen Betreffs getestet. Unklar ist außerdem, ob „Abholung am …“ immer der letzte Abholtag ist. Rückmeldungen helfen: Wie ihr helfen könnt

Bekannte Grenze

Kommt die Amazon-Abholmail, bevor der Paketdienst selbst „abholbereit“ meldet, kann die Abholmeldung zweimal kommen.

v0.3.35

Korrekturen

• eBay „📦PAKET ZUGESTELLT“ (#32): eBay schreibt die Zustellmail inzwischen auch so. Bisher landete sie in „Nicht erkannt“, jetzt springt die Bestellung auf „Zugestellt“. Den Namen liefert der Betreff, der Verkäufer wird nie übernommen. Erkannt werden „BESTELLUNG ZUGESTELLT:“ und „PAKET ZUGESTELLT:“ überall im Betreff, auch hinter einem Symbol, „WG:“ oder „[EXTERN]“.
• DPD Österreich mit Zeitfenster (#31): „Ihr DPD Paket kommt zwischen … und … Uhr“ setzt das Paket auf „In Zustellung“ für heute, mit Zeitfenster.

Anonymisier-Skript für Beispielmails

Das Skript anonymize_mail.py hat Adressblöcke mit 4-stelliger Postleitzahl (Österreich, Schweiz) nicht als Adresse erkannt. Name und Straße konnten dadurch stehen bleiben. Jetzt erkennt es:

• 4-stellige Postleitzahlen (auch mit „A-“ / „CH-“)
• mehr Straßenwörter (…gasse, …strasse, …weg, …platz, …allee usw.) und österreichische Hausnummern wie „12/3/7“
• die Namenszeile direkt über der Straße
• den Block unter „an folgende Adresse zugestellt:“
• den Verkäufer einer eBay-Mail an beiden Stellen, an denen eBay ihn nennt

Wer schon Beispielmails eingereicht hat: Bitte die fertigen Dateien vor dem Hochladen wie immer selbst durchlesen. Wer aus Österreich oder der Schweiz schon eine eingereicht hat, schaut am besten noch einmal nach, ob Name oder Straße drinstehen, und löscht den Anhang in dem Fall.

Nicht mit echten Mails geprüft

Beide neuen Mails sind nach den Beschreibungen der Einsender nachgebaut. Rückmeldung, ob sie bei euch erkannt werden, hilft: Wie ihr helfen könnt