> 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/api-docs-ua/zagalna-informaciya/treking.md). # Трекінг :link:[*Початок роботи з API*](https://api-portal.novapost.com/api-docs-ua)
Актуальні статуси трекінгу
1Відправник самостійно створив цю накладну, але ще не надав до відправки
2Видалено
3Номер не знайдено
4Відправлення у місті ХХXХ (статус для міжобласних відправлень)
41Відправлення у місті ХХXХ (статус для послуг «Локал стандарт» і «Локал експрес» — доставка в межах міста)
5Відправлення прямує до міста YYYY
6Відправлення у місті YYYY, орієнтовна доставка до ВІДДІЛЕННЯ-XXX dd-mm. Очікуйте додаткове повідомлення про прибуття
7Прибув на відділення
8 Прибув на відділення (завантажено в Поштомат)
9Відправлення отримано
10Відправлення отримано %DateReceived%. Протягом доби ви одержите SMS-повідомлення про надходження грошового переказу та зможете отримати його в касі відділення «Нова пошта»
11Відправлення отримано %DateReceived%. Грошовий переказ видано одержувачу
12Нова пошта комплектує ваше відправлення
15Відправлення вже в дорозі до України
101На шляху до одержувача
102Відмова від отримання (відправником створено замовлення на повернення)
103Відмова від отримання
104Змінено адресу
105Припинено зберігання
106Одержано і створено ЕН зворотної доставки
107Відправлення переміщено з пункту видачі замовлень (PUDO) до основного відділення, яке його обслуговує
111Невдала спроба доставки через відсутність одержувача на адресі або зв'язку з ним
112Дата доставки перенесена одержувачем
## Перегляд детальної інформації про статус відправлень (JSON) > Метод \*\*getStatusDocuments\*\* у моделі \*\*TrackingDocumentGeneral\*\* (або \*\*TrackingDocument\*\*) надає можливість перегляду детальної інформації про статус відправлень. Цей метод дозволяє користувачам отримати актуальні дані щодо статусу їхніх відправлень, зокрема інформацію про відправника та одержувача.\ > \ > Основні можливості методу:\ > \- \*\*Отримання даних за номером телефону\*\*: Під час введення номера телефону можна отримати інформацію про відправника та одержувача, включно з їхніми контактними даними.\ > \- \*\*Масовий перегляд відправлень\*\*: Метод дозволяє переглядати інформацію одночасно до 100 відправлень.\ > \- \*\*Актуальні статуси трекінгу\*\*: Метод відображає всі актуальні статуси трекінгу для кожного відправлення.\ > \- \*\*Доступність\*\*: Метод доступний як для авторизованих, так і для неавторизованих запитів.\ > \ > Авторизований доступ має такі особливості:\ > \- Для отримання повних даних про відправлення необхідно використовувати API-ключ.\ > \- У разі успішної авторизації та валідації повертаються коректні дані відправника та одержувача.\ > \ > Неавторизований доступ (без використання API-ключа) має обмежений доступ до даних. Для запитів застосовується логіка підміни — дані відправника та одержувача замінюються на дані, що належать номеру телефону із запиту.
```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Tracking","version":"2.0.0"},"tags":[{"name":"TrackingDocument","description":"Операції, пов'язані з відстеженням відправлень"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["TrackingDocument"],"operationId":"getStatusDocumentsJson","summary":"Перегляд детальної інформації про статус відправлень (JSON)","description":"Метод **getStatusDocuments** у моделі **TrackingDocumentGeneral** (або **TrackingDocument**) надає можливість перегляду детальної інформації про статус відправлень. Цей метод дозволяє користувачам отримати актуальні дані щодо статусу їхніх відправлень, зокрема інформацію про відправника та одержувача.\n\nОсновні можливості методу:\n- **Отримання даних за номером телефону**: Під час введення номера телефону можна отримати інформацію про відправника та одержувача, включно з їхніми контактними даними.\n- **Масовий перегляд відправлень**: Метод дозволяє переглядати інформацію одночасно до 100 відправлень.\n- **Актуальні статуси трекінгу**: Метод відображає всі актуальні статуси трекінгу для кожного відправлення.\n- **Доступність**: Метод доступний як для авторизованих, так і для неавторизованих запитів.\n\nАвторизований доступ має такі особливості:\n- Для отримання повних даних про відправлення необхідно використовувати API-ключ.\n- У разі успішної авторизації та валідації повертаються коректні дані відправника та одержувача.\n\nНеавторизований доступ (без використання API-ключа) має обмежений доступ до даних. Для запитів застосовується логіка підміни — дані відправника та одержувача замінюються на дані, що належать номеру телефону із запиту.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetStatusDocumentsJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetStatusDocumentsResponse"}}}}}}}},"components":{"schemas":{"GetStatusDocumentsJsonRequest":{"type":"object","additionalProperties":false,"required":["modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача (необов'язковий для неавторизованого доступу)"},"modelName":{"type":"string","enum":["TrackingDocumentGeneral","TrackingDocument"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getStatusDocuments"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetStatusDocumentsMethodProperties"}}},"GetStatusDocumentsMethodProperties":{"type":"object","additionalProperties":false,"required":["Documents"],"properties":{"Documents":{"type":"array","description":"Масив документів, який слід відстежити (до 100 елементів)","items":{"$ref":"#/components/schemas/DocumentItemInput"}}}},"DocumentItemInput":{"type":"object","additionalProperties":false,"required":["DocumentNumber"],"properties":{"DocumentNumber":{"type":"string","description":"Номер документа (експрес-накладної)"},"Phone":{"type":"string","description":"Номер телефону одержувача/відправника для отримання розширеної інформації"}}},"GetStatusDocumentsResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив результатів трекінгу документів","items":{"$ref":"#/components/schemas/TrackingDocumentItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"TrackingDocumentItem":{"type":"object","additionalProperties":true,"properties":{"PossibilityCreateReturn":{"type":"boolean","description":"Доступність замовлення послуги повернення вантажу (true/false)"},"PossibilityCreateRefusal":{"type":"boolean","description":"Доступність замовлення послуги відмови від вантажу (true/false)"},"PossibilityChangeEW":{"type":"boolean","description":"Доступність замовлення послуги внесення змін в експрес-накладну (ЕН) (true/false)"},"PossibilityCreateRedirecting":{"type":"boolean","description":"Доступність замовлення послуги переадресування (true/false)"},"Number":{"type":"string","maxLength":36,"description":"Номер документа"},"Redelivery":{"type":"string","maxLength":36,"description":"Ідентифікатор зворотної доставки (0 — відсутня, 1 — наявна)"},"RedeliverySum":{"type":"string","maxLength":36,"description":"Сума зворотної доставки"},"RedeliveryNum":{"type":"string","maxLength":36,"description":"Ідентифікатор номера ЕН зворотної доставки (якщо створено)"},"RedeliveryPayer":{"type":"string","maxLength":36,"description":"Ідентифікатор платника зворотної доставки"},"OwnerDocumentType":{"type":"string","maxLength":36,"description":"Тип ЕН на підставі"},"LastCreatedOnTheBasisDocumentType":{"type":"string","maxLength":36,"description":"Останні зміни типу документа"},"LastCreatedOnTheBasisPayerType":{"type":"string","maxLength":36,"description":"Останні зміни, тип платника"},"LastCreatedOnTheBasisDateTime":{"type":"string","maxLength":36,"description":"Останні зміни, дата створення"},"LastTransactionStatusGM":{"type":"string","maxLength":36,"description":"Останній статус транзакції грошового переказу"},"LastTransactionDateTimeGM":{"type":"string","maxLength":36,"description":"Останній час та дата транзакції грошового переказу"},"LastAmountTransferGM":{"type":"string","maxLength":36,"description":"Поточне значення суми грошового переказу"},"DateCreated":{"type":"string","maxLength":36,"description":"Дата створення ЕН"},"DocumentWeight":{"type":"string","maxLength":36,"description":"Вага"},"FactualWeight":{"type":"string","maxLength":36,"description":"Фактична вага з ЕН"},"VolumeWeight":{"type":"string","maxLength":36,"description":"Об'ємна вага з ЕН"},"CheckWeight":{"type":"string","maxLength":36,"description":"Інформація після контрольного зважування"},"CheckWeightMethod":{"type":"string","maxLength":36,"description":"Тип зважування, згідно з яким виконувалось контрольне зважування"},"DocumentCost":{"type":"string","maxLength":36,"description":"Вартість доставки"},"CalculatedWeight":{"type":"string","maxLength":36,"description":"Розрахункова вага"},"SumBeforeCheckWeight":{"type":"string","maxLength":36,"description":"Інформація до контрольного зважування"},"PayerType":{"type":"string","maxLength":36,"description":"Ідентифікатор платника"},"RecipientFullName":{"type":"string","maxLength":36,"description":"Дані ПІБ отримувача з накладної, за умови зазначення номера телефону"},"RecipientDateTime":{"type":"string","maxLength":36,"description":"Дата, коли отримувач забрав вантаж"},"ScheduledDeliveryDate":{"type":"string","maxLength":36,"description":"Очікувана дата доставки"},"PaymentMethod":{"type":"string","maxLength":36,"description":"Тип оплати"},"CargoDescriptionString":{"type":"string","maxLength":36,"description":"Опис вантажу"},"CargoType":{"type":"string","maxLength":36,"description":"Тип вантажу"},"CitySender":{"type":"string","maxLength":36,"description":"Місто відправника"},"CityRecipient":{"type":"string","maxLength":36,"description":"Місто отримувача"},"WarehouseRecipient":{"type":"string","maxLength":36,"description":"Склад отримувача"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"AfterpaymentOnGoodsCost":{"type":"string","maxLength":36,"description":"Контроль оплати"},"ServiceType":{"type":"string","maxLength":36,"description":"Тип доставки"},"UndeliveryReasonsSubtypeDescription":{"type":"string","maxLength":36,"description":"Опис причини нерозвезення"},"WarehouseRecipientNumber":{"type":"string","maxLength":36,"description":"Номер відділення отримувача"},"LastCreatedOnTheBasisNumber":{"type":"string","maxLength":36,"description":"Останні зміни, номер ЕН"},"PhoneRecipient":{"type":"string","maxLength":36,"description":"Номер телефону отримувача"},"RecipientFullNameEW":{"type":"string","maxLength":36,"description":"Дані ПІБ отримувача з накладної, за умови зазначення в запиті номера телефону"},"WarehouseRecipientInternetAddressRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) складу отримувача"},"MarketplacePartnerToken":{"type":"string","maxLength":36,"description":"Токен торговельного майданчика"},"ClientBarcode":{"type":"string","maxLength":36,"description":"Внутрішній номер замовлення"},"RecipientAddress":{"type":"string","maxLength":36,"description":"Адреса отримувача"},"CounterpartyRecipientDescription":{"type":"string","maxLength":36,"description":"Опис контрагента отримувача"},"CounterpartySenderType":{"type":"string","maxLength":36,"description":"Тип контрагента відправника"},"DateScan":{"type":"string","maxLength":36,"description":"Дата сканування, що призвела до формування статусу"},"PaymentStatus":{"type":"string","maxLength":36,"description":"Статус для інтернет-еквайрингу"},"PaymentStatusDate":{"type":"string","maxLength":36,"description":"Дата оплати для інтернет-еквайрингу"},"AmountToPay":{"type":"string","maxLength":36,"description":"Сума до сплати для інтернет-еквайрингу"},"AmountPaid":{"type":"string","maxLength":36,"description":"Сплачено для інтернет-еквайрингу"},"Status":{"type":"string","maxLength":36,"description":"Статус"},"StatusCode":{"type":"string","maxLength":36,"description":"Ідентифікатор статусу"},"RefEW":{"type":"string","maxLength":36,"description":"Ідентифікатор накладної для інтернет-еквайрингу (використовується в робочих цілях)"},"BackwardDeliverySubTypesActions":{"type":"string","maxLength":36,"description":"Інформація за нестандартними підтипами зворотної доставки"},"BackwardDeliverySubTypesServices":{"type":"string","maxLength":36,"description":"Інформація за нестандартними підтипами зворотної доставки"},"UndeliveryReasons":{"type":"string","maxLength":36,"description":"Причина нерозвезення"},"DatePayedKeeping":{"type":"string","maxLength":36,"description":"Дата початку платного зберігання"},"InternationalDeliveryType":{"type":"string","maxLength":36,"description":"Тип міжнародної доставки"},"SeatsAmount":{"type":"string","maxLength":36,"description":"Кількість місць"},"CardMaskedNumber":{"type":"string","maxLength":36,"description":"Замаскований номер платіжної карти"},"ExpressWaybillPaymentStatus":{"type":"string","maxLength":36,"description":"Статус оплати ЕН"},"ExpressWaybillAmountToPay":{"type":"string","maxLength":36,"description":"Сума оплати за ЕН"},"PhoneSender":{"type":"string","maxLength":36,"description":"Телефон відправника"},"TrackingUpdateDate":{"type":"string","maxLength":36,"description":"Оновлена дата відстеження"},"WarehouseSender":{"type":"string","maxLength":36,"description":"Відділення відправника"},"DateReturnCargo":{"type":"string","maxLength":36,"description":"Дата повернення вантажу"},"DateMoving":{"type":"string","maxLength":36,"description":"Дата переміщення"},"DateFirstDayStorage":{"type":"string","maxLength":36,"description":"Дата початку зберігання"},"RefCityRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор міста одержувача"},"RefCitySender":{"type":"string","maxLength":36,"description":"Ідентифікатор міста відправника"},"RefSettlementRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор населеного пункту одержувача"},"RefSettlementSender":{"type":"string","maxLength":36,"description":"Ідентифікатор населеного пункту відправника"},"SenderAddress":{"type":"string","maxLength":36,"description":"Адреса відправника"},"SenderFullNameEW":{"type":"string","maxLength":36,"description":"Повне ім'я відправника"},"AnnouncedPrice":{"type":"string","maxLength":36,"description":"Оголошена вартість"},"AdditionalInformationEW":{"type":"string","maxLength":36,"description":"Додаткова інформація"},"ActualDeliveryDate":{"type":"string","maxLength":36,"description":"Фактична дата доставки"},"PostomatV3CellReservationNumber":{"type":"string","maxLength":36,"description":"Номер бронювання комірки поштомата, за умови доставки до поштомата"},"OwnerDocumentNumber":{"type":"string","maxLength":36,"description":"Номер ЕН на основі"},"LastAmountReceivedCommissionGM":{"type":"string","maxLength":36,"description":"Сума комісії за грошовий переказ"},"DeliveryTimeframe":{"type":"string","maxLength":36,"description":"Часовий інтервал, якщо було замовлено (тільки для ЕН до адреси)"},"CreatedOnTheBasis":{"type":"string","maxLength":36,"description":"Створено на основі"},"UndeliveryReasonsDate":{"type":"string","maxLength":36,"description":"Дата причини нерозвезення"},"RecipientWarehouseTypeRef":{"type":"string","maxLength":36,"description":"Ідентифікатор типу відділення одержувача"},"WarehouseRecipientRef":{"type":"string","maxLength":36,"description":"Ідентифікатор відділення одержувача"},"CategoryOfWarehouse":{"type":"string","maxLength":36,"description":"Категорія відділення"},"WarehouseRecipientAddress":{"type":"string","maxLength":36,"description":"Адреса відділення одержувача"},"WarehouseSenderInternetAddressRef":{"type":"string","maxLength":36,"description":"Інтернет-адреса відділення відправника"},"WarehouseSenderAddress":{"type":"string","maxLength":36,"description":"Адреса відділення відправника"},"AviaDelivery":{"type":"string","maxLength":36,"description":"Авіадоставка"},"BarcodeRedBox":{"type":"string","maxLength":36,"description":"Штрихкод пакування типу RedBox"},"CargoReturnRefusal":{"type":"string","description":"Наявність послуги «Відмова від повернення» (true/false)"},"DaysStorageCargo":{"type":"string","maxLength":36,"description":"День зберігання вантажу"},"Packaging":{"type":"array","nullable":true,"description":"Пакування","items":{"type":"string"}},"PartialReturnGoods":{"type":"array","nullable":true,"description":"Часткове повернення","items":{"type":"string"}},"SecurePayment":{"type":"string","description":"Ознака надійної покупки (true/false)"},"PossibilityChangeCash2Card":{"type":"boolean","description":"Доступність можливості зміни виплати грошового переказу на картку (true/false)"},"PossibilityChangeDeliveryIntervals":{"type":"boolean","description":"Доступність зміни інтервалу доставки (true/false)"},"PossibilityTermExtensio":{"type":"boolean","description":"Доступність можливості подовження термінів зберігання (true/false)"},"StorageAmount":{"type":"string","maxLength":36,"description":"Кількість днів зберігання вантажу"},"StoragePrice":{"type":"string","maxLength":36,"description":"Вартість зберігання"},"FreeShipping":{"type":"string","maxLength":36,"description":"Ознака безкоштовної доставки"},"LoyaltyCardRecipient":{"type":"string","maxLength":36,"description":"Номер картки лояльності отримувача, за наявності"}}}}}} ``` ## Перегляд детальної інформації про статус відправлень (XML) > Метод \*\*getStatusDocuments\*\* у моделі \*\*TrackingDocumentGeneral\*\* (або \*\*TrackingDocument\*\*) надає можливість перегляду детальної інформації про статус відправлень. Цей метод дозволяє користувачам отримати актуальні дані щодо статусу їхніх відправлень, зокрема інформацію про відправника та одержувача.\ > \ > Основні можливості методу:\ > \- \*\*Отримання даних за номером телефону\*\*: Під час введення номера телефону можна отримати інформацію про відправника та одержувача, включно з їхніми контактними даними.\ > \- \*\*Масовий перегляд відправлень\*\*: Метод дозволяє переглядати інформацію одночасно до 100 відправлень.\ > \- \*\*Актуальні статуси трекінгу\*\*: Метод відображає всі актуальні статуси трекінгу для кожного відправлення.\ > \- \*\*Доступність\*\*: Метод доступний як для авторизованих, так і для неавторизованих запитів.\ > \ > Авторизований доступ має такі особливості:\ > \- Для отримання повних даних про відправлення необхідно використовувати API-ключ.\ > \- У разі успішної авторизації та валідації повертаються коректні дані відправника та одержувача.\ > \ > Неавторизований доступ (без використання API-ключа) має обмежений доступ до даних. Для запитів застосовується логіка підміни — дані відправника та одержувача замінюються на дані, що належать номеру телефону із запиту.
```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Tracking","version":"2.0.0"},"tags":[{"name":"TrackingDocument","description":"Операції, пов'язані з відстеженням відправлень"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["TrackingDocument"],"operationId":"getStatusDocumentsXml","summary":"Перегляд детальної інформації про статус відправлень (XML)","description":"Метод **getStatusDocuments** у моделі **TrackingDocumentGeneral** (або **TrackingDocument**) надає можливість перегляду детальної інформації про статус відправлень. Цей метод дозволяє користувачам отримати актуальні дані щодо статусу їхніх відправлень, зокрема інформацію про відправника та одержувача.\n\nОсновні можливості методу:\n- **Отримання даних за номером телефону**: Під час введення номера телефону можна отримати інформацію про відправника та одержувача, включно з їхніми контактними даними.\n- **Масовий перегляд відправлень**: Метод дозволяє переглядати інформацію одночасно до 100 відправлень.\n- **Актуальні статуси трекінгу**: Метод відображає всі актуальні статуси трекінгу для кожного відправлення.\n- **Доступність**: Метод доступний як для авторизованих, так і для неавторизованих запитів.\n\nАвторизований доступ має такі особливості:\n- Для отримання повних даних про відправлення необхідно використовувати API-ключ.\n- У разі успішної авторизації та валідації повертаються коректні дані відправника та одержувача.\n\nНеавторизований доступ (без використання API-ключа) має обмежений доступ до даних. Для запитів застосовується логіка підміни — дані відправника та одержувача замінюються на дані, що належать номеру телефону із запиту.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetStatusDocumentsXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetStatusDocumentsXmlResponse"}}}}}}}},"components":{"schemas":{"GetStatusDocumentsXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача (необов'язковий для неавторизованого доступу)"},"modelName":{"type":"string","enum":["TrackingDocumentGeneral","TrackingDocument"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getStatusDocuments"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetStatusDocumentsXmlMethodProperties"}}},"GetStatusDocumentsXmlMethodProperties":{"type":"object","additionalProperties":false,"required":["Documents"],"xml":{"name":"methodProperties"},"properties":{"Documents":{"type":"array","description":"Масив документів для відстеження","xml":{"name":"Documents"},"items":{"$ref":"#/components/schemas/DocumentItemInput","xml":{"name":"item"}}}}},"DocumentItemInput":{"type":"object","additionalProperties":false,"required":["DocumentNumber"],"properties":{"DocumentNumber":{"type":"string","description":"Номер документа (експрес-накладної)"},"Phone":{"type":"string","description":"Номер телефону одержувача/відправника для отримання розширеної інформації"}}},"GetStatusDocumentsXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив результатів трекінгу документів","xml":{"name":"data","wrapped":true},"items":{"$ref":"#/components/schemas/TrackingDocumentXmlItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}}}},"TrackingDocumentXmlItem":{"allOf":[{"$ref":"#/components/schemas/TrackingDocumentItem"}],"xml":{"name":"item"}},"TrackingDocumentItem":{"type":"object","additionalProperties":true,"properties":{"PossibilityCreateReturn":{"type":"boolean","description":"Доступність замовлення послуги повернення вантажу (true/false)"},"PossibilityCreateRefusal":{"type":"boolean","description":"Доступність замовлення послуги відмови від вантажу (true/false)"},"PossibilityChangeEW":{"type":"boolean","description":"Доступність замовлення послуги внесення змін в експрес-накладну (ЕН) (true/false)"},"PossibilityCreateRedirecting":{"type":"boolean","description":"Доступність замовлення послуги переадресування (true/false)"},"Number":{"type":"string","maxLength":36,"description":"Номер документа"},"Redelivery":{"type":"string","maxLength":36,"description":"Ідентифікатор зворотної доставки (0 — відсутня, 1 — наявна)"},"RedeliverySum":{"type":"string","maxLength":36,"description":"Сума зворотної доставки"},"RedeliveryNum":{"type":"string","maxLength":36,"description":"Ідентифікатор номера ЕН зворотної доставки (якщо створено)"},"RedeliveryPayer":{"type":"string","maxLength":36,"description":"Ідентифікатор платника зворотної доставки"},"OwnerDocumentType":{"type":"string","maxLength":36,"description":"Тип ЕН на підставі"},"LastCreatedOnTheBasisDocumentType":{"type":"string","maxLength":36,"description":"Останні зміни типу документа"},"LastCreatedOnTheBasisPayerType":{"type":"string","maxLength":36,"description":"Останні зміни, тип платника"},"LastCreatedOnTheBasisDateTime":{"type":"string","maxLength":36,"description":"Останні зміни, дата створення"},"LastTransactionStatusGM":{"type":"string","maxLength":36,"description":"Останній статус транзакції грошового переказу"},"LastTransactionDateTimeGM":{"type":"string","maxLength":36,"description":"Останній час та дата транзакції грошового переказу"},"LastAmountTransferGM":{"type":"string","maxLength":36,"description":"Поточне значення суми грошового переказу"},"DateCreated":{"type":"string","maxLength":36,"description":"Дата створення ЕН"},"DocumentWeight":{"type":"string","maxLength":36,"description":"Вага"},"FactualWeight":{"type":"string","maxLength":36,"description":"Фактична вага з ЕН"},"VolumeWeight":{"type":"string","maxLength":36,"description":"Об'ємна вага з ЕН"},"CheckWeight":{"type":"string","maxLength":36,"description":"Інформація після контрольного зважування"},"CheckWeightMethod":{"type":"string","maxLength":36,"description":"Тип зважування, згідно з яким виконувалось контрольне зважування"},"DocumentCost":{"type":"string","maxLength":36,"description":"Вартість доставки"},"CalculatedWeight":{"type":"string","maxLength":36,"description":"Розрахункова вага"},"SumBeforeCheckWeight":{"type":"string","maxLength":36,"description":"Інформація до контрольного зважування"},"PayerType":{"type":"string","maxLength":36,"description":"Ідентифікатор платника"},"RecipientFullName":{"type":"string","maxLength":36,"description":"Дані ПІБ отримувача з накладної, за умови зазначення номера телефону"},"RecipientDateTime":{"type":"string","maxLength":36,"description":"Дата, коли отримувач забрав вантаж"},"ScheduledDeliveryDate":{"type":"string","maxLength":36,"description":"Очікувана дата доставки"},"PaymentMethod":{"type":"string","maxLength":36,"description":"Тип оплати"},"CargoDescriptionString":{"type":"string","maxLength":36,"description":"Опис вантажу"},"CargoType":{"type":"string","maxLength":36,"description":"Тип вантажу"},"CitySender":{"type":"string","maxLength":36,"description":"Місто відправника"},"CityRecipient":{"type":"string","maxLength":36,"description":"Місто отримувача"},"WarehouseRecipient":{"type":"string","maxLength":36,"description":"Склад отримувача"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"AfterpaymentOnGoodsCost":{"type":"string","maxLength":36,"description":"Контроль оплати"},"ServiceType":{"type":"string","maxLength":36,"description":"Тип доставки"},"UndeliveryReasonsSubtypeDescription":{"type":"string","maxLength":36,"description":"Опис причини нерозвезення"},"WarehouseRecipientNumber":{"type":"string","maxLength":36,"description":"Номер відділення отримувача"},"LastCreatedOnTheBasisNumber":{"type":"string","maxLength":36,"description":"Останні зміни, номер ЕН"},"PhoneRecipient":{"type":"string","maxLength":36,"description":"Номер телефону отримувача"},"RecipientFullNameEW":{"type":"string","maxLength":36,"description":"Дані ПІБ отримувача з накладної, за умови зазначення в запиті номера телефону"},"WarehouseRecipientInternetAddressRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) складу отримувача"},"MarketplacePartnerToken":{"type":"string","maxLength":36,"description":"Токен торговельного майданчика"},"ClientBarcode":{"type":"string","maxLength":36,"description":"Внутрішній номер замовлення"},"RecipientAddress":{"type":"string","maxLength":36,"description":"Адреса отримувача"},"CounterpartyRecipientDescription":{"type":"string","maxLength":36,"description":"Опис контрагента отримувача"},"CounterpartySenderType":{"type":"string","maxLength":36,"description":"Тип контрагента відправника"},"DateScan":{"type":"string","maxLength":36,"description":"Дата сканування, що призвела до формування статусу"},"PaymentStatus":{"type":"string","maxLength":36,"description":"Статус для інтернет-еквайрингу"},"PaymentStatusDate":{"type":"string","maxLength":36,"description":"Дата оплати для інтернет-еквайрингу"},"AmountToPay":{"type":"string","maxLength":36,"description":"Сума до сплати для інтернет-еквайрингу"},"AmountPaid":{"type":"string","maxLength":36,"description":"Сплачено для інтернет-еквайрингу"},"Status":{"type":"string","maxLength":36,"description":"Статус"},"StatusCode":{"type":"string","maxLength":36,"description":"Ідентифікатор статусу"},"RefEW":{"type":"string","maxLength":36,"description":"Ідентифікатор накладної для інтернет-еквайрингу (використовується в робочих цілях)"},"BackwardDeliverySubTypesActions":{"type":"string","maxLength":36,"description":"Інформація за нестандартними підтипами зворотної доставки"},"BackwardDeliverySubTypesServices":{"type":"string","maxLength":36,"description":"Інформація за нестандартними підтипами зворотної доставки"},"UndeliveryReasons":{"type":"string","maxLength":36,"description":"Причина нерозвезення"},"DatePayedKeeping":{"type":"string","maxLength":36,"description":"Дата початку платного зберігання"},"InternationalDeliveryType":{"type":"string","maxLength":36,"description":"Тип міжнародної доставки"},"SeatsAmount":{"type":"string","maxLength":36,"description":"Кількість місць"},"CardMaskedNumber":{"type":"string","maxLength":36,"description":"Замаскований номер платіжної карти"},"ExpressWaybillPaymentStatus":{"type":"string","maxLength":36,"description":"Статус оплати ЕН"},"ExpressWaybillAmountToPay":{"type":"string","maxLength":36,"description":"Сума оплати за ЕН"},"PhoneSender":{"type":"string","maxLength":36,"description":"Телефон відправника"},"TrackingUpdateDate":{"type":"string","maxLength":36,"description":"Оновлена дата відстеження"},"WarehouseSender":{"type":"string","maxLength":36,"description":"Відділення відправника"},"DateReturnCargo":{"type":"string","maxLength":36,"description":"Дата повернення вантажу"},"DateMoving":{"type":"string","maxLength":36,"description":"Дата переміщення"},"DateFirstDayStorage":{"type":"string","maxLength":36,"description":"Дата початку зберігання"},"RefCityRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор міста одержувача"},"RefCitySender":{"type":"string","maxLength":36,"description":"Ідентифікатор міста відправника"},"RefSettlementRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор населеного пункту одержувача"},"RefSettlementSender":{"type":"string","maxLength":36,"description":"Ідентифікатор населеного пункту відправника"},"SenderAddress":{"type":"string","maxLength":36,"description":"Адреса відправника"},"SenderFullNameEW":{"type":"string","maxLength":36,"description":"Повне ім'я відправника"},"AnnouncedPrice":{"type":"string","maxLength":36,"description":"Оголошена вартість"},"AdditionalInformationEW":{"type":"string","maxLength":36,"description":"Додаткова інформація"},"ActualDeliveryDate":{"type":"string","maxLength":36,"description":"Фактична дата доставки"},"PostomatV3CellReservationNumber":{"type":"string","maxLength":36,"description":"Номер бронювання комірки поштомата, за умови доставки до поштомата"},"OwnerDocumentNumber":{"type":"string","maxLength":36,"description":"Номер ЕН на основі"},"LastAmountReceivedCommissionGM":{"type":"string","maxLength":36,"description":"Сума комісії за грошовий переказ"},"DeliveryTimeframe":{"type":"string","maxLength":36,"description":"Часовий інтервал, якщо було замовлено (тільки для ЕН до адреси)"},"CreatedOnTheBasis":{"type":"string","maxLength":36,"description":"Створено на основі"},"UndeliveryReasonsDate":{"type":"string","maxLength":36,"description":"Дата причини нерозвезення"},"RecipientWarehouseTypeRef":{"type":"string","maxLength":36,"description":"Ідентифікатор типу відділення одержувача"},"WarehouseRecipientRef":{"type":"string","maxLength":36,"description":"Ідентифікатор відділення одержувача"},"CategoryOfWarehouse":{"type":"string","maxLength":36,"description":"Категорія відділення"},"WarehouseRecipientAddress":{"type":"string","maxLength":36,"description":"Адреса відділення одержувача"},"WarehouseSenderInternetAddressRef":{"type":"string","maxLength":36,"description":"Інтернет-адреса відділення відправника"},"WarehouseSenderAddress":{"type":"string","maxLength":36,"description":"Адреса відділення відправника"},"AviaDelivery":{"type":"string","maxLength":36,"description":"Авіадоставка"},"BarcodeRedBox":{"type":"string","maxLength":36,"description":"Штрихкод пакування типу RedBox"},"CargoReturnRefusal":{"type":"string","description":"Наявність послуги «Відмова від повернення» (true/false)"},"DaysStorageCargo":{"type":"string","maxLength":36,"description":"День зберігання вантажу"},"Packaging":{"type":"array","nullable":true,"description":"Пакування","items":{"type":"string"}},"PartialReturnGoods":{"type":"array","nullable":true,"description":"Часткове повернення","items":{"type":"string"}},"SecurePayment":{"type":"string","description":"Ознака надійної покупки (true/false)"},"PossibilityChangeCash2Card":{"type":"boolean","description":"Доступність можливості зміни виплати грошового переказу на картку (true/false)"},"PossibilityChangeDeliveryIntervals":{"type":"boolean","description":"Доступність зміни інтервалу доставки (true/false)"},"PossibilityTermExtensio":{"type":"boolean","description":"Доступність можливості подовження термінів зберігання (true/false)"},"StorageAmount":{"type":"string","maxLength":36,"description":"Кількість днів зберігання вантажу"},"StoragePrice":{"type":"string","maxLength":36,"description":"Вартість зберігання"},"FreeShipping":{"type":"string","maxLength":36,"description":"Ознака безкоштовної доставки"},"LoyaltyCardRecipient":{"type":"string","maxLength":36,"description":"Номер картки лояльності отримувача, за наявності"}}}}}} ``` --- # 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/api-docs-ua/zagalna-informaciya/treking.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.