Створення/редагування чернетки «Електронної товарно-транспортної накладної» (е-ТТН)

Для роботи з цим методом користувач повинен бути авторизованим.

Важливо

Вибір дії (створення або редагування): в разі якщо в url запиту присутній ідентифікатор документа (параметр doc_uuid), то документ сервісу «ETTN» з зазначеним Id підлягає редагуванню.

URL

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/ttn?gln=9864065732327

URL параметри

gln (обов’язково) String - GLN власної Компанії АБО guid (обов’язково) String - унікальний ідентифікатор власної організації на платформі

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

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

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

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

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

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

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

RESPONSE

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

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