# API сервісу ETTN v3

# Перелік методів АРІ сервісу e-TTН

<p class="callout info">Для роботи з методами користувач повинен бути [авторизованим](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi).</p>

##### **Загальні методи**

<table border="1" id="bkmrk-%D0%97%D0%B0%D0%B2%D0%B0%D0%BD%D1%82%D0%B0%D0%B6%D0%B5%D0%BD%D0%BD%D1%8F-%D1%82%D1%96%D0%BB%D0%B0-%D0%B4%D0%BE" style="border-collapse: collapse; width: 100%; height: 331.922px;"><colgroup><col style="width: 57.9216%;"></col><col style="width: 42.0784%;"></col></colgroup><tbody><tr style="height: 35.3906px;"><td style="height: 35.3906px; background-color: rgb(236, 240, 241);">Завантаження тіла документа у форматі JSON/XML/ECMR/PDF/ZIP

</td><td style="height: 35.3906px; background-color: rgb(236, 240, 241);">[GET /api/eds/doc/ettn/body](https://wiki-v2.edin.ua/books/robota-z-api/page/zavantazennia-tila-dokumenta-u-formati-jsonxmlecmrpdfzip-get-apiedsdocettnbody)</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Підписання даних сервісу (збереження підпису)

</td><td style="height: 35.3906px;">[POST /api/eds/doc/ettn/sign](https://wiki-v2.edin.ua/books/robota-z-api/page/pidpisannia-danix-servisu-zberezennia-pidpisu-post-apiedsdocettnsign)</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px; background-color: rgb(236, 240, 241);">Отримання всіх квитанцій вказаного документа

</td><td style="height: 35.3906px; background-color: rgb(236, 240, 241);">[GET /api/eds/doc/tickets](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-vsix-kvitancii-vkazanogo-dokumenta-get-apiedsdoctickets)</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Отримання інформації (мета-даних) про документ

</td><td style="height: 35.3906px;">[GET /api/eds/doc](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-informaciyi-meta-danix-pro-dokument-get-apiedsdoc)</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px; background-color: rgb(236, 240, 241);">Отримання інформації про підписантів е-ТТН та Актів v3 (family=7)

</td><td style="height: 35.3906px; background-color: rgb(236, 240, 241);">[GET /api/eds/doc/ettn/sign/info](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-informaciyi-pro-pidpisantiv-e-ttn-ta-aktiv-v3-family7-get-apiedsdocettnsigninfo)</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Видалити документи-чернетки

</td><td style="height: 35.3906px;">[PATCH /api/eds/docs](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-dokumenti-cernetki-patch-apiedsdocs-SLO)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px; background-color: rgb(236, 240, 241);">Пошук транспортного засобу у власному довіднику транспортних засобів

</td><td style="height: 46.5938px; background-color: rgb(236, 240, 241);">[GET /api/oas/v2/transport](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-transportnogo-zasobu-u-vlasnomu-dovidniku-transportnix-zasobiv-get-apioasv2transport)</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Створення нового транспортного засобу в довіднику

</td><td style="height: 35.3906px;">[POST /api/oas/v2/transport](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorennia-novogo-transportnogo-zasobu-v-dovidniku-post-apioasv2transport)</td></tr><tr style="height: 37.5938px;"><td style="height: 37.5938px; background-color: rgb(236, 240, 241);">Видалення чернетки транзакції

</td><td style="height: 37.5938px; background-color: rgb(236, 240, 241);">[DELETE /api/eds/doc/ettn/draft\_ticket](https://wiki-v2.edin.ua/books/robota-z-api/page/vidalennia-cernetki-tranzakciyi-delete-apiedsdocettndraft-ticket)</td></tr></tbody></table>

##### **Робота з e-TTН**

<table border="1" id="bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F%2F%D1%80%D0%B5%D0%B4%D0%B0%D0%B3%D1%83%D0%B2%D0%B0%D0%BD%D0%BD" style="border-collapse: collapse; width: 100%; height: 367.047px;"><colgroup><col style="width: 57.9167%;"></col><col style="width: 42.2025%;"></col></colgroup><tbody><tr style="height: 36.5px;"><td style="height: 36.5px; background-color: rgb(236, 240, 241);">Створення/редагування чернетки e-TTH

</td><td style="height: 36.5px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/ttn](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-e-tth)</td></tr><tr style="height: 35.4375px;"><td style="height: 35.4375px;">Надсилання e-TTH з Чернеток

</td><td style="height: 35.4375px;">[PATCH /api/eds/doc/ettn/ttn/send](https://wiki-v2.edin.ua/books/robota-z-api/page/nadsilannia-e-tth-z-cernetok-patch-apiedsdocettnttnsend)</td></tr><tr style="height: 39.5938px;"><td style="height: 39.5938px; background-color: rgb(236, 240, 241);">Створення/редагування нової транзакції (чернетки) до e-TTH документа

</td><td style="height: 39.5938px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/ttn/transaction](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-novoyi-tranzakciyi-cernetki-do-e-tth-dokumenta-post-apiedsdocettnttntransaction)</td></tr><tr style="height: 36.5px;"><td style="height: 36.5px;">Надсилання нової транзакції до e-TTH документа

</td><td style="height: 36.5px;">[PUT /api/eds/doc/ettn/ttn/transaction](https://wiki-v2.edin.ua/books/robota-z-api/page/nadsilannia-novoyi-tranzakciyi-do-e-tth-dokumenta-put-apiedsdocettnttntransaction)</td></tr><tr style="height: 36.4375px;"><td style="height: 36.4375px; background-color: rgb(236, 240, 241);">Відхилення e-TTH

</td><td style="height: 36.4375px; background-color: rgb(236, 240, 241);">[PUT /api/eds/doc/ettn/ttn/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/vidxilennia-e-tth-put-apiedsdocettnttnreject)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Додавання вкладення (pdf) до e-TTH

</td><td style="height: 29.7969px;">[POST /api/eds/doc/ettn/ttn/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/dodavannia-vkladennia-pdf-do-e-tth-post-apiedsdocettnttnattachment)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Отримати (завантажити) файл-вкладення до e-TTH

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[GET /api/eds/doc/ettn/ttn/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-zavantaziti-fail-vkladennia-do-e-tth-get-apiedsdocettnttnattachment)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Надіслати вкладення на повторну реєстрацію у разі виникнення помилки

</td><td style="height: 46.5938px;">[PATCH /api/eds/doc/ettn/ttn/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/nadislati-vkladennia-na-povtornu-rejestraciiu-u-razi-viniknennia-pomilki-patch-apiedsdocettnttnattachment)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Видалити файл-вкладення з документа

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[DELETE /api/eds/doc/ettn/ttn/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-fail-vkladennia-z-dokumenta-delete-apiedsdocettnttnattachment)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Створення та надсилання e-TTH (без створення чернетки)

</td><td style="height: 46.5938px;">[POST /api/eds/doc/ettn/ttn/create\_and\_send](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorennia-ta-nadsilannia-e-tth-bez-stvorennia-cernetki-post-apiedsdocettnttncreate-and-send)</td></tr></tbody></table>

##### **Робота з актами до e-TTH**

<table border="1" id="bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F%2F%D1%80%D0%B5%D0%B4%D0%B0%D0%B3%D1%83%D0%B2%D0%B0%D0%BD%D0%BD-3" style="border-collapse: collapse; width: 100%; height: 514.141px;"><colgroup><col style="width: 58.1639%;"></col><col style="width: 41.8361%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Створення/редагування чернетки «Акт коригування»

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/adjustment](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-koriguvannia-post-apiedsdocettnadjustment)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Створення/редагування чернетки «Акт про заміну пункту призначення вантажу»

</td><td style="height: 46.5938px;">[POST /api/eds/doc/ettn/consignee\_change](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-pro-zaminu-punktu-priznacennia-vantazu-post-apiedsdocettnconsignee-change)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Створення/редагування чернетки «Акт розбіжностей про вантаж»

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/disagreement](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-rozbiznostei-pro-vantaz-post-apiedsdocettndisagreement)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Створення/редагування чернетки «Акт про відмову вантажити до e-TTN»

</td><td style="height: 46.5938px;">[POST /api/eds/doc/ettn/load\_reject](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-pro-vidmovu-vantaziti-do-e-ttn-post-apiedsdocettnload-reject)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Створення/редагування чернетки «Акт перевантаження до e-TTN»

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/reload](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-perevantazennia-do-e-ttn-post-apiedsdocettnreload)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Створення/редагування чернетки «Акт перепломбування до e-TTN»

</td><td style="height: 29.7969px;">[POST /api/eds/doc/ettn/resealing](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-pereplombuvannia-do-e-ttn-post-apiedsdocettnresealing)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Створення/редагування чернетки «Акт примусового завершення e-TTN»

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/stop](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-primusovogo-zaversennia-e-ttn-post-apiedsdocettnstop)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Створення/редагування чернетки «Акт розвантаження на проміжному складі до e-TTN»

</td><td style="height: 46.5938px;">[POST /api/eds/doc/ettn/storage\_delivery](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-rozvantazennia-na-promiznomu-skladi-do-e-ttn-post-apiedsdocettnstorage-delivery)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px; background-color: rgb(236, 240, 241);">Створення/редагування чернетки «Акт завантаження на проміжному складі до e-TTN»

</td><td style="height: 46.5938px; background-color: rgb(236, 240, 241);">[POST /api/eds/doc/ettn/storage\_pickup](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-cernetki-akt-zavantazennia-na-promiznomu-skladi-do-e-ttn-post-apiedsdocettnstorage-pickup)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Створення/редагування нової транзакції (чернетки) до Актів сервісу

</td><td style="height: 29.7969px;">[POST /api/eds/doc/ettn/act/transaction](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorenniaredaguvannia-novoyi-tranzakciyi-cernetki-do-aktiv-servisu-post-apiedsdocettnacttransaction)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Надсилання нової транзакції до Актів сервісу

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[PUT /api/eds/doc/ettn/act/transaction](https://wiki-v2.edin.ua/books/robota-z-api/page/nadsilannia-novoyi-tranzakciyi-do-aktiv-servisu-put-apiedsdocettnacttransaction)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Відхилення Актів сервісу

</td><td style="height: 29.7969px;">[PUT /api/eds/doc/ettn/act/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/vidxilennia-aktiv-servisu-put-apiedsdocettnactreject)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Надсилання Актів з Чернеток

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[PATCH /api/eds/doc/ettn/act/send](https://wiki-v2.edin.ua/books/robota-z-api/page/nadsilannia-aktiv-z-cernetok-patch-apiedsdocettnactsend)</td></tr></tbody></table>

##### **Підписки на події**

<table border="1" id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%B4%D0%B0%D0%BD%D0%B8%D1%85-%D0%BF%D1%80%D0%BE-" style="border-collapse: collapse; width: 100%; height: 165.781px;"><colgroup><col style="width: 58.4022%;"></col><col style="width: 41.5978%;"></col></colgroup><tbody><tr style="height: 46.5938px;"><td style="height: 46.5938px; background-color: rgb(236, 240, 241);">Отримання даних про підписки на події / Отримання даних про підпис особи

</td><td style="height: 46.5938px; background-color: rgb(236, 240, 241);">[GET /api/mintrans/subscribe](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-danix-pro-pidpiski-na-podiyi-otrimannia-danix-pro-pidpis-osobi-get-apimintranssubscribe)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Створення підписки про події (отримання документів)

</td><td style="height: 29.7969px;">[POST /api/mintrans/subscribe](https://wiki-v2.edin.ua/books/robota-z-api/page/stvorennia-pidpiski-pro-podiyi-otrimannia-dokumentiv-post-apimintranssubscribe)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Видалення підписки на події (отримання документів)

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[DELETE /api/mintrans/subscribe](https://wiki-v2.edin.ua/books/robota-z-api/page/vidalennia-pidpiski-na-podiyi-otrimannia-dokumentiv-delete-apimintranssubscribe)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Отримання списку подій з ЦБД

</td><td style="height: 29.7969px;">[GET /api/mintrans/events](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-spisku-podii-z-cbd-get-apimintransevents)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">Отримання документа з ЦБД

</td><td style="height: 29.7969px; background-color: rgb(236, 240, 241);">[GET /api/mintrans/doc](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-dokumenta-z-cbd-get-apimintransdoc)</td></tr></tbody></table>

##### **Робота зі «Зведеною e-ТТН»**

<table border="1" id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D0%BE%D0%B2%27%D1%8F%D0%B7%D0%B0%D0%BD%D0%B8%D1%85" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 58.5216%;"></col><col style="width: 41.4784%;"></col></colgroup><tbody><tr><td style="background-color: rgb(236, 240, 241);">Отримання пов'язаних документів «Зведеної e-ТТН»

</td><td style="background-color: rgb(236, 240, 241);">[GET /api/eds/doc/ettn/ttn/link\_docs](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-poviazanix-dokumentiv-zvedenoyi-ttn-get-apiedsdocettnttnlink-docs)</td></tr><tr><td>Прив'язка ТТН до «Зведеної e-ТТН»

</td><td>[POST /api/eds/doc/ettn/ttn/link\_docs](https://wiki-v2.edin.ua/books/robota-z-api/page/priviazka-ttn-do-zvedenoyi-ttn-post-apiedsdocettnttnlink-docs)</td></tr><tr><td style="background-color: rgb(236, 240, 241);">Видалення прив’язки e-ТТН до «Зведеної e-ТТН»

</td><td style="background-color: rgb(236, 240, 241);">[DELETE /api/eds/doc/ettn/ttn/link\_docs](https://wiki-v2.edin.ua/books/robota-z-api/page/vidalennia-priviazki-ttn-do-zvedenoyi-ttn-delete-apiedsdocettnttnlink-docs)</td></tr></tbody></table>

# Алгоритми обміну документами (API)

![Main_API_002.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-12/scaled-1680-/hTyJa4QA3ELYYIX8-main-api-002.png)

- [Пряма схема документообігу е-ТТН v3](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/ETTNv3_API_work.html)
- [Додаткові транзакції та зміни до е-ТТН v3 при формуванні актів](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Additional_transactions.html)
- [Алгоритм «Заявка на транспортування»-&gt;»Підтвердження транспортування» (TRANSPORTATIONORDER)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/Proposalv3_API_work.html)
- [Алгоритм «Акта розбіжностей про вантаж» (DisagreementAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/DisagreementActv3_API_work.html)
    
    [Алгоритм «Акта про відмову вантажити» (LoadRejectAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/LoadRejectActv3_API_work.html)
    
    [Алгоритм «Акт примусового завершення е-ТТН» (StopAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/StopActv3_API_work.html)
    
    [Алгоритм «Акт перепломбування» (ResealingAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/ResealingActv3_API_work.html)
    
    [Алгоритм «Акт розвантаження на проміжному складі» (StorageDeliveryAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/StorageDeliveryActv3_API_work.html)
    
    [Алгоритм «Акт завантаження на проміжному складі» (StoragePickUpAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/StoragePickUpActv3_API_work.html)
    
    [Алгоритм «Акт перевантаження» (ReloadAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/ReloadActv3_API_work.html)
    
    [Алгоритми «Акт про заміну пункту призначення вантажу» (ConsigneeChangeAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/ConsigneeChangeActv3_API_work.html)
    
    [Алгоритм «Акт коригування» (AdjustmentAct)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/AdjustmentActv3_API_work.html)
- [Алгоритм «Рахунок (Логістика)» (COMDOC\_040)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/COMDOC_040_API_work.html)
    
    [Алгоритм «Акт наданих послуг (Логістика)» (COMDOC\_037)](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Work_with_API/COMDOC_037_API_work.html)

# Алгоритм «Заявка на транспортування»->»Підтвердження транспортування» (TRANSPORTATIONORDER)



# Алгоритм «Акт коригування» (AdjustmentAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col></col><col></col><col></col><col></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт коригування**</td></tr><tr><td>  
</td><td class="align-center">Замовник OB, Вантажовідправник CZ, Перевізник CA або Водій DR, Вантажоодержувач CN</td><td>  
</td><td class="align-center">Ініціатор акта (Замовник OB, Вантажовідправник CZ, Перевізник CA або Водій DR, Вантажоодержувач CN)</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 100.714%;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 33.2587%;"></col><col style="width: 66.7413%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td></tr><tr><td colspan="2">**Акт коригування**</td></tr><tr><td class="align-center">-</td><td class="align-left">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт коригування"
    - `AssociatedReferencedDocument.ID` = номер акту коригування
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту коригування
2. В тілі ТТН можливі внесення змін в такі блоки: 
    - ExchangedDocument 
        - ExchangedDocument.IssueLogisticsLocation.Name + ExchangedDocument.IssueLogisticsLocation.Description  
            SpecifiedSupplyChainConsignment
        - DeliveryInstructions.Description  
            ConsignorTradeParty
        - ConsignorTradeParty. ID (schemeAgencyID="ЄДРПОУ")
        - ConsignorTradeParty.Name
        - ConsignorTradeParty.RoleCode
        - ConsignorTradeParty.PostalTradeAddress
        - ConsignorTradeParty.DefinedTradeContact
    - ConsigneeTradeParty 
        - ConsigneeTradeParty. ID (schemeAgencyID="ЄДРПОУ")
        - ConsigneeTradeParty.Name
        - ConsigneeTradeParty.RoleCode
        - ConsigneeTradeParty.PostalTradeAddress
        - ConsigneeTradeParty.DefinedTradeContact
    - CarrierTradeParty 
        - CarrierTradeParty. ID (schemeAgencyID="ЄДРПОУ")
        - CarrierTradeParty.Name
        - CarrierTradeParty.RoleCode
        - CarrierTradeParty.PostalTradeAddress
        - CarrierTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - FW) 
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.PostalTradeAddress
        - NotifiedTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - OB) 
        - NotifiedTradeParty.ID (schemeAgencyID="ЄДРПОУ")
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.RoleCode
        - NotifiedTradeParty.PostalTradeAddress
        - NotifiedTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - WD) 
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.PostalTradeAddress
        - NotifiedTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - COP) 
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.DefinedTradeContact.PersonName
    - CarrierAcceptanceLogisticsLocation 
        - CarrierAcceptanceLogisticsLocation.Name + CarrierAcceptanceLogisticsLocation.Description
        - "CarrierAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LatitudeMeasure +
        - CarrierAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LongitudeMeasure"
    - ConsigneeReceiptLogisticsLocation 
        - ConsigneeReceiptLogisticsLocation.Name + ConsigneeReceiptLogisticsLocation.Description
        - ConsigneeAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LatitudeMeasure +
    - ConsigneeAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LongitudeMeasure
    - DeliveryTransportEvent 
        - DeliveryTransportEvent.ActualOccurrenceDateTime
        - DeliveryTransportEvent.ScheduledOccurrenceDateTime
        - DeliveryTransportEvent.ApplicableNote (з кодом DOWNTIME)
    - PickUpTransportEvent 
        - PickUpTransportEvent.ActualOccurrenceDateTime
        - PickUpTransportEvent.ScheduledOccurrenceDateTime
        - PickUpTransportEvent.ApplicableNote (з кодом DOWNTIME)
    - IncludedSupplyChainConsignmentItem 
        - IncludedSupplyChainConsignmentItem.GlobalID (schemeAgencyID="УКТЗЕД")
        - IncludedSupplyChainConsignmentItem.NatureIdentificationTransportCargo. Identification
        - IncludedSupplyChainConsignmentItem.ApplicableTransportDangerousGoods.UNDGIdentificationCode
        - IncludedSupplyChainConsignmentItem.AssociatedReferencedDocument.ID + IncludedSupplyChainConsignmentItem.AssociatedReferencedDocument.Remarks
        - IncludedSupplyChainConsignmentItem.TransportLogisticsPackage.PhysicalLogisticsShippingMarks.Marking
        - IncludedSupplyChainConsignmentItem.TransportLogisticsPackage.PhysicalLogisticsShippingMarks.BarcodeLogisticsLabel.ID
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом VENDOR\_CODE)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом URL)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом BASE\_UOM)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом BUYER\_CODE)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом RETURN\_TARE)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом RTP\_QUANTITY)
        - IncludedNote (transportation\_max\_temperature, logger\_return, logistic\_unit\_number\_with\_logger, gps\_number, logger\_number, comment, reserve\_number, vehicle\_length, vehicle\_width, vehicle\_height, gross\_vehicle\_weight\_with\_cargo, pallets\_with\_temperature\_control\_quantity, pallets\_without\_temperature\_control\_quantity)
3. UaSignatureStorage - підпис ініціатора (Замовника OB, Вантажовідправника CZ, Перевізника CA або Водія DR, Вантажоодержувача CN)

</td></tr></tbody></table>

# Алгоритм «Акт розвантаження на проміжному складі» (StorageDeliveryAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB" style="width: 100%;"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col style="width: 23.4803%;"></col><col style="width: 26.9368%;"></col><col style="width: 18.949%;"></col><col style="width: 30.5146%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт розвантаження на проміжному складі**</td></tr><tr><td class="align-center">+</td><td class="align-center">Перевізник CA (поточний) або Водій DR (поточний)</td><td class="align-center">+</td><td class="align-center">Проміжний склад WD</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 112.5%;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 42.5531%;"></col><col style="width: 57.4469%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td></tr><tr><td colspan="2">**Акт розвантаження на проміжному складі**</td></tr><tr><td class="align-left">1. В тіло ТТН додається блок `MainCarriageLogisticsTransportMovement`, проміжний склад зазначається з роллю `WD`
2. UaSignatureStorage - підпис Перевізника CA або Водія DR

</td><td class="align-left"><span style="text-decoration: underline;">Позитивне</span> завершення ЖЦ Акту:

1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт розвантаження на проміжному складі"
    - `AssociatedReferencedDocument.ID` = номер акту розвантаження
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту розвантаження
2. В тілі ТТН поточний Перевізник та поточний Водій переносяться з `CarrierTradeParty` з роллю `CA` в `NotifiedTradeParty` з роллю `CJ`
3. UaSignatureStorage - підпис Проміжного складу WD

<span style="text-decoration: underline;">Негативне</span> завершення ЖЦ Акту (відхилено Перевізником або Проміжним складом):

1. В тілі ТТН прибирається блок `MainCarriageLogisticsTransportMovement`

</td></tr></tbody></table>

# Алгоритм «Акт перепломбування» (ResealingAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 182.578px;"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col style="width: 23.4803%;"></col><col style="width: 25.2682%;"></col><col style="width: 21.9309%;"></col><col style="width: 29.4398%;"></col></colgroup><tbody><tr style="height: 63.3906px;"><td class="align-center" style="height: 63.3906px;">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center" style="height: 63.3906px;">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center" style="height: 63.3906px;">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center" style="height: 63.3906px;">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт перепломбування**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td class="align-center" style="height: 29.7969px;">Замовник OB</td><td class="align-center" style="height: 29.7969px;">+</td><td class="align-center" style="height: 29.7969px;">Перевізник CA або Водій DR / Замовник ОВ</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 316.188px;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 44.6961%;"></col><col style="width: 55.3039%;"></col></colgroup><tbody><tr style="height: 46.5938px;"><td class="align-center" style="height: 46.5938px;">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center" style="height: 46.5938px;">**Реєструється після завершення ЖЦ Акту**</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт перепломбування**</td></tr><tr style="height: 239.797px;"><td class="align-center" style="height: 239.797px;">-</td><td class="align-left" style="height: 239.797px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт перепломбування"
    - `AssociatedReferencedDocument.ID` = номер акту перепломбування
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту перепломбування
2. В тілі ТТН замінюються дані пломби відповідного транспортного засобу: 
    - UtilizedLogisticsTransportEquipment.AffixedLogisticsSeal.ID
3. UaSignatureStorage - підпис Перевізника CA або Водія DR / Замовника OB

</td></tr></tbody></table>

# Алгоритм «Акта розбіжностей про вантаж» (DisagreementAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB" style="width: 103.333%;"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col style="width: 26.4601%;"></col><col style="width: 22.4076%;"></col><col style="width: 18.7128%;"></col><col style="width: 32.3004%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт розбіжностей про вантаж**</td></tr><tr><td>  
</td><td class="align-center">Вантажовідправник CZ</td><td>  
</td><td class="align-center">Вантажоодержувач CN</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 100%; height: 210.407px;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 33.2499%;"></col><col style="width: 66.7501%;"></col></colgroup><tbody><tr style="height: 46.5938px;"><td class="align-center" style="height: 46.5938px;">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center" style="height: 46.5938px;">**Реєструється після завершення ЖЦ Акту**</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт розбіжностей про вантаж**</td></tr><tr style="height: 134.016px;"><td style="height: 134.016px;">-

</td><td style="height: 134.016px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = Акт розбіжностей про вантаж
    - `AssociatedReferencedDocument.ID` = номер акту розбіжностей
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту розбіжностей
2. UaSignatureStorage - підпис Вантажоодержувача CN

</td></tr></tbody></table>

# Додаткові транзакції та зміни до е-ТТН v3 при формуванні актів

<table border="1" class="align-center" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 415.547px;"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col style="width: 18.7128%;"></col><col style="width: 16.8057%;"></col><col style="width: 26.8158%;"></col><col style="width: 13.4703%;"></col><col style="width: 24.3147%;"></col></colgroup><tbody><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Тип документа**</td><td style="height: 80.1875px;">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td style="height: 80.1875px;">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td style="height: 80.1875px;">**Реєструється після завершення ЖЦ Акту**</td><td style="height: 80.1875px;">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Акт перевантаження</td><td style="height: 29.7969px;">+</td><td style="height: 29.7969px;">Перевізник CA (поточний) або Водій DR (поточний)</td><td style="height: 29.7969px;">+</td><td style="height: 29.7969px;">Перевізник CA (новий) або Водій DR (новий)</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">Акт розвантаження на проміжному складі</td><td style="height: 63.3906px;">+</td><td style="height: 63.3906px;">Перевізник CA (поточний) або Водій DR (поточний)</td><td style="height: 63.3906px;">+</td><td style="height: 63.3906px;">Проміжний склад WD</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Акт про відмову вантажити</td><td style="height: 46.5938px;">  
</td><td style="height: 46.5938px;">Вантажовідправник CZ</td><td style="height: 46.5938px;">  
</td><td style="height: 46.5938px;">Не потребує реєстрації транзакцій до ТТН</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">Акт завантаження на проміжному складі</td><td style="height: 46.5938px;">+</td><td style="height: 46.5938px;">Проміжний склад WD</td><td style="height: 46.5938px;">+</td><td style="height: 46.5938px;">Перевізник CA (новий) або Водій DR (новий)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Акт перепломбування</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Замовник OB</td><td style="height: 29.7969px;">+</td><td style="height: 29.7969px;">Перевізник CA або Водій DR / Замовник ОВ</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Акт про заміну пункту призначення вантажу</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Вантажоодержувач CN, Вантажовідправник CZ, Замовник OB, Перевізник CA або Водій DR</td><td style="height: 29.7969px;">+</td><td style="height: 29.7969px;">Замовник ОВ</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Акт розбіжностей про вантаж</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Вантажоодержувач CN</td><td style="height: 29.7969px;">+</td><td style="height: 29.7969px;">Вантажоодержувач CN</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Акт коригування</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Замовник OB, Вантажовідправник CZ, Перевізник CA або Водій DR, Вантажоодержувач CN</td><td style="height: 29.7969px;">+</td><td style="height: 29.7969px;">Ініціатор акта (Замовник OB, Вантажовідправник CZ, Перевізник CA або Водій DR, Вантажоодержувач CN)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Акт примусового завершення</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Замовник OB</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Не потребує реєстрації транзакцій до ТТН</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 4041.47px;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 39.5709%;"></col><col style="width: 60.4291%;"></col></colgroup><tbody><tr style="height: 46.5938px;"><td class="align-center" style="height: 46.5938px;">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center" style="height: 46.5938px;">**Реєструється після завершення ЖЦ Акту**</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт перевантаження**</td></tr><tr style="height: 452px;"><td style="height: 452px;">У разі заміни Перевізника та/або Водія:

1. В тіло ТТН додається поточний/новий Перевізник та поточний/новий Водій в `NotifiedTradeParty` з роллю `CH`
2. UaSignatureStorage - підпис поточного Перевізника CA або поточного Водія DR

</td><td style="height: 452px;"><span style="text-decoration: underline;"><span style="background-color: rgb(255, 255, 255);">Позитивне</span></span> завершення ЖЦ Акту:

1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт перевантаження"
    - `AssociatedReferencedDocument.ID` = номер акту перевантаження
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акта перевантаження
2. В тілі ТТН попередній Перевізник та попередній Водій переносяться з `CarrierTradeParty` з роллю `CA` в `NotifiedTradeParty` з роллю `CJ`
3. В тілі ТТН новий Перевізник та новий Водій переносяться з `NotifiedTradeParty` з роллю `CH` в `CarrierTradeParty` з роллю `CA`
4. В тілі ТТН заміються старі дані по всім транспортним засобам на нові дані по всім транспортним засобам
5. В тіло ТТН додається новий Водій в `PickUpTransportEvent - CertifyingTradeParty` з роллю `DR` (в блоці будуть тільки унікальні водії за `ID`)
6. UaSignatureStorage - підпис нового Перевізника CA або нового Водія DR

<span style="text-decoration: underline;">Негативне</span> завершення ЖЦ Акту (відхилено Перевізником або Водієм):

1. В тілі ТТН новий Перевізник та новий Водій переносяться з `NotifiedTradeParty` з роллю `CH` в `NotifiedTradeParty` з роллю `CJ`

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт розвантаження на проміжному складі**  
</td></tr><tr style="height: 328.625px;"><td style="height: 328.625px;">1. В тіло ТТН додається блок `MainCarriageLogisticsTransportMovement`, проміжний склад зазначається з роллю `WD`
2. UaSignatureStorage - підпис Перевізника CA або Водія DR

</td><td style="height: 328.625px;"><span style="text-decoration: underline;">Позитивне</span> завершення ЖЦ Акту:

1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт розвантаження на проміжному складі"
    - `AssociatedReferencedDocument.ID` = номер акту розвантаження
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту розвантаження
2. В тілі ТТН поточний Перевізник та поточний Водій переносяться з `CarrierTradeParty` з роллю `CA` в `NotifiedTradeParty` з роллю `CJ`
3. UaSignatureStorage - підпис Проміжного складу WD

<span style="text-decoration: underline;">Негативне</span> завершення ЖЦ Акту (відхилено Перевізником або Проміжним складом):

1. В тілі ТТН прибирається блок `MainCarriageLogisticsTransportMovement`

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт завантаження на проміжному складі**  
</td></tr><tr style="height: 288.391px;"><td style="height: 288.391px;">1. В тіло ТТН додається новий Перевізник та новий Водій в `NotifiedTradeParty` з роллю `CH`
2. UaSignatureStorage - підпис Проміжного складу WD

</td><td style="height: 288.391px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт завантаження на проміжному складі"
    - `AssociatedReferencedDocument.ID` = номер акту завантаження
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту завантаження
2. В тілі ТТН новий Перевізник та новий Водій переносяться з `NotifiedTradeParty` з роллю `CH` в `CarrierTradeParty` з роллю `CA`
3. В тілі ТТН заміються старі дані по всім транспортним засобам на нові дані по всім транспортним засобам
4. В тіло ТТН додається новий Водій в `PickUpTransportEvent - CertifyingTradeParty` з роллю `DR` (в блоці будуть тільки унікальні водії за `ID`)
5. UaSignatureStorage - підпис Перевізника CA або Водія DR

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт перепломбування**  
</td></tr><tr style="height: 238px;"><td class="align-left" style="height: 238px;">-

</td><td style="height: 238px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт перепломбування"
    - `AssociatedReferencedDocument.ID` = номер акту перепломбування
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту перепломбування
2. В тілі ТТН замінюються дані пломби відповідного транспортного засобу: 
    - UtilizedLogisticsTransportEquipment.AffixedLogisticsSeal.ID
3. UaSignatureStorage - підпис Перевізника CA або Водія DR / Замовника OB

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт про заміну пункту призначення вантажу**

</td></tr><tr style="height: 305.188px;"><td style="height: 305.188px;">-

</td><td style="height: 305.188px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт про заміну пункту призначення вантажу"
    - `AssociatedReferencedDocument.ID` = номер акту про заміну пункту призначення вантажу
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту про заміну пункту призначення вантажу
2. В тілі ТТН попередній вантажоодержувач переноситься з `ConsigneeTradeParty` з роллю `CN` в `NotifiedTradeParty` з роллю `CJ`
3. В тілі ТТН новий вантажоодержувач та пункт розвантаження додаються у відповідні блоки: 
    - `ConsigneeTradeParty` з роллю `CN`
    - `ConsigneeReceiptLogisticsLocation` (замість старих даних пункту розвантаження)
4. UaSignatureStorage - підпис Замовника OB

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт розбіжностей про вантаж**

</td></tr><tr style="height: 170.812px;"><td style="height: 170.812px;">-

</td><td style="height: 170.812px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = Акт розбіжностей про вантаж
    - `AssociatedReferencedDocument.ID` = номер акту розбіжностей
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту розбіжностей
2. UaSignatureStorage - підпис Вантажоодержувача CN

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт коригування**

</td></tr><tr style="height: 1884.09px;"><td style="height: 1884.09px;">-

</td><td style="height: 1884.09px;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт коригування"
    - `AssociatedReferencedDocument.ID` = номер акту коригування
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту коригування
2. В тілі ТТН можливі внесення змін в такі блоки: 
    - ExchangedDocument 
        - ExchangedDocument.IssueLogisticsLocation.Name + ExchangedDocument.IssueLogisticsLocation.Description  
            SpecifiedSupplyChainConsignment
        - DeliveryInstructions.Description  
            ConsignorTradeParty
        - ConsignorTradeParty. ID (schemeAgencyID="ЄДРПОУ")
        - ConsignorTradeParty.Name
        - ConsignorTradeParty.RoleCode
        - ConsignorTradeParty.PostalTradeAddress
        - ConsignorTradeParty.DefinedTradeContact
    - ConsigneeTradeParty 
        - ConsigneeTradeParty. ID (schemeAgencyID="ЄДРПОУ")
        - ConsigneeTradeParty.Name
        - ConsigneeTradeParty.RoleCode
        - ConsigneeTradeParty.PostalTradeAddress
        - ConsigneeTradeParty.DefinedTradeContact
    - CarrierTradeParty 
        - CarrierTradeParty. ID (schemeAgencyID="ЄДРПОУ")
        - CarrierTradeParty.Name
        - CarrierTradeParty.RoleCode
        - CarrierTradeParty.PostalTradeAddress
        - CarrierTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - FW) 
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.PostalTradeAddress
        - NotifiedTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - OB) 
        - NotifiedTradeParty.ID (schemeAgencyID="ЄДРПОУ")
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.RoleCode
        - NotifiedTradeParty.PostalTradeAddress
        - NotifiedTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - WD) 
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.PostalTradeAddress
        - NotifiedTradeParty.DefinedTradeContact
    - NotifiedTradeParty (роль - COP) 
        - NotifiedTradeParty.Name
        - NotifiedTradeParty.DefinedTradeContact.PersonName
    - CarrierAcceptanceLogisticsLocation 
        - CarrierAcceptanceLogisticsLocation.Name + CarrierAcceptanceLogisticsLocation.Description
        - "CarrierAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LatitudeMeasure +
        - CarrierAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LongitudeMeasure"
    - ConsigneeReceiptLogisticsLocation 
        - ConsigneeReceiptLogisticsLocation.Name + ConsigneeReceiptLogisticsLocation.Description
        - ConsigneeAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LatitudeMeasure +
    - ConsigneeAcceptanceLogisticsLocation. PhysicalGeographicalCoordinate. LongitudeMeasure
    - DeliveryTransportEvent 
        - DeliveryTransportEvent.ActualOccurrenceDateTime
        - DeliveryTransportEvent.ScheduledOccurrenceDateTime
        - DeliveryTransportEvent.ApplicableNote (з кодом DOWNTIME)
    - PickUpTransportEvent 
        - PickUpTransportEvent.ActualOccurrenceDateTime
        - PickUpTransportEvent.ScheduledOccurrenceDateTime
        - PickUpTransportEvent.ApplicableNote (з кодом DOWNTIME)
    - IncludedSupplyChainConsignmentItem 
        - IncludedSupplyChainConsignmentItem.GlobalID (schemeAgencyID="УКТЗЕД")
        - IncludedSupplyChainConsignmentItem.NatureIdentificationTransportCargo. Identification
        - IncludedSupplyChainConsignmentItem.ApplicableTransportDangerousGoods.UNDGIdentificationCode
        - IncludedSupplyChainConsignmentItem.AssociatedReferencedDocument.ID + IncludedSupplyChainConsignmentItem.AssociatedReferencedDocument.Remarks
        - IncludedSupplyChainConsignmentItem.TransportLogisticsPackage.PhysicalLogisticsShippingMarks.Marking
        - IncludedSupplyChainConsignmentItem.TransportLogisticsPackage.PhysicalLogisticsShippingMarks.BarcodeLogisticsLabel.ID
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом VENDOR\_CODE)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом URL)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом BASE\_UOM)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом BUYER\_CODE)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом RETURN\_TARE)
        - IncludedSupplyChainConsignmentItem.ApplicableNote.Content (з кодом RTP\_QUANTITY)
        - IncludedNote (transportation\_max\_temperature, logger\_return, logistic\_unit\_number\_with\_logger, gps\_number, logger\_number, comment, reserve\_number, vehicle\_length, vehicle\_width, vehicle\_height, gross\_vehicle\_weight\_with\_cargo, pallets\_with\_temperature\_control\_quantity, pallets\_without\_temperature\_control\_quantity)
3. UaSignatureStorage - підпис ініціатора (Замовника OB, Вантажовідправника CZ, Перевізника CA або Водія DR, Вантажоодержувача CN)

</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт примусового завершення**

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-

</td><td style="height: 29.7969px;">-</td></tr><tr style="height: 29.7969px;"><td colspan="2" style="height: 29.7969px;">**Акт про відмову вантажити**

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-

</td><td style="height: 29.7969px;">-</td></tr></tbody></table>

# Опис помилок сервісу e-TTН

<p class="callout info">На сторінці наведено опис помилок сервісу «e-TTН». Опис загальних помилок для всіх сервісів EDIN доступний за [посиланням](https://wiki-v2.edin.ua/books/robota-z-api/page/zagalni-pomilki-pri-roboti-z-api-vsi-servisi-edin-SLH).</p>

##### **Опис помилок сервісу «e-ТТН»**

<table class="colwidths-given docutils align-default" id="bkmrk-%D0%9A%D0%BE%D0%B4-%D0%B2%D1%96%D0%B4%D0%BF%D0%BE%D0%B2%D1%96%D0%B4%D1%96-%D0%A2%D0%B5%D0%BA%D1%81%D1%82-" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 10.3695%;">**Код відповіді**

</td><td style="width: 23.6008%;">**Текст помилки**

</td><td style="width: 11.9177%;">**Індекс**

</td><td style="width: 54.112%;">**Опис**

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SETUP\_DOC\_NUMBER\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-1

</td><td style="width: 54.112%;">Setup document number \[%s\]

Заповніть номер документу \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SETUP\_DOC\_DATE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-2

</td><td style="width: 54.112%;">Setup document date \[%s\]

Заповніть дату документу \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SETUP\_ETTN\_REF\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-3

</td><td style="width: 54.112%;">Setup reference to ettn

Заповніть посилання на ТТН

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">EMPTY\_GLN\_FIELD\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-4

</td><td style="width: 54.112%;">\[%s\] is not filled in gln \[%s\]

\[%s\] не заповнено в gln \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">TRADE\_PARTY\_ID\_NOT\_FILED\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-5

</td><td style="width: 54.112%;">Field \[id.value\] in trade party for role \[%s\] is not filled

Поле \[id.value\] учасника ролі \[%s\] не заповнено

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">EMPTY\_FIELD\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-6

</td><td style="width: 54.112%;">field \[%s\] is not filled

Поле \[%s\] не заповнене

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_INITIATOR\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-7

</td><td style="width: 54.112%;">Unknown initiator

Невідомий ініціатор

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_CARRIER\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-8

</td><td style="width: 54.112%;">Unknown carrier

Невідомий перевізник

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_UNLOAD\_STORAGE

</td><td style="width: 11.9177%;">ERR\_TTN-9

</td><td style="width: 54.112%;">Unknown unload storage

Невідомий склад розвантаження

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_LOAD\_STORAGE

</td><td style="width: 11.9177%;">ERR\_TTN-10

</td><td style="width: 54.112%;">Unknown load storage

Невідомий склад навантаження

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_CONSIGNOR\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-11

</td><td style="width: 54.112%;">Unknown consignor

Невідомий вантажовідправник

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_CONSIGNEE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-12

</td><td style="width: 54.112%;">Unknown consignee

Невідомий вантажоотримувач

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_CUSTOMER\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-13

</td><td style="width: 54.112%;">Unknown customer

Невідомий замовний

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_NEW\_CONSIGNEE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-14

</td><td style="width: 54.112%;">Unknown new consignee

Невідомий новий вантажоотримувач

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_NEW\_CARRIER\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-15

</td><td style="width: 54.112%;">Unknown new carrier

Невідомий новий перевізник

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_DRIVER\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-16

</td><td style="width: 54.112%;">Unknown driver

Невідомий водій

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_NEW\_DRIVER\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-17

</td><td style="width: 54.112%;">Unknown new driver

Невідомий новий водій

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNKNOWN\_INITIATOR\_GLN\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-18

</td><td style="width: 54.112%;">Unknown initiator gln \[%s\]

Невідомий ініціатор gln \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DETERMINE\_GLN\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-19

</td><td style="width: 54.112%;">Failed to determine gln for trade party \[%s\]

Не вдалося визначити gln для учасника \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DETERMINE\_DRIVER\_GLN\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-20

</td><td style="width: 54.112%;">Failed to determine gln for driver \[%s\]

Не вдалося визначити gln для водія \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DETERMINE\_TRADE\_PARTY\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-21

</td><td style="width: 54.112%;">Failed to determine trading party for gln \[%s\]

Не вдалося визначити учасника для gln \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">GLN\_TRADEPARTY\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-22

</td><td style="width: 54.112%;">Unknown gln \[%s\] for tradeParty with role: \[%s\], and name \[%s\]

Невідомий gln \[%s\] для учасника з роллю: \[%s\] і назвою \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">IS\_NOT\_DRIVER\_GLN\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-23

</td><td style="width: 54.112%;">gln \[%s\] is not driver gln

gln \[%s\] не є gln-ом водія

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INCORRECT\_DRIVER\_TIN

</td><td style="width: 11.9177%;">ERR\_TTN-24

</td><td style="width: 54.112%;">Incorrect driver TIN in field \[taxRegistration.id\], expected \[%s\]

Неправильний ІПН водія в полі \[taxRegistration.id\], очікується \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">EDRPOU\_MISMATCH

</td><td style="width: 11.9177%;">ERR\_TTN-25

</td><td style="width: 54.112%;">Edrpou \[%s\] in gln \[%s\] and document \[%s\] are different

ЄДРПОУ \[%s\] в gln \[%s\] та документі \[%s\] відрізняються

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">TIN\_MISMATCH

</td><td style="width: 11.9177%;">ERR\_TTN-26

</td><td style="width: 54.112%;">TIN \[%s\] in gln \[%s\] and document \[%s\] are different

ІПН \[%s\] в gln \[%s\] та документі \[%s\] відрізняються

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">PARENT\_ETTN\_NOT\_FOUND\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-27

</td><td style="width: 54.112%;">Parent ettn not found

Документ підстава (ТТН) не знайдено

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">PARENT\_STORAGE\_DELIVERY\_DOC\_FOUND\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-28

</td><td style="width: 54.112%;">Parent storage delivery doc not found

Документ підстава (акт розвантаження на проміжному складі) не знайдено

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">PARENT\_ETTN\_STATUS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-29

</td><td style="width: 54.112%;">Parent TTN has incorrect status

Документ підстава (ТТН) має некоректний статус

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ETTN\_ONSTORAGE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-30

</td><td style="width: 54.112%;">TTN status «ONSTORAGE» can be changed automatically only after the completion of the life cycle of the storage pick up act or the stop TTN act

Статус ТТН «ONSTORAGE» може бути змінено автоматично лише після завершення життєвого циклу акта завантаження на складі або акту зупинки ТТН

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ACT\_IN\_PROCESS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-31

</td><td style="width: 54.112%;">Work with TTN is temporarily unavailable. Due to the unfinished process of working with the act \[%s\] to this TTN. Wait for the completion of work on it.

Робота з ТТН тимчасово недоступна. У зв’язку з незавершеним процесом роботи з актом \[%s\] до цієї ТТН. Дочекайтеся завершення роботи над ним.

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">WAITING\_FOR\_TTN\_UPDATE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-32

</td><td style="width: 54.112%;">We have already created a new transaction for TTN. Please use API method GET, "/api/eds/doc/ettn/body" for receiving this new transaction.

Ми вже створили нову транзакцію для ТТН. Будь ласка, використовуйте метод API GET, "/api/eds/doc/ettn/body" для отримання цієї нової транзакції.

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">KEY\_BLOCKED\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-33

</td><td style="width: 54.112%;">Key blocked. EDRPOU/TIN mismatch.

Ключ заблоковано. Невідповідність ЄДРПОУ/ІПН.

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">CONTENT\_FOR\_SIGN\_IS\_NOT\_CREATED\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-34

</td><td style="width: 54.112%;">No signature content created. Resave document

Вміст для підписання не створено. Збережіть документ повторно

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SIGN\_HASH\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-35

</td><td style="width: 54.112%;">sign\_hash is broken, resave document

невідповідний sign\_hash, повторно збережіть документ

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ONLY\_SIGNED\_STAMP\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-36

</td><td style="width: 54.112%;">The document cannot be signed only with the stamp. Sign the document with your signature.

Документ не може бути підписаний лише печаткою. Підпишіть документ своїм підписом.

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INCORRECT\_CONTENT\_TYPE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-37

</td><td style="width: 54.112%;">Setup correct content type in request. Use „application/json“ or „application/xml“

Вкажіть content type в запиті. Використовуйте «application/json» або «application/xml».

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ACTION\_NOT\_AVAILABLE

</td><td style="width: 11.9177%;">ERR\_TTN-38

</td><td style="width: 54.112%;">Action not available.

Дія недоступна.

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DOCUMENT\_NOT\_FOUND\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-39

</td><td style="width: 54.112%;">Document not found

Документ не знайдено

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">TICKET\_NOT\_FOUND\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-40

</td><td style="width: 54.112%;">The required ticket was not found

Необхідна квитанція не знайдена

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ROLE\_MISMATCH\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-41

</td><td style="width: 54.112%;">The company role specified in the URL parameter does not match the role of this company in the document structure

Вказана в URL-параметрі роль компанії не відповідає ролі цієї компанії в структурі документа

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNSUPPORTED\_DOC\_TYPE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-42

</td><td style="width: 54.112%;">Unknown or unsupported doc type.

Невідомий або непідтримуваний тип документа.

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">MINTRANS\_STATUS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-43

</td><td style="width: 54.112%;">Mintrans status error. expected: \[%s\], actual: \[%s\]

Невідповідність статусу від Мінтранс. Очікуваний \[%s\], фактичний \[%s\].

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INITIATOR\_ROLE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-44

</td><td style="width: 54.112%;">Invalid initiator role

Некоректна роль ініціатора

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">TTN\_ACT\_INP\_ROCESS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-45

</td><td style="width: 54.112%;">Act for TTN is in process

Присутній незавершенний акт до ТТН

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">TEMPLATE\_DOC\_UUID\_PARAMS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-46

</td><td style="width: 54.112%;">"template\_doc\_uuid" and "doc\_uuid" parameters cannot be set at the same time

Параметри "template\_doc\_uuid" і "doc\_uuid" не можна встановити одночасно

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INCORRECT\_DOC\_STATUS

</td><td style="width: 11.9177%;">ERR\_TTN-47

</td><td style="width: 54.112%;">Incorrect doc status

Неправильний статус документа

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNSUPPORTED\_ROLE\_CODE

</td><td style="width: 11.9177%;">ERR\_TTN-48

</td><td style="width: 54.112%;">Unknown or unsupported role\_code \[%s\]

Невідомий або непідтримуваний role\_code \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNSUPPORTED\_FORMAT\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-49

</td><td style="width: 54.112%;">Unsupported format \[%s\]

Непідтримуваний формат \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">UNSUPPORTED\_RESPONSE\_TYPE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-50

</td><td style="width: 54.112%;">Unsupported response\_type \[%s\]

Непідтримуваний response\_type \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INCORRECT\_SUBSTATUS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-51

</td><td style="width: 54.112%;">Detect sub\_status error. Current sub\_status: \[%s\]

Некорекнтий сабстатус. Поточний сабстатус: \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ACT\_IS\_COMPLETED\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-52

</td><td style="width: 54.112%;">Act is completed

Акт завершено

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DELIVERY\_COMPLETED\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-53

</td><td style="width: 54.112%;">Delivery is completed

Поставку завершено

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ATTACHMENT\_TYPE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-54

</td><td style="width: 54.112%;">Incorrect attachment type: \[%s\] one of: \[%s\] expected

Неправильний тип вкладення: очікується \[%s\] один із: \[%s\].

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ATTACHMENT\_FILE\_TYPE\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-55

</td><td style="width: 54.112%;">Unsupported file type \[%s\]

Непідтримуваний тип файлу \[%s\].

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ATTACHMENT\_FILE\_COUNT\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-56

</td><td style="width: 54.112%;">Expected 1 file in multipart/form data

Очікується 1 файл у multipart/form data

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">ATTACHMENT\_NOT\_FOUND\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-57

</td><td style="width: 54.112%;">Attachment not found

Вкладення не знайдено

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">PARENT\_DOC\_PARTICIPANTS\_MISMATCHED

</td><td style="width: 11.9177%;">ERR\_TTN-58

</td><td style="width: 54.112%;">The list of participants in the basis document does not correspond to the list of participants in the current document

Перелік учасників документа підстави не відповідає переліку учасників поточного документа

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">MINTRANS\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-59

</td><td style="width: 54.112%;">MINTRANS\_ERROR: \[%s\]

Помилка від Мінтранс: \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">FAIL\_TO\_PARSE\_CONTENT

</td><td style="width: 11.9177%;">ERR\_TTN-60

</td><td style="width: 54.112%;">Fail to parse content in field \[%s\]

Не вдалося опрацювати контент у полі \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INVALID\_SIGN\_FORMAT\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-61

</td><td style="width: 54.112%;">INVALID\_SIGN\_FORMAT, CADES\_X\_LONG is expected

Некоректний форма підпису, допустимий лише CADES\_X\_LONG

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">GLN\_ADDRESS\_NOT\_FOUND

</td><td style="width: 11.9177%;">ERR\_TTN-62

</td><td style="width: 54.112%;">Gln for address \[%s\] not found

Не вдалося визначити gln для адреси \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">KATOTTG\_MISMATCH

</td><td style="width: 11.9177%;">ERR\_TTN-63

</td><td style="width: 54.112%;">katottg \[%s\] in gln \[%s\] and document \[%s\] are different

катоттг \[%s\] в gln \[%s\] та документі \[%s\] відрізняються

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SIGN\_CONTAINER\_IS\_EMPTY

</td><td style="width: 11.9177%;">ERR\_TTN-64

</td><td style="width: 54.112%;">Signs not found

В документі відсутні підписи

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">XSD\_VALIDATION\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-65

</td><td style="width: 54.112%;">xsd validation error: \[%s\]

Помилка при валідації за xsd: \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">APPLICATION\_XML\_CONTENT\_TYPE\_EXPECTED

</td><td style="width: 11.9177%;">ERR\_TTN-66

</td><td style="width: 54.112%;">Setup correct content type in request. Use „application/xml“

Вкажіть content type в запиті. Використовуйте «application/xml».

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">XML\_BODY\_IS\_NOT\_CANONICAL

</td><td style="width: 11.9177%;">ERR\_TTN-67

</td><td style="width: 54.112%;">xml body is not canonical or invalid

xml тіло не канонізоване або некоректне

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DOCUMENT\_VALIDATION\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-68

</td><td style="width: 54.112%;">Validation document errors: \[%s\]

Документ містить помилки: \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DOCUMENT\_XSD\_VALIDATION\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-69

</td><td style="width: 54.112%;">XSD Validation document error: \[%s\]

Помилка валідації документа за XSD: \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">DRIVER\_RESP\_PERSON\_NTO\_FOUND

</td><td style="width: 11.9177%;">ERR\_TTN-70

</td><td style="width: 54.112%;">No person with the driver’s TIN was found among the responsible persons of the carrier

Серед відповідальних осіб перевізника не знайдено особу з ІПН водія

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">EMPTY\_LINK\_DOC\_LIST

</td><td style="width: 11.9177%;">ERR\_TTN-72

</td><td style="width: 54.112%;">empty link doc list

Порожній список документів

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">LINK\_DOCS\_LIMIT\_EXCEEDED

</td><td style="width: 11.9177%;">ERR\_TTN-73

</td><td style="width: 54.112%;">The limit of the number of linked documents has been exceeded. Limit: \[%s\], 1

Перевищено ліміт кількості пов’язаних документів. Ліміт: \[%s\], 1

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INCORRECT\_LINKED\_DOC\_UUID\_LIST

</td><td style="width: 11.9177%;">ERR\_TTN-74

</td><td style="width: 54.112%;">Incorrect list uuid of documents

Некоректний список uuid-ів документів

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">INCORRECT\_LINK\_DOCS\_DATA

</td><td style="width: 11.9177%;">ERR\_TTN-75

</td><td style="width: 54.112%;">Errors found when checking documents: \[%s\], 1

Знайдені помилки при перевірці документів: \[%s\], 1

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SIGN\_ERROR

</td><td style="width: 11.9177%;">ERR\_TTN-76

</td><td style="width: 54.112%;">Signs is invalid: \[%s\], 1

Помилка при перевірці підпису: \[%s\], 1

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;">SIGN\_EDRPOU\_MISMATCH\_COMPANY\_EDRPOU

</td><td style="width: 11.9177%;">ERR\_TTN-77

</td><td style="width: 54.112%;">EDRPOU from sign: \[%s\] is not equals gln EDRPOU: \[%s\], 2

ЄДРПОУ з підписа: \[%s\] не відповідає ЄДРПОУ з глн: \[%s\], 2

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-78

</td><td style="width: 54.112%;">It is not possible to generate a new bill of lading with the same data of ORDER\_NO, ORDER\_DATE, DELIVERY\_NOTE\_NO, DELIVERY\_NOTE\_DATEaccording to the settings of the consignee

Неможливо створити нову накладну з тими самими даними ORDER\_NO, ORDER\_DATE, DELIVERY\_NOTE\_NO, DELIVERY\_NOTE\_DATEвідповідно до налаштувань одержувача

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-79

</td><td style="width: 54.112%;">Unknown performer

Невідомий виконавець

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-80

</td><td style="width: 54.112%;">Key blocked. Key is not on secure media

Ключ заблоковано. Ключ знаходиться на незахищеному носії

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-82

</td><td style="width: 54.112%;">Key blocked. Signer position is required

Ключ заблоковано. Наявність посади підписанта обов’язкова

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-83

</td><td style="width: 54.112%;">Company not found by code: \[%s\], companyCode

За кодом \[%s\] компанія не знайдена, companyCode

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-84

</td><td style="width: 54.112%;">Document body not found or not created, try to resave document

Тіло документа не знайдено або ще не створено, спробуйте повторно зберегти документ

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-85

</td><td style="width: 54.112%;">Setup url params: \[%s\], params

Вкажіть url-параметри: \[%s\], params

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-86

</td><td style="width: 54.112%;">Request body is empty or invalid

Тіло запиту порожнє або некоректне

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-88

</td><td style="width: 54.112%;">Document is not signed

Документ не підписаний

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-89

</td><td style="width: 54.112%;">Completed doc \[%s\] for parent eTTN already exists

Для документа підстави (ТТН) вже зареєстровано документ: \[%s\]

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-90

</td><td style="width: 54.112%;">Unsupported status \[%s\], one of \[%s\] is expected

Некоректний статус \[%s\]. Очікується один з наступних: \[%s\]

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-91

</td><td style="width: 54.112%;">Confirm document error

Помилка при підтвердження документа

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-92

</td><td style="width: 54.112%;">Reject document error

Помилка при відхиленні документа

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-93

</td><td style="width: 54.112%;">Company not found for this user

Не знайдено компанію для поточного юзера

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-94

</td><td style="width: 54.112%;">No supported documents

Відсутні підтримувані документи

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-95

</td><td style="width: 54.112%;">Invalid format of transport id, only Latin uppercase letters and numbers are expected.

Некоректний формат транспортного засобу, очікуються лише латинські великі літери та цифри.

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-96

</td><td style="width: 54.112%;">Some link docs has incorrect status

Деякі пов’язані документи знаходяться в некоректному статусі.

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-97

</td><td style="width: 54.112%;">Katottg code for \[%s\] is required

КАТОТТГ для адреси \[%s\] є обов’язковим

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-98

</td><td style="width: 54.112%;">Rejection unavailable after carrier signing

Відхилення неможливе після підписання перевізником

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-99

</td><td style="width: 54.112%;">The signature is not available according to the recipient’s requirements

Підпис недоступний відповідно до вимог одержувача

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-100

</td><td style="width: 54.112%;">It is not possible to create / send a new transaction to a document in Draft status

Неможливо створити / відправити нову транзакцію до документа в статусі Чернетка

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-101

</td><td style="width: 54.112%;">Дія недоступна для поточної ролі учасника

Action not available for current party role

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-102

</td><td style="width: 54.112%;">The action is not available for a document in draft status

Дія недоступна для документа в статусі чернетка

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-103

</td><td style="width: 54.112%;">Field {field} has invalid value {value}

Поле {поле} має недопустиме значення {значення}

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-105

</td><td style="width: 54.112%;">The action is not available. TTN lifecycle was terminated

Дія недоступна. Життєвий цикл ТТН було завершено

</td></tr><tr class="row-odd"><td class="align-center" style="width: 10.3695%;">400

</td><td style="width: 23.6008%;"> </td><td style="width: 11.9177%;">ERR\_TTN-106

</td><td style="width: 54.112%;">The action is not available. TTN lifecycle was terminated based on {doc name}

Дія недоступна. Життєвий цикл ТТН було завершено на підставі {назва документа}

</td></tr><tr class="row-even"><td class="align-center" style="width: 10.3695%;">500

</td><td style="width: 23.6008%;">Internal server error: sd898sdf63

</td><td style="width: 11.9177%;"> </td><td style="width: 54.112%;">Виникає в разі неможливості опрацювати запит (рекомендуємо звернутись до нашої технічної підтримки: [support@edin.ua](mailto:support%40edin.ua))

</td></tr></tbody></table>

##### **Помилки, що можуть виникнути на стороні ЦБД**

<table class="colwidths-given docutils align-default" id="bkmrk-%D0%9A%D0%BE%D0%B4-%D0%B2%D1%96%D0%B4%D0%BF%D0%BE%D0%B2%D1%96%D0%B4%D1%96-%D0%9A%D0%BE%D0%B4-%D0%BF%D0%BE" style="width: 100.119%;"><tbody><tr class="row-odd"><td style="width: 15.6138%;">**Код відповіді**

</td><td style="width: 17.2839%;">**Код помилки**

</td><td style="width: 67.1023%;">**Опис**

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">0

</td><td style="width: 67.1023%;">Внутрішня помилка ЦБД

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">1

</td><td style="width: 67.1023%;">Некоректно сформований запит

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">2

</td><td style="width: 67.1023%;">Некоректний токен

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">4

</td><td style="width: 67.1023%;">Некоректний тип транспортного засобу

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">5

</td><td style="width: 67.1023%;">Некоректна роль представника

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">6

</td><td style="width: 67.1023%;">Об’єкт eTTN не знайдений

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">7

</td><td style="width: 67.1023%;">Некоректний перехід між станами eTTN

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">9

</td><td style="width: 67.1023%;">Завантаження у поточному стані не дозволене

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">10

</td><td style="width: 67.1023%;">Об’єкт супровідного документу не знайдений

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">11

</td><td style="width: 67.1023%;">Запропонований тип супровідного документу відрізняється від поточного

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">12

</td><td style="width: 67.1023%;">Некоректний перехід між станами супровідних документів

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">13

</td><td style="width: 67.1023%;">Некоректний запропонований час відміни супровідного документу

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">14

</td><td style="width: 67.1023%;">Підпис подіїї більше не дійсний

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">15

</td><td style="width: 67.1023%;">Відсутній ідентифікатор події

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">16

</td><td style="width: 67.1023%;">Розбіжність у текстах згоди

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">17

</td><td style="width: 67.1023%;">Споживач не підписаний на події

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">18

</td><td style="width: 67.1023%;">Відсутній текст згоди

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">19

</td><td style="width: 67.1023%;">Токен доступу більше не дійсний

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">20

</td><td style="width: 67.1023%;">Некоректна роль підписанта eTTN

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">21

</td><td style="width: 67.1023%;">Некоректна роль підписанта супровідного документу

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">22

</td><td style="width: 67.1023%;">Некоректне посилання на документ

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">24

</td><td style="width: 67.1023%;">Некоректна комбінація станів eTTN та супровідного документу

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">25

</td><td style="width: 67.1023%;">Некоректна операція з оновлення представників

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">26

</td><td style="width: 67.1023%;">Некоректна кількість підписів супровідного документу

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">27

</td><td style="width: 67.1023%;">Некоректний тип супровідного документу

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">28

</td><td style="width: 67.1023%;">Некоректний запропонований час оновлення супровідного документу

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">29

</td><td style="width: 67.1023%;">Документ не відповідає схемі

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">30

</td><td style="width: 67.1023%;">Підпис документу не пройшов перевірку

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">31

</td><td style="width: 67.1023%;">Невалідна попередня версія документу

</td></tr><tr class="row-odd"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">32

</td><td style="width: 67.1023%;">Не вдалося завантажити документ

</td></tr><tr class="row-even"><td style="width: 15.6138%;">400

</td><td style="width: 17.2839%;">33

</td><td style="width: 67.1023%;">Невалідний токен для отримання документу

</td></tr></tbody></table>

# Видалення прив’язки ТТН до «Зведеної ТТН» DELETE /api/eds/doc/ettn/ttn/link_docs

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 16.0869%;"></col><col style="width: 83.9131%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/link\_docs

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії;

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа «Зведена ТТН»

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>*application/json*

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу (в json форматі) передається масив UUID-ів ТТН документів, що будуть видалені зі «Зведеної ТТН».

</td></tr></tbody></table>

**Приклад запиту**

```json
["doc_uuid одиночної ТТН №1", "doc_uuid одиночної ТТН №2", "doc_uuid одиночної ТТН №3"]
```

##### **RESPONSE**

Код сервера 200 (ok).

# Прив'язка ТТН до «Зведеної ТТН» POST /api/eds/doc/ettn/ttn/link_docs

**Правила формування зв’язку між ТТН та «Зведеною ТТН»**

1. **Унікальність зв’язку**
    
    
    - Одна ТТН може бути пов’язана лише з однією «Зведеною ТТН».
    - Для створення нового зв’язку попередній необхідно розірвати.
2. **Умови формування зв’язку**
    
    
    - «Зведена ТТН» має перебувати у статусі «Чернетка».
    - ТТН може перебувати в одному з допустимих статусів:
        
        
        - **OPEN** (чернетка відправника) зі значенням `ready_for_sign == 1` (готовий до підписання);
        - **SENT** (відправлений відправником).
3. **Вимоги до узгодженості даних**
    
    
    - Поле **`carrier_uuid`** («Перевізник») у всіх пов’язаних ТТН має збігатися.
    - Значення наступних [додаткових полів](https://wiki-v2.edin.ua/books/robota-z-api/page/dodatkovi-polia-extra-fields) у всіх ТТН повинні бути однаковими та відповідати даним «Зведеної ТТН»:
        
        
        - **`consignee_uuid`** – Вантажоотримувач,
        - **`consignor_uuid`** – Вантажовідправник,
        - **`driver_uuid`** – Водій,
        - **`load_place_uuid`** – Місце завантаження,
        - **`delivery_place_uuid`** – Місце доставки.
4. **Обмеження**
    
    
    - До однієї «Зведеної ТТН» можна прив’язати не більше 100 ТТН документів.

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e"><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/link\_docs

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії;

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа «Зведена ТТН»

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>*application/json*

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу (в json форматі) передається масив UUID-ів ТТН документів, що будуть пов’язані зі «Зведеною ТТН».

</td></tr></tbody></table>

**Приклад запиту**

```json
["doc_uuid одиночної ТТН №1", "doc_uuid одиночної ТТН №2", "doc_uuid одиночної ТТН №3"]
```

##### **RESPONSE**

Код сервера 200 (ok).

# Отримання пов'язаних документів  «Зведеної ТТН» GET /api/eds/doc/ettn/ttn/link_docs

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 106.667%;"><tbody><tr class="row-odd"><td style="width: 18.7146%;">**URL**

</td><td style="width: 81.2854%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 18.7146%;">Метод запиту

</td><td style="width: 81.2854%;">GET

</td></tr><tr class="row-odd"><td style="width: 18.7146%;">URL запиту

</td><td style="width: 81.2854%;">/api/eds/doc/ettn/ttn/link\_docs

</td></tr><tr class="row-even"><td style="width: 18.7146%;">URL параметри

</td><td style="width: 81.2854%;">**gln** (обов’язково) String - GLN власної Компанії;

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа «Зведена ТТН»

</td></tr><tr class="row-odd"><td style="width: 18.7146%;">**Headers**

</td><td style="width: 81.2854%;"> </td></tr><tr class="row-even"><td style="width: 18.7146%;">Authorization

</td><td style="width: 81.2854%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 18.7146%;">Content-Type

</td><td style="width: 81.2854%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді в json форматі передається масив об’єктів з даними пов’язаних документів (об’єкт[ XDoc](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdoc)).

# Отримання документа з ЦБД GET /api/mintrans/doc

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 16.0921%;">**URL**

</td><td style="width: 83.9079%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 16.0921%;">Метод запиту

</td><td style="width: 83.9079%;">GET

</td></tr><tr class="row-odd"><td style="width: 16.0921%;">URL запиту

</td><td style="width: 83.9079%;">/api/mintrans/doc

</td></tr><tr class="row-even"><td style="width: 16.0921%;">URL параметри

</td><td style="width: 83.9079%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**mintrans\_doc\_id** (обов’язково) String - ідентифікатор документа (documentId з методу отримання даних подій)

</td></tr><tr class="row-odd"><td style="width: 16.0921%;">**Headers**

</td><td style="width: 83.9079%;"> </td></tr><tr class="row-even"><td style="width: 16.0921%;">Authorization

</td><td style="width: 83.9079%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 16.0921%;">Content-Type

</td><td style="width: 83.9079%;">*application/json*

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповіді передаються дані документа з ЦБД ([об’єкт EttnV3MintransDoc](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Methods/EveryBody/EttnV3MintransDoc.html)).

# Отримання списку подій з ЦБД GET /api/mintrans/events

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 14.898%;">**URL**

</td><td style="width: 85.102%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 14.898%;">Метод запиту

</td><td style="width: 85.102%;">GET

</td></tr><tr class="row-odd"><td style="width: 14.898%;">URL запиту

</td><td style="width: 85.102%;">/api/mintrans/events

</td></tr><tr class="row-even"><td style="width: 14.898%;">URL параметри

</td><td style="width: 85.102%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі;

**date\_from** (обов’язково) long - дата (unix timestamp), починаючи з якої буде робитись вибірка;

**limit** (опціонально) int - ліміт вибірки (за замовчуванням=50);

**offset** (опціонально) int - зміщення відносно верхньої межі вибірки (за замовчуванням=0)

</td></tr><tr class="row-odd"><td style="width: 14.898%;">**Headers**

</td><td style="width: 85.102%;"> </td></tr><tr class="row-even"><td style="width: 14.898%;">Authorization

</td><td style="width: 85.102%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 14.898%;">Content-Type

</td><td style="width: 85.102%;">*application/json*

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповіді передаються дані подій з ЦБД масив об’єктів [EttnV3Event](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-ettnv3event).

# Видалення підписки на події (отримання документів) DELETE /api/mintrans/subscribe

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.9642%;">**URL**

</td><td style="width: 84.0358%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.9642%;">Метод запиту

</td><td style="width: 84.0358%;">DELETE

</td></tr><tr class="row-odd"><td style="width: 15.9642%;">URL запиту

</td><td style="width: 84.0358%;">/api/mintrans/subscribe

</td></tr><tr class="row-even"><td style="width: 15.9642%;">URL параметри

</td><td style="width: 84.0358%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

</td></tr><tr class="row-odd"><td style="width: 15.9642%;">**Headers**

</td><td style="width: 84.0358%;"> </td></tr><tr class="row-even"><td style="width: 15.9642%;">Authorization

</td><td style="width: 84.0358%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.9642%;">Content-Type

</td><td style="width: 84.0358%;">*application/json*

</td></tr><tr class="row-even"><td style="width: 15.9642%;">**REQUEST**

</td><td style="width: 84.0358%;"> </td></tr><tr class="row-odd"><td style="width: 15.9642%;">JSON Body

</td><td style="width: 84.0358%;">В тілі запиту методу в base64 форматі передається підписаний рядок «yes» (попередньо підписуємо рядок «yes» -&gt; отримуємо p7s файл підпису -&gt; конвертуємо p7s в base64 формат)

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Створення підписки про події (отримання документів) POST /api/mintrans/subscribe

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 16.4535%;">**URL**

</td><td style="width: 83.5465%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 16.4535%;">Метод запиту

</td><td style="width: 83.5465%;">POST

</td></tr><tr class="row-odd"><td style="width: 16.4535%;">URL запиту

</td><td style="width: 83.5465%;">/api/mintrans/subscribe

</td></tr><tr class="row-even"><td style="width: 16.4535%;">URL параметри

</td><td style="width: 83.5465%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

</td></tr><tr class="row-odd"><td style="width: 16.4535%;">**Headers**

</td><td style="width: 83.5465%;"> </td></tr><tr class="row-even"><td style="width: 16.4535%;">Authorization

</td><td style="width: 83.5465%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 16.4535%;">Content-Type

</td><td style="width: 83.5465%;">*application/json*

</td></tr><tr class="row-even"><td style="width: 16.4535%;">**REQUEST**

</td><td style="width: 83.5465%;"> </td></tr><tr class="row-odd"><td style="width: 16.4535%;">JSON Body

</td><td style="width: 83.5465%;">В тілі запиту методу в base64 форматі передається підписаний рядок «yes» (попередньо підписуємо рядок «yes» -&gt; отримуємо p7s файл підпису -&gt; конвертуємо p7s в base64 формат)

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповіді передаються дані підписки (об'єкт [mintransSubscription](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-mintranssubscription)).

# Отримання даних про підписки на події / Отримання даних про підпис особи GET /api/mintrans/subscribe

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.374%;">**URL**

</td><td style="width: 84.626%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.374%;">Метод запиту

</td><td style="width: 84.626%;">GET

</td></tr><tr class="row-odd"><td style="width: 15.374%;">URL запиту

</td><td style="width: 84.626%;">/api/mintrans/subscribe

</td></tr><tr class="row-even"><td style="width: 15.374%;">URL параметри

</td><td style="width: 84.626%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**sign\_info** (опціонально) Boolean - при sign\_info=true в тілі відповіді передаються дані про підпис особи, що оформила підписку (не дані про підписку)

</td></tr><tr class="row-odd"><td style="width: 15.374%;">**Headers**

</td><td style="width: 84.626%;"> </td></tr><tr class="row-even"><td style="width: 15.374%;">Authorization

</td><td style="width: 84.626%;">**SID** - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.374%;">Content-Type

</td><td style="width: 84.626%;">*application/json*

</td></tr></tbody></table>

##### **RESPONSE**

<span style="background-color: rgb(248, 202, 198);">У тілі відповіді передаються дані підписок (масив об’єктів [mintransSubscription](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-mintranssubscription)) або дані про підпис особи, що оформила підписку ([об’єкт ExEndUserSignInfo](https://wiki.edin.ua/uk/latest/API_ETTNv3_1/Methods/EveryBody/ExEndUserSignInfo.html)), якщо в методі передається параметр sign\_info.</span>

# Надсилання Актів з Чернеток PATCH /api/eds/doc/ettn/act/send

Метод призначений для надсилання нових документів, які вже підписані. У разі внесення змін чи доповнень, їх надсилання здійснюється через методи `/api/eds/doc/ettn/act/transaction`.

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.3712%;">**URL**

</td><td style="width: 84.6288%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.3712%;">Метод запиту

</td><td style="width: 84.6288%;">PATCH

</td></tr><tr class="row-odd"><td style="width: 15.3712%;">URL запиту

</td><td style="width: 84.6288%;">/api/eds/doc/ettn/act/send

</td></tr><tr class="row-even"><td style="width: 15.3712%;">URL параметри

</td><td style="width: 84.6288%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

</td></tr><tr class="row-odd"><td style="width: 15.3712%;">**Headers**

</td><td style="width: 84.6288%;"> </td></tr><tr class="row-even"><td style="width: 15.3712%;">Authorization

</td><td style="width: 84.6288%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.3712%;">Content-Type

</td><td style="width: 84.6288%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Відхилення Актів сервісу PUT /api/eds/doc/ettn/act/reject

<p class="callout info">Метод може використовуватися як ініціатором Акта (до підписання іншою стороною), так і отримувачем — до моменту підписання.</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 16.3236%;">**URL**

</td><td style="width: 83.6764%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 16.3236%;">Метод запиту

</td><td style="width: 83.6764%;">PUT

</td></tr><tr class="row-odd"><td style="width: 16.3236%;">URL запиту

</td><td style="width: 83.6764%;">/api/eds/doc/ettn/act/reject

</td></tr><tr class="row-even"><td style="width: 16.3236%;">URL параметри

</td><td style="width: 83.6764%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**rejected\_by** (обов’язково) String - ПІБ співробітника

</td></tr><tr class="row-odd"><td style="width: 16.3236%;">**Headers**

</td><td style="width: 83.6764%;"> </td></tr><tr class="row-even"><td style="width: 16.3236%;">Authorization

</td><td style="width: 83.6764%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 16.3236%;">Content-Type

</td><td style="width: 83.6764%;">*application/json*

</td></tr><tr class="row-even"><td style="width: 16.3236%;">**REQUEST**

</td><td style="width: 83.6764%;"> </td></tr><tr class="row-odd"><td style="width: 16.3236%;">JSON Body

</td><td style="width: 83.6764%;">В тілі запиту методу (в json форматі) передається причина відхилення документа в текстовому вигляді.

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Надсилання нової транзакції до Актів сервісу PUT /api/eds/doc/ettn/act/transaction

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 16.2098%;">**URL**

</td><td style="width: 83.7902%;">https://edo-v2.edin.ua </td></tr><tr class="row-even"><td style="width: 16.2098%;">Метод запиту

</td><td style="width: 83.7902%;">PUT

</td></tr><tr class="row-odd"><td style="width: 16.2098%;">URL запиту

</td><td style="width: 83.7902%;">/api/eds/doc/ettn/act/transaction

</td></tr><tr class="row-even"><td style="width: 16.2098%;">URL параметри

</td><td style="width: 83.7902%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

</td></tr><tr class="row-odd"><td style="width: 16.2098%;">**Headers**

</td><td style="width: 83.7902%;"> </td></tr><tr class="row-even"><td style="width: 16.2098%;">Authorization

</td><td style="width: 83.7902%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 16.2098%;">Content-Type

</td><td style="width: 83.7902%;">*application/json* або *application/xml*

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Створення/редагування нової транзакції (чернетки) до Актів сервісу POST /api/eds/doc/ettn/act/transaction

При повторному виклику методу з тими самими URL-параметрами відбувається оновлення (перезапис) вже вкладеного контенту.

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 14.4209%;"></col><col style="width: 85.5791%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/act/transaction

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>*application/json* або *application/xml*

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу (в json/xml форматі) передається транзакція - контент документа без підписів ([об’єкт EcmrAct](https://wiki.edin.ua/uk/latest/API_ETTNv3/Methods/EveryBody/EcmrAct.html))

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

<p class="callout info">Після відпрацювання методу, та до надсилання транзакції, результат [**отримання документа сервісу**](https://wiki-v2.edin.ua/books/robota-z-api/page/zagalni-metodi#bkmrk-%D0%97%D0%B0%D0%B2%D0%B0%D0%BD%D1%82%D0%B0%D0%B6%D0%B5%D0%BD%D0%BD%D1%8F-%D1%82%D1%96%D0%BB%D0%B0-%D0%B4%D0%BE) матиме відмінність для інших контрагентів.</p>

# Створення/редагування чернетки «Акт завантаження на проміжному складі до e-TTN» POST /api/eds/doc/ettn/storage_pickup

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 15.9722%;"></col><col style="width: 84.0278%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/storage\_pickup

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/Authorization.html)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>*application/json* or *application/xml*

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу передається тіло документа [Акта завантаження на проміжному складі](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-zavantazennia-na-promiznomu-skladi) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт розвантаження на проміжному складі до e-TTN» POST /api/eds/doc/ettn/storage_delivery

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.0099%;">**URL**

</td><td style="width: 84.9901%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.0099%;">Метод запиту

</td><td style="width: 84.9901%;">POST

</td></tr><tr class="row-odd"><td style="width: 15.0099%;">URL запиту

</td><td style="width: 84.9901%;">/api/eds/doc/ettn/storage\_delivery

</td></tr><tr class="row-even"><td style="width: 15.0099%;">URL параметри

</td><td style="width: 84.9901%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td style="width: 15.0099%;">**Headers**

</td><td style="width: 84.9901%;"> </td></tr><tr class="row-even"><td style="width: 15.0099%;">Authorization

</td><td style="width: 84.9901%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.0099%;">Content-Type

</td><td style="width: 84.9901%;">*application/json* or *application/xml*

</td></tr><tr class="row-even"><td style="width: 15.0099%;">**REQUEST**

</td><td style="width: 84.9901%;"> </td></tr><tr class="row-odd"><td style="width: 15.0099%;">JSON Body

</td><td style="width: 84.9901%;">В тілі запиту методу передається тіло документа [Акта розвантаження на проміжному складі](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-rozvantazennia-na-promiznomu-skladi) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт примусового завершення e-TTN» POST /api/eds/doc/ettn/stop

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 15.1335%;"></col><col style="width: 84.8665%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/stop

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>*application/json* or *application/xml*

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу передається тіло документа [Акта примусового завершення е-ТТН](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-primusovogo-zaversennia-e-ttn) у форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт перепломбування до e-TTN» POST /api/eds/doc/ettn/resealing

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 14.6583%;">**URL**

</td><td style="width: 85.3417%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 14.6583%;">Метод запиту

</td><td style="width: 85.3417%;">POST

</td></tr><tr class="row-odd"><td style="width: 14.6583%;">URL запиту

</td><td style="width: 85.3417%;">/api/eds/doc/ettn/resealing

</td></tr><tr class="row-even"><td style="width: 14.6583%;">URL параметри

</td><td style="width: 85.3417%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td style="width: 14.6583%;">**Headers**

</td><td style="width: 85.3417%;"> </td></tr><tr class="row-even"><td style="width: 14.6583%;">Authorization

</td><td style="width: 85.3417%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 14.6583%;">Content-Type

</td><td style="width: 85.3417%;">*application/json* or *application/xml*

</td></tr><tr class="row-even"><td style="width: 14.6583%;">**REQUEST**

</td><td style="width: 85.3417%;"> </td></tr><tr class="row-odd"><td style="width: 14.6583%;">JSON Body

</td><td style="width: 85.3417%;">В тілі запиту методу передається тіло документа [Акта перепломбування](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-pereplombuvannia) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт перевантаження до e-TTN» POST /api/eds/doc/ettn/reload

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 14.7805%;">**URL**

</td><td style="width: 85.2195%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 14.7805%;">Метод запиту

</td><td style="width: 85.2195%;">POST

</td></tr><tr class="row-odd"><td style="width: 14.7805%;">URL запиту

</td><td style="width: 85.2195%;">/api/eds/doc/ettn/reload

</td></tr><tr class="row-even"><td style="width: 14.7805%;">URL параметри

</td><td style="width: 85.2195%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td style="width: 14.7805%;">**Headers**

</td><td style="width: 85.2195%;"> </td></tr><tr class="row-even"><td style="width: 14.7805%;">Authorization

</td><td style="width: 85.2195%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 14.7805%;">Content-Type

</td><td style="width: 85.2195%;">*application/json* or *application/xml*

</td></tr><tr class="row-even"><td style="width: 14.7805%;">**REQUEST**

</td><td style="width: 85.2195%;"> </td></tr><tr class="row-odd"><td style="width: 14.7805%;">JSON Body

</td><td style="width: 85.2195%;">В тілі запиту методу передається тіло документа [Акта перевантаження](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-perevantazennia) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт про відмову вантажити до e-TTN» POST /api/eds/doc/ettn/load_reject

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.2485%;">**URL**

</td><td style="width: 84.7515%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.2485%;">Метод запиту

</td><td style="width: 84.7515%;">POST

</td></tr><tr class="row-odd"><td style="width: 15.2485%;">URL запиту

</td><td style="width: 84.7515%;">/api/eds/doc/ettn/load\_reject

</td></tr><tr class="row-even"><td style="width: 15.2485%;">URL параметри

</td><td style="width: 84.7515%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td style="width: 15.2485%;">**Headers**

</td><td style="width: 84.7515%;"> </td></tr><tr class="row-even"><td style="width: 15.2485%;">Authorization

</td><td style="width: 84.7515%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.2485%;">Content-Type

</td><td style="width: 84.7515%;">*application/json* or *application/xml*

</td></tr><tr class="row-even"><td style="width: 15.2485%;">**REQUEST**

</td><td style="width: 84.7515%;"> </td></tr><tr class="row-odd"><td style="width: 15.2485%;">JSON Body

</td><td style="width: 84.7515%;">В тілі запиту методу передається тіло документа [Акта про відмову вантажити](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-pro-vidmovu-vantaziti) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт розбіжностей про вантаж» POST /api/eds/doc/ettn/disagreement

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 16.2072%;">**URL**

</td><td style="width: 83.7928%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 16.2072%;">Метод запиту

</td><td style="width: 83.7928%;">POST

</td></tr><tr class="row-odd"><td style="width: 16.2072%;">URL запиту

</td><td style="width: 83.7928%;">/api/eds/doc/ettn/disagreement

</td></tr><tr class="row-even"><td style="width: 16.2072%;">URL параметри

</td><td style="width: 83.7928%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td style="width: 16.2072%;">**Headers**

</td><td style="width: 83.7928%;"> </td></tr><tr class="row-even"><td style="width: 16.2072%;">Authorization

</td><td style="width: 83.7928%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 16.2072%;">Content-Type

</td><td style="width: 83.7928%;">*application/json* or *application/xml*

</td></tr><tr class="row-even"><td style="width: 16.2072%;">**REQUEST**

</td><td style="width: 83.7928%;"> </td></tr><tr class="row-odd"><td style="width: 16.2072%;">JSON Body

</td><td style="width: 83.7928%;">В тілі запиту методу передається тіло документа [Акта розбіжностей про вантаж](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-rozbiznostei-pro-vantaz) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт про заміну пункту призначення вантажу» POST /api/eds/doc/ettn/consignee_change

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.8558%;">**URL**

</td><td style="width: 84.1442%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.8558%;">Метод запиту

</td><td style="width: 84.1442%;">POST

</td></tr><tr class="row-odd"><td style="width: 15.8558%;">URL запиту

</td><td style="width: 84.1442%;">/api/eds/doc/ettn/consignee\_change

</td></tr><tr class="row-even"><td style="width: 15.8558%;">URL параметри

</td><td style="width: 84.1442%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td style="width: 15.8558%;">**Headers**

</td><td style="width: 84.1442%;"> </td></tr><tr class="row-even"><td style="width: 15.8558%;">Authorization

</td><td style="width: 84.1442%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.8558%;">Content-Type

</td><td style="width: 84.1442%;">*application/json* or *application/xml*

</td></tr><tr class="row-even"><td style="width: 15.8558%;">**REQUEST**

</td><td style="width: 84.1442%;"> </td></tr><tr class="row-odd"><td style="width: 15.8558%;">JSON Body

</td><td style="width: 84.1442%;">В тілі запиту методу передається тіло документа [Акта про заміну пункту призначення вантажу](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-pro-zaminu-punktu-priznacennia-vantazu) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення/редагування чернетки «Акт коригування» POST /api/eds/doc/ettn/adjustment

Вибір дії (створення чи редагування) визначається параметрами запиту:

- якщо в URL присутній ідентифікатор документа (`doc_uuid`), відбувається редагування документа сервісу «ETTN» з указаним Id;
- якщо параметр `doc_uuid` відсутній, створюється новий документ, тип якого задається в URL.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/adjustment

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеного документа)

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>*application/json* or *application/xml*

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу передається тіло документа [Акта коригування](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/akt-koriguvannia) в форматі json чи xml залежно від Content-Type. **Важливо:** в тілі Акта має передаватись ідентифікатор (guid) е-ТТН (детальніше за посиланням вище).

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі

```
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Створення та надсилання  e-TTH (без створення чернетки) POST /api/eds/doc/ettn/ttn/create_and_send

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e"><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/create\_and\_send

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/xml

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу передається повне UAECMR тіло документа [е-ТТН](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/elektronna-tovarno-transportna-nakladna-e-ttn) (з заповненим UaSignatureStorage та підписом/підписами) в xml форматі.

</td></tr></tbody></table>

<details id="bkmrk-%D0%9F%D1%80%D0%B8%D0%BA%D0%BB%D0%B0%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-%D0%B2-xml"><summary>Приклад запиту в xml форматі</summary>

```json
<UAECMR
             xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:103"
             xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:103"
             xmlns:uas="urn:ua:signatures:SignaturesExtensions:1"
             xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:27">
             <eCMR>
                     <ExchangedDocumentContext>
                             <ram:SpecifiedTransactionID>0</ram:SpecifiedTransactionID>
                             <ram:BusinessProcessSpecifiedDocumentContextParameter>
                                     <ram:ID>urn:ua:e-transport.gov.ua:ettn:01</ram:ID>
                             </ram:BusinessProcessSpecifiedDocumentContextParameter>
                             <ram:GuidelineSpecifiedDocumentContextParameter>
                                     <ram:ID>urn:ua:e-transport.gov.ua:ettn:01:generic:001</ram:ID>
                             </ram:GuidelineSpecifiedDocumentContextParameter>
                     </ExchangedDocumentContext>
                     <ExchangedDocument>
                             <ram:ID>test_3674_re-test_010</ram:ID>
                             <ram:IssueDateTime>
                                     <udt:DateTime>2023-09-17T09:30:00.000Z</udt:DateTime>
                             </ram:IssueDateTime>
                             <ram:IncludedNote>
                                     <ram:ContentCode listAgencyID="logistic_unit_number_with_logger">logistic number</ram:ContentCode>
                                     <ram:Content>CZ</ram:Content>
                             </ram:IncludedNote>
                             <ram:IncludedNote>
                                     <ram:ContentCode listAgencyID="gps_number">gps</ram:ContentCode>
                                     <ram:Content>CZ</ram:Content>
                             </ram:IncludedNote>
                             <ram:IncludedNote>
                                     <ram:ContentCode listAgencyID="logger_number">termologer number</ram:ContentCode>
                                     <ram:Content>CZ</ram:Content>
                             </ram:IncludedNote>
                             <ram:IncludedNote>
                                     <ram:ContentCode listAgencyID="reserve_number">reserve_number</ram:ContentCode>
                                     <ram:Content>CZ</ram:Content>
                             </ram:IncludedNote>
                             <ram:IncludedNote>
                                     <ram:ContentCode listAgencyID="comment">comment by CZ</ram:ContentCode>
                                     <ram:Content>CZ</ram:Content>
                             </ram:IncludedNote>
                             <ram:IssueLogisticsLocation>
                                     <ram:Name>Місце складання документу</ram:Name>
                                     <ram:Description>test1</ram:Description>
                             </ram:IssueLogisticsLocation>
                     </ExchangedDocument>
                     <SpecifiedSupplyChainConsignment>
                             <ram:GrossWeightMeasure unitCode="KGM">555</ram:GrossWeightMeasure>
                             <ram:AssociatedInvoiceAmount currencyID="UAH">4690</ram:AssociatedInvoiceAmount>
                             <ram:ConsignmentItemQuantity>234</ram:ConsignmentItemQuantity>
                             <ram:ConsignorTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">42453235</ram:ID>
                                     <ram:Name>Володя Нова ГЛН</ram:Name>
                                     <ram:RoleCode>CZ</ram:RoleCode>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>456464</ram:PostcodeCode>
                                             <ram:StreetName>вул. Атом, буд. 1</ram:StreetName>
                                             <ram:CityName>c. Річиця</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Волинська обл. Ковельський р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864065748076</ram:ID>
                                             <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                             </ram:ConsignorTradeParty>
                             <ram:ConsigneeTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">98084002</ram:ID>
                                     <ram:Name>Мій Одержувач</ram:Name>
                                     <ram:RoleCode>CN</ram:RoleCode>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>734532</ram:PostcodeCode>
                                             <ram:StreetName>б.145, вул. Зелена</ram:StreetName>
                                             <ram:CityName>c. Річиця</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Волинська обл. Ковельський р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864065748694</ram:ID>
                                             <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                             </ram:ConsigneeTradeParty>
                             <ram:CarrierTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
                                     <ram:Name>Мій Перевізник</ram:Name>
                                     <ram:RoleCode>CA</ram:RoleCode>
                                     <ram:DefinedTradeContact>
                                             <ram:PersonName>Мій водій</ram:PersonName>
                                             <ram:TelephoneUniversalCommunication>
                                                     <ram:CompleteNumber>380759876087</ram:CompleteNumber>
                                             </ram:TelephoneUniversalCommunication>
                                     </ram:DefinedTradeContact>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>734532</ram:PostcodeCode>
                                             <ram:StreetName>б. 77, вул. Вічна</ram:StreetName>
                                             <ram:CityName>м. Вінниця</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Вінницька обл. Вінницький р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedTaxRegistration>
                                             <ram:ID>3607902</ram:ID>
                                     </ram:SpecifiedTaxRegistration>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>DER453456</ram:ID>
                                     </ram:SpecifiedGovernmentRegistration>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864065748793</ram:ID>
                                             <ram:TypeCode>DRIVER_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864065748724</ram:ID>
                                             <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                             </ram:CarrierTradeParty>
                             <ram:NotifiedTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">43234323</ram:ID>
                                     <ram:Name>3674_test</ram:Name>
                                     <ram:RoleCode>OB</ram:RoleCode>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>468373</ram:PostcodeCode>
                                             <ram:StreetName>вул. МОлода, б.53</ram:StreetName>
                                             <ram:CityName>м. Житомир</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Житомирська обл., Житомирський р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedGovernmentRegistration></ram:SpecifiedGovernmentRegistration>
                             </ram:NotifiedTradeParty>
                             <ram:NotifiedTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">23462345</ram:ID>
                                     <ram:Name>Мій Експедитор</ram:Name>
                                     <ram:RoleCode>FW</ram:RoleCode>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>888888</ram:PostcodeCode>
                                             <ram:StreetName>Новий Ужгород</ram:StreetName>
                                             <ram:CityName>м. Ужгород</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Закарпатська обл. Ужгородський р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864065748823</ram:ID>
                                             <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                             </ram:NotifiedTradeParty>
                             <ram:NotifiedTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">23232178</ram:ID>
                                     <ram:Name>Мій WH</ram:Name>
                                     <ram:RoleCode>WD</ram:RoleCode>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>7728382</ram:PostcodeCode>
                                             <ram:StreetName>Моя Адреса</ram:StreetName>
                                             <ram:CityName>c. Хороша</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Вінницька обл. Вінницький р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864232613176</ram:ID>
                                             <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                             </ram:NotifiedTradeParty>
                             <ram:NotifiedTradeParty>
                                     <ram:ID schemeAgencyID="ЄДРПОУ">56523432</ram:ID>
                                     <ram:Name>Мій COP</ram:Name>
                                     <ram:RoleCode>COP</ram:RoleCode>
                                     <ram:PostalTradeAddress>
                                             <ram:PostcodeCode>46234523222</ram:PostcodeCode>
                                             <ram:StreetName>Моя Адреса</ram:StreetName>
                                             <ram:CityName>c. Непереможне</ram:CityName>
                                             <ram:CountryID>UA</ram:CountryID>
                                             <ram:CountrySubDivisionName>Дніпропетровська обл. Криворізький р-н</ram:CountrySubDivisionName>
                                     </ram:PostalTradeAddress>
                                     <ram:SpecifiedGovernmentRegistration>
                                             <ram:ID>9864232613183</ram:ID>
                                             <ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
                                     </ram:SpecifiedGovernmentRegistration>
                             </ram:NotifiedTradeParty>
                             <ram:CarrierAcceptanceLogisticsLocation>
                                     <ram:ID schemeAgencyID="КАТОТТГ">UA07060170160041154</ram:ID>
                                     <ram:Name>Володя Нова ГЛН</ram:Name>
                                     <ram:TypeCode>10</ram:TypeCode>
                                     <ram:Description>Україна, 456464, Волинська обл. Ковельський р-н, c. Річиця, вул. Атом, буд. 1</ram:Description>
                                     <ram:PhysicalGeographicalCoordinate>
                                             <ram:SystemID schemeAgencyID="GLN">9864065748076</ram:SystemID>
                                     </ram:PhysicalGeographicalCoordinate>
                             </ram:CarrierAcceptanceLogisticsLocation>
                             <ram:ConsigneeReceiptLogisticsLocation>
                                     <ram:ID schemeAgencyID="КАТОТТГ">UA07060170160041154</ram:ID>
                                     <ram:Name>Мій Одержувач</ram:Name>
                                     <ram:TypeCode>5</ram:TypeCode>
                                     <ram:Description>Україна, 734532, Волинська обл. Ковельський р-н, c. Річиця, б.145, вул. Зелена</ram:Description>
                                     <ram:PhysicalGeographicalCoordinate>
                                             <ram:SystemID schemeAgencyID="GLN">9864065748694</ram:SystemID>
                                     </ram:PhysicalGeographicalCoordinate>
                             </ram:ConsigneeReceiptLogisticsLocation>
                             <ram:DeliveryTransportEvent></ram:DeliveryTransportEvent>
                             <ram:PickUpTransportEvent>
                                     <ram:CertifyingTradeParty>
                                             <ram:ID schemeAgencyID="РНОКПП">111111111111</ram:ID>
                                             <ram:Name>Post</ram:Name>
                                             <ram:RoleCode>CZ</ram:RoleCode>
                                             <ram:DefinedTradeContact>
                                                     <ram:PersonName>Consignor</ram:PersonName>
                                                     <ram:MobileTelephoneUniversalCommunication>
                                                             <ram:CompleteNumber>380222222222</ram:CompleteNumber>
                                                     </ram:MobileTelephoneUniversalCommunication>
                                                     <ram:EmailURIUniversalCommunication>
                                                             <ram:CompleteNumber>consignor@edin.ua</ram:CompleteNumber>
                                                     </ram:EmailURIUniversalCommunication>
                                             </ram:DefinedTradeContact>
                                     </ram:CertifyingTradeParty>
                             </ram:PickUpTransportEvent>
                             <ram:IncludedSupplyChainConsignmentItem>
                                     <ram:SequenceNumeric>1</ram:SequenceNumeric>
                                     <ram:InvoiceAmount currencyID="UAH">4690</ram:InvoiceAmount>
                                     <ram:GrossWeightMeasure unitCode="KGM">555</ram:GrossWeightMeasure>
                                     <ram:TariffQuantity unitCode="UAH">3</ram:TariffQuantity>
                                     <ram:GlobalID schemeAgencyID="УКТЗЕД">234523</ram:GlobalID>
                                     <ram:NatureIdentificationTransportCargo>
                                             <ram:Identification>Name 1</ram:Identification>
                                     </ram:NatureIdentificationTransportCargo>
                                     <ram:ApplicableTransportDangerousGoods>
                                             <ram:UNDGIdentificationCode>234523</ram:UNDGIdentificationCode>
                                     </ram:ApplicableTransportDangerousGoods>
                                     <ram:AssociatedReferencedLogisticsTransportEquipment>
                                             <ram:ID>Номер контейнера</ram:ID>
                                     </ram:AssociatedReferencedLogisticsTransportEquipment>
                                     <ram:TransportLogisticsPackage>
                                             <ram:ItemQuantity>234</ram:ItemQuantity>
                                             <ram:TypeCode>CT</ram:TypeCode>
                                             <ram:Type>палета</ram:Type>
                                             <ram:PhysicalLogisticsShippingMarks>
                                                     <ram:Marking>Назва транспортної упаковки</ram:Marking>
                                                     <ram:BarcodeLogisticsLabel>
                                                             <ram:ID>34623345</ram:ID>
                                                     </ram:BarcodeLogisticsLabel>
                                             </ram:PhysicalLogisticsShippingMarks>
                                     </ram:TransportLogisticsPackage>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>VENDOR_CODE</ram:ContentCode>
                                             <ram:Content>6234</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>BUYER_CODE</ram:ContentCode>
                                             <ram:Content>452345</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>QUANTITY</ram:ContentCode>
                                             <ram:Content>2345</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>BASE_UOM</ram:ContentCode>
                                             <ram:Content>палета</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>PRICE_WITH_VAT</ram:ContentCode>
                                             <ram:Content>2</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>SUM_WITHOUT_VAT</ram:ContentCode>
                                             <ram:Content>7035</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>NET_WEIGHT</ram:ContentCode>
                                             <ram:Content>11</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>RETURN_TARE</ram:ContentCode>
                                             <ram:Content>Зворотня тара</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>RTP_TYPE</ram:ContentCode>
                                             <ram:Content>Тип транспортної упаковки</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>RTP_QUANTITY</ram:ContentCode>
                                             <ram:Content>42</ram:Content>
                                     </ram:ApplicableNote>
                             </ram:IncludedSupplyChainConsignmentItem>
                             <ram:UtilizedLogisticsTransportEquipment>
                                     <ram:ID>bb77767AB</ram:ID>
                                     <ram:SettingTransportSettingTemperature>
                                             <ram:MinimumValueMeasure unitCode="CEL">11</ram:MinimumValueMeasure>
                                             <ram:MaximumValueMeasure unitCode="CEL">22</ram:MaximumValueMeasure>
                                     </ram:SettingTransportSettingTemperature>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>BRAND</ram:ContentCode>
                                             <ram:Content>auto_from_act_brand</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>MODEL</ram:ContentCode>
                                             <ram:Content>auto_from_act_model</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>COLOR</ram:ContentCode>
                                             <ram:Content>black_color</ram:Content>
                                     </ram:ApplicableNote>
                                     <ram:ApplicableNote>
                                             <ram:ContentCode>TYPE</ram:ContentCode>
                                             <ram:Content>auto_from_act_type</ram:Content>
                                     </ram:ApplicableNote>
                             </ram:UtilizedLogisticsTransportEquipment>
                             <ram:DeliveryInstructions>
                                     <ram:Description>покілометровий тариф</ram:Description>
                                     <ram:DescriptionCode>TRANSPORTATION_TYPE</ram:DescriptionCode>
                             </ram:DeliveryInstructions>
                     </SpecifiedSupplyChainConsignment>
             </eCMR>
             <UaSignatureStorage>
                     <Signature>
                             <SigningPartyRoleCode>CZ</SigningPartyRoleCode>
                             <PartySignature>MIIhZQYJK...r8OD+8LBU5</PartySignature>
                             <Name>Іванов Іван Іванович</Name>
                             <Position>1</Position>
                             <SpecifiedTaxRegistration>
                                     <ram:ID>1234567890</ram:ID>
                             </SpecifiedTaxRegistration>
                     </Signature>
             </UaSignatureStorage>
     </UAECMR>
```

</details>##### **RESPONSE**

В тілі відповіді (json) передається `doc_uuid` - унікальний ідентифікатор документа на платформі:

```json
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}
```

# Видалити файл-вкладення з документа DELETE /api/eds/doc/ettn/ttn/attachment

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.6093%;">**URL**

</td><td style="width: 84.3907%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.6093%;">Метод запиту

</td><td style="width: 84.3907%;">DELETE

</td></tr><tr class="row-odd"><td style="width: 15.6093%;">URL запиту

</td><td style="width: 84.3907%;">/api/eds/doc/ettn/ttn/attachment

</td></tr><tr class="row-even"><td style="width: 15.6093%;">URL параметри

</td><td style="width: 84.3907%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**attach\_uuid** (обов’язково) - UUID; ідентифікатор вкладення

</td></tr><tr class="row-odd"><td style="width: 15.6093%;">**Headers**

</td><td style="width: 84.3907%;"> </td></tr><tr class="row-even"><td style="width: 15.6093%;">Authorization

</td><td style="width: 84.3907%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.6093%;">Content-Type

</td><td style="width: 84.3907%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Надіслати вкладення на повторну реєстрацію у разі виникнення помилки PATCH /api/eds/doc/ettn/ttn/attachment

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 16.0855%;"></col><col style="width: 83.9145%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/attachment?

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**attach\_uuid** (обов’язково) - UUID; ідентифікатор вкладення

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Отримати (завантажити) файл-вкладення до e-TTH GET /api/eds/doc/ettn/ttn/attachment

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 15.2548%;"></col><col style="width: 84.7452%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/attachment

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**type** (обов’язково) String - формат очікуваної відповіді; можливі варіанти:

- `<span class="pre">list</span>` - список UUID вкладень
- `<span class="pre">bytes</span>` - набір байтів; потребує зазначення параметра **attach\_uuid**
- `<span class="pre">file</span>` - файл; потребує зазначення параметра **attach\_uuid**

**attach\_uuid** (опціонально/обов’язково) - UUID; ідентифікатор вкладення. Параметр є обов’язковим при **type** = `<span class="pre">file</span>` / `<span class="pre">bytes</span>`

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповіді передається вкладення до документа сервісу «е-ТТН»:

- у вигляді набору байтів — якщо `type=bytes`;
- у вигляді файлу — якщо `type=file`;
- у форматі JSON (масив [об’єкта XDocAttachment](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdocattachment)) — якщо `type=list`.

# Додавання вкладення (pdf) до e-TTH POST /api/eds/doc/ettn/ttn/attachment

<p class="callout info">Вкладення може бути лише в pdf форматі!</p>

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.6093%;">**URL**

</td><td style="width: 84.3907%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.6093%;">Метод запиту

</td><td style="width: 84.3907%;">POST

</td></tr><tr class="row-odd"><td style="width: 15.6093%;">URL запиту

</td><td style="width: 84.3907%;">/api/eds/doc/ettn/ttn/attachment

</td></tr><tr class="row-even"><td style="width: 15.6093%;">URL параметри

</td><td style="width: 84.3907%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**type** (обов’язково) String - тип вкладення (число 1-25) з довідника [DICT.01.10](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/chapter/dovidniki-ettn-v3)

</td></tr><tr class="row-odd"><td style="width: 15.6093%;">**Headers**

</td><td style="width: 84.3907%;"> </td></tr><tr class="row-even"><td style="width: 15.6093%;">Authorization

</td><td style="width: 84.3907%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.6093%;">Content-Type

</td><td style="width: 84.3907%;">[multipart/form-data](https://tools.ietf.org/html/rfc7578)

</td></tr><tr class="row-even"><td style="width: 15.6093%;">**REQUEST**

</td><td style="width: 84.3907%;"> </td></tr><tr class="row-odd"><td style="width: 15.6093%;">Form-data

</td><td style="width: 84.3907%;">В тілі запиту передається pdf файл (доступна можливість обробки файла в BASE64 форматі).

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Відхилення e-TTH PUT /api/eds/doc/ettn/ttn/reject

Відхилення документа може здійснюватися:

- **Вантажовідправником** — після реєстрації своєї транзакції, але до моменту реєстрації транзакції від Водія/Перевізника;
- **Перевізником або Водієм** — до реєстрації власної транзакції.

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 15.7283%;"></col><col style="width: 84.2717%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>PUT

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/reject

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**rejected\_by** (обов’язково) String - ПІБ співробітника

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>В тілі запиту методу (в json форматі) передається причина відхилення документа в текстовому вигляді.

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Надсилання нової транзакції до e-TTH документа PUT /api/eds/doc/ettn/ttn/transaction

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.9727%;">**URL**

</td><td style="width: 84.0273%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.9727%;">Метод запиту

</td><td style="width: 84.0273%;">PUT

</td></tr><tr class="row-odd"><td style="width: 15.9727%;">URL запиту

</td><td style="width: 84.0273%;">/api/eds/doc/ettn/ttn/transaction

</td></tr><tr class="row-even"><td style="width: 15.9727%;">URL параметри

</td><td style="width: 84.0273%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**role\_code** (опціонально) String - код ролі учасника документообігу, що відправляє транзакцію (за замовчуванням визначається автоматично). Використовується у випадку, коли кілька ролей-учасників мають однаковий GLN і роль *за замовчуванням* (згідно з життєвим циклом документа) для виконання обробки документа не підходить. Допустимі значення:

- CZ - Вантажовідправник
- DR - Водій
- CA - Перевізник
- CN - Вантажоодержувач
- FW - Експедитор
- OB - Замовник

**update\_doc\_state** (опціонально) boolean - true за замовчуванням; значення false використовується для внесення учасником змін в уже відправлену транзакцію (коригування) без зміни статусу документообігу (sub\_status\_id). Якщо передати update\_doc\_state=false, то транзакція відправиться без зміни статусу е-ТТН.

</td></tr><tr class="row-odd"><td style="width: 15.9727%;">**Headers**

</td><td style="width: 84.0273%;"> </td></tr><tr class="row-even"><td style="width: 15.9727%;">Authorization

</td><td style="width: 84.0273%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.9727%;">Content-Type

</td><td style="width: 84.0273%;">application/json або application/xml

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Створення/редагування нової транзакції (чернетки) до e-TTH документа POST /api/eds/doc/ettn/ttn/transaction

<p class="callout warning">При повторному виклику методу з тими ж URL-параметрами вкладений контент буде перезаписано (відредаговано).</p>

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.2547%;">**URL**

</td><td style="width: 84.7453%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.2547%;">Метод запиту

</td><td style="width: 84.7453%;">POST

</td></tr><tr class="row-odd"><td style="width: 15.2547%;">URL запиту

</td><td style="width: 84.7453%;">/api/eds/doc/ettn/ttn/transaction

</td></tr><tr class="row-even"><td style="width: 15.2547%;">URL параметри

</td><td style="width: 84.7453%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

</td></tr><tr class="row-odd"><td style="width: 15.2547%;">**Headers**

</td><td style="width: 84.7453%;"> </td></tr><tr class="row-even"><td style="width: 15.2547%;">Authorization

</td><td style="width: 84.7453%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.2547%;">Content-Type

</td><td style="width: 84.7453%;">application/json або application/xml

</td></tr><tr class="row-even"><td style="width: 15.2547%;">**REQUEST**

</td><td style="width: 84.7453%;"> </td></tr><tr class="row-odd"><td style="width: 15.2547%;">JSON Body

</td><td style="width: 84.7453%;">В тілі запиту методу (в json форматі) передається транзакція - контент документа без підписів ([об’єкт Ecmr](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-ecmr))

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

<p class="callout info">Після виконання методу, але до надсилання транзакції, результат отримання документа в сервісі відрізнятиметься для інших контрагентів.</p>

# Надсилання e-TTH з Чернеток PATCH /api/eds/doc/ettn/ttn/send

- Надсилання можливе лише для підписаного документа.
- Цим методом відправляється тільки новий документ.
- Подальші доповнення чи зміни до документа, а також їх надсилання, здійснюються за допомогою методів: `/api/ettn/eds/ecmr/transaction`.

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 16.3169%;"></col><col style="width: 83.6831%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/ettn/ttn/send

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**branch\_uuid** (опціонально) UUID - ідентифікатор «гілки постачання» (для мережі АТБ). Використовується для об’єднання документів одного постачання (ланцюжок документів з «Повідомленням про відвантаження» (DESADV)). Якщо в запиті параметр branch\_uuid не передається, то значення цього параметра автоматично формується платформою EDI Network на підставі даних з [тіла документа е-ТТН](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/elektronna-tovarno-transportna-nakladna-e-ttn):

- <dl class="simple"><dt>AssociatedReferencedDocument.TypeCode=220</dt><dd>
    - AssociatedReferencedDocument.ID &lt;== Номер документа з ORDER.NUMBER
    - AssociatedReferencedDocument.FormattedIssueDateTime.DateTimeString &lt;== Дата документа з ORDER.DATE
    
    </dd></dl>
- <dl class="simple"><dt>AssociatedReferencedDocument.TypeCode=351</dt><dd>
    - AssociatedReferencedDocument.ID &lt;== Номер документа з DESADV.NUMBER
    - AssociatedReferencedDocument.FormattedIssueDateTime.DateTimeString &lt;== Дата документа з DESADV.DATE
    
    </dd></dl>

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Створення/редагування чернетки e-TTH

Вибір дії (створення чи редагування):

- якщо в URL запиту передано ідентифікатор документа (**doc\_uuid**), то буде виконано редагування документа сервісу «ETTN» з цим Id;
- якщо параметр **doc\_uuid** відсутній, то буде створено новий документ.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 17.7612%;">**URL**

</td><td style="width: 82.2388%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 17.7612%;">Метод запиту

</td><td style="width: 82.2388%;">POST

</td></tr><tr class="row-odd"><td style="width: 17.7612%;">URL запиту

</td><td style="width: 82.2388%;">/api/eds/doc/ettn/ttn

</td></tr><tr class="row-even"><td style="width: 17.7612%;">URL параметри

</td><td style="width: 82.2388%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеної чернетки)

**template\_doc\_uuid** (опціонально) UUID - ідентифікатор «Попередньої e-ТТН». При передаванні цього параметра створювана чернетка e-ТТН наповнюється даними з документа-підстави («Попередньої e-ТТН»), тому тіло в запиті не передається

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

**fill\_up** (опціонально) boolean - false за замовчуванням; при fill\_up = true виконується перевірка тіла e-ТТН та автоматичне наповнення його даними (по Компанії, Водію, Транспорту, Пунктам Навантаження/Розвантаження) з довідників, автоматичний розрахунок Загальної ваги;

**full\_validate** (опціонально) boolean - true за замовчуванням. Незалежно від параметра full\_validate документ проходить повну перевірку (всі обов’язкові поля та XSD), якщо ця перевірка успішна - то в extrafield проставляється ready\_for\_sign параметр

- Якщо full\_validate = false - то у відповіді повертається помилка лише по полях які необхідні для збереження документа;
- Якщо full\_validate = true - то у відповіді повертається помилка по всім обов’язковим полям та xsd валідації.

</td></tr><tr class="row-odd"><td style="width: 17.7612%;">**Headers**

</td><td style="width: 82.2388%;"> </td></tr><tr class="row-even"><td style="width: 17.7612%;">Authorization

</td><td style="width: 82.2388%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 17.7612%;">Content-Type

</td><td style="width: 82.2388%;">application/json or application/xml

</td></tr><tr class="row-even"><td style="width: 17.7612%;">**REQUEST**

</td><td style="width: 82.2388%;"> </td></tr><tr class="row-odd"><td style="width: 17.7612%;">JSON Body

</td><td style="width: 82.2388%;">В тілі запиту методу передається документ [e-ТТН в json чи xml](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/elektronna-tovarno-transportna-nakladna-e-ttn) форматі

<p class="callout info">Тіло відсутнє при передачі template\_doc\_uuid параметра!</p>

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді (json) передається **doc\_uuid** - унікальний ідентифікатор документа на платформі:

```json
{doc_uuid:"e3dbf6e8-029e-4c3b-804b-9b2741d9f37d"}
```

# Видалення чернетки транзакції DELETE /api/eds/doc/ettn/draft_ticket

Метод призначений для видалення чернетки транзакції, створеної з помилками, до документа.

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 98.2143%;"><tbody><tr class="row-odd"><td style="width: 16.8622%;">**URL**

</td><td style="width: 83.1378%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 16.8622%;">Метод запиту

</td><td style="width: 83.1378%;">DELETE

</td></tr><tr class="row-odd"><td style="width: 16.8622%;">URL запиту

</td><td style="width: 83.1378%;">/api/eds/doc/ettn/draft\_ticket

</td></tr><tr class="row-even"><td style="width: 16.8622%;">URL параметри

</td><td style="width: 83.1378%;">**gln** (обов’язково) String - GLN власної Компанії

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа, до якого створено чернетку

</td></tr><tr class="row-odd"><td style="width: 16.8622%;">**Headers**

</td><td style="width: 83.1378%;"> </td></tr><tr class="row-even"><td style="width: 16.8622%;">Authorization

</td><td style="width: 83.1378%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 16.8622%;">Content-Type

</td><td style="width: 83.1378%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Створення нового транспортного засобу в довіднику POST /api/oas/v2/transport

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 105.119%;"><colgroup><col style="width: 17.1657%;"></col><col style="width: 82.8343%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>**/api/oas/v2/transport**

</td></tr><tr class="row-even"><td>**Headers**

</td><td> </td></tr><tr class="row-odd"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-even"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-odd"><td>**REQUEST**

</td><td> </td></tr><tr class="row-even"><td>JSON Body

</td><td>В тілі запиту методу (в json форматі) передаються дані нового транспортного засобу ([об'єкт Transport)](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-transport).

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Пошук транспортного засобу у власному довіднику транспортних засобів GET /api/oas/v2/transport

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 17.0346%;">**URL**

</td><td style="width: 82.9654%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 17.0346%;">Метод запиту

</td><td style="width: 82.9654%;">GET

</td></tr><tr class="row-odd"><td style="width: 17.0346%;">URL запиту

</td><td style="width: 82.9654%;">/api/oas/v2/transport

</td></tr><tr class="row-even"><td style="width: 17.0346%;">URL параметри

</td><td style="width: 82.9654%;">**transport\_number** (обов’язково) String - номер транспортного засобу (у літеро сполученні допускається лише латинниця) від 4 символів. Так номер **AA0001AA** користувач може знайти за `<span class="pre">AA00,</span> <span class="pre">0001,</span> <span class="pre">01AA,</span> <span class="pre">...</span>`

</td></tr><tr class="row-odd"><td style="width: 17.0346%;">**Headers**

</td><td style="width: 82.9654%;"> </td></tr><tr class="row-even"><td style="width: 17.0346%;">Authorization

</td><td style="width: 82.9654%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 17.0346%;">Content-Type

</td><td style="width: 82.9654%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповіді з довідника передаються дані знайдених транспортних засобів (масив [об'єкта Transport)](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-transport).

# Видалити документи-чернетки PATCH /api/eds/docs

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 17.3923%;">**URL**

</td><td style="width: 82.6077%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 17.3923%;">Метод запиту

</td><td style="width: 82.6077%;">PATCH

</td></tr><tr class="row-odd"><td style="width: 17.3923%;">URL запиту

</td><td style="width: 82.6077%;">/api/eds/docs

</td></tr><tr class="row-even"><td style="width: 17.3923%;">URL параметри

</td><td style="width: 82.6077%;">**gln** (обов’язково) String - GLN власної Компанії;

**family** (опціонально) UUID - сервіс/сімейство документів; можливі значення: edi

**detailed\_response** (опціонально) boolean - false за замовчуванням; при detailed\_response = true, то у відповідь повернеться додатково статус видалення по кожному документу (success/failed)

</td></tr><tr class="row-odd"><td style="width: 17.3923%;">**Headers**

</td><td style="width: 82.6077%;"> </td></tr><tr class="row-even"><td style="width: 17.3923%;">Authorization

</td><td style="width: 82.6077%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 17.3923%;">Content-Type

</td><td style="width: 82.6077%;">application/json

</td></tr><tr class="row-even"><td style="width: 17.3923%;">**REQUEST**

</td><td style="width: 82.6077%;"> </td></tr><tr class="row-odd"><td style="width: 17.3923%;">JSON Body

</td><td style="width: 82.6077%;">В тілі запиту методу передається масив ідентифікаторів документів-чернеток до видалення, наприклад: `<span class="pre">[«345b68bb-552b-4d0e-8091-a5991f16250c»,«a751981c-1abf-4268-afac-c2389948fe54»]</span>`

</td></tr></tbody></table>

##### **RESPONSE**

Код сервера 200 (ok).

# Отримання інформації про підписантів е-ТТН та Актів v3 (family=7) GET /api/eds/doc/ettn/sign/info

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 111.548%;"><tbody><tr class="row-odd"><td style="width: 18.8372%;">**URL**

</td><td style="width: 81.1628%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 18.8372%;">Метод запиту

</td><td style="width: 81.1628%;">GET

</td></tr><tr class="row-odd"><td style="width: 18.8372%;">URL запиту

</td><td style="width: 81.1628%;">/api/eds/doc/ettn/sign/info

</td></tr><tr class="row-even"><td style="width: 18.8372%;">URL параметри

</td><td style="width: 81.1628%;">**gln** (обов’язково) String - GLN власної Компанії

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

</td></tr><tr class="row-odd"><td style="width: 18.8372%;">**Headers**

</td><td style="width: 81.1628%;"> </td></tr><tr class="row-even"><td style="width: 18.8372%;">Authorization

</td><td style="width: 81.1628%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 18.8372%;">Content-Type

</td><td style="width: 81.1628%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді передається інформація про підписантів (об’єкт [SignsPackageV2](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-signspackagev2)).

# Отримання інформації (мета-даних) про документ GET /api/eds/doc

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 16.4487%;"></col><col style="width: 83.5513%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** - рядок; унікальний ідентифікатор організації в системі

**doc\_uuid** - рядок; UUID документа

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповідь передаються дані вказаного документа (об'єкт [XDoc](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdoc)).

# Отримання всіх квитанцій вказаного документа GET /api/eds/doc/tickets

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 15.963%;"></col><col style="width: 84.037%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua</td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/eds/doc/tickets

</td></tr><tr class="row-even"><td>URL параметри

</td><td>**gln** (обов’язково) - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** (обов’язково) - рядок; унікальний ідентифікатор організації в системі

**doc\_uuid** (обов’язково) - рядок; UUID документа

**loadBody** (опціонально) - отримати квитанції разом з їх тілами; можливі значення: loadBody

**type** (опціонально) - тип отримання даних; можливі значення: zip - у вигляді архіву (при цьому обов’язково вказується назва архіву - параметр file\_name)

**file\_name** - назва архіву (вказується при наявності параметра type)

**family** (опціонально) - сімейство; можливі значення: edi

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json or application/zip

</td></tr></tbody></table>

##### **RESPONSE**

В тілі відповіді залежно від наявності параметра type передається масив [об’єкта XTicket](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xticket) (квитанції вказаного документа) в json форматі чи у вигляді zip-архіву.

# Підписання даних сервісу (збереження підпису) POST /api/eds/doc/ettn/sign

<p class="callout warning">Формат підпису повинен відповідати стандарту CAdES-X Long (детальніше — у [специфікації](https://uakey.com.ua/news/main/cades-x-long-format-dlja-dovgotrivalogo-zbergannja-kep))</p>

> **Підписання в сервісі «ЕТТН» можна здійснювати двома способами:**
> 
> 1. <span style="background-color: rgb(255, 255, 255);">**Через ECMR тіло документа**</span>
>     
>     
>     - [Отримати тіло документа сервісу «ЕТТН» у форматі ECMR](https://wiki-v2.edin.ua/books/robota-z-api/page/zavantazennia-tila-dokumenta-u-formati-jsonxmlecmrpdfzip-get-apiedsdocettnbody)
>     - Підписати отримане ECMR тіло (результат — p7s-файл підпису)
>     - Конвертувати p7s у base64 — цей результат передається у масиві тіла запиту
> 2. <span style="background-color: rgb(255, 255, 255);">**Через sign\_hash (extra\_fields)**</span>
>     
>     
>     - [Отримати `sign_hash` (extra\_fields) документа сервісу «ЕТТН»](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-informaciyi-meta-danix-pro-dokument-get-apiedsdoc)
>     - Підписати значення `sign_hash` (результат — p7s-файл підпису)
>     - Конвертувати p7s у base64 — цей результат передається у масиві тіла запиту

<p class="callout info">Перепідписання документа (оновлення підпису повторним викликом методу) дозволяється лише до моменту відправки документа контрагенту.</p>

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.0759%;">**URL**

</td><td style="width: 84.9241%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.0759%;">Метод запиту

</td><td style="width: 84.9241%;">POST

</td></tr><tr class="row-odd"><td style="width: 15.0759%;">URL запиту

</td><td style="width: 84.9241%;">/api/eds/doc/ettn/sign

</td></tr><tr class="row-even"><td style="width: 15.0759%;">URL параметри

</td><td style="width: 84.9241%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**role\_code** (обов’язково) String - код ролі учасника-підписанта:

- CZ - Вантажовідправник;
- CN - Вантажоодержувач;
- DR - Водій;
- CA - Перевізник;
- OB - Замовник;
- WD - Проміжний склад, що приймає вантаж;
- WH - Проміжний склад, що здає вантаж;
- <dl class="simple"><dt>Для **Акта перевантаження**:</dt><dd>
    - CA - Водій / Перевізник, що здає вантаж;
    - OV - Перевізник, що здає вантаж;
    - DR - Водій, що приймає вантаж;
    - CH - Водій / Перевізник, що приймає вантаж
    
    </dd></dl>

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

</td></tr><tr class="row-odd"><td style="width: 15.0759%;">**Headers**

</td><td style="width: 84.9241%;"> </td></tr><tr class="row-even"><td style="width: 15.0759%;">Authorization

</td><td style="width: 84.9241%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.0759%;">**REQUEST**

</td><td style="width: 84.9241%;"> </td></tr><tr class="row-even"><td style="width: 15.0759%;">JSON Body

</td><td style="width: 84.9241%;">В тілі запиту методу передається масив файлів підпису p7s в base64 форматі.

</td></tr></tbody></table>

**Приклад тіла запиту:**

```json
["ZGZkZmRmZGZkZmRmdnh2dmM==", "ZGZkZmRmZGZkZmRmdnh2dmM=="]
```

##### **RESPONSE**

Код сервера 200 (ok).

# Завантаження тіла документа у форматі JSON/XML/ECMR/PDF/ZIP GET /api/eds/doc/ettn/body

Метод використовується для всіх оновлених документів сервісу «e-ТТН»

##### **REQUEST**

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><tbody><tr class="row-odd"><td style="width: 15.7296%;">**URL**

</td><td style="width: 84.2704%;">https://edo-v2.edin.ua</td></tr><tr class="row-even"><td style="width: 15.7296%;">Метод запиту

</td><td style="width: 84.2704%;">GET

</td></tr><tr class="row-odd"><td style="width: 15.7296%;">URL запиту

</td><td style="width: 84.2704%;">/api/eds/doc/ettn/body

</td></tr><tr class="row-even"><td style="width: 15.7296%;">URL параметри

</td><td style="width: 84.2704%;">**gln** (обов’язково) String - GLN власної Компанії АБО **guid** (обов’язково) String - унікальний ідентифікатор власної організації на платформі

**doc\_uuid** (обов’язково) UUID - ідентифікатор документа

**response\_type** (опціонально) String - тип формату, в якому будуть передаватись дані (для зручності подальшого опрацювання); можливі варіанти:

- `<span class="pre">bytes</span>` (за замовчуванням)
- `<span class="pre">file</span>`
- `<span class="pre">base64</span>`

**file\_name** (опціонально) - String; назва файлу для завантаження. Якщо вказано, то при **response\_type** = `<span class="pre">file</span>` повернеться файл з заданим значенням file\_name. За замовчуванням назва файлу формується згідно зі структурою: *ttn\_\[UUID ТТН\].xml/pdf/json/ecmr/zip*

**format** (опціонально) - String; формат файлу для отримання/завантаження (якщо не вказано - ZIP); можливі варіанти:

- `<span class="pre">pdf</span>` - отримання документа в PDF форматі;
- `<span class="pre">xml</span>` - отримання документа в XML форматі;
- `<span class="pre">json</span>` - отримання документа в JSON форматі (за замовчуванням);
- `<span class="pre">ecmr</span>` - отримання ECMR документа;
- `<span class="pre">zip</span>` - архів, який містить XML та PDF файли;
- `<span class="pre">ttn_package</span>` - отримати zip-архів е-ТТН разом з усіма пов’язаними Актами (архів з XML). Параметр застосовується лише до е-ТТН (в doc\_uuid) з позитивно закінченим життєвим циклом (Вантажоодержувач підписав ТТН)
- `<span class="pre">czo_package</span>` - отримати zip-архів е-ТТН з усіма транзакціями для подальшої перевірки на ЦЗО ([https://czo.gov.ua/verify](https://czo.gov.ua/verify))

</td></tr><tr class="row-odd"><td style="width: 15.7296%;">**Headers**

</td><td style="width: 84.2704%;"> </td></tr><tr class="row-even"><td style="width: 15.7296%;">Authorization

</td><td style="width: 84.2704%;">SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td style="width: 15.7296%;">Content-Type

</td><td style="width: 84.2704%;">application/json

</td></tr></tbody></table>

##### **RESPONSE**

У тілі відповідь передається документ сервісу «e-ТТН» в визначеному запитом форматі ([Специфікації документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/chapter/specifikaciyi-dokumentiv-servisu-e-ttn-v3)).

# Алгоритм «Акта про відмову вантажити» (LoadRejectAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col></col><col></col><col></col><col></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт про відмову вантажити**</td></tr><tr><td>  
</td><td class="align-center">Вантажовідправник CZ</td><td>  
</td><td class="align-center">Не потребує реєстрації транзакцій до ТТН</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 106.548%;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 37.1885%;"></col><col style="width: 62.8115%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td></tr><tr><td colspan="2">**Акт про відмову вантажити  
</td></tr><tr><td class="align-center">-</td><td class="align-center">-</td></tr></tbody></table>

# Алгоритм «Акт завантаження на проміжному складі» (StoragePickUpAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col></col><col></col><col></col><col></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт завантаження на проміжному складі**</td></tr><tr><td class="align-center">+</td><td class="align-center">Проміжний склад WD</td><td class="align-center">+</td><td class="align-center">Перевізник CA (новий) або Водій DR (новий)</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 104.524%;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 42.4516%;"></col><col style="width: 57.5484%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td></tr><tr><td colspan="2">**Акт завантаження на проміжному складі**</td></tr><tr><td class="align-left">1. В тіло ТТН додається новий Перевізник та новий Водій в `NotifiedTradeParty` з роллю `CH`
2. UaSignatureStorage - підпис Проміжного складу WD

</td><td style="text-align: justify;">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт завантаження на проміжному складі"
    - `AssociatedReferencedDocument.ID` = номер акту завантаження
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту завантаження
2. В тілі ТТН новий Перевізник та новий Водій переносяться з `NotifiedTradeParty` з роллю `CH` в `CarrierTradeParty` з роллю `CA`
3. В тілі ТТН заміються старі дані по всім транспортним засобам на нові дані по всім транспортним засобам
4. В тіло ТТН додається новий Водій в `PickUpTransportEvent - CertifyingTradeParty` з роллю `DR` (в блоці будуть тільки унікальні водії за `ID`)
5. UaSignatureStorage - підпис Перевізника CA або Водія DR

</td></tr></tbody></table>

# Алгоритм «Акт перевантаження» (ReloadAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col></col><col></col><col></col><col></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт перевантаження**</td></tr><tr><td class="align-center">+</td><td class="align-center">Перевізник CA (поточний) або Водій DR (поточний)</td><td class="align-center">+</td><td class="align-center">Перевізник CA (новий) або Водій DR (новий)</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 100%;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 39.4541%;"></col><col style="width: 60.5459%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td></tr><tr><td colspan="2">**Акт перевантаження**</td></tr><tr><td class="align-center">У разі заміни Перевізника та/або Водія:

1. В тіло ТТН додається поточний/новий Перевізник та поточний/новий Водій в `NotifiedTradeParty` з роллю `CH`
2. UaSignatureStorage - підпис поточного Перевізника CA або поточного Водія DR

</td><td class="align-left"><span style="text-decoration: underline;">Позитивне</span> завершення ЖЦ Акту:

1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт перевантаження"
    - `AssociatedReferencedDocument.ID` = номер акту перевантаження
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акта перевантаження
2. В тілі ТТН попередній Перевізник та попередній Водій переносяться з `CarrierTradeParty` з роллю `CA` в `NotifiedTradeParty` з роллю `CJ`
3. В тілі ТТН новий Перевізник та новий Водій переносяться з `NotifiedTradeParty` з роллю `CH` в `CarrierTradeParty` з роллю `CA`
4. В тілі ТТН заміються старі дані по всім транспортним засобам на нові дані по всім транспортним засобам
5. В тіло ТТН додається новий Водій в `PickUpTransportEvent - CertifyingTradeParty` з роллю `DR` (в блоці будуть тільки унікальні водії за `ID`)
6. UaSignatureStorage - підпис нового Перевізника CA або нового Водія DR

<span style="text-decoration: underline;">Негативне</span> завершення ЖЦ Акту (відхилено Перевізником або Водієм):

1. В тілі ТТН новий Перевізник та новий Водій переносяться з `NotifiedTradeParty` з роллю `CH` в `NotifiedTradeParty` з роллю `CJ`

</td></tr></tbody></table>

# Алгоритми «Акт про заміну пункту призначення вантажу» (ConsigneeChangeAct)

<table border="1" id="bkmrk-%D0%94%D0%BE%D0%B4.-%D1%82%D1%80%D0%B0%D0%BD%D0%B7%D0%B0%D0%BA%D1%86%D1%96%D1%97-%28%D0%BA%D0%BE%D0%BB"><caption>**Дод. транзакції (коли формуються та ким реєструються)**</caption><colgroup><col></col><col></col><col></col><col></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Хто виступає ініціатором Акта (ролі вказані з ТТН)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td><td class="align-center">**Хто реєструє транзакцію ТТН по завершенню ЖЦ Акта (ролі вказані з ТТН)**</td></tr><tr><td colspan="4">**Акт про заміну пункту призначення вантажу**</td></tr><tr><td>  
</td><td class="align-center">Вантажоодержувач CN, Вантажовідправник CZ, Замовник OB, Перевізник CA або Водій DR</td><td class="align-center">+</td><td class="align-center">Замовник ОВ</td></tr></tbody></table>

<table border="1" id="bkmrk-%D0%97%D0%BC%D1%96%D0%BD%D0%B8%2C-%D1%8F%D0%BA%D1%96-%D0%B2%D0%BD%D0%BE%D1%81%D1%8F%D1%82%D1%8C%D1%81%D1%8F" style="width: 101.429%;"><caption>**Зміни, які вносяться коригуючим Актом до ТТН**</caption><colgroup><col style="width: 34.6824%;"></col><col style="width: 65.3176%;"></col></colgroup><tbody><tr><td class="align-center">**Реєструється до початку ЖЦ Акту (завжди ініціатором акта)**</td><td class="align-center">**Реєструється після завершення ЖЦ Акту**</td></tr><tr><td colspan="2">**Акт про заміну пункту призначення вантажу**</td></tr><tr><td class="align-center">-</td><td class="align-center">1. В тіло ТТН додається коригуючий акт: 
    - `AssociatedReferencedDocument.Remarks (TypeCode = 916)` = "Акт про заміну пункту призначення вантажу"
    - `AssociatedReferencedDocument.ID` = номер акту про заміну пункту призначення вантажу
    - `AssociatedReferencedDocument.FormattedIssueDateTime` = дата акту про заміну пункту призначення вантажу
2. В тілі ТТН попередній вантажоодержувач переноситься з `ConsigneeTradeParty` з роллю `CN` в `NotifiedTradeParty` з роллю `CJ`
3. В тілі ТТН новий вантажоодержувач та пункт розвантаження додаються у відповідні блоки: 
    - `ConsigneeTradeParty` з роллю `CN`
    - `ConsigneeReceiptLogisticsLocation` (замість старих даних пункту розвантаження)
4. UaSignatureStorage - підпис Замовника OB

</td></tr></tbody></table>

# Алгоритм «Рахунок (Логістика)» (COMDOC_040)



# Алгоритм «Акт наданих послуг (Логістика)» (COMDOC_037)