# Паспорт

Актуальная форма паспорта выдаётся с 1 октября 1997 года. С 1 июля 2011 года в паспорте заполняются нижние две строки с машиночитаемыми записями (МЧЗ). Сервис извлекает данные как из визуальных полей, так и из МЧЗ. При выборе между ними, сервис ориентируется на контрольные суммы в МЧЗ и читабельность данных визуальных полей.

<figure><img src="https://content.gitbook.com/content/P798bs8GrIKSCwO6P0xF/blobs/0nvilNT1KCpJN9vNsre4/image.png" alt="" width="375"><figcaption><p>Пример документа из <a href="https://ru.wikipedia.org/wiki/%D0%9F%D0%B0%D1%81%D0%BF%D0%BE%D1%80%D1%82_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D0%B8%D0%BD%D0%B0_%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B9%D1%81%D0%BA%D0%BE%D0%B9_%D0%A4%D0%B5%D0%B4%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8">Wikipedia</a></p></figcaption></figure>

{% hint style="success" %}
Тип документа в API: `passport_main`
{% endhint %}

### Перечень извлекаемых полей

<table><thead><tr><th width="204.33333333333331">Поле</th><th width="205">Название в API</th><th>Формат поля</th></tr></thead><tbody><tr><td>Серия и номер</td><td><code>series_and_number</code></td><td>4 цифры, пробел, 6 цифр</td></tr><tr><td>Имя</td><td><code>first_name</code></td><td>Русский алфавит</td></tr><tr><td>Фамилия</td><td><code>surname</code></td><td>Русский алфавит</td></tr><tr><td>Отчество</td><td><code>other_names</code></td><td>Русский алфавит</td></tr><tr><td>Пол</td><td><code>sex</code></td><td><code>муж.</code> или <code>жен.</code></td></tr><tr><td>Дата рождения</td><td><code>date_of_birth</code></td><td>дд.мм.гггг</td></tr><tr><td>Место рождения</td><td><code>place_of_birth</code></td><td>Русский алфавит</td></tr><tr><td>Дата выдачи</td><td><code>date_of_issue</code></td><td>дд.мм.гггг</td></tr><tr><td>Код подразделения</td><td><code>subdivision_code</code></td><td>3 цифры, тире, 3 цифры</td></tr><tr><td>Паспорт выдан</td><td><code>issuing_authority</code></td><td>Русский алфавит</td></tr><tr><td>МЧЗ, строка 1</td><td><code>mrz_1</code></td><td>Латинский алфавит, цифры, &#x3C;></td></tr><tr><td>МЧЗ, строка 2</td><td><code>mrz_2</code></td><td>Латинский алфавит, цифры, &#x3C;></td></tr><tr><td>Номер разворота</td><td><code>page_number</code></td><td><a href="https://ru.wikipedia.org/wiki/%D0%9F%D0%B0%D1%81%D0%BF%D0%BE%D1%80%D1%82_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D0%B8%D0%BD%D0%B0_%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B9%D1%81%D0%BA%D0%BE%D0%B9_%D0%A4%D0%B5%D0%B4%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8#%D0%91%D0%BB%D0%B0%D0%BD%D0%BA_%D0%BF%D0%B0%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0">Номера страниц</a> главного разворота паспорта. Всегда возвращает 2-3</td></tr></tbody></table>

{% hint style="danger" %}
Перед началом работы изучите общее описание сервиса извлечения данных в разделе [«Извлечение данных»](https://doc.dbrain.io/servisy/izvlechenie-dannykh). Ниже мы перечислили лишь уникальные параметры для главного разворота паспорта
{% endhint %}

## Параметры запроса к API

#### Нормализация поля «Паспорт выдан»

{% hint style="success" %}

#### use\_internal\_api — boolean

{% endhint %}

Поведение по умолчанию: `use_internal_api=true` — сервис нормализует поле «Паспорт выдан». Для этого он использует расширенную версию [справочника](https://github.com/hflabs/fms-unit) соответствий кода подразделения и места выдачи. Так мы повышаем точность извлечения поля «Паспорт выдан». Поэтому сервис выдаёт корректный результат даже в ситуациях, когда поле полностью нечитабельно.

В крайне редких случаях нормализация может приводить к неточному соответствию результатов распознавания поля «Паспорт выдан» и фактического текста в паспорте. Например, вместо `ОТДЕЛОМ УФМС РОССИИ ПО Г. МОСКВЕ ПО РАЙОНУ ЗЮЗИНО` сервис может вернуть `ОТДЕЛОМ УФМС РОССИИ ПО ГОРОДУ МОСКВЕ ПО РАЙОНУ ЗЮЗИНО`.

Мы не рекомендуем, но если вы всё же хотите отключить нормализацию поля «Паспорт выдан», передайте параметр `use_internal_api=false`&#x20;

{% hint style="warning" %}
В России нет юридических норм, которые обязывают вас использовать в документах побуквенное воспроизведение поля «Паспорт выдан».&#x20;

Например, у нашего продакта Артёма текст поля «Паспорт выдан» очень длинный и не влезает ни в одну печатную форму. Что ему делать? Артём всегда использует сокращения.&#x20;

Для однозначной идентификации места выдачи документа достаточно поля «Код подразделения»
{% endhint %}

{% hint style="success" %}
Помимо извлечения данных из паспорта сервис Dbrain умеет:

* [Проверять](https://doc.dbrain.io/servisy/proverka-dokumentov)[ действительность паспорта и находить признаки подделки файлов с документом](https://doc.dbrain.io/servisy/proverka-dokumentov)
* [Верифицировать результаты извлечения данных в онлайн-режиме с помощью обученных людей](https://doc.dbrain.io/servisy/manual-recognition)
* [Сравнивать фотографии из паспорта с лицом человека](https://doc.dbrain.io/servisy/operacii-s-licami/sravnenie-lic)
  {% endhint %}