Техподдержка

Звоните
8 800 500-14-77
Круглосуточно
Заказать обратный звонок
Пишите
Онлайн-консультант Написать письмо

Работа в сервисе

  • Как определить количество истраченных запросов?

    Чтобы определить количество истраченных по ключу запросов, существует специальный метод stat.

    Параметр Значение
    URL https://focus-api.kontur.ru/api3/stat
    Метод Get
    Параметры запроса Key — ключ доступа
    XML — получить ответ в формате xml
    Схема ответа json-схема, xsd-схема
    Пример запроса https://focus-api.kontur.ru/api3/stat?key=***

    Отправьте запрос, и в ответ сервер API пришлет массив данных по количеству истраченных запросов по каждому методу, подключенному к ключу.

    Пример

    «methodName»:"api3/req","periodStartDate":"2017-11-22","periodEndDate":"2019-01-01","limitType":"LegalEntities","limit":7000,"spent":5127

    Посмотреть, что значит то или иное поле, можно в схеме для json или XML.

    Особенности подсчета запросов:

    • Запросы по каждому методу считаются индивидуально. Если вы истратили лимит запросов по одному из методов, это никак не повлияет на работоспособность других методов.
    • Большинство методов имеют тип лимита LegalEntities или Persons. Это значит, что подсчет идет по уникальным запросам. Количество уникальных запросов равно количеству уникальных ОГРН/ИННФЛ, по которым вы запрашивали данные с начала действия ключа. Даже если лимит был превышен, вы можете продолжать делать запросы и получать ответы по тем лицам, по которым уже делали запросы ранее. Количество повторных запросов к одному и тому же лицу не лимитируется.
    • Методы с типом лимита Requests учитывают все запросы: уникальные и повторные. Такой тип лимита имеет метод search, который используется для поиска контрагента по «поисковой строке», а также «безлимитные» методы: fizBankr, checkPassport, selectionByRegDate и pepSearch. «Безлимитные» методы имеют только технические ограничения:
      • 100 000 — по умолчанию (лимит можно сбросить по запросу в техподдержку);
      • 999 999 999 — если метод будет ограничен по ip-адресам.
    • Метод по наблюдению (mon) не лимитируется.
  • Какие методы позволяют поставить юрлицо или ИП на наблюдение?

    Для постоянного отслеживания изменений в сведениях по юридическим лицам и предпринимателям в API Контур.Фокуса создано семейство методов mon:

    • Метод для постановки на наблюдение:
    • Методы для получения информации о результатах наблюдения:

    Для всех методов по получению изменений используется одинаковая Json-схема.

  • Как указать список юрлиц или ИП для наблюдения?

    Чтобы подключить мониторинг, нужно отправить на сервер список ИНН/ОГРН, по которым вы хотите получать изменения. Разделители между ИНН/ОГРН могут быть любые, но мы рекомендуем использовать перевод строк. Список помещается в POST-запрос monList. В ответ от сервера придет список всех ИНН и ОГРН, которые были успешно поставлены на наблюдение.

    Параметр Значение
    URL https://focus-api.kontur.ru/api3/monList
    Метод POST
    Параметры запроса Key — ключ доступа 
    Тело запроса Список ИНН или ОГРН, которые будут поставлены на наблюдение. Рекомендуемый формат — список, разделенный переводами строк
    Ответ сервера Список всех ИНН и ОГРН, которые успешно поставились на наблюдение
  • Как отредактировать, перезаписать и очистить список организаций для наблюдения?

    По умолчанию каждый POST-запрос monList перезаписывает список ИНН/ОГРН на сервере списком из запроса.

    Если нужно не перезаписать список на сервере, а добавить к уже существующему списку список ИНН/ОГРН из запроса, то укажите в запросе дополнительный параметр append=true.

    Пример запроса: https://focus-api.kontur.ru/api3/monList?key=***&append= true

    Для очистки списка ИНН/ОГРН на сервере достаточно послать пустой POST-запрос monList.

  • Как получить список организаций, за которыми установлено наблюдение?

    Если вы хотите уточнить список, по которому на текущий момент ведется наблюдение, то нужно отправить пустой GET-запрос monList.

    Параметр Значение
    URL https://focus-api.kontur.ru/api3/monList
    Метод Get
    Параметры запроса Key — ключ доступа
    Ответ сервера Список всех ИНН и ОГРН, которые в настоящий момент поставлены на наблюдение

    Пустой POST-запрос безвозвратно удалит список наблюдаемых организаций.

  • Как получать новости по наблюдаемому списку организаций?

    Чтобы получить сведения по произошедшим изменениям, нужно отправить запрос согласно указанным ниже параметрам.

    Параметр Значение
    URL

    https://focus-api.kontur.ru/api3/req/mon

    https://focus-api.kontur.ru/api3/egrDetails/mon

    Метод Get
    Параметры запроса

    Key — ключ доступа;

    date — дата, за которую необходимо предоставить новости в формате ГГГГ-ММ-ДД

    Ответ сервера ОГРН

    В ответ сервер вернет список ОГРН, по которым в указанную дату произошли изменения. Далее требуется отправить запросы по полученным ОГРН требуемыми информационными методами (req, egrDetails), чтобы получить актуальную информацию. Сравнив актуальные данные и информацию, которая хранится на сервере на текущий момент, можно выявить произошедшие изменения.

    Особенности работы методов наблюдения:

    • На данный момент req/mon и egrDetails/mon следят за одними и теми же фактами. Делать два запроса по этим методам нет необходимости.
    • Методы созданы для наблюдения за недавними фактами. Методы работают с датами не больше 50 дней назад.
    • Сам API не сообщает информацию, что именно изменилось.
  • За какими фактами юрлиц и ИП можно наблюдать?

    Юрлица:

    • КПП
    • Краткое наименование
    • Полное наименование
    • Статус
    • Адрес
    • Уставной капитал
    • Руководители ФЛ — следим за появлением новых, за исчезновением текущих
    • Учредители:
      • Физлица — следим за появлением новых, за исчезновением текущих и за изменениями по текущим: имя
      • Юрлица — следим за появлением новых, за исчезновением текущих и за изменениями по текущим: полное наименование, доля
      • Иностранные компании — следим за появлением новых, за исчезновением текущих и за изменениями по текущим: доля, страна

    ИП:

    • ФИО
    • Адрес
    • Статус
  • Как осуществляется наблюдение?

    Стандартный сценарий наблюдения:

    1. Однократная выгрузка данных по списку ИНН/ОГРН по методам req и/или egrDetails.
    2. Постановка организаций на наблюдение через метод monList.
    3. Ежедневно высылается запрос по методу req/mon или egrDetails/mon с указанием вчерашней даты. Не рекомендуем посылать запросы ранее 05:00 по МСК.
    4. Если в ответ пришел список ОГРН, то по ним актуализируется информация через методы req и/или egrDetails. При необходимости сравниваются актуальные и старые данные, чтобы выявить произошедшие изменения.
  • 200 OK

    Запрос успешно обработан. Если пришел пустой ответ, то это значит что, по запросу абонента нам нечего сказать. Например: абонент указал ИНН несуществующей организации.

  • 400 error inn/ogrn param is not specified или 400 error Invalid 'innfl' parameter value ***

    ИНН, ИННФЛ или ОГРН указаны не по формату:

    • не соблюдена длина поля. ИНН 10 или 12 цифр. ОГРН — 13 цифр.
    • кроме цифр есть буквы или другие спецсимволы.
    • указан ИНН и/или ОГРН состоящий из нулей.
  • 403 error No valid key specified

    В запросе указан неверно ключ или нет доступа к используемому методу.

  • 400 error No more than 100 ogrns/inns can be requested at one time

    В запросе превышено максимальное возможное количество ИНН или ОГРН. Указать можно не больше 100.

  • 403 error Requests limit *** exceeded

    Истек лимит по используемому методу.

  • 403 error Requests limit per day exceeded

    Достигнут дневной лимит запросов. Дневной лимит равен троекратному лимиту ключа. Например: если ключ куплен на 3000 организаций, то дневной лимит — 9 000 запросов. Максимальное количество запросов в день — 500 000.

  • 403 error Key expired on 16.04.2017 00:00. Now 26.10.2017 11:15

    Истек срок действия ключа.

  • Server error #***

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

Вы всё ещё думаете? Просто попробуйте.