Skip to main content

Підписання даних сервісу (збереження підпису) POST /api/eds/doc/ettn/sign

Формат підпису повинен відповідати стандарту CAdES-X Long (детальніше — у специфікації)

Підписання в сервісі «ЕТТН» можна здійснювати двома способами:

  1. Через ECMR тіло документа

    • Отримати тіло документа сервісу «ЕТТН» у форматі ECMR.

    • Підписати отримане ECMR тіло (результат — p7s-файл підпису).

    • Конвертувати p7s у base64 — цей результат передається у масиві тіла запиту.

  2. Через sign_hash (extra_fields)

    • Отримати sign_hash (extra_fields) документа сервісу «ЕТТН».

    • Підписати значення sign_hash (результат — p7s-файл підпису).

    • Конвертувати p7s у base64 — цей результат передається у масиві тіла запиту.

Перепідписання документа (оновлення підпису повторним викликом методу) дозволяється лише до моменту відправки документа контрагенту.

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/sign

URL параметри

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

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

  • CZ - Вантажовідправник;

  • CN - Вантажоодержувач;

  • DR - Водій;

  • CA - Перевізник;

  • OB - Замовник;

  • WD - Проміжний склад, що приймає вантаж;

  • WH - Проміжний склад, що здає вантаж;

  • Для Акта перевантаження:
    • CA - Водій / Перевізник, що здає вантаж;

    • OV - Перевізник, що здає вантаж;

    • DR - Водій, що приймає вантаж;

    • CH - Водій / Перевізник, що приймає вантаж

doc_uuid (обов’язково) UUID - ідентифікатор документа

Headers

 

Authorization

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

REQUEST

 

JSON Body

В тілі запиту методу передається масив файлів підпису p7s в base64 форматі.

Приклад тіла запиту:

["ZGZkZmRmZGZkZmRmdnh2dmM==", "ZGZkZmRmZGZkZmRmdnh2dmM=="]
RESPONSE

Код сервера 200 (ok).