# Підписати документ за допомогою КНЕДП 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.5315%;"></col><col style="width: 80.4456%;"></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;">**1. Загальні параметри:**

**gln** (обов’язково) String - GLN власної компанії.

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

**2. Параметри для EDI-документів:**

**send** (опційно) - ознака відправки отримувачу:

- true - підписати і відправити;
- false - лише підписати, не відправляти (за замовчуванням).

Для вхідного документа підписання відбувається з обов'язковою відправкою отримувачу.

**append\_sign** (опційно) - ознака додавання/заміни підпису:

- true - додасть підписи до вже існуючих, якщо такі є
- false - замінить новими підписами існуючі (за замовчуванням)

Для вхідного документа підписання відбувається лише з додаванням підпису, заміна підпису заборонена.

**3. Параметри для ЕТТН та Актів :**

**remove\_prev\_signs** (необов’язково) Boolean - ознака видалення попередніх підписів (за замовчуванням `false`);

**update\_ttn\_after\_act\_sign** (необов’язково) Boolean - ознака оновлення ТТН після підписання (за замовчуванням `true`).

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

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

</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 (обов'язково). [Інструкція з отримання токена](https://wiki-v2.edin.ua/books/instrukciyi-koristuvaca/page/zurnal-kompanii-dlia-administratora#bkmrk-%C2%A0-5)

</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](https://wiki-v2.edin.ua/books/robota-z-api-portalu-edin-id/page/sifruvannia-parolia-za-dopomogoiu-vidkritogo-kliuca-rsa) і закодованими у 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).

---

Опис [загальних помилок при роботі з API](https://wiki-v2.edin.ua/books/robota-z-api/page/zagalni-pomilki-pri-roboti-z-api-vsi-servisi-edin-SLH) (всі сервіси EDIN).

Опис [помилок сервісу EDI Network](https://wiki-v2.edin.ua/books/robota-z-api/page/opis-pomilok-servisu-edi-network).