> 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/page-3.md).
# Page 3
## Створити експрес-накладну до відділення (рядком)
> Метод \*\*save\*\* працює в моделі \*\*InternetDocumentGeneral\*\* та дозволяє створювати (формувати) експрес-накладну (інтернет-документ) до відділення.\
> \
> Після створення інтернет-документа в програмному середовищі API, ЕН з'являється в особистому кабінеті.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.pl/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"paths":{"/json":{"post":{"tags":["InternetDocument"],"summary":"Створити експрес-накладну до відділення (рядком)","description":"Метод **save** працює в моделі **InternetDocumentGeneral** та дозволяє створювати (формувати) експрес-накладну (інтернет-документ) до відділення.\n\nПісля створення інтернет-документа в програмному середовищі API, ЕН з'являється в особистому кабінеті.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API ключ."},"modelName":{"type":"string"},"calledMethod":{"type":"string"},"methodProperties":{"type":"object","required":["PayerType","PaymentMethod","DateTime","CargoType","Weight","ServiceType","SeatsAmount","Description","Cost","CitySender","Sender","SenderAddress","ContactSender","SendersPhone","RecipientsPhone","NewAddress","RecipientCityName","RecipientArea","RecipientAreaRegions","RecipientAddressName","RecipientName","RecipientType","SettlementType","EDRPOU"],"properties":{"PayerType":{"type":"string","maxLength":36,"description":"Тип платника (Sender, Recipient, ThirdPerson)"},"PaymentMethod":{"type":"string","maxLength":36,"description":"Форма розрахунку (Cash/NonCash)"},"DateTime":{"type":"string","maxLength":36,"description":"Дата відправки у форматі дд.мм.рррр"},"CargoType":{"type":"string","maxLength":36,"description":"Тип вантажу"},"VolumeGeneral":{"type":"string","maxLength":36,"description":"Загальний об'єм, м.куб (min. 0.0004), обов'язково зазначати, якщо не передається параметр OptionsSeat"},"Weight":{"type":"string","maxLength":36,"description":"Фактична вага, кг (min. 0,1)"},"ServiceType":{"type":"string","maxLength":36,"description":"Технологія доставки (DoorsDoors, DoorsWarehouse, WarehouseWarehouse, WarehouseDoors)"},"SeatsAmount":{"type":"string","maxLength":36,"description":"Кількість місць відправлення, ціле число"},"Description":{"type":"string","maxLength":36,"description":"Текстове поле, вводиться для додаткового опису відправлення"},"Cost":{"type":"string","maxLength":36,"description":"Оціночна вартість, ціле число (якщо не зазначити вартість, то API автоматично проставить мінімальну оціночну вартість — 300.00)"},"CitySender":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) міста відправника"},"Sender":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) відправника"},"SenderAddress":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) адреси відправника. Дані з відповіді методу \"Список адрес контрагента\""},"ContactSender":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи-відправника. Дані з відповіді методу \"Список контактних осіб контрагента\""},"SendersPhone":{"type":"string","maxLength":36,"description":"Телефон відправника у форматі +380660000000, 380660000000, 0660000001"},"RecipientsPhone":{"type":"string","maxLength":36,"description":"Телефон отримувача у форматі +380660000000, 380660000000, 0660000001"},"NewAddress":{"type":"string","maxLength":36,"description":"Використання нового адресного довідника (1 — так, 0 — ні)"},"RecipientCityName":{"type":"string","maxLength":36,"description":"Назва міста отримувача (ЗАЗНАЧАЄТЬСЯ ТЕКСТОМ)"},"RecipientArea":{"type":"string","maxLength":36,"description":"Назва області (ЗАЗНАЧАЄТЬСЯ ТЕКСТОМ)"},"RecipientAreaRegions":{"type":"string","maxLength":36,"description":"Назва району (ЗАЗНАЧАЄТЬСЯ ТЕКСТОМ)"},"RecipientAddressName":{"type":"string","maxLength":36,"description":"Номер відділення"},"RecipientHouse":{"type":"string","maxLength":36,"description":"У разі відправлення на відділення це поле не заповнювати"},"RecipientFlat":{"type":"string","maxLength":36,"description":"У разі відправлення на відділення це поле не заповнювати"},"RecipientName":{"type":"string","description":"ПІБ отримувача (для приватної особи); назва організації отримувача (для організації)","maxLength":255},"RecipientType":{"type":"string","description":"Тип отримувача (Organization/PrivatePerson)\n","enum":["PrivatePerson","Organization"]},"SettlementType":{"type":"string","description":"Тип населеного пункту: значення параметру SettlementTypeDescription з методу getSettlements або значення SettlementTypeCode запиту на онлайн-пошук населених пунктів searchSettlements\n","maxLength":36},"OwnershipForm":{"type":"string","nullable":true,"description":"Ідентифікатор форми власності","maxLength":36},"RecipientContactName":{"type":"string","nullable":true,"description":"ПІБ отримувача","maxLength":255},"EDRPOU":{"type":"string","description":"ЄДРПОУ","maxLength":36}}}}}}}},"responses":{"200":{"description":"Експрес-накладну створено","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Вказує, чи було запит успішно оброблено."},"data":{"type":"array","description":"Список створених експрес-накладних.","items":{"type":"object","properties":{"Ref":{"type":"string","description":"Ідентифікатор (REF) експрес-накладної","maxLength":36},"CostOnSite":{"type":"string","description":"Вартість доставки","maxLength":36},"EstimatedDeliveryDate":{"type":"string","description":"Прогнозована дата доставки","maxLength":36},"IntDocNumber":{"type":"string","description":"Номер експрес-накладної","maxLength":36},"TypeDocument":{"type":"string","description":"Тип експрес-накладної","maxLength":36}}}}}}}}}}}}}}
```
## Створити експрес-накладну до відділення (XML)
> Метод \*\*save\*\* працює в моделі \*\*InternetDocumentGeneral\*\* та дозволяє створювати (формувати) експрес-накладну (інтернет-документ) до відділення.\
> \
> Після створення інтернет-документа в програмному середовищі API, ЕН з'являється в особистому кабінеті.
```json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.pl/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"paths":{"/xml":{"post":{"tags":["InternetDocument"],"summary":"Створити експрес-накладну до відділення (XML)","description":"Метод **save** працює в моделі **InternetDocumentGeneral** та дозволяє створювати (формувати) експрес-накладну (інтернет-документ) до відділення.\n\nПісля створення інтернет-документа в програмному середовищі API, ЕН з'являється в особистому кабінеті.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"type":"object","xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API ключ.","xml":{"name":"apiKey"}},"modelName":{"type":"string","xml":{"name":"modelName"}},"calledMethod":{"type":"string","xml":{"name":"calledMethod"}},"methodProperties":{"type":"object","xml":{"name":"methodProperties"},"required":["PayerType","PaymentMethod","DateTime","CargoType","Weight","ServiceType","SeatsAmount","Description","Cost","CitySender","Sender","SenderAddress","ContactSender","SendersPhone","RecipientsPhone","NewAddress","RecipientCityName","RecipientArea","RecipientAreaRegions","RecipientAddressName","RecipientName","RecipientType","SettlementType","EDRPOU"],"properties":{"PayerType":{"type":"string","maxLength":36,"description":"Тип платника (Sender, Recipient, ThirdPerson)","xml":{"name":"PayerType"}},"PaymentMethod":{"type":"string","maxLength":36,"description":"Форма розрахунку (Cash/NonCash)","xml":{"name":"PaymentMethod"}},"DateTime":{"type":"string","maxLength":36,"description":"Дата відправки у форматі дд.мм.рррр","xml":{"name":"DateTime"}},"CargoType":{"type":"string","maxLength":36,"description":"Тип вантажу","xml":{"name":"CargoType"}},"VolumeGeneral":{"type":"string","maxLength":36,"description":"Загальний об'єм, м.куб (min. 0.0004), обов'язково зазначати, якщо не передається параметр OptionsSeat","xml":{"name":"VolumeGeneral"}},"Weight":{"type":"string","maxLength":36,"description":"Фактична вага, кг (min. 0,1)","xml":{"name":"Weight"}},"ServiceType":{"type":"string","maxLength":36,"description":"Технологія доставки (DoorsDoors, DoorsWarehouse, WarehouseWarehouse, WarehouseDoors)","xml":{"name":"ServiceType"}},"SeatsAmount":{"type":"string","maxLength":36,"description":"Кількість місць відправлення, ціле число","xml":{"name":"SeatsAmount"}},"Description":{"type":"string","maxLength":36,"description":"Текстове поле, вводиться для додаткового опису відправлення","xml":{"name":"Description"}},"Cost":{"type":"string","maxLength":36,"description":"Оціночна вартість, ціле число (якщо не зазначити вартість, то API автоматично проставить мінімальну оціночну вартість — 300.00)","xml":{"name":"Cost"}},"CitySender":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) міста відправника","xml":{"name":"CitySender"}},"Sender":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) відправника","xml":{"name":"Sender"}},"SenderAddress":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) адреси відправника. Дані з відповіді методу \"Список адрес контрагента\"","xml":{"name":"SenderAddress"}},"ContactSender":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи-відправника. Дані з відповіді методу \"Список контактних осіб контрагента\"","xml":{"name":"ContactSender"}},"SendersPhone":{"type":"string","maxLength":36,"description":"Телефон відправника у форматі +380660000000, 380660000000, 0660000001","xml":{"name":"SendersPhone"}},"RecipientsPhone":{"type":"string","maxLength":36,"description":"Телефон отримувача у форматі +380660000000, 380660000000, 0660000001","xml":{"name":"RecipientsPhone"}},"NewAddress":{"type":"string","maxLength":36,"description":"Використання нового адресного довідника (1 — так, 0 — ні)","xml":{"name":"NewAddress"}},"RecipientCityName":{"type":"string","maxLength":36,"description":"Назва міста отримувача (ЗАЗНАЧАЄТЬСЯ ТЕКСТОМ)","xml":{"name":"RecipientCityName"}},"RecipientArea":{"type":"string","maxLength":36,"description":"Назва області (ЗАЗНАЧАЄТЬСЯ ТЕКСТОМ)","xml":{"name":"RecipientArea"}},"RecipientAreaRegions":{"type":"string","maxLength":36,"description":"Назва району (ЗАЗНАЧАЄТЬСЯ ТЕКСТОМ)","xml":{"name":"RecipientAreaRegions"}},"RecipientAddressName":{"type":"string","maxLength":36,"description":"Номер відділення","xml":{"name":"RecipientAddressName"}},"RecipientHouse":{"type":"string","maxLength":36,"description":"У разі відправлення на відділення це поле не заповнювати","xml":{"name":"RecipientHouse"}},"RecipientFlat":{"type":"string","maxLength":36,"description":"У разі відправлення на відділення це поле не заповнювати","xml":{"name":"RecipientFlat"}},"RecipientName":{"type":"string","description":"ПІБ отримувача (для приватної особи); назва організації отримувача (для організації)","maxLength":255,"xml":{"name":"RecipientName"}},"RecipientType":{"type":"string","description":"Тип отримувача (Organization/PrivatePerson)\n","enum":["PrivatePerson","Organization"],"xml":{"name":"RecipientType"}},"SettlementType":{"type":"string","description":"Тип населеного пункту: значення параметру SettlementTypeDescription з методу getSettlements або значення SettlementTypeCode запиту на онлайн-пошук населених пунктів searchSettlements\n","maxLength":36,"xml":{"name":"SettlementType"}},"OwnershipForm":{"type":"string","nullable":true,"description":"Ідентифікатор форми власності","maxLength":36,"xml":{"name":"OwnershipForm"}},"RecipientContactName":{"type":"string","nullable":true,"description":"ПІБ отримувача","maxLength":255,"xml":{"name":"RecipientContactName"}},"EDRPOU":{"type":"string","description":"ЄДРПОУ","maxLength":36,"xml":{"name":"EDRPOU"}}}}}}}}},"responses":{"200":{"description":"Експрес-накладну створено","content":{"application/xml":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Вказує, чи було запит успішно оброблено."},"data":{"type":"array","description":"Список створених експрес-накладних.","items":{"type":"object","properties":{"Ref":{"type":"string","description":"Ідентифікатор (REF) експрес-накладної","maxLength":36},"CostOnSite":{"type":"string","description":"Вартість доставки","maxLength":36},"EstimatedDeliveryDate":{"type":"string","description":"Прогнозована дата доставки","maxLength":36},"IntDocNumber":{"type":"string","description":"Номер експрес-накладної","maxLength":36},"TypeDocument":{"type":"string","description":"Тип експрес-накладної","maxLength":36}}}}}}}}}}}}}}
```
## Створити експрес-накладну зі зворотною доставкою
> Метод \*\*save\*\* працює в моделі \*\*InternetDocument\*\*. Цей метод дозволяє створювати/формувати експрес-накладну (інтернет-документ) із замовленням послуги \*\*"Зворотна доставка"\*\*.\
> \
> \*\*Увага!\*\* Допустимі значення платника: \*\*"Відправник"\*\* або \*\*"Одержувач"\*\*.\
> \
> Можливо сформувати запит із додатковими послугами.\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка документів із різними підтипами"\*\*\
> \
> Щоб замовити послугу \*\*"Зворотна доставка документів із різними підтипами"\*\*, у параметрі \`UserActions\` необхідно передавати значення \`UserCallSender\` ("Перетелефонувати відправнику"). Це потрібно для того, щоб у разі відсутності в одержувача повного пакета документів або неправильно оформлених документів оператор міг зателефонувати відправнику та уточнити подальші дії.\
> \
> \*\*Можливі підтипи документів:\*\*\
> \
> \- \`Attorney\` — довіреність із підписом та печаткою (доступно лише разом), значення \`true\` або \`false\`\
> \- \`IsTakeAttorney\` — забір довіреності, значення \`1\` — так, \`0\` — ні\
> \- \`WaybillNewPostWithStamp\`; \`WaybillNewPostWithoutStamp\` — експрес-накладна (ЕН) ТОВ "Нова пошта" з підписом та печаткою, значення \`true\` або \`false\`\
> \- \`WaybillNewPostWithStamp\` — ЕН ТОВ "Нова пошта" з печаткою, значення \`true\` або \`false\`\
> \- \`WaybillNewPostWithoutStamp\` — ЕН ТОВ "Нова пошта" з підписом, значення \`true\` або \`false\`\
> \- \`WaybillStateNumber1WithStamp\`; \`WaybillStateNumber1WithoutStamp\` — ТТН державного зразка (№1) з підписом та печаткою, значення \`true\` або \`false\`\
> \- \`WaybillStateNumber1WithStamp\` — ТТН державного зразка (№1) з печаткою, значення \`true\` або \`false\`\
> \- \`WaybillStateNumber1WithoutStamp\` — ТТН державного зразка (№1) з підписом, значення \`true\` або \`false\`\
> \- \`CostWaybillWithStamp\`; \`CostWaybillWithoutStamp\` — видаткова накладна з підписом та печаткою, значення \`true\` або \`false\`\
> \- \`CostWaybillWithStamp\` — видаткова накладна з печаткою, значення \`true\` або \`false\`\
> \- \`CostWaybillWithoutStamp\` — видаткова накладна з підписом, значення \`true\` або \`false\`\
> \- \`InternationalWaybill\` — міжнародна накладна з підписом, значення \`true\` або \`false\`\
> \- \`OrderFrom\` — бланк замовлення з підписом, значення \`true\` або \`false\`\
> \- \`AktPPVWithStamp\`; \`AktPPVWithoutStamp\` — акт прийому-передачі з підписом та печаткою, значення \`true\` або \`false\`\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender",\
> "CargoType": "Documents",\
> "Services": {\
> "Attorney": true,\
> "WaybillNewPostWithStamp": true,\
> "UserActions": "UserCallSender"\
> }\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка грошей"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender або Recipient",\
> "CargoType": "Money",\
> "RedeliveryString": "4552"\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Контроль підпису документів"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender",\
> "CargoType": "SignedDocuments",\
> "RedeliveryString": ""\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка піддонів"\*\*\
> \
> \*\*Увага!\*\* Послуга \*\*"Зворотна доставка піддонів"\*\* тимчасово відключена.\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка двох видів"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender",\
> "CargoType": "Money",\
> "RedeliveryString": "4552"\
> },\
> {\
> "PayerType": "Sender",\
> "CargoType": "Trays",\
> "RedeliveryString": "Піддоні( тара)",\
> "Trays": \[\
> {\
> "CargoDescription": "d5c36c5c-a29d-11de-a2ca-000c294065a1",\
> "Amount": "5"\
> },\
> {\
> "CargoDescription": "d5c36c5d-a29d-11de-a2ca-000c294065a1",\
> "Amount": "3"\
> }\
> ]\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка документів"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender або Recipient",\
> "CargoType": "Documents",\
> "RedeliveryString": ""\
> }\
> ]\
> \`\`\`\
> \
> Після створення інтернет-документа в програмному середовищі API, ЕН з'являється у відповідному списку в особистому кабінеті.
````json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.pl/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"paths":{"/json":{"post":{"tags":["InternetDocument"],"summary":"Створити експрес-накладну зі зворотною доставкою","description":"Метод **save** працює в моделі **InternetDocument**. Цей метод дозволяє створювати/формувати експрес-накладну (інтернет-документ) із замовленням послуги **\"Зворотна доставка\"**.\n\n**Увага!** Допустимі значення платника: **\"Відправник\"** або **\"Одержувач\"**.\n\nМожливо сформувати запит із додатковими послугами.\n\n**Формування запиту із замовленням послуги \"Зворотна доставка документів із різними підтипами\"**\n\nЩоб замовити послугу **\"Зворотна доставка документів із різними підтипами\"**, у параметрі `UserActions` необхідно передавати значення `UserCallSender` (\"Перетелефонувати відправнику\"). Це потрібно для того, щоб у разі відсутності в одержувача повного пакета документів або неправильно оформлених документів оператор міг зателефонувати відправнику та уточнити подальші дії.\n\n**Можливі підтипи документів:**\n\n- `Attorney` — довіреність із підписом та печаткою (доступно лише разом), значення `true` або `false`\n- `IsTakeAttorney` — забір довіреності, значення `1` — так, `0` — ні\n- `WaybillNewPostWithStamp`; `WaybillNewPostWithoutStamp` — експрес-накладна (ЕН) ТОВ \"Нова пошта\" з підписом та печаткою, значення `true` або `false`\n- `WaybillNewPostWithStamp` — ЕН ТОВ \"Нова пошта\" з печаткою, значення `true` або `false`\n- `WaybillNewPostWithoutStamp` — ЕН ТОВ \"Нова пошта\" з підписом, значення `true` або `false`\n- `WaybillStateNumber1WithStamp`; `WaybillStateNumber1WithoutStamp` — ТТН державного зразка (№1) з підписом та печаткою, значення `true` або `false`\n- `WaybillStateNumber1WithStamp` — ТТН державного зразка (№1) з печаткою, значення `true` або `false`\n- `WaybillStateNumber1WithoutStamp` — ТТН державного зразка (№1) з підписом, значення `true` або `false`\n- `CostWaybillWithStamp`; `CostWaybillWithoutStamp` — видаткова накладна з підписом та печаткою, значення `true` або `false`\n- `CostWaybillWithStamp` — видаткова накладна з печаткою, значення `true` або `false`\n- `CostWaybillWithoutStamp` — видаткова накладна з підписом, значення `true` або `false`\n- `InternationalWaybill` — міжнародна накладна з підписом, значення `true` або `false`\n- `OrderFrom` — бланк замовлення з підписом, значення `true` або `false`\n- `AktPPVWithStamp`; `AktPPVWithoutStamp` — акт прийому-передачі з підписом та печаткою, значення `true` або `false`\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"Documents\",\n \"Services\": {\n \"Attorney\": true,\n \"WaybillNewPostWithStamp\": true,\n \"UserActions\": \"UserCallSender\"\n }\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Зворотна доставка грошей\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender або Recipient\",\n \"CargoType\": \"Money\",\n \"RedeliveryString\": \"4552\"\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Контроль підпису документів\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"SignedDocuments\",\n \"RedeliveryString\": \"\"\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Зворотна доставка піддонів\"**\n\n**Увага!** Послуга **\"Зворотна доставка піддонів\"** тимчасово відключена.\n\n**Формування запиту із замовленням послуги \"Зворотна доставка двох видів\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"Money\",\n \"RedeliveryString\": \"4552\"\n },\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"Trays\",\n \"RedeliveryString\": \"Піддоні( тара)\",\n \"Trays\": [\n {\n \"CargoDescription\": \"d5c36c5c-a29d-11de-a2ca-000c294065a1\",\n \"Amount\": \"5\"\n },\n {\n \"CargoDescription\": \"d5c36c5d-a29d-11de-a2ca-000c294065a1\",\n \"Amount\": \"3\"\n }\n ]\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Зворотна доставка документів\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender або Recipient\",\n \"CargoType\": \"Documents\",\n \"RedeliveryString\": \"\"\n }\n]\n```\n\nПісля створення інтернет-документа в програмному середовищі API, ЕН з'являється у відповідному списку в особистому кабінеті.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API ключ."},"modelName":{"type":"string"},"calledMethod":{"type":"string"},"methodProperties":{"type":"object","required":["PayerType","PaymentMethod","DateTime","CargoType","Weight","ServiceType","SeatsAmount","Description","Cost","CitySender","Sender","SenderAddress","ContactSender","SendersPhone","CityRecipient","Recipient","RecipientAddress","ContactRecipient","RecipientsPhone","NewAddress","OptionsSeat"],"properties":{"PayerType":{"type":"string","maxLength":36,"description":"Тип платника (Sender, Recipient, ThirdPerson)"},"PaymentMethod":{"type":"string","maxLength":36,"description":"Форма розрахунку (Cash/NonCash)"},"DateTime":{"type":"string","maxLength":36,"description":"Дата відправки у форматі дд.мм.рррр"},"CargoType":{"type":"string","maxLength":36,"description":"Тип вантажу"},"Weight":{"type":"string","maxLength":36,"description":"Фактична вага, кг (min. 0,1)"},"ServiceType":{"type":"string","maxLength":36,"description":"Технологія доставки (DoorsDoors, DoorsWarehouse, WarehouseWarehouse, WarehouseDoors)"},"SeatsAmount":{"type":"string","maxLength":36,"description":"Кількість місць відправлення, ціле число"},"Description":{"type":"string","maxLength":36,"description":"Текстове поле, вводиться для додаткового опису відправлення"},"Cost":{"type":"string","maxLength":36,"description":"Оціночна вартість, ціле число (якщо не зазначити вартість, то АРІ автоматично проставить мінімальну оціночну вартість 300.01)"},"CitySender":{"type":"string","maxLength":36,"description":"Ідентифікатор міста відправника"},"Sender":{"type":"string","maxLength":36,"description":"Ідентифікатор відправника"},"SenderAddress":{"type":"string","maxLength":36,"description":"Ідентифікатор адреси відправника (REF). Дані з відповіді методу «Список адрес контрагента»"},"ContactSender":{"type":"string","maxLength":36,"description":"Ідентифікатор контактної особи відправника (REF). Дані з відповіді методу «Список контактних осіб контрагента»"},"SendersPhone":{"type":"string","maxLength":36,"description":"Телефон відправника у форматі: +380660000000, 380660000000, 0660000001\n"},"CityRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор міста отримувача"},"Recipient":{"type":"string","maxLength":36,"description":"Ідентифікатор отримувача"},"RecipientAddress":{"type":"string","maxLength":36,"description":"Ідентифікатор адреси отримувача"},"ContactRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор контактної особи"},"RecipientsPhone":{"type":"string","maxLength":36,"description":"Телефон отримувача у форматі: +380660000000, 380660000000, 0660000001\n"},"NewAddress":{"type":"string","maxLength":36,"description":"Використання нового адресного довідника (1 — так, 0 — ні)"},"OptionsSeat":{"type":"array","description":"Параметр вантажу для кожного місця відправлення","items":{"type":"object"}},"BackwardDeliveryData":{"type":"array","description":"Зворотна доставка підтипів документів","items":{"type":"object"}}}}}}}}},"responses":{"200":{"description":"Приклад XML-запиту для створення експрес-накладної зі зворотною доставкою","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Вказує, чи було запит успішно оброблено."},"data":{"type":"array","description":"Список створених експрес-накладних.","items":{"type":"object","properties":{"Ref":{"type":"string","description":"Ідентифікатор експрес-накладної","maxLength":36},"CostOnSite":{"type":"string","description":"Вартість доставки","maxLength":36},"EstimatedDeliveryDate":{"type":"string","description":"Прогнозована дата доставки","maxLength":36},"IntDocNumber":{"type":"string","description":"Номер експрес-накладної","maxLength":36},"TypeDocument":{"type":"string","description":"Тип експрес-накладної","maxLength":36}}}}}}}}}}}}}}
````
## Створити експрес-накладну зі зворотною доставкою
> Метод \*\*save\*\* працює в моделі \*\*InternetDocument\*\*. Цей метод дозволяє створювати/формувати експрес-накладну (інтернет-документ) із замовленням послуги \*\*"Зворотна доставка"\*\*.\
> \
> \*\*Увага!\*\* Допустимі значення платника: \*\*"Відправник"\*\* або \*\*"Одержувач"\*\*.\
> \
> Можливо сформувати запит із додатковими послугами.\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка документів із різними підтипами"\*\*\
> \
> Щоб замовити послугу \*\*"Зворотна доставка документів із різними підтипами"\*\*, у параметрі \`UserActions\` необхідно передавати значення \`UserCallSender\` ("Перетелефонувати відправнику"). Це потрібно для того, щоб у разі відсутності в одержувача повного пакета документів або неправильно оформлених документів оператор міг зателефонувати відправнику та уточнити подальші дії.\
> \
> \*\*Можливі підтипи документів:\*\*\
> \
> \- \`Attorney\` — довіреність із підписом та печаткою (доступно лише разом), значення \`true\` або \`false\`\
> \- \`IsTakeAttorney\` — забір довіреності, значення \`1\` — так, \`0\` — ні\
> \- \`WaybillNewPostWithStamp\`; \`WaybillNewPostWithoutStamp\` — експрес-накладна (ЕН) ТОВ "Нова пошта" з підписом та печаткою, значення \`true\` або \`false\`\
> \- \`WaybillNewPostWithStamp\` — ЕН ТОВ "Нова пошта" з печаткою, значення \`true\` або \`false\`\
> \- \`WaybillNewPostWithoutStamp\` — ЕН ТОВ "Нова пошта" з підписом, значення \`true\` або \`false\`\
> \- \`WaybillStateNumber1WithStamp\`; \`WaybillStateNumber1WithoutStamp\` — ТТН державного зразка (№1) з підписом та печаткою, значення \`true\` або \`false\`\
> \- \`WaybillStateNumber1WithStamp\` — ТТН державного зразка (№1) з печаткою, значення \`true\` або \`false\`\
> \- \`WaybillStateNumber1WithoutStamp\` — ТТН державного зразка (№1) з підписом, значення \`true\` або \`false\`\
> \- \`CostWaybillWithStamp\`; \`CostWaybillWithoutStamp\` — видаткова накладна з підписом та печаткою, значення \`true\` або \`false\`\
> \- \`CostWaybillWithStamp\` — видаткова накладна з печаткою, значення \`true\` або \`false\`\
> \- \`CostWaybillWithoutStamp\` — видаткова накладна з підписом, значення \`true\` або \`false\`\
> \- \`InternationalWaybill\` — міжнародна накладна з підписом, значення \`true\` або \`false\`\
> \- \`OrderFrom\` — бланк замовлення з підписом, значення \`true\` або \`false\`\
> \- \`AktPPVWithStamp\`; \`AktPPVWithoutStamp\` — акт прийому-передачі з підписом та печаткою, значення \`true\` або \`false\`\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender",\
> "CargoType": "Documents",\
> "Services": {\
> "Attorney": true,\
> "WaybillNewPostWithStamp": true,\
> "UserActions": "UserCallSender"\
> }\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка грошей"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender або Recipient",\
> "CargoType": "Money",\
> "RedeliveryString": "4552"\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Контроль підпису документів"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender",\
> "CargoType": "SignedDocuments",\
> "RedeliveryString": ""\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка піддонів"\*\*\
> \
> \*\*Увага!\*\* Послуга \*\*"Зворотна доставка піддонів"\*\* тимчасово відключена.\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка двох видів"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender",\
> "CargoType": "Money",\
> "RedeliveryString": "4552"\
> },\
> {\
> "PayerType": "Sender",\
> "CargoType": "Trays",\
> "RedeliveryString": "Піддоні( тара)",\
> "Trays": \[\
> {\
> "CargoDescription": "d5c36c5c-a29d-11de-a2ca-000c294065a1",\
> "Amount": "5"\
> },\
> {\
> "CargoDescription": "d5c36c5d-a29d-11de-a2ca-000c294065a1",\
> "Amount": "3"\
> }\
> ]\
> }\
> ]\
> \`\`\`\
> \
> \*\*Формування запиту із замовленням послуги "Зворотна доставка документів"\*\*\
> \
> \*\*Приклад:\*\*\
> \
> \`\`\`json\
> "BackwardDeliveryData":\
> \[\
> {\
> "PayerType": "Sender або Recipient",\
> "CargoType": "Documents",\
> "RedeliveryString": ""\
> }\
> ]\
> \`\`\`\
> \
> Після створення інтернет-документа в програмному середовищі API, ЕН з'являється у відповідному списку в особистому кабінеті.
````json
{"openapi":"3.0.0","info":{"title":"API Nova Post","version":"1.0.0"},"tags":[],"servers":[{"description":"sandbox","url":"https://api-stage.novapost.pl/v.1.0/"},{"description":"production","url":"https://api.novapost.com/v.1.0/"}],"paths":{"/xml":{"post":{"tags":["InternetDocument"],"summary":"Створити експрес-накладну зі зворотною доставкою","description":"Метод **save** працює в моделі **InternetDocument**. Цей метод дозволяє створювати/формувати експрес-накладну (інтернет-документ) із замовленням послуги **\"Зворотна доставка\"**.\n\n**Увага!** Допустимі значення платника: **\"Відправник\"** або **\"Одержувач\"**.\n\nМожливо сформувати запит із додатковими послугами.\n\n**Формування запиту із замовленням послуги \"Зворотна доставка документів із різними підтипами\"**\n\nЩоб замовити послугу **\"Зворотна доставка документів із різними підтипами\"**, у параметрі `UserActions` необхідно передавати значення `UserCallSender` (\"Перетелефонувати відправнику\"). Це потрібно для того, щоб у разі відсутності в одержувача повного пакета документів або неправильно оформлених документів оператор міг зателефонувати відправнику та уточнити подальші дії.\n\n**Можливі підтипи документів:**\n\n- `Attorney` — довіреність із підписом та печаткою (доступно лише разом), значення `true` або `false`\n- `IsTakeAttorney` — забір довіреності, значення `1` — так, `0` — ні\n- `WaybillNewPostWithStamp`; `WaybillNewPostWithoutStamp` — експрес-накладна (ЕН) ТОВ \"Нова пошта\" з підписом та печаткою, значення `true` або `false`\n- `WaybillNewPostWithStamp` — ЕН ТОВ \"Нова пошта\" з печаткою, значення `true` або `false`\n- `WaybillNewPostWithoutStamp` — ЕН ТОВ \"Нова пошта\" з підписом, значення `true` або `false`\n- `WaybillStateNumber1WithStamp`; `WaybillStateNumber1WithoutStamp` — ТТН державного зразка (№1) з підписом та печаткою, значення `true` або `false`\n- `WaybillStateNumber1WithStamp` — ТТН державного зразка (№1) з печаткою, значення `true` або `false`\n- `WaybillStateNumber1WithoutStamp` — ТТН державного зразка (№1) з підписом, значення `true` або `false`\n- `CostWaybillWithStamp`; `CostWaybillWithoutStamp` — видаткова накладна з підписом та печаткою, значення `true` або `false`\n- `CostWaybillWithStamp` — видаткова накладна з печаткою, значення `true` або `false`\n- `CostWaybillWithoutStamp` — видаткова накладна з підписом, значення `true` або `false`\n- `InternationalWaybill` — міжнародна накладна з підписом, значення `true` або `false`\n- `OrderFrom` — бланк замовлення з підписом, значення `true` або `false`\n- `AktPPVWithStamp`; `AktPPVWithoutStamp` — акт прийому-передачі з підписом та печаткою, значення `true` або `false`\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"Documents\",\n \"Services\": {\n \"Attorney\": true,\n \"WaybillNewPostWithStamp\": true,\n \"UserActions\": \"UserCallSender\"\n }\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Зворотна доставка грошей\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender або Recipient\",\n \"CargoType\": \"Money\",\n \"RedeliveryString\": \"4552\"\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Контроль підпису документів\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"SignedDocuments\",\n \"RedeliveryString\": \"\"\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Зворотна доставка піддонів\"**\n\n**Увага!** Послуга **\"Зворотна доставка піддонів\"** тимчасово відключена.\n\n**Формування запиту із замовленням послуги \"Зворотна доставка двох видів\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"Money\",\n \"RedeliveryString\": \"4552\"\n },\n {\n \"PayerType\": \"Sender\",\n \"CargoType\": \"Trays\",\n \"RedeliveryString\": \"Піддоні( тара)\",\n \"Trays\": [\n {\n \"CargoDescription\": \"d5c36c5c-a29d-11de-a2ca-000c294065a1\",\n \"Amount\": \"5\"\n },\n {\n \"CargoDescription\": \"d5c36c5d-a29d-11de-a2ca-000c294065a1\",\n \"Amount\": \"3\"\n }\n ]\n }\n]\n```\n\n**Формування запиту із замовленням послуги \"Зворотна доставка документів\"**\n\n**Приклад:**\n\n```json\n\"BackwardDeliveryData\":\n[\n {\n \"PayerType\": \"Sender або Recipient\",\n \"CargoType\": \"Documents\",\n \"RedeliveryString\": \"\"\n }\n]\n```\n\nПісля створення інтернет-документа в програмному середовищі API, ЕН з'являється у відповідному списку в особистому кабінеті.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"type":"object","xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API ключ.","xml":{"name":"apiKey"}},"modelName":{"type":"string","xml":{"name":"modelName"}},"calledMethod":{"type":"string","xml":{"name":"calledMethod"}},"methodProperties":{"type":"object","xml":{"name":"methodProperties"},"required":["PayerType","PaymentMethod","DateTime","CargoType","Weight","ServiceType","SeatsAmount","Description","Cost","CitySender","Sender","SenderAddress","ContactSender","SendersPhone","CityRecipient","Recipient","RecipientAddress","ContactRecipient","RecipientsPhone","NewAddress","OptionsSeat"],"properties":{"PayerType":{"type":"string","maxLength":36,"description":"Тип платника (Sender, Recipient, ThirdPerson)","xml":{"name":"PayerType"}},"PaymentMethod":{"type":"string","maxLength":36,"description":"Форма розрахунку (Cash/NonCash)","xml":{"name":"PaymentMethod"}},"DateTime":{"type":"string","maxLength":36,"description":"Дата відправки у форматі дд.мм.рррр","xml":{"name":"DateTime"}},"CargoType":{"type":"string","maxLength":36,"description":"Тип вантажу","xml":{"name":"CargoType"}},"Weight":{"type":"string","maxLength":36,"description":"Фактична вага, кг (min. 0,1)","xml":{"name":"Weight"}},"ServiceType":{"type":"string","maxLength":36,"description":"Технологія доставки (DoorsDoors, DoorsWarehouse, WarehouseWarehouse, WarehouseDoors)","xml":{"name":"ServiceType"}},"SeatsAmount":{"type":"string","maxLength":36,"description":"Кількість місць відправлення, ціле число","xml":{"name":"SeatsAmount"}},"Description":{"type":"string","maxLength":36,"description":"Текстове поле, вводиться для додаткового опису відправлення","xml":{"name":"Description"}},"Cost":{"type":"string","maxLength":36,"description":"Оціночна вартість, ціле число (якщо не зазначити вартість, то АРІ автоматично проставить мінімальну оціночну вартість 300.01)","xml":{"name":"Cost"}},"CitySender":{"type":"string","maxLength":36,"description":"Ідентифікатор міста відправника","xml":{"name":"CitySender"}},"Sender":{"type":"string","maxLength":36,"description":"Ідентифікатор відправника","xml":{"name":"Sender"}},"SenderAddress":{"type":"string","maxLength":36,"description":"Ідентифікатор адреси відправника (REF). Дані з відповіді методу «Список адрес контрагента»","xml":{"name":"SenderAddress"}},"ContactSender":{"type":"string","maxLength":36,"description":"Ідентифікатор контактної особи відправника (REF). Дані з відповіді методу «Список контактних осіб контрагента»","xml":{"name":"ContactSender"}},"SendersPhone":{"type":"string","maxLength":36,"description":"Телефон відправника у форматі: +380660000000, 380660000000, 0660000001\n","xml":{"name":"SendersPhone"}},"CityRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор міста отримувача","xml":{"name":"CityRecipient"}},"Recipient":{"type":"string","maxLength":36,"description":"Ідентифікатор отримувача","xml":{"name":"Recipient"}},"RecipientAddress":{"type":"string","maxLength":36,"description":"Ідентифікатор адреси отримувача","xml":{"name":"RecipientAddress"}},"ContactRecipient":{"type":"string","maxLength":36,"description":"Ідентифікатор контактної особи","xml":{"name":"ContactRecipient"}},"RecipientsPhone":{"type":"string","maxLength":36,"description":"Телефон отримувача у форматі: +380660000000, 380660000000, 0660000001\n","xml":{"name":"RecipientsPhone"}},"NewAddress":{"type":"string","maxLength":36,"description":"Використання нового адресного довідника (1 — так, 0 — ні)","xml":{"name":"NewAddress"}},"OptionsSeat":{"type":"array","description":"Параметр вантажу для кожного місця відправлення","xml":{"name":"OptionsSeat","wrapped":true},"items":{"type":"object","xml":{"name":"item"}}},"BackwardDeliveryData":{"type":"array","description":"Зворотна доставка підтипів документів","xml":{"name":"BackwardDeliveryData","wrapped":true},"items":{"type":"object","xml":{"name":"item"}}}}}}}}}},"responses":{"200":{"description":"Експрес-накладну створено","content":{"application/xml":{"schema":{"type":"object","xml":{"name":"file"},"properties":{"success":{"type":"boolean","description":"Вказує, чи було запит успішно оброблено.","xml":{"name":"success"}},"data":{"type":"array","description":"Список створених експрес-накладних.","xml":{"name":"data","wrapped":true},"items":{"type":"object","xml":{"name":"item"},"properties":{"Ref":{"type":"string","description":"Ідентифікатор експрес-накладної","maxLength":36,"xml":{"name":"Ref"}},"CostOnSite":{"type":"string","description":"Вартість доставки","maxLength":36,"xml":{"name":"CostOnSite"}},"EstimatedDeliveryDate":{"type":"string","description":"Прогнозована дата доставки","maxLength":36,"xml":{"name":"EstimatedDeliveryDate"}},"IntDocNumber":{"type":"string","description":"Номер експрес-накладної","maxLength":36,"xml":{"name":"IntDocNumber"}},"TypeDocument":{"type":"string","description":"Тип експрес-накладної","maxLength":36,"xml":{"name":"TypeDocument"}}}}}}}}}}}}}}}
````
---
# 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/page-3.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.