Розпізнавання документів — Українська 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 код.