Техническое руководство "API FOCUS"

advertisement
API Контур-Фокус
Оглавление
Описание ...................................................................................................................................................... 3
JSON SCHEMA ............................................................................................................................................... 3
Поиск. ....................................................................................................................................................... 3
Данные по ЮЛ ......................................................................................................................................... 3
Данные по ИП .......................................................................................................................................... 3
Данные по лицензиям ............................................................................................................................ 3
Данные по арбитражным делам............................................................................................................ 3
Данные по бухформам ............................................................................................................................ 4
Автодополнение. ........................................................................................................................................ 4
Параметры запроса: ................................................................................................................................ 4
Пример запроса ....................................................................................................................................... 4
Поиск. ........................................................................................................................................................... 4
Параметры запроса: ................................................................................................................................ 5
Поля возвращаемого документа: .......................................................................................................... 5
Пример запроса. ...................................................................................................................................... 5
Получение данных по юридическому лицу ............................................................................................ 6
Параметры запроса: ................................................................................................................................ 7
Поля возвращаемого документа ........................................................................................................... 7
Пример запроса. ....................................................................................................................................12
Получение данных по ИП. .......................................................................................................................14
Параметры запроса: ..............................................................................................................................14
Поля возвращаемого документа .........................................................................................................15
Пример запроса. ....................................................................................................................................16
Список лицензий.......................................................................................................................................17
Параметры запроса: ..............................................................................................................................17
Поля возвращаемого документа: ........................................................................................................18
Пример запроса: ....................................................................................................................................18
Бухформы 1 и 2 .........................................................................................................................................19
Параметры запроса: ..............................................................................................................................19
Поля возвращаемого документа: ........................................................................................................19
Пример запроса: ....................................................................................................................................19
Наблюдение. .............................................................................................................................................20
Ограничения ..........................................................................................................................................20
Указание списка организаций для наблюдения.................................................................................21
Получение списка организаций, за которыми установлено наблюдение .......................................21
Получение новостей по наблюдаемому списку .................................................................................21
Описание
API Фокуса предназначен для поиска юридических лиц и ИП, а так же для получения данных по
ним. API состоит из нескольких программных интерфейсов:
Автодополнение
Подсказки при вводе запроса. Позволяет получить
список строк для дополнения вводимой строки.
Пример. По строке «скб кон» будут выдаваться
строки:
скб контур
скб ком
скб ко
скб карат
скб км
скб каскад
скб кавео
скб камертон
скб континент
скб конкрит
Поиск
Позволяет получить список компаний по указанному
запросу.
Позволяет получить основные реквизиты и данные о
юридическом лице.
Позволяет получить основные реквизиты и данные о
ИП.
Позволяет получить лицензии, которые выдавались
организации
Позволяет получить арбитражные дела организации
Получение данных по
юридическому лицу
Получение данных по ИП
Получение данных лицензий
Получение данных арбитражных
дел
Получение данных бухформ №1 и
№2
Позволяет получить данных бухформ организации
JSON SCHEMA
JSON схема – описание структуры возвращаемого документа. В схемах всегда написаны
актуальный набор возвращаемых данных.
Поиск.
https://focus-api.kontur.ru/api2/search?.kontur.ru/api2/search?schema
Данные по ЮЛ
https://focus-api.kontur.ru/api2/ul?schema
Данные по ИП
https://focus-api.kontur.ru/api2/ip?schema
Данные по лицензиям
https://focus-api.kontur.ru/api2/licences?schema
Данные по арбитражным делам
https://focus-api.kontur.ru/api2/courts?schema
Данные по бухформам
https://focus-api.kontur.ru/api2/buhforms?schema
Автодополнение.
Возвращает список строк, которые могут дополнить вводимое значение (автоподсказка).
Адрес сервиса: https://focus-api.kontur.ru/api2/autocomplete
Используется метод GET.
Параметры запроса:
Параметр Тип данных и пример
key
Base64
q
String
q=«Скб ко»
Описание
Ключ доступа
Строка, которую необходимо дополнить
Возвращаемый документ (HTTP response) представляет собой список строк, в которых указаны
слова для автодополнения.
Пример запроса
Запрос: https://focus-api.kontur.ru/api2/autocomplete?key=key1&q=скб%20ко
Результат:
скб контур
скб ком
скб ко
скб карат
скб км
скб каскад
скб кавео
скб камертон
скб континент
скб конкрит
Поиск.
Позволяет получить список компаний по указанному запросу.
Адрес сервиса: https://focus-api.kontur.ru/api2/search
Используется метод GET.
Параметры запроса:
Параметр
Тип данных и пример
key
q
Описание
Base64
String
q=«Иванов Екатеринбург»
Не обязательные параметры
Ключ доступа
Строка, по которой будет осуществляться
поиск
region
Код региона. Если необходимо
применить фильтр по региону.
Номер возвращаемой страницы (на
одной странице возвращается не более
10 результатов поиска). Если
параметр page отсутствует, то считается,
что page=1. Максимально допустимый
номер страницы - 50
String
region=66
String
page=2
page
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON,
содержащий сниппеты найденных юрлиц или ИП.
Поля возвращаемого документа:
Имя
Тип
Описание
index
string
Порядковый номер результата
shortName
string
Краткое наименование юрлица
longName
string
Полное наименование юрлица
activityText
string
Описание основного вида деятельности
address
string
Юридический адрес юрлица
inn
string
ИНН/ОГРН юрлица
ogrn
string
ИНН/ОГРН юрлица
fio
string
ФИО ИП
statusText
string
Статус юрлица или ИП
Пример запроса.
https://focus-api.kontur.ru/api2/search?key=key1&q=газпром
Ответ.
{
count: 2559,
items:
[
{
type: "UL",
index: "1",
shortName: "ОАО "ГАЗПРОМ"",
longName: "открытое акционерное общество "Газпром"",
activityText: "Оптовая торговля прочим жидким и газообразным топливом",
address: "117997, г Москва, ул Наметкина, 16",
inn: "7736050003",
ogrn: "1027700070518",
statusText: "Действующее"
},
{
type: "UL",
index: "2",
shortName: "ООО "ГАЗПРОМ ПЕРЕРАБОТКА"",
longName: "общество с ограниченной ответственностью "Газпром Переработка"",
activityText: "Производство нефтепродуктов",
address: "628417, Ханты-Мансийский Автономный Округ - Югра ао, г Сургут, ул Островского, 16",
inn: "1102054991",
ogrn: "1071102001651",
statusText: "Действующее"
},
...
{
type: "UL",
index: "9",
shortName: "ООО "ГАЗПРОМ МЕЖРЕГИОНГАЗ"",
longName: "общество с ограниченной ответственностью "Газпром Межрегионгаз"",
activityText: "Оптовая торговля прочим жидким и газообразным топливом",
address: "142770, г Москва, поселение Сосенское, п Газопровод, 103А",
inn: "5003021311",
ogrn: "1025000653930",
statusText: "Действующее"
},
{
type: "UL",
index: "10",
shortName: "ОАО "ГАЗПРОМ-МЕДИА ХОЛДИНГ"",
longName: "открытое акционерное общество "Газпром-Медиа Холдинг"",
activityText: "Консультирование по вопросам коммерческой деятельности и управления",
address: "117647, г Москва, ул Профсоюзная, 125А",
inn: "7728668727",
ogrn: "5087746018960",
statusText: "Действующее"
}
]
}
Получение данных по юридическому лицу
Позволяет получить основные реквизиты и данные о юридическом лице.
Адрес сервиса: https://focus-api.kontur.ru/api2/ul
Используется метод GET.
Параметры запроса:
Параметр
Тип данных и пример
Описание
key
Base64
Ключ доступа
inn*
String
ИНН искомого юр.лица.
inn=6663003127
ogrn*
String
ОГРН искомого юр.лица
ogrn=1026605606620
*В запросе надо указать или inn или orgn
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON,
содержащий список найденных юр.лиц.
Поля возвращаемого документа
(любое из полей может отсутствовать):
Имя
Тип
Описание
shortName
string
Краткое наименование организации
longName
string
Полное наименование организации
inn
string
ИНН
kpp
string
КПП
ogrn
string
ОГРН
okpo
string
ОКПО
regDate
string
Дата образования
liquidationDate
string
Дата ликвидации
statusText
string
Статус в виде неформализованной
строки
Статус в виде структурированной
информации:
statusEx
active bool
Действующее
liquidated bool
Ликвидирован
liquidating bool
В процессе ликвидации
reorganizing bool
address
Юридический адрес:
zip string
regionCode string
regionName string
Индекс
Код региона
Название региона
district string
Район
city string
Город
place string
Населенный пункт
street string
Улица
house string
Дом
bulk string
flat string
date string
houseRegsCount_ESTIMATE integer
flatRegsCount_ESTIMATE integer
mainActivity
Корпус
Офис/квартира/комната
Дата
Примерное количество компаний,
зарегистрированных по тому же
адресу с точностью до номера дома
Примерное количество компаний,
зарегистрированных по тому же
адресу с точностью до номера офиса
Основной вид деятельности:
code string
text string
activities
Код вида деятельности
Название вида деятельности
Список видов деятельности
code string
text string
Код вида деятельности
Название вида деятельности
Лицо, имеющее право подписи без
доверенности (руководитель):
head
fio string
ФИО
Inn string
ИННФЛ
date string
fioMentionsCount_ESTIMATE integer
capital
В процессе реорганизации
Дата внесения записи в ЕГРЮЛ
Примерное количество компаний, где
данное ФИО упоминается в качестве
руководителя или учредителя
Уставный капитал:
sum string
Сумма
date string
Дата внесения записи в ЕГРЮЛ
foundersFL
Список учредителей физ. лиц:
fio string
ФИО
Inn string
ИНН физ.лица
share number Сумма в уставном капитале
sharePercent_ESTIMATE number Доля в процентах
fioMentionsCount_ESTIMATE string
date string
foundersUL
Примерное количество компаний, где
данное ФИО упоминается в качестве
руководителя или учредителя
Дата внесения записи в ЕГРЮЛ
Список учредителей юр лиц:
name string
inn string
Ogrn string
Наименование организации
ИНН
ОГРН
Share number Сумма в уставном капитале
sharePercent_ESTIMATE number Доля в процентах
Date string
foundersForeign
Дата внесения записи в ЕГРЮЛ
Учредители иностранные лица
name string
country string
Наименование организации
Страна
share number Сумма в уставном капитале (в рублях)
sharePercent_ESTIMATE number Доля в процентах
date string
Successors
Дата
Список преемников:
Name string
Inn string
Наименование организации
ИНН
Ogrn string
ОГРН
Date string
Дата внесения записи в ЕГРЮЛ
Predecessors
Список предшественников:
name string
Наименование организации
Inn string
ИНН
Ogrn string
ОГРН
Date string
Дата внесения записи в ЕГРЮЛ
pfrRegNumber
string
Регистрационный номер ПФР
fssRegNumber
string
Регистрационный номер ФСС
fomsRegNumber
string
Регистрационный номер ФОМС
integer
Количество юрлиц, в уставном
капитале которых есть доля текущего
юрлица
foundedULCount_ESTIMATE
courtsCasesStat
Статистика арбитражных дел:
plaintiff
В качестве истца:
count_12month_ESTIMATE integer
Количество дел в качестве истца за
последние 12 месяцев
Общая сумма исковых требований в
качестве истца за последние 12
totalSum_12month_ESTIMATE number месяцев
count_ESTIMATE integer
Количество дел в качестве истца
Общая сумма исковых требований в
totalSum_ESTIMATE number качестве истца
defendant
В качестве ответчика:
count_12month_ESTIMATE integer
Количество дел в качестве ответчика
за последние 12 месяцев
Общая сумма исковых требования в
качестве ответчика за последние 12
totalSum_12month_ESTIMATE number месяцев
count_ESTIMATE integer
Количество дел в качестве ответчика
Общая сумма исковых требования в
totalSum_ESTIMATE number качестве ответчика
govContractsStat
offered
Статистика заключенных
государственных контрактов
Выигранные гос.контракты
count_12month_ESTIMATE integer
Количество заключенных контрактов
по 223, 94 и 44 ФЗ за последние 12
месяцев
Общая сумма заключенных
контрактов по 223, 94 и 44 ФЗ за
totalSum_12month_ESTIMATE number последние 12 месяцев
count_ESTIMATE integer
Количество заключенных контрактов
по 223, 94 и 44 ФЗ
Общая сумма заключенных
totalSum_ESTIMATE number контрактов по 223, 94 и 44 ФЗ
placed
Размещенные гос.контракты
count_12month_ESTIMATE integer
Количество размещенных контрактов
по 223, 94 и 44 ФЗ за последние 12
месяцев
Общая сумма размещенных
контрактов по 223, 94 и 44 ФЗ за
totalSum_12month_ESTIMATE number последние 12 месяцев
count_ESTIMATE integer
Количество размещенных контрактов
по 223, 94 и 44 ФЗ
Общая сумма размещенных
totalSum_ESTIMATE number контрактов по 223, 94 и 44 ФЗ
Статистика упоминаний компании в
интернете
internetMentionsStat
mentionsCount_ESTIMATE integer
Оценка количество сайтов и с
упоминанием текущей компании
Статистика по исполнительным
производствам в отношении
компании
executoryProcessesStat
Count_ESTIMATE integer
Количество незавершенных
исполнительных производств
Общая сумма незавершенных
totalSum_ESTIMATE number исполнительных производств
Статистика по сообщениям о
банкротстве
bankruptcyStat
Count_ESTIMATE integer
Количество найденных сообщений о
банкротстве
latestDate_ESTIMATE number Дата последнего сообщения
tradeMarksStat
Статистика по связанным товарным
знакам
mentionsCount_ESTIMATE integer
Количество товарных знаков,
действующих или недействующих, в
которых упоминается текущая
компания
Статистика по наличию сведений о
бухгалтерской отчетности в
источниках Росстата
financialStatementsStat
latestYear_ESTIMATE string
Последний отчетный год, за который
найдена бухгалтерская отчетность
endRevenue number Выручка на конец года, руб.
startRevenue number Выручка на начало года, руб.
endBalance number Баланс на конец года, руб.
startBalance number Баланс на начало года, руб.
Чистая прибыль (убыток) на конец
endPureProfit number года, руб.
Чистая прибыль (убыток) на начало
startPureProfit number года, руб.
href
string
Ссылка на карточку организации в
Фокусе
Пример запроса.
https://focus-api.kontur.ru/api2/ul?key=key1&ogrn=1026605606620
Ответ.
{
items:
[
{
shortName: "ЗАО "ПФ "СКБ КОНТУР"",
longName: "Закрытое акционерное общество "Производственная Фирма "Скб Контур"",
inn: "6663003127",
kpp: "667301001",
ogrn: "1026605606620",
okpo: "00242766",
regDate: "1992-03-26",
statusText: "Действующее",
statusEx:
{
active: true,
liquidated: false,
liquidating: false,
reorganizing: false
},
address:
{
zip: "620017",
regionCode: "66",
regionName:
{
abbr: "обл",
abbrEx: "область",
value: "Свердловская"
},
city:
{
abbr: "г",
abbrEx: "город",
value: "Екатеринбург"
},
street:
{
abbr: "пр-кт",
abbrEx: "проспект",
value: "Космонавтов"
},
house:
{
abbr: "дом",
abbrEx: "дом",
value: "56"
},
date: "2008-12-19",
houseRegsCount_ESTIMATE: 59,
flatRegsCount_ESTIMATE: 59
},
mainActivity:
{
code: "72.20",
text: "Разработка программного обеспечения и консультирование в этой области"
},
activities:
[
{
code: "72.20",
text: "Разработка программного обеспечения и консультирование в этой области"
},
{
code: "74.14",
text: "Консультирование по вопросам коммерческой деятельности и управления"
},
],
heads:
[
{
fio: "Мраморов Дмитрий Михайлович",
inn: "744800102483",
post: "Генеральный Директор",
date: "2010-02-11",
fioMentionsCount_ESTIMATE: 4
}
],
capital:
{
sum: 5465115,
date: "2008-05-07"
},
pfrRegNumber: "075033001392",
fomsRegNumber: "654019370010182",
foundedULCount_ESTIMATE: 11,
courtsCasesStat:
{
plaintiff:
{
count_12month_ESTIMATE: 4,
totalSum_12month_ESTIMATE: 51561.71,
count_ESTIMATE: 18,
totalSum_ESTIMATE: 10867367.61
},
defendant:
{
count_12month_ESTIMATE: 6,
totalSum_12month_ESTIMATE: 2208668.55,
count_ESTIMATE: 11,
totalSum_ESTIMATE: 2411557.27
}
},
govContractsStat:
{
offered:
{
count_12month_ESTIMATE: 358,
totalSum_12month_ESTIMATE: 42407713.99,
count_ESTIMATE: 848,
totalSum_ESTIMATE: 134698045.09
}
},
internetMentionsStat:
{
mentionsCount_ESTIMATE: 77
},
tradeMarksStat:
{
mentionsCount_ESTIMATE: 28
},
financialStatementsStat:
{
latestYear_ESTIMATE: 2012
},
href: "https://focus.kontur.ru/entity?query=1026605606620"
}
]
}
Получение данных по ИП.
Позволяет получить основные реквизиты и данные о ИП.
Адрес сервиса: https://focus-api.kontur.ru/api2/ip
Используется метод GET.
Параметры запроса:
Параметр
Тип данных и пример
Описание
key
Base64
Ключ доступа
inn*
String
ИНН искомого ИП
inn=744800102483
ogrn*
String
ОГРН ИП
ogrn=304744825300079
*В запросе надо указать или inn или orgn
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON,
содержащий список найденных ИП.
Поля возвращаемого документа
(любое из полей может отсутствовать):
Имя
fio
inn
ogrn
okpo
Тип
string
string
string
string
statusText
string
statusEx
okato
mainActivity:
active bool
liquidated bool
string
code string
text string
activities
code string
text string
nalogReg
pfrRegNumber
fssRegNumber
fomsRegNumber
href
courtsCasesStat
plaintiff
nalogCode string
nalogName string
regDate string
string
string
string
string
Count_12month_ESTIMATE string
totalSum_12month_ESTIMATE string
Описание
ФИО
ИНН
ОГРН
ОКПО
Статус в виде неформализованной
строки
Статус в виде структурированной
информации:
Действующий
Прекратил деятельность
ОКАТО
Основной вид деятельности:
Код вида деятельности
Название вида деятельности
Список видов деятельности:
Код вида деятельности
Название вида деятельности
Сведения о постановке на учет в
налоговом органе
Код налогового органа
Наименование налогового органа
Дата постановки на учет
Регистрационный номер ПФР
Регистрационный номер ФСС
Регистрационный номер ФОМС
Ссылка на карточку организации в
Фокусе
Статистика арбитражных дел:
В качестве истца:
Количество дел в качестве истца за
последние 12 месяцев
Общая сумма исковых требований в
качестве истца за последние 12
месяцев
count_ESTIMATE string Количество дел в качестве истца
Общая сумма исковых требований в
TotalSum_ESTIMATE string качестве истца
defendant
В качестве ответчика:
Количество дел в качестве ответчика за
Count_12month_ESTIMATE string последние 12 месяцев
Общая сумма исковых требования в
качестве ответчика за последние 12
totalSum_12month_ESTIMATE string месяцев
count_ESTIMATE string Количество дел в качестве ответчика
Общая сумма исковых требования в
TotalSum_ESTIMATE string качестве ответчика
Статистика заключенных
govContractsStat
государственных контрактов:
Количество заключенных контрактов
по 223, 94 и 44 ФЗ за последние 12
Count_12month_ESTIMATE string месяцев
Общая сумма заключенных контрактов
по 223, 94 и 44 ФЗ за последние 12
totalSum_12month_ESTIMATE string месяцев
Количество заключенных контрактов
count_ESTIMATE string по 223, 94 и 44 ФЗ
Общая сумма заключенных контрактов
totalSum_ESTIMATE string по 223, 94 и 44 ФЗ
Статистика упоминаний ИП в
internetMentionsStat:
интернете:
Оценка количество сайтов и с
mentionsCount_ESTIMATE string упоминанием текущей компании
Пример запроса.
https://focus-api.kontur.ru/api2/ip?key=key1&ogrn=304390608400256
Ответ.
{
items:
[
{
fio: "Лосик Ляна Николаевна",
inn: "390606595707",
ogrn: "304390608400256",
okpo: "0110197372",
statusText: "Действующее",
statusEx:
{
active: true,
liquidated: false
},
okato: "27401368000",
address:
{
regionCode: "39",
regionName:
{
abbr: "обл",
abbrEx: "область",
value: "Калининградская"
},
city:
{
abbr: "г",
abbrEx: "город",
value: "Калининград"
}
},
mainActivity:
{
code: "51.42",
text: "Оптовая торговля одеждой, включая нательное белье, и обувью"
},
activities:
[
{
code: "51.42",
text: "Оптовая торговля одеждой, включая нательное белье, и обувью"
},
{
code: "52.43.1",
text: "Розничная торговля обувью"
}
],
pfrRegNumber: "049003032635",
courtsCasesStat:
{
defendant:
{
count_ESTIMATE: 1,
totalSum_ESTIMATE: 0
}
},
href: https://focus.kontur.ru/entity?query=304390608400256
}
]
}
Список лицензий.
Используется для получения списка выданных лицензий.
Адрес сервиса: https://focus-api.kontur.ru/api2/licences
Используется метод GET.
Параметры запроса:
Параметр Тип данных и пример
key
Base64
ogrn
String
Описание
Ключ доступа
ОГРН юр.лица
ogrn=1026605606620
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON,
содержащий список найденных лицензий.
Поля возвращаемого документа:
Имя
officialNum
issuerName
Тип
string
string
date
String
dateStart
String
dateEnd
String
statusDescription
activity
services
addresses
string
string
string
string
Описание
Номер лицензии (если известен)
Название органа, выдавшего лицензию (если
известен)
Дата лицензии (если известна) - чаще всего
совпадает с датой начала действия лицензии
(шаблон: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$)
Дата начала действия лицензии (если известна)
(шаблон: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$)
Дата окончания действия лицензии (если известна)
(шаблон: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$)
Строковое описание статуса (если известно)
Описание вида деятельности
Описание видов работ/услуг
Места действия лицензии (массив
неформализованных строк)
Пример запроса:
https://focusapi.kontur.ru/api2/licences?key=8daae76fe35d7c59ecf7145a9bd98a3bf8f2a926&ogrn=1026605606620
Пример ответа:
[
{
officialNum: "№ 84876",
dateStart: "2011-03-29",
dateEnd: "2016-03-29",
activity: "Телематические услуги связи"
},
{
officialNum: "№ 76894",
dateStart: "2010-10-05",
dateEnd: "2015-10-05",
activity: "Телематические услуги связи"
},
{
officialNum: "84876 1",
date: "2011-03-29",
dateStart: "2011-03-29",
dateEnd: "2016-03-29",
services:
[
"Телематические услуги связи"
],
addresses:
[
"Москва",
"Московская область"
]
}
]
Бухформы 1 и 2
Используется для получения сведений бухгалтерской отчетности по формам №1 и №2.
Адрес сервиса: https://focus-api.kontur.ru/api2/buhforms
Используется метод GET.
Параметры запроса:
Параметр Тип данных и пример
key
Base64
ogrn
String
Описание
Ключ доступа
ОГРН юр.лица
ogrn=1026605606620
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON,
содержащий список бухформ за найденные года.
Поля возвращаемого документа:
Имя
items
year
organizationType
form1
code
name
startValue
endValue
form2
code
name
startValue
endValue
Тип
array
integer
string
array
integer
string
integer
integer
array
integer
string
integer
integer
Описание
Список бухформ
Год
Тип организации, который определяет набор
показателей в формах. Принимает значения:
 SONO – соц.ориентированная
