> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/metodi-1/metodi/readme/vidpravlennya/vidstezhennya-vidpravlennya.md). # Відстеження відправлення ## Базове відстеження > Цей API-метод дозволяє отримати статус відправлення, вказавши номер транспортного документа. Зазначивши номер документа в запиті, ви можете отримати інформацію про поточне місцезнаходження або статус відправлення, надаючи клієнтам оновлення в режимі реального часу щодо переміщення їхнього вантажу.\
\ > 🔸Цей метод працює \*\*лише з номером транспортного документа (номером відправлення)\*\* і \*\*не підтримує пошук за номерами замовлень клієнта або будь-якими зовнішніми ідентифікаторами\*\*.\
\ > 🔸\*\*Базове відстеження\*\* надає спрощену відповідь відстеження, зосереджену на історії статусів відправлення та, за потреби, пов'язаних номерах відправлень. На відміну від \*\*Повне відстеження\*\*, цей метод не повертає детальну інформацію про маршрут, дані на рівні окремих місць, причини недоставки, записи про повернення/переадресацію або розширені метадані. Цей метод призначений для швидкої та легкої перевірки статусів.\ > \ > 🔹\*\*Опис елементів керування:\*\*\ > \ > \*\*SCHEMA\*\*\
\ > Відображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.\ > \- \*\*Single line description\*\*\
\ > Опис, який вміщується в один рядок; текст, що не вміщується, залишається прихованим.\ > \- \*\*Multiline description\*\*\
\ > Розширений опис, який відображає більше одного рядка тексту.\ > \ > \*\*EXAMPLE\*\*\
\ > Показує готовий приклад JSON з коректно заповненими значеннями, щоб продемонструвати, як має виглядати валідний запит або відповідь.
```json {"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[{"name":"Shipments"}],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.com/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"Authorization","description":"JWT-токен авторизації зі строком дії 1 годину у заголовку"}},"responses":{"Unauthorized":{"description":"Неавторизований доступ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Вказаний ресурс не знайдено","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Validation":{"description":"Помилка валідації","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Час очікування з’єднання вичерпано","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/tracking/history":{"get":{"tags":["Shipments"],"description":"Цей API-метод дозволяє отримати статус відправлення, вказавши номер транспортного документа. Зазначивши номер документа в запиті, ви можете отримати інформацію про поточне місцезнаходження або статус відправлення, надаючи клієнтам оновлення в режимі реального часу щодо переміщення їхнього вантажу.
\n🔸Цей метод працює **лише з номером транспортного документа (номером відправлення)** і **не підтримує пошук за номерами замовлень клієнта або будь-якими зовнішніми ідентифікаторами**.
\n🔸**Базове відстеження** надає спрощену відповідь відстеження, зосереджену на історії статусів відправлення та, за потреби, пов'язаних номерах відправлень. На відміну від **Повне відстеження**, цей метод не повертає детальну інформацію про маршрут, дані на рівні окремих місць, причини недоставки, записи про повернення/переадресацію або розширені метадані. Цей метод призначений для швидкої та легкої перевірки статусів.\n\n🔹**Опис елементів керування:**\n\n**SCHEMA**
\nВідображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.\n- **Single line description**
\n Опис, який вміщується в один рядок; текст, що не вміщується, залишається прихованим.\n- **Multiline description**
\n Розширений опис, який відображає більше одного рядка тексту.\n\n**EXAMPLE**
\nПоказує готовий приклад JSON з коректно заповненими значеннями, щоб продемонструвати, як має виглядати валідний запит або відповідь.\n","parameters":[{"in":"query","name":"numbers[]","description":"Номери відправлень. Може приймати як один номер, так і масив номерів.","schema":{"type":"string"}},{"in":"query","name":"extended","description":"Параметр, що відповідає за включення до відповіді масиву об'єктів зі списком усіх пов'язаних відправлень.\n\nЩоб отримати ці дані у відповіді, встановіть значення `1`.\n","schema":{"type":"string","default":0},"required":false}],"responses":{"200":{"description":"Схема відповіді відстеження","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Масив елементів в інвойсі.","items":{"type":"object","properties":{"id":{"type":"string","description":"Ідентифікатор транспортного документа."},"number":{"type":"string","description":"Номер транспортного документа."},"history_tracking":{"type":"array","description":"Масив статусів історії відстеження для зазначеного відправлення.","items":{"type":"object","properties":{"code":{"type":"string","description":"Номер коду статусу відстеження.\n\n**Список доступних статусів із їх кодами та описом їхнього значення:**\n\n- `1` — Ready to send\n- `2` — Deleted\n- `4` — Accepted for sending\n- `5` — Sent from the Sender''s Division\n- `6` — Arrived in the city of the Recipient\n- `7` — Arrived (at the Division)\n- `8` — Arrived (at the Postomat)\n- `9` — Closed\n- `10` — The shipment is closed and the money transfer is sent to the Sender\n- `11` — The shipment is closed and the sender has received the money transfer\n- `13` — Arrival at the transit sorting center\n- `16` — Departure from the transit sorting center\n- `17` — ArrivalTransitWarehouse (currently not used)\n- `19` — DepartureFromTransitWarehouse (currently not used)\n- `30` — Arrived at customs terminal\n- `31` — Departed from customs terminal\n- `99` — Delivery to Postomat is impossible (technical issues or oversized parcel)\n- `101` — Uploaded to the courier for delivery to the address\n- `102` — Returns (sender ordered a return)\n- `103` — Refusal of shipment\n- `104` — Redirecting\n- `105` — Utilization\n- `106` — Received and created return shipment of Documents/Document Subtypes\n- `110` — Shipment transferred to temporary storage\n- `111` — Failed delivery attempt (in case of targeted delivery)\n- `112` — Delivery date postponed (for targeted delivery)\n- `113` — Storage period expired (Postomat)\n- `114` — Awaiting customs clearance\n- `115` — Arrived at customs terminal\n- `116` — Broker refusal — under resolution\n- `117` — Cargo not found or lost (customs)\n- `118` — Forbidden content — delivery impossible (customs)\n- `119` — Customs clearance in progress\n- `120` — Customs clearance completed\n- `121` — Sent to destination city after customs\n- `122` — Preparing for transfer to customs\n- `123` — Awaiting information from the recipient\n- `125` — Preparing for transfer to customs\n- `126` — Preparing for transfer to customs\n- `127` — Customs declaration data verification in progress\n- `128` — Processing accompanying documents prior to customs\n- `130` — Import prohibited by customs\n- `131` — Return of uncleared cargo\n- `132` — Preparing for return\n- `133` — Client communication regarding a customs comment\n- `134` — The international shipment has been handed over to the customs broker for processing\n- `135` — The international shipment has been placed in Storage Area\n- `138` — Shipment delay due to incorrect recipient information\n- `141` — Storage period expired\n- `144` — Storage period expired\n- `149` — In storage\n- `155` — Shipment transferred for disposal\n- `197` — Processing customs documents\n- `198` — Cargo inspection by customs\n- `199` — Shipment requires customs clearance\n- `999` — Undetermined\n"},"code_name":{"type":"string","description":"Назва статусу відстеження.\n\nЯкщо в запиті передано параметр `extended`=`1`, це поле у відповіді міститиме детальну назву статусу відстеження.\n\n🔸**Це поле надається лише для інформаційних цілей, і його значення може змінюватися з часом. Для обробки статусів відстеження рекомендується використовувати поле** `history_tracking.code`.\n"},"country_code":{"type":"string","description":"Код країни місця, у якому було створено статус відстеження."},"settlement":{"type":"string","description":"Назва населеного пункту місця, у якому було створено статус відстеження."},"date":{"type":"string","description":"Дата й час створення статусу відстеження."}}}},"related_numbers":{"type":"array","description":"Масив об'єктів, що містить список пов'язаних відправлень.\n\n🔸**Номери відправлень, наведені тут, можуть змінюватися.**\n","items":{"type":"string"}}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Validation"},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"Базове відстеження"}}}} ``` ## Повне відстеження > Цей API-метод дозволяє отримати статус відправлення, вказавши номер транспортного документа. Зазначивши номер документа в запиті, ви можете отримати інформацію про поточне місцезнаходження або статус відправлення, надаючи клієнтам оновлення в режимі реального часу щодо переміщення їхнього вантажу.\ > \ > За замовчуванням відповідь містить такі блоки даних:\ > \- Поточний статус відправлення;\ > \- Історія відстеження;\ > \- Актуальна історія відстеження;\ > \- Опис відправлення;\ > \- Розширена інформація про пов'язані відправлення.\ > \ > За потреби до відповіді можна включити додаткові блоки, передавши відповідні параметри:\ > \- \`withUndeliveryReason = true\` — додає масив об'єктів з інформацією про причини недоставки відправлень.\ > \- \`withCreatedOnTheBasis = true\` — додає масив об'єктів з інформацією про повернення або переадресації, пов'язані з відправленням.\ > \ > 🔸\*\*Повне відстеження\*\* надає вичерпну відповідь відстеження, що містить детальні дані про статус відправлення, повну історію переміщення, опис місць, причини недоставки та інформацію про пов'язані або похідні відправлення. На відміну від \*\*Базового відстеження\*\*, воно надає розширені операційні дані та призначене для випадків, коли потрібна повна видимість логістичного життєвого циклу відправлення.\ > \ > 🔹\*\*Опис елементів керування:\*\*\ > \ > \*\*SCHEMA\*\*\
\ > Відображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.\ > \- \*\*Single line description\*\*\
\ > Опис, який вміщується в один рядок; текст, що не вміщується, залишається прихованим.\ > \- \*\*Multiline description\*\*\
\ > Розширений опис, який відображає більше одного рядка тексту.\ > \ > \*\*EXAMPLE\*\*\
\ > Показує готовий приклад JSON з коректно заповненими значеннями, щоб продемонструвати, як має виглядати валідний запит або відповідь.
```json {"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[{"name":"Shipments"}],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.com/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","in":"header","name":"Authorization","description":"JWT-токен авторизації зі строком дії 1 годину у заголовку"}},"responses":{"Unauthorized":{"description":"Неавторизований доступ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Вказаний ресурс не знайдено","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Validation":{"description":"Помилка валідації","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Час очікування з’єднання вичерпано","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/tracking":{"get":{"tags":["Shipments"],"description":"Цей API-метод дозволяє отримати статус відправлення, вказавши номер транспортного документа. Зазначивши номер документа в запиті, ви можете отримати інформацію про поточне місцезнаходження або статус відправлення, надаючи клієнтам оновлення в режимі реального часу щодо переміщення їхнього вантажу.\n\nЗа замовчуванням відповідь містить такі блоки даних:\n- Поточний статус відправлення;\n- Історія відстеження;\n- Актуальна історія відстеження;\n- Опис відправлення;\n- Розширена інформація про пов'язані відправлення.\n\nЗа потреби до відповіді можна включити додаткові блоки, передавши відповідні параметри:\n- `withUndeliveryReason = true` — додає масив об'єктів з інформацією про причини недоставки відправлень.\n- `withCreatedOnTheBasis = true` — додає масив об'єктів з інформацією про повернення або переадресації, пов'язані з відправленням.\n\n🔸**Повне відстеження** надає вичерпну відповідь відстеження, що містить детальні дані про статус відправлення, повну історію переміщення, опис місць, причини недоставки та інформацію про пов'язані або похідні відправлення. На відміну від **Базового відстеження**, воно надає розширені операційні дані та призначене для випадків, коли потрібна повна видимість логістичного життєвого циклу відправлення.\n\n🔹**Опис елементів керування:**\n\n**SCHEMA**
\nВідображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.\n- **Single line description**
\n Опис, який вміщується в один рядок; текст, що не вміщується, залишається прихованим.\n- **Multiline description**
\n Розширений опис, який відображає більше одного рядка тексту.\n\n**EXAMPLE**
\nПоказує готовий приклад JSON з коректно заповненими значеннями, щоб продемонструвати, як має виглядати валідний запит або відповідь.\n","parameters":[{"in":"query","name":"numbers[]","description":"Номери відправлень. Може приймати як один номер, так і масив номерів.","schema":{"type":"string"}},{"in":"query","name":"ids[]","description":"Пошук відправлень за ідентифікаторами транспортних документів. Може приймати як один ідентифікатор, так і масив ідентифікаторів для виконання пошуку.","schema":{"type":"integer","format":"int32"}},{"in":"query","name":"withUndeliveryReason","description":"Параметр, що відповідає за включення до відповіді масиву об'єктів з інформацією про причини недоставки.\n\nЩоб отримати ці дані у відповіді, встановіть значення `true`.\n","schema":{"type":"boolean","default":false},"required":false},{"in":"query","name":"withCreatedOnTheBasis","description":"Параметр, що відповідає за включення до відповіді масиву об'єктів з інформацією про пов'язані відправлення (типи: `Redirecting`, `Return`, `Utilization`, `Redelivery`).\n\nЩоб отримати ці дані у відповіді, встановіть значення `true`.\n","schema":{"type":"boolean","default":false},"required":false},{"in":"query","name":"countryCode","description":"Дволітерний код країни відправника відповідно до стандарту ISO 3166-1 Alpha-2.\n\nЯкщо цей параметр указано, Історія відстеження та Актуальна історія відстеження відображатимуться лише для зазначеної країни.\n\nPattern: ^[A-Z]{2}$\n","schema":{"type":"string"}},{"in":"query","name":"external","description":"Параметр, що відповідає за включення до відповіді масиву об'єктів зі списком усіх пов'язаних відправлень, а також масиву, що містить розширену інформацію про ці відправлення — зокрема ім'я власника відправлення, номер відправлення та дату створення відправлення.\n\nЩоб отримати ці дані у відповіді, встановіть значення `1`.\n","schema":{"type":"string","default":0},"required":false},{"in":"query","name":"trackingByBarcode","description":"Система фільтрує агреговані дані та повертає інформацію лише для зазначеного місця. Це дозволяє відстежувати маршрут доставки конкретного місця у складі багатомісного відправлення.","schema":{"type":"string"},"required":false},{"in":"query","name":"withAllParcels","description":"Система агрегує події з усіх місць в один масив, згрупований за номером місця. Це дозволяє відстежувати маршрут доставки кожного місця у складі багатомісного відправлення.\n","schema":{"type":"boolean","default":false},"required":false}],"responses":{"200":{"description":"Схема відповіді відстеження","content":{"application/json":{"schema":{"type":"object","properties":{"currentStatus":{"type":"array","description":"Масив об'єктів, що містить детальну інформацію про поточний статус відправлення.","items":{"type":"object","properties":{"number":{"type":"string","description":"Номер відправлення."},"createdDate":{"type":"string","format":"date-time","description":"Дата створення відправлення.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"scheduledDate":{"type":"string","format":"date-time","description":"Розрахункова дата доставки.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"scheduledDateOriginal":{"type":"string","format":"date-time","nullable":true,"description":"Початкова розрахункова дата доставки.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"adjustedDate":{"type":"string","format":"date-time","nullable":true,"description":"Скоригована дата доставки.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"closingDate":{"type":"string","format":"date-time","nullable":true,"description":"Дата закриття відправлення (завершення всіх операцій).\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"statusCode":{"type":"string","description":"Номер коду статусу відстеження.\n\n**Список доступних статусів із їх кодами та описом їхнього значення:**\n\n- `1` — Ready to send\n- `2` — Deleted\n- `4` — Accepted for sending\n- `5` — Sent from the Sender''s Division\n- `6` — Arrived in the city of the Recipient\n- `7` — Arrived (at the Division)\n- `8` — Arrived (at the Postomat)\n- `9` — Closed\n- `10` — The shipment is closed and the money transfer is sent to the Sender\n- `11` — The shipment is closed and the sender has received the money transfer\n- `13` — Arrival at the transit sorting center\n- `16` — Departure from the transit sorting center\n- `17` — ArrivalTransitWarehouse (currently not used)\n- `19` — DepartureFromTransitWarehouse (currently not used)\n- `30` — Arrived at customs terminal\n- `31` — Departed from customs terminal\n- `99` — Delivery to Postomat is impossible (technical issues or oversized parcel)\n- `101` — Uploaded to the courier for delivery to the address\n- `102` — Returns (sender ordered a return)\n- `103` — Refusal of shipment\n- `104` — Redirecting\n- `105` — Utilization\n- `106` — Received and created return shipment of Documents/Document Subtypes\n- `110` — Shipment transferred to temporary storage\n- `111` — Failed delivery attempt (in case of targeted delivery)\n- `112` — Delivery date postponed (for targeted delivery)\n- `113` — Storage period expired (Postomat)\n- `114` — Awaiting customs clearance\n- `115` — Arrived at customs terminal\n- `116` — Broker refusal — under resolution\n- `117` — Cargo not found or lost (customs)\n- `118` — Forbidden content — delivery impossible (customs)\n- `119` — Customs clearance in progress\n- `120` — Customs clearance completed\n- `121` — Sent to destination city after customs\n- `122` — Preparing for transfer to customs\n- `123` — Awaiting information from the recipient\n- `125` — Preparing for transfer to customs\n- `126` — Preparing for transfer to customs\n- `127` — Customs declaration data verification in progress\n- `128` — Processing accompanying documents prior to customs\n- `130` — Import prohibited by customs\n- `131` — Return of uncleared cargo\n- `132` — Preparing for return\n- `133` — Client communication regarding a customs comment\n- `134` — The international shipment has been handed over to the customs broker for processing\n- `135` — The international shipment has been placed in Storage Area\n- `138` — Shipment delay due to incorrect recipient information\n- `141` — Storage period expired\n- `144` — Storage period expired\n- `149` — In storage\n- `155` — Shipment transferred for disposal\n- `197` — Processing customs documents\n- `198` — Cargo inspection by customs\n- `199` — Shipment requires customs clearance\n- `999` — Undetermined\n"},"status":{"type":"string","description":"Назва коду статусу."},"statusDate":{"type":"string","format":"date-time","description":"Дата й час встановлення цього статусу.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"deliveryType":{"type":"string","description":"Тип доставки."},"deliveryCountry":{"type":"string","pattern":"^[A-Z]{2}$","description":"Дволітерний код країни призначення відповідно до стандарту ISO 3166-1 Alpha-2."}}}},"detailsTracking":{"type":"array","description":"Масив об'єктів, що містить детальну інформацію про весь маршрут переміщення відправлення, включаючи переміщення пов'язаних відправлень, якщо вони доступні.\n\nНе заповнюється, якщо використовується відстеження на рівні посилки (тобто коли передано `trackingByBarcode` або `withAllParcels` = `true`).\n","items":{"type":"object","properties":{"number":{"type":"string","description":"Номер відправлення."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Дата й час встановлення цього статусу.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"event":{"type":"string","description":"Назва події.\n\n**Доступні назви подій:**\n\n- `CreateID` — Shipment ID created\n- `CreateIDFullfilment` — Shipment ID created (fulfillment)\n- `Deleted` — Deleted\n- `CanceledSender` — Shipment cancelled by sender\n- `DeclarationDeleted` — Declaration cancelled\n- `ArrivalSenderWarehouse` — Arrival at sender’s warehouse\n- `ArrivalSenderPostomat` — Arrival at sender’s parcel locker\n- `ArrivalSenderDoors` — Courier picked up the shipment from sender\n- `DepartureSenderWarehouseFullfilment` — Shipped from sender's warehouse (fulfillment)\n- `DepartureSenderWarehouse` — Shipment dispatched from sender’s warehouse\n- `Departure` — Shipment\n- `Arrival` — Arrival\n- `DepartureSenderWarehouseFuture` — Shipment from sender’s warehouse (future event)\n- `DepartureFuture` — Shipment (future event)\n- `ArrivalFuture` — Arrival (future event)\n- `OnTheWayArrival` — En route to arrival point\n- `OnTheWayArrivalFuture` — En route to arrival point (future event)\n- `OnTheWayDeparture` — Shipment in transit\n- `OnTheWayDepartureFuture` — Shipment in transit (future event)\n- `ArrivalSenderDoorsFuture` — Courier picked up the shipment from sender (future event)\n- `ArrivalSenderCityDeliveryService` — Delivery service in recipient’s city (arrival)\n- `ArrivalTerminal` — Arrival at terminal\n- `ArrivalCustomsBrokerPartner` — Partner customs broker (arrival)\n- `DepartureDeliveryService` — Delivery service (dispatch)\n- `DepartureSenderCityDeliveryService` — Delivery service in sender’s city (dispatch)\n- `DepartureCustomsBrokerPartner` — Partner customs broker (dispatch)\n- `ArrivalDeliveryServiceFuture` — Delivery service (arrival, future event)\n- `ArrivalSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (arrival, future event)\n- `ArrivalTerminalFuture` — Arrival at terminal (future event)\n- `ArrivalCustomsBrokerPartnerFuture` — Partner customs broker (arrival, future event)\n- `DepartureDeliveryServiceFuture` — Delivery service (dispatch, future event)\n- `DepartureSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (dispatch, future event)\n- `DepartureTerminalFuture` — Dispatch from terminal (future event)\n- `DepartureTerminal` — Dispatch from terminal\n- `ArrivalDepot` — Arrival at depot\n- `DepartureDepot` — Dispatch from depot\n- `ArrivalDepotFuture` — Arrival at depot (future event)\n- `DepartureDepotFuture` — Dispatch from depot (future event)\n- `ArrivalSenderCityDepot` — Depot in sender’s city (arrival)\n- `DepartureSenderCityDepot` — Depot in sender’s city (dispatch)\n- `ArrivalSenderCityDepotFuture` — Depot in sender’s city (arrival, future event)\n- `DepartureSenderCityDepotFuture` — Depot in sender’s city (dispatch, future event)\n- `CustomsClearanceInitiated` — Customs clearance\n- `ArrivalSenderCityTerminal` — Terminal in sender’s city (arrival)\n- `ArrivalSenderCityTerminalFuture` — Terminal in sender’s city (arrival, future event)\n- `DepartureSenderCityTerminal` — Terminal in sender’s city (dispatch)\n- `DepartureSenderCityTerminalFuture` — Terminal in sender’s city (dispatch, future event)\n- `SentForCustomsClearance` — Sent for customs clearance\n- `CustomClearanceIsCompleted` — Customs processing completed\n- `SentToDestinationCountry` — Sent to destination city after customs\n- `ArrivalCustomTerminal` — Arrived at customs terminal\n- `ArrivalDeliveryService` — Delivery service (arrival)\n- `MovingPostomat` — Awaiting transportation / In transit to parcel locker\n- `InCityRecipientDeparture` — In recipient's city (dispatch)\n- `InCityRecipientArrival` — In recipient's city (arrival)\n- `InCityRecipientPlan` — In recipient's city (planned event)\n- `InCityRecipientFuture` — In recipient’s city (future event)\n- `InCityRecipient` — In recipient’s city\n- `InCityRecipientArrivalFuture` — In recipient’s city (future arrival event)\n- `InCityRecipientDepartureFuture` — In recipient’s city (future dispatch event)\n- `InCityRecipientPlanFuture` — In recipient’s city (future planned event)\n- `ArrivalDestinationDepot` — Destination city warehouse (arrival)\n- `DepartureDestinationDepot` — Destination city warehouse (dispatch)\n- `ArrivalDestinationDepotFuture` — Destination city warehouse (arrival, future event)\n- `DepartureDestinationDepotFuture` — Destination city warehouse (dispatch, future event)\n- `ArrivalDestinationDeliveryService` — Delivery service in recipient’s city (arrival)\n- `DepartureDestinationDeliveryService` — Delivery service in recipient’s city (dispatch)\n- `ArrivalDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (arrival, future event)\n- `DepartureDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (dispatch, future event)\n- `ArrivalDestinationTerminal` — Terminal in recipient’s city (arrival)\n- `ArrivalDestinationTerminalFuture` — Terminal in recipient’s city (arrival, future event)\n- `DepartureDestinationTerminal` — Terminal in recipient’s city (dispatch)\n- `DepartureDestinationTerminalFuture` — Terminal in recipient’s city (dispatch, future event)\n- `ArrivalSameSettlementImport` — Single locality (import, arrival)\n- `NoFreeSlotsInPostomat` — No free parcel locker cells available\n- `LoadingCourierForMoving` — Courier picked up the shipment\n- `ArrivalSameSettlementImportFuture` — Single locality (import, arrival, future event)\n- `ParcelWasTransferredToPartner` — Transferred to partner for further delivery\n- `ArrivalSameSettlementLocal` — Single locality (local, arrival)\n- `ArrivalSameSettlementLocalFuture` — Single locality (local, arrival, future event)\n- `ArrivalDuplicate` — Shipment pending processing at partner warehouse\n- `ArrivalDuplicatePassed` — Shipment was pending processing at partner warehouse\n- `DepartureDuplicate` — Shipment in the process of dispatching from partner warehouse\n- `DepartureDuplicatePassed` — Shipment was in dispatch process from partner warehouse\n- `InRouteDuplicate` — Shipment in transit — temporary partner-side delay\n- `InRouteDuplicatePassed` — Temporary partner-side delay resolved\n- `TransferPoint` — Transfer point\n- `MovingPoint` — At pickup point\n- `TransferPointPostomat` — Arrival at parcel locker\n- `ArrivalRecipientWarehouse` — Arrival at recipient’s warehouse\n- `ArrivalRecipientWarehouseFuture` — Arrival at recipient’s warehouse (future event)\n- `ArrivalRecipientPartnerWarehouse` — Arrived at partner warehouse\n- `ArrivalRecipientPostomat` — Arrived at recipient’s parcel locker\n- `ReceivedDoorsFuture` — Delivery to address (future event)\n- `ReceivedWarehouse` — Received at warehouse\n- `ReceivedDoors` — Delivered to address\n- `ReceivedPartner` — Shipment received by partner\n- `AlternativeDelivery` — Alternative delivery type applied (delivered to neighbor, left at the door, placed in mailbox, etc.)\n- `MoneyTransferAddress` — Money transfer (to address)\n- `MoneyTransfer` — Money transfer (to branch)\n- `MoneyTransferAddressFuture` — Money transfer (to address, future event)\n- `ArrivalSC` — Arrival at sorting center (SC)\n- `TransferToPartner` — Handed over to partner\n- `ArrivalTransitWarehouse` — Arrived at transit warehouse\n- `DepartureFromTransitWarehouse` — Departed from transit warehouse\n- `ProblemWithPostomat` — Delivery to Postomat impossible\n- `LoadingCourier` — Courier loading\n- `LoadingCourierFuture` — Courier loading (future event)\n- `ReturnTransferPoint` — Return to transfer point\n- `EWCargoAutoReturnRecipient` — Automatic return to sender\n- `OrderCargoReturn` — Return requested\n- `UndeliveryReasonsClient` — Not delivered (recipient refused the shipment)\n- `OrderRedirecting` — Redirection requested\n- `Utilization` — Sent for utilization\n- `DeclarationUtilization` — Shipment disposed\n- `EWRedeliveryAddress` — Redelivery (to address)\n- `EWRedeliveryDivision` — Redelivery (to branch)\n- `EWRedeliveryAddressFuture` — Redelivery (to address, future event)\n- `UndeliveryReasonsNoConnection` — Not delivered (no contact with recipient)\n- `ChangingTheDateWithTimeInterval` — Delivery rescheduled (time slot specified)\n- `ChangingTheDate` — Delivery rescheduled\n- `ShelfLifeHasExpired` — Storage period expired\n- `DeclarationArrivalCustomTerminalOutsideManifest` — Customs control started (outside manifest)\n- `DeclarationArrivalCustomTerminal` — Customs control started\n- `DeclarationInRoute` — Shipment en route to customs control\n- `DeclarationBrokerRejection` — Broker rejection — under review\n- `DeclarationCargoLost` — Shipment lost\n- `DeclarationCargoNotArrive` — Shipment did not arrive on schedule — under additional verification\n- `DeclarationCargoProhibitedForImport` — Prohibited content — delivery impossible\n- `DeclarationCustomsCargoSeizedBySmugglingDepartment` — Shipment seized by customs anti-smuggling department\n- `DeclarationCustomsCargoInspection` — Shipment undergoing customs inspection\n- `DeclarationCargoUnderInspectionCustoms` — Shipment under additional customs inspection\n- `DeclarationCustomsClearanceInitiated` — Customs clearance in progress\n- `DeclarationCustomsHold` — Shipment temporarily on hold by customs\n- `DeclarationCustomClearanceIsCompleted` — Customs clearance completed\n- `DeclarationSentToDestinationCountry` — Cleared customs — en route to destination country\n- `DeclarationAddedToManifest` — Added to the manifest\n- `DeclarationCustomerNoResponse` — Awaiting information from the recipient\n- `DeclarationPackagingDamaged` — Packaging damaged\n- `DeclarationShipmentDamaged` — Shipment damaged\n- `DeclarationInvalidCustomerData` — Verifying declaration data\n- `DeclarationNoSupportingDocuments` — Supporting documents missing\n- `CustomsRefusal` — Import prohibited by customs\n- `DeclarationAwaitingCustomsRelease` — Processing customs documents\n- `DeclarationCustomsDocumentsReceived` — Customs documents received, clearance in progress\n- `DeclarationShipmentAudit` — Cargo inspection by customs\n- `DeclarationRequireCustomsClearance` — Customs clearance required\n- `PickUpCreated` — Pickup order created\n- `PickUpAppointedCourier` — Courier assigned\n- `PickUpInProgress` — Courier en route for pickup\n- `PickUpReceivedByCourier` — Shipment received by courier\n- `PickUpDone` — Shipment picked up by courier\n- `PickUpNotPacked` — Pickup not completed — shipment was not packed\n- `PickUpNotCompleted` — Pickup not completed by courier\n\n- `DepartureCustomsBrokerPartnerFuture` — Partner customs broker (dispatch, future event)\n- `ShelfLifeHasExpiredReturn` — Not collected from Postomat — moved to the nearest division\n- `Lost` — Shipment lost\n"},"eventStatus":{"type":"string","description":"Статуси виконання події.\n\n**Можливі значення:**\n- `Passed` — подія вже відбулася\n- `Now` — подія відбувається зараз\n- `Future` — подія запланована на майбутнє\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"Дволітерний код країни, що позначає країну, в якій сталася подія, відповідно до стандарту ISO 3166-1 Alpha-2."},"code":{"type":"string","description":"Номер коду статусу відстеження.\n\n**Допустимі значення відповідають значенням, визначеним для поля `currentStatus.statusCode`.**\n"},"divisionName":{"type":"string","description":"Відділення, у якому відбувається відповідна подія."},"postCode":{"type":"string","description":"Фактичний поштовий індекс."},"settlementName":{"type":"string","description":"Назва населеного пункту, у якому відбувається подія."},"eventName":{"type":"string","description":"Назва події для клієнта."},"postCode1":{"type":"string","description":"Початок діапазону поштових індексів для населеного пункту."},"postCode2":{"type":"string","description":"Кінець діапазону поштових індексів для населеного пункту."}}}},"historyOnlineTracking":{"type":"array","description":"Масив об'єктів, що містить інформацію про історію онлайн-відстеження статусів відправлення, за винятком дубльованих подій.\n\nНе заповнюється, якщо використовується відстеження на рівні посилки (тобто коли передано `trackingByBarcode` або `withAllParcels` = `true`).\n","items":{"type":"object","properties":{"number":{"type":"string","description":"Номер відправлення."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Дата й час встановлення цього статусу.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"event":{"type":"string","description":"Назва події.\n\n**Допустимі значення відповідають значенням, визначеним для поля `detailsTracking.event`.**\n"},"eventStatus":{"type":"string","description":"Статуси виконання події.\n\n**Можливі значення:**\n- `Passed` — подія вже відбулася\n- `Now` — подія відбувається зараз\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"Дволітерний код країни, що позначає країну походження відправлення, відповідно до стандарту ISO 3166-1 Alpha-2."},"code":{"type":"string","description":"Номер коду статусу відстеження.\n\n**Допустимі значення відповідають значенням, визначеним для поля `currentStatus.statusCode`.**\n"},"divisionName":{"type":"string","description":"Відділення, у якому відбувається відповідна подія."},"postCode":{"type":"string","description":"Фактичний поштовий індекс."},"settlementName":{"type":"string","description":"Назва населеного пункту, у якому відбувається подія."},"eventName":{"type":"string","description":"Назва події для клієнта."},"postCode1":{"type":"string","description":"Початок діапазону поштових індексів для населеного пункту."},"postCode2":{"type":"string","description":"Кінець діапазону поштових індексів для населеного пункту."}}}},"parcelsDetailsTracking":{"type":"object","description":"Масив об'єктів, що містить детальну інформацію про весь маршрут переміщення посилки.\n\nЗаповнюється, якщо використовується відстеження на рівні посилки (тобто коли передано `trackingByBarcode` або `withAllParcels` = `true`).\n","additionalProperties":{"type":"array","description":"Динамічний ключ об'єкта, значенням якого є номер посилки. Використовується для групування подій відстеження за конкретною посилкою.","items":{"type":"object","properties":{"number":{"type":"string","description":"Номер відправлення."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Дата й час встановлення цього статусу.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"event":{"type":"string","description":"Назва події.\n\n**Доступні назви подій:**\n- `CreateID` — Shipment ID created\n- `CreateIDFullfilment` — Shipment ID created (fulfillment)\n- `Deleted` — Deleted\n- `CanceledSender` — Shipment cancelled by sender\n- `DeclarationDeleted` — Declaration cancelled\n- `ArrivalSenderWarehouse` — Arrival at sender’s warehouse\n- `ArrivalSenderPostomat` — Arrival at sender’s parcel locker\n- `ArrivalSenderDoors` — Courier picked up the shipment from sender\n- `DepartureSenderWarehouseFullfilment` — Shipped from sender's warehouse (fulfillment)\n- `DepartureSenderWarehouse` — Shipment dispatched from sender’s warehouse\n- `Departure` — Shipment\n- `Arrival` — Arrival\n- `DepartureSenderWarehouseFuture` — Shipment from sender’s warehouse (future event)\n- `DepartureFuture` — Shipment (future event)\n- `ArrivalFuture` — Arrival (future event)\n- `OnTheWayArrival` — En route to arrival point\n- `OnTheWayArrivalFuture` — En route to arrival point (future event)\n- `OnTheWayDeparture` — Shipment in transit\n- `OnTheWayDepartureFuture` — Shipment in transit (future event)\n- `ArrivalSenderDoorsFuture` — Courier picked up the shipment from sender (future event)\n- `ArrivalSenderCityDeliveryService` — Delivery service in recipient’s city (arrival)\n- `ArrivalTerminal` — Arrival at terminal\n- `ArrivalCustomsBrokerPartner` — Partner customs broker (arrival)\n- `DepartureDeliveryService` — Delivery service (dispatch)\n- `DepartureSenderCityDeliveryService` — Delivery service in sender’s city (dispatch)\n- `DepartureCustomsBrokerPartner` — Partner customs broker (dispatch)\n- `ArrivalDeliveryServiceFuture` — Delivery service (arrival, future event)\n- `ArrivalSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (arrival, future event)\n- `ArrivalTerminalFuture` — Arrival at terminal (future event)\n- `ArrivalCustomsBrokerPartnerFuture` — Partner customs broker (arrival, future event)\n- `DepartureDeliveryServiceFuture` — Delivery service (dispatch, future event)\n- `DepartureSenderCityDeliveryServiceFuture` — Delivery service in sender’s city (dispatch, future event)\n- `DepartureTerminalFuture` — Dispatch from terminal (future event)\n- `DepartureTerminal` — Dispatch from terminal\n- `ArrivalDepot` — Arrival at depot\n- `DepartureDepot` — Dispatch from depot\n- `ArrivalDepotFuture` — Arrival at depot (future event)\n- `DepartureDepotFuture` — Dispatch from depot (future event)\n- `ArrivalSenderCityDepot` — Depot in sender’s city (arrival)\n- `DepartureSenderCityDepot` — Depot in sender’s city (dispatch)\n- `ArrivalSenderCityDepotFuture` — Depot in sender’s city (arrival, future event)\n- `DepartureSenderCityDepotFuture` — Depot in sender’s city (dispatch, future event)\n- `CustomsClearanceInitiated` — Customs clearance\n- `ArrivalSenderCityTerminal` — Terminal in sender’s city (arrival)\n- `ArrivalSenderCityTerminalFuture` — Terminal in sender’s city (arrival, future event)\n- `DepartureSenderCityTerminal` — Terminal in sender’s city (dispatch)\n- `DepartureSenderCityTerminalFuture` — Terminal in sender’s city (dispatch, future event)\n- `SentForCustomsClearance` — Sent for customs clearance\n- `CustomClearanceIsCompleted` — Customs processing completed\n- `SentToDestinationCountry` — Sent to destination city after customs\n- `ArrivalCustomTerminal` — Arrived at customs terminal\n- `ArrivalDeliveryService` — Delivery service (arrival)\n- `MovingPostomat` — Awaiting transportation / In transit to parcel locker\n- `InCityRecipientDeparture` — In recipient's city (dispatch)\n- `InCityRecipientArrival` — In recipient's city (arrival)\n- `InCityRecipientPlan` — In recipient's city (planned event)\n- `InCityRecipientFuture` — In recipient’s city (future event)\n- `InCityRecipient` — In recipient’s city\n- `InCityRecipientArrivalFuture` — In recipient’s city (future arrival event)\n- `InCityRecipientDepartureFuture` — In recipient’s city (future dispatch event)\n- `InCityRecipientPlanFuture` — In recipient’s city (future planned event)\n- `ArrivalDestinationDepot` — Destination city warehouse (arrival)\n- `DepartureDestinationDepot` — Destination city warehouse (dispatch)\n- `ArrivalDestinationDepotFuture` — Destination city warehouse (arrival, future event)\n- `DepartureDestinationDepotFuture` — Destination city warehouse (dispatch, future event)\n- `ArrivalDestinationDeliveryService` — Delivery service in recipient’s city (arrival)\n- `DepartureDestinationDeliveryService` — Delivery service in recipient’s city (dispatch)\n- `ArrivalDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (arrival, future event)\n- `DepartureDestinationDeliveryServiceFuture` — Delivery service in recipient’s city (dispatch, future event)\n- `ArrivalDestinationTerminal` — Terminal in recipient’s city (arrival)\n- `ArrivalDestinationTerminalFuture` — Terminal in recipient’s city (arrival, future event)\n- `DepartureDestinationTerminal` — Terminal in recipient’s city (dispatch)\n- `DepartureDestinationTerminalFuture` — Terminal in recipient’s city (dispatch, future event)\n- `ArrivalSameSettlementImport` — Single locality (import, arrival)\n- `NoFreeSlotsInPostomat` — No free parcel locker cells available\n- `LoadingCourierForMoving` — Courier picked up the shipment\n- `ArrivalSameSettlementImportFuture` — Single locality (import, arrival, future event)\n- `ParcelWasTransferredToPartner` — Transferred to partner for further delivery\n- `ArrivalSameSettlementLocal` — Single locality (local, arrival)\n- `ArrivalSameSettlementLocalFuture` — Single locality (local, arrival, future event)\n- `ArrivalDuplicate` — Shipment pending processing at partner warehouse\n- `ArrivalDuplicatePassed` — Shipment was pending processing at partner warehouse\n- `DepartureDuplicate` — Shipment in the process of dispatching from partner warehouse\n- `DepartureDuplicatePassed` — Shipment was in dispatch process from partner warehouse\n- `InRouteDuplicate` — Shipment in transit — temporary partner-side delay\n- `InRouteDuplicatePassed` — Temporary partner-side delay resolved\n- `TransferPoint` — Transfer point\n- `MovingPoint` — At pickup point\n- `TransferPointPostomat` — Arrival at parcel locker\n- `ArrivalRecipientWarehouse` — Arrival at recipient’s warehouse\n- `ArrivalRecipientWarehouseFuture` — Arrival at recipient’s warehouse (future event)\n- `ArrivalRecipientPartnerWarehouse` — Arrived at partner warehouse\n- `ArrivalRecipientPostomat` — Arrived at recipient’s parcel locker\n- `ReceivedDoorsFuture` — Delivery to address (future event)\n- `ReceivedWarehouse` — Received at warehouse\n- `ReceivedDoors` — Delivered to address\n- `ReceivedPartner` — Shipment received by partner\n- `AlternativeDelivery` — Alternative delivery type applied (delivered to neighbor, left at the door, placed in mailbox, etc.)\n- `MoneyTransferAddress` — Money transfer (to address)\n- `MoneyTransfer` — Money transfer (to branch)\n- `MoneyTransferAddressFuture` — Money transfer (to address, future event)\n- `ArrivalSC` — Arrival at sorting center (SC)\n- `TransferToPartner` — Handed over to partner\n- `ArrivalTransitWarehouse` — Arrived at transit warehouse\n- `DepartureFromTransitWarehouse` — Departed from transit warehouse\n- `ProblemWithPostomat` — Delivery to Postomat impossible\n- `LoadingCourier` — Courier loading\n- `LoadingCourierFuture` — Courier loading (future event)\n- `ReturnTransferPoint` — Return to transfer point\n- `EWCargoAutoReturnRecipient` — Automatic return to sender\n- `OrderCargoReturn` — Return requested\n- `UndeliveryReasonsClient` — Not delivered (recipient refused the shipment)\n- `OrderRedirecting` — Redirection requested\n- `Utilization` — Sent for utilization\n- `DeclarationUtilization` — Shipment disposed\n- `EWRedeliveryAddress` — Redelivery (to address)\n- `EWRedeliveryDivision` — Redelivery (to branch)\n- `EWRedeliveryAddressFuture` — Redelivery (to address, future event)\n- `UndeliveryReasonsNoConnection` — Not delivered (no contact with recipient)\n- `ChangingTheDateWithTimeInterval` — Delivery rescheduled (time slot specified)\n- `ChangingTheDate` — Delivery rescheduled\n- `ShelfLifeHasExpired` — Storage period expired\n- `DeclarationArrivalCustomTerminalOutsideManifest` — Customs control started (outside manifest)\n- `DeclarationArrivalCustomTerminal` — Customs control started\n- `DeclarationInRoute` — Shipment en route to customs control\n- `DeclarationBrokerRejection` — Broker rejection — under review\n- `DeclarationCargoLost` — Shipment lost\n- `DeclarationCargoNotArrive` — Shipment did not arrive on schedule — under additional verification\n- `DeclarationCargoProhibitedForImport` — Prohibited content — delivery impossible\n- `DeclarationCustomsCargoSeizedBySmugglingDepartment` — Shipment seized by customs anti-smuggling department\n- `DeclarationCustomsCargoInspection` — Shipment undergoing customs inspection\n- `DeclarationCargoUnderInspectionCustoms` — Shipment under additional customs inspection\n- `DeclarationCustomsClearanceInitiated` — Customs clearance in progress\n- `DeclarationCustomsHold` — Shipment temporarily on hold by customs\n- `DeclarationCustomClearanceIsCompleted` — Customs clearance completed\n- `DeclarationSentToDestinationCountry` — Cleared customs — en route to destination country\n- `DeclarationAddedToManifest` — Added to the manifest\n- `DeclarationCustomerNoResponse` — Awaiting information from the recipient\n- `DeclarationPackagingDamaged` — Packaging damaged\n- `DeclarationShipmentDamaged` — Shipment damaged\n- `DeclarationInvalidCustomerData` — Verifying declaration data\n- `DeclarationNoSupportingDocuments` — Supporting documents missing\n- `CustomsRefusal` — Import prohibited by customs\n- `DeclarationAwaitingCustomsRelease` — Processing customs documents\n- `DeclarationCustomsDocumentsReceived` — Customs documents received, clearance in progress\n- `DeclarationShipmentAudit` — Cargo inspection by customs\n- `DeclarationRequireCustomsClearance` — Customs clearance required\n- `PickUpCreated` — Pickup order created\n- `PickUpAppointedCourier` — Courier assigned\n- `PickUpInProgress` — Courier en route for pickup\n- `PickUpReceivedByCourier` — Shipment received by courier\n- `PickUpDone` — Shipment picked up by courier\n- `PickUpNotPacked` — Pickup not completed — shipment was not packed\n- `PickUpNotCompleted` — Pickup not completed by courier\n\n- `DepartureCustomsBrokerPartnerFuture` — Partner customs broker (dispatch, future event)\n- `ShelfLifeHasExpiredReturn` — Not collected from Postomat — moved to the nearest division\n- `Lost` — Shipment lost\n"},"eventStatus":{"type":"string","description":"Статуси виконання події.\n\n**Можливі значення:**\n- `Passed` — подія вже відбулася\n- `Now` — подія відбувається зараз\n- `Future` — подія запланована на майбутнє\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"Дволітерний код країни, що позначає країну, в якій сталася подія, відповідно до стандарту ISO 3166-1 Alpha-2."},"code":{"type":"string","description":"Номер коду статусу відстеження.\n\n**Допустимі значення відповідають значенням, визначеним для поля `currentStatus.statusCode`.**\n"},"divisionName":{"type":"string","description":"Відділення, у якому відбувається відповідна подія."},"postCode":{"type":"string","description":"Фактичний поштовий індекс."},"settlementName":{"type":"string","description":"Назва населеного пункту, у якому відбувається подія."},"eventName":{"type":"string","description":"Назва події для клієнта."},"postCode1":{"type":"string","description":"Початок діапазону поштових індексів для населеного пункту."},"postCode2":{"type":"string","description":"Кінець діапазону поштових індексів для населеного пункту."}}}}},"parcelsHistoryOnlineTracking":{"type":"object","description":"Масив об'єктів, що містить інформацію про історію онлайн-відстеження статусів посилки, за винятком дубльованих подій.\n\nЗаповнюється, якщо використовується відстеження на рівні посилки (тобто коли передано `trackingByBarcode` або `withAllParcels` = `true`).\n","additionalProperties":{"type":"array","description":"Динамічний ключ об'єкта, значенням якого є номер посилки. Використовується для групування подій відстеження за конкретною посилкою.","items":{"type":"object","properties":{"number":{"type":"string","description":"Номер відправлення."},"date":{"type":"string","format":"date-time","nullable":true,"description":"Дата й час встановлення цього статусу.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"event":{"type":"string","description":"Назва події.\n\n**Допустимі значення відповідають значенням, визначеним для поля `detailsTracking.event`.**\n"},"eventStatus":{"type":"string","description":"Статуси виконання події.\n\n**Можливі значення:**\n- `Passed` — подія вже відбулася\n- `Now` — подія відбувається зараз\n"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$","nullable":true,"description":"Дволітерний код країни, що позначає країну походження відправлення, відповідно до стандарту ISO 3166-1 Alpha-2."},"code":{"type":"string","description":"Номер коду статусу відстеження.\n\n**Допустимі значення відповідають значенням, визначеним для поля `currentStatus.statusCode`.**\n"},"divisionName":{"type":"string","description":"Відділення, у якому відбувається відповідна подія."},"postCode":{"type":"string","description":"Фактичний поштовий індекс."},"settlementName":{"type":"string","description":"Назва населеного пункту, у якому відбувається подія."},"eventName":{"type":"string","description":"Назва події для клієнта."},"postCode1":{"type":"string","description":"Початок діапазону поштових індексів для населеного пункту."},"postCode2":{"type":"string","description":"Кінець діапазону поштових індексів для населеного пункту."}}}}},"parcels":{"type":"array","description":"Блок опису посилок. Масив містить об'єкти, кожен з яких відповідає за інформацію про посилку.","items":{"type":"object","properties":{"number":{"type":"string","pattern":"^[A-Z]{4}\\d{10}$","description":"Номер транспортного документа."},"rowNumber":{"type":"integer","minimum":1,"nullable":true,"description":"Номер посилки."},"untied":{"type":"boolean","description":"Внутрішні дані. Не використовувати."},"cargoCategoryGroup":{"type":"string","description":"Тип відправлення (посилка, документи, палета тощо)."},"cargoCategoryId":{"type":"string","description":"Внутрішні дані. Не використовувати."},"categoryCargoName":{"type":"string","description":"Назва категорії відправлення."},"parcelDescription":{"type":"string","maxLength":255,"description":"Короткий опис вмісту посилки."},"insuranceCost":{"type":"number","minimum":0,"description":"Сума оголошеної вартості."},"insuranceCostCurrencyCode":{"type":"string","description":"Валюта, у якій указано оголошену вартість відправлення, відповідно до стандарту ISO 4217."},"length":{"type":"integer","minimum":1,"description":"Фактична довжина посилки в мм."},"width":{"type":"integer","minimum":1,"description":"Фактична ширина посилки в мм."},"height":{"type":"integer","minimum":1,"description":"Фактична висота посилки в мм."},"actualWeight":{"type":"number","minimum":0,"maximum":2147483647,"description":"Фактична вага посилки в грамах."},"volumetricWeight":{"type":"number","minimum":0,"maximum":2147483647,"description":"Об'ємна вага посилки."},"lengthCheck":{"type":"number","nullable":true,"description":"Фактична скоригована довжина відправлення в міліметрах після контрольного вимірювання."},"widthCheck":{"type":"number","nullable":true,"description":"Фактична скоригована ширина відправлення в міліметрах після контрольного вимірювання."},"heightCheck":{"type":"number","nullable":true,"description":"Фактична скоригована висота відправлення в міліметрах після контрольного вимірювання."},"actualWeightCheck":{"type":"number","nullable":true,"description":"Фактична скоригована вага відправлення в грамах після контрольного вимірювання."},"volumetricWeightCheck":{"type":"number","nullable":true,"description":"Фактична скоригована об'ємна вага відправлення в грамах після контрольного вимірювання."}}}},"alternativeNumbers":{"type":"array","description":"Масив об'єктів, що містить список пов'язаних відправлень.","items":{"type":"string"}},"alternativeNumbersGW":{"type":"array","description":"Масив об'єктів, що містить розширену інформацію про пов'язані відправлення.","items":{"type":"object","properties":{"name":{"type":"string","description":"Ім'я власника відправлення."},"number":{"type":"string","description":"Номер відправлення."},"date":{"type":"string","format":"date-time","description":"Дата створення відправлення.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"}}}},"undeliveryReasons":{"type":"array","description":"Масив об'єктів, що містить інформацію про причини невручення відправлення.","items":{"type":"object","properties":{"reasonName":{"type":"string","description":"Назва причини невручення."},"reasonDate":{"type":"string","format":"date-time","description":"Дата невручення.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"},"reasonId":{"type":"string","description":"Унікальний ідентифікатор причини невручення."},"subtypeOfReasonId":{"type":"string","description":"Унікальний ідентифікатор підпричини невручення."},"subtypeOfReasonName":{"type":"string","description":"Назва підпричини невручення."}}}},"createdOnTheBasis":{"type":"array","description":"Масив об'єктів, що містить інформацію про відправлення, створені на основі інших відправлень.","items":{"type":"object","properties":{"number":{"type":"string","description":"Номер документа."},"type":{"type":"string","description":"Тип документа.\n\n**Можливі значення:**\n- `Redirecting`\n- `Return`\n- `Utilization`\n- `Redelivery`\n"},"createdDate":{"type":"string","format":"date-time","description":"Дата невручення.\n\nДата у форматі ISO 8601 із часовою зоною UTC.\n"}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/Validation"},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"Повне відстеження"}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://api-portal.novapost.com/metodi-1/metodi/readme/vidpravlennya/vidstezhennya-vidpravlennya.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.