Table of Contents

Розпізнавання документів — Українська ID-картка

Огляд

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

  • Українська ID-картка (нового зразка, двостороння)
  • Закордонний біометричний паспорт

Загальні інструкції з налаштування та використання дивіться у базовій статті: Розпізнавання документів фізичної особи.

Підтримувані українські документи

Українська ID-картка

Українська ID-картка є двостороннім документом. Для розпізнавання:

  1. Відкрийте майстер розпізнавання (з Документів фізичної особи → Create from Document).
  2. Завантажте лицьову сторону ID-картки (Upload File або Upload Photo).
  3. Завантажте зворотну сторону ID-картки.
  4. Система об'єднає обидва зображення в єдиний PDF та відправить для аналізу.

Наступні поля зазвичай витягуються з української ID-картки:

Поле Приклад значення
Прізвище ШЕВЧЕНКО
Ім'я ІВАН
По батькові ПЕТРОВИЧ
Прізвище (English) SHEVCHENKO
Ім'я (English) IVAN
По батькові (English) PETROVYCH
Дата народження 15.01.1990
Стать Ч (Чоловіча)
Громадянство Україна/UKR
РНОКПП 1234567890
Номер документа 000123456
Дата видачі 20.05.2020
Дата закінчення дії 20.05.2030
Орган видачі 1234

Закордонний біометричний паспорт

Закордонний біометричний паспорт — це односторінковий документ (сторінка з даними). Завантажте сторінку з даними як один файл або фото.

Витягується аналогічний набір полів з іменами українською та англійською мовами (як надруковано в паспорті).

Як дані потрапляють у картку фізичної особи

Після розпізнавання:

  • Прізвище / Ім'я / По батькові — заповнюються з українського тексту, конвертуються у правильний регістр (напр., ШЕВЧЕНКО → Шевченко)
  • Прізвище (English) / Ім'я (English) / По батькові (English) — заповнюються з англійського тексту на документі
  • РНОКПП — записується у полі РНОКПП (VAT Registration No.)
  • Громадянство — визначається з Україна/UKR у відповідний код Країни/Регіону в BC
  • Стать — Ч або М → Чоловіча, Ж → Жіноча
  • Дата народження — записується у поле Дата народження

Пошук існуючої фізичної особи

При створенні фізичної особи з українського документа система шукає вже існуючу особу за:

  1. РНОКПП (VAT Registration No.)
  2. Датою народження

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

Налаштування аналізатора для українських документів

Нижче описано налаштування аналізатора саме для українських документів. Загальну інструкцію з підключення Azure та налаштування BC дивіться у базовій статті: Розпізнавання документів фізичної особи.

Створення аналізатора в Azure AI Foundry

  1. Відкрийте Azure AI Foundry → ваш проєкт → Content Understanding.
  2. Натисніть Create Analyzer → оберіть тип Document.
  3. Задайте назву, наприклад: ua-id-card або ua-passport.
  4. У розділі Field Schema додайте поля зі схеми нижче.

Схема полів для української ID-картки

Назви полів повинні точно збігатися (чутливі до регістру). Для кожного поля задайте Field Name та Field Description.

Field Name Field Description (приклад) Примітка
LastName Прізвище українською мовою, як надруковано на картці Напр., ШЕВЧЕНКО
FirstName Ім'я українською мовою Напр., ІВАН
MiddleName По батькові українською мовою Напр., ПЕТРОВИЧ
LastNameEnglish Прізвище англійською, як надруковано на картці Напр., SHEVCHENKO
FirstNameEnglish Ім'я англійською Напр., IVAN
MiddleNameEnglish По батькові англійською Напр., PETROVYCH
BirthDate Дата народження в форматі дати Напр., 15.01.1990
Sex Стать: Ч (чоловіча) або Ж (жіноча) Система розпізнає Ч/М/F/M/Ж
Nationality Громадянство, як надруковано на документі Зазвичай Україна/UKR
PersonalNumber РНОКПП (ІПН) 10-значний номер
DocumentNumber Номер документа Напр., 000123456
IssueDate Дата видачі документа Напр., 20.05.2020
ExpirationDate Дата закінчення дії документа Напр., 20.05.2030
IssuingAuthority Орган, що видав документ (код) Напр., 1234

Рекомендації для описів полів (Field Description)

Якість розпізнавання залежить від того, наскільки детально ви опишете поле. Приклади добрих описів:

  • LastName: "Прізвище українською мовою, надруковане на лицьовій стороні ID-картки поряд з полем Ім'я. Наприклад: ШЕВЧЕНКО"
  • LastNameEnglish: "Surname transliterated in Latin letters, printed on the front side. For example: SHEVCHENKO"
  • PersonalNumber: "РНОКПП (10-значний податковий номер), надрукований на зворотній стороні ID-картки"
  • Nationality: "Громадянство у форматі Україна/UKR, як надруковано на документі"

Після створення аналізатора

  1. Натисніть Build у Azure AI Foundry.
  2. Протестуйте, завантаживши скан ID-картки (обидві сторони в одному PDF). Переконайтесь, що всі поля витягуються коректно.
  3. У Business Central на сторінці Azure Content Understanding Setup натисніть Sync Analyzers, щоб новий аналізатор з'явився у списку.
  4. Призначте аналізатор для сценарію Person Document на сторінці Azure CU Scenario Setup, або призначте його на конкретний тип документа у Person Document Types.

Система обробляє формат Україна/UKR автоматично — витягує частину після / та визначає країну через ISO код.

Edit this page