# API сервісу EDI Network

# Перелік методів API сервісу EDI Network

<p class="callout info">Всі запити нижче перерахованих API методів платформи EDIN 2.0 направляються на адресу: [https://edo-v2.edin.ua](https://edo-v2.edin.ua/)</p>

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

##### **Робота з документами**

<table id="bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B8-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%82-" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити чернетку документа / Клонувати відправлений документ (COMDOC)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/doc](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Відправити чернетку

</td><td style="width: 39.0848%; height: 35.2778px;">[PATCH /api/eds/doc/send](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити та відправити документ (без створення чернетки)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/create\_and\_send](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Пошук документів (з фільтрацією), вибір списку документів

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/docs/search](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-dokumentiv-z-filtracijeiu-vibir-spisku-dokumentiv-post-apiedsdocssearch)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Отримати інформацію (мета-дані) про документ

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-informaciiu-meta-dani-pro-dokument-get-apiedsdoc)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Отримати конкретний ланцюжок документів

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/chain](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-konkretnii-lanciuzok-dokumentiv-get-apiedschain)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Отримати ланцюжки вхідних документів

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/chains/search](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-lanciuzki-vxidnix-dokumentiv-post-apiedschainssearch)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Отримати контент документа

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/body](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Отримати XML контенту документа

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/xml](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-xml-kontent-dokumenta-get-apiedsdocxml)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Завантажити тіло документа/підпису

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/download](https://wiki-v2.edin.ua/books/robota-z-api/page/zavantaziti-tilo-dokumentapidpisu-get-apiedsdocdownload)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;"><span class="doc">Відправити статус документа</span>

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/statuses](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-status-dokumenta-post-apiedsdocstatuses)</td></tr><tr style="height: 36.4306px;"><td style="width: 60.8913%; height: 36.4306px;">Отримати статус документа

</td><td style="width: 39.0848%; height: 36.4306px;">[GET /api/eds/doc/statuses](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-status-dokumenta-get-apiedsdocstatuses)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.6806px;"><td style="width: 60.8913%; height: 33.6806px;"><span class="doc">Редагувати чернетку документа</span>

</td><td style="width: 39.0848%; height: 33.6806px;">[PUT /api/eds/doc](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-cernetku-dokumenta-put-apiedsdoc)</td></tr><tr style="height: 34.4306px;"><td style="width: 60.8913%; height: 34.4306px;">Заповнити індекси (додавання / оновлення полів екстрапараметрів)

</td><td style="width: 39.0848%; height: 34.4306px;">[PUT /api/eds/doc/extra\_fields](https://wiki-v2.edin.ua/books/robota-z-api/page/zapovniti-indeksi-dodavannia-onovlennia-poliv-ekstraparametriv-put-apiedsdocextra-fields)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.4306px;"><td style="width: 60.8913%; height: 33.4306px;">Архівувати / Розархівувати ланцюжок документів

</td><td style="width: 39.0848%; height: 33.4306px;">[PATCH /api/eds/chain/archive](https://wiki-v2.edin.ua/books/robota-z-api/page/arxivuvati-rozarxivuvati-lanciuzok-dokumentiv-patch-apiedschainarchive)</td></tr><tr style="height: 36.4306px;"><td style="width: 60.8913%; height: 36.4306px;">Отримати реєстр документів в xls форматі

</td><td style="width: 39.0848%; height: 36.4306px;">[GET /api/eds/doc/reports/doctype](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-rejestr-dokumentiv-v-xls-formati-get-apiedsdocreportsdoctype)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.4306px;"><td style="width: 60.8913%; height: 33.4306px;">Отримати інформацію про підпис/підписантів

</td><td style="width: 39.0848%; height: 33.4306px;">[GET /api/eds/doc/attachment/sign/info](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-informaciiu-pro-pidpispidpisantiv-get-apiedsdocattachmentsigninfo)</td></tr><tr style="height: 29.6806px;"><td style="width: 60.8913%; height: 29.6806px;">Видалити документи-чернетки

</td><td style="width: 39.0848%; height: 29.6806px;">[PATCH /api/eds/docs](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-dokumenti-cernetki-patch-apiedsdocs)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.6806px;"><td style="width: 60.8913%; height: 33.6806px;">Отримати тіло документів (json) за вказаними UUID

</td><td style="width: 39.0848%; height: 33.6806px;">[POST /api/v2/eds/doc/content](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-tilo-dokumentiv-json-za-vkazanimi-uuid-post-apiv2edsdoccontent)</td></tr><tr style="height: 46.4722px;"><td style="width: 60.8913%; height: 46.4722px;"><span class="doc">Відправити транзакції до «Резерву товару» PRDRSRVN (зміни в табличній частині)</span>

</td><td style="width: 39.0848%; height: 46.4722px;">[POST /api/eds/doc/prdrsrvn/transaction](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-tranzakciyi-do-rezervu-tovaru-prdrsrvn-zmini-v-tablicnii-castini-post-apiedsdocprdrsrvntransaction)</td></tr><tr style="background-color: rgb(236,240,241); height: 32.6806px;"><td style="width: 60.8913%; height: 32.6806px;"><span class="doc">Одночасне прийняття, підписання та відправка двох пов’язаних документів</span>

</td><td style="width: 39.0848%; height: 32.6806px;">[POST /api/eds/docs\_and\_tickets](https://wiki-v2.edin.ua/books/robota-z-api/page/odnocasne-priiniattia-pidpisannia-ta-vidpravka-dvox-poviazanix-dokumentiv-post-apiedsdocs-and-tickets)</td></tr><tr style="height: 33.4306px;"><td style="width: 60.8913%; height: 33.4306px;">Отримати статус документа

</td><td style="width: 39.0848%; height: 33.4306px;">[POST /api/v2/eds/docs/state](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-status-dokumenta-post-apiv2edsdocsstate)</td></tr><tr style="background-color: rgb(236,240,241);"><td style="width: 60.8913%;">Підписати документ за допомогою КНЕДП EDIN ID

</td><td style="width: 39.0848%;">[POST /api/eds/doc/edin\_id/sign](https://wiki-v2.edin.ua/books/robota-z-api/page/pidpisati-dokument-za-dopomogoiu-knedp-edin-id-post-apiedsdocedin-idsign)</td></tr></tbody></table>

##### **Робота з "Універсальним/неструктурованим документом" (CONDRA)**

<table id="bkmrk-1-%D0%97%D0%B0%D0%B2%D0%B0%D0%BD%D1%82%D0%B0%D0%B6%D0%B8%D1%82%D0%B8-%C2%AB%D0%9D%D0%B5%D1%81%D1%82%D1%80" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Завантажити «Неструктурований (універсальний) документ» (CONDRA) у вигляді архіву

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/condra/body](https://wiki-v2.edin.ua/books/robota-z-api/page/zavantaziti-nestrukturovanii-universalnii-dokument-condra-v-vigliadi-arxivu-get-apiedsdoccondrabody)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Відправити «Неструктурований (універсальний) документ» (CONDRA)

</td><td style="width: 39.0848%; height: 35.2778px;">[PATCH /api/eds/doc/condra/send](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-nestrukturovanii-universalnii-dokument-condra-patch-apiedsdoccondrasend)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити чернетку «Універсального/неструктурованого документа» (CONDRA)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/doc/condra/create](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-universalnogonestrukturovanogo-dokumenta-condra-post-apiv2edsdoccondracreate)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Створити і відправити «Універсальний/неструктурований документ» (CONDRA) без створення чернетки

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/doc/condra/create\_and\_send](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-i-vidpraviti-universalniinestrukturovanii-dokument-condra-bez-stvorennia-cernetki-post-apiv2edsdoccondracreate-and-send)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Додати файл-вкладення (для CONDRA)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/body](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-fail-vkladennia-dlia-condra-post-apiedsdocbody)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;"><span class="doc">Створити чернетку документа (для CONDRA)</span>

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-dlia-condra-post-apiedsdoc)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Отримати UUID (для CONDRA)

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/office/uuid](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-uuid-dlia-condra-get-apiofficeuuid)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Підписати файл (для CONDRA)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/body](https://wiki-v2.edin.ua/books/robota-z-api/page/pidpisati-fail-dlia-condra-post-apiedsdocbody)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Відхилити «Універсальний/неструктурований документ» (CONDRA). Створення квитанції №13

</td><td style="width: 39.0848%; height: 35.2778px;">[PATCH /api/v2/eds/condra/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/vidxiliti-dokument-condra-stvorennia-kvitanciyi-13-patch-apiv2edscondrareject)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Відкликати «Універсальний/неструктурований документ» (CONDRA). Створення квитанції №14

</td><td style="width: 39.0848%; height: 35.2778px;">[PATCH /api/v2/eds/condra/withdraw](https://wiki-v2.edin.ua/books/robota-z-api/page/vidklikati-dokument-condra-stvorennia-kvitanciyi-14-patch-apiv2edscondrawithdraw)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Прийняти «Універсальний/неструктурований документ» (CONDRA)

</td><td style="width: 39.0848%; height: 35.2778px;">[PATCH /api/v2/eds/condra/confirm/send](https://wiki-v2.edin.ua/books/robota-z-api/page/priiniati-dokument-condra-patch-apiv2edscondraconfirmsend)</td></tr></tbody></table>

##### **Робота з файлами (вкладення до документа)**

<table id="bkmrk-1-%D0%94%D0%BE%D0%B4%D0%B0%D1%82%D0%B8-%D1%84%D0%B0%D0%B9%D0%BB-%D0%B4%D0%BE-%D0%B4%D0%BE%D0%BA" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 61.0105%; height: 35.2778px;">Додати файл до документа-чернетки

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-fail-do-dokumenta-cernetki-post-apiedsdocattachment)</td></tr><tr style="height: 35.2778px;"><td style="width: 61.0105%; height: 35.2778px;">Отримати файл-вкладення

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-fail-vkladennia-get-apiedsdocattachment)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 61.0105%; height: 35.2778px;">Видалити файл-вкладення (чернетка)

</td><td style="width: 39.0848%; height: 35.2778px;">[DELETE /api/eds/doc/attachment](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-fail-vkladennia-cernetka-delete-apiedsdocattachment)</td></tr><tr style="height: 35.2778px;"><td style="width: 61.0105%; height: 35.2778px;">Роздрукувати вкладення документа

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/print](https://wiki-v2.edin.ua/books/robota-z-api/page/rozdrukuvati-vkladennia-dokumenta-get-apiedsdocprint)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 61.0105%; height: 35.2778px;">Додати підпис до вкладень документа-чернетки

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/attachment/sign](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-pidpis-do-vkladen-dokumenta-cernetki-post-apiedsdocattachmentsign)</td></tr><tr style="height: 35.2778px;"><td style="width: 61.0105%; height: 35.2778px;">Отримати хеш вкладення (контейнера) документа для підписання

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/attachment/sign/hash](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-xes-vkladennia-konteinera-dokumenta-dlia-pidpisannia-get-apiedsdocattachmentsignhash)</td></tr></tbody></table>

##### **Робота з квитанціями**

