Створення фізичної особи з Дія (Дія Шерінг)

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

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

Шлях: список Фіз особи → Створити з Дія, або Картка фізичної особи → Функції → Оновити з Дія.

Загальний опис

Дія Шерінг — це інтеграція з офіційним API шерінгу Дії. Принцип роботи такий:

1. Ви розпочинаєте запит на шерінг у Business Central і обираєте, який документ (або документи) хочете отримати.
2. Особа — власник документів — підтверджує запит у застосунку Дія.
3. Дія повертає підписаний пакет — набір PDF-файлів разом зі структурованим описом metadata.json для кожного документа.
4. Business Central зчитує метадані, зіставляє їх із полями картки та прикріплює PDF-файли.

Особа не надсилає скани чи фотографії вручну — дані надходять безпосередньо з державних реєстрів через Дію, тож вони вже перевірені та структуровані.

Режими шерінгу

Під час створення запиту ви обираєте Режим шерінгу:

• Online — Business Central генерує диплінк, який відображається як QR-код і як посилання для копіювання. Якщо особа поруч — вона сканує QR-код; якщо ні — ви надсилаєте посилання через месенджер або електронну пошту. Посилання дійсне 3 хвилини та одноразове. Режим Online також підтримує Мультишерінг (див. нижче).
• Offline — особа відкриває документ у застосунку Дія та зчитує з нього 13-значний штрихкод. Ви вводите (або скануєте) цей штрихкод у Business Central. У режимі Offline запитується один тип документа за раз.

Життєвий цикл запиту

Після створення запиту Business Central автоматично опитує Дію щодо статусу, доки особа не відповість:

Статус	Значення
Ініціалізовано / В обробці	Запит створено; система очікує, поки особа відкриє та підтвердить його в Дії.
Виконано	Особа підтвердила запит. Пакет документів готовий і автоматично завантажується та обробляється.
Відмова	Особа відхилила запит, або посилання застаріло.
Не використано	Посилання не відкрили протягом строку дії.

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

Передумови

Дія Шерінг працює через розширення SMART eSignature for Ukraine, яке відповідає за з'єднання з Дією. Перш ніж запитувати документи, адміністратор має:

• Налаштувати URL-адреси сервісу Дія та токен партнерського доступу в налаштуваннях eSignature.
• Зареєструвати щонайменше один підрозділ Дія (branch) з увімкненим параметром Enable Sharing.
• Налаштувати офери (offers) та області шерінгу (scopes) — перелік типів документів, які організація має право запитувати — для цього підрозділу.

Дозволи на запит конкретного типу документа надаються на acquirer-акаунті організації в Дії та погоджуються з Дією. Якщо тип документа не дозволений для вашої організації, запитати його неможливо.

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

Створення фізичної особи з Дія

Використовуйте цей сценарій, щоб створити новий запис фізичної особи з отриманих документів.

1. Відкрийте список Фіз особи та оберіть Створити з Дія.
2. У майстрі Шерінг документів Дія на першому кроці:
   • Оберіть Підрозділ (Branch ID) і перевірте Назву підрозділу.
   • Виберіть Режим шерінгу (Online або Offline).
   • Виберіть Тип документа, який потрібно запитати, або увімкніть Мультишерінг, щоб запитати кілька документів одразу (лише Online — див. Мультишерінг).
3. Продовжте крок відповідно до режиму:
   • Online — покажіть особі QR-код або скопіюйте Посилання та надішліть його. Зачекайте, поки особа підтвердить запит у Дії.
   • Offline — попросіть особу відкрити документ у Дії та зчитати 13-значний штрихкод; введіть або відскануйте його та продовжте.
4. Майстер показує крок Очікування, поки особа підтверджує запит у Дії.
5. Коли документи надходять, на кроці Результати відображаються отримані дані: Тип документа, Повне ім'я, РНОКПП, Номер документа, Дата народження та повне Резюме. Ви можете завантажити основний файл або весь пакет.
6. Завершіть майстер. Створюється та відкривається нова картка фізичної особи з усіма розпізнаними полями та прикріпленими PDF-файлами.

Оновлення наявної фізичної особи з Дія

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

1. Відкрийте Картку фізичної особи.
2. Оберіть Функції → Оновити з Дія.
3. Пройдіть ті самі кроки майстра, що описані вище.
4. Після завершення обробки система повідомить, що особу оновлено.

