QRScan + A8PRO CR · Материалы для интегратора
Добавьте считывание документов в вашу программу
QRScan и A8PRO CR получают данные документа. Ваша программа использует их для карточки клиента, договора или другой операции. Подключение строится вокруг вашего рабочего процесса — независимо от отрасли.
ZIP · инструкции RU/KZ/EN, OpenAPI QRScan v2, коллекция Postman и анкета подключения. Без ключей и установщиков.
Добавьте функцию, сохранив привычный процесс
Оператор остаётся в вашей системе
Данные используются там, где уже оформляют клиентов. Можно связать запуск считывания с карточкой клиента или документом вашей программы.
Структурированные поля вместо перепечатывания
Получайте доступные ФИО, ИИН и реквизиты документа, сопоставляйте их со своими полями и показывайте результат оператору.
Один или оба способа
QRScan подходит для съёмки оригиналов и цифровых документов с телефона клиента. A8PRO CR — для совместимого картридера и паспортного сканера.
Выберите интерфейс подключения
QRScan · API сервиса
Смартфон снимает документ в браузере. Серверная часть вашей интеграции создаёт сеанс и получает результат по HTTPS в JSON.
- Создать сеанс и показать QR-код с mobile_url.
- Дождаться съёмки; получить результат по действию оператора.
- Проверить поля и надёжно сохранить результат в своей системе.
- Отправить ACK с receipt_token, чтобы завершить обмен.
Ключ выдаётся отдельно и хранится на серверной стороне. Публичное демо показывает процесс, но не предоставляет API-доступ.
A8PRO CR · локальный интерфейс
Программа на компьютере Windows связывает совместимый считыватель с вашей системой. Для самого считывания и локальной передачи результата интернет не требуется.
- Зафиксировать версию A8PRO CR, Windows, устройство и драйвер.
- Получить контракт локального интерфейса именно для выбранной версии.
- Настроить запросы, сопоставление полей и проверку результата оператором.
- Проверить чтение, ошибки устройства и повторные операции на рабочем месте.
Точные адреса, авторизация, формат ответа и подтверждение получения зависят от выбранного выпуска. Универсальный контракт для всех версий не заявляется; согласуем его до разработки.
Как связать считывание с вашей системой
1С или настольная программа
Разработчик добавляет команду считывания и заполнение нужных полей. Для A8PRO CR проверяем, где выполняется клиент: на рабочем ПК или сервере.
CRM или веб-приложение
QRScan подключается через серверную часть. Для A8PRO CR отдельно проектируем связь с компьютером оператора: localhost сервера — не компьютер клиента.
Терминальный сервер или удалённое рабочее место
Согласуем расположение устройства, драйверов и компонента интеграции. Возможность проброса оборудования проверяется на вашей инфраструктуре.
Что делает A8PRO, а что — ваша программа
A8PRO
Предоставляет средство считывания, согласованный интерфейс, описание обмена и условия доступа. Для оборудования подтверждается выбранная конфигурация.
Интегратор
Добавляет запуск и получение результата, сопоставляет поля, обрабатывает ожидание и ошибки, реализует проверку и сохранение в принимающей системе.
Поля и правила обработки
Состав результата зависит от документа и способа чтения. Не все поля доступны одновременно: например, данные чипа и MRZ различаются. Проверяйте даты и форматы, оставляйте возможность исправления; не заменяйте существующие данные пустыми значениями.
Пример сопоставления полей QRScan
| Поле API | Поле вашей системы |
|---|---|
last_name / first_name / middle_name | Фамилия / имя / отчество |
iin | ИИН — строка, не число |
document_number | Номер документа — строка |
issuing_authority | Кем выдан документ |
issue_date / expiry_date | Даты выдачи / окончания после проверки |
Это пример сопоставления, а не полный ответ API и не общий формат двух продуктов. Контракт A8PRO CR согласуется отдельно.
Что проверить перед запуском
- Обычное считывание, проверка и сохранение в нужной карточке.
- Пустые поля, неполный документ и корректность дат.
- Отмена, истечение срока, отсутствие связи или отключённое устройство.
- Повтор запроса после потери ответа — без повторного оформления клиента.
- Изоляция одновременных операций разных рабочих мест.
- Для QRScan: сохранение до ACK, повтор ACK и отсутствие возврата к API v1.
Вопросы о подключении
Можно подключить любую программу?
Возможность зависит от интерфейсов и доступности доработки. 1С, CRM и другие системы — типы возможных интеграций, а не обещание готового модуля для каждой версии.
Нужны ли отдельные версии для разных отраслей?
Механизм считывания одинаков. Отличаются поля назначения и рабочий процесс принимающей программы.
Достаточно ли просто купить картридер?
Нужны совместимые документ, оборудование, драйвер, A8PRO CR и связь с принимающей программой. Состав поставки согласуем до подключения.
Где сохраняется результат?
После передачи правила сохранения и доступа задаёт ваша система. В QRScan нужно корректно завершать обмен через ACK; для A8PRO CR используется контракт выбранного выпуска.
Что прислать для оценки подключения
- Название и версия программы; кто может её дорабатывать.
- Где она работает: рабочий ПК, браузер, сервер или терминальная сессия.
- Какие документы и поля нужны; где их использовать.
- QRScan, A8PRO CR или оба варианта; для CR — устройство, драйвер и Windows.
- Количество рабочих мест и желаемый сценарий запуска считывания.
На основании этих данных согласуем способ обмена, тестовый сценарий, состав поставки и стоимость работ. Сроки и условия тестового доступа определяются для вашего проекта.