Kontur Focus REST API Python library

Библиотека-обертка для взаимодействия с REST API Контур.Фокус.

Бибилиотека использует методы REST API Контур.Фокус.

Установка

в разработке

Параметры подключения

from kontur_focus import Focus

ul = Focus(inn='7842393933')  # Инициализация класса, необходимо указать ИНН компании
print(ul.base_info())  # Запрос основной информации из ЕГРЮЛ

Методы

base_info() Получение основной информации о компании

Описание

Метод для работы с реквизитами Российских юридических лиц и индивидуальными предпринимателями. С помощью метода можно просто и быстро обновлять реквизиты деловых партнеров. API предоставляет актуальную и историческую информацию из баз данных ФНС России – ЕГРЮЛ и ЕГРИП, а также часть данных из источников ГМЦ Росстата.

Пример ответа

[{
  "inn": "7842393933",
  "ogrn": "1089847357126",
  "focusHref": "https://focus.kontur.ru/entity?query=1089847357126",
  "UL": {
    "kpp": "781001001",
    "okpo": "87419394",
    "okato": "40284000000",
    "okfs": "34",
    "oktmo": "40373000000",
    "okogu": "4210011",
    "okopf": "12300",
    "opf": "Общества с ограниченной ответственностью",
    "legalName": {
      "short": "ООО Селектел",
      "full": "Общество с ограниченной ответственностью Сеть дата-центров Селектел",
      "readable": "ООО Сеть дата-центров Селектел",
      "date": "2008-09-11"
    },...

---

advanced_info() Получение расширенной информации о компании

Описание

Метод для работы с расширенными реквизитами. С помощью метода можно просто и быстро обновлять реквизиты деловых партнеров. API предоставляет актуальную и историческую информацию из баз данных ФНС России – ЕГРЮЛ и ЕГРИП, а также часть данных из источников ГМЦ Росстата.

Пример ответа

[{
  "inn": "7842393933",
  "ogrn": "1089847357126",
  "focusHref": "https://focus.kontur.ru/entity?query=1089847357126",
  "UL": {
    "kpp": "781001001",
    "okpo": "87419394",
    "okato": "40284000000",
    "okfs": "34",
    "oktmo": "40373000000",
    "okogu": "4210011",
    "okopf": "12300",
    "opf": "Общества с ограниченной ответственностью",
    "legalName": {
      "short": "ООО Селектел",
      "full": "Общество с ограниченной ответственностью Сеть дата-центров Селектел",
      "readable": "ООО Сеть дата-центров Селектел",
      "date": "2008-09-11"
    },...

---

founders_history() История владения организацией

Описание

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

Датой включения в состав участников считается официальная дата внесения сведений в ЕГРЮЛ. А датой исключения — наиболее ранняя дата из выписки, в которой вышедший участник больше не упоминается. Периоды, которые закончились более 5 лет назад не возвращаются.

Пример ответа

[
  {
    "ogrn":"1089847357126",
    "inn":"7842393933",
    "focusHref":"https://focus.kontur.ru/entity?query=1089847357126",
    "companyHistory":[
      {
        "startDate":"2018-03-29",
        "endDate":"2024-02-06",
        "statedCapital":123185400
      },
      {
        "startDate":"2024-02-06",
        "statedCapital":128318125
      }
    ],
    "foundersHistory":[
      {
        "info":{
          "name":"Компания с ограниченной ответственностью Лвл1 Менеджмент ЛТД",
          "country":"ОАЭ"
        },
        "periods":[
          {
            "startDate":"2023-08-08",
            "endDate":"2023-12-15"
          },...

---

foreign_representatives() Иностранные представительства и филиалы

Описание

Метод для работы с реквизитами иностранных представительств и филиалов России.

Адрес иностранных представительств в источнике (РАФП) может быть указан в одном из адресных форматов - КЛАДР или ФИАС. В ответе метода юридический адрес в формате, в котором указан в источнике.

---

full_analytics() Расширенная аналитика

Описание

Проверяйте организации по заданному набору критериев. Метод получения расширенной аналитики позволяет построить индивидуальную автоматизированную систему оценки контрагентов (скоринга), а также обогатить дополнительными критериями. Разнообразие применяемых критериев обеспечивает быстрый старт без необходимости повторять то, что уже реализовано в системе Контур.Фокус.

Устанавливайте свои собственные маркеры проверки — банкротство, особые реестры ФНС, смена руководителя и т.д., и сервис оповестит о появлении значимых для вас рисковых факторов.

---

government_lists() Список реестров РФ

Описание

Список официальных реестров РФ с идентификаторами для использования в других методах.

Пример ответа

[
    {
        "name": "illicit_reward",
        "uid": "53a2d6b8-2ca3-41a6-b3c2-f942d58b35fd",
        "description": "Участники закупок, привлечённые к административной ответственности по ст. 19.28 КоАП РФ"
    },
    {
        "name": "banks",
        "uid": "7c1c310a-9c26-4e08-80f5-8b7611f28460",
        "description": "Перечень кредитных организаций"
    },
    {
        "name": "insurance_business",
        "uid": "c18dd28d-0028-4bad-b73c-c15de023d843",
        "description": "Страховые компании"
    },
    {
        "name": "foreign_agents",
        "uid": "fcfc856d-89f8-408b-afef-56750cb90fed",
        "description": "Иностранные агенты"
    },...

---

check_if_in_lists(list_name: str = None) Наличие организации в реестрах при проверке контрагентов

Описание

Проверяйте наличие организации в реестрах при проверке контрагентов.

Параметры

Name	Required	Type	Description
list_name	false	string(255)	Имя списка из метода government_lists()

Если list_name не указан, отдаются все списки с указанием наличия или отсутствия в них организации.

Пример ответа

[
  {
    "inn": "7842393933",
    "ogrn": "1089847357126", 
    "focusHref": "https://focus.kontur.ru/entity?query=1089847357126", 
    "listsEntries": 
      [
        {
          "id": "d764d2a2-b33b-446f-b60e-be517698864d",
          "name": "Стратегические предприятия и стратегические АО", 
          "isInList": "false", 
          "lastUpdateDate": "2024-04-09"
        },...

Если в list_name указано имя списка, отдается только начилие или отсутствие в списке.

Пример ответа

false