# Створення/редагування чернетки e-TTH

Вибір дії (створення чи редагування):

- якщо в URL запиту передано ідентифікатор документа (**doc\_uuid**), то буде виконано редагування документа сервісу «ETTN» з цим Id;
- якщо параметр **doc\_uuid** відсутній, то буде створено новий документ.

<p class="callout info">Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна [за посиланням](https://wiki-v2.edin.ua/books/edi-network-produkt-e-ttn/page/pravila-zapovnennia-adres-u-ttn-ta-aktax-na-osnovi-danix-iz-gln).</p>

##### **REQUEST**

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

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

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

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

</td><td style="width: 82.2388%;">/api/eds/doc/ettn/ttn

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

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

**doc\_uuid** (опціонально) UUID - ідентифікатор документа (передається для редагування (оновлення) даних раніше створеної чернетки)

**template\_doc\_uuid** (опціонально) UUID - ідентифікатор «Попередньої e-ТТН». При передаванні цього параметра створювана чернетка e-ТТН наповнюється даними з документа-підстави («Попередньої e-ТТН»), тому тіло в запиті не передається

**new\_doc\_uuid** (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта)

**fill\_up** (опціонально) boolean - false за замовчуванням; при fill\_up = true виконується перевірка тіла e-ТТН та автоматичне наповнення його даними (по Компанії, Водію, Транспорту, Пунктам Навантаження/Розвантаження) з довідників, автоматичний розрахунок Загальної ваги;

**full\_validate** (опціонально) boolean - true за замовчуванням. Незалежно від параметра full\_validate документ проходить повну перевірку (всі обов’язкові поля та XSD), якщо ця перевірка успішна - то в extrafield проставляється ready\_for\_sign параметр

- Якщо full\_validate = false - то у відповіді повертається помилка лише по полях які необхідні для збереження документа;
- Якщо full\_validate = true - то у відповіді повертається помилка по всім обов’язковим полям та xsd валідації.

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

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

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

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

</td><td style="width: 82.2388%;">application/json or application/xml

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

</td><td style="width: 82.2388%;"> </td></tr><tr class="row-odd"><td style="width: 17.7612%;">JSON Body

</td><td style="width: 82.2388%;">В тілі запиту методу передається документ [e-ТТН в json чи xml](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/elektronna-tovarno-transportna-nakladna-e-ttn) форматі

<p class="callout info">Тіло відсутнє при передачі template\_doc\_uuid параметра!</p>

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

##### **RESPONSE**

В тілі відповіді (json) передається **doc\_uuid** - унікальний ідентифікатор документа на платформі:

```json
{doc_uuid:"e3dbf6e8-029e-4c3b-804b-9b2741d9f37d"}
```