Выписка по организации из ЕГРЮЛ/ЕГРИП

F.0286.EXT.ACT

Позволяет получить сведения о юридическом лице или индивидуальном предпринимателе в виде выписки из ЕГРЮЛ/ЕГРИП.

Источник данных — ФНС России.

Идентификаторы объекта: ИНН, ОГРН или ОГРНИП контрагента.

Иcпользуемые источники: xfirm/fns_egrul_egrip_report_file.

Время генерации отчёта:

  • 50-й перцентиль — 5 с.;
  • 95-й перцентиль — 15 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип запроса.
Фиксированное значение: MULTIPART
query string Обязательный Значение простого запроса.
Фиксированное значение:  
data object Обязательный Идентификаторы объекта поиска
Параметры объекта data
inn string Обязательный,
если не указан ОГРН или ОГРНИП		 ИНН юридического или физического лица
ogrn string Обязательный,
если не указан ИНН или ОГРНИП		 ОГРН
ogrnip string Обязательный,
если не указан ИНН или ОГРН		 ОГРНИП

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

Если запрос содержит несколько идентификаторов, то для поиска будет использоваться один из них, выбираемый по следующим правилам:

Заполненные идентификаторы Используемый идентификатор
ИНН ЮЛ + ОГРН ИНН ЮЛ
ИНН ЮЛ + ОГРН + ОГРНИП ИНН ЮЛ
ОГРН + ОГРНИП ОГРН
ИНН ФЛ + ОГРН ИНН ФЛ
ИНН ФЛ + ОГРН + ОГРНИП ОГРНИП
ИНН ФЛ + ОГРНИП ОГРНИП

Пример тела запроса по ИНН юрлица

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "inn": "1234567890"
  }
}

Пример тела запроса по ОГРН

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "ogrn": "1234567890123"
  }
}

Пример тела запроса по ОГРНИП

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "ogrnip": "123456789012345"
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.xfirm.fns_egrul_egrip_report_file тела ответа.

Поле Тип Описание
report.fnsReportUrl string Ссылка на файл выписки на сервере ФНС.
Ссылка имеет ограниченный срок действия
report.s3ReportUrl string Ссылка на файл выписки на сервере SD.
Срок действия ссылки не ограничен

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "F.0286.EXT.ACT_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "xfirm/fns_egrul_egrip_report_file",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "xfirm": {
          "fns_egrul_egrip_report_file": {
            "report": {
              "fnsReportUrl": "https://egrul.nalog.ru/vyp-download/7436C761",
              "s3ReportUrl": "https://s3.spectrumdata.tech/xfirm/REPORT/2023/29.11.2023/970/ip-11-20.pdf"
            }
          }
        }
      }
    }
  ]
}