# Паспорт

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

<figure><img src="/files/x0rpBmEeFKXNeBeQPR5A" 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" %}
Перед началом работы изучите общее описание сервиса извлечения данных в разделе [«Извлечение данных»](/servisy/izvlechenie-dannykh.md). Ниже мы перечислили лишь уникальные параметры для главного разворота паспорта
{% endhint %}

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

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

{% hint style="success" %}
**use\_internal\_api — boolean**
{% endhint %}

1. async
   * **Назначение**: Асинхронная обработка задач. Позволяет отправить задачу в API и получить результат через эндпоинт result.
   * **Состояние**: Работает корректно.
2. return\_crops
   * **Назначение**: Возвращает бинарное изображение вырезанного из фона и корректно сориентированного документа.
   * **Состояние**: Работает корректно.
3. task\_tags
   * **Назначение**: Метки задач, позволяющие идентифицировать и организовывать запросы по ключевым словам или строкам. Передается массив тегов.
   * **Состояние**: Работает корректно.
4. address\_division
   * **Назначение**: Разделение адреса на административные и муниципальные единицы. Используется только для прописок
   * **Состояние**: Работает, основное использование — административное деление(районы, муниц. округа).
5. **check\_fake**
   * **Назначение**: Проверка метаданных изображения на подлинность, раньше использовалась в anti-fraud.
   * **Состояние**: Перенесен в антифрод, сохранён для обратной совместимости.
6. **check\_fake\_visual**
   * **Назначение**: Определение фальшивых изображений, помогает выявить отредактированные документы (например, созданные в Photoshop).
   * **Состояние**: Устарел, перенесен в антифрод; Сохранён для обратной совместимости.
7. classify\_image\_origin
   * **Назначение**: Классификация источника изображения (скан, фото и т.д.).
   * **Состояние**: Работает; улучшенная версия теперь интегрирована в антифрод.
8. doc\_type
   * **Назначение**: Определение типа документа для фильтрации и классификации. В ответ приходит только указанный тип документа.
   * **Состояние**: Работает корректно.
9. **use\_internal\_api**
   * **Назначение**: Включение нормализации места выдачи паспорта РФ с использованием внутреннего словаря.
   * **Состояние**: Перенесен в антифрод, сохранён для обратной совместимости. используется по умолчанию.
10. **use\_iqa (Image Quality Assessment)**
    * **Назначение**: Оценка качества изображения для проверки его пригодности к распознаванию.
    * **Состояние**: Работает; Предназначен для мобильных приложениях.
11. **with\_gocr**
    * **Назначение**: Используется для распознавания текста на языках СНГ и других локальных языках с редкими символами.
    * **Состояние**: Работает только в облаке; используется для специфических документов.

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

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

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

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

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

Для однозначной идентификации места выдачи документа достаточно поля «Код подразделения»
{% 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://docs.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.