некоммерческая орг.
 Small – малое предприятие
 Large – крупное предприятие
Форма 1
Код строки
Название строки
Значение на начало периода
Значение на конец периода
Форма 2
Код строки
Название строки
Значение на начало периода
Значение на конец периода
Пример запроса:
https://focusapi.kontur.ru/api2/buhforms?key=8daae76fe35d7c59ecf7145a9bd98a3bf8f2a926&ogrn=103773987729
5
Пример ответа:
[
{
year: 2005,
organizationType: "Large",
form1:
[
{
code: 110,
name: "Нематериальные активы",
startValue: 60846000,
endValue: 193080000
},
...
{
code: 970,
name: "Износ жилищного фонда",
startValue: 276544000,
endValue: 302976000
}
],
form2: []
},
...
{
year: 2013,
organizationType: "Large",
form1:
[
{
code: 1100,
name: "Итого",
startValue: 4053226000000,
endValue: 4319575000000
},
...
{
code: 1340,
name: "Переоценка внеоборотных активов",
startValue: 1251387000000,
endValue: 1248068000000
},
],
form2: []
}
]
Наблюдение.
Для постоянного отслеживания изменений в сведениях по юридическим лицам и
предпринимателям можно поставить их на наблюдение, а впоследствии получать список тех, по
которым произошли изменения за определенный день. Это позволит сократить объем запросов,
передаваемых на сервер.
Ограничения
Данные методы работают только для тарифов, которые предусматривают ограничение на
максимальное количество контрагентов (ИНН/ОГРН) и не предусматривают ограничение на
количество запросов к серверу. При этом максимальное количество наблюдаемых организаций
совпадает с максимальным количеством ИНН/ОГРН, предусмотренным тарифом, но не более 100
тысяч ИНН/ОГРН. Например, если на тарифе предусмотрено ограничение в 20 тысяч ИНН/ОГРН
контрагентов, то максимальное количество организаций, которое можно поставить на
наблюдение будет таким же - 20 тысяч.
Указание списка организаций для наблюдения
URL
https://focus-api.kontur.ru/api2/monList
Метод
POST
Параметры
запроса
key - ключ доступа
Тело запроса
Список ИНН/ОГРН, которые будут поставлены на наблюдение. Рекомендуемый
формат - список, разделенный переводами строк.
Ответ сервера
Список всех ИНН/ОГРН, которые успешно поставились на наблюдение.
https://focus-api.kontur.ru/api2/monList/schema
Получение списка организаций, за которыми установлено наблюдение
URL
https://focus-api.kontur.ru/api2/monList
Метод
GET
Параметры
запроса
key - ключ доступа
Тело запроса
Пустое.
Ответ сервера
Список всех ИНН/ОГРН, которые в настоящий момент поставлены на
наблюдение. Ответ соответствует схеме:
https://focus-api.kontur.ru/api2/monList/schema
Получение новостей по наблюдаемому списку
URL
https://focus-api.kontur.ru/api2/monListNews
Метод
GET
Параметры
запроса
key - ключ доступа
Тело запроса
Пустое.
date - дата, за которую необходимо предоставить новости в формате ГГГГ-ММДД
Ответ сервера
Список ОГРН организаций, для которых за указанную дату происходили
изменения в Контур.Фокусе.
Формат ответа соответствует схеме: https://focusapi.kontur.ru/api2/monListNews/schema
Download