Skip to main content

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

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

  • якщо в URL запиту передано ідентифікатор документа (doc_uuid), то буде виконано редагування документа сервісу «ETTN» з цим Id;

  • якщо параметр doc_uuid відсутній, то буде створено новий документ.

Перед створенням чернетки перевірте коректність формування адреси компанії відповідно до даних, зазначених у GLN. Ознайомитися з правилами заповнення адрес можна за посиланням.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/ttn

URL параметри

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 валідації.

Headers

 

Authorization

SID - токен, отриманий при авторизації

Content-Type

application/json or application/xml

REQUEST

 

JSON Body

В тілі запиту методу передається документ e-ТТН в json чи xml форматі

 

Тіло відсутнє при передачі template_doc_uuid параметра!

RESPONSE

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