Skip to main content

Підписати документ за допомогою КНЕДП EDIN ID POST /api/eds/doc/edin_id/sign

Метод використовується для підписання чернетки без відправки, підписання з одночасною відправкою та підписання вхідних документів у відповідь за допомогою КНЕДП EDIN ID.  Якщо за документом запущено процес узгодження, підписати його цим роутом неможливо. Використовується для підписання наступних документів:

  • Комерційні документи (COMDOC)
  • Універсальний документ  (CONDRA)
  • Товарна/цінова/видаткова накладна (DOCUMENTINVOICE)
  • Коригування до товарної накладної (DOCCORINVOICE)
  • ТТН та акти до неї

REQUEST

URL

  

Метод запиту

 POST

URL запиту

/api/eds/doc/edin_id/sign

URL параметри

1. Загальні параметри:

 

gln (обов’язково) String - GLN власної компанії.

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

 

2. Параметри для EDI-документів:

 

send (опційно) - ознака відправки отримувачу:

  • true - підписати і відправити;
  • false - лише підписати, не відправляти (за замовчуванням).

Для вхідного документа підписання відбувається з обов'язковою відправкою отримувачу.

 

append_sign (опційно) - ознака додавання/заміни підпису:

  • true - додасть підписи до вже існуючих, якщо такі є
  • false - замінить новими підписами існуючі (за замовчуванням)

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

 

3. Параметри для ЕТТН та Актів :

 

remove_prev_signs (необов’язково) Boolean - ознака видалення попередніх підписів (за замовчуванням false);

update_ttn_after_act_sign (необов’язково) Boolean - ознака оновлення ТТН після підписання (за замовчуванням true).

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

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

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

    DR - Водій;

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

    OB - Замовник;

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

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

    Для Акта перевантаження:

      CA - Водій / Перевізник, що здає вантаж;

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

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

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

      Headers

       

      Authorization

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

      x-edinid-system-id

      Токен x-system-id підключення до EDIN.ID (обов'язково)

      Content-Type

      application/json

      REQUEST


      JSON Body

      У тілі запиту передається масив з паролями до ключів підпису/печатки в EDIN ID, зашифрованими RSA-публічним ключем EDIN ID і закодованими у base64. Для підписання вхідного документа у відповідь усі підписи треба передати в keys одразу.

       

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

       

      {
    "keys": {
        "00ccb011-5b58-4602-a3c0-b9c73f2a6a2e": "LX3YvHb06pw6q/9tyxLDYgS18GRdoRTjB+Kbd84tcd3ru/RiJpecwhBaM9lUDAX+4AkEe2D79wG5dpQDJOZm5n/xgf81+TZlHb6U8h6V38JTsbeFHFWRBVxpReTgK4dREknRcNeXUjnSjp6eKnofmvAOjoxPt82MmQzVAme0JaQ=",
        "47facc78-48aa-4ab5-88ad-3924a3cbeeb5": "LX3YvHb06pw6q/9tyxLDYgS18GRdoRTjB+Kbd84tcd3ru/RiJpecwhBaM9lUDAX+4AkEe2D79wG5dpQDJOZm5n/xgf81+TZlHb6U8h6V38JTsbeFHFWRBVxpReTgK4dREknRcNeXUjnSjp6eKnofmvAOjoxPt82MmQzVAme0JaQ="
    }
}

      RESPONSE

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

      Back to top