> 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/ua/overview/shipments/perenapravlennya-vidpravlennya.md).
# Перенаправлення відправлення
## Створити перенаправлення відправлення
> Метод дозволяє створити перенаправлення для вже існуючого відправлення 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":{"summary":"Створити перенаправлення відправлення","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":"Коментар до перенаправлення.\n\n**🔹Якщо коментар відсутній, передайте порожній рядок.**\n"},"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"}}}}}}
```
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://api-portal.novapost.com/methods/ua/overview/shipments/perenapravlennya-vidpravlennya.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.