Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Zasób Tracking
reprezentuje obiekt z informacjami o aktualnym stanie przesyłki w procesie logistycznym. Za jego pomocą można uzyskać informacje o utworzeniu przesyłki, ostatniej zmianie statusu czy też historii statusów.
Info |
---|
Listę statusów występujących w trackingu można pobrać korzystając z [1.2.0] Statusy |
Info |
---|
Tracking nie jest dostępna na środowisku sandboxowym. Nie są zwracane statusy |
Na tej stronie
Table of Contents |
---|
Uwierzytelnianie
Zasób Tracking nie jest autoryzowany, nie jest wymagane podanie tokenu.
Struktura
Zasób Tracking
posiada następujące atrybuty:
Atrybut | Typ | Opis |
---|---|---|
| String | Numer przesyłki |
| String | Rodzaj przesyłki. Dostępne rodzaje opisane są na stronie [1.9.1] Rozmiary i usługi dla przesyłek |
| String | Rodzaj przesyłki. Dostępne rodzaje opisane są na stronie [1.9.1] Rozmiary i usługi dla przesyłek |
| Object | Dodatkowe atrybuty dla przesyłek paczkomatowychPaczkomat®. |
| String | Status w jakim aktualnie znajduje się przesyłka. |
| DateTime | Data utworzenia przesyłki. |
| DateTime | Data ostatniej aktualizacji informacji o zmianie statusu. |
| Array | Tablica obiektów zawierające historię zmian statusów, posortowana chronologicznie w kolejności malejącej (ostatni status jest pierwszy na liście). |
| Array | Tablica przewidywanych statusów, przez które może przejść jeszcze określona przesyłka. |
Dodatkowe atrybuty dla przesyłek paczkomatowych Paczkomat® custom_attributes
Atrybut | Typ | Opis |
---|---|---|
| String | Rozmiar przesyłki [A, B, C] |
| String | Nazwa paczkomatu Paczkomat® odbiorczego. |
| Hash | Dodatkowe parametry paczkomatu Paczkomat® odbiorczego. |
| String | Nazwa paczkomatu Paczkomat® nadawczego. |
| Hash | Dodatkowe parametry paczkomatu Paczkomat® nadawczego. |
Tablica obiektów zawierające historię zmian statusów, posortowana chronologicznie w kolejności malejącej (ostatni status jest pierwszy na liście) tracking_details
Atrybut | Typ | Opis |
---|---|---|
| String | Nazwa statusu |
| String | Symbol statusu Lista statusów które posiadają przypisany origin_status |
| String | Nazwa agencji |
| String | Czas zmiany statusu |
Przykład zasobu Tracker
w formacie JSON:
|
Historia przesyłki
Pobieranie informacji o zmianach statusów dla określonej przesyłki:
Code Block | ||
---|---|---|
| ||
GET /v1/tracking/:tracking_number |
Przykład zapytania
Code Block | ||
---|---|---|
| ||
curl -X GET https://api-shipx-pl.easypack24.net/v1/tracking/612345678901234567890123 -H 'content-type: application/json' |
Odpowiedź
Gdy podany numer przesyłki jest poprawny i zostały odnalezione informacje o przesyłce, serwer zwróci odpowiedź jak poniżej:
language | json |
---|
|
Historia przesyłki
Pobieranie informacji o zmianach statusów dla określonej przesyłki:
|
Przykład zapytania
|
Odpowiedź
Gdy podany numer przesyłki jest poprawny i zostały odnalezione informacje o przesyłce, serwer zwróci odpowiedź jak poniżej:
|
Przykład odpowiedzi w sytuacji gdy informacje o przesyłce nie zostały odnalezione:
|
Przykład odpowiedzi w sytuacji, gdy system nie był w stanie rozpoznać rodzaju przesyłki na podstawie podanego numeru:
|
Historia serwisu przesyłek
Paczki mieszane mogą zmieniać swój serwis w tracie procesu logistycznego.
Historię ostatniego serwisu paczki można przeglądać, odpytują poniższy zasób:
Przykład zapytania
|
Przykład odpowiedzi
|