API Дії для бізнесу: як отримувати електронні копії документів від клієнтів за допомогою Дії

Привіт!

Я працюю в команді впровадження Дії. Ми допомагаємо державним установам та бізнесу підключати API Дії, щоб замінити ксерокопії, сканкопії і підписання від руки на зручні цифрові сервіси.

Прагнемо до майбутнього у форматі paperless. Щоб українці забули про папери, «копія вірна» на кожній сторінці, поїздки і черги. Адже завдяки Дії компанії можуть отримувати електронні копії цифрових документів і підписані Дія.Підписом документи відразу в свою інформаційну систему. Як офлайн, так і віддалено.

Якщо ви реєструвалися в застосунку Monobank, прив’язували номер телефону до паспорта онлайн у застосунках lifecell / Vodafone / Київстар чи повертали евакуйоване авто через Київ Цифровий — напевно бачили на етапі ідентифікації варіант надіслати документи через Дію. Це інтеграція API Дії, яка дає змогу компанії отримувати копії цифрових документів від клієнтів за допомогою застосунку Дія. Компанія створює paperless-процес, а користувач має флоу в кілька тапів.

Цей сервіс називається шерингом документів через Дію. Як компанії інтегрують його за API і що для цього потрібно — розповім далі.

Шеринг документів через Дію — це коли бізнес та державні установи отримують цифрові копії документів клієнтів за допомогою застосунку Дія безпосередньо у свою інформаційну систему. Компанія отримує копію у форматі PDF з цифровими підписами користувача та ДП Дія, а також поля документа у вигляді метаданих JSON. Метадані можна використати для автоматичного заповнення клієнтських даних у різних формах, договорах чи заявах, що спрощує взаємодію з користувачами та пришвидшує процес обслуговування.

Шеринг документів можна налаштувати:

1. Онлайн: на вебсайтах, у застосунках або терміналах партнера
2. Офлайн — у фізичних відділеннях партнера.

Як відбувається шеринг документів через API Дії

1. Компанія відправляє користувачу в Дію запит на копію / копії документів.
2. Користувач ознайомлюється із запитом, у якому вказано, яка компанія і копії яких документів запитує. Далі підтверджує запит власним Дія.Підписом.
3. Компанія отримує у власну інформаційну систему pdf-копію документа та її метадані.

Щоб відправляти запити на копії документів у Дію, IT-спеціалістам компанії потрібно налаштувати інтеграцію з API Дії. Для цього необхідно написати нам з відповідним запитом. Контакти для зв’язку — на сайті Інтеграція Дії.

Процес інтеграції шерингу документів через Дію передбачає 5 основних кроків

1. Ознайомлення з технічною документацією.
2. Отримання тестового токену й тестування сервісу для власного бізнес-процесу.
3. Юридична частина — підписання договору про співпрацю.
4. Демонстрація відеофлоу налаштованого процесу на тестовому середовищі.
5. Перехід у продове оточення.

Для чого компанії й установи інтегрують шеринг документів

Для ідентифікації та верифікації клієнтів. А також для автоматичного заповнення полів у різноманітних формах і заявах даними з цифрової копії.

Наприклад, ваша компанія надає сервіс з прокату авто. Для оформлення договору потрібні паспортні дані клієнта та дані з посвідчення водія. Замість того щоб просити фото / ксерокопії документів чи вручну вводити дані, можна під’єднати шеринг паспорта та посвідчення водія через Дію — й автоматизувати заповнення договору.

Інший приклад: ви надаєте послуги страхування авто. Щоб клієнту не вводити номер авто, марку тощо, можна налаштувати шеринг техпаспорта через Дію. Так за лічені хвилини отримаєте дані по авто й зможе автоматично внести їх у поля договору. Клієнту не потрібно нічого вказувати вручну. Крім того, дані є перевіреними, оскільки отримуєте інформацію з державних реєстрів.

Шеринг документів також можна використовувати для оформлення працевлаштування. Нові співробітники надсилають копії документів онлайн через Дію відразу в інформаційну систему компанії, і не потрібні ксерокопії чи фото.

Які документи можна шерити через Дію

• Паспорт громадянина України у формі ID-картки
• Закордонний паспорт
• РНОКПП (ІПН)
• Довідка внутрішньо переміщеної особи (ВПО)
• Водійські права
• Техпаспорт
• Студентський квиток
• Освітні документи: свідоцтва, атестати та дипломи
• Посвідчення ветерана
• Актові записи про народження, про шлюб, розірвання шлюбу й зміну імені

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

Як відбувається тестування сервісу шерингу документів

Ми створюємо чат з партнером у зручному меседжері для оперативної комунікації. Надаємо детальну технічну документацію та доступ до тестового застосунку Дія з тестовими користувачами, які мать весь необхідний портфель штучно згенерованих документів. Це дає змогу тестувати сервіси без потреби взаємодії з реальними даними.

Технічна документація описує вимоги до ендпоінта, структури запиту, приклади JSON-метаданих за кожним цифровим документом, який доступний для шерингу, приклади фактичного відображення в застосунку Дія та можливі помилки.

Якщо в процесі інтеграції виникають будь-які запитання — їх можна вирішити у цьому ж чаті з нашою командою.

Що потрібно, щоб отримати доступ до продового оточення

Після успішного тестування партнер надсилає нам фінальне відеофлоу налаштованого процесу для ознайомлення. Далі підписує договір, ми надаємо доступ до продового оточення — а це значить, що партнер може використовувати сервіс у роботі з реальними клієнтами.

У результаті у партнера буде два акаунти на API ДП Дія: тестовий і продуктовий. Це дає змогу навіть після виходу в продове оточення використовувати тестове для налаштування сервісу для інших бізнес-процесів чи досліджувати шеринг нових документів для розширення інтеграції.

Шифрування даних

Під час шерингу документів дані передаються в зашифрованому вигляді та можуть бути розшифровані (отже, прочитані та оброблені) лише тим партнером, який їх запитав у користувача. Партнеру потрібно мати цифровий ключ, на публічний сертифікат якого шифруватимуться дані.

Зашифрований пакет з даними надсилається на сервер партнера лише після підтвердження користувача, яке він надає в застосунку Дія безпосередньо перед відправленням.

Щоб під’єднати сервіс шерингу документів через Дію у власні бізнес-процеси, переходьте на наш сайт Інтеграція Дії та пишіть за вказаними контактами.