# API сервісу Е-Сертифікати

# Перелік методів API сервісу Е-Сертифікати

<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 border="1" 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="border-collapse: collapse; width: 100%; height: 326.487px;"><colgroup><col style="width: 53.265%;"></col><col style="width: 46.7112%;"></col></colgroup><tbody><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Створити сертифікат</td><td style="height: 29.6806px;">[POST /api/ecs/certificate](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-sertifikat-post-apiecscertificate)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Оновити сертифікат</td><td style="height: 29.6806px;">[PUT /api/ecs/certificate](https://wiki-v2.edin.ua/books/robota-z-api/page/onoviti-sertifikat-put-apiecscertificate)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Отримати сертифікат</td><td style="height: 29.6806px;">[GET /api/ecs/certificate](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-sertifikat-get-apiecscertificate)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Видалити сертифікат</td><td style="height: 29.6806px;">[DELETE /api/ecs/certificate](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-sertifikat-delete-apiecscertificate)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Архівувати / розархівувати сертифікат</td><td style="height: 29.6806px;">[PUT /api/ecs/archive](https://wiki-v2.edin.ua/books/robota-z-api/page/arxivuvati-rozarxivuvati-sertifikat-put-apiecsarchive)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Задати / змінити тип доступу до сертифіката</td><td style="height: 29.6806px;">[PUT /api/ecs/access](https://wiki-v2.edin.ua/books/robota-z-api/page/zadatizminiti-tip-dostupu-do-sertifikata-put-apiecsaccess)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Копіювати сертифікат</td><td style="height: 29.6806px;">[PUT /api/ecs/copy](https://wiki-v2.edin.ua/books/robota-z-api/page/kopiiuvati-sertifikat-put-apiecscopy)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Знайти сертифікат / сертифікати</td><td style="height: 29.6806px;">[POST /api/ecs/search](https://wiki-v2.edin.ua/books/robota-z-api/page/znaiti-sertifikat-ti-post-apiecssearch)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Додати (прив'язати) товари до сертифіката</td><td style="height: 29.6806px;">[PUT /api/ecs/products](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-priviazati-tovari-do-sertifikata-put-apiecsproducts)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Масово завантажити сертифікати</td><td style="height: 29.6806px;">[POST /api/ecs/certificates](https://wiki-v2.edin.ua/books/robota-z-api/page/masovo-zavantaziti-sertifikati-post-apiecscertificates)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;"><span class="doc">Створити сертифікат з типом «Декларація виробника» (CERTDOC)</span>

</td><td style="height: 29.6806px;">[POST /api/ecs/certdoc](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-sertifikat-z-tipom-deklaraciia-virobnika-certdoc-post-apiecscertdoc)</td></tr></tbody></table>

##### **Робота з вкладеннями до сертифікатів**

<table border="1" id="bkmrk-%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B8%D1%82%D0%B8-%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%B5%D0%BD%D0%BD%D1%8F-%D0%B4" style="border-collapse: collapse; width: 100%; height: 326.487px;"><colgroup><col style="width: 53.3842%;"></col><col style="width: 46.7112%;"></col></colgroup><tbody><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Створити вкладення до сертифіката</td><td style="height: 29.6806px;">[POST /api/ecs/body](https://wiki-v2.edin.ua/books/robota-z-api/page/stvoriti-vkladennia-do-sertifikatu-post-apiecsbody)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Додати нові вкладення до сертифіката</td><td style="height: 29.6806px;">[PUT /api/ecs/body](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-novi-vkladennia-do-sertifikata-put-apiecsbody)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Отримати контент вкладення до сертифіката</td><td style="height: 29.6806px;">[GET /api/ecs/body](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-kontent-vkladennia-do-sertifikata-get-apiecsbody)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Видалити всі вкладення до сертифіката</td><td style="height: 29.6806px;">[DELETE /api/ecs/body](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-vsi-vkladennia-sertifikata-delete-apiecsbody)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Отримати вкладення до сертифіката в PDF</td><td style="height: 29.6806px;">[GET /api/ecs/body/download](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-vkladennia-do-sertifikata-v-pdf-get-apiecsbodydownload)</td></tr><tr><td>Підписати вкладення до сертифіката</td><td>[POST /api/ecs/certificate/sign](https://wiki-v2.edin.ua/books/robota-z-api/page/pidpisati-vkladennia-do-sertifikata-post-apiecscertificatesign)

</td></tr><tr><td style="background-color: rgb(236, 240, 241);">Отримати дані про підписання вкладення до сертифіката</td><td style="background-color: rgb(236, 240, 241);">[GET /api/ecs/certificate/sign](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-dani-pro-pidpisannia-vkladennia-do-sertifikata-get-apiecscertificatesign)</td></tr></tbody></table>

##### **Робота з пов'язаними відвантаженнями**

<table border="1" id="bkmrk-%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D1%82%D0%B8-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D1%96%D0%B4%D0%B2" style="border-collapse: collapse; width: 100%; height: 326.487px;"><colgroup><col style="width: 53.3842%;"></col><col style="width: 46.592%;"></col></colgroup><tbody><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Отримати список відвантажень по сертифікату</td><td style="height: 29.6806px;">[GET /api/ecs/certificate/shipments](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimati-spisok-vidvantazen-po-sertifikatu-get-apiecscertificateshipments)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Додати відвантаження в список відвантажень по сертифікату</td><td style="height: 29.6806px;">[POST /api/ecs/certificate/shipments](https://wiki-v2.edin.ua/books/robota-z-api/page/dodati-vidvantazennia-v-spisok-vidvantazen-po-sertifikatu-post-apiecscertificateshipments)</td></tr><tr style="height: 29.6806px; background-color: rgb(236, 240, 241);"><td style="height: 29.6806px;">Редагувати дані відвантаження</td><td style="height: 29.6806px;">[PATCH /api/ecs/certificate/shipments](https://wiki-v2.edin.ua/books/robota-z-api/page/redaguvati-dani-vidvantazennia-patch-apiecscertificateshipments)</td></tr><tr style="height: 29.6806px;"><td style="height: 29.6806px;">Видалити відвантаження з сертифікату</td><td style="height: 29.6806px;">[DELETE /api/ecs/certificate/shipments](https://wiki-v2.edin.ua/books/robota-z-api/page/vidaliti-vidvantazenia-z-sertifikatu-delete-apiecscertificateshipments)</td></tr></tbody></table>

# Опис помилок сервісу «Е-Сертифікати»

<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"><colgroup><col></col><col></col><col></col><col></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\_CRT-1

</td><td>Unknown certificate type: %s

Тип сертифіката некоректний: %s

</td><td>Невідомий тип сертифіката при зміні типа доступа (PUT, «/api/ecs/access»)

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

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

</td><td>Search query error: %s

Помилка пошукового запиту: %s

</td><td>Некоректне тіло запита (POST, «/api/ecs/search»)

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

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

</td><td>Certificate with UUID \[%s\] not found

Сертифікат із указаним UUID \[%s\] не знайдено

</td><td>Сертифікат не знайдено (GET, «/api/ecs/certificate»)

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

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

</td><td>Data validation errors detected

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

</td><td>Помилки при опрацюванні сертифікатів, завантажених із excel (POST, «/api/ecs/certificates»)

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

##### **Опис помилки при масовому завантаженні сертифікатів**

Якщо в сертифікатах, що передаються буде допущена помилка, то Ви отримаєте відповідь про помилку в файлі, наприклад:

```
{
    "certificatesErrors":
    {
        "2":
        [
            {
                "errorType": 1,
                "columnName": "Тип сертификату"
            },
            {
                "errorType": 2,
                "columnName": "Тип сертификату"
            },
            {
                "errorType": 1,
                "columnName": "Номер сертифікату"
            },
            {
                "errorType": 1,
                "columnName": "Дата видачі"
            },
            {
                "errorType": 1,
                "columnName": "Вид сертифікату"
            },
            {
                "errorType": 2,
                "columnName": "Вид сертифікату"
            },
            {
                "errorType": 1,
                "columnName": "Дата закінчення дії",
                "cause": "Вид сертифікату = 1"
            },
            {
                "errorType": 1,
                "columnName": "Номер партії",
                "cause": "Вид сертифікату = 2"
            },
            {
                "errorType": 1,
                "columnName": "Дата початку дії"
            },
            {
                "errorType": 1,
                "columnName": "Назва файлу"
            },
            {
                "errorType": 2,
                "columnName": "Назва файлу",
                "allowedValues": "[pdf, jpg, jpeg, png, tiff]",
                "fileName": "filename.txt"
            },
            {
                "errorType": 3,
                "columnName": "Назва файлу",
                "fileName": "filename.pdf"
            },
            {
                "errorType": 4,
                "columnName": "Назва файлу",
                "fileName": "filename.pdf"
            }
        ]
    },
    "productsErrors":
    {
        "2":
        [
            {
                "errorType": 1,
                "columnName": "Номер сертифікату"
            }
        ]
    },
    "createdCertificates":
    [],
    "existedCertificates":
    [],
    "certsCount": 0,
    "productsCount": 0
}
```

**Опис параметрів помилки**

<div class="wy-table-responsive" id="bkmrk-%D0%9F%D0%BE%D0%BB%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81-certificat"><table class="colwidths-given docutils align-default" style="width: 100%;"><colgroup><col style="width: 28.2403%;"></col><col style="width: 71.7359%;"></col></colgroup><thead><tr class="row-odd"><td>Поле

</td><td>Опис

</td></tr></thead><tbody><tr class="row-even"><td>**certificatesErrors**/**productsErrors**

</td><td>об’єкт; починається з номера *рядка сертифіката / рядка тварної позиції (відповідно)*, де була допущена помилка. Містить параметри:

- <dl class="simple"><dt>**errorType** - тип помилки:</dt><dd>
    - 1 - Незаповнене обов’язкове поле, для цього значення помилка може містити поле **cause** (причина чому воно має бути обов’язкове, як у випадку з Дата закінчення дії або Номер партії;
    - 2 - Некоректне значення поля, для цього поля також є поле **allowedValues**, це для помилки з Ім’ям файлу; для цього значення помилка може містити поле **fileName**;
    - 3 - Файл з іменем файла вказаним в колонці Імя файлу не знайдено в zip-архіві; для цього значення помилка може містити поле **fileName**;
    - 4 - Файл з іменем файла вказаним в колонці Імя файлу занадто великий; для цього значення помилка може містити поле **fileName**.
    
    </dd></dl>
- **columnName** - назва колонки;

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

</td><td>масив; номера створених сертифікатів

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

</td><td>масив; номера існуючих сертифікатів

</td></tr><tr class="row-odd"><td>**certsCount** - кількість сертифікатів (рядків на 1-му листі xls/xlsx-файлу)

</td><td> </td></tr><tr class="row-even"><td>**productsCount** - кількість товарних позицій (рядків на 2-му листі xls/xlsx-файлу)

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

</div>

# Видалити відвантаженя з сертифікату DELETE /api/ecs/certificate/shipments

За допомогою цього методу можна із сертифікату видалити відвантаження по їхньому id.

**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-2"><table class="colwidths-given docutils align-default" style="width: 78.5714%;"><colgroup><col style="width: 20.1715%;"></col><col style="width: 79.809%;"></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/ecs/certificate/shipments**

</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>В тілі запиту передається JSON масив ідентифікаторів відвантажень.

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

```json
[11,7]
```

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

</div>**RESPONSE**

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

# Редагувати дані відвантаження PATCH /api/ecs/certificate/shipments

**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: 173.69%;"><colgroup><col style="width: 16.691%;"></col><col style="width: 83.2957%;"></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/ecs/certificate/shipments**

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

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

```json
[{"id":11,"creatorId":13202937,"number":"shipment_11","date":1740269800,"buyer":"9864065750135"},{"id":7,"creatorId":13202937,"number":"shipment_7","date":1740169800,"buyer":"9864065750119"}]
```

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

</div>**RESPONSE**

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

# Додати відвантаження в список відвантажень по сертифікату POST /api/ecs/certificate/shipments

**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: 127.262%;"><colgroup><col style="width: 14.6593%;"></col><col style="width: 85.3275%;"></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/ecs/certificate/shipments**

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

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

**uuid** (обов'язково) - сертифіката, обовязковий  
**limit** (необовязково) - якщо не передається, значення за замовчуванням 20  
**offset** (необовязково) - якщо не передається, значення за замовчуванням 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>application/json

</td></tr><tr><td>**REQUEST**

</td><td></td></tr><tr><td>JSON Body

</td><td>В тілі запиту передається JSON масив параметрів відвантаження (об'єкт [XCertificateShipment](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xcertificateshipment)).

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

```json
[{"number":"shipment_1","date":"1740169800","buyer":"9864065750119"},{"number":"shipment_4","date":"1740336908","buyer":"9864065750148"}]
```

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

</div>**RESPONSE**

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

# Отримати список відвантажень по сертифікату GET /api/ecs/certificate/shipments

**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.8095%;"><colgroup><col style="width: 23.804%;"></col><col style="width: 76.173%;"></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/ecs/certificate/shipments**

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

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

**uuid** (обовязково) - ідентифікатор сертифіката  
**limit** (необовязково) - якщо не передали, значення 20  
**offset** (необовязково) - якщо не передали, значення 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>application/json

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

</div>**RESPONSE**

У відповідь отримується JSON масив об'єктів з даними відвантажень, пов'язаних з обраним сертифікатом (об'єкти [XCertificateShipment](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xcertificateshipment)).

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

```json
[{"id":9,"creatorId":13202937,"number":"shipment_2","date":1740369800,"buyer":"9864065750117"},{"id":15,"creatorId":13202937,"number":"shipment_3","date":1740269800,"buyer":"9864065750135"},{"id":13,"creatorId":13202937,"number":"shipment_1","date":1740169800,"buyer":"9864065750119"}]
```

# Отримати вкладення до сертифіката в PDF GET /api/ecs/body/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: 78.8095%;"><tbody><tr class="row-odd"><td style="width: 21.0195%;">**URL**

</td><td style="width: 78.9602%;"> </td></tr><tr class="row-even"><td style="width: 21.0195%;">Метод запиту

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

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

</td><td style="width: 78.9602%;">**/api/ecs/body/download**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

**body\_type** (обов’язково) int - тип тіла:

- 1 - вкладення до сертифіката;
- 2 - base64 контент без підписів/печаток;
- 3- sign, base64 тіло підпису

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

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

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

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

</td><td style="width: 78.9602%;">application/pdf

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

</div>**RESPONSE**

У тілі **відповіді** передається

- pdf файл з вкладеннями, якщо **body\_type: 1**.
- p7s файл, якщо **body\_type: 2.**

# Видалити всі вкладення сертифіката DELETE /api/ecs/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-d"><table class="colwidths-given docutils align-default" style="width: 79.2857%;"><colgroup><col style="width: 20.2974%;"></col><col style="width: 79.6859%;"></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/ecs/body**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

**body\_type** (обов’язково) int - тип тіла:

- 1 - вкладення до сертифіката

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

</div>**RESPONSE**

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

# Отримати контент вкладення до сертифіката GET /api/ecs/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: 78.9286%;"><colgroup><col style="width: 21.0195%;"></col><col style="width: 78.9602%;"></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/ecs/body**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

**body\_type** (обов’язково) int - тип тіла:

- 1 - вкладення до сертифіката

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

</div>**RESPONSE**

У тілі відповіді передається контент сформованого pdf файлу з вкладеннями у вигляді base64 рядка.

# Додати нові вкладення до сертифіката PUT /api/ecs/body

<p class="callout info">Максимальний розмір файлу для завантаження - 7,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: 102.262%;"><colgroup><col style="width: 14.42%;"></col><col style="width: 85.5667%;"></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/ecs/body**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

**body\_type** (обов’язково) int - тип тіла:

- 1 - вкладення до сертифіката

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

</td><td>В тілі запиту передаються файли вкладень в форматі PDF, JPG, JPEG, PNG, TIFF. Всі файли, що передаються будуть автоматично об’єднані в один PDF файл.

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

```json
-----------------------------28001198861666343170695798896
Content-Disposition: form-data; name="files[]"; filename="istockphoto-1154370446-612x612.png"
Content-Type: image/png

(data)

-----------------------------28001198861666343170695798896
Content-Disposition: form-data; name="files[]"; filename="photo-1518020382113-a7e8fc38eac9.jpeg"
Content-Type: image/jpeg

(data)

-----------------------------28001198861666343170695798896--
```

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

</div>**RESPONSE**

У тілі відповіді передається контент сформованого pdf файлу з вкладеннями у вигляді base64 рядка.

# Створити вкладення до сертифікату POST /api/ecs/body

<p class="callout info">Максимальний розмір файлу для завантаження - 7,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: 15.1362%;"></col><col style="width: 84.8506%;"></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/ecs/body**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

**body\_type** (обов’язково) int - тип тіла:

- 1 - вкладення до сертифіката

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

</td><td>В тілі запиту передаються файли вкладень в форматі PDF, JPG, JPEG, PNG, TIFF. Всі файли, що передаються будуть автоматично об’єднані в один PDF файл.

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

</div>Приклад запиту:

```json
-----------------------------28001198861666343170695798896
Content-Disposition: form-data; name="files[]"; filename="istockphoto-1154370446-612x612.png"
Content-Type: image/png

(data)

-----------------------------28001198861666343170695798896
Content-Disposition: form-data; name="files[]"; filename="photo-1518020382113-a7e8fc38eac9.jpeg"
Content-Type: image/jpeg

(data)

-----------------------------28001198861666343170695798896--
```

**RESPONSE**

У тілі відповіді передається контент сформованого pdf файлу з вкладеннями у вигляді base64 рядка.

# Створити сертифікат з типом «Декларація виробника» (CERTDOC) POST /api/ecs/certdoc

**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: 78.5714%;"><colgroup><col style="width: 17.9937%;"></col><col style="width: 81.9889%;"></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/ecs/certdoc**

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

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

**publish** (необов’язково) 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>[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>Form-data

</td><td>В тілі запиту передається XML файл сертифіката.

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

</div>**RESPONSE**

У тілі відповіді передається унікальний ідентифікатор (UUID) створеного сертифіката, наприклад:

 `<span class="pre">55ef04b2-281e-4fca-bb67-d48fe88ae74f</span>`.

# Масово завантажити сертифікати POST /api/ecs/certificates

<p class="callout info">Максимальний розмір файлу для завантаження - 7,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.6575%;"></col><col style="width: 85.3293%;"></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/ecs/certificates**

</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>[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>В тілі запиту передається zip-файл, що містить файли-вкладення (в форматі PDF, JPG, JPEG, PNG, TIFF) та заповнений xls/xlsx шаблон з зазначеними назвами файлів-вкладень.

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

</div>**Приклад передаваємого zip знаходиться у вкладенні до цієї сторінки (ліва бокова панель).**

**RESPONSE**

У тілі відповіді передаються [дані завантажених сертифікатів](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xcertificate-dani-sertifikata) (масив об’єктів XCertificate).

<p class="callout info">Якщо в сертифікатах, що передаються, буде допущена помилка, то Ви отримаєте [відповідь про помилку в файлі](https://wiki-v2.edin.ua/link/579#bkmrk-%D0%9E%D0%BF%D0%B8%D1%81-%D0%BF%D0%BE%D0%BC%D0%B8%D0%BB%D0%BA%D0%B8-%D0%BF%D1%80%D0%B8-%D0%BC%D0%B0%D1%81).</p>

# Додати (прив’язати) товари до сертифіката PUT /api/ecs/products

<p class="callout info">Якщо продукт уже прив’язаний до сертифіката і в тілі передано його ідентифікатор (XCertificateProduct.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"><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/ecs/products**

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

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

**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/books/robota-z-api/page/objekt-xcertificateproduct-dani-tovariv), що прив’язуються до сертифіката (масив об’єктів XCertificateProduct).

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

</div>**RESPONSE**

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

# Знайти сертифікат/-ти POST /api/ecs/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: 78.5714%;"><colgroup><col style="width: 17.9937%;"></col><col style="width: 81.9889%;"></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/ecs/search**

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

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

**owner\_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>В тілі запиту методу передаються дані для фільтрації (об’єкт [XQueryCertificates](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-xquerycertificates))

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

</div>**RESPONSE**

В тілі відповіді передаються [дані про сертифікати](https://wiki-v2.edin.ua/books/robota-z-api/page/dani-pro-sertifikat).

# Копіювати сертифікат PUT /api/ecs/copy

**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"><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/ecs/copy**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

**company\_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></tbody></table>

</div>**RESPONSE**

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

# Задати/змінити тип доступу до сертифіката PUT /api/ecs/access

**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.1757%;"></col><col style="width: 85.811%;"></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/ecs/access**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката (можливо передавати кілька в одному запиті)

**type** (обов’язково) String - тип доступу, можливі значення:

- private - обмежений доступ
- public - публічний доступ

</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>Тіло очікується лише при **type=private**: тіло запиту в форматі Map&lt;Long, Boolean&gt;, де ключ - це intGlnID кому відкрито доступ, а значення true/false - чи буде дозволено даному intGlnID репостити цей сертифікат комусь іще.

Приклад тіла запиту:

<div><div class="cm-editor ͼ1 ͼ2 ͼ4 ͼ1p"><div class="cm-scroller" tabindex="-1"><div aria-hidden="true" class="cm-gutters cm-gutters-before"><div class="cm-gutter cm-lineNumbers"><div class="cm-gutterElement">1</div></div></div><div aria-multiline="true" aria-readonly="true" autocapitalize="off" autocorrect="off" class="cm-content" contenteditable="true" role="textbox" spellcheck="false" translate="no" writingsuggestions="false"><div class="cm-line">[[13203393,false],[13203397,false]]</div></div></div></div></div></td></tr></tbody></table>

</div>**RESPONSE**

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

# Архівувати / розархівувати сертифікат PUT /api/ecs/archive

Дія «архівувати» / «розархівувати» залежить від того, де перебуває сертифікат до виконання метода:

<div class="admonition hint" id="bkmrk-%D1%8F%D0%BA%D1%89%D0%BE-%D1%81%D0%B5%D1%80%D1%82%D0%B8%D1%84%D1%96%D0%BA%D0%B0%D1%82-%D0%B2%C2%A0%D0%90%D1%80">- якщо сертифікат в **Архіві**, то виконається розархівування;
- якщо сертифікат в **Опублікованих**, то виконається архівування.

</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: 78.5714%;"><colgroup><col style="width: 21.0195%;"></col><col style="width: 78.9602%;"></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/ecs/archive**

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

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

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

</div>**RESPONSE**

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

# Видалити сертифікат DELETE /api/ecs/certificate

**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: 78.6905%;"><colgroup><col style="width: 21.0195%;"></col><col style="width: 78.9602%;"></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/ecs/certificate**

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

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

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

</div>**RESPONSE**

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

# Отримати сертифікат GET /api/ecs/certificate

**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.8095%;"><tbody><tr class="row-odd"><td style="width: 18.7526%;">**URL**

</td><td style="width: 81.2305%;"> </td></tr><tr class="row-even"><td style="width: 18.7526%;">Метод запиту

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

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

</td><td style="width: 81.2305%;">**/api/ecs/certificate**

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

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

**uuid** (обов’язково) UUID - унікальний ідентифікатор сертифіката

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

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

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

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

</div>**RESPONSE**

В тілі відповіді передаються [дані про сертифікат](https://wiki-v2.edin.ua/books/robota-z-api/page/dani-pro-sertifikat).

# Оновити сертифікат PUT /api/ecs/certificate

**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: 78.8095%;"><colgroup><col style="width: 22.196%;"></col><col style="width: 77.7825%;"></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/ecs/certificate**

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

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

</div>**RESPONSE**

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

# Створити сертифікат POST /api/ecs/certificate

**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: 78.6905%;"><colgroup><col style="width: 22.196%;"></col><col style="width: 77.7825%;"></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/ecs/certificate**

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

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

</div>**RESPONSE**

У тілі відповіді передається унікальний ідентифікатор (UUID) створеного сертифіката, наприклад: `<span class="pre">55ef04b2-281e-4fca-bb67-d48fe88ae74f</span>`.

# Підписати вкладення до сертифіката POST /api/ecs/certificate/sign

<p class="callout info">Для підпису доступні тільки сертифікати в стані чернетки із завантаженим вкладенням. Підписувати може тільки користувач з GLN, який створив даний сертифікат.</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.7747%;"></col><col style="width: 85.1928%;"></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/ecs/certificate/sign**

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

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

**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/octet-stream

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

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

# Отримати дані про підписання вкладення до сертифіката GET /api/ecs/certificate/sign

**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: 97.8571%;"><colgroup><col style="width: 16.3203%;"></col><col style="width: 83.7682%;"></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/ecs/certificate/sign**

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

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

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

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

В тілі **відповіді** (json) передається інформація про підписантів (масив об’єктів [ExEndUserSignInfo](https://wiki-v2.edin.ua/books/robota-z-api/page/objekt-exendusersigninfo-dani-pidpisantiv-dokumenta) ).