Repository navigation
Releases: ha-parcel-integrations/ha-ppl-cz
Release list
1.0.1
Bug fixes
- give the Deliveries calendar its truck icon
The Deliveries calendar previously showed the generic Home Assistant calendar icon instead of the delivery truck icon used elsewhere.
📦 See every supported carrier — new ones land regularly.
💛 Support the project
1.0.0
Bug fixes
- count a parcel redirected to a pickup point after a missed home delivery under the Awaiting pickup sensor, not only parcels addressed directly to a pickup point
- give the Awaiting pickup sensor the same name as in the other parcel integrations across all languages, without changing existing sensors' entity IDs
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.12.0
New features
- add a credential-free way to track PPL CZ parcels by entering each tracking number and its direction by hand instead of signing in with a mojePPL account, which also brings a deliveries calendar and a real parcel weight that the account login can't provide; existing account setups are unaffected and keep working exactly as before
Bug fixes
- stop repeatedly asking to reconnect PPL CZ when the mojePPL sign-in is actually fine, since a mojePPL account can only be signed in on one device at a time and connecting Home Assistant will sign the mobile app out (and vice versa) — the setup screen, reconnect screen, and README now explain this, the reconnect prompt names the likely cause instead of a generic expired session, PPL's own error code is logged for easier diagnosis, and only a genuine credential rejection triggers the reconnect flow instead of every transient server error
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.11.0
New features
- always check PPL CZ on the adaptive schedule that speeds up while a parcel is out for delivery, slows down while it's still on its way, and stays quiet overnight apart from two catch-up checks, so the old "Refresh every" setting is gone and existing installs move over automatically with nothing to change, and your account is still checked regularly enough that a parcel added outside Home Assistant still shows up on its own
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.10.1
Other improvements
- maintenance release: attach the HACS release archive
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.10.0
New features
-
Automatic polling — Refresh every can now be set to Automatic instead of a fixed number of minutes. New installs default to it; existing installs keep their current fixed value until you switch. Automatic adjusts how often PPL CZ is checked based on what your parcels are actually doing:
- No polling between 00:00–06:00 local time, aside from one catch-up check right at each end of that window, so an overnight update is never missed.
- Checks every 15 minutes the moment a tracked parcel goes out for delivery — PPL CZ never reports a delivery window, so there's no earlier point to start from.
- Checks every 45 minutes otherwise — this is also the minimum cadence, since it's the only way to discover a new shipment that appeared in your account.
- Delivered parcels never affect the cadence — only what's still in transit counts.
- A small, fixed per-install offset is added on top, so not every PPL CZ installation polls at exactly the same second.
This is opt-in for now, but it's expected to become the default — and eventually the only — polling behaviour across the parcel-integrations suite. If you try Automatic, we'd genuinely like to hear how it goes: share your experience in this discussion.
-
A new Awaiting pickup sensor.
Other improvements
- PPL CZ never tells us a delivery window up front, so from this version the integration quietly checks, once per active shipment, whether an undocumented endpoint actually has one. If your logs ever show a
WARNINGmentioningdeliveryInfo, that's it working — please share it (via the issue link in the log line, or in this discussion). It's the one thing that could let a future release show a real delivery window for PPL CZ, and it can only be confirmed from a real account.
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.4
Bug fixes
- Fixed a recurring authentication failure where the account session would eventually stop refreshing until Home Assistant was restarted. The integration was sharing Home Assistant's aiohttp session with every other integration, and Azure's login service kept stamping cookies onto it that accumulated over time and eventually broke the login exchange. It now uses its own session that never stores cookies.
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.0
A custom Home Assistant integration that tracks your PPL CZ (mojePPL) parcels. Log in with your e-mail and a one-time PIN — no password to store — and it automatically tracks every parcel on your account, both the ones you're receiving and the ones you sent.
New features
- Automatic import of every parcel on your mojePPL account — no manual tracking numbers
- Both directions: parcels you're receiving and parcels you sent, each with their own sensors
- Passwordless login: e-mail plus a one-time PIN, no password stored, with automatic session renewal
- Per-parcel sensor with the canonical status (
registered/in_transit/at_pickup_point/delivered/ …), PPL CZ's own status text and a tracking deep-link - Summary sensors: incoming, outgoing, and recently delivered parcels in both directions
- Events and device triggers for no-code automations (parcel registered, status changed, delivered — incoming and outgoing)
- Opt-in per-parcel status history
- Manual refresh button and a diagnostic last-update sensor
- Part of the ha-parcel-integrations family: the same canonical parcel format, statuses and events as the other carrier integrations, so it plugs straight into the Parcel Aggregator and cross-carrier automations
Why 0.9.0, not 1.0.0
Login, the PIN exchange and polling the account inbox are all confirmed live, end-to-end, against a real mojePPL account. What hasn't happened yet is seeing a populated parcel: the account used to verify this integration had no shipments on it, so the exact shape of a real parcel is reconstructed from the app itself rather than observed. Every field is guarded defensively — a mismatch reports unknown rather than a wrong status — and logs a one-shot warning with a ready-made issue link. If you have a real PPL CZ shipment, that's exactly what closes this out.
Known limitations
- No weight, dimensions or expected delivery window — PPL CZ's account API exposes none of them.
delivered_atonly gets a real timestamp when the opt-in status-history option is on; PPL CZ's parcel list carries no delivered date on its own.
📦 See every supported carrier — new ones land regularly.
💛 Support the project