<table id="bkmrk-1-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D1%82%D0%B8-%D0%B2%D1%81%D1%96-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Отримати всі квитанції вказаного документа

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/tickets](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-vsi-kvitanciyi-vkazanogo-dokumenta-get-apiedsdoctickets)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Отримати інформацію про підписантів

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/signers](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-informaciiu-pro-pidpisantiv-get-apiedsdocsigners)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;"><span class="doc">Отримати інформацію про підписантів за всіма вказаними транзакціями документа</span>

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/v2/eds/doc/signers](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-informaciiu-pro-pidpisantiv-za-vsima-vkazanimi-tranzakciiami-dokumenta-get-apiv2edsdocsigners)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Отримати дані/контент квитанції

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/ticket/body](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-danikontent-kvitanciyi-get-apiedsdocticketbody)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;"><span class="doc">Створити на сервері квитанцію «Анулювання»</span>

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/v2/eds/doc/repeal](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-na-serveri-kvitanciiu-anuliuvannia-get-apiv2edsdocrepeal)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Створити на сервері квитанцію «Повідомлення про відмову від підписання документу» (COMDOC\_021) для COMDOC/TRANSPORTATIONORDER документів

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/v2/eds/comdoc/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-na-serveri-kvitanciiu-povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021-dlia-comdoctransportationorder-dokumentiv-get-apiv2edscomdocreject)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити на сервері квитанцію «Повідомлення про відмову від підписання документу» (COMDOC\_021)

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/v2/eds/doc/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-na-serveri-kvitanciiu-povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021-get-apiv2edsdocreject)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Створити квитанцію №1 (підпис чернетки)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/doc/ticket](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити квитанцію №2 (прийняття документа COMDOC)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/comdoc/accept](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Створити квитанцію №11 (запит на анулювання COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/doc/repeal](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити квитанцію №12 (прийняття запиту на анулювання COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/v2/eds/doc/repeal/accept](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr><tr style="height: 36.4306px;"><td style="width: 60.8913%; height: 36.4306px;">Створити квитанцію №13 (відхилення документа COMDOC/TRANSPORTATIONORDER)

</td><td style="width: 39.0848%; height: 36.4306px;">[POST /api/v2/eds/comdoc/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-13-vidxilennia-dokumenta-comdoctransportationorder-post-apiv2edscomdocreject)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.6806px;"><td style="width: 60.8913%; height: 33.6806px;">Створити квитанцію №14 (відкликати підписання документа COMDOC/TRANSPORTATIONORDER)

</td><td style="width: 39.0848%; height: 33.6806px;">[POST /api/v2/eds/comdoc/revoke](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edscomdocrevoke)</td></tr><tr style="height: 34.4306px;"><td style="width: 60.8913%; height: 34.4306px;"><span class="doc">Створити квитанцію №15 (відмова від анулювання COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER)</span>

</td><td style="width: 39.0848%; height: 34.4306px;">[POST /api/v2/eds/doc/repeal/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.4306px;"><td style="width: 60.8913%; height: 33.4306px;">Відправити відмову від підписання (створення квитанції №13)

</td><td style="width: 39.0848%; height: 33.4306px;">[POST /api/v2/eds/doc/reject](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="height: 36.4306px;"><td style="width: 60.8913%; height: 36.4306px;"><span class="doc">Створити на сервері квитанцію «Відкликання підписання документа» (COMDOC\_021)</span>

</td><td style="width: 39.0848%; height: 36.4306px;">[GET /api/v2/eds/doc/revoke](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-na-serveri-kvitanciiu-vidklikannia-pidpisannia-dokumenta-comdoc-021-get-apiv2edsdocrevoke)</td></tr><tr style="background-color: rgb(236,240,241); height: 33.4306px;"><td style="width: 60.8913%; height: 33.4306px;"><span class="doc">Створити квитанцію №14 (відкликати підписання документа COMDOC/TRANSPORTATIONORDER)</span>

</td><td style="width: 39.0848%; height: 33.4306px;">[POST /api/v2/eds/doc/revoke](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr></tbody></table>

##### **Робота з тегами**

<table id="bkmrk-1-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B8-%D0%BD%D0%BE%D0%B2%D0%B8%D0%B9-%D1%82%D0%B5%D0%B3" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити новий тег (мітку)

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/tags](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-novii-teg-mitku-post-apiedstags)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Отримати список тегів (міток)

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/tags](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-tegiv-mitok-get-apiedstags)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Редагувати тег

</td><td style="width: 39.0848%; height: 35.2778px;">[PUT /api/eds/tags](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-teg-put-apiedstags)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Видалити теги

</td><td style="width: 39.0848%; height: 35.2778px;">[DELETE /api/eds/tags](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-tegi-delete-apiedstags)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Прив'язати тег до документа

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/tags](https://wiki-v2.edin.ua/books/robota-z-api/page/priviazati-teg-do-dokumenta-post-apiedsdoctags)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Вилучити теги з документа

</td><td style="width: 39.0848%; height: 35.2778px;">[DELETE /api/eds/doc/tags](https://wiki-v2.edin.ua/books/robota-z-api/page/viluciti-tegi-z-dokumenta-delete-apiedsdoctags)</td></tr></tbody></table>

##### **Погодження**

<table id="bkmrk-1-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F-%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D1%96%D1%8E" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Створити сценарій погодження документів

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/approval/scenario](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-scenarii-pogodzennia-dokumentiv-post-apiedsdocapprovalscenario)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Отримати сценарій/-ії (на рівні GLN)

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/approval/scenario](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-scenarii-yi-na-rivni-gln-get-apiedsdocapprovalscenario)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Редагувати / видалити сценарій погодження документів

</td><td style="width: 39.0848%; height: 35.2778px;">[PUT /api/eds/doc/approval/scenario](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-vidaliti-scenarii-pogodzennia-dokumentiv-put-apiedsdocapprovalscenario)</td></tr><tr style="height: 35.2778px;"><td style="width: 60.8913%; height: 35.2778px;">Запуск документа на погодження / Зміна статуса кроку погодження

</td><td style="width: 39.0848%; height: 35.2778px;">[POST /api/eds/doc/approval/step](https://wiki-v2.edin.ua/books/robota-z-api/page/zapusk-dokumenta-na-pogodzennia-zmina-statusa-kroku-pogodzennia-post-apiedsdocapprovalstep)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 60.8913%; height: 35.2778px;">Отримати кроки погодження за документом

</td><td style="width: 39.0848%; height: 35.2778px;">[GET /api/eds/doc/approval/step](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kroki-pogodzennia-za-dokumentom-get-apiedsdocapprovalstep)</td></tr></tbody></table>

##### **Робота з подіями**

<div id="bkmrk-%D0%9E%D0%B1%D0%B8%D1%80%D0%B0%D1%94%D1%82%D0%B5-%D1%96%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%82"><div>1. Обираєте ідентифікатор документу, з якого Ви плануєте розпочати отримувати всі наступні події.
2. Надсилаєте запит на [отримання останнього ідентифікатора події за документом](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-ostanniu-podiiu-za-dokumentom-get-apiedsdocseventlast).
3. В отриманному у відповідь об'єкті **XEvent** зберігаєте значення параметра **id**.
4. Надсилаєте запит для [пошуку подій](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-podii-post-apiedsdocsevents). В об'єкті запиту **EventsStorageQuery**, в параметрі **fromId** вказуєте ідентифікатор події, який Ви отримали в пункті 3.
5. З отриманного у відповідь об'єкта **EventsStorageQueryResult** зберігаєте значення параметра **lastEventId** замість того, що зберегли в пункті 3.
6. Опрацьовуєте документи в **EventsStorageQueryResult**.
7. Якщо кількість значень в параметрі **items** об'єкта **EventsStorageQueryResult**:

- - дорівнює вказаному ліміту (limit) або рівне 100, то повторюйте операції з 4 по 7.
    - меньше вказаного ліміту (limit) або менше 100, то необхідно зробити паузу (1 хвилина) для подальшого виконання операцій з 4 по 7.

</div><div><table id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D1%82%D0%B8-%D0%BE%D1%81%D1%82%D0%B0%D0%BD%D0%BD%D1%8E-%D0%BF%D0%BE%D0%B4" style="width: 100%; height: 771.834px;"><tbody><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 58.7428%; height: 35.2778px;"><div><div>Отримати останню подію за документом</div></div></td><td style="width: 41.2334%; height: 35.2778px;">[GET /api/eds/docs/event/last](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-ostanniu-podiiu-za-dokumentom-get-apiedsdocseventlast)</td></tr><tr style="height: 35.2778px;"><td style="width: 58.7428%; height: 35.2778px;"><div><div>Отримати список подій</div></div></td><td style="width: 41.2334%; height: 35.2778px;">[GET /api/eds/docs/events](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-podii-get-apiedsdocsevents)</td></tr><tr style="height: 35.2778px; background-color: rgb(236,240,241);"><td style="width: 58.7428%; height: 35.2778px;"><div><div>Пошук подій</div></div></td><td style="width: 41.2334%; height: 35.2778px;">[POST /api/eds/docs/events](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-podii-post-apiedsdocsevents)</td></tr></tbody></table>

</div></div>

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

[![Basic_002.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/scaled-1680-/hOiPP0Qaziwm1FPg-basic-002.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/hOiPP0Qaziwm1FPg-basic-002.png)

##### **Алгоритм «Прайс-лист» (PRICAT)**

<details id="bkmrk-pricat-%E2%84%96-%D0%BA%D1%80%D0%BE%D0%BA%D1%83-%D0%9C%D0%95%D0%A0%D0%95%D0%96"><summary>PRICAT</summary>

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 355.2px;"><colgroup><col style="width: 11.0811%;"></col><col style="width: 88.8951%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**МЕРЕЖА**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">а)</td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc) <sup>extra</sup></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.3</td><td style="height: 29.6px;">[Відправка чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">б)</td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Відправка документа без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.2</td><td style="height: 29.6px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr></tbody></table>

---

\[extra\] - В алгоритмах з початковим створенням чернетки можливо організувати додаткову перевірку і редагування чернетки документа (за необхідності) іншими співробітниками Вашої компанії:

1. [Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)
2. [Знайти чернетки документів для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-dokumentiv-z-filtracijeiu-vibir-spisku-dokumentiv-post-apiedsdocssearch)
3. [Отримати тіло чернетки-документа для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)
4. [Редагувати чернетку документа](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-cernetku-dokumenta-put-apiedsdoc)
5. [Змінити індекси (оновлення полів екстрапараметрів)](https://wiki-v2.edin.ua/books/robota-z-api/page/zapovniti-indeksi-dodavannia-onovlennia-poliv-ekstraparametriv-put-apiedsdocextra-fields)

</details>##### **Алгоритм «Замовлення» (ORDER)**

<details id="bkmrk-order-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD%D0%B0%D0%BB%D0%B0%D1%88%D1%82"><summary>ORDER</summary>

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 355.2px;"><colgroup><col style="width: 11.0811%;"></col><col style="width: 88.8951%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**МЕРЕЖА**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">а)</td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc) <sup>extra</sup></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.3</td><td style="height: 29.6px;">[Відправка чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">б)</td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Відправка документа без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.2</td><td style="height: 29.6px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr></tbody></table>

---

\[extra\] - В алгоритмах з початковим створенням чернетки можливо організувати додаткову перевірку і редагування чернетки документа (за необхідності) іншими співробітниками Вашої компанії:

1. [Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)
2. [Знайти чернетки документів для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-dokumentiv-z-filtracijeiu-vibir-spisku-dokumentiv-post-apiedsdocssearch)
3. [Отримати тіло чернетки-документа для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)
4. [Редагувати чернетку документа](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-cernetku-dokumenta-put-apiedsdoc)
5. [Змінити індекси (оновлення полів екстрапараметрів)](https://wiki-v2.edin.ua/books/robota-z-api/page/zapovniti-indeksi-dodavannia-onovlennia-poliv-ekstraparametriv-put-apiedsdocextra-fields)

</details>##### **Алгоритм «Підтвердження замовлення» (ORDRSP)**

<details id="bkmrk-ordrsp-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD%D0%B0%D0%BB%D0%B0%D1%88"><summary>ORDRSP</summary>

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 355.2px;"><colgroup><col style="width: 11.0811%;"></col><col style="width: 88.8951%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">а)</td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc) <sup>extra</sup></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.3</td><td style="height: 29.6px;">[Відправка чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">б)</td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Відправка документа без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**МЕРЕЖА**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.2</td><td style="height: 29.6px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr></tbody></table>

---

\[extra\] - В алгоритмах з початковим створенням чернетки можливо організувати додаткову перевірку і редагування чернетки документа (за необхідності) іншими співробітниками Вашої компанії:

1. [Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)
2. [Знайти чернетки документів для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-dokumentiv-z-filtracijeiu-vibir-spisku-dokumentiv-post-apiedsdocssearch)
3. [Отримати тіло чернетки-документа для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)
4. [Редагувати чернетку документа](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-cernetku-dokumenta-put-apiedsdoc)
5. [Змінити індекси (оновлення полів екстрапараметрів)](https://wiki-v2.edin.ua/books/robota-z-api/page/zapovniti-indeksi-dodavannia-onovlennia-poliv-ekstraparametriv-put-apiedsdocextra-fields)

</details>##### **Алгоритм «Повідомлення про відвантаження» (DESADV)**

<details id="bkmrk-desadv-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD%D0%B0%D0%BB%D0%B0%D1%88"><summary>DESADV</summary>

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 355.2px;"><colgroup><col style="width: 11.0811%;"></col><col style="width: 88.8951%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">а)</td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc) <sup>extra</sup></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.3</td><td style="height: 29.6px;">[Відправка чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">б)</td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Відправка документа без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**МЕРЕЖА**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.2</td><td style="height: 29.6px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr></tbody></table>

---

\[extra\] - В алгоритмах з початковим створенням чернетки можливо організувати додаткову перевірку і редагування чернетки документа (за необхідності) іншими співробітниками Вашої компанії:

1. [Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)
2. [Знайти чернетки документів для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-dokumentiv-z-filtracijeiu-vibir-spisku-dokumentiv-post-apiedsdocssearch)
3. [Отримати тіло чернетки-документа для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)
4. [Редагувати чернетку документа](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-cernetku-dokumenta-put-apiedsdoc)
5. [Змінити індекси (оновлення полів екстрапараметрів)](https://wiki-v2.edin.ua/books/robota-z-api/page/zapovniti-indeksi-dodavannia-onovlennia-poliv-ekstraparametriv-put-apiedsdocextra-fields)

</details>##### **Алгоритм «Повідомлення про прийом» (RECADV)**

<details id="bkmrk-recadv-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD%D0%B0%D0%BB%D0%B0%D1%88"><summary>RECADV</summary>

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 355.2px;"><colgroup><col style="width: 11.0811%;"></col><col style="width: 88.8951%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**МЕРЕЖА**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">а)</td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc) <sup>extra</sup></td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.3</td><td style="height: 29.6px;">[Відправка чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">б)</td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">1.2</td><td style="height: 29.6px;">[Відправка документа без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.1</td><td style="height: 29.6px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">2.2</td><td style="height: 29.6px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr></tbody></table>

---

\[extra\] - В алгоритмах з початковим створенням чернетки можливо організувати додаткову перевірку і редагування чернетки документа (за необхідності) іншими співробітниками Вашої компанії:

1. [Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)
2. [Знайти чернетки документів для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/posuk-dokumentiv-z-filtracijeiu-vibir-spisku-dokumentiv-post-apiedsdocssearch)
3. [Отримати тіло чернетки-документа для редагування](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)
4. [Редагувати чернетку документа](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-cernetku-dokumenta-put-apiedsdoc)
5. [Змінити індекси (оновлення полів екстрапараметрів)](https://wiki-v2.edin.ua/books/robota-z-api/page/zapovniti-indeksi-dodavannia-onovlennia-poliv-ekstraparametriv-put-apiedsdocextra-fields)

</details>##### **Алгоритм «Видаткова накладна» (COMDOC\_006)**

<details id="bkmrk-comdoc_006-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD"><summary>COMDOC\_006</summary>

[![COMDOC_006_API_work_001.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/scaled-1680-/jEysqMhEw2JIRTOz-comdoc-006-api-work-001.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/jEysqMhEw2JIRTOz-comdoc-006-api-work-001.png)

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 394.4px;"><colgroup><col style="width: 9.65341%;"></col><col style="width: 90.3228%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">а)</span></td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.3</span></td><td style="height: 35.2px;">[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.4</span></td><td style="height: 35.2px;">[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">б)</span></td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**МЕРЕЖА**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.2</span></td><td style="height: 35.2px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr><td style="background-color: rgb(206, 212, 217);"><span style="color: rgb(224, 62, 45);">  
</span></td><td class="align-center" style="background-color: rgb(206, 212, 217);">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr><td style="background-color: rgb(206, 212, 217);"><span style="color: rgb(224, 62, 45);">  
</span></td><td class="align-center" style="background-color: rgb(206, 212, 217);">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Акт про виявлені недоліки» (COMDOC\_005)**

<details id="bkmrk-comdoc_005-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD"><summary>COMDOC\_005</summary>

[![COMDOC_005_API_work_001.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/scaled-1680-/U19R1IHLNQEiTdje-comdoc-005-api-work-001.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/U19R1IHLNQEiTdje-comdoc-005-api-work-001.png)

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 394.4px;"><colgroup><col style="width: 9.65341%;"></col><col style="width: 90.3228%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">а)</span></td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.3</span></td><td style="height: 35.2px;">[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.4</span></td><td style="height: 35.2px;">[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">б)</span></td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**МЕРЕЖА**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.2</span></td><td style="height: 35.2px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr><td style="background-color: rgb(206, 212, 217);"><span style="color: rgb(224, 62, 45);">  
</span></td><td class="align-center" style="background-color: rgb(206, 212, 217);">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr><td style="background-color: rgb(206, 212, 217);"><span style="color: rgb(224, 62, 45);">  
</span></td><td class="align-center" style="background-color: rgb(206, 212, 217);">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Коригування видаткової накладної» (COMDOC\_038)**

<details id="bkmrk-comdoc_038-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD"><summary>COMDOC\_038</summary>

[![COMDOC_038_API_work_001.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/scaled-1680-/NlJJfhT2ceqNOGzk-comdoc-038-api-work-001.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/NlJJfhT2ceqNOGzk-comdoc-038-api-work-001.png)

Можливо налаштувати процес відправки документа з окремою дією створення чернетки або без неї:

<table border="1" style="border-collapse: collapse; width: 100%; height: 394.4px;"><colgroup><col style="width: 9.65341%;"></col><col style="width: 90.3228%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**№ кроку**</td><td class="align-center" style="background-color: rgb(206, 212, 217); height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">а)</span></td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.3</span></td><td style="height: 35.2px;">[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.4</span></td><td style="height: 35.2px;">[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">б)</span></td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="height: 29.6px;"><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);"> </td><td class="align-center" style="height: 29.6px; background-color: rgb(206, 212, 217);">**МЕРЕЖА**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.2</span></td><td style="height: 35.2px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr><td style="background-color: rgb(206, 212, 217);"><span style="color: rgb(224, 62, 45);">  
</span></td><td class="align-center" style="background-color: rgb(206, 212, 217);">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr><td style="background-color: rgb(206, 212, 217);"><span style="color: rgb(224, 62, 45);">  
</span></td><td class="align-center" style="background-color: rgb(206, 212, 217);">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>

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

##### **Алгоритм «Прибуткова накладна» (COMDOC\_007)**

<details id="bkmrk-comdoc_007-%D0%9C%D0%BE%D0%B6%D0%BD%D0%B0-%D0%BD%D0%B0%D0%BB"><summary>COMDOC\_007</summary>

[![../../../_images/COMDOC_007_API_work_001.png](https://wiki.edin.ua/uk/latest/_images/COMDOC_007_API_work_001.png)](https://wiki.edin.ua/uk/latest/_images/COMDOC_007_API_work_001.png)

---

Можна налаштувати процес відправки документа з окремою дією створення чернетки чи без неї:

<table style="width: 97.8571%;"><colgroup><col style="width: 14.437%;"></col><col style="width: 85.539%;"></col></colgroup><tbody><tr style="background-color: rgb(236, 240, 241);"><td class="align-center">**№ кроку**</td><td class="align-center">**МЕРЕЖА**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">а)</span></td><td>**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.3</span></td><td>[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.4</span></td><td>[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">б)</span></td><td>**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td class="align-center"> </td><td class="align-center">**ПОСТАЧАЛЬНИК**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.2</span></td><td>[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Акт невідповідності» (COMDOC\_009)**

<details id="bkmrk-comdoc_009-%D0%9C%D0%BE%D0%B6%D0%BD%D0%B0-%D0%BD%D0%B0%D0%BB"><summary>COMDOC\_009</summary>

[![../../../_images/COMDOC_009_API_work_001.png](https://wiki.edin.ua/uk/latest/_images/COMDOC_009_API_work_001.png)](https://wiki.edin.ua/uk/latest/_images/COMDOC_009_API_work_001.png)

---

Можна налаштувати процес відправки документа з окремою дією створення чернетки чи без неї:

<table style="width: 97.619%; height: 707.6px;"><colgroup><col style="width: 14.4928%;"></col><col style="width: 85.4701%;"></col></colgroup><tbody><tr style="height: 29.6px; background-color: rgb(236, 240, 241);"><td class="align-center" style="height: 29.6px;">**№ кроку**</td><td class="align-center" style="height: 29.6px;">**МЕРЕЖА**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">а)</span></td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.3</span></td><td style="height: 35.2px;">[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.4</span></td><td style="height: 35.2px;">[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">б)</span></td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td style="height: 35.2px;">[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="height: 29.6px; background-color: rgb(236, 240, 241);"><td class="align-center" style="height: 29.6px;"> </td><td class="align-center" style="height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.2</span></td><td style="height: 35.2px;">[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">2.3</span></td><td style="height: 35.2px;">[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td style="height: 35.2px;">[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="height: 29.6px; background-color: rgb(236, 240, 241);"><td style="height: 29.6px;">  
</td><td class="align-center" style="height: 29.6px;">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td style="height: 35.2px;">[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td style="height: 35.2px;">[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="height: 29.6px; background-color: rgb(236, 240, 241);"><td style="height: 29.6px;">  
</td><td class="align-center" style="height: 29.6px;">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">4.1</span></td><td style="height: 35.2px;">[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 37.2px;"><td style="height: 37.2px;"><span style="color: rgb(45, 194, 107);">4.2</span></td><td style="height: 37.2px;">[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td style="height: 35.2px;">[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Акт приймання-передачі (додаток 8)» (COMDOC\_032)**

<details id="bkmrk-comdoc_032-%D0%9C%D0%BE%D0%B6%D0%BD%D0%B0-%D0%BD%D0%B0%D0%BB"><summary>COMDOC\_032</summary>

[![../../../_images/COMDOC_032_API_work_001.png](https://wiki.edin.ua/uk/latest/_images/COMDOC_032_API_work_001.png)](https://wiki.edin.ua/uk/latest/_images/COMDOC_032_API_work_001.png)

---

Можна налаштувати процес відправки документа з окремою дією створення чернетки чи без неї:

<table style="width: 99.881%; height: 329.6px;"><colgroup><col style="width: 16.2252%;"></col><col style="width: 83.7509%;"></col></colgroup><tbody><tr style="background-color: rgb(236, 240, 241); height: 29.6px;"><td class="align-center" style="height: 29.6px;">**№ кроку**</td><td class="align-center" style="height: 29.6px;">**ПОСТАЧАЛЬНИК**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.1</span></td><td style="height: 35.2px;">[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">а)</span></td><td style="height: 29.6px;">**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.3</span></td><td style="height: 35.2px;">[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.4</span></td><td>[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;"><span style="color: rgb(45, 194, 107);">б)</span></td><td style="height: 29.6px;">**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr style="height: 35.2px;"><td style="height: 35.2px;"><span style="color: rgb(45, 194, 107);">1.2</span></td><td style="height: 35.2px;">[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="height: 29.6px; background-color: rgb(236, 240, 241);"><td class="align-center" style="height: 29.6px;"> </td><td class="align-center" style="height: 29.6px;">**МЕРЕЖА**</td></tr><tr style="height: 35.2px;"><td><span style="color: rgb(45, 194, 107);">2.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr style="height: 35.2px;"><td><span style="color: rgb(45, 194, 107);">2.2</span></td><td>[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td class="align-center"> </td><td class="align-center">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

<div class="wy-table-responsive">  
</div>---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Акт приймання-передачі (додаток 9)» (COMDOC\_033)**

<details id="bkmrk-comdoc_033-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD"><summary>COMDOC\_033</summary>

[![../../../_images/COMDOC_033_API_work_001.png](https://wiki.edin.ua/uk/latest/_images/COMDOC_033_API_work_001.png)](https://wiki.edin.ua/uk/latest/_images/COMDOC_033_API_work_001.png)

---

Можливо налаштувати процес відправки документа з окремою дією створення чернетки чи без неї:

<table style="width: 96.9048%;"><colgroup><col style="width: 14.4928%;"></col><col style="width: 85.4701%;"></col></colgroup><tbody><tr style="background-color: rgb(236, 240, 241);"><td class="align-center">**№ кроку**</td><td class="align-center">**МЕРЕЖА**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">а)</span></td><td>**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.3</span></td><td>[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.4</span></td><td>[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">б)</span></td><td>**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td class="align-center"> </td><td class="align-center">**ПОСТАЧАЛЬНИК**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.2</span></td><td>[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Акт приймання товару до АПП» (COMDOC\_034)**

<details id="bkmrk-comdoc_034-%D0%9C%D0%BE%D0%B6%D0%BB%D0%B8%D0%B2%D0%BE-%D0%BD"><summary>COMDOC\_034</summary>

[![../../../_images/COMDOC_034_API_work_001.png](https://wiki.edin.ua/uk/latest/_images/COMDOC_034_API_work_001.png)](https://wiki.edin.ua/uk/latest/_images/COMDOC_034_API_work_001.png)

---

Можливо налаштувати процес відправки документа з окремою дією створення чернетки чи без неї:

<table style="width: 96.9048%;"><colgroup><col style="width: 14.4928%;"></col><col style="width: 85.4701%;"></col></colgroup><tbody><tr style="background-color: rgb(236, 240, 241);"><td class="align-center">**№ кроку**</td><td class="align-center">**МЕРЕЖА**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">а)</span></td><td>**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.3</span></td><td>[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.4</span></td><td>[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">б)</span></td><td>**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td class="align-center"> </td><td class="align-center">**ПОСТАЧАЛЬНИК**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.2</span></td><td>[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>##### **Алгоритм «Акт приймання товару до ВН» (COMDOC\_035)**

<details id="bkmrk-comdoc_035-%D0%9C%D0%BE%D0%B6%D0%BD%D0%B0-%D0%BD%D0%B0%D0%BB"><summary>COMDOC\_035</summary>

[![../../../_images/COMDOC_035_API_work_001.png](https://wiki.edin.ua/uk/latest/_images/COMDOC_035_API_work_001.png)](https://wiki.edin.ua/uk/latest/_images/COMDOC_035_API_work_001.png)

---

Можна налаштувати процес відправки документа з окремою дією створення чернетки чи без неї:

<table style="width: 96.9048%;"><colgroup><col style="width: 14.4928%;"></col><col style="width: 85.4701%;"></col></colgroup><tbody><tr style="background-color: rgb(236, 240, 241);"><td class="align-center">**№ кроку**</td><td class="align-center">**МЕРЕЖА**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">а)</span></td><td>**Варіант 1: Відправка документа зі створенням чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Створення чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-cernetku-dokumenta-klonuvati-vidpravlenii-dokument-comdoc-post-apiv2edsdoc)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.3</span></td><td>[Підписання чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-1-pidpis-cernetki-post-apiv2edsdocticket)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.4</span></td><td>[Відправка підписаної чернетки документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-cernetku-patch-apiedsdocsend)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">б)</span></td><td>**Варіант 2: Відправка документа без створення чернетки**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">1.2</span></td><td>[Відправка вже підписаного документа (.p7s) без створення чернетки](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-dokument-bez-stvorennia-cernetki-post-apiedsdoccreate-and-send)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">1.5\*</span></td><td>[Відкликання підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td class="align-center"> </td><td class="align-center">**ПОСТАЧАЛЬНИК**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.1</span></td><td>[Авторизація](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.2</span></td><td>[Отримання контента документа](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-dokumenta-get-apiedsdocbody)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">2.3</span></td><td>[Підписання вхідного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-2-priiniattia-dokumenta-comdoc-post-apiv2edscomdocaccept)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">2.3\*</span></td><td>[Відхилення підписання COMDOC документа](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ІНІЦІАТОР АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.1\*</span></td><td>[Авторизація Ініціатора](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">3.2\*</span></td><td>[Створення запиту на анулювання COMDOC документа Ініціатором](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-11-zapit-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepeal)</td></tr><tr style="background-color: rgb(236, 240, 241);"><td>  
</td><td class="align-center">**ОТРИМУВАЧ АНУЛЮВАННЯ**</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.1</span></td><td>[Авторизація Отримувача](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)</td></tr><tr><td><span style="color: rgb(45, 194, 107);">4.2</span></td><td>[Відмова від анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-15-vidmova-vid-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealreject)</td></tr><tr><td><span style="color: rgb(224, 62, 45);">4.2\*</span></td><td>[Приймання анулювання COMDOC документа Отримувачем](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-12-priiniattia-zapitu-na-anuliuvannia-comdocdocumentinvoicetransportationorder-post-apiv2edsdocrepealaccept)</td></tr></tbody></table>

---

[Додаткові методи API](https://wiki-v2.edin.ua/books/robota-z-api/page/perelik-metodiv-api-servisu-edi-network#bkmrk-%D0%A0%D0%BE%D0%B1%D0%BE%D1%82%D0%B0-%D0%B7-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%8F%D0%BC%D0%B8)

</details>

# Опис помилок сервісу «EDI Network»

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

<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%86%D0%BD%D0%B4%D0%B5%D0%BA%D1%81" style="width: 102.857%;"><colgroup><col style="width: 9.53266%;"></col><col style="width: 11.4397%;"></col><col style="width: 35.9867%;"></col><col style="width: 43.0172%;"></col></colgroup><thead><tr class="row-odd"><td>**Код відповіді**

</td><td>**Індекс помилки**

</td><td>**Текст помилки**

</td><td>**Опис**

</td></tr></thead><tbody><tr class="row-even"><td>400

</td><td>ERR\_EDI-1

</td><td>Validation document errors: \[%s\]

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

</td><td>Помилка при перевірці обов'язкових тегів в xml - в дужках перелік незаповнених/некоректно заповнених полів

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-2

</td><td>XSD Validation document error: \[%s\]

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

</td><td>Помилка при валідації по xsd - в дужках вказується конкретна причина помилки

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

</td><td>ERR\_EDI-3

</td><td>Business logic validation document errors: \[%s\]

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

</td><td>Помилка при перевірці обов'язкових тегів в xml згідно бізнес-логіки - в дужках перелік незаповнених/ некоректно заповнених полів

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-4

</td><td>Unknown or unsupported document type: \[%s\]

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

</td><td>Помилка виникає тільки в 1-му випадку: при спробі відправити документ CONDRA методом create\_and\_send

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

</td><td>ERR\_EDI-5

</td><td> </td><td>Помилка виникає при перевірці підпису, якщо позначка часу створена офлайн

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-6

</td><td>Data should contain \[%s\] marker

Данні мають містити \[%s\] маркер

</td><td>Помилка виникає при спробі дешифрування даних, якщо дані не містять крипто-заголовки (CERTCRYPT або UA1\_CRYPT)

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

</td><td>ERR\_EDI-7

</td><td>Data should be enveloped (crypted)

Дані повинні бути захищені (зашифровані)

</td><td>Помилка виникає при спробі дешифрування даних, якщо дані не зашифровані

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-8

</td><td>Decription failed - \[%s\]

Не вдалося розшифрувати - \[%s\]

</td><td>Помилка виникає при спробі дешифрування даних, якщо при дешифруванні виникає помилка - в дужках причина

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

</td><td>ERR\_EDI-9

</td><td>The data is not signed or contains an incorrect signature

Дані не підписані або містять некоректний підпис

</td><td>Помилка виникає коли клієнт передав не підписані або не коректно підписані дані, коли вони мають бути підписані (наприклад, роут create\_and\_send при відправці p7s-ки, вказуючи content-type = application/pkcs7-signature)

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-10

</td><td>You cannot send a document signed only with a seal

Ви не можете надіслати документ, підписаний тільки печаткою

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

</td><td>ERR\_EDI-11

</td><td>GLN from request \[%s\] should match sender’s GLN from body \[%s\]

GLN із запиту \[%s\] має збігатися з GLN відправника з тіла \[%s\]

</td><td>Помилка виникає в create\_and\_send або роуті створення документа через API, коли є невідповідність GLN-ів, який був переданий в url-параметрі і GLN відправника в тілі документа

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-12

</td><td>Sender GLN cannot be same as recipient GLN

GLN відправника не може збігатись з GLN отримувача

</td><td>Помилка виникає в методі create\_and\_send, коли клієнти відправляють документи самі собі

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

</td><td>ERR\_EDI-13

</td><td>Branch uuid \[%s\] already revoked

UUID \[%s\] гілки уже відкликано

</td><td> </td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-14

</td><td>COMDOC \[019/021\] not yet supported.

COMDOC \[019/021\] ще не підтримується.

</td><td>Помилка виникає тільки в 1-му випадку: при спробі відправити цей підтип COMDOC методом create\_and\_send

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

</td><td>ERR\_EDI-15

</td><td>Doc is not in open status

Документ не в статусі - чернетка

</td><td>Помилка виникає у випадках, коли клієнт хоче додати/видалити вкладення у документа не чернетки (CONDRA)

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-16

</td><td>Document already revoked, current status: \[%s\]

Документ уже відкликано, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

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

</td><td>ERR\_EDI-17

</td><td>Document already signed, current status: \[%s\]

Документ уже підписаний, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-18

</td><td>Document already both signed, current status: \[%s\]

Документ уже підписаний двома сторонами, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

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

</td><td>ERR\_EDI-19

</td><td>Document already сanceled, current status: \[%s\]

Документ уже анульовано, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-20

</td><td>Document already repealed, current status: \[%s\]

Документ уже скасовано, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

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

</td><td>ERR\_EDI-21

</td><td>Document already has repeal request, current status: \[%s\]

Документ уже має запит на скасування, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-22

</td><td>Document has no repeal request, current status: \[%s\]

Документ не має запиту на скасування, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

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

</td><td>ERR\_EDI-23

</td><td>Document’s repeal already rejected, current status: \[%s\]

Скасування документа уже відхилено, поточний статус: \[%s\]

</td><td>Помилка виникає при спробі відправити тікет (прийняти COMDOC, підписати DOCINVOICE і т.д.), що протирічить логіці документообігу

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-24

</td><td>DocumentInvoice parties do not contain certificate’s EDRPOU: \[%s\]

Сторони DocumentInvoice не містять ЄДРПОУ з сертифіката: \[%s\]

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

</td><td>ERR\_EDI-25

</td><td>DocumentInvoice parties do not contain certificate’s DRFO: \[%s\]

Сторони DocumentInvoice не містять ДРФО з сертифіката: \[%s\]

</td><td> </td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-26

</td><td>There is no EDRPOU/DRFO code in the signature certificate

У сертифікаті підпису відсутні коди ЄДРПОУ/ДРФО

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

</td><td>ERR\_EDI-27

</td><td>COMDOC parties do not contain certificate’s EDRPOU: \[%s\]

Сторони COMDOC не містять ЄДРПОУ з сертифіката: \[%s\]

</td><td> </td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-28

</td><td>The signing key is not on a secure medium. Please select a different key and try again

Ключ для підписання, що використовується, знаходиться не на захищеному носії. Виберіть, будь ласка, інший ключ і спробуйте ще раз

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

</td><td>ERR\_EDI-29

</td><td>There is no signer position in the key. Please select a different key and try again

У ключі немає посади підписувача. Виберіть, будь ласка, інший ключ і спробуйте ще раз

</td><td> </td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-30

</td><td>The document does not contain sender’s signatures. Change the settings of your signature module to create a signature online. Or contact technical support for advice.

Документ не містить підписів відправника. Змініть налаштування свого модуля підписання для створення підпису онлайн. Або зверніться до служби технічної підтримки для консультації.

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

</td><td>ERR\_EDI-31

</td><td>\[signs\] is empty

\[signs\] порожній

</td><td>Помилка виникає в роутах при роботі з тікетами (створення, відхилення документа, прийняття COMDOC і т.д.), у разі якщо клієнт користується застарілим способом передачі тіла, використовуючи об'єкт TicketRequestData і не передавши в json-і \[signs\]

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-32

</td><td>Field \[%s\] is required

Поле \[%s\] є обов’язковим

</td><td>Помилка виникає тільки в роуті POST /api/eds/doc/archive, якщо в об’єкті DocumentStorageQuery не передано - direction або type, або docDate

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

</td><td>ERR\_EDI-33

</td><td>Expected non-empty list of uuids

Cписок uuid не може бути пустим

</td><td>Помилка виникає тільки в роуті - /api/v2/eds/doc/content, якщо список uuid-ів порожній

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-34

</td><td>The size of the list cannot be more than \[%s\]

Розмір списку не може перевищувати \[%s\]

</td><td>Помилка виникає тільки в роуті /api/v2/eds/doc/content, якщо в списку значень UUID більше ніж 50

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

</td><td>ERR\_EDI-35

</td><td>Report’s start date \[%s\] cannot be more than end date \[%s\]

Дата початку звіту \[%s\] не може перевищувати дату завершення \[%s\]

</td><td>Помилка виникає в роутах формування звітів

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-36

</td><td>Date range (from \[%s\] to \[%s\]) cannot be more than 31 days

Діапазон дат (від \[%s\] до \[%s\]) не може перевищувати 31 день

</td><td>Помилка виникає в роутах формування звітів

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

</td><td>ERR\_EDI-37

</td><td>Report can be created based on only one parameter: sender OR recipient OR partner

Звіт можна створити лише за одним параметром: sender OR recipient OR partner

</td><td>Помилка виникає в роутах формування звітів

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-38

</td><td>Content from request does not match original content, actual\_hash:\[%s\] request\_hash:\[%s\], actualContentHash

Контент запиту не відповідає оригінальному контенту, actual\_hash:\[%s\] request\_hash:\[%s\], actualContentHash

</td><td>Помилка виникає, якщо хеш контенту в eds не відповідають хешу контенту з тіла запиту (це про підписання документів у відповідь)

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

</td><td>ERR\_EDI-39

</td><td>Signs count should be more than parent data signs count

Кількість підписів повинна бути більшою, ніж у батьківській квитанції

</td><td> </td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-40

</td><td>\[subjEDRPOUCode\] from sign does not match any of \[КодКонтрагента\] or \[ІПН\] from XML

\[subjEDRPOUCode\] із підпису не відповідає жодному з \[КодКонтрагента\] або \[ІПН\] із XML

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

</td><td>ERR\_EDI-41

</td><td>Incorrect document family. One of \[%s\] is expected

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

</td><td> </td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-42

</td><td>Handling sign failed - \[%s\]

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

</td><td>Помилка виникає при опрацюванні p7s, зазвичай ці помилки пов’язані з ІІТ бібліотекою

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

</td><td>ERR\_EDI-43

</td><td>Ticket with transaction type \[%s\] not found

Квитанцію з типом транзакції \[%s\] не знайдено

</td><td>Помилка виникає в роутах при отриманні інформації по підписантам в тікеті

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-44

</td><td>XSLT for document type \[%s\] not found

XSLT для типу документа \[%s\] не знайдено

</td><td>Не знайдено карту конвертації

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

</td><td>ERR\_EDI-45

</td><td>Can’t define recipient GLN

Неможливо визначити GLN одержувача

</td><td>Не вдалось визначити отримувача при відправці DOCCORINVOICE

</td></tr><tr class="row-odd"><td>400

</td><td>ERR\_EDI-46

</td><td>The document can only be signed by one party

Документ може бути підписаний тільки однією стороною

</td><td>Відправлений COMDOC містить поле «ОдностороннєПідписання»

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

# Отримати кроки погодження за документом GET /api/eds/doc/approval/step

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 97.8571%;"><colgroup><col style="width: 23.2741%;"></col><col style="width: 76.7034%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/approval/step**

</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></tbody></table>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані кроків погодження](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdocapprovalstep) (об’єкт з масивами об’єктів XDocApprovalStep).

**Приклад відповіді:**

```json
{
  "1": [
    {
      "docId": 3580,
      "scenarioId": 9,
      "stepId": 1,
      "userId": 60215367,
      "stepStatus": 0,
      "operationType": 0,
      "dateChanged": 1674072579
    }
  ],
  "2": [
    {
      "docId": 3580,
      "scenarioId": 9,
      "stepId": 2,
      "userId": 50206653,
      "stepStatus": 0,
      "operationType": 0,
      "dateChanged": 1674072579
    }
  ],
  "3": [
    {
      "docId": 3580,
      "scenarioId": 9,
      "stepId": 3,
      "userId": 60215367,
      "stepStatus": 0,
      "operationType": 0,
      "dateChanged": 1674072579
    }
  ]
}
```

# Запуск документа на погодження / Зміна статуса кроку погодження POST /api/eds/doc/approval/step

<p class="callout info">Для запуску документа на погодження в методі потрібно передавати опціональний параметр **scenario\_id**!</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 12.8703%;"></col><col style="width: 87.1165%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/approval/step**

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

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

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

**scenario\_id** (обов’язково / опціонально) long - ідентифікатор документа (обов’язково при запуску документа на погодження)

**id** (опціонально) long - номер кроку погодження із сценарію

**status** (опціонально) long - ідентифікатор статусу:

- 0 - на погодженні
- 1 - погоджено
- 2 - відхилено

</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>При відхиленні (status=2) в тілі запиту методу потрібно передавати текстовий коментар - причину відхилення.

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

</div>**RESPONSE**

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

# Редагувати / видалити сценарій погодження документів PUT /api/eds/doc/approval/scenario

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PUT

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

</td><td>**/api/eds/doc/approval/scenario**

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

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

**id** (обов’язково) long - ідентифікатор сценарію до редагування

</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>В тілі запиту методу передаються [дані кроків за сценарієм](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdocapprovalscenario-dani-krokiv-za-scenarijem) (об’єкт з масивами об’єктів XDocApprovalScenario)

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

</div>**RESPONSE**

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

# Отримати сценарій/-ї (на рівні GLN) GET /api/eds/doc/approval/scenario

<p class="callout info">Метод може бути використаний для отримання всіх сценаріїв (на рівні GLN) або конкретного, якщо в методі передається опціональний параметр **id**!</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.3456%;"></col><col style="width: 86.6412%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/approval/scenario**

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

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

**id** (опціонально) long - ідентифікатор сценарію

**auto** (опціонально) boolean - автоматичний запуск погодження (false за замовчуванням). При auto=true повертаються тільки сценарії з автозапуском.

**doc\_type** (опціонально) int - тип документа для автопогодження (повертаються сценарії тільки за обраним типом документа). Відпрацьовує лише у зв’язці із auto=true. Можливі значення:

- <dl class="simple"><dt>28 - COMDOC:</dt><dd>
    - Акт наданих послуг (COMDOC\_018)
    - Акт виконаних робіт (COMDOC\_013)
    - Акт взаємозаліку (COMDOC\_015)
    - Рахунок-фактура (COMDOC\_016)
    - Акт звірки зведений (COMDOC\_029)
    - Претензія (COMDOC\_030)
    - Акт наданих послуг (Логістика) (COMDOC\_037)
    
    </dd></dl>
- 118 - Акт приймання наданих послуг (DOCINVOICEACT)
- 115 - Повідомлення про штрафні санкції (ORDRPT)

</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>

</div>**RESPONSE**

В тілі **відповіді** передаються [дані сценарію/-їв](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdocapprovalscenario-dani-krokiv-za-scenarijem) (об’єкт / масив об’єктів XDocApprovalScenario).

# Створити сценарій погодження документів POST /api/eds/doc/approval/scenario

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 99.5238%;"><colgroup><col style="width: 15.3258%;"></col><col style="width: 84.6609%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/approval/scenario**

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

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

**name** (обов’язково) int - назва сценарію

</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>В тілі запиту методу передаються [дані кроків за сценарієм](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdocapprovalscenario-dani-krokiv-za-scenarijem) (об’єкт з масивами об’єктів XDocApprovalScenario)

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

</div>**RESPONSE**

В тілі **відповіді** передаються дані сценарію (об’єкт [XDocApprovalScenario](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xdocapprovalscenario-dani-krokiv-za-scenarijem)).

# Вилучити теги з документа DELETE /api/eds/doc/tags

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-d"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1324%;"></col><col style="width: 84.8543%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

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

</td><td>**/api/eds/doc/tags**

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

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

**doc\_id** (обов’язково) long - ідентифікатор документа

</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) передається масив об’єктів: [тегів](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xtag) для видалення з документа.

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

</div>**RESPONSE**

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

# Прив'язати тег до документа POST /api/eds/doc/tags

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-pos"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1343%;"></col><col style="width: 84.8524%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>  
</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/tags**

</td></tr><tr><td>URL параметри

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

**doc\_id** (обов’язково) long - ідентифікатор документа

</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) передається масив обʼєктів [XTag](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xtag)

*Приклад:*

```json
[
  {
    "id": "ід тега",
    "name": "назва тега"
  },
  {
    "id": "ід тега",
    "name": "назва тега"
  }
]
```

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

</div>**RESPONSE**

У відповіді повертається повідомлення та статус:

<table border="1" id="bkmrk-status-message-%D0%9A%D0%BE%D0%BC%D0%B5%D0%BD" style="width: 100%;"><colgroup><col style="width: 8.69741%;"></col><col style="width: 26.578%;"></col><col style="width: 64.7113%;"></col></colgroup><thead><tr><td>STATUS</td><td>Message</td><td>Коментар</td></tr></thead><tbody><tr><td>200</td><td>Запит успішно опрацьовано</td><td>Статус заявки змінено на вказаний</td></tr><tr><td>500</td><td>Internal Server Error. Chanel ID: 123456</td><td>Непередбачена внутрішня помилка. Необхідно звернутись до тех. підтримки для зʼясування причини помилки.</td></tr></tbody></table>

<div class="wy-table-responsive" id="bkmrk-url-https%3A%2F%2Fedo-v2.e-2"></div>

# Видалити теги DELETE /api/eds/tags

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p-1" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.6564%;"></col><col style="width: 85.3304%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

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

</td><td>**/api/eds/tags**

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

</td><td>**gln** (обов’язково) String - GLN власної Компанії; АБО **guid** (обов’язково) 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) передається масив ідентифікаторів тегів до видалення, наприклад: `<span class="pre">[2,</span> <span class="pre">10,</span> <span class="pre">12]</span>`.

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

</div></div></div></div>**RESPONSE**

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

# Редагувати тег PUT /api/eds/tags

<p class="callout warning">Назва тегу повинна бути унікальною й довжиною не більше 20 символів.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.8962%;"></col><col style="width: 85.0905%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PUT

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

</td><td>**/api/eds/tags**

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

</td><td>**gln** (обов’язково) String - GLN власної Компанії; АБО **guid** (обов’язково) 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) передається масив об’єктів: [тегів](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xtag) з відредагованими назвами/короткими назвами.

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

</div>**RESPONSE**

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

# Отримати список тегів (міток) GET /api/eds/tags

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-https%3A%2F%2Fedo-v2.e-1"><table class="colwidths-given docutils align-default"><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>**GET**

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

</td><td>**/api/eds/tags**

</td></tr><tr><td>URL параметри

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

**search** (опціонально) 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></tbody></table>

</div><div class="wy-table-responsive" id="bkmrk-"></div>**RESPONSE**

В тілі відповіді в json форматі передається масив тегів ([Обʼєкт XTag](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xtag)), що відповідають пошуковому запиту

```json
[
  {
    "id": "ід тега",
    "name": "назва тега"
  },
]
```

# Створити новий тег (мітку) POST /api/eds/tags

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-pos"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.775%;"></col><col style="width: 85.2117%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>  
</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/tags**

</td></tr><tr><td>URL параметри

</td><td>**gln** (обов’язково) String - GLN власної Компанії; АБО **guid** (обов’язково) 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) передається список (масив) назв тегів у вигляді масиву.

<p class="callout warning">Назва тегу (мітки) повинна бути унікальною й довжиною не більше 20 символів.</p>

*Приклад:*

```json
["Ken", "json", "Stethem"]
```

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

</div>**RESPONSE**

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

```json
[
  {
    "id": "ід тега",
    "name": "назва тега"
  },
]
```

<div class="wy-table-responsive" id="bkmrk-url-https%3A%2F%2Fedo-v2.e"></div>

# Створити квитанцію №14 (відкликати підписання документа COMDOC/TRANSPORTATIONORDER) POST /api/v2/eds/doc/revoke

Відкликати підписання документа COMDOC/TRANSPORTATIONORDER може лише відправник документа до того, як документ змінить свій стан на:

- відкликаний (в документа є квитанція №14)
- відмовлений (в документа є квитанція №13)
- анульований (в документа є квитанція №12)
- прийнятий (в документа є квитанція №2)

Значення \[ЕлектроннийДокумент/Відхилив/GLN\] має відповідати параметру gln в запиті. ЄДРПОУ в підписі має відповідати \[КодКонтрагента\] або \[ІПН\] в блоці \[ЕлектроннийДокумент/Відхилив\]

Метод може бути використаний для відправки **Відкликання підписання** : Комерційних документів (сімейство COMDOC), [Накладних (DOCUMENTINVOICE)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice), [Додаток до договору 7А (METRO\_7A)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7a-metro-7a), [Додаток до договору 7Б (METRO\_7B)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7b-metro-7b), [Додаток до договору 7Ц (METRO\_7C)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7c-metro-7c), [«Заявка на транспортування» / «Підтвердження заявки на транспортування» (TRANSPORTATIONORDER)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/zaiavka-na-transportuvannia-pidtverdzennia-zaiavki-na-transportuvannia).

Для [DOCUMENTINVOICE](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice) та [DOCCORINVOICE](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/koriguvannia-do-tovarnoyi-nakladnoyi-doccorinvoice) (**і лише для цих документів**) метод може бути виконаний в режимі автоматичного формування і відправки «Повідомлення про відмову від підписання документа» ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021)) при наявності autoGenerate параметра. За наявності параметра autoGenerate тіло квитанції формується автоматично, але без підпису.

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0102%;"></col><col style="width: 84.9765%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/revoke**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта

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

<span class="red">**лише для DOCUMENTINVOICE/DOCCORINVOICE**:</span> **autoGenerate** (опціонально) - параметр (без значення), що вказує на автоматичне генерування квитанції Відкликання підписання

</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>`<span class="pre">application/json</span>` або `<span class="pre">application/xml</span>` (запит містить **autoGenerate** параметр) або `<span class="pre">application/pkcs7-signature</span>` (запит без **autoGenerate** параметра)

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

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

</td><td>В тілі запиту методу **обов’язково** передається:

- текст причини відкликання документа (коли запит містить **autoGenerate** параметр);

АБО

- підписаний p7s файл квитанції Відкликання підписання - запит без **autoGenerate** параметра.

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

</div></div></div></div>**RESPONSE**

В тілі відповіді передаються:

<div class="document" id="bkmrk-chain_uuid%C2%A0--%D1%96%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section">- **chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ
- **doc\_uuid** - ідентифікатор документа, якому належить квитанція
- **ticket\_uuid** - ідентифікатор квитанції

</div></div></div>**JSON приклад відповіді:**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити на сервері квитанцію «Відкликання підписання документа» (COMDOC_021) GET /api/v2/eds/doc/revoke

Цей метод може бути використаний для **Відкликання підписання** : Комерційних документів (сімейство COMDOC), [Накладних (DOCUMENTINVOICE)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice), [Додаток до договору 7А (METRO\_7A)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7a-metro-7a), [Додаток до договору 7Б (METRO\_7B)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7b-metro-7b), [Додаток до договору 7Ц (METRO\_7C)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7c-metro-7c), [«Заявка на транспортування» / «Підтвердження заявки на транспортування» (TRANSPORTATIONORDER)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/zaiavka-na-transportuvannia-pidtverdzennia-zaiavki-na-transportuvannia).

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0113%;"></col><col style="width: 84.9754%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/v2/eds/doc/revoke**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа

**reason** - text; текст причини відкликання

**response\_type** (опціонально) - формат очікуваної відповіді; можливі варіанти:

- **json** (за замовчуванням)
- **xml**
- **json\_base64**
- **xml\_base64**

</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>

</div>**RESPONSE**

В тілі відповіді передається тіло згенерованого COMDOC\_021 в json форматі або форматі, обраному в запиті **response\_type** ([приклади відповіді](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-vidpovidi-pri-stvorenni-kvitanciyi-povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu) + [специфікація COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021)).

# Відправити відмову від підписання (створення квитанції №13) POST /api/v2/eds/doc/reject

Метод може бути використаний для відправки **Відмови від підписання** : Комерційних документів (сімейство COMDOC), [Накладних (DOCUMENTINVOICE)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice), [Додаток до договору 7А (METRO\_7A)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7a-metro-7a), [Додаток до договору 7Б (METRO\_7B)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7b-metro-7b), [Додаток до договору 7Ц (METRO\_7C)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7c-metro-7c), [«Заявка на транспортування» / «Підтвердження заявки на транспортування» (TRANSPORTATIONORDER)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/zaiavka-na-transportuvannia-pidtverdzennia-zaiavki-na-transportuvannia).

Для [DOCUMENTINVOICE](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice) та [DOCCORINVOICE](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/koriguvannia-do-tovarnoyi-nakladnoyi-doccorinvoice) (**і лише для цих документів**) метод може бути виконаний в режимі автоматичного формування і відправки «Повідомлення про відмову від підписання документа» ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021)) при наявності autoGenerate параметра. За наявності параметра autoGenerate тіло квитанції формується автоматично, але без підпису.

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.247%;"></col><col style="width: 84.7397%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/reject**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта АБО **guid** (обов’язково) String - унікальний ідентифікатор організації на платформі EDIN 2.0

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

<span class="red">**лише для DOCUMENTINVOICE/DOCCORINVOICE**:</span> **autoGenerate** (опціонально) - параметр (без значення), що вказує на автоматичне генерування xml Повідомлення про відмову від підписання документа ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021))

</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>`<span class="pre">application/json</span>` (запит містить **autoGenerate** параметр) або `<span class="pre">application/pkcs7-signature</span>` (запит без **autoGenerate** параметра)

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

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

</td><td>В тілі запиту методу **обов’язково** передається:

- текст причини відмови від підписання документа (коли запит містить **autoGenerate** параметр);

АБО

- підписаний p7s файл Повідомлення про відмову від підписання документа ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021)) - запит без **autoGenerate** параметра.

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

</div>**RESPONSE**

В тілі відповіді передаються:

- **chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ
- **doc\_uuid** - ідентифікатор документа, якому належить квитанція
- **ticket\_uuid** - ідентифікатор квитанції

**JSON приклад відповіді:**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити квитанцію №15 (відмова від анулювання COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER) POST /api/v2/eds/doc/repeal/reject

<p class="callout info">Виконати «Відмову від анулювання» документа може лише отримувач «Запиту на анулювання» (є квитанція №11) до того, як документ змінить свій стан на «анульовано» (в документа є квитанція №12).</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1283%;"></col><col style="width: 84.8585%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/repeal/reject**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER

</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>В тілі запиту методу передається непідписаний xml ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021) з даними документа підстави і причиною відмови від анулювання в полі «Текст») в бінарному вигляді. Тіло можливо створити методом [GET /api/v2/eds/doc/reject](https://wiki-v2.edin.ua/link/288#bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F-%D0%BD%D0%B0-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D1%96-2)

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

</div>**RESPONSE**

В тілі відповіді передаються:

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ

**doc\_uuid** - ідентифікатор документа, якому належить квитанція

**ticket\_uuid** - ідентифікатор квитанції

**Приклад (JSON):**

```json
{
  "chain_uuid": "d47a29f6-b208-41a1-bb6e-8f5fc58745cd",
  "doc_uuid": "38e37759-825a-4774-a3c3-d77f241253a8",
  "ticket_uuid": "111aaeaa-3601-49d9-a5e5-fe2aaebdacdb"
}
```

# Створити квитанцію №14 (відкликати підписання документа COMDOC/TRANSPORTATIONORDER) POST /api/v2/eds/comdoc/revoke

<p class="callout danger">Наполегливо рекомендуємо використовувати замість даного методу новий метод **/api/v2/eds/doc/revoke** [за посиланням](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-kvitanciiu-14-vidklikati-pidpisannia-dokumenta-comdoctransportationorder-post-apiv2edsdocrevoke).</p>

Відкликати підписання документа COMDOC/TRANSPORTATIONORDER може лише відправник документа до того, як документ змінить свій стан на:

- відкликаний (в документа є квитанція №14)
- відмовлений (в документа є квитанція №13)
- анульований (в документа є квитанція №12)
- прийнятий (в документа є квитанція №2)

Значення \[ЕлектроннийДокумент/Відхилив/GLN\] має відповідати параметру gln в запиті. ЄДРПОУ в підписі має відповідати \[КодКонтрагента\] або \[ІПН\] в блоці \[ЕлектроннийДокумент/Відхилив\]

Цей метод може бути виконаний двома способами, що відрізняються набором вхідних параметрів і потребою в передаванні тіла запиту:

**Спосіб № 1:**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.2515%;"></col><col style="width: 84.7353%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/comdoc/revoke**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC

</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/pkcs7-signature* or *application/xml*

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

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

</td><td>В тілі запиту методу можуть передаватись:

- при *Content-Type=application/pkcs7-signature* підписані дані p7s в бінарному вигляді;
- при *Content-Type=application/xml* непідписаний xml ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021)) в бінарному вигляді.

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

</div>**Спосіб № 2:**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p-1"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1325%;"></col><col style="width: 84.8542%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/comdoc/revoke**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC

**autoGenerate** - параметр (без значення), що вказує на автоматичне генерування квитанції

</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>**REQUEST**

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

</td><td>В тілі запиту методу **обов’язково** передається текст причини відкликання документа.

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

</div>**RESPONSE**

В тілі відповіді передаються:

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ

**doc\_uuid** - ідентифікатор документа, якому належить квитанція

**ticket\_uuid** - ідентифікатор квитанції

**JSON приклад:**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити квитанцію №13 (відхилення документа COMDOC/TRANSPORTATIONORDER) POST /api/v2/eds/comdoc/reject

<p class="callout danger">Наполегливо рекомендуємо використовувати замість даного методу новий метод **/api/v2/eds/doc/reject** [за посиланням](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject).</p>

Відхилити документ COMDOC може лише отримувач документа до того, як документ змінить свій стан на:

- відкликаний (в документа є квитанція №14)
- відмовлений (в документа є квитанція №13)
- анульований (в документа є квитанція №12)
- прийнятий (в документа є квитанція №2)

Значення \[ЕлектроннийДокумент/Відхилив/GLN\] має відповідати параметру gln в запиті. ЄДРПОУ в підписі має відповідати \[КодКонтрагента\] або \[ІПН\] в блоці \[ЕлектроннийДокумент/Відхилив\]

Цей метод може бути виконаний двома способами, що відрізняються набором вхідних параметрів і потребою в передаванні тіла запиту:

**Спосіб № 1:**

<table class="colwidths-given docutils align-default" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p" style="width: 100%;"><colgroup><col style="width: 15.2515%;"></col><col style="width: 84.7353%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/comdoc/reject**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC

</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/pkcs7-signature or application/xml

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

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

</td><td>В тілі запиту методу можуть передаватись:

- при Content-Type=application/pkcs7-signature підписані дані p7s в бінарному вигляді;
- при Content-Type=application/xml непідписаний xml ([COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021)) в бінарному вигляді.

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

**Спосіб № 2:**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p-1"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.8912%;"></col><col style="width: 85.0956%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/comdoc/reject**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** - рядок; унікальний ідентифікатор організації в системі;

**doc\_uuid** - рядок; UUID документа COMDOC

**autoGenerate** - параметр (без значення), що вказує на автоматичне генерування квитанції

</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>**REQUEST**

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

</td><td>В тілі запиту методу **обов’язково** передається текст причини відхилення документа

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

</div>**RESPONSE**

В тілі відповіді передаються:

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ

**doc\_uuid** - ідентифікатор документа, якому належить квитанція

**ticket\_uuid** - ідентифікатор квитанції

**JSON приклад:**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити квитанцію №12 (прийняття запиту на анулювання COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER) POST /api/v2/eds/doc/repeal/accept

Підтвердити (прийняти) запит на анулювання документа **неможливо**, якщо документ:

<div class="admonition important" id="bkmrk-%D0%B0%D0%BD%D1%83%D0%BB%D1%8C%D0%BE%D0%B2%D0%B0%D0%BD%D0%BE-%28%D1%83-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5">- анульовано (у документа є квитанція №12)
- відсутнє запрошення анулювання (в документа **відсутня** квитанція №11)

</div>ЄДРПОУ в підписі має відповідати ЄДРПОУ, зазначеному в документі (наприклад, для COMDOC: \[КодКонтрагента\] або \[ІПН\] в одному з блоків \[ЕлектроннийДокумент/Сторони/Контрагент\])

**<span class="green">REQUEST</span>**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.2496%;"></col><col style="width: 84.7372%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/repeal/accept**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER

</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/pkcs7-signature

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

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

</td><td>В тілі запиту методу передаються підписані дані p7s в бінарному вигляді. Тобто передається підписане з Вашої сторони вхідне тіло документа до анулювання.

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

</div>**RESPONSE**

В тілі відповіді передаються:

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ

**doc\_uuid** - ідентифікатор документа, якому належить квитанція

**ticket\_uuid** - ідентифікатор квитанції

 **JSON приклад:**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити квитанцію №11 (запит на анулювання COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER) POST /api/v2/eds/doc/repeal

Створити запит на анулювання документа **неможливо**, якщо документ знаходиться в стані:

<div class="admonition important" id="bkmrk-%D0%B2%D1%96%D0%B4%D0%BA%D0%BB%D0%B8%D0%BA%D0%B0%D0%BD%D0%B8%D0%B9-%28%D0%B2-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC">- відкликаний (в документа є квитанція №14)
- відмовлений (в документа є квитанція №13)
- запрошено анулювання (в документа є квитанція №11)

</div>ЄДРПОУ в підписі має відповідати ЄДРПОУ, зазначеному в документі (наприклад, для COMDOC: \[КодКонтрагента\] або \[ІПН\] в одному з блоків \[ЕлектроннийДокумент/Сторони/Контрагент\])

**<span class="green">REQUEST</span>**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0105%;"></col><col style="width: 84.9763%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/repeal**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC/DOCUMENTINVOICE/TRANSPORTATIONORDER

</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/pkcs7-signature

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

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

</td><td>В тілі запиту методу передаються підписані дані p7s в бінарному вигляді. Тобто передається підписане xml тіло, отримане в результаті виконання методу [GET /api/v2/eds/doc/repeal](https://wiki-v2.edin.ua/link/288#bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F-%D0%BD%D0%B0-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80%D1%96))

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

</div>**RESPONSE**

В тілі відповіді передаються:

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ

**doc\_uuid** - ідентифікатор документа, якому належить квитанція

**ticket\_uuid** - ідентифікатор квитанції

**JSON приклад:**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити квитанцію №2 (прийняття документа COMDOC) POST /api/v2/eds/comdoc/accept

Прийняти документ COMDOC може лише отримувач документа до того, як документ змінить свій стан на:

<div class="admonition important" id="bkmrk-%D0%B2%D1%96%D0%B4%D0%BA%D0%BB%D0%B8%D0%BA%D0%B0%D0%BD%D0%B8%D0%B9-%28%D0%B2-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC">- відкликаний (в документа є квитанція №14)
- відмовлений (в документа є квитанція №13)
- анульований (в документа є квитанція №12)
- прийнятий (в документа є квитанція №2)

</div>ЄДРПОУ в підписі має відповідати \[КодКонтрагента\] або \[ІПН\] в одному з блоків \[ЕлектроннийДокумент/Сторони/Контрагент\]

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.2516%;"></col><col style="width: 84.7352%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/comdoc/accept**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC

</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/pkcs7-signature

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

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

</td><td>В тілі запиту методу передаються підписані дані p7s в бінарному вигляді

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

</div>**RESPONSE**

В тілі відповіді передаються:

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ

**doc\_uuid** - ідентифікатор документа, якому належить квитанція

**ticket\_uuid** - ідентифікатор квитанції

**Приклад (JSON):**

```json
{
  "chain_uuid": "7b6aef20-9f42-460e-9031-bb81c91e3b03",
  "doc_uuid": "e013510a-4267-4553-80f0-eb5ebabdfd05",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити квитанцію №1 (підпис чернетки) POST /api/v2/eds/doc/ticket

За допомогою цього методу можливо підписати чернетку документа (COMDOC, DECLAR, DECLARJ12, DOCUMENTINVOICE, KORINVOICE, DOCCORINVOICE, TRANSPORTATIONORDER).

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.2515%;"></col><col style="width: 84.7353%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/ticket**

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

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

**doc\_uuid** (обов’язково) 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>В тілі запиту методу передаються [дані для здійснення операції підписання](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-signs-dani-dlia-zdiisnennia-operaciyi-pidpisannia)

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

</div>**RESPONSE**

- **chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ
- **doc\_uuid** - ідентифікатор документа на платформі EDIN 2.0;
- **ticket\_uuid** - ідентифікатор квитанції

**JSON приклад відповіді:**

```json
{
  "chain_uuid": "7ccff78e-ea42-47ea-81e4-5508ed4fbd51",
  "doc_uuid": "3698b501-e1ef-464d-a71a-58066f556114",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Створити на сервері квитанцію «Повідомлення про відмову від підписання документу» (COMDOC_021) GET /api/v2/eds/doc/reject

Метод GET **api/v2/eds/doc/reject** може бути використаний для Відмови від підписання : Комерційних документів (сімейство COMDOC), [Накладних (DOCUMENTINVOICE)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice), [Додаток до договору 7А (METRO\_7A)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7a-metro-7a), [Додаток до договору 7Б (METRO\_7B)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7b-metro-7b), [Додаток до договору 7Ц (METRO\_7C)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/dodatok-do-dogovoru-7c-metro-7c), [«Заявка на транспортування» / «Підтвердження заявки на транспортування» (TRANSPORTATIONORDER)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/zaiavka-na-transportuvannia-pidtverdzennia-zaiavki-na-transportuvannia).

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1304%;"></col><col style="width: 84.8564%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/v2/eds/doc/reject**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC

**reason** - text; текст причини відмови/анулювання

**response\_type** (опціонально) - формат очікуваної відповіді; можливі варіанти:

- **json** (за замовчуванням)
- **xml**
- **json\_base64**
- **xml\_base64**

</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>

</div>**RESPONSE**

В тілі відповіді передається тіло згенерованого:

- [COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021) для анулювання Комерційних документів (COMDOC)
- [DOCUMENTINVOICE](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice) з DocumentFunctionCode=CNCL і сегментом Repealer для анулювання накладних DOCUMENTINVOICE
- [TRANSPORTATIONORDER](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/zaiavka-na-transportuvannia-pidtverdzennia-zaiavki-na-transportuvannia) для анулювання «Заявки на транспортування» / «Підтвердження заявки на транспортування»

в json форматі або форматі, обраному в запиті response\_type ([приклади відповіді](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-vidpovidi-pri-stvorenni-kvitanciyi-povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu)).

# Створити на сервері квитанцію «Повідомлення про відмову від підписання документу» (COMDOC_021) для COMDOC/TRANSPORTATIONORDER документів GET /api/v2/eds/comdoc/reject

<p class="callout danger">Наполегливо рекомендуємо використовувати замість даного методу новий метод **/api/v2/eds/doc/reject** [за посиланням](https://wiki-v2.edin.ua/books/robota-z-api/page/vidpraviti-vidmovu-vid-pidpisannia-stvorennia-kvitanciyi-13-post-apiv2edsdocreject).</p>

За допомогою GET методу **api/v2/eds/comdoc/reject** можливо створити документ COMDOC-відмову.

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1303%;"></col><col style="width: 84.8565%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/v2/eds/comdoc/reject**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа COMDOC

**reason** - text; текст причини відмови/анулювання

**response\_type** (опціонально) - формат очікуваної відповіді; можливі варіанти:

- **json** (за замовчуванням)
- **xml**
- **json\_base64**
- **xml\_base64**

</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>

</div>**RESPONSE**

В тілі відповіді передається тіло згенерованого COMDOC\_021 в json форматі або форматі, обраному в запиті response\_type ([приклади відповіді](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-vidpovidi-pri-stvorenni-kvitanciyi-povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu) + [специфікація COMDOC\_021](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu-comdoc-021))».

# Створити на сервері квитанцію «Анулювання» GET /api/v2/eds/doc/repeal

За допомогою цього методу можливо створити квитанцію для подальшого запуску «Анулювання».

**<span class="green">REQUEST</span>**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1304%;"></col><col style="width: 84.8564%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/v2/eds/doc/repeal**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта;

**doc\_uuid** - рядок; UUID документа, до якого потрібно виконати анулювання;

**reason** - text; текст причини відмови/анулювання;

**response\_type** (опціонально) - формат очікуваної відповіді; можливі варіанти:

- **json** (за замовчуванням)
- **xml**
- **json\_base64**
- **xml\_base64**

</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>

</div>**RESPONSE**

В тілі відповіді передається тіло згенерованого:

- [COMDOC\_019](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/anuliuvannia-comdoc-019) для анулювання Комерційних документів (COMDOC)
- [DOCUMENTINVOICE](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tovarnacinovavidatkova-nakladna-documentinvoice) з DocumentFunctionCode=RPLN і сегментом Repealer для анулювання накладних DOCUMENTINVOICE
- [TRANSPORTATIONORDER](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/zaiavka-na-transportuvannia-pidtverdzennia-zaiavki-na-transportuvannia) для анулювання «Заявки на транспортування» / «Підтвердження заявки на транспортування»

в json форматі або форматі обраному в запиті response\_type ([приклади відповіді](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-vidpovidi-pri-stvorenni-kvitanciyi-povidomlennia-pro-vidmovu-vid-pidpisannia-dokumentu)).

# Отримати дані/контент квитанції GET /api/eds/doc/ticket/body

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.01%;"></col><col style="width: 84.9768%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/ticket/body**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** - рядок; унікальний ідентифікатор організації в системі

**doc\_uuid** - рядок; UUID документа

**transaction\_type** - число; тип транзакції

- 1 - документ підписаний однією стороною (одним контрагентом)
- 2 - документ підписаний з обох сторін (двома контрагентами)
- 11 - запит на анулювання
- 12 - підтвердження анулювання
- 13 - відмова від підписання (з указуванням причини відмови)

**body\_type** - число; тип тіла квитанції (індекс контента)

- 1 - зміст підпису (контент в base64 форматі)

**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/octet-stream

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

</div>**RESPONSE**

В тілі відповіді в залежності від параметра body\_type передаються [дані підпису](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-signinfo-informaciia-pro-pidpis) (json) або контент підпису (base64).

# Отримати інформацію про підписантів за всіма вказаними транзакціями документа GET /api/v2/eds/doc/signers

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1283%;"></col><col style="width: 84.8585%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/v2/eds/doc/signers**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** (обов’язково) String - унікальний ідентифікатор організації в системі;

**doc\_uuid** (обов’язково) String - UUID документа;

**transaction\_type** (обов’язково) int - тип транзакції (параметр можливо передавати списком):

- 1 - документ підписаний однією стороною (одним контрагентом)
- 2 - документ підписаний з обох сторін (двома контрагентами)
- 11 - запит на анулювання
- 12 - підтвердження анулювання
- 13 - відмова від підписання (з указуванням причини відмови)

</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>

</div></div></div></div>**RESPONSE**

В тілі відповіді передається інформація про підписантів (об’єкт, що містить перелік номерів вказних в запиті транзакцій та масив об’єктів [ExEndUserSignInfo](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-exendusersigninfo-dani-pidpisantiv-dokumenta) з даними підписантів до кожної вказаної транзакції).

# Отримати інформацію про підписантів GET /api/eds/doc/signers

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.129%;"></col><col style="width: 84.8577%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/signers**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** - рядок; унікальний ідентифікатор організації в системі

**doc\_uuid** - рядок; UUID документа

**transaction\_type** - число; тип транзакції

- 1 - документ підписаний однією стороною (одним контрагентом)
- 2 - документ підписаний з обох сторін (двома контрагентами)
- 11 - запит на анулювання
- 12 - підтвердження анулювання
- 13 - відмова від підписання (з указанням причини відмови)

</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>

</div></div></div></div>**RESPONSE**

В тілі відповіді передається інформація про підписантів (масив об’єктів [ExEndUserSignInfo](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-exendusersigninfo-dani-pidpisantiv-dokumenta) ).

<p class="callout info">Якщо в квитанції відсутнє тіло з типом транзакції 1 і більше, то у відповіді методу передається порожній масив підписантів (наприклад, при відкликанні підписання документа COMDOC).</p>

# Отримати всі квитанції вказаного документа GET /api/eds/doc/tickets

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0095%;"></col><col style="width: 84.9773%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </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>

</div>**RESPONSE**

В тілі відповіді в залежності від наявності параметра **type** передаються масив об’єктів ([квитанції вказаного документа](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xticket)) в json форматі чи у вигляді zip-архіву.

# Отримати хеш вкладення (контейнера) документа для підписання GET /api/eds/doc/attachment/sign/hash

<p class="callout warning">Реалізовано на даний момент для наступних документів: [Універсальний/неструктурований документ (CONDRA)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0126%;"></col><col style="width: 84.9741%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/attachment/sign/hash**

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

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

**attachment\_uuid** (обов’язково) UUID - ідентифікатор файла-вкладення (параметр attachmentUUID в тілі відповіді при [додаванні файла](https://wiki-v2.edin.ua/link/292#bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B4%D0%BE-%D0%B4))

</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>

</div>**RESPONSE**

В тілі відповіді в текстовому вигляді передається хеш вкладення (контейнера) документа для підписання:

```json
mIDIAXJ6vWVwiuQ1LZ7pNxjOO1b/JuevNmRzfrUtpjU=
```

# Додати підпис до вкладень документа-чернетки POST /api/eds/doc/attachment/sign

<p class="callout warning">Реалізовано на даний момент для наступних документів: [Універсальний/неструктурований документ (CONDRA)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1317%;"></col><col style="width: 84.8551%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/attachment/sign**

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

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

**attachment\_uuid** (обов’язково) UUID - ідентифікатор файла-вкладення (параметр attachmentUUID в тілі відповіді при [додаванні файла](https://wiki-v2.edin.ua/link/292#bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B4%D0%BE-%D0%B4))

</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>В тілі запиту методу передається файл підпису p7s в base64 форматі.

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

</div>**RESPONSE**

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

# Роздрукувати вкладення документа GET /api/eds/doc/print

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1291%;"></col><col style="width: 84.8576%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/print**

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

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

**doc\_uuid** (обов’язково) - рядок; UUID документа

**response\_type** (опціонально) - [MIME типізація](https://uk.wikipedia.org/wiki/MIME_%D1%82%D0%B8%D0%BF) згідно типу файлу-вкладення

**attachment\_uuid** (обов’язково) UUID - ідентифікатор файла-вкладення (параметр attachmentUUID в тілі відповіді при [додаванні файла](https://wiki-v2.edin.ua/link/292#bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B4%D0%BE-%D0%B4))

</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>[MIME типізація](https://uk.wikipedia.org/wiki/MIME_%D1%82%D0%B8%D0%BF) згідно типу файлу-вкладення

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

</div></div></div></div>**RESPONSE**

В тілі відповіді передається принт-форма вкладення документа.

# Видалити файл-вкладення (чернетка) DELETE /api/eds/doc/attachment

<p class="callout warning">Кожен раз при видаленні одного вкладення підписи всіх інших вкладень документа видаляються.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-d"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.3682%;"></col><col style="width: 84.6185%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>DELETE

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

</td><td>**/api/eds/doc/attachment**

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

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

**attachment\_uuid** (обов’язково) UUID - ідентифікатор файла-вкладення (параметр attachmentUUID в тілі відповіді при [додаванні файла](https://wiki-v2.edin.ua/link/292#bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B4%D0%BE-%D0%B4))

**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>

</div>**RESPONSE**

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

# Отримати файл-вкладення GET /api/eds/doc/attachment

<p class="callout warning">Реалізовано на даний момент для наступних документів: [Універсальний/неструктурований документ (CONDRA)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)</p>

**REQUEST**

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

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/attachment**

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

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

**attachment\_uuid** (обов’язково) UUID - ідентифікатор файла-вкладення (параметр attachmentUUID в тілі відповіді при [додаванні файла](https://wiki-v2.edin.ua/link/292#bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B4%D0%BE-%D0%B4))

</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>[MIME типізація](https://uk.wikipedia.org/wiki/MIME_%D1%82%D0%B8%D0%BF) згідно типу файлу-вкладення

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

</div>**RESPONSE**

В тілі відповіді передається файл-вкладення.

# Додати файл до документа-чернетки POST /api/eds/doc/attachment

<p class="callout warning">Реалізовано на даний момент для наступних документів: [Універсальний/неструктурований документ (CONDRA)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)</p>

<p class="callout info">Один документ може містити не більше 10 файлів в наступних форматах: PDF/XLS/XLSX/DOC/DOCX/ODT/PPT/PPTX/JPG/BMP/PNG/XML/P7S з розміром файлу не більше 5 Мб. Назва файла не повинна перевищувати 100 символів. Кожен раз при додаванні нового вкладення підписи всіх інших вкладень документа видаляються.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.3695%;"></col><col style="width: 84.6173%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/attachment**

</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>multipart/form-data

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

</td><td> </td></tr><tr class="row-odd"><td>Form-data

</td><td>В тілі запиту передається 1 файл.

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

</div>**Приклад запиту:**

```json
boundary=----15217883902974046383107741460

----15217883902974046383107741460
Content-Disposition: form-data; name="file"; filename="name.pdf"
Content-Type: application/pdf

(data)
----15217883902974046383107741460
```

# Прийняти документ (CONDRA) PATCH /api/v2/eds/condra/confirm/send

<p class="callout warning">Підтвердити можна лише **вхідний** документ, за яким ще не відбувалось Підтвердження / Відхилення / Відкликання!</p>

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.2505%;"></col><col style="width: 84.7363%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**/api/v2/eds/condra/confirm/send**

</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

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

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

</td><td>В тілі запиту методу передається тіло документа в xml форматі ([специфікація документа CONDRA](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)).

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

</div>**RESPONSE**

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

# Відкликати документ (CONDRA). Створення квитанції №14. PATCH /api/v2/eds/condra/withdraw

<p class="callout warning">Відкликати можна лише **надісланий** документ, за яким ще не відбувалось Підтвердження / Відхилення / Відкликання!</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0124%;"></col><col style="width: 84.9744%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**/api/v2/eds/condra/withdraw**

</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

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

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

</td><td>В тілі запиту методу передається тіло документа в xml форматі ([специфікація документа CONDRA](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)).

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

</div>**RESPONSE**

В тілі **відповіді** передаються дані створеної квитанції документа (об’єкт [XTicket](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xticket)).

# Відхилити  документ (CONDRA). Створення квитанції №13. PATCH /api/v2/eds/condra/reject

<p class="callout warning">Відхилити можливо лише **вхідний** документ, за яким ще не відбувалось Підтвердження / Відхилення / Відкликання!</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0124%;"></col><col style="width: 84.9744%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**/api/v2/eds/condra/reject**

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

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

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

**message** (обов’язково) 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/xml

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

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

</td><td>В тілі запиту методу передається тіло документа в xml форматі ([специфікація документа CONDRA](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)).

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

</div>**RESPONSE**

В тілі відповіді передаються дані створеної квитанції документа (об’єкт [XTicket](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xticket) ).

# Підписати файл (для CONDRA) POST /api/eds/doc/body

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1335%;"></col><col style="width: 84.8532%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/body**

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

</td><td>**gln** (обов’язково) рядок (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта

АБО

**guid** (обов’язково) String - унікальний ідентифікатор організації на платформі EDIN 2.0

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

**family** (опціонально) int - сервіс (сімейство); допустимі значення:

- edi
- uzd

**content\_type** (обов’язково) String – тип тіла контента; можливі значення: hash\_sign (константа)

**body\_type** (обов’язково) String - тип тіла документа; можливі значення:

- content - base64 контент без підписів/печаток;
- json - json документа;
- sign - base64 тіло підпису;
- xml - тіло документа в xml форматі

</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>text/plain

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

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

</td><td>В тілі запиту методу передається p7s файл підпису в бінарному вигляді.

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

</div>**RESPONSE**

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

# Отримати UUID (для CONDRA) GET /api/office/uuid

За допомогою GET методу **/api/office/uuid** генерується один UUID. Для створення CONDRA потрібно запускати метод двічі.

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 78.5714%;"><colgroup><col style="width: 27.5781%;"></col><col style="width: 72.3925%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/office/uuid**

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

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

</td><td>**SID** - токен, отриманий при [авторизації](https://wiki.edin.ua/uk/latest/integration_2_0/APIv2/Methods/Authorization.html)

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

</td><td>application/json

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

</div>**RESPONSE**

В тілі відповіді в текстовому вигляді передається uuid - сгенерований унікальний ідентифікатор:

```json
c48f97e9-8d98-4c52-8635-675a6145f570
```

# Створити чернетку документа (для CONDRA) POST /api/eds/doc

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.247%;"></col><col style="width: 84.7397%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта АБО **guid** (обов’язково) String - унікальний ідентифікатор організації на платформі EDIN 2.0

**doc\_type** (обов’язково) String - тип документа ([опис параметру](https://wiki-v2.edin.ua/link/367#bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D1%8F-2.-%D0%9E%D0%BF%D0%B8%D1%81-%D1%82%D0%B8%D0%BF%D1%96))

**doc\_number** (обов’язково) String - номер документа

**doc\_date** (обов’язково) число - дата документа (в форматі UNIX-timestamp)

**recipient** (обов’язково) String (13) - gln отримувача

**family** (обов’язково) String (13) - сервіс (сімейство); допустимі значення:

- edi
- uzd
- ettn

**created\_from** (опціонально) String - ідентифікатор документа або ланцюжка

**created\_from\_doc\_id** (опціонально) 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 ([XML специфікації EDI документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/chapter/specifikaciyi-dokumentiv-servisu-edi-network) + [XML специфікації ETTN документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/chapter/specifikaciyi-dokumentiv-servisu-e-ttn-v3)). Приклад [тіла запиту для створення CONDRA](https://wiki-v2.edin.ua/books/robota-z-api/page/dani-tila-zapitu-shho-peredaiutsia-dlia-stvorennia-cernetki-condra).

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

</div>**RESPONSE**

В тілі відповіді в текстовому вигляді передається doc\_uuid - унікальний ідентифікатор документа:

```json
e64a304b-b0c0-454b-a361-5dc5d6987952
```

# Додати файл-вкладення (для CONDRA) POST /api/eds/doc/body

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1314%;"></col><col style="width: 84.8553%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/body**

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

</td><td>**gln** (обов’язково) рядок (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта

АБО

**guid** (обов’язково) String - унікальний ідентифікатор організації на платформі EDIN 2.0

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

**family** (опціонально) int - сервіс (сімейство); допустимі значення:

- edi
- uzd

**body\_type** (обов’язково) String - тип тіла документа; можливі значення:

- content - base64 контент без підписів/печаток;
- json - json документа;
- sign - base64 тіло підпису;
- xml - тіло документа в xml форматі

</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/pkcs7-signature – для p7s файла

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet – для Excel

… etc [MIME типізація](https://developer.mozilla.org/ru/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types)

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

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

</td><td>В тілі запиту методу передається тіло файла в бінарному вигляді.

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

</div>**RESPONSE**

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

# Створити й відправити «Універсальний/неструктурований документ» (CONDRA) без створення чернетки POST /api/v2/eds/doc/condra/create_and_send

За допомогою цього методу відбувається одночасне створення та відправка «Універсального/неструктурованого документа» (CONDRA).

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.1276%;"></col><col style="width: 84.8591%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/condra/create\_and\_send**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**recipient** (обов’язково) String (13) - GLN отримувача

**number** (обов’язково) String (32) - номер документа

**date** (обов’язково) YYYY-MM-DD - дата документа

**doctype** (обов’язково) String (1000) - [код підтипа документа](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)

**contractNumber** (опціонально) String (16) - номер договору

**contractDate** (опціонально) YYYY-MM-DD - дата договору

**summ** (опціонально) Число десяткове - сума документа

**delivery** (опціонально) String (13) - GLN місця доставки

</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>[multipart/form-data](https://tools.ietf.org/html/rfc7578)

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

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

</td><td>В тілі запиту методу передаються підписані чи непідписані файли-вкладення (не більше 10 файлів з розміром файлу не більше 5 Мб) в їх нативному форматі (розширення файлу змінювати не потрібно). [Приклади запитів](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-zapitu-pri-stvorenni-ta-vidpravci-universalnogonestrukturovanogo-dokumenta-condra) + [специфікація документа CONDRA](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra).

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

</div>**RESPONSE**

**doc\_uuid** - ідентифікатор документа на платформі EDIN 2.0;

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ.

**JSON приклад відповіді:**

```json
{
   "doc_uuid": "0ca98f00-6988-4aac-a660-8f289a24fe2d",
   "chain_uuid": "4838e8fe-c0aa-4fe9-ad78-74832d9e2b59"
}
```

# Створити чернетку «Універсального/неструктурованого документа» (CONDRA) POST /api/v2/eds/doc/condra/create

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.2563%;"></col><col style="width: 84.7305%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/condra/create**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**recipient** (обов’язково) String (13) - GLN отримувача

**number** (обов’язково) String (32) - номер документа

**date** (обов’язково) YYYY-MM-DD - дата документа

**doctype** (обов’язково) String (1000) - [код підтипа документа](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra)

**contractNumber** (опціонально) String (16) - номер договору

**contractDate** (опціонально) YYYY-MM-DD - дата договору

**summ** (опціонально) Число десяткове - сума документа

**delivery** (опціонально) String (13) - GLN місця доставки

</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>[multipart/form-data](https://tools.ietf.org/html/rfc7578)

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

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

</td><td>В тілі запиту методу передаються підписані чи непідписані файли-вкладення (не більше 10 файлів з розміром файлу не більше 5 Мб) в їх нативному форматі (розширення файлу змінювати не потрібно). [Приклади запитів](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-zapitu-pri-formuvanni-cernetki-universalnogonestrukturovanogo-dokumenta-condra) + [специфікація документа CONDRA](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/universalniinestrukturovanii-dokument-condra).

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

</div>**RESPONSE**

**doc\_uuid** - ідентифікатор документа на платформі EDIN 2.0;

**JSON приклад відповіді:**

```json
{
   "doc_uuid": "a066f658-e7fa-407d-b4bf-4b044fe5cc88"
}
```

# Відправити «Неструктурований (універсальний) документ» (CONDRA) PATCH /api/eds/doc/condra/send

Наявність ритейлера при документообізі автоматично визначається платформою (тобто якщо Відправник або Одержувач є ритейлером, то створений ланцюжок буде мати позначку конкретного ритейлера).

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.4907%;"></col><col style="width: 84.4961%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**/api/eds/doc/condra/send**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта АБО **guid** - рядок; унікальний ідентифікатор організації в системі

**doc\_uuid** - рядок; UUID документа

**doc\_hash** (опціонально) - рядок; хеш документа

**chain\_hash** (опціонально) - рядок; хеш ланцюжка

**chain\_uuid** (опціонально) - рядок; ID ланцюжка

**partner\_id** (опціонально) - число; id торгової мережі (можливо отримати з [довідника торгових мереж](https://wiki-v2.edin.ua/link/284#bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D0%B5%D1%80%D0%B5%D0%BB%D1%96%D0%BA%D1%83-%D1%80))

**chain\_type** (опціонально) - число; тип ланцюжка документів;

- 0 - звичайний
- 2 - особлива схема - MATCH INVOICE (ТМ Фоззі)
- 3 - особлива схема - не MATCH INVOICE (ТМ Фоззі)

</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>text/plain; charset=UTF-8

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

</div>**RESPONSE**

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

# Завантажити «Неструктурований (універсальний) документ» (CONDRA) в вигляді архіву GET /api/eds/doc/condra/body

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 19.4241%;"></col><col style="width: 80.5627%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/condra/body**

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

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

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

**file\_name** (обов’язково) 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/octet-stream

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

</div>**RESPONSE**

У тілі відповіді передається архів (.zip), що містить тіло документа CONDRA (.xml), файли-вкладення (оригінали або контейнери тіл підпису (.p7s) + листи підписання кожного вкладення (.pdf), якщо вкладення з підписами).

# Отримати статус документа POST /api/v2/eds/docs/state

Метод дозволяє користувачеві отримати статус вхідного/відправленого документа (документів).

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 98.4524%;"><colgroup><col style="width: 26.0994%;"></col><col style="width: 73.887%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/docs/state**

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

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

</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>Масив UUID документів через кому, наприклад:

```json
["44f3cf03-e2a3-4f8b-aae1-cafeb28fe699", "fb56e025-9c4d-4936-b889-087c6d5c837d"]
```

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

</div> **RESPONSE**

В тілі відповіді передається інформація про стан документа (exchange\_status і де можливо: sub\_status\_id).

**JSON приклад відповіді:**

```json
{
"44f3cf03-e2a3-4f8b-aae1-cafeb28fe699": {
    "sub_status_id": "1",
    "exchange_status": "000000000000000000000001"
    },
"fb56e025-9c4d-4936-b889-087c6d5c837d": {
    "sub_status_id": "1",
    "exchange_status": "000000000000000000000001"
    }
}
```

# Одночасне прийняття, підписання та відправка двох пов’язаних документів POST /api/eds/docs_and_tickets

Даний метод однією дією (одночасно) виконує Прийняття [«Акта приймання-передачі (додаток 8)» (COMDOC\_032)](https://wiki.edin.ua/uk/latest/ClientProcesses/ATB/ATB_XML-structure.html#comdoc-032) (створення квитанції) та Відправку пов’язаного [«Акта приймання-передачі (додаток 8)» (COMDOC\_033)](https://wiki.edin.ua/uk/latest/ClientProcesses/ATB/ATB_XML-structure.html#comdoc-033) без чернетки (подібно до послідовного виконання [/api/v2/eds/comdoc/accept](https://wiki-v2.edin.ua/link/288#bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F-%D0%BA%D0%B2%D0%B8%D1%82%D0%B0%D0%BD%D1%86%D1%96%D1%97--1) та [/api/eds/doc/create\_and\_send](https://wiki-v2.edin.ua/link/286#bkmrk-%D0%92%D1%96%D0%B4%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0-)).

<p class="callout warning">Якщо під час виконання методу під час перевірок буде виявлена логічна помилка на будь-якому етапі, то жодні дії не будуть виконані. Тобто або підписуються обидва документа, або жоден.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 15.0151%;"></col><col style="width: 84.9716%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/docs\_and\_tickets**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

</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>[multipart/form-data](https://tools.ietf.org/html/rfc7578)

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

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

</td><td>В тілі запиту методу передаються два файли-вкладення пов’язаних документів (рекомендовано в p7s форматі (в бінарному вигляді чи в base64)) та їх дані в об’єкті [DocumentRequest](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-documentrequest-dani-poviazanix-dokumentiv)

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

</div>**Повний приклад запиту:**

```json
POST /api/eds/docs_and_tickets?gln=9864066822430 HTTP/1.1
Host: localhost:8084
Authorization: 9e04baf1-f33b-4e76-8657-5212bae7a9z5
Content-Length: 590
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="files"; filename="comdoc_32_from_atb.p7s"
Content-Type: <Content-Type header here>

(data)
----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="documents"

{"documents":[{"fileName":"comdoc_32_from_atb.p7s","type":"comdoc"},{"fileName":"comdoc_33_from_atb.p7s","type":"comdoc"}]}
----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="files"; filename="comdoc_33_from_atb.p7s"
Content-Type: <Content-Type header here>

(data)
----WebKitFormBoundary7MA4YWxkTrZu0gW
```

**RESPONSE**

**doc\_uuid** - ідентифікатор документа на платформі EDIN 2.0;

**chain\_uuid** - ідентифікатор ланцюжка, в якому знаходиться документ;

**ticket\_uuid** - ідентифікатор квитанції.

**JSON приклад відповіді:**

```json
{
   "comdoc_32_from_atb.p7s": {
      "doc_uuid": "fdae7e57-3706-4599-90e2-1a5ebee71512",
      "chain_uuid": "d62f1b6e-7400-4bc3-ba5b-7e5d7931adbc",
      "ticket_uuid": "411f23ee-ab07-472f-a1e2-7155a7631ff8"
   }, - це для тікета
   "comdoc_33_from_atb.p7s": {
      "doc_uuid": "b45f5906-9a6b-45d9-adb1-0cc527d260c4",
      "chain_uuid": "d62f1b6e-7400-4bc3-ba5b-7e5d7931adbc"
   } - це для документа
}
```

# Відправити транзакції до «Резерву товару» PRDRSRVN (зміни в табличній частині) POST /api/eds/doc/prdrsrvn/transaction

<p class="callout info">Виконувати дії з документом можливо на будь-якому етапі, однак поки оригінальний документ не буде старше 5 днів.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.8934%;"></col><col style="width: 85.0933%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/prdrsrvn/transaction**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**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-platformihttps://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

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

</td><td>`<span class="pre">application/json</span>` або `<span class="pre">application/xml</span>`

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

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

</td><td>В тілі запиту методу передається тіло документа (контент) в json/xml форматі ([xml-специфікація документа Резерв товару (PRDRSRVN)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/rezerv-tovaru-prdrsrvn))

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

</div>**RESPONSE**

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

# Отримати тіло документів (json) за вказаними UUID POST /api/v2/eds/doc/content

<p class="callout info">Обмеження: не більше 50 документів одним запитом!</p>

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 79.2857%;"><colgroup><col style="width: 26.3694%;"></col><col style="width: 73.6051%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc/content**

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

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

</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>Масив UUID документів через кому

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

</div>**Приклад запиту:**

```json
["8b441f1f-a209-4331-b848-5d01766f3a5c", "07d369fe-6f17-4d7a-94d4-9fe0ccad9379"]
```

**RESPONSE**

В тілі відповіді передаються дані тіл документів в json форматі.

**JSON приклад відповіді:**

```json
{
    "07d369fe-6f17-4d7a-94d4-9fe0ccad9379": "{\"DATE\":\"2023-05-16\",\"HEAD\":[{\"SENDER\":\"9864065732181\",\"POSITION\":[{\"POSITIONNUMBER\":1,\"PRODUCT\":\"1231231002\",\"QUANTITYOFCUINTU\":45,\"QUANTITY\":\"10\",\"PRODUCTIDBUYER\":\"11111\",\"DELIVERYPLACE\":\"9864065732211\"}],\"RECIPIENT\":\"9864065732211\",\"SUPPLIER\":\"9864065732181\",\"DELIVERYPLACE\":\"9864065732211\",\"BUYER\":\"9864065732211\"}],\"NUMBER\":\"1111\",\"ORDERNUMBER\":\"1111111\",\"ORDERDATE\":\"2023-05-01\",\"DELIVERYDATE\":\"2023-05-02\",\"AMOUNT\":\"100000\",\"CURRENCY\":\"UAH\",\"DELIVERYINFO\":\"доп\"}",
    "8b441f1f-a209-4331-b848-5d01766f3a5b": "{\"title\":{\"number\":\"17301/1010101\",\"type\":\"Акт виконаних робіт\",\"code\":\"013\",\"date\":\"2023-05-18\",\"place_of\":\"м. Київ\",\"doc_basis\":[{\"number\":\"111\",\"type\":\"Договір\",\"code\":\"001\",\"date\":\"2023-05-01\"}]},\"parties\":{\"partners\":[{\"status\":\"Продавець\",\"type\":\"Юридична\",\"name\":\"Товариство з обмеженою відповідальністю \\\"Імпульс Схід\\\"\",\"code\":\"40824037\",\"inn\":\"408240313043\",\"gln\":\"9864065732181\"},{\"status\":\"Покупець\",\"type\":\"Юридична\",\"name\":\"ПрАТ \\\"Монделіс Україна\\\"\",\"code\":\"00382220\",\"inn\":\"003822218163\",\"gln\":\"9864065732211\"}]},\"table\":{\"position\":[{\"position_number\":\"1\",\"description\":\"Відшкодування витрат за гарантії\",\"qty_received\":1.0,\"unit\":\"послуга\",\"price_base\":21309.99,\"vat\":0.0,\"price\":21309.99,\"total\":{\"sum_without_vat\":21309.99,\"sum_vat\":0.0,\"sum\":21309.99},\"id\":\"1\"}]},\"total\":{\"sum_without_vat\":21309.99,\"vat\":0.0,\"sum\":21309.99}}"
}
```

# Видалити документи-чернетки PATCH /api/eds/docs

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.2264%;"></col><col style="width: 86.7604%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**/api/eds/docs**

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

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

**family** (опціонально) UUID - сервіс/сімейство документів; можливі значення: edi

**detailed\_response** (опціонально) boolean - false за замовчуванням; при detailed\_response = true, то у відповідь повернеться додатково статус видалення по кожному документу (success/failed)

</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>В тілі запиту методу передається масив ідентифікаторів документів-чернеток до видалення, наприклад: `<span class="pre">[«345b68bb-552b-4d0e-8091-a5991f16250c»,«a751981c-1abf-4268-afac-c2389948fe54»]</span>`

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

</div>**RESPONSE**

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

# Отримати інформацію про підпис/підписантів GET /api/eds/doc/attachment/sign/info

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.9412%;"></col><col style="width: 86.0456%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/attachment/sign/info**

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

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

**attachment\_uuid** (обов’язково) UUID - ідентифікатор файла-вкладення (параметр attachmentUUID в тілі відповіді при [додаванні файла](https://wiki-v2.edin.ua/link/292#bkmrk-%D0%94%D0%BE%D0%B4%D0%B0%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F-%D1%84%D0%B0%D0%B9%D0%BB%D1%83-%D0%B4%D0%BE-%D0%B4))

</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>

</div>**RESPONSE**

В тілі відповіді передається інформація про підписантів (масив об’єктів [ExEndUserSignInfo](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-exendusersigninfo-dani-pidpisantiv-dokumenta)).

# Отримати реєстр документів в xls форматі GET /api/eds/doc/reports/doctype

<p class="callout warning">Обмеження! Реєстр можливо отримати за період, що не перевищує 31 добу та лише для певних типів документів.</p>

Перелік типів документів, для яких можна отримати реєстр:

<div class="admonition- admonition" id="bkmrk-%C2%AB%D0%97%D0%B0%D0%BC%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F%C2%BB-%28orders">- «Замовлення» (ORDERS)
- «Повідомлення про відвантаження» (DESADV)
- «Підтвердження замовлення» (ORDRSP)
- «Повідомлення про прийом» (RECADV)
- «Рахунок» (INVOICE)
- «Накладні» (DOCUMENTIVOICE) загалом чи за вказаним [підтипом](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/pidtipi-elektronnix-dokumentiv) : «Товарна накладна»/»Цінова накладна»/»Видаткова накладна»/»Накладна за кількістю» (DOCUMENTINVOICE з DocumentFunctionCode=DRN/PRN/TN)
- «Комерційні документи» (COMDOC) загалом чи за вказаним [підтипом](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/pidtipi-elektronnix-dokumentiv) «Комерційного документа»

</div><div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 12.8666%;"></col><col style="width: 87.1202%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/reports/doctype**

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

</td><td>**gln** (обов’язково) - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** (обов’язково) - рядок; унікальний ідентифікатор організації в системі

**doc\_type\_id** (обов’язково) - число; [id типу документа](https://wiki-v2.edin.ua/link/367#bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D1%8F-2.-%D0%9E%D0%BF%D0%B8%D1%81-%D1%82%D0%B8%D0%BF%D1%96). Доступні значення: 1,2,3,4,5,28,59,67

**sub\_doc\_type\_id** (опціонально) - число; [id підтипу документа](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/pidtipi-elektronnix-dokumentiv)

**date\_from** (опціонально) - початок періоду виборки в UNIX-форматі (якщо не вказано, то поточна дата мінус 31 день)

**date\_to** (опціонально) - кінець періоду виборки в UNIX-форматі (якщо не вказано, то поточна дата)

**sender** (обов’язково) - рядок (13); номер GLN відправника документів АБО **recipient** (обов’язково) - рядок (13); номер GLN отримувача документів АБО **partner** (обов’язково) - id рітейлера (торгової мережі)

</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>

</div>**RESPONSE**

У тілі відповіді передається звіт у вигляді xlsx-файлу з даними документів.

# Архівувати / Розархівувати ланцюжок документів PATCH /api/eds/chain/archive

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.2991%;"></col><col style="width: 85.6877%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**api/eds/chain/archive**

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

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

**chain\_uuid** (обов’язково) String - унікальний ідентифікатор ланцюжка документів;

**archive** (обов’язково) boolean - визначає дію:

- true - Архівувати (перенести в Архів);
- false - Розархівувати (винести з архіву)

</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>

</div>**RESPONSE**

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

# Заповнити індекси (додавання / оновлення полів екстрапараметрів) PUT /api/eds/doc/extra_fields

<p class="callout info">Заповнення індексів необхідно для коректного відображення та пошуку документів. По факту це повтор «Створення CONDRA», але з іншими полями. Якщо на попередньому кроці отримали помилку, то необхідно переривати подальше виконання запитів.</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.1792%;"></col><col style="width: 85.8076%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PUT

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

</td><td>**/api/eds/doc/extra\_fields**

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

</td><td>**gln** (обов’язково) рядок (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта

АБО

**guid** (обов’язково) String - унікальний ідентифікатор організації на платформі EDIN 2.0

**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>В тілі запиту методу передаються [додаткові поля (поля екстрапараметрів)](https://wiki-v2.edin.ua/link/395#bkmrk-%D0%9E%D0%BF%D0%B8%D1%81-extra_fields%C2%A0%D0%BF%D0%B0). Приклад [індексації CONDRA та TRANSPORTATIONORDER](https://wiki-v2.edin.ua/books/robota-z-api/page/prikladi-dodavannia-onovlennia-poliv-ekstraparametriv)

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

</div>**RESPONSE**

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

# Редагувати чернетку документа PUT /api/eds/doc

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.058%;"></col><col style="width: 85.9288%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PUT

</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 на рівні аккаунта

**doc\_uuid** (обов’язково) UUID - унікальний ідентифікатор документа

**doc\_number** (обов’язково) String - номер документа

**doc\_date** (обов’язково) Число - дата документа (в форматі UNIX-timestamp)

**recipient** (опціонально) Число (13) - GLN отримувача

**family** (опціонально) String (13) - сервіс (сімейство); допустимі значення:

- edi
- uzd

</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 ([XML специфікації EDI документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/chapter/specifikaciyi-dokumentiv-servisu-edi-network) + [XML специфікації ETTN документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/chapter/specifikaciyi-dokumentiv-servisu-e-ttn-v3)). Приклад [тіла запиту для редагування CONDRA](https://wiki-v2.edin.ua/books/robota-z-api/page/dani-tila-zapitu-shho-peredaiutsia-dlia-stvorennia-cernetki-condra).

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

</div>**RESPONSE**

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

# Отримати статус документа GET /api/eds/doc/statuses

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.3435%;"></col><col style="width: 86.6432%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/statuses**

</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>

</div>**RESPONSE**

У тілі відповідь передається статус вказаного документа (об’єкт [XStatus](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xstatus) ).

# Відправити статус документа POST /api/eds/doc/statuses

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.0561%;"></col><col style="width: 85.9307%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/statuses**

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

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

**doc\_uuid** (обов’язково) рядок - UUID документа;

**type** (обов’язково) число - статус документа;

- 0 - позитивний (прийнято)
- 1 - негативний (відхилено)
- 5 - **Отримувач** відхиляє документ
- 6 - **Ініціатор** відхиляє документ

**sub\_status** (опціонально) число - сабстатус документа (не використовується для ТТН v3 та пов’язаних Актів):

- 5 - **Отримувач** відхиляє документ, наприклад:
    
    <div>
    - Перевізник відхиляє Заявку на транспортування
    
    </div>
- 6 - **Ініціатор** відхиляє документ, наприклад:
    
    <div>
    - Замовник відхиляє Заявку на транспортування
    - Перевізник відхиляє Підтвердження заявки на транспортування
    
    </div>

Взаємовиключаючі параметри:

- **recipient** (опціонально) рядок (13) - gln Відправника документа. Якщо Отримувач документа відправляє запит без *recipient* параметра, то цей статус буде відображатись лише на стороні ініціатора запиту (Отримувача документа);
- **for\_all** (опціонально) - якщо параметр передається, то статус створиться для всіх учасників документа.

</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>В тілі запиту методу передається вільний текст (причина, наприклад, для відхилення/відмови/анулювання)

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

</div>**RESPONSE**

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

# Завантажити тіло документа/підпису GET /api/eds/doc/download

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 12.6308%;"></col><col style="width: 87.356%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/download**

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

</td><td>**gln** - String (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта; АБО **guid** - String; GUID організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - UUID; UUID документа

**file\_name** (опціонально) - String; назва файлу для завантаження

**format** (опціонально) - String; формат файлу для завантаження (якщо не вказано - ZIP); можливі варіанти:

- XLS
- PDF
- XML
- P7S
- ZIP

**response\_type** (опціонально) - String; формат відповіді сервера (якщо не вказано - file); можливі варіанти:

- bytes - відповідь передається в бінарному вигляді;
- file - відповідь передається у вигляді файла з розширенням

</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/octet-stream

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

</div>**RESPONSE**

У тілі відповідь передається тіло вказаного документа/підпису чи архів з усіма доступними форматами файлів.

# Отримати XML контент документа GET /api/eds/doc/xml

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.1812%;"></col><col style="width: 85.8056%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/xml**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_uuid** - рядок; UUID документа

**response\_type** (опціонально) - формат очікуваної відповіді; можливі варіанти:

- `<span class="pre">bytes</span>` - xml файл (за замовчуванням)
- `<span class="pre">zip</span>` - архів, який містить xml файл і всі супровідні до нього файли (якщо документ типу COMDOC, то в архіві буде xml файл і всі його підписи)
- `<span class="pre">base64</span>` - xml файл в форматі Base64

</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>

</div>**RESPONSE**

В тілі відповіді передається XML контента документа ([специфікації документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tipi-elektronnix-dokumentiv)).

# Отримати контент документа GET /api/eds/doc/body

За допомогою цього методу можливо швидко отримати контент документа без підписів/печаток, а також тіло підпису, тіло печатки.

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.9409%;"></col><col style="width: 86.0458%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/body**

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

</td><td>**gln** (обов’язково) String (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні аккаунта

АБО

**guid** (обов’язково) String - унікальний ідентифікатор організації на платформі EDIN 2.0

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

**body\_type** (обов’язково) String - тип тіла документа; можливі значення:

- content - base64 контент без підписів/печаток;
- json - json документа;
- sign - base64 тіло підпису;
- xml - тіло документа в xml форматі;

**response\_type** (опціонально) String - формат очікуваної відповіді; можливі варіанти:

- **bytes** (за замовчуванням)
- **file**
- **base64**

</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>

</div>**RESPONSE**

В тілі відповіді передається тіло документа в форматі, що визначається значенням параметра **body\_type**.

# Отримати ланцюжки вхідних документів POST /api/eds/chains/search

За допомогою цього методу можна зробити пошук ланцюжків по заданих критеріях.

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p-1"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.6565%;"></col><col style="width: 85.3303%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/chains/search**

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

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

**status\_id** (опціонально) int - id папки документів:

- 0 - Всі
- 1 - Вхідні
- 2 - Надіслані
- 3 - Архівні
- 4 - Чернетки
- 5 - Важливі.

**family** (опціонально) String - назва сімейства документів:

- edi
- uzd
- certificats
- ats
- ettn
- distribex (Маркет)
- simple-doc (Вільний)
- tender
- agreement
- openprice (Є-Товар).

</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>В тілі запиту методу передаються [обов’язкові та додаткові критерії пошуку/фільтрації](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-storagequery-dani-dlia-filtraciyi)

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

</div>**RESPONSE**

В тілі відповіді передається масив об’єктів [XChain](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xchain).

# Отримати конкретний ланцюжок документів GET /api/eds/chain

Документи пов’язуються в один ланцюжок в тому випадку, якщо у них ідентичні значення полів **Відправник**, **Одержувач**, **Покупець**, **Точка доставки** (GLN-и) і **Номер замовлення** (якщо відсутній, то **Номер документа**).

[![EdsChain_01.png](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/scaled-1680-/9z3orTXVgvT6o1ZJ-edschain-01.png)](https://wiki-v2.edin.ua/uploads/images/gallery/2025-09/9z3orTXVgvT6o1ZJ-edschain-01.png)

За допомогою методу **api/eds/chain** і заданих параметрів можливо отримати (вивантажити) необхідні дані вказаного ланцюжка документів.

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/chain**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**chain\_uuid** - рядок; ID ланцюжка

**Опціональні url-параметри (boolean фільтри):**

**load\_docs** - чи завантажувати документи, що відносяться до ланцюжка

**load\_bodies** - чи завантажувати тіла документів

**load\_package** - чи завантажувати пакети

**load\_comments** - чи завантажувати коментарі

**load\_tags** - чи завантажувати теги до документів

**load\_statuses** - чи завантажувати статуси до документів

</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>

</div>**Приклади url-запитів:**

- Отримати перелік документів за визначеним ланцюжком без завантаження їхніх тіл, пакетів, коментарів, тегів і статусів:

[https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&amp;chain\_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&amp;load\_docs=true&amp;load\_bodies=false&amp;load\_package=false&amp;load\_comments=false&amp;load\_tags=false&amp;load\_statuses=false](https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&chain_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&load_docs=true&load_bodies=false&load_package=false&load_comments=false&load_tags=false&load_statuses=false)

<div class="section" id="bkmrk--3"></div>- Отримати перелік документів за визначеним ланцюжком з завантаженням тіл і коментарів без завантаження їхніх пакетів, тегів і статусів:

[https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&amp;chain\_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&amp;load\_docs=true&amp;load\_bodies=true&amp;load\_package=false&amp;load\_comments=true&amp;load\_tags=false&amp;load\_statuses=false](https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&chain_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&load_docs=true&load_bodies=true&load_package=false&load_comments=true&load_tags=false&load_statuses=false)

<div class="section" id="bkmrk--4"></div>- Отримати перелік документів за визначеним ланцюжком з завантаженням пакетів, тегів без завантаження їхніх тіл і коментарів і статусів:

[https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&amp;chain\_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&amp;load\_docs=true&amp;load\_bodies=false&amp;load\_package=true&amp;load\_comments=false&amp;load\_tags=true&amp;load\_statuses=false](https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&chain_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&load_docs=true&load_bodies=false&load_package=true&load_comments=false&load_tags=true&load_statuses=false)

<div class="section" id="bkmrk--5"></div>- Отримати перелік документів за визначеним ланцюжком з завантаженням статусів без завантаження їхніх тіл, коментарів, пакетів, тегів:

[https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&amp;chain\_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&amp;load\_docs=true&amp;load\_bodies=false&amp;load\_package=false&amp;load\_comments=false&amp;load\_tags=false&amp;load\_statuses=true](https://edo-v2.edin.ua/api/eds/chain?gln=9864232304302&chain_uuid=0fe60377-51db-4b7a-b7eb-cdf5fa91a46a&load_docs=true&load_bodies=false&load_package=false&load_comments=false&load_tags=false&load_statuses=true)

**RESPONSE**

В тілі відповіді передається ланцюжок документів (об’єкт [XChain](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xchain)).

# Отримати інформацію (мета-дані) про документ GET /api/eds/doc

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.54%;"></col><col style="width: 85.4468%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </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>

</div>**RESPONSE**

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

# Пошук документів (з фільтрацією), вибір списку документів POST /api/eds/docs/search

За допомогою цього методу можна зробити пошук по заданих критеріях, наприклад, отримати список документів з певним статусом або за проміжок часу.

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.4646%;"></col><col style="width: 86.5221%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/docs/search**

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

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

**status\_id** (опціонально) int - id папки документів:

- 0 - Всі
- 1 - Вхідні;
- 2 - Надіслані;
- 3 - Архівні;
- 4 - Чернетки;
- 5 - Важливі.

**family** (опціонально) String - назва сімейства документів:

- edi
- uzd
- certificats
- ats
- ettn
- distribex (Маркет)
- simple-doc (Вільний)
- tender
- agreement
- openprice (Є-Товар)

</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>В тілі запиту методу передаються [обов’язкові та додаткові критерії пошуку/фільтрації](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-storagequery-dani-dlia-filtraciyi)

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

</div>**RESPONSE**

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

# Відправити документ (без створення чернетки) POST /api/eds/doc/create_and_send

Метод є універсальним для різних типів документів і дозволяє одночасно створити та відправити документ без створення чернетки.

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 14.0633%;"></col><col style="width: 85.9235%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/eds/doc/create\_and\_send**

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

</td><td>**gln** - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_type** - рядок; тип документа ([опис параметру](https://wiki-v2.edin.ua/link/367#bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D1%8F-2.-%D0%9E%D0%BF%D0%B8%D1%81-%D1%82%D0%B8%D0%BF%D1%96))

</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>[multipart/form-data](https://tools.ietf.org/html/rfc7578)

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

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

</td><td>В тілі запиту методу передєються тільки **один файл-вкладення** в форматі `<span class="pre">application/json</span>` чи `<span class="pre">application/xml</span>` чи `<span class="pre">application/pkcs7-signature</span>` ([приклади запитів](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-zapitu-pri-vidpravci-dokumenta-bez-stvorennia-cernetki) + [специфікації документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tipi-elektronnix-dokumentiv))

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

</div></div></div></div><p class="callout info">При вказуванні `<span class="pre">application/pkcs7-signature</span>` доступна можливість обробки BASE64 формату.</p>

**RESPONSE**

<div class="document" id="bkmrk-chain_uuid%C2%A0--%D1%96%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section">- chain\_uuid - ідентифікатор ланцюжка, в якому знаходиться документ
- doc\_uuid - ідентифікатор документа на платформі EDIN 2.0;
- ticket\_uuid - ідентифікатор квитанції

</div></div></div><p class="callout info">Параметр ticket\_uuid система повертає тільки у випадках, коли на існуючий документ намагаються створити додатковий тікет (підписання у відповідь, відмова від підпису, запит на анулювання). Тобто, якщо документ новий, система поверне у відповідь тільки chain\_uuid та doc\_uuid.</p>

**Приклад відповіді (JSON):**

```json
{
  "chain_uuid": "7ccff78e-ea42-47ea-81e4-5508ed4fbd51",
  "doc_uuid": "3698b501-e1ef-464d-a71a-58066f556114",
  "ticket_uuid": "1003706c-3656-497b-9438-c6f33e27c36d"
}
```

# Відправити чернетку PATCH /api/eds/doc/send

За допомогою цього методу можлива відправка чернетки (з додатковими особливостями відправки).

<p class="callout info">Наявність ритейлера при документообігу автоматично визначається платформою (тобто якщо Відправник або Одержувач є ритейлером, то створений ланцюжок буде мати позначку конкретного ритейлера).</p>

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p"><table class="colwidths-given docutils align-default"><colgroup><col></col><col></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>PATCH

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

</td><td>**/api/eds/doc/send**

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

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

**doc\_uuid** (обов’язково) String - унікальний ідентифікатор документа;

**doc\_hash** (опціонально) - рядок; хеш документа;

**chain\_hash** (опціонально) - рядок; хеш ланцюжка документів;

**chain\_uuid** (опціонально) - рядок; ID ланцюжка документів;

**partner\_id** (опціонально) - число; id торгової мережі (можливо отримати з [довідника торгових мереж](https://wiki-v2.edin.ua/link/284#bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D0%BF%D0%B5%D1%80%D0%B5%D0%BB%D1%96%D0%BA%D1%83-%D0%B2));

**chain\_type** (опціонально) - число; тип ланцюжка документів;

- 0 - звичайний
- 2 - особлива схема - MATCH INVOICE (ТМ Фоззі)
- 3 - особлива схема - не MATCH INVOICE (ТМ Фоззі)

</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>В тілі запиту методу опціонально передаються [додаткові поля](https://wiki-v2.edin.ua/books/robota-z-api/page/dodatkovi-polia-extra-fields)

**Виняток:** при відправці

- «Заявки на транспортування» / «Підтвердження транспортування» (TRANSPORTATIONORDER)
- «Комерційних документів» (COMDOC)
- «Накладних» (DOCUMENTINVOICE)
- «Коригування до накладної» (DOCCORINVOICE)

в тілі запиту обов’язково передається параметр sub\_status\_id.

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

</div>Приклад для відправки «Заявки на транспортування» / «Підтвердження транспортування» (TRANSPORTATIONORDER):

```json
{"extra_fields":{"sub_status_id":"1"}}
```

**RESPONSE**

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

# Створити чернетку документа / Клонувати відправлений документ (COMDOC) POST /api/v2/eds/doc

<p class="callout info">За допомогою цього методу можливо створити чернетку документа (передається тіло документа) зазначеного типу (параметр doc\_type) для вказаного одержувача АБО можливо клонувати відправлений документ (передається параметр clone\_from\_doc\_uuid) в чернетку.</p>

**REQUEST**

<div class="document" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-p" itemscope="itemscope" itemtype="http://schema.org/Article" role="main"><div itemprop="articleBody"><div class="section"><div class="wy-table-responsive"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 13.2264%;"></col><col style="width: 86.7604%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td>**/api/v2/eds/doc**

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

</td><td>**gln** (обов’язково) рядок (13) - номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта

**doc\_type** (обов’язково/-) рядок - тип створюваного документа ([опис параметру](https://wiki-v2.edin.ua/link/367#bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D1%8F-2.-%D0%9E%D0%BF%D0%B8%D1%81-%D1%82%D0%B8%D0%BF%D1%96)); даний параметр не передається при клонуванні документа (коли передається **clone\_from\_doc\_uuid** параметр);

**clone\_from\_doc\_uuid** (обов’язково/-) рядок - унікальний ідентифікатор вже відправленого документа (COMDOC) для клонування в чернетку (при цьому тіло передавати не обов’язково, а Content-Type=application/json); даний параметр не передається при створенні чернетки документа

</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>`<span class="pre">application/json</span>` або `<span class="pre">application/xml</span>` або `<span class="pre">application/pkcs7-signature</span>`

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

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

</td><td>При створенні чернетки в тілі запиту методу передається документ у форматі JSON або XML або P7S в бінарному вигляді ([приклад запиту (в тому числі й для створення CONDRA та TRANSPORTATIONORDER)](https://wiki-v2.edin.ua/books/robota-z-api/page/priklad-zapitu-na-stvorennia-dokumenta-cernetki) + [специфікації документів](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/tipi-elektronnix-dokumentiv))

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

</div></div></div></div>**RESPONSE**

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

# Отримати останню подію за документом GET /api/eds/docs/event/last

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 78.6905%;"><colgroup><col style="width: 23.3171%;"></col><col style="width: 76.6423%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td>**/api/eds/doc/event/last**

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

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

**doc\_id** (обов’язково) - ідентифікатор документа

</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>

</div>**RESPONSE**

В тілі **відповіді** передається остання подія за документом (об'єкт[ XEvent](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xevent-podiia-za-dokumentom)).

# Отримати список подій GET /api/eds/docs/events

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 78.5714%;"><colgroup><col style="width: 23.3171%;"></col><col style="width: 76.6423%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>GET

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

</td><td><div><div>/api/eds/docs/events</div></div></td></tr><tr class="row-even"><td>URL параметри

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

<div><div>**from\_id** (обов'язково) long - ідентифікатор події, після якої (починаючи з наступної) необхідно отримати список наступних подій</div><div><div><div>**grouped** (опціонально) boolean:</div>- true - згрупувати події за документами;
- false - не групувати (за замовчуванням)

</div></div></div></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>

</div>**RESPONSE**

В тілі **відповіді** передається список подій за документами (масив об'єктів [XEvent](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xevent-podiia-za-dokumentom)).

# Пошук подій POST /api/eds/docs/events

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 87.7381%;"><colgroup><col style="width: 26.4271%;"></col><col style="width: 73.5427%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td> </td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

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

</td><td><div><div>/api/eds/docs/events</div></div></td></tr><tr class="row-even"><td>URL параметри

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

</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><td>**REQUEST**

</td><td> </td></tr><tr><td>JSON Body

</td><td>В тілі запиту методу передаються [параметри пошуку подій за документами](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-eventsstoragequery-parametri-posuku-podii)

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

</div>**RESPONSE**

В тілі **відповіді** передаються результати пошуку подій за документами (об’єкт [EventsStorageQueryResult](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-eventsstoragequeryresult-rezultati-posuku-podii-za-dokumentami)).

# Підписати документ за допомогою КНЕДП EDIN ID POST /api/eds/doc/edin_id/sign

Метод використовується для підписання чернетки без відправки, підписання з одночасною відправкою та підписання вхідних документів у відповідь за допомогою КНЕДП EDIN ID. Якщо за документом запущено процес узгодження, підписати його цим роутом неможливо. Використовується для підписання наступних документів:

- Комерційні документи (COMDOC)
- Універсальний документ (CONDRA)
- Товарна/цінова/видаткова накладна (DOCUMENTINVOICE)
- Коригування до товарної накладної (DOCCORINVOICE)

**REQUEST**

<div class="wy-table-responsive" id="bkmrk-url-%C2%A0-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%B7%D0%B0%D0%BF%D0%B8%D1%82%D1%83-g"><table class="colwidths-given docutils align-default" style="width: 97.619%; height: 676.476px;"><colgroup><col style="width: 19.5244%;"></col><col style="width: 80.4463%;"></col></colgroup><tbody><tr class="row-odd" style="height: 29.6px;"><td style="height: 29.6px;">**URL**

</td><td style="height: 29.6px;"> </td></tr><tr class="row-even" style="height: 29.6px;"><td style="height: 29.6px;">Метод запиту

</td><td style="height: 29.6px;"> POST

</td></tr><tr class="row-odd" style="height: 29.6px;"><td style="height: 29.6px;">URL запиту

</td><td style="height: 29.6px;">**/api/eds/doc/edin\_id/sign**

</td></tr><tr class="row-even" style="height: 153.85px;"><td style="height: 153.85px;">URL параметри

</td><td style="height: 153.85px;">**gln** (обов’язково) String - GLN власної компанії.

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

**send** (опційно) - ознака відправки отримувачу:

- true - підписати і відправити;
- false - лише підписати, не відправляти (за замовчуванням).

Для вхідного документа підписання відбувається з обов'язковою відправкою отримувачу.

**append\_sign** (опційно) - ознака додавання/заміни підпису:

- true - додасть підписи до вже існуючих, якщо такі є
- false - замінить новими підписами існуючі (за замовчуванням)

Для вхідного документа підписання відбувається лише з додаванням підпису, заміна підпису заборонена.

</td></tr><tr class="row-odd" style="height: 29.6px;"><td style="height: 29.6px;">**Headers**

</td><td style="height: 29.6px;"> </td></tr><tr class="row-even" style="height: 35.2px;"><td style="height: 35.2px;">Authorization

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

</td></tr><tr style="height: 30.9125px;"><td style="height: 30.9125px;">x-edinid-system-id

</td><td style="height: 30.9125px;">Токен `x-system-id` підключення до EDIN.ID (обов'язково)

</td></tr><tr class="row-odd" style="height: 29.6px;"><td style="height: 29.6px;">Content-Type

</td><td style="height: 29.6px;">application/json

</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">**REQUEST**

</td><td style="height: 29.6px;"></td></tr><tr style="height: 278.913px;"><td style="height: 278.913px;">JSON Body

</td><td style="height: 278.913px;">У тілі запиту передається масив з паролями до ключів **підпису/печатки** в EDIN ID, зашифрованими RSA-публічним ключем EDIN ID і закодованими у base64. Для підписання вхідного документа у відповідь усі підписи треба передати в `keys` одразу.

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

```json
{
    "keys": {
        "00ccb011-5b58-4602-a3c0-b9c73f2a6a2e": "LX3YvHb06pw6q/9tyxLDYgS18GRdoRTjB+Kbd84tcd3ru/RiJpecwhBaM9lUDAX+4AkEe2D79wG5dpQDJOZm5n/xgf81+TZlHb6U8h6V38JTsbeFHFWRBVxpReTgK4dREknRcNeXUjnSjp6eKnofmvAOjoxPt82MmQzVAme0JaQ=",
        "47facc78-48aa-4ab5-88ad-3924a3cbeeb5": "LX3YvHb06pw6q/9tyxLDYgS18GRdoRTjB+Kbd84tcd3ru/RiJpecwhBaM9lUDAX+4AkEe2D79wG5dpQDJOZm5n/xgf81+TZlHb6U8h6V38JTsbeFHFWRBVxpReTgK4dREknRcNeXUjnSjp6eKnofmvAOjoxPt82MmQzVAme0JaQ="
    }
}
```

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

</div>**RESPONSE**

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