> 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/methods/page-5.md).
# Page 5
16 ВЕР 2026 **`ADDED`**
Створення перенаправлення відправлення
Дізнатись деталі
Додано новий метод **Створити перенаправлення відправлення**, який дозволяє змінити місце отримання вже існуючого відправлення Nova Post без створення нового відправлення. За допомогою методу відправлення можна перенаправити у відділення, поштомат або на адресу отримувача.
## Створити перенаправлення відправлення
> Метод дозволяє створити перенаправлення для вже існуючого відправлення Nova Post та змінити місце його отримання без створення нового відправлення.\
> \
> За допомогою методу можна перенаправити відправлення:\
> \- у відділення;\
> \- у поштомат;\
> \- на адресу отримувача.\
> \
> Для нового місця доставки необхідно використовувати лише один спосіб адресації:\
> \- \`recipient.divisionId\` — для доставки у відділення або поштомат;\
> \- \`recipient.addressParts.street\` разом з іншими обов’язковими полями \`recipient.addressParts\` — для адресної доставки.\
> \
> 🔸Не передавайте \`recipient.divisionId\` та \`recipient.addressParts.street\` одночасно. Якщо не передано жодне з цих полів, запит не пройде валідацію.\
> \
> Після успішного створення перенаправлення нове відправлення створювати не потрібно. Перенаправлення застосовується до вже існуючого відправлення.
```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"}}}},"Time-out":{"description":"Час очікування з’єднання вичерпано","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/modification/redirecting":{"post":{"tags":["Shipments"],"description":"Метод дозволяє створити перенаправлення для вже існуючого відправлення Nova Post та змінити місце його отримання без створення нового відправлення.\n\nЗа допомогою методу можна перенаправити відправлення:\n- у відділення;\n- у поштомат;\n- на адресу отримувача.\n\nДля нового місця доставки необхідно використовувати лише один спосіб адресації:\n- `recipient.divisionId` — для доставки у відділення або поштомат;\n- `recipient.addressParts.street` разом з іншими обов’язковими полями `recipient.addressParts` — для адресної доставки.\n\n🔸Не передавайте `recipient.divisionId` та `recipient.addressParts.street` одночасно. Якщо не передано жодне з цих полів, запит не пройде валідацію.\n\nПісля успішного створення перенаправлення нове відправлення створювати не потрібно. Перенаправлення застосовується до вже існуючого відправлення.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","payerType","recipient"],"properties":{"id":{"description":"Ідентифікатор існуючого відправлення, для якого необхідно створити перенаправлення.\n\nМоже бути переданий як додатне ціле число або UUID. Для числового значення мінімальне значення — 1.\n\n**🔻Це поле є обов’язковим.**\n","oneOf":[{"type":"integer","minimum":1},{"type":"string","format":"uuid"}]},"payerType":{"type":"string","description":"Сторона, відповідальна за оплату послуги перенаправлення. Доступні значення:\n- `Sender` — відправник;\n- `Recipient` — отримувач;\n- `ThirdPerson` — третя особа.\n\n**🔻Це поле є обов’язковим.**\n","enum":["Sender","Recipient","ThirdPerson"]},"payerContractNumber":{"type":"string","nullable":true,"description":"Номер договору платника."},"customerType":{"type":"string","description":"Тип клієнта, який ініціює перенаправлення. Доступні значення:\n- `Recipient` — отримувач;\n- `Sender` — відправник.\n","enum":["Recipient","Sender"]},"customerPhone":{"type":"string","nullable":true,"description":"Контактний номер телефону клієнта."},"source":{"type":"string","description":"Джерело створення перенаправлення.\n\nДля інтеграції через API використовується значення `API`.\n","enum":["API"]},"note":{"type":"string","nullable":true,"description":"Коментар до перенаправлення."},"recipient":{"type":"object","description":"Дані отримувача та нового місця отримання відправлення.\n\nДля кожного запиту необхідно використовувати лише один спосіб адресації:\n- `divisionId` — для доставки у відділення або поштомат;\n- `addressParts.street` разом з іншими обов’язковими полями адреси — для адресної доставки.\n\n**🔻Ця група полів є обов’язковою.**\n","required":["phone","name","addressParts"],"properties":{"phone":{"type":"string","description":"Контактний номер телефону отримувача. Поле має бути присутнім та містити валідне непорожнє значення.\n\n**🔻Це поле є обов’язковим.**\n"},"name":{"type":"string","description":"Ім’я отримувача. Поле має бути присутнім та містити непорожнє значення.\n\n**🔻Це поле є обов’язковим.**\n"},"email":{"type":"string","nullable":true,"description":"Email отримувача."},"countryCode":{"type":"string","description":"Код країни отримувача.\n\nНаприклад: `UA`, `MD`.\n"},"companyTin":{"type":"string","nullable":true,"description":"Податковий номер компанії отримувача, якщо застосовується."},"eoriCode":{"type":"string","nullable":true,"description":"EORI-код отримувача, якщо застосовується."},"divisionId":{"type":"integer","minimum":1,"description":"Ідентифікатор відділення або поштомата.\n\n**🔹Це поле є обов’язковим, якщо** `recipient.addressParts.street` **не передано або поле має порожнє значення.**\n\nДля адресної доставки `recipient.divisionId` передавати не потрібно.\n\n🔸Не передавайте `recipient.divisionId` та `recipient.addressParts.street` одночасно.\n"},"divisionNumber":{"type":"string","nullable":true,"description":"Номер відділення або поштомата."},"settlementId":{"type":"integer","nullable":true,"description":"Ідентифікатор населеного пункту."},"addressParts":{"type":"object","description":"Дані нової адреси доставки. Об’єкт має бути присутнім у запиті незалежно від способу адресації.\n\nДля доставки у відділення або поштомат передайте порожній об’єкт `addressParts: {}` та вкажіть `recipient.divisionId`.\n\nДля адресної доставки необхідно заповнити `building`, `street`, `city`, `region` та `postCode`. Усі зазначені поля мають бути присутніми та містити непорожні значення.\n\n**🔻Ця група полів є обов’язковою.**\n","properties":{"building":{"type":"string","description":"Номер будинку.\n\n**🔹Це поле є обов’язковим для адресної доставки.**\n"},"street":{"type":"string","description":"Назва вулиці. Якщо поле заповнено, використовується сценарій адресної доставки.\n\n**🔹Це поле є обов’язковим для адресної доставки.**\n\n🔸Не передавайте `recipient.addressParts.street` одночасно з `recipient.divisionId`.\n"},"city":{"type":"string","description":"Місто.\n\n**🔹Для адресної доставки поле має бути присутнім та містити непорожнє значення.**\n"},"region":{"type":"string","description":"Область або регіон.\n\n**🔹Для адресної доставки поле має бути присутнім та містити непорожнє значення.**\n"},"postCode":{"type":"string","description":"Поштовий індекс.\n\n**🔹Для адресної доставки поле має бути присутнім та містити непорожнє значення.**\n"}}}}}}}}}},"responses":{"200":{"description":"Перенаправлення успішно створено.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Ідентифікатор створеного перенаправлення."},"number":{"type":"string","description":"Номер створеного перенаправлення."},"shipmentId":{"type":"integer","description":"Ідентифікатор відправлення, для якого створено перенаправлення."},"shipmentnumber":{"type":"string","description":"Номер існуючого відправлення Nova Post."},"type":{"type":"string","description":"Тип створеної модифікації.\n\nДля цього методу повертається `Redirecting`.\n","enum":["Redirecting"]},"status":{"type":"string","description":"Поточний статус обробки перенаправлення.\n\n🔹`NeedProcessing` означає, що перенаправлення створено та передано на подальшу обробку.\n"},"payerType":{"type":"string","description":"Сторона, відповідальна за оплату послуги перенаправлення.","enum":["Sender","Recipient","ThirdPerson"]},"customerType":{"type":"string","description":"Тип клієнта, який ініціював перенаправлення. Можливі значення:\n- `Recipient` — отримувач;\n- `Sender` — відправник.\n","enum":["Recipient","Sender"]},"note":{"type":"string","description":"Коментар до перенаправлення."},"scheduledDeliveryDate":{"type":"string","format":"date-time","description":"Планова дата та час доставки після перенаправлення."},"cost":{"type":"number","description":"Вартість послуги перенаправлення."},"currency":{"type":"string","description":"Код валюти вартості послуги.\n\nНаприклад: `USD`.\n"},"currencySymbol":{"type":"string","description":"Символ валюти.\n\nНаприклад: `$`.\n"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Відправлення з указаним ідентифікатором не знайдено."},"422":{"description":"Запит не пройшов валідацію або перенаправлення неможливо виконати для поточного відправлення."},"503":{"$ref":"#/components/responses/Time-out"}},"summary":"Створити перенаправлення відправлення"}}}}
```
16 SEP 2026 **`ADDED`**
Create a shipment redirect
Details
A new method, **Create a shipment redirect**, has been added. It allows you to change the delivery location of an existing Nova Post shipment without creating a new shipment. Using this method, a shipment can be redirected to a branch, a parcel locker, or the recipient's address.
## Create a shipment redirect
> The method allows you to create a redirect for an existing Nova Post shipment and change its delivery location without creating a new shipment.\
> \
> Using this method, a shipment can be redirected:\
> \- to a branch;\
> \- to a parcel locker;\
> \- to the recipient's address.\
> \
> For the new delivery location, only one addressing method must be used:\
> \- \`recipient.divisionId\` — for delivery to a branch or parcel locker;\
> \- \`recipient.addressParts.street\` together with the other required \`recipient.addressParts\` fields — for address delivery.\
> \
> 🔸Do not provide \`recipient.divisionId\` and \`recipient.addressParts.street\` at the same time. If neither of these fields is provided, the request will fail validation.\
> \
> After a redirect is successfully created, there is no need to create a new shipment. The redirect is applied to the existing shipment.
```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":"Authorization JWT-token with a lifetime of 1 hour in header"}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Time-out":{"description":"Connection time-out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"errors":{"type":"object","properties":{"":{"type":"string"}}}}}}},"paths":{"/shipments/modification/redirecting":{"post":{"summary":"Create a shipment redirect","tags":["Shipments"],"description":"The method allows you to create a redirect for an existing Nova Post shipment and change its delivery location without creating a new shipment.\n\nUsing this method, a shipment can be redirected:\n- to a branch;\n- to a parcel locker;\n- to the recipient's address.\n\nFor the new delivery location, only one addressing method must be used:\n- `recipient.divisionId` — for delivery to a branch or parcel locker;\n- `recipient.addressParts.street` together with the other required `recipient.addressParts` fields — for address delivery.\n\n🔸Do not provide `recipient.divisionId` and `recipient.addressParts.street` at the same time. If neither of these fields is provided, the request will fail validation.\n\nAfter a redirect is successfully created, there is no need to create a new shipment. The redirect is applied to the existing shipment.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","payerType","recipient"],"properties":{"id":{"description":"Identifier of the existing shipment for which a redirect must be created.\n\nIt can be passed as a positive integer or UUID. For a numeric value, the minimum value is 1.\n\n**🔻This field is required.**\n","oneOf":[{"type":"integer","minimum":1},{"type":"string","format":"uuid"}]},"payerType":{"type":"string","description":"Party responsible for paying for the redirect service. Available values:\n- `Sender` — sender;\n- `Recipient` — recipient;\n- `ThirdPerson` — third party.\n\n**🔻This field is required.**\n","enum":["Sender","Recipient","ThirdPerson"]},"payerContractNumber":{"type":"string","nullable":true,"description":"Payer's contract number."},"customerType":{"type":"string","description":"Type of customer initiating the redirect. Available values:\n- `Recipient` — recipient;\n- `Sender` — sender.\n","enum":["Recipient","Sender"]},"customerPhone":{"type":"string","nullable":true,"description":"Customer's contact phone number."},"source":{"type":"string","description":"Source from which the redirect is created.\n\nFor API integration, use the value `API`.\n","enum":["API"]},"note":{"type":"string","nullable":true,"description":"Comment for the redirect."},"recipient":{"type":"object","description":"Recipient data and the new shipment delivery location.\n\nEach request must use only one addressing method:\n- `divisionId` — for delivery to a branch or parcel locker;\n- `addressParts.street` together with the other required address fields — for address delivery.\n\n**🔻This group of fields is required.**\n","required":["phone","name","addressParts"],"properties":{"phone":{"type":"string","description":"Recipient's contact phone number. The field must be present and contain a valid non-empty value.\n\n**🔻This field is required.**\n"},"name":{"type":"string","description":"Recipient's name. The field must be present and contain a non-empty value.\n\n**🔻This field is required.**\n"},"email":{"type":"string","nullable":true,"description":"Recipient's email address."},"countryCode":{"type":"string","description":"Recipient's country code.\n\nFor example: `UA`, `MD`.\n"},"companyTin":{"type":"string","nullable":true,"description":"Recipient company tax identification number, if applicable."},"eoriCode":{"type":"string","nullable":true,"description":"Recipient's EORI code, if applicable."},"divisionId":{"type":"integer","minimum":1,"description":"Branch or parcel locker identifier.\n\n**🔹This field is required if** `recipient.addressParts.street` **is not provided or has an empty value.**\n\nFor address delivery, `recipient.divisionId` does not need to be provided.\n\n🔸Do not provide `recipient.divisionId` and `recipient.addressParts.street` at the same time.\n"},"divisionNumber":{"type":"string","nullable":true,"description":"Branch or parcel locker number."},"settlementId":{"type":"integer","nullable":true,"description":"Settlement identifier."},"addressParts":{"type":"object","description":"New delivery address data. The object must be present in the request regardless of the addressing method.\n\nFor delivery to a branch or parcel locker, provide an empty `addressParts: {}` object and specify `recipient.divisionId`.\n\nFor address delivery, `building`, `street`, `city`, `region`, and `postCode` must be populated. All specified fields must be present and contain non-empty values.\n\n**🔻This group of fields is required.**\n","properties":{"building":{"type":"string","description":"Building number.\n\n**🔹This field is required for address delivery.**\n"},"street":{"type":"string","description":"Street name. If this field is populated, the address delivery scenario is used.\n\n**🔹This field is required for address delivery.**\n\n🔸Do not provide `recipient.addressParts.street` together with `recipient.divisionId`.\n"},"city":{"type":"string","description":"City.\n\n**🔹For address delivery, this field must be present and contain a non-empty value.**\n"},"region":{"type":"string","description":"Region.\n\n**🔹For address delivery, this field must be present and contain a non-empty value.**\n"},"postCode":{"type":"string","description":"Postal code.\n\n**🔹For address delivery, this field must be present and contain a non-empty value.**\n"}}}}}}}}}},"responses":{"200":{"description":"Redirect successfully created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"Identifier of the created redirect."},"number":{"type":"string","description":"Number of the created redirect."},"shipmentId":{"type":"integer","description":"Identifier of the shipment for which the redirect was created."},"shipmentnumber":{"type":"string","description":"Number of the existing Nova Post shipment."},"type":{"type":"string","description":"Type of the created modification.\n\nFor this method, `Redirecting` is returned.\n","enum":["Redirecting"]},"status":{"type":"string","description":"Current redirect processing status.\n\n🔹`NeedProcessing` means that the redirect has been created and submitted for further processing.\n"},"payerType":{"type":"string","description":"Party responsible for paying for the redirect service.","enum":["Sender","Recipient","ThirdPerson"]},"customerType":{"type":"string","description":"Type of customer that initiated the redirect. Possible values:\n- `Recipient` — recipient;\n- `Sender` — sender.\n","enum":["Recipient","Sender"]},"note":{"type":"string","description":"Comment for the redirect."},"scheduledDeliveryDate":{"type":"string","format":"date-time","description":"Scheduled delivery date and time after the redirect."},"cost":{"type":"number","description":"Cost of the redirect service."},"currency":{"type":"string","description":"Currency code of the service cost.\n\nFor example: `USD`.\n"},"currencySymbol":{"type":"string","description":"Currency symbol.\n\nFor example: `$`.\n"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"The shipment with the specified identifier was not found."},"422":{"description":"The request failed validation, or redirecting cannot be performed for the current shipment."},"503":{"$ref":"#/components/responses/Time-out"}}}}}}
```
---
# 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/methods/page-5.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.