Документация QntSoft API
Общие сведения
Qntsoft API – набор веб-сервисов для получения и валидации реквизитов юридических лиц, ИП и физизических лиц, а также прочей полезной информации.
Доступ к сервисам осуществляется по протоколу HTTP. В данном документе описаны базовые принципы взаимодействия с API.
Подключиться
По вопросам получения токена для доступа к API обращайтесь на электронную почту sales@qntsoft.ru
Авторизация запросов
В данный момент для авторизации запроса к API необходимо передать параметр token
содержащий ваш персональный авторизационный ключ.
В будущих версиях API будет доступна возможность авторизации с помощью HTTP заголовка Authorization: Bearer token
Выполнение запросов к API
Все запросы к QntSoft API выполняются по протоколу HTTPS.
Способ передачи параметров: form-data или x-www-form-urlencoded.
Конкретные Endpoint URL и методы запросов (на данный момент API использует GET и POST) указаны в описании каждого конкретного метода.
В случае успешного ответа API вернет HTTP-код 200.
В случае ошибки будет возвращен один из HTTP-кодов: 400, 403, 404
Тестирование запросов в Postman
Запросы к сервисам Api QntSoft можно тестировать и отлаживать с помощью приложения Postman. Не забудьте подставить в запрос свой авторизационный token
вместо QNTSOFT_API_TOKEN
.
Для того, чтобы не подставлять свой токен в каждом сервисе в Postman вручную, вы можете воспользоваться настройкой окружения (Manage Environments - в правом верхнем углу) и добавить QNTSOFT_API_TOKEN в глобальные переменные, указав Ваш токен.
Для загрузки коллекции Postman перейдите по ссылке:
Банковские сервисы
Получение данных о пластиковой карте по первым 6 цифрам (BIN)
Данный метод используется для получения сведений о пластиковой (банковской) карте по BIN-номеру банка (первые 6 цифр)
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
bin | Да | BIN карты (первые 6 цифр). Можно передать от 3 до 6 цифр |
Примеры ответов:
Получение данных о банке (Россия) по номеру БИК
Данный метод используется для получения сведений о банке по его БИК
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
bic | Да | БИК банка |
Пример ответа:
Получение сведений о приостановлении операций по банковским счетам налогоплательщиков
Данный метод используется для получения сведений о приостановлении операций по банковским счетам налогоплательщиков.
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
inn | Да | ИНН налогоплательщика |
bic | Да | БИК банка, от имени которого выполняется запрос |
Пример ответа:
API сервисы для России
Получение ИНН физического лица по паспортным данным
Данный метод используется для получения ИНН физического лица по паспортным данным.
Время ответа на запрос может достигать 15 секунд.
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
document_series | Да | Серия паспорта. 4 цифры. |
document_number | Да | Номер паспорта. 6 цифр. |
document_issue_date | Да | Дата выдачи документа в формате дд.мм.гггг |
first_name | Да | Имя из паспорта |
last_name | Да | Фамилия из паспорта |
father_name | Нет | Отчество из паспорта. Является обязательным, только при наличии отчества в паспорте. |
birth_date | Да | Дата рождения по паспорту в формате дд.мм.гггг |
use_cache | Нет | Флаг использования кеша:1 - пытаться найти данные пользователя в кеше qntsoft0 – не использовать кешЗначение по умолчанию – 1 |
Пример ответа:
Получение данных компании/ИП по ИНН/ОГРН из ЕГРЮЛ/ЕГРИП
Данный метод используется для получения сведений об ИП и юридических лицах из базы данных ЕГРЮЛ/ЕГРИП по ИНН или ОГРН юр. лица / ИП.
URL для запроса: https://api.qntsoft.ru/api/ru/egrul/inn/{INN}?token={TOKEN}
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
inn | Да | ИНН |
URL для запроса: https://api.qntsoft.ru/api/ru/egrul/ogrn/{OGRN}?token={TOKEN}
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
ogrn | Да | ОГРН (обязательный для поиска по ОГРН) |
Пример ответа:
Проверка паспорта по базе отозванных паспортов ФМС/МВД
Данный метод используется для проверки паспорта физического лица по базе данных ФМС/МВД.
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
passport_series | Да | Серия паспорта. 4 цифры. |
passport_number | Да | Номер паспорта. 6 цифр. |
Пример ответа:
Проверка наличия ККТ в реестре
Данный метод используется для проверки наличия ККТ (контрольно-кассовой техники) в реестре ФНС
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
factory_number | Да | Заводской номер |
model_code | Да | Код модели (см таблицу ниже) |
Таблица кодов моделей ККТ
ООО «АЗУР ПОС» | |
---|---|
0118 | АЗУР-01Ф |
ООО «АРКУС-СТ» | |
0102 | АМС-300.1Ф |
0083 | АМС-300Ф |
0130 | АМС-700Ф |
0047 | АМС-100Ф |
ООО «АСТОР ТРЕЙД» | |
0099 | Меркурий-МФ |
0056 | Меркурий-119Ф |
0076 | Меркурий-130Ф |
0077 | Меркурий-180Ф |
0050 | Меркурий-115Ф |
0051 | Меркурий-185Ф |
ООО «АТОЛ» | |
0103 | АТОЛ 20Ф |
0104 | АТОЛ 50Ф |
0110 | АТОЛ 91Ф |
0162 | АТОЛ Sigma 8Ф |
0161 | АТОЛ Sigma 7Ф |
0121 | АТОЛ 92Ф |
0122 | АТОЛ 150Ф |
0062 | АТОЛ 42ФС |
0073 | АТОЛ 60Ф |
0074 | АТОЛ 15Ф |
0018 | АТОЛ 90Ф |
0019 | АТОЛ 55Ф |
0020 | АТОЛ 52Ф |
0021 | АТОЛ 25Ф |
0006 | АТОЛ 77Ф |
0007 | АТОЛ 30Ф |
0008 | АТОЛ 11Ф |
0002 | АТОЛ FPrint-22ПТК |
ООО «Винкор Никсдорф» | |
0068 | WNJI-003Ф |
ООО НПО «ГК ПОРТ» | |
0111 | ПОРТ-100Ф |
0112 | ПОРТ-1000Ф |
0154 | ПОРТ-600Ф |
ООО «Дримкас» | |
0034 | ВИКИ ПРИНТ 80 ПЛЮС Ф |
0044 | Viki Tower F |
0125 | Касса Ф |
0140 | Пульс ФА |
0075 | Дримкас-Ф |
0004 | ВИКИ МИНИ Ф |
0022 | ВИКИ ПРИНТ 57 Ф |
0023 | ВИКИ ПРИНТ 57 ПЛЮС Ф |
ООО «Инженерный Стапель» | |
0133 | САЛЮТ-08Ф |
0134 | САЛЮТ-10Ф |
ООО «ИЗОТ-Электроникс» | |
0155 | Электроника 30Ф |
ООО «ИнфоОборона» | |
0107 | FN-1.online/ФАС |
ООО «ИСКРАСервис» | |
0119 | МИКРО 106-Ф |
0069 | МИКРО 35G-Ф |
ООО «КРАФТ» | |
0136 | Уникум-ФА |
ООО «КАССОВЫЕ РЕШЕНИЯ» | |
0150 | Облако-1Ф |
ООО «ККМ ОНЛАЙН» | |
0117 | НЕВА-01-Ф |
ООО «КАСТОМ» | |
0081 | CUSTOM Q3X-Ф |
ООО «КАЗНАЧЕЙ» | |
0057 | КАЗНАЧЕЙ ФА |
ООО «КИТ ИНВЕСТ» | |
0106 | КИТ Онлайн-Ф |
0123 | КИТ ШОП-Ф |
0078 | Терминал-ФА |
АО «Калужский завод телеграфной аппаратуры» | |
0079 | Касби-02Ф |
ЗАО «Компьютерно-кассовые системы» | |
0052 | СПАРК-115-Ф |
ООО «Кристалл Сервис Интеграция» | |
0035 | ПИРИТ 2СФ |
0005 | ПИРИТ 2Ф |
0024 | ПИРИТ 1Ф |
ООО «ЛАНТЕР» | |
0132 | TZ Pro-F |
ООО «ЛАБОРАТОРИЯ ЗАЩИТЫ ИНФОРМАЦИИ» | |
0089 | К1-Ф |
ООО «Мобильные платежные системы» | |
0163 | ПэйМоб-Ф |
ООО «Мультисофт Системз» | |
0156 | MSPOS-E-Ф |
0141 | IRAS-EM Ф |
0142 | IRAS-E Ф |
0143 | MSPOS-T-Ф |
ООО «Новые кассовые решения» | |
0138 | НКР-01-Ф |
АО «Научно-исследовательсткий институт «Солитон» | |
0113 | МТ01-Солитон mPOS-Ф |
ООО «НТЦ«Измеритель» | |
0065 | ЭЛВЕС-ФР-Ф |
0114 | ЭЛВЕС-МИНИ-Ф |
0015 | ЭЛВЕС-МФ |
0072 | ЭЛВЕС-МИКРО-Ф |
ООО «НТЦ Альфа-Проект» | |
0030 | ПТК«IRAS 900 K» |
0115 | ПТК«АЛЬФА-ТК-Ф» |
0144 | СТАРТ-ТК-Ф |
0145 | СТАРТ 21 ФА |
0027 | ПТК«MSTAR-TK» |
0028 | ПТК«MSPOS-K» |
0029 | ПТК«АЛЬФА-ТК» |
ООО «Ойстерс» | |
0165 | Лимон БАНК-Ф |
0164 | Лимон СМАРТ-Ф |
0160 | Лимон МОБАЙЛ-Ф |
ООО «ОПЛАТ-СЕРВИС» | |
0084 | УМКА-01-ФА |
ООО «ОРИОН ЮТА ТРЕЙД» | |
0055 | ОРИОН-100Ф |
ООО «ПОСЦЕНТР» | |
0135 | POSCENTER-A7L-Ф |
0158 | POSCENTER-02Ф |
0139 | РИТЕЙЛ-КОМБО-01Ф |
ООО «Передовые торговые решения» | |
0088 | ars.mobile Ф |
0097 | ars.vera 01Ф |
0098 | ars.evo 01Ф |
ООО «ПРЕДПРИЯТИЕ«МИКРОТЕХ» | |
0148 | MicroPay-ФС |
0124 | MicroPay-ФАС |
0070 | ПКТФ |
ООО «Пионер инжиниринг» | |
0042 | Пионер-114Ф |
ООО «Пэй Киоск» | |
0032 | PAYONLINE-01-ФА |
0092 | NETPAY-ФС |
0127 | AQSI5-Ф |
0063 | PAY VKP-80K-ФА |
ООО «ПРОФИНДУСТРИЯ-ЦЕНТР» | |
0146 | MB Solution-F |
ООО «РайтСкан» | |
0151 | МКАССА RS9000-Ф |
ООО «Ремонт и обслуживание контрольно-кассовой техники» | |
0085 | МЕЩЕРА-01-Ф |
ООО «РП Система» | |
0082 | РП Система 1ФС |
0109 | Кассир 57Ф |
0126 | КАССИР 80Ф |
0149 | Кассатка-Мини-Ф |
0120 | Кассатка-1Ф |
0064 | РП Система 1ФА |
ООО «РР-Электро» | |
0036 | РР-03Ф |
0037 | РР-04Ф |
0157 | РР-Микро-Ф |
0013 | РР-01Ф |
0025 | РР-02Ф |
АО Научно-производственный центр «Спектр» | |
0131 | СПЕКТР-ПС-Ф |
ООО «СЧЕТНО АНАЛИТИЧЕСКИЕ МАШИНЫ» | |
0087 | ОКА-102Ф |
0108 | Ока МФ |
ООО «Сервис Плюс» | |
0091 | СП801-Ф |
0061 | ЧекВей77-Ф |
0060 | СП802-Ф |
0059 | СП101-Ф |
0058 | СП402-Ф |
ЗАО «СЧЕТМАШ» | |
0033 | ЭКР 2102К-Ф |
0046 | МИНИКА 1102МК-Ф |
0100 | ФЕЛИКС-РМФ |
0137 | МИНИКА 1105К-Ф |
ОАО «Специальное конструкторское бюро вычислительной техники«ИСКРА» | |
0086 | ПРИМ 06-Ф |
0049 | МК 35-Ф |
0038 | ПРИМ 07-Ф |
0039 | ПРИМ 21-ФА |
0040 | ПРИМ 08-Ф |
0041 | ПРИМ 88-Ф |
ООО «Телемаркет» | |
0159 | АК СМАРТ-01-Ф |
ООО «ТЕРЛИС» | |
0090 | МЁБИУС.NET.H21-Ф |
0094 | ZEBRA-EZ320-Ф |
0095 | МЁБИУС.NET.T18-Ф |
ООО «Тринити» | |
0014 | РИТЕЙЛ-01Ф |
ООО «УЭБ Технолоджи» | |
0096 | АГАТ 1Ф |
0153 | WAB57-FRФ |
ООО «Франс Информатик энд Текнолоджи» | |
0093 | FIT-ONLINE-Ф |
0101 | FIT-NEWLINE-F |
ООО «Фирма ПИЛОТ» | |
0105 | SKY-PRINT 54-F |
0152 | SKY-PRINT Mini-F |
0054 | POSprint FP410-Ф |
0053 | POSprint FP510-Ф |
АО «ШТРИХ-М» | |
0045 | ШТРИХ-МИНИ-02Ф |
0066 | ШТРИХ-МОБАЙЛ-Ф |
0067 | ШТРИХ-ФР-02Ф |
0128 | ШТРИХ-НАНО-Ф |
0129 | ШТРИХ-СМАРТПОС-Ф |
0048 | ШТРИХ-МПЕЙ-Ф |
0016 | ШТРИХ-М-02Ф |
0017 | ШТРИХ-М-01Ф |
0071 | NCR-001Ф |
0010 | ШТРИХ-ФР-01Ф |
0011 | ШТРИХ-МИНИ-01Ф |
0012 | ШТРИХ-ЛАЙТ-01Ф |
0001 | ШТРИХ-ON-LINE |
0026 | ШТРИХ-ЛАЙТ-02Ф |
ООО «ЭВОТОР» | |
0116 | Эвотор СТ5Ф |
0080 | ЭВОТОР СТ3Ф |
0009 | ЭВОТОР СТ2Ф |
ООО «Ярус Лтд» | |
0031 | ЯРУС М2100Ф |
0043 | ЯРУС ТФ |
Пример ответа:
Проверка наличия ФН в реестре
Данный метод используется для проверки наличия ФН (фискального накопителя) в реестре ФНС
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
factory_number | Да | Заводской номер |
model_code | Да | Код модели (см таблицу ниже) |
Таблица кодов моделей ФН
ООО «Дримкас» | |
---|---|
0012 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 6-15-2 |
ООО «ИНВЕНТА» | |
0010 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 4 |
0008 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 5-15-2 |
0016 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 5-15-1 |
0017 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 2 |
АО «КОНЦЕРН «АВТОМАТИКА» | |
0005 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение 3 |
0011 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение Ав15-2 |
0019 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение Ав36-2 |
ООО «НТЦ «Измеритель» | |
0002 | Средство криптографической защиты фискальных данных «ФН-1» исполнение 3 версия 1 |
0007 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1» исполнение Из13-2 |
0014 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение Из15-2 |
ООО «Прагматик» | |
0003 | Средство криптографической защиты фискальных данных «ФН-1» исполнение 3 версия 2 |
0006 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1» исполнение Пр13-2 |
0013 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение Пр15-2 |
ООО «РИК» | |
0001 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель ФН-1 |
0004 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1» исполнение 2 |
ООО «ЭВОТОР» | |
0009 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение Эв15-2 |
0018 | Шифровальное (криптографическое) средство защиты фискальных данных фискальный накопитель «ФН-1.1» исполнение Эв36-2 |
Пример ответа:
Подсказки для поиска ОКВЭД
Данный метод используется для вывода поисковых подсказок по общероссийскому классификатору видов экономической деятельности (ОКВЭД)
Метод запроса: POST
Поиск по описанию кода ОКВЭД
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
text | Да | Текст для поиска по ОКВЭД (минимум 4 символа) |
Пример ответа:
Поиск по номеру кода ОКВЭД
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
code | Да | Код ОКВЭД (строка) |
Пример ответа:
Валидация ИНН
Данный метод используется проверки валидности ИНН
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
inn | Да | Значение для проверки на валидность формату ИНН |
Пример ответа:
Валидация ОГРН
Данный метод используется проверки валидности ОГРН
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
ogrn | Да | Значение для проверки на валидность формату ОГРН |
Пример ответа:
Валидация ОГРНИП
Данный метод используется проверки валидности ОГРНИП
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
ogrnip | Да | Значение для проверки на валидность формату ОГРНИП |
Пример ответа:
Валидация СНИЛС
Данный метод используется проверки валидности СНИЛС
Метод запроса: GET
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
snils | Да | Значение для проверки на валидность формату СНИЛС (только цифры, без дефисов) |
Пример ответа:
API сервисы для Казахстана
Получение РНН по ФИО и ЖСН/ИИН
Данный метод используется для получения РНН физического лица по ФИО + номеру ЖСН/ИИН.
Время ответа на запрос может достигать 15 секунд.
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
first_name | Да | Имя из паспорта |
last_name | Да | Фамилия из паспорта |
father_name | Нет | Отчество из паспорта. Является обязательным, только при наличии отчества в паспорте. |
uin | Да | Персональный номер ЖСН/ИИН |
use_cache | Нет | Флаг использования кеша:1 - пытаться найти данные пользователя в кеше qntsoft0 – не использовать кешЗначение по умолчанию – 1 |
Пример ответа:
API сервисы для Узбекистана
Получение ИНН (СТИР) по серии и номеру паспорта
Данный метод используется для получения ИНН (СТИР) физического лица по серии и номеру паспорта. В качестве дополнительных данных в ответе будет возвращены ФИО лица которому присвоен ИНН, а так же дата и район регистрации.
Время ответа на запрос может достигать 15 секунд.
Метод запроса: POST
Параметр | Обязательный | Описание |
---|---|---|
token | Да | Ваш авторизационный токен |
document_series | Да | Серия паспорта |
document_number | Да | Номер паспорта |
use_cache | Нет | Флаг использования кеша:1 - пытаться найти данные пользователя в кеше qntsoft0 – не использовать кешЗначение по умолчанию – 1 |
Пример ответа:
Последние изменения
Техническая поддержка
По вопросам получения токена для доступа к API обращайтесь на sales@qntsoft.ru
По вопросам технической поддержки обращайтесь на support@qntsoft.ru