Person Document Recognition — Ukrainian ID Card

Overview

This section describes the specifics of using the Person Document Recognition feature with Ukrainian identity documents:

• Ukrainian ID card (new format, two-sided)
• Ukrainian biometric passport (foreign travel passport)

For general setup and usage instructions, see the base article: Person Document Recognition.

Supported Ukrainian Documents

Ukrainian ID Card (ID-картка)

The Ukrainian ID card is a two-sided document. To recognize it:

1. Open the recognition wizard (from Person Documents → Create from Document).
2. Upload the front side of the ID card (Upload File or Upload Photo).
3. Upload the back side of the ID card.
4. The system combines both images into a single PDF and sends it for analysis.

The following fields are typically extracted from a Ukrainian ID card:

Field	Example value
Last Name	ШЕВЧЕНКО
First Name	ІВАН
Middle Name	ПЕТРОВИЧ
Last Name (English)	SHEVCHENKO
First Name (English)	IVAN
Middle Name (English)	PETROVYCH
Date of Birth	15.01.1990
Sex	Ч (Male)
Nationality	Україна/UKR
Personal Number (РНОКПП)	1234567890
Document Number	000123456
Issue Date	20.05.2020
Expiration Date	20.05.2030
Issuing Authority	1234

Ukrainian Biometric Passport

The biometric foreign travel passport is a single-page document (the data page). Upload the data page as a single file or photo.

The same set of fields is extracted, with names in both Ukrainian and English (as printed in the passport).

How the Data Maps to the Person Card

After recognition:

• Прізвище / Ім'я / По батькові — filled from the Ukrainian text, converted to proper case (e.g., ШЕВЧЕНКО → Шевченко)
• Прізвище (English) / Ім'я (English) / По батькові (English) — filled from the English text on the document
• РНОКПП — mapped to the VAT Registration No. field
• Громадянство — resolved from Україна/UKR to the appropriate Country/Region code in BC
• Стать — Ч or М mapped to Male, Ж mapped to Female
• Дата народження — mapped to Birth Date

Existing Person Lookup

When creating a person from a Ukrainian document, the system searches for an existing person by:

1. РНОКПП (VAT Registration No.)
2. Date of birth

If a match is found, the system asks whether to update the existing person record instead of creating a new one.

Analyzer Setup for Ukrainian Documents

Below are the specific instructions for creating an analyzer for Ukrainian documents. For general Azure connection and BC setup instructions, see the base article: Person Document Recognition.

Creating an Analyzer in Azure AI Foundry

1. Open Azure AI Foundry → your project → Content Understanding.
2. Click Create Analyzer → select type Document.
3. Give it a name, for example: ua-id-card or ua-passport.
4. In the Field Schema section, add fields from the schema below.

Field Schema for Ukrainian ID Card

Field names must match exactly (case-sensitive). For each field, provide the Field Name and a Field Description.

Field Name	Field Description (example)	Note
LastName	Surname in Ukrainian as printed on the card	e.g., ШЕВЧЕНКО
FirstName	First name in Ukrainian	e.g., ІВАН
MiddleName	Patronymic in Ukrainian	e.g., ПЕТРОВИЧ
LastNameEnglish	Surname transliterated in Latin letters, printed on the front side	e.g., SHEVCHENKO
FirstNameEnglish	First name in English	e.g., IVAN
MiddleNameEnglish	Patronymic in English	e.g., PETROVYCH
BirthDate	Date of birth in date format	e.g., 15.01.1990
Sex	Sex: Ч (male) or Ж (female)	System recognizes Ч/М/F/M/Ж
Nationality	Citizenship as printed on the document	Typically Україна/UKR
PersonalNumber	РНОКПП (tax identification number)	10-digit number
DocumentNumber	Document number	e.g., 000123456
IssueDate	Document issue date	e.g., 20.05.2020
ExpirationDate	Document expiration date	e.g., 20.05.2030
IssuingAuthority	Issuing authority (code)	e.g., 1234

Tips for Field Descriptions

Recognition quality depends on how detailed the field descriptions are. Examples of good descriptions:

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

After Creating the Analyzer

1. Click Build in Azure AI Foundry.
2. Test by uploading a scan of an ID card (both sides in a single PDF). Verify that all fields are extracted correctly.
3. In Business Central, on the Azure Content Understanding Setup page, click Sync Analyzers so the new analyzer appears in the list.
4. Assign the analyzer to the Person Document scenario on the Azure CU Scenario Setup page, or assign it to a specific document type in Person Document Types.

The system handles the Україна/UKR format automatically — it extracts the part after / and resolves it via ISO code.