Розпізнавання документів фізичної особи

Огляд

Функція Розпізнавання документів фізичної особи дозволяє автоматично створювати або оновлювати картку фізичної особи, завантаживши скан або фото документа, що посвідчує особу. Система використовує Azure Content Understanding (AI) для витягування даних з документа і заповнення полів картки.

Рішення є універсальним — воно працює з будь-яким типом персонального документа (паспорти, ID-картки, посвідки на проживання, водійські посвідчення тощо) з будь-якої країни. Ви налаштовуєте аналізатор в Azure AI Foundry під документи, актуальні для вашого бізнесу.

Підтримувані формати файлів: PDF, JPG, JPEG, PNG.

Передумови

Мають бути встановлені наступні розширення:

• SMART Azure Document Intelligence — забезпечує підключення до Azure Content Understanding
• SMART Person Document Recognition — надає майстер розпізнавання та логіку інтеграції

В Azure має бути налаштований ресурс Azure AI Foundry із сервісом Content Understanding та створений аналізатор для розпізнавання документів.

Налаштування

Крок 1. Створення ресурсу Azure AI Foundry та аналізатора

Перед налаштуванням Business Central необхідно створити та підготувати ресурси в Azure:

1. Створіть ресурс Azure AI Foundry (або Azure AI Services) у Azure Portal.
2. Відкрийте портал Azure AI Foundry та перейдіть до вашого проєкту.
3. У розділі Content Understanding створіть новий Analyzer (аналізатор):
   • Оберіть тип аналізатора — Document (для документів, що посвідчують особу).
   • Задайте назву аналізатора (наприклад, person-id-card).
4. У схемі аналізатора додайте поля (Field Schema), задавши назву поля (Field Name) та опис (Field Description) — що саме витягувати з документа. Перелік підтримуваних полів дивіться в розділі Налаштування аналізаторів нижче.
5. Збережіть та побудуйте (Build) аналізатор.
6. Протестуйте аналізатор на порталі Azure AI Foundry, завантаживши зразок документа.

Після цього знадобляться:

• Endpoint URL — URL ендпоінту ресурсу (знайдіть в Azure Portal → ваш ресурс → Keys and Endpoint)
• API Key — ключ доступу (Key 1 або Key 2 з тієї самої сторінки)

Крок 2. Налаштування Azure Content Understanding у Business Central

1. Знайдіть сторінку Azure Content Understanding Setup у Business Central.
2. Заповніть:
   • Endpoint URL — URL ендпоінту з Azure Portal
   • API Key — ключ доступу (зберігається безпечно в Isolated Storage)
   • API Version — 2025-11-01 (за замовчуванням)
3. Якщо аналізатор використовує власні деплойменти моделей (LLM), заповніть секцію Foundry Model Deployments:
   • Model Deployment 1 — назва деплойменту основної мовної моделі (наприклад, gpt-4o)
   • Model Deployment 2 — назва деплойменту резервної моделі (опціонально)
   • Model Deployment 3 — назва деплойменту embedding-моделі (опціонально)

Якщо при створенні аналізатора ви використовували стандартні моделі Azure AI Foundry, поля Model Deployment можна залишити порожніми.

Налаштування асинхронної обробки

На тій самій сторінці, у секції Async Processing, можна налаштувати поведінку фонової обробки:

Поле	Опис	За замовчуванням
Async Processing Enabled	Увімкнути фонову обробку (рекомендовано)	Так
Polling Interval (Seconds)	Інтервал опитування статусу, 1–60 сек	5
Max Polling Duration (Minutes)	Максимальний час очікування, 1–1440 хв	30

Крок 3. Синхронізація аналізаторів

1. На сторінці Azure Content Understanding Setup натисніть дію Sync Analyzers.
2. Система завантажить список доступних аналізаторів з Azure та збереже їх у Business Central.
3. Перевірте список на сторінці Analyzers (доступна через навігацію з Setup-сторінки).

Крок 4. Налаштування сценарію

1. Відкрийте Azure CU Scenario Setup (доступна через навігацію з Setup-сторінки або через пошук).
2. Створіть запис:
   • Scenario = Person Document
   • Analyzer ID = оберіть аналізатор, створений для розпізнавання документів
3. Цей сценарій буде використовуватися за замовчуванням при розпізнаванні.
4. Для перевірки — натисніть Test Scenario, завантажте тестовий документ і переконайтесь, що аналіз проходить успішно.

Крок 5 (опціонально). Аналізатор для конкретного типу документа

Якщо різні типи документів потребують різних аналізаторів:

1. Відкрийте довідник Person Document Types (типи документів фізичної особи).
2. У полі Analyzer ID оберіть специфічний аналізатор для потрібного типу документа.
3. Якщо заповнено — цей аналізатор має пріоритет над сценарієм.

Пріоритет вибору аналізатора: Analyzer ID на типі документа → Сценарій → помилка, якщо нічого не налаштовано.

Створення фізичної особи з документа

1. Відкрийте Картку фізичної особи або список фізичних осіб.
2. Перейдіть до Документи фізичної особи і натисніть Create from Document.
3. Відкриється майстер розпізнавання:

Крок 1 — Завантаження

• Оберіть Тип документа фізичної особи (паспорт, ID-картка тощо).
• Натисніть Upload File для завантаження PDF або зображення, або Upload Photo для зйомки з камери.
• Для двосторонніх документів — завантажте обидві сторони. Система автоматично об'єднає зображення в єдиний PDF.
• Натисніть Next для початку аналізу.

Крок 2 — Обробка

• Документ відправляється в Azure Content Understanding для AI-аналізу.
• Обробка виконується у фоновому режимі — інтерфейс залишається доступним.
• Після завершення аналізу майстер автоматично переходить до кроку перегляду.

Крок 3 — Перегляд та редагування

• Розпізнані поля та їх значення відображаються в таблиці.
• Ви можете редагувати будь-яке значення перед збереженням — для виправлення помилок розпізнавання.
• Натисніть Finish для створення або оновлення запису.

Що відбувається при натисканні Finish

Система:

1. Шукає існуючу фізичну особу за ІПН (персональний номер) та/або датою народження.
2. Якщо знайдено — пропонує оновити існуючу особу або створити нову.
3. Якщо не знайдено — створює нову картку фізичної особи.
4. Заповнює наступні поля з розпізнаних даних:

Поле	Джерело
Ім'я	FirstName (конвертується у правильний регістр)
По батькові	MiddleName (конвертується у правильний регістр)
Прізвище	LastName (конвертується у правильний регістр)
Ім'я (English)	FirstNameEnglish
По батькові (English)	MiddleNameEnglish
Прізвище (English)	LastNameEnglish
Дата народження	BirthDate
Стать	Sex (F/M відповідно Female/Male)
Громадянство	Nationality (визначається через ISO код або назву країни)
РНОКПП / ІПН	PersonalNumber

5. Створює запис документа фізичної особи (номер документа, дата видачі, дата закінчення дії, орган видачі, номер запису).
6. Прикріплює завантажені файли як вкладення документа.

Обробка дублікатів документів

Якщо документ з таким самим типом і номером вже існує, система пропонує:

• Update Existing — замінити дані та вкладення в існуючому документі
• Create New — створити новий запис документа

Виявлення зміни ПІБ

Якщо розпізнане ім'я відрізняється від поточного імені фізичної особи, система пропонує три варіанти:

• Ігнорувати — залишити поточне ім'я
• Оновити ім'я — безпосередньо оновити ПІБ на картці
• Звіт про зміну ПІБ — запустити звіт для документального оформлення зміни

Налаштування аналізаторів

Ви можете налаштувати аналізатори в Azure AI Foundry для розпізнавання будь-якого типу документа.

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

1. Відкрийте Azure AI Foundry → ваш проєкт → Content Understanding.
2. Натисніть Create Analyzer → оберіть тип Document.
3. Задайте назву аналізатора (наприклад, person-passport, person-id-card).
4. У розділі Field Schema додайте поля з таблиці нижче.
5. Для кожного поля задайте:
   • Field Name — назва з таблиці (наприклад, FirstName). Назва повинна точно збігатися, оскільки система шукає поля за цими іменами.
   • Field Description — опис того, що витягувати з документа. Чим детальніший опис, тим точніше аналізатор витягне дані. Наприклад: "Person's first name as printed on the document".
6. Натисніть Build для побудови аналізатора.
7. Протестуйте результат, завантаживши зразок документа.

Підтримувані поля

Схема полів аналізатора повинна включати наступні назви полів для коректного маппінгу:

Назва поля	Опис	Обов'язкове
FirstName	Ім'я (мовою документа)	Так
LastName	Прізвище (мовою документа)	Так
MiddleName	По батькові	Ні
FirstNameEnglish	Ім'я англійською (якщо є на документі)	Ні
MiddleNameEnglish	По батькові англійською	Ні
LastNameEnglish	Прізвище англійською	Ні
BirthDate	Дата народження	Ні
Sex	Стать (F/M або Ж/Ч)	Ні
Nationality	Громадянство	Ні
CountryRegion	Код країни	Ні
PersonalNumber	ІПН / персональний номер	Ні
DocumentNumber	Номер документа	Ні
IssueDate	Дата видачі документа	Ні
ExpirationDate	Дата закінчення дії	Ні
IssuingAuthority	Орган видачі	Ні
PlaceOfBirth	Місце народження	Ні
PlaceOfIssue	Місце видачі	Ні
DocumentType	Тип документа	Ні
MachineReadableZone	MRZ-зона (для паспортів)	Ні
Aliases	Альтернативні імена	Ні

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