Externe Integration - Internationale Sendungsverfolgung (17TRACK, DHL)

cover-colis

Hallo zusammen!

Die La Poste-Integration (Intégration externe - La Poste (suivi de colis)) verfolgt Sendungen von La Poste, Colissimo und Chronopost… aber unsere Pakete gehen auch über UPS, DPD, GLS, Mondial Relay oder kommen nach drei Wochen Reise aus China. Hier ist also das Komplement für alles andere, inklusive international. @ruegerth, du hast DHL und die österreichische und Schweizer Post gefragt: das ist für dich ^^

Was es kann

  • Ein Gerät pro Paket, mit einem gemeinsamen Status für alle Transporteure: registriert, in Transit, in Lieferung, abzuholen, Problem, geliefert. Und auch der letzte Schritt mit dem Text des Transporteurs, dem Ort, dem Datum, dem Transporteur und dem voraussichtlichen Lieferdatum.
  • Drei Auslöser: „In Lieferung“, „Geliefert“ und „Das Paket erfordert Ihre Aufmerksamkeit“ (abzuholen am Paketshop oder Problem), jeder filterbar auf ein bestimmtes Paket.
  • Drei Szenenaktionen: ein Paket verfolgen (auch aus dem Objekt einer E-Mail), das Verfolgen beenden und den Status meiner Pakete lesen.
  • Ein Widget „Meine Pakete“, das zuerst diejenigen zeigt, die auf Sie warten; ein Druck öffnet die Historie und den Verfolgungslink.
  • Ein geliefertes Paket wird nach 7 Tagen automatisch archiviert (einstellbar).
  • Auf Französisch, Englisch, Deutsch und Spanisch.

Wer was nutzt: Die Nummern DHL und Deutsche Post nutzen die offizielle DHL-API. Alles andere läuft über 17TRACK, das den Transporteur anhand der Nummer erkennt: UPS, FedEx, USPS, GLS, DPD, Royal Mail, Sendungen aus China… und die nationalen Postdienste, darunter die österreichische und die Schweizer Post. UPS, FedEx und USPS haben zwar ihre eigenen APIs, aber diese erfordern ein Geschäftskonto: 17TRACK ist viel einfacher. Für La Poste, Colissimo und Chronopost behalten Sie die La Poste-Integration, die die offizielle API liest.

Der coole Teil

Paket in Lieferung und niemand zu Hause → „Das Amazon-Paket kommt heute“
Paket am Paketshop abzuholen → Erinnerung am nächsten Morgen mit der Adresse des letzten Schritts
Jeden Morgen um 8 Uhr → Sprachansage „Sie haben 2 Pakete unterwegs, eines davon wird heute geliefert“

Installation

:warning: Mindestens Gladys 5.1.

Sie kommt im Store beim nächsten Indexer-Lauf. In der Zwischenzeit: Integrationen → Von GitHub installieren, mit GitHub - guim31/gladys-colis: International parcel tracking (17TRACK, DHL and more) for Gladys Assistant · GitHub

  1. Erstellen Sie einen kostenlosen 17TRACK-Schlüssel auf https://api.17track.net, einen kostenlosen DHL-Schlüssel auf https://developer.dhl.com (API „Shipment Tracking - Unified“), oder beides. Mit nur dem DHL-Schlüssel werden nur DHL-Pakete verfolgt.
  2. Fügen Sie den oder die Schlüssel in die Konfiguration ein.
  3. Verwenden Sie die Aktion „Paket verfolgen“ mit der Nummer, dann fügen Sie das Paketgerät im Tab Entdeckung hinzu.

Kleine ehrliche Vorbehalte

  • Die kostenlosen Angebote sind begrenzt, und die Integration hält sich daran: maximal 240 DHL-Anfragen pro Tag und nur eine 17TRACK-Registrierung pro Paket. Bei 17TRACK gibt das kostenlose Angebot eine begrenzte Anzahl von Nummernregistrierungen (200 zu Beginn laut ihrer Hilfe, das ist etwas unklar); „Pakete jetzt lesen“ zeigt an, was übrig bleibt.
  • Maximal 40 verfolgte Pakete, und das Gerät eines archivierten Pakets bleibt in Gladys: manuell zu löschen.
  • DHL sagt nicht „in Lieferung“ oder „abzuholen“: die Integration errät es anhand des Textes des Schritts, auf Englisch und Deutsch. Eine ungewöhnliche Formulierung kann in „In Transit“ bleiben.
  • Die Schritte behalten den Text des Transporteurs, ohne Übersetzung.
  • Entwickelt ohne 17TRACK- oder DHL-Konto. Ich habe von zu Hause aus überprüft, dass die echten APIs von 17TRACK und DHL auf eine falsche Schlüssel korrekt antworten und diese ablehnen, aber noch kein echtes Paket wurde verfolgt. Die österreichische und Schweizer Post laufen über 17TRACK und wurden nicht einzeln überprüft: @ruegerth, dein Feedback wird wertvoll sein.

Wie die vorherigen, entwickelt mit Claude Code. Unabhängiges Projekt, nicht affiliated mit 17TRACK, DHL oder den genannten Transporteuren.

Repository: GitHub - guim31/gladys-colis: International parcel tracking (17TRACK, DHL and more) for Gladys Assistant · GitHub