Обработка
На исходнике покажем найденные границы и линию разреза. Готовые страницы можно дополнительно поправить.
История
API
Ключ заменяет пароль в запросах. Не передавайте его посторонним.
Распознанные поля паспорта
При создании задачи параметр ocr по умолчанию включён (-F "ocr=0" — выключить). В ответе готовой задачи (status: done) смотрите массив fields, при включённых проверках — checks, и объект timing.
Статусы поля: ok — уверенно, uncertain — лучше проверить, missing — не найдено, error — неверный формат. Поле inn появляется, только если администратор включил поиск ИНН. Проверки (checks): ok — всё в порядке, not_found — не найдено, invalid — паспорт недействителен, match — есть в списке, review — нужна ручная сверка, skipped — не хватает данных, error — сбой сервиса. У каждой проверки есть время (durationMs) и стоимость (priceRub). Полное описание — в OpenAPI.
Пользователи
Помощь
Краткая инструкция, как пользоваться сервисом в повседневной работе.
С чего начать
- Войдите по логину и паролю, которые выдал администратор.
- В меню слева откройте Обработка — это основной рабочий экран.
- При необходимости переключите светлую или тёмную тему кнопкой в правом верхнем углу.
Как обработать сканы
- Выберите режим: Авто (рекомендуется), Одна страница или Разворот.
- При необходимости включите доп. опции: выравнивание, обрезку фона, яркость и контраст, распознать поля.
- Перетащите файлы в область загрузки или нажмите на неё и выберите файлы. Можно сразу несколько.
- Поддерживаются PDF (в том числе многостраничные), JPG, PNG, WEBP, TIFF и BMP.
- Нажмите Обработать и дождитесь результата ниже.
- Авто — сервис сам ищет линию сгиба, даже если края чуть обрезаны.
- Одна страница — если на снимке уже одна страница паспорта.
- Разворот — если на снимке две страницы рядом и нужно разрезать по сгибу.
Что делать с результатом
- Откройте карточку задачи: там видны исходник с разметкой и готовые страницы. Для PDF исходник сначала переводится в картинку — на ней же показываются синяя рамка границ и красная линия разреза.
- На каждой готовой странице поверх снимка — номер бланка (если распознан) и метка типа: Выдача, ФИО или Прописка.
- В блоке Структура паспорта — все поля бланка. Иконки: ✓ уверенно, ! лучше проверить (наведите курсор — пояснение), – не найдено. Если администратор включил поиск ИНН, номер появится отдельной строкой.
- Блок Проверки виден, когда проверки включены. Там действительность паспорта по данным МВД, поиск ИНН и сверка со списками террористов и экстремистов. У каждой строки — итог, сколько заняло времени и сколько списалось.
- Значения в полях можно поправить перед копированием в свою систему.
- Скачайте отдельные страницы или весь результат разом (кнопка «Скачать всё»).
- Нажмите на картинку, чтобы увеличить её.
- Если результат не устроил — измените настройки и запустите повторно без новой загрузки файла.
История
- В разделе История хранятся прошлые обработки.
- Можно найти задачу по имени файла, открыть её снова, повторить или удалить.
- Кнопка Очистить историю удаляет все прошлые записи разом.
Ключ API
Раздел API нужен, если сканы должны обрабатываться из другой системы автоматически. Ключ заменяет пароль в таких запросах — его нельзя передавать посторонним. При необходимости ключ можно обновить: старый сразу перестанет действовать.
В ответе задачи при распознавании полей смотрите массив fields (со статусами), при включённых проверках — checks и поле inn, у каждой страницы — pageNumber / pageType, а также timing (в том числе время проверок). Подробности и пример — на странице API и в OpenAPI.
Для администратора
- В меню профиля доступен раздел Пользователи: создание учёток и назначение роли.
- В Настройки (только администратор) можно выбрать, чем распознавать поля паспорта: локально или через Яндекс.Облако, указать ключ доступа и смотреть статистику использования облака. Там же включаются проверки: ИНН, действительность паспорта через МВД и списки террористов и экстремистов — с ключом сервиса и учётом расхода. Там же задаётся срок хранения истории.
- В О приложении — краткое описание сервиса.
Метка Beta
Сервис в пробной версии: функции уже можно использовать в работе, но отдельные детали ещё могут меняться.
Настройки
Распознавание полей
Выберите, каким сервисом читать данные с паспорта. Локальный работает без интернета. Яндекс.Облако — отдельная модель «паспорт», данные уходят во внешний сервис.
Нужны сервисный аккаунт с ролью на Vision OCR и API-ключ в консоли Яндекс.Облака. Если облако недоступно, сервис попробует распознать локально.
Использование Яндекса
Считаем свои запросы: Яндекс тарифицирует распознавание паспорта примерно по 0,71 ₽ за страницу. Остаток баланса в облаке здесь не виден — его смотрите в кабинете Яндекса.
Проверки после распознавания
По желанию сервис сверяет паспорт во внешних базах. Общий выключатель и ключ включают проверки для всех новых обработок. Каждую проверку можно включить отдельно.
Данные паспорта уходят во внешний сервис. Паспорт проверяется в МВД по актуальным данным, а не по старой выгрузке. Если на скане не хватает полей, запрос не отправляется и деньги не списываются.
Расход на проверки
Считаем фактические списания из ответов сервиса, не ориентировочные цены.
Хранение истории
Старые обработки и файлы удаляются автоматически. Срок по умолчанию — 30 дней. Ноль отключает автоочистку.
О приложении
Сервис принимает сканы паспорта, в том числе сразу несколько файлов и многостраничные PDF. Каждый лист документа обрабатывается отдельно: если это разворот, он делится на две страницы по линии сгиба. PDF перед разметкой переводится в изображение, чтобы на исходнике были видны границы документа и линия разреза. На выходе — отдельные файлы по страницам, общий PDF и архив со всем результатом сразу. Исходный файл сохраняется для сверки. Готовые страницы можно увеличить. По желанию их также можно выровнять, обрезать пустое поле и поправить яркость. Если настройки изменить, результат можно запустить заново без новой загрузки.
Распознавание полей настраивается администратором в разделе «Настройки». Результат можно забрать в интерфейсе или по ключу API.