Paketverfolgung

Verfolgt Sendungen aller Zusteller, die parcel.app unterstützt, mit einem einzigen API-Schlüssel. Der Adapter fragt dein parcel.app-Konto ab und bildet jede Sendung im ioBroker-Objektbaum ab.

Kapitel: diese Seite · Skripte und Automatisierung · Häufige Fragen

Voraussetzung

Du brauchst ein parcel.app-Premium-Abo. Die API ist eine Premium-Funktion — ohne sie beantwortet parcel.app jede Anfrage mit HTTP 403 und der Adapter kann nichts lesen. Der Adapter legt kein Konto an und verwaltet keines; er liest nur (und fügt auf Wunsch Sendungen hinzu).

Der Adapter spricht nicht selbst mit den Zustellern. Alles, was in ioBroker erscheint, ist das, was parcel.app über eine Sendung weiß — einen Zusteller, den parcel.app nicht erreicht, erreicht auch dieser Adapter nicht.

Einrichtung

1. API-Schlüssel holen

1. web.parcelapp.net öffnen und mit dem parcel.app-Konto anmelden.
2. Den Bereich API öffnen.
3. Den Schlüssel kopieren. Er ist eine lange Zeichenkette — vollständig kopieren, ohne Leerzeichen davor oder dahinter.

2. Instanz anlegen

In ioBroker unter Adapter nach parcelapp suchen und eine Instanz hinzufügen. Der Konfigurationsdialog öffnet sich von selbst.

3. Einstellungen ausfüllen

4. Verbindung testen

Die Schaltfläche Verbindung testen führt eine echte Anfrage aus und meldet das tatsächliche Ergebnis — ein falscher Schlüssel, ein abgelaufenes Abo oder ein Netzwerkproblem werden benannt und nicht hinter einem grünen „Ok" versteckt. Danach speichern; die Instanz startet und die erste Abfrage folgt sofort.

Hinweis: der Test verbraucht dasselbe Anfragebudget wie das Abfragen (20 Anfragen pro Stunde). Ein paar Klicks bei der Einrichtung sind unproblematisch, Dauerklicken nicht.

Das richtige Abfrageintervall

parcel.app liefert die Sendungsliste aus einem serverseitigen Zwischenspeicher, der rund 45 bis 90 Minuten alt ist. Ein kürzeres Intervall macht die Sendungsdaten deshalb nicht frischer — es verkürzt nur die Zeit zwischen dem Auffrischen bei parcel.app und dem Bemerken in ioBroker. Die Vorgabe von 10 Minuten ist ein guter Kompromiss; unter 5 Minuten wäre das Stundenbudget gesprengt und wird abgelehnt.

Was im Objektbaum entsteht

parcelapp.0.
├── info.connection              Verbindung zur parcel.app-API
├── summary.
│   ├── activeCount              Noch nicht zugestellte Sendungen
│   ├── todayCount               Heute erwartete Sendungen
│   └── deliveryWindow           Gemeinsames Fenster der heutigen Sendungen
└── deliveries.
    └── <Paketkennung>.          Ein Gerät je Sendung
        ├── carrier
        ├── status
        ├── statusCode
        ├── description
        ├── trackingNumber
        ├── extraInfo
        ├── deliveryWindow
        ├── deliveryEstimate
        ├── lastEvent
        ├── lastLocation
        └── lastUpdated

Verbindung

Zusammenfassung

Die Zusammenfassungswerte werden beim Stoppen der Instanz nicht zurückgesetzt. Die Zahl der unterwegs befindlichen Sendungen ändert sich nicht dadurch, dass niemand hinsieht.

Je Sendung

Jede Sendung wird ein Gerät unterhalb von deliveries.. Der Gerätename ist die Beschreibung, die du der Sendung in parcel.app gegeben hast — und wenn du das Gerät im ioBroker-Admin umbenennst, gewinnt dein Name und wird von keinem Update überschrieben.

Status-Codes

-1 ist kein parcel.app-Status. Der Adapter verwendet ihn, wenn parcel.app einen Statuswert schickt, den er nicht deuten kann — etwa weil dort ein neuer Code eingeführt wurde. Eine solche Sendung bleibt bewusst sichtbar, statt als „zugestellt" missverstanden und still entfernt zu werden.

Nur Sendungen im Status 2, 4 und 8 können ein voraussichtliches Zustelldatum haben; bei allen anderen sind deliveryWindow und deliveryEstimate deshalb leer.

Sprache

Jeder Text, den der Adapter schreibt — Statusbezeichnungen, Zustellprognosen, Objektnamen und Beschreibungen — folgt der ioBroker-Systemsprache (Systemeinstellungen → Sprache). Es gibt keine Spracheinstellung je Instanz. Ein Sprachwechsel wirkt bei den Objektnamen sofort und bei den Zustandswerten nach dem nächsten Adapter-Neustart.

Sendungen löschen

Die parcel.app-API hat keinen Lösch-Endpunkt, der Adapter kann eine Sendung also nicht aus deinem parcel.app-Konto entfernen. Lösche sie in der parcel.app-App oder im Web, dann verschwindet sie mit der nächsten Abfrage auch aus ioBroker.

Was der Adapter tut: bei eingeschaltetem Zugestellte Pakete automatisch entfernen verschwinden eine zugestellte Sendung und alle ihre Datenpunkte aus dem Objektbaum — die Sendung selbst bleibt in deinem parcel.app-Konto.

Changelog

0.12.1 (2026-09-07)

• New: Carrier, status and description of a package now carry a short explanation in the object tree, in all eleven languages — including why scripts should read the status code, not the text.

0.12.0 (2026-09-06)

• Fixed: A package that reappeared after a database hiccup kept datapoints without a name or description until the adapter was restarted.
• Fixed: A delivery window written as "September 6, 2026 14:30" was ignored, so window, estimate and the count of packages expected today stayed empty for those carriers.
• New: The documentation explains why a delivery window can stay empty, and an unreadable date from the carrier can now be reported so the format gets added.
• New: The last known location of a package explains itself in the object tree: it is where the carrier last scanned it, not a live position.

0.11.1 (2026-09-04)

• Fixed: The last-changed timestamp of a package kept its old label and had no description as long as the package did not move.

0.11.0 (2026-09-04)

• Fixed: Since version 0.10.3 the Test Connection button gave no response at all, and packages added from a script never showed up — both work again.
• Fixed: On installations that already existed, the summary datapoints and the connection state kept their old English names — an update now reaches every datapoint.
• New: Datapoints whose name alone does not explain them now carry a short description in the object tree, in all eleven languages.
• New: Detailed user documentation in English and German, shown in the ioBroker documentation portal.
• Fixed: Two settings from much older versions were still listed in the instance configuration although nothing used them any more.

0.10.4 (2026-09-02)

• Fixed: A malformed reply from parcel.app (empty body or a broken delivery entry) no longer aborts the poll with a cryptic internal message — it is reported as an API problem and retried next poll.
• Fixed: A brief ioBroker database hiccup while marking the connection as online was mistaken for a parcel.app failure and switched the connection indicator to red.
• Fixed: Scripts that call checkConnection with a non-text API key now receive the regular "API key is too short" reply instead of an internal failure.
• Improved: Control characters in texts coming from parcel.app (carrier names, status notes) are now stripped completely before they reach the states.

License

MIT License

Copyright (c) 2026 krobi krobi@power-dreams.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Developed with assistance from Claude.ai