Releases: ha-parcel-integrations/ha-4px
Release list
0.10.0
New features
- skip already-delivered parcels when checking for updates, since their status can't change anymore — they still stay visible as sensors and in the delivered history for as long as configured
🙋 2 open questions need a real parcel to answer
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.4
Other improvements
- maintenance release: attach the HACS release archive
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.3
Bug fixes
- stop logging an unrecognised status warning for parcels with no tracking events yet
🙋 2 open questions need a real parcel to answer
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.2
Other improvements
- Raised the minimum supported Home Assistant version to 2024.12.
🙋 Open questions still need a real parcel to answer
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.1
Bug fixes
- Map 14 previously unrecognised status codes seen on real parcels, including delivery-failed (
FPX_D_FD), which now correctly reportsprobleminstead ofunknown.
🙋 Open questions need a real parcel to answer
📦 See every supported carrier — new ones land regularly.
💛 Support the project
0.9.0
The first release of the 4PX integration — tracking for the cross-border parcels 4PX carries between China and their final destination.
No account is needed: you enter the tracking code, and 4PX's own public tracking endpoint does the rest.
New features
- Per-parcel sensors with the canonical status, a link to the 4PX tracking page, and the sender/receiver country or area.
- Summary sensors — incoming parcels and recently delivered parcels, each carrying the full parcel list as an attribute so one dashboard card can render everything.
- Events and device triggers for parcel registered, status changed and delivered, so automations don't need to poll anything themselves.
fourpx.track_parcel/fourpx.untrack_parcelservices, so a dashboard button can add a parcel without opening the integration options.- Opt-in status history — the full journey timeline per parcel, at no extra request since 4PX ships it in the same response.
- A manual refresh button and a diagnostic sensor showing when 4PX was last polled successfully.
Known limitations — and how you can help
This release is built and tested against one confirmed real delivery, so it ships conservatively:
- Only a handful of status codes are mapped so far. An unrecognised one reports
unknownrather than guessing, and writes a one-time log line with a ready-made issue link. - Timestamps use 4PX's own UTC-offset field; its plain display-time field is not yet trusted for local time, since the one journey we've seen it on crossed several time zones.
That's exactly why this is 0.9.0 rather than 1.0.0 — a second real journey, especially an unusual one (a delay, a return, a customs hold), is what moves it to a stable release.
Installation
Add https://github.com/ha-parcel-integrations/ha-4px to HACS as a custom repository, install 4PX, and restart Home Assistant.
🙋 Open questions need a real parcel to answer
📦 See every supported carrier — new ones land regularly.
💛 Support the project