Створення/редагування чернетки 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 SID - токен, отриманий при при авторизації
|
|
Content-Type
|
application/json or json or application/xml
|
|
REQUEST
|
|
|
JSON Body
|
В тілі запиту методу передається документ документ e-ТТН в json чи xml форматі
Тіло відсутнє при передачі template_doc_uuid параметра!
|
RESPONSE
В тілі відповіді тілі відповіді (json) передається передається doc_uuid doc_uuid - унікальний ідентифікатор документа на платформі:
{doc_uuid:"e3dbf6e8-029e-4c3b-804b-9b2741d9f37d"}
