Підписання даних сервісу «ЕТТН» (збереження підпису)

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

Увага

Формат підпису має бути CAdES-X Long (детальніше про даний формат підпису). Наприклад, хмарні провайдери «Вчасно.КЕП» та «Deposit sign» за замовчуванням повертають формат CAdES-X Long.

Підказка

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

  1. Отримати тіло документа сервісу «ЕТТН» в ECMR форматі -> Підписати отримане ECMR тіло (отримуємо p7s файл підпису) -> Конвертуємо p7s в base64 формат - це буде зміст в масиві тіла запиту.

  2. Отримати sign_hash (extra_fields) документа сервісу «ЕТТН» -> Підписати отримане значення sign_hash (отримуємо p7s файл підпису) -> Конвертуємо p7s в base64 формат - це буде зміст в масиві тіла запиту.

Примітка

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

URL

Метод запиту

POST

URL запиту

/api/eds/doc/ettn/sign?gln=9864066822430&role_code=CZ&doc_uuid=f33f2e86-1038-4718-b512-0065944306a5

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).