Паспорт
BETA

Проверка сканов паспорта

Паспорт BETA
Обработка История API Помощь

Обработка

Режим
Авто ищет линию сгиба по всему развороту, даже если края чуть обрезаны или вокруг снимка пустое поле. Одна страница оставляет кадр целиком. Разворот режет по найденному сгибу.
Дополнительно

На исходнике покажем найденные границы и линию разреза. Готовые страницы можно дополнительно поправить.

Перетащите сканы паспорта или нажмите, чтобы выбрать файлы
Можно несколько файлов одного паспорта: PDF, JPG, PNG, WEBP, TIFF или BMP

История

API

Ключ заменяет пароль в запросах. Не передавайте его посторонним.


            

            

              
Распознанные поля паспорта

              
При создании задачи параметр ocr по умолчанию включён (-F "ocr=0" — выключить). В ответе есть id (UUID) и link (путь к карточке в интерфейсе, /#/job/…). У готовой задачи (status: done) смотрите массив fields, список пояснений reasons (что нашлось и чего не хватает), при включённых проверках — checks, объекты timing и services (какой сервис распознал поля и кто делал проверки).

              

              
Статусы поля: ok — уверенно, uncertain — лучше проверить, missing — не найдено, error — неверный формат. Поле inn появляется, только если администратор включил поиск ИНН. Проверки (checks): ok — всё в порядке, not_found — не найдено, invalid — паспорт недействителен, match — есть в списке, review — нужна ручная сверка, skipped — не хватает данных, error — сбой сервиса. У каждой проверки есть время (durationMs) и стоимость (priceRub). Полное описание — в OpenAPI.

            

            

              

                

                  
Методы API

                  
Описание операций для подключения по ключу.

                

                

                  YAML
                  JSON
                

              

              

              
Загрузка…

              

                

                  
                    

                      Метод
                      Путь
                      Описание
                      Раздел
                    

                  
                  
                

              

            

          


          

            
Пользователи

            

              

                

                  
                  
                

                

                  
                  
                

                

                  Роль
                  

                    
                    
                  

                

                

                  
                

              

            

            

          


          

            
Помощь

            
Краткая инструкция, как пользоваться сервисом в повседневной работе.


            

              
С чего начать

              
    
                
  1. Войдите по логину и паролю, которые выдал администратор.
    2. 
                
  2. В меню слева откройте Обработка — это основной рабочий экран.
    3. 
                
  3. При необходимости переключите светлую или тёмную тему кнопкой в правом верхнем углу.
    4. 
              

            


            

              
Как обработать сканы

              
    
                
  1. Выберите режим и опции (блок можно свернуть — при запуске обработки он сворачивается сам). Перетащите файлы одного паспорта и нажмите Обработать — несколько файлов уходят одной задачей, данные собираются со всех страниц.
    2. 
              

              

                Какой режим выбрать?
                
    
                  
  • Авто — сервис сам ищет линию сгиба, даже если края чуть обрезаны.
    • 
                  
  • Одна страница — если на снимке уже одна страница паспорта.
    • 
                  
  • Разворот — если на снимке две страницы рядом и нужно разрезать по сгибу.
    • 
                

              

              

                Распознать поля — по умолчанию включено. Сервис читает ФИО, даты, серию, прописку и другие поля и показывает их в блоке «Структура паспорта». Чем именно распознавать (локально или через Яндекс.Облако) задаёт администратор в Настройках. Если облако вернуло неполный набор (нет фамилии, серии или блока выдачи), приложение дополняет пустые поля локальным чтением; при расхождении даты рождения надёжнее локальное чтение (машинная зона) может заменить ответ облака. Для рукописных бланков (старые паспорта) облако сначала пробует модель «паспорт», а если ответ пустой или слишком скудный (например, один ложный код со штампа) — дочитывает моделью «рукопись», при необходимости пробуя поворот страницы. Если штампов прописки несколько, берётся последний: по дате на штампе, иначе по номеру страницы бланка, иначе по порядку файлов. Зоны найденных полей подсвечиваются рамками и при облачном, и при локальном чтении. Мелкие половинки разворота перед отправкой в облако увеличиваются. Выбор галочки «Распознать поля» запоминается в браузере. На плохих сканах поля могут быть с пометкой «лучше проверить» — это нормально, правьте вручную перед использованием. Блики голограмм на фото часто мешают фамилии и дате рождения: лучше переснять под другим углом или включить «Яркость и контраст» и повторить.
              

            


            

              
Что делать с результатом

              
    
                
  • Откройте карточку задачи: там видны исходник с разметкой и готовые страницы. Для PDF исходник сначала переводится в картинку — на ней же показываются синяя рамка границ и красная линия разреза.
    • 
                
  • В карточке можно скопировать прямую ссылку на эту обработку (кнопка «Скопировать ссылку») — удобно, чтобы вернуться к результату или передать коллеге.
    • 
                
  • На каждой готовой странице поверх снимка — номер бланка (если распознан) и метка типа: Выдача, ФИО или Прописка. Если поля распознаны, их зоны подсвечены цветной рамкой: зелёная — уверенно, жёлтая — лучше проверить, красная — ошибка формата.
    • 
                
  • Страницы автоматически поворачиваются, чтобы текст читался привычно (не вверх ногами и не боком). Сканы с телефона с меткой ориентации уже учитывались раньше; теперь то же делается и для «кривых» сканов без такой метки.
    • 
                
  • В блоке Структура паспорта — все поля бланка. Иконки: ✓ уверенно, ! лучше проверить (наведите курсор — пояснение), – не найдено. Ниже — список причин: сколько полей заполнено, какие страницы нашлись, что не прочиталось и почему. Если администратор включил поиск ИНН, номер появится отдельной строкой. Сервисы, время и ориентировочная стоимость показаны чипами над полями.
    • 
                
  • Блок Проверки виден, когда проверки включены. Там действительность паспорта по данным МВД, поиск ИНН и сверка со списками террористов и экстремистов. У каждой строки — итог, сколько заняло времени и сколько списалось.
    • 
                
  • Значения в полях можно поправить перед копированием в свою систему.
    • 
                
  • Скачайте отдельные страницы или весь результат разом (кнопка «Скачать всё»).
    • 
                
  • Нажмите на картинку, чтобы увеличить её.
    • 
                
  • Если результат не устроил — измените настройки и запустите повторно без новой загрузки файла.
    • 
              

            


            

              
История

              
    
                
  • В разделе История хранятся прошлые обработки.
    • 
                
  • Можно найти задачу по имени файла, открыть её снова, повторить или удалить.
    • 
                
  • У каждой задачи есть уникальный номер (UUID). Кнопка со ссылкой копирует адрес карточки — его можно отправить коллеге. После входа в сервис ссылка сразу откроет статус и результат.
    • 
                
  • Кнопка Очистить историю удаляет все прошлые записи разом.
    • 
              

            


            

              
Ключ API

              
Раздел API нужен, если сканы должны обрабатываться из другой системы автоматически. Ключ заменяет пароль в таких запросах — его нельзя передавать посторонним. При необходимости ключ можно обновить: старый сразу перестанет действовать.

              
В ответе задачи есть id (UUID) и link для открытия карточки в браузере. При распознавании полей смотрите массив fields (со статусами) и reasons (кратко: что найдено и чего не хватает), при включённых проверках — checks и поле inn, у каждой страницы — pageNumber / pageType, а также timing и services (какой сервис читал поля и кто делал проверки). Подробности и пример — на странице API и в OpenAPI.

            


            

              
Для администратора

              
    
                
  • В меню профиля доступен раздел Пользователи: создание учёток и назначение роли.
    • 
                
  • В Настройки (только администратор) можно выбрать, чем распознавать поля паспорта: локально или через Яндекс.Облако, указать ключ доступа и смотреть статистику использования облака. Там же включаются проверки: ИНН, действительность паспорта через МВД и списки террористов и экстремистов — с ключом сервиса и учётом расхода. Там же задаётся срок хранения истории.
    • 
                
  • В карточке задачи (после обработки через Яндекс) есть кнопка Тех. ответ Яндекса: можно посмотреть запрос и сырой ответ облака без картинки и без ключа — удобно разбирать сбои распознавания.
    • 
                
  • В О приложении — краткое описание сервиса.
    • 
              

            


            

              
Метка Beta

              
Сервис в пробной версии: функции уже можно использовать в работе, но отдельные детали ещё могут меняться.

            

          


          

            
Настройки

            

              
Распознавание полей

              
Выберите, каким сервисом читать данные с паспорта. Локальный работает без интернета. Яндекс.Облако сначала читает моделью «паспорт», а для рукописных бланков при пустом ответе — моделью «рукопись». Данные уходят во внешний сервис.

              

                Сервис
                

                  
                  
                

              

              

                

                  
                  
                

                

                  
                  
                  

                

                
Нужны сервисный аккаунт с ролью на Vision OCR и API-ключ в консоли Яндекс.Облака. Если модель «паспорт» не нашла поля (часто на рукописных бланках), сервис сам запросит модель «рукопись». Если облако недоступно или набор всё ещё неполный, результат дополнится локальным чтением.

              

              

                
              

            

            

              
Использование Яндекса

              
Считаем свои запросы: Яндекс тарифицирует распознавание паспорта примерно по 0,71 ₽ за страницу. Остаток баланса в облаке здесь не виден — его смотрите в кабинете Яндекса.

              

                
0Запросов

                
0Успешно

                
0Ошибок

                
0Единиц

                
0Оценка, ₽

              

              

              

                
              

            

            

              
Проверки после распознавания

              
По желанию сервис сверяет паспорт во внешних базах. Общий выключатель и ключ включают проверки для всех новых обработок. Каждую проверку можно включить отдельно.

              
              

                
                
                
              

              

                
                
                

              

              
Данные паспорта уходят во внешний сервис. Паспорт проверяется в МВД по актуальным данным, а не по старой выгрузке. Если на скане не хватает полей, запрос не отправляется и деньги не списываются.

              

                
              

            

            

              
Расход на проверки

              
Считаем фактические списания из ответов сервиса, не ориентировочные цены.

              

                
0Запросов

                
0Успешно

                
0Ошибок

                
0Списано, ₽

                
—Остаток, ₽

              

              

              

                
              

            

            

              
Хранение истории

              
Старые обработки и файлы удаляются автоматически. Срок по умолчанию — 30 дней. Ноль отключает автоочистку.

              

                
                
              

              

                
              

            

          


          

            
О приложении

            

              

                
                

                  
Паспорт

                  BETA
                

              

              
Сервис принимает сканы паспорта, в том числе сразу несколько файлов одного документа и многостраничные PDF. Все файлы одной загрузки — один паспорт: данные собираются со всех страниц. Каждый лист обрабатывается отдельно: если это разворот, он делится на две страницы по линии сгиба. PDF перед разметкой переводится в изображение, чтобы на исходнике были видны границы документа и линия разреза. На выходе — отдельные файлы по страницам, общий PDF и архив со всем результатом сразу. Исходный файл сохраняется для сверки. Готовые страницы можно увеличить. По желанию их также можно выровнять, обрезать пустое поле и поправить яркость. Если настройки изменить, результат можно запустить заново без новой загрузки.

              
Распознавание полей настраивается администратором в разделе «Настройки». Результат можно забрать в интерфейсе или по ключу API.