Під час оновлення система обережно не перезаписує дані, які не повинні змінюватися автоматично. Зокрема, якщо особа вже пов'язана зі співробітником, ім'я не перезаписується мовчки — натомість пропонується процес зміни імені, щоб зміна була належно зареєстрована.

Зіставлення особи та вирішення конфліктів

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

• Під час створення (Створити з Дія): якщо особа з тими самими РНОКПП + датою народження + ім'ям уже існує, система запитує, що робити:
  • Створити нову — все одно створити нову фізичну особу;
  • Оновити наявну — записати отримані дані до наявної особи;
  • Скасувати — припинити без змін.
• Під час оновлення (Оновити з Дія): якщо РНОКПП, зчитаний із документа, відрізняється від РНОКПП поточної особи, система попереджає про розбіжність і запитує:
  • Оновити поточну — все одно застосувати дані до поточної особи;
  • Створити нову — створити нову особу з отриманих даних;
  • Оновити іншу — показується лише тоді, коли інша особа вже має розпізнаний РНОКПП; застосовує дані до тієї особи;
  • Скасувати — припинити без змін.

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

Мультишерінг

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

• Звичайний шерінг запитує один тип документа. Особа підтверджує цей документ, а у відповіді міститься цей документ (або кілька екземплярів того самого типу).
• Мультишерінг запитує всі типи документів з області офера одразу — наприклад, ID-картку, картку платника податків і свідоцтво про народження разом. Особа підтверджує один раз, а у відповіді надходять усі вони.

Мультишерінг доступний лише в режимі Online і лише тоді, коли для обраного підрозділу налаштований офер з більш ніж одним типом документа. Прапорець Мультишерінг з'являється на першому кроці майстра тільки за цих умов.

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

Підтримувані документи та їх обробка

Система розпізнає наведені нижче типи документів Дія та зіставляє кожен із конкретними даними особи. Якщо значення вже присутнє і не повинно перезаписуватися автоматично (наприклад, ім'я особи, пов'язаної зі співробітником), воно зберігається.

Документ Дія	Що заповнює
ID-картка (паспорт громадянина України)	Прізвище / Ім'я / По батькові (укр.), Прізвище/Ім'я (англ.), Дата народження, Стать, РНОКПП, Унікальний номер запису в реєстрі, Громадянство, Адреса реєстрації, Місце народження; створює документ особи з номером, датою видачі та органом видачі.
Закордонний (біометричний) паспорт	Ті самі ідентифікаційні поля, що й ID-картка, включно з англомовними іменами та адресою реєстрації; створює відповідний документ особи.
Картка платника податків (РНОКПП)	Прізвище / Ім'я / По батькові (укр.), Дата народження, РНОКПП.
РНОКПП дитини	Створює дитину як родича (Дитина) з ПІБ, датою народження та статтю.
Свідоцтво про народження дитини	Створює дитину як родича (Дитина) з ПІБ, датою народження та статтю; підписаний PDF прикріплюється до запису родича.
Власне свідоцтво про народження (user-birth-record)	Власне свідоцтво про народження особи. Заповнює прізвище / ім'я / по батькові особи, дату народження, стать і РНОКПП, місце народження, батьків як родичів, і реєструє свідоцтво як документ особи.
Довідка ВПО (внутрішньо переміщеної особи)	Прізвище / Ім'я / По батькові, Дата народження, Стать, фактична адреса, місце народження; реєструє документ довідки.
Посвідка на проживання (постійна / тимчасова)	Ідентифікаційні поля, включно з англомовними іменами, РНОКПП, адресою реєстрації; реєструє документ посвідки.
Посвідчення водія	Прізвище / Ім'я / По батькові включно з англомовними іменами, Дата народження, Унікальний номер запису в реєстрі, реєструє документ з водійським посвідченням з номером документа, датою видачі та закінчення, органом видачі.
Пенсійне посвідчення	Прізвище / Ім'я / По батькові; реєструє пільгу пенсіонера в медичній інформації (тип пенсії та номер справи) і пенсійний документ в документах фіз.особи.
Студентський квиток	Прізвище / Ім'я / По батькові, номер документа, дати видачі та закінчення.
Посвідчення ветерана	Прізвище / Ім'я / По батькові; реєструє групу інвалідності та пільгу учасника бойових дій (ветерана) в медичній інформації (з датами видачі та закінчення) і призначає відповідний код додаткових гарантій зайнятості; реєструє посвідчення як документ особи.
Освітній документ	Створює запис кваліфікації: заклад, спеціальність, кваліфікація, серія/номер документа, дати навчання, факультет і тип документа (Диплом / Інше).
Актовий запис про зміну імені	Оновлює прізвище / ім'я / по батькові.
Актовий запис про шлюб	Встановлює сімейний стан Одружений(а), створює подружжя як родича (Подружжя) з датою початку відносин, ПІБ та датою народження.
Актовий запис про розірвання шлюбу	Встановлює сімейний стан Розлучений(а) та закриває відносини з подружжям датою завершення.
Довідки ОК-5 / ОК-7	Отримуються та прикріплюються для довідки.

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

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

Поля фізичної особи, що заповнюються

Для фізичної особи дані, повернуті Дією, записуються до наведених нижче полів і пов'язаних записів.

Ідентифікація

Поле	Джерело / примітки
Прізвище	З документів, які містять дані про ПІБ особи (паспорт, картка платника податків, водійське посвідчення тощо).
Ім'я	Ті самі джерела.
По батькові	Ті самі джерела.
Прізвище (англ.), Ім'я (англ.)	Із закордонного паспорта, водійського посвідчення та посвідки на проживання.
Дата народження	Захищена, якщо РНОКПП і дата народження вже встановлені.
РНОКПП (ІПН)	Персональний ідентифікаційний номер фізичної особи.
Унікальний номер запису в реєстрі	Номер запису в реєстрі.
Стать	Зіставляється з українським значенням (ч → Чоловіча, ж → Жіноча).
Громадянство	Зіставляється зі значенням національності (наприклад, Україна → UA).

Адреси

Адреси записуються до альтернативних адрес особи:

• Адреса реєстрації — область, район, місто, вулиця, будинок і квартира, отримані з даних реєстрації паспорта/посвідки, з датою реєстрації.
• Місце народження — місто, район і область, отримані з тексту місця народження.
• Фактична адреса — із довідки ВПО.

Пов'язані записи

• Документи особи — ID-картка, закордонний паспорт, посвідчення водія, студентський квиток, довідка ВПО, пенсійне посвідчення, посвідчення ветерана та інші, кожен із номером, серією, датами видачі/дії та органом видачі. Підписаний PDF прикріплюється.
• Родичі — діти (зі свідоцтва про народження та РНОКПП дитини) та подружжя (із записів про шлюб/розлучення), з іменами, датами народження, статтю, датами відносин. Код родича обирається за типом відносин і статтю (наприклад, син чи донька).
• Медична інформація —
  • Інвалідність (з посвідчення ветерана), з датами початку та завершення, та групою інвалідності;
  • Пільга учасника бойових дій (ветерана) (з посвідчення ветерана), з відповідним кодом додаткових гарантій зайнятості, видом пільги учасник бойових дій та датами початку/завершення;
  • Пільга пенсіонера (з пенсійного посвідчення), з типом пенсії, видом пільги пенсіонер, датами початку/завершення та номером справи.
• Кваліфікація — освітні дані з освітнього документа, включно з типом документа (Диплом / Інше).

Примітки та обмеження

• Мультишерінг доступний лише в режимі Online. У режимі Offline ви запитуєте один документ за раз, оскільки штрихкод прив'язаний до конкретного документа в застосунку Дія.
• Посилання короткочасні. Онлайн-посилання на шерінг (і офлайн-штрихкод) дійсне близько 3 хвилин і одноразове. Згенеруйте нове посилання, якщо строк дії минув.
• Файли зберігаються як PDF. Документи надходять як підписані конверти; обгортки підпису (.p7s, .p7e) видаляються, а PDF прикріплюється до відповідного запису.
• Наявні дані зіставляються й оновлюються, а не дублюються. Коли особа, документ чи родич уже існують, система оновлює відсутні значення замість створення дубліката. Особа зіставляється за РНОКПП + датою народження + ім'ям; у разі конфлікту система пропонує створити новий запис, оновити наявний або скасувати (див. Зіставлення особи та вирішення конфліктів).
• Місце народження зберігає найдетальніше значення. Коли місце народження вже існує, система зберігає варіант із більшою деталізацією (місто / район / область / країна) замість сліпого перезапису, і використовує дату народження особи як дату чинності адреси.
• Захист імені для співробітників. Якщо особа пов'язана зі співробітником, ім'я не перезаписується автоматично — натомість використовується процес зміни імені, датований датою реєстрації актового запису.

Пов'язані теми

• Картка фізичної особи
• Розпізнавання документів — Українська ID-картка
• Розпізнавання QR-коду Reserve+