###Клиент для Python3
https://pypi.org/project/sabyvok/
###Демо-стенд
Демо-стенд доступен без авторизации. Дальше к адресной строке добавляется метод и параметры запроса.
https://api.sbis.ru/vok-demo/
https://sbis.ru/contragents_api_demo - интерфейс для демо стенда
Для демо-версии доступны ИНН:
7605016030 — Тензор
7736050003 — Газпром
7707049388 — Ростелеком
7814593627 — Бодрус
7827004484 — Концерн ТИТАН-2
071514088779 — Мигиров Альберт Гариевич, ИП
6382082839 — Межрайонная ИФНС России № 23 по Самарской Области
7708503727 — РЖД
7709464710 — Эталонинвест
В демо-версии не доступны методы отдающие файлы
###Получение данных
Авторизация
Подробно об авторизации - https://sbis.ru/help/integration/api/auth. Интересующие пункты: "Добавить приложение" и "Настроить сервисную авторизацию".
Запрос
Общение с API происходит по url: https://api.sbis.ru/vok/. Дальше к адресной строке добавляется метод, например получение реквизитов (req) - https://api.sbis.ru/vok/req. В конце добавляются параметры запроса, например вот таким запросом можно получить данные о компании Газпром - https://api.sbis.ru/vok/req?inn=7736050003. Метод http запроса и параметры запроса описаны для каждого метода в отдельном README. Во все запросы нужно подавать headers как указано в статье об авторизации. При отсутствии лицензии на API ВОК в ответе на запрос будет возвращаться код http ошибки - 403
Массовые запросы
Массовыми являются все методы, исключая методы отдающие файлы, поисковые методы и методы событий. Статистика по запросам клиента также не массовая.
Количество реквизитов ограничено 20 значениями.
Единовременно можно подавать только 1 тип реквизитов - ИНН или ОГРН.
Количество дневных запросов будет вычисляться из количества поданных в массвый запрос реквизитов (ИНН, ОГРН).
КПП дополняет только реквизит ИНН.
Если подаётся пара ИНН + КПП они должны идти до одиночных ИНН в списках реквизитов.
Формат ответа для всех массовых методов начинается так
{
"type": "array",
"items": [
{
...
}
]
}Пример запроса:
https://api.sbis.ru/vok-demo/req?inn=7605016030&inn=7736050003
Методы
req - основные реквизиты контрагента подробное описание
logo, registration-information - логотип и регистрационные данные контрагента подробное описание
tenders, tenders-info, customers, rivals - данные о торгах подробное описание
owners, affiliate, dirs-history, founders-history - данные о лицах связанных с контрагентом подробное описание
subscriptions/(events, contractors, subscribe, unsubscribe) - данные о событиях, подписка на них подробное описание
pdf/(business-report, due-diligence-report, financial-report, signed-excerpt), xml/(egrul-excerpt, reporting-excerpt) - подробное описание
finance, cost-business, reliability, reliability/blocks, market-position, creditworthiness - данные об аналитике
statistic-courts, courts, executive-lists - данные о судах контрагента подробное описание
bankruptcy, bankruptcy/file - данные о банкротстве контрагента
fea - статистика о внешнеэкономической деятельности контрагента подробное описание
license/(stat, data) - лицензии и сертификаты контрагента подробное описание
sro, sro/file - присутствие контрагента в СРО подробное описание
inspections/(stat, data) - проверки контрагента подробное описание
vacancies/(stat, data) - вакансии контрагента подробное описание
trademarks, trademarks/image - товарные знаки контрагента подробное описание
contractor-history - История изменений контрагента подробное описание
contacts-official - Контактные данные контрагента подробное описание
excerpts/(list, last, file) - Выписки контрагента подробное описание
search - Поисковые методы подробное описание
branches - Филиалы контрагента подробное описание
client/stat - Статистика запросов клиента подробное описание
pledges, pledges/file - Залог/Лизинг подробное описание
vehicle, vehicle/stat - Автотранспорт подробное описание
events, events/file - События контаргента подробное описание
