# Підписання даних сервісу (збереження підпису) POST /api/eds/doc/ettn/sign

<p class="callout warning">Формат підпису повинен відповідати стандарту CAdES-X Long (детальніше — у [специфікації](https://uakey.com.ua/news/main/cades-x-long-format-dlja-dovgotrivalogo-zbergannja-kep))</p>

> **Підписання в сервісі «ЕТТН» можна здійснювати двома способами:**
> 
> 1. <span style="background-color: rgb(255, 255, 255);">**Через ECMR тіло документа**</span>
>     
>     
>     - [Отримати тіло документа сервісу «ЕТТН» у форматі ECMR](https://wiki-v2.edin.ua/books/robota-z-api/page/zavantazennia-tila-dokumenta-u-formati-jsonxmlecmrpdfzip-get-apiedsdocettnbody)
>     - Підписати отримане ECMR тіло (результат — p7s-файл підпису)
>     - Конвертувати p7s у base64 — цей результат передається у масиві тіла запиту
> 2. <span style="background-color: rgb(255, 255, 255);">**Через sign\_hash (extra\_fields)**</span>
>     
>     
>     - [Отримати `sign_hash` (extra\_fields) документа сервісу «ЕТТН»](https://wiki-v2.edin.ua/books/robota-z-api/page/otrimannia-informaciyi-meta-danix-pro-dokument-get-apiedsdoc)
>     - Підписати значення `sign_hash` (результат — p7s-файл підпису)
>     - Конвертувати p7s у base64 — цей результат передається у масиві тіла запиту

<p class="callout info">Перепідписання документа (оновлення підпису повторним викликом методу) дозволяється лише до моменту відправки документа контрагенту.</p>

##### **REQUEST**

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

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

</td><td style="width: 84.9241%;">POST

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

</td><td style="width: 84.9241%;">/api/eds/doc/ettn/sign

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

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

**role\_code** (обов’язково) String - код ролі учасника-підписанта:

- CZ - Вантажовідправник;
- CN - Вантажоодержувач;
- DR - Водій;
- CA - Перевізник;
- OB - Замовник;
- WD - Проміжний склад, що приймає вантаж;
- WH - Проміжний склад, що здає вантаж;
- <dl class="simple"><dt>Для **Акта перевантаження**:</dt><dd>
    - CA - Водій / Перевізник, що здає вантаж;
    - OV - Перевізник, що здає вантаж;
    - DR - Водій, що приймає вантаж;
    - CH - Водій / Перевізник, що приймає вантаж
    
    </dd></dl>

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

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

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

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

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

</td><td style="width: 84.9241%;"> </td></tr><tr class="row-even"><td style="width: 15.0759%;">JSON Body

</td><td style="width: 84.9241%;">В тілі запиту методу передається масив файлів підпису p7s в base64 форматі.

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

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

```json
["ZGZkZmRmZGZkZmRmdnh2dmM==", "ZGZkZmRmZGZkZmRmdnh2dmM=="]
```

##### **RESPONSE**

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