Status Mapping: ShipX PL → Global Tracking
As part of the transition described in the Migration Guide, tracking parcels was consolidated into InPost Global API, enabling single integration for all InPost markets. If your integration currently reads shipment status from the ShipX PL API or webhook, this page will help you find Global Tracking equivalent code.
Who is it for?
This guide is intended for merchants and integrators migrating parcel tracking from ShipX PL to Global Tracking. If you're looking for the broader migration scope (authentication, shipment creation, labels, pickups), see the Migration Guide.
Mapping
For the full catalogue of event codes, giving you enhanced visibility — see Tracking Events.
| ShipX PL Status | ShipX PL Title | Global Tracking Status | Global Tracking Title | Condition |
|---|---|---|---|---|
| accepted_from_courier_by_warehouse | MMD.1001 | [Generic] Adopted at Logistics Centre | ||
| adopted_at_sorting_center | Przyjęta w Sortowni. | MMD.1001 | [Generic] Adopted at Logistics Centre | |
| adopted_at_source_branch | Przyjęta w oddziale InPost. | MMD.1001 | [Generic] Adopted at Logistics Centre | |
| adopted_at_target_branch | Przyjęta w Oddziale Docelowym. | MMD.1001 | [Generic] Adopted at Logistics Centre | |
| avizo | Powrót do oddziału. | LMD.9014 | Uncollected Parcel- Return to sender initiated | |
| canceled | Anulowano etykietę. | EOL.9004 | Cancelled | |
| canceled_redirect_to_box | Anulowano przekierowanie. | LMD.3012 | Redirect cancelled | |
| claimed | Zareklamowana w automacie Paczkomat. | FMD.9001 | Parcel claimed | |
| collected_from_sender | Odebrana od klienta. | FMD.1002 | [Generic] Collected by courier | |
| confirmed | Przygotowana przez Nadawcę. | CRE.1001 | [Generic] Parcel Creation | Standard shipment |
| confirmed | Przygotowana przez Nadawcę. | RTS.1001 | [Generic] Returning to Sender | Returning to sender |
| courier_avizo_in_customer_service_point | Oczekuje na odbiór. | LMD.9013 | Parcel ready to collect at customer service point | |
| created | Przesyłka utworzona. | CRE.1001 | [Generic] Parcel Creation | |
| delay_in_delivery | Możliwe opóźnienie doręczenia. | INF.9001 | Delay in Delivery | |
| delivered | Dostarczona. | EOL.1001 | [Generic] Delivered | Location Type: address, logisticsCentre |
| delivered | Dostarczona. | EOL.1002 | Parcel collected | Location Type: lockerPoint, pudoPoint |
| delivered | Dostarczona. | RTS.1002 | [Generic] Returned to Sender | Returned to sender |
| dispatched_by_sender | Paczka nadana w automacie Paczkomat. | FMD.1001 | [Generic] Ready for courier collection | |
| dispatched_by_sender_to_pok | Nadana w PaczkoPunkcie. | FMD.1001 | [Generic] Ready for courier collection | |
| missing | EOL.9001 | Missing | ||
| out_for_delivery | Przekazano do doręczenia. | LMD.1001 | [Generic] In-transit (last-mile) | |
| out_for_delivery_to_address | W doręczeniu. | LMD.1001 | [Generic] In-transit (last-mile) | |
| oversized | Przesyłka ponadgabarytowa. | LMD.9003 | Oversized | |
| pickup_reminder_sent | Przypomnienie o czekającej paczce. | LMD.9001 | Reminder to collect | |
| pickup_reminder_sent_address | W doręczeniu. | LMD.9004 | [Generic] Attempted delivery | |
| pickup_time_expired | Upłynął termin odbioru. | LMD.9002 | Expired | |
| readdressed | Przekierowano na inny adres. | LMD.3006 | Delivery readdressed | |
| ready_to_pickup | Umieszczona w automacie Paczkomat (odbiorczym). | LMD.1005 | Ready to collect APM | Location Type: lockerPoint |
| ready_to_pickup_from_branch | Paczka nieodebrana – czeka w Oddziale | LMD.3004 | Branch collection assigned | |
| ready_to_pickup_from_pok | Czeka na odbiór w PaczkoPunkcie. | LMD.1004 | Ready to collect PUDO | Location Type: pudoPoint |
| redirect_to_box | Przekierowano do automatu Paczkomat. | LMD.3013 | Redirected to PUDO by recipient | Location Type: pudoPoint |
| redirect_to_box | Przekierowano do automatu Paczkomat. | LMD.3014 | Redirected to APM by recipient | Location Type: lockerPoint |
| rejected_by_receiver | Odmowa przyjęcia. | LMD.9006 | Undeliverable: Rejected by recipient | |
| returned_to_sender | Zwrot do nadawcy. | RTS.1002 | [Generic] Returned to Sender | |
| sent_from_source_branch | W trasie. | MMD.1004 | [Generic] Line-Haul | |
| sent_from_sorting_center | Wysłana z Sortowni. | MMD.1004 | [Generic] Line-Haul | |
| sent_to_client_hub | HAN.1001 | [Generic] Handover | ||
| sent_to_client_hub-fix | HAN.1001 | [Generic] Handover | ||
| stack_in_box_machine | Paczka magazynowana w tymczasowym automacie Paczkomat | LMD.9012 | Stored temporary in a box machine | |
| stack_in_customer_service_point | Paczka magazynowana w PaczkoPunkcie. | LMD.3007 | Stored temporary in a service point | |
| stack_parcel_in_box_machine_pickup_time_expired | Upłynął termin odbioru paczki magazynowanej | LMD.3009 | Expired on temporary box machine | |
| stack_parcel_pickup_time_expired | Upłynął termin odbioru paczki magazynowanej. | LMD.3011 | Expired on temporary collection point | |
| taken_by_courier | Odebrana od Nadawcy. | FMD.1002 | [Generic] Collected by courier | |
| taken_by_courier_from_customer_service_point | Zwrócona do nadawcy. | LMD.9014 | Uncollected Parcel- Return to sender initiated | |
| taken_by_courier_from_pok | W drodze do oddziału nadawczego InPost. | FMD.1002 | [Generic] Collected by courier | |
| undelivered | Przekazanie do magazynu przesyłek niedoręczalnych. | LMD.9005 | [Generic] Undeliverable | |
| undelivered_cod_cash_receiver | Brak możliwości doręczenia. | LMD.9009 | Undeliverable: COD conditions not met | |
| undelivered_incomplete_address | Brak możliwości doręczenia. | LMD.9007 | Undeliverable: Incorrect delivery details | |
| undelivered_lack_of_access_letterbox | Brak możliwości doręczenia. | LMD.9010 | Undeliverable: No mailbox | |
| undelivered_no_mailbox | Brak możliwości doręczenia. | LMD.9010 | Undeliverable: No mailbox | |
| undelivered_unknown_receiver | Brak możliwości doręczenia. | LMD.9008 | Undeliverable: Receiver unknown | |
| undelivered_wrong_address | Brak możliwości doręczenia. | LMD.9015 | Delivery Attempt - Incorrect Delivery Details | |
| unstack_from_box_machine | Paczka w drodze do pierwotnie wybranego automatu Paczkomat | LMD.3005 | Original collection point reassigned | |
| unstack_from_customer_service_point | W drodze do wybranego automatu Paczkomat. | LMD.3005 | Original collection point reassigned |
How to read above table?
Each row maps one ShipX PL status to its corresponding Global Tracking event code. Some statuses are more granular in the newest approach, hence ShipX PL status may map to multiple new events.
Global Tracking event codes follow a PREFIX.CODE format, where the prefix identifies the stage of the parcel's journey:
| Prefix | Stage | Meaning |
|---|---|---|
CRE | Creation | The parcel has been created in the system. |
FMD | First-Mile Delivery | The parcel is starting its journey and being handed to a courier. |
MMD | Mid-Mile Delivery | The parcel has been received at a logistics centre. |
LMD | Last-Mile Delivery | The parcel is on its way to, or waiting at, its final destination. |
EOL | End of Life | The parcel's journey has concluded (delivered or cancelled). |
RTS | Return to Sender | The parcel is being returned to the sender. |
HAN | Handover | The parcel is being handed over to another party (e.g. a carrier hub). |
Additional notes
- Redirected parcels: In ShipX PL, a redirected parcel's history is shown as two separate journeys. In Global Tracking, the same parcel's history is consolidated into a single, continuous journey — including the point where the redirect occurred and its new destination.
- Location-dependent mappings: A few ShipX PL statuses (for example
redirect_to_box) map to different Global Tracking codes depending on the location type of the destination point (Locker, Pickup Point, or other). Always check the Condition column before hard-coding a 1:1 mapping. - Redundant ShipX PL statuses: Some ShipX PL statuses that appear semantically distinct (e.g.
taken_by_courier,taken_by_courier_from_pok,collected_from_sender) map to the same Global Tracking code (FMD.1002) because they represent the same stage of the parcel journey from the customer's perspective.
ShipX PL codes without a Global Tracking equivalent
The following ShipX PL statuses have no corresponding GT event. If your integration currently reacts to any of these, it will not receive an equivalent event after migrating — you'll need to adapt that logic or remove its dependency on these signals.
| ShipX PL Status | ShipX PL Title |
|---|---|
| offer_selected | Oferta wybrana. |
| offers_prepared | Przygotowano oferty. |
| other | Inny status. |
| ready_to_pickup_from_pok_registered | Czeka na odbiór w PaczkoPunkcie. |
| return_pickup_confirmation_to_sender | Przygotowano dokumenty zwrotne. |
| undelivered_not_live_address | Brak możliwości doręczenia. |
Related resources
- Migration Guide — full scope of migration to global APIs.
- Tracking Events — complete catalogue of Global Tracking event codes, payloads, and webhook subscriptions.
- Webhook Signature Verification — secure your webhook endpoint before switching over tracking notifications.