# Паспорт

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

<figure><img src="/files/x0rpBmEeFKXNeBeQPR5A" alt="" width="375"><figcaption><p>Пример документа из <a href="https://ru.wikipedia.org/wiki/Паспорт_гражданина_Российской_Федерации">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" %}
Перед началом работы изучите общее описание сервиса извлечения данных в разделе [«Извлечение данных»](/servisy/izvlechenie-dannykh.md). Ниже мы перечислили лишь уникальные параметры для главного разворота паспорта
{% 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 умеет:

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.dbrain.io/servisy/izvlechenie-dannykh/pasport.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
