QRScan + A8PRO CR · Интеграторға арналған материалдар
Бағдарламаңызға құжат деректерін оқуды қосыңыз
QRScan және A8PRO CR құжат деректерін алады. Бағдарламаңыз оларды клиент карточкасына, шартқа немесе басқа операцияға қолданады. Қосылу салаға қарамастан сіздің жұмыс үдерісіңізге бейімделеді.
ZIP · RU/KZ/EN нұсқаулықтары, QRScan v2 OpenAPI, Postman жинағы және қосылу сауалнамасы. Кілттер мен орнатқыштар жоқ.
Мүмкіндікті үйреншікті үдеріске қосыңыз
Оператор өз жүйеңізде қалады
Деректер клиенттерді рәсімдейтін жерде пайдаланылады. Құжат оқуды клиент карточкасымен немесе бағдарламаңыздағы операциямен байланыстыруға болады.
Қайта терудің орнына құрылымды өрістер
Қолжетімді аты-жөнді, ЖСН мен құжат деректемелерін алып, өз өрістеріңізбен сәйкестендіріңіз және нәтижені операторға көрсетіңіз.
Бір немесе екі тәсіл
QRScan түпнұсқаны және клиент телефонындағы цифрлық құжатты түсіреді. A8PRO CR үйлесімді картридермен және паспорт сканерімен жұмыс істейді.
Қосылу интерфейсін таңдаңыз
QRScan · сервис API-і
Смартфон құжатты браузерде түсіреді. Интеграцияның серверлік бөлігі сеанс жасап, нәтижені HTTPS арқылы JSON пішімінде алады.
- Сеанс жасап, mobile_url мәнін QR-код ретінде көрсету.
- Түсіруді күтіп, оператор дайын болғанда нәтижені алу.
- Өрістерді тексеріп, нәтижені өз жүйеңізде сенімді сақтау.
- Алмасуды аяқтау үшін receipt_token бар ACK жіберу.
Қолжетімділік кілті бөлек беріледі және серверлік бөлікте сақталады. Ашық демо үдерісті көрсетеді, бірақ 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.
- Жұмыс орындарының саны және қалаған оқу үдерісі.
Осы мәліметтерге сүйеніп, алмасу тәсілін, сынақ сценарийін, жеткізу құрамын және жұмыс құнын келісеміз. Мерзімдер мен тестілік қолжетімділік шарттары жобаңызға қарай анықталады.