- Created by Сергей Константинов, last modified by Антон Жиянов on 19 Jan 2023
Находит компанию или индивидуального предпринимателя по ИНН, КПП, ОГРН. Возвращает реквизиты компании, учредителей, руководителей, сведения о налоговой, ПФР и ФСС, финансы, лицензии, реестр МСП и другую информацию о компании.
Запрос
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "query": "7719402047" }' \ http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/party
Заголовки
Заголовок | Описание |
---|---|
| Тип данных в запросе: |
| Тип данных в ответе: application/json или application/xml |
| API-ключ в формате: Только для пользователей подсказок DaData.ru |
Параметры
Параметр | Обязательный? | Описание |
---|---|---|
query | да | ИНН или ОГРН |
branch_type | нет | Тип филиала (MAIN, BRANCH) |
kpp | нет | КПП организации 19.4+ |
| нет | Ограничение по статусу организации |
type | нет | Тип организации |
count | нет | Количество возвращаемых подсказок (по умолчанию — 10, максимум — 300) 21.1+ |
Ответ
Возвращает объект организации, который соответствует указанному коду:
Поле | Тип данных | Описание |
---|---|---|
value | string(1000) | Краткое наименование организации (data.name.short_with_opf ). Если краткое наименование не указано — полное наименование (data.name.full_with_opf ) |
unrestricted_value | string(1000) | = value |
data.address | Адрес | |
└ value | string(1000) | — адрес одной строкой:
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ |
└ unrestricted_value | string(1000) | — адрес одной строкой (полный, от региона) |
└ data | ||
└ data.source | string(1000) | — исходный адрес одной строкой как в ЕГРЮЛ |
└ data.qc | string(10) | — код качества адреса (19.1+)
|
data.branch_count | unsignedShort | Количество филиалов |
data.branch_type | string(50) | Тип подразделения
|
data.fio └ surname └ name └ patronymic └ gender └ source └ qc | string(100) string(100) string(100) | Имя ИП ( 21.3+) — фамилия — имя — отчество не заполняется не заполняется не заполняется |
data.inn | string(20) | ИНН |
data.kpp | string(10) | КПП |
data.kpp_largest | string(10) | не заполняется |
data.ogrn | string(20) | ОГРН (13 цифр) Для представительств иностранных компаний — номер записи об аккредитации (НЗА, 11 цифр) в РАФП. |
data.ogrn_date | long | Дата выдачи ОГРН |
data.hid | string(100) | Внутренний идентификатор |
data.management └ name └ post └ disqualified └ start_date | string(200) string(500) boolean long | Руководитель — ФИО руководителя — должность руководителя — true, если в состав руководства входят дисквалифицированные лица (19.7+) — дата вступления в должность (24.9+) |
data.name └ full_with_opf └ short_with_opf └ full
└ latin | string(1000) string(1000) string(1000) string(1000) | Наименование — полное наименование — краткое наименование — полное наименование без ОПФ — краткое наименование без ОПФ — не заполняется |
data.okato | string(20) | Код ОКАТО (20.9+) |
data.oktmo | string(20) | Код ОКТМО (20.9+) |
data.okpo | string(10) | Код ОКПО |
data.okogu | string(10) | Код ОКОГУ (20.9+) |
data.okfs | string(10) | Код ОКФС (20.9+) |
data.okved | string(10) | Код ОКВЭД |
data.okved_type | string(10) | Версия справочника ОКВЭД (2001 или 2014) |
data.opf └ code └ full └ short └ type | string(10) string(1000) string(1000) string(10) | Организационно-правовая форма — код ОКОПФ — полное название ОПФ — краткое название ОПФ — версия справочника ОКОПФ |
data.state └ actuality_date └ registration_date └ liquidation_date └ code └ status | long long long string(10) string(50) | Состояние — дата актуальности сведений — дата регистрации — дата ликвидации — детальный статус (c декабря 2020) — статус организации ACTIVE действующая LIQUIDATING ликвидируется LIQUIDATED ликвидирована REORGANIZING в процессе присоединения к другому юрлицу, с последующей ликвидацией BANKRUPT банкрот (с февраля 2021) |
data.type | string(50) | Тип организации LEGAL юридическое лицо INDIVIDUAL индивидуальный предприниматель |
data.employee_count | int | Количество сотрудников (19.7+) |
Дополнительные поля, заполняются в зависимости от тарифа «Дадаты» * | ||
Заполняются при выборе конкретной подсказки в jQuery плагине или через метод API findById . До этого они пустые. | ||
Тарифы «Расширенный» и «Максимальный» | ||
data.okveds[ ] └ main └ type └ code └ name | boolean string(10) string(10) string(1000) | Коды ОКВЭД дополнительных видов деятельности — основной или нет (true / false) — версия справочника ОКВЭД (2001 или 2014) — код по справочнику — наименование по справочнику |
data.authorities | Сведения о налоговой, ПФР и ФСС | |
data.authorities.fts_registration └ type └ code └ name └ address | string(50) string(20) string(500) string(500) | ИФНС регистрации — код гос. органа — код отделения — наименование отделения — адрес отделения одной строкой |
data.authorities.fts_report | ИФНС отчётности, структура аналогична fts_registration | |
data.authorities.pf | Отделение Пенсионного фонда, структура аналогична fts_registration | |
data.authorities.sif | Отделение Фонда соц. страхования, структура аналогична fts_registration | |
data.citizenship └ code.numeric └ code.alpha_3 └ name.full └ name.short | unsignedShort string(10) string(1000) string(1000) | Гражданство ИП — числовой код страны по ОКСМ — трехбуквенный код страны по ОКСМ — полное наименование страны — краткое наименование страны |
Тариф «Максимальный» | ||
data.address.invalidity | object | — недостоверность сведений об адресе |
data.founders[ ] └ ogrn └ inn └ name └ fio └ hid └ type └ invalidity └ start_date | string(20) string(20) string(1000) object string(100) string(50) object long | Учредители компании — ОГРН учредителя (для юрлиц) — ИНН учредителя — наименование учредителя (для юрлиц) — ФИО учредителя (для физлиц) — внутренний идентификатор — тип учредителя (LEGAL / PHYSICAL) — недостоверность сведений об учредителе — дата вступления в должность (24.9+) |
data.founders[ ].share └ type └ value └ numerator └ denominator | string(50) decimal long long | Доля учредителя (справочники от 05.06.2020 и новее): — тип значения (PERCENT / DECIMAL / FRACTION) — значение (для type = PERCENT и type = DECIMAL) — числитель дроби (для type = FRACTION) — знаменатель дроби (для type = FRACTION) типы: PERCENT процент (46) DECIMAL десятичная дробь (3.14) FRACTION обычная дробь (3/4) |
data.managers[ ] └ ogrn └ inn └ name └ fio └ post └ hid └ type └ invalidity └ start_date | string(20) string(20) string(1000) object string(500) string(100) string(50) object long | Руководители компании — ОГРН руководителя (для юрлиц) — ИНН руководителя — наименование руководителя (для юрлиц) — ФИО руководителя (для физлиц) — должность руководителя (для физлиц) — внутренний идентификатор — тип руководителя — недостоверность сведений о руководителе — дата вступления в должность (24.9+) типы: EMPLOYEE сотрудник LEGAL юрлицо |
data.predecessors[] └ ogrn └ inn └ name | string(20) string(20) string(1000) | Правопредшественники, только для юрлиц (20.10+) — ОГРН предшественника — ИНН предшественники — наименование предшественника |
data.successors[] └ ogrn └ inn └ name | string(20) string(20) string(1000) | Правопреемники, только для юрлиц (20.10+) — ОГРН преемника — ИНН преемника — наименование преемника |
data.capital └ type └ value | string(50) decimal | Уставной капитал компании — тип капитала — размер капитала |
data.finance └ tax_system └ income └ expense └ revenue └ year └ debt └ penalty | string(50) decimal decimal decimal int decimal decimal | Финансовая информация (19.7+) — система налогообложения организации — доходы по данным бухгалтерской отчетности — расходы по данным бухгалтерской отчетности — выручка по данным бухгалтерской отчетности (23.8+) — год бухгалтерской отчестности (21.3+) — задолженность по налоговым платежам за позапрошлый год — наложенные штрафы за позапрошлый год |
Документы | ||
data.documents.fts_registration └ type └ series └ number └ issue_date └ issue_authority | string(50) string(20) string(20) long string(500) | Свидетельство о регистрации в налоговой — тип документа (= FTS_REGISTRATION) — серия документа — номер документа — дата выдачи — код подразделения |
data.documents.fts_report | Сведения об учете в налоговом органе, структура аналогична fts_registration (21.7+) | |
data.documents.pf_registration | Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration | |
data.documents.sif_registration | Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration | |
data.documents.smb └ type └ category └ series └ number └ issue_date └ issue_authority | string(50) string(50) string(20) string(20) long string(500) | Запись в реестре малого и среднего предпринимательства — тип документа (= SMB) — категория (MICRO, SMALL, MEDIUM) не заполняется не заполняется — дата включения организации в реестр не заполняется категории: MICRO микро-предприятие SMALL малое предприятие MEDIUM среднее предприятие |
data.licenses[ ] └ series └ number └ issue_date └ issue_authority └ suspend_date └ suspend_authority └ valid_from └ valid_to └ activities[ ] └ addresses[ ] | string(100) string(100) long string(1000) long string(1000) long long string[](1000) string[](1000) | Лицензии — серия документа — номер документа — дата выдачи — название выдавшего органа — дата приостановки — название приостановившего органа — дата начала действия — дата окончания действия — перечень лицензируемых видов деятельности — перечень адресов, по которым действует лицензия |
data.phones[ ] └ value └ unrestricted_value | string(1000) string(1000) | Телефоны — телефон одной строкой — телефон одной строкой |
data.phones[ ]. data.contact └ type └ name | string(50) string(1000) | Контактное лицо — тип — имя типы: MANAGING_PARTY управляющая организация TRUSTED_EMPLOYEE сотрудник TRUSTED_FOREIGNER иностранный гражданин |
data.phones[ ]. data └ source └ type └ number └ extension └ provider └ country └ region └ city └ timezone └ country_code └ city_code └ qc_conflict └ qc | string(250) string(50) string(10) string(10) string(100) string(50) string(100) string(100) string(50) string(10) string(10) | Гранулярные поля телефона — телефон, указанный в ЕГРЮЛ — тип телефона — локальный номер телефона — добавочный номер — оператор связи (только для России) — страна — регион (только для России) — город (только для стационарных телефонов) — часовой пояс города (Россия), страны (прочие страны) — код страны — код города не заполняется не заполняется типы телефонов: Мобильный +7 911 243-45-68 Стационарный +7 495 456-55-77 Прямой мобильный +7 495 243-45-68 Колл-центр 8 800 222-12-22 Неизвестный +7 333 1111112 |
data.emails[ ] └ value └ unrestricted_value | string(1000) string(1000) | Адреса эл. почты — адрес эл. почты одной строкой — адрес эл. почты одной строкой |
data.emails[ ].data └ local └ domain └ source └ type └ qc | string(100) string(100) string(250) | Гранулярные поля эл. почты — именная часть — доменная часть — адрес эл. почты , указанный в ЕГРЮЛ не заполняется не заполняется |
data.invalid | boolean | Недостоверность сведений о компании |
Не используются | ||
data.source | ||
data.qc |
* Для «коробки» возвращаются все дополнительные поля.
Система налогообложения
Код | Описание |
---|---|
ESHN | единый сельскохозяйственный налог (ЕСХН) |
SRP | система налогообложения при выполнении соглашений о разделе продукции (СРП) |
USN | упрощенная система налогообложения (УСН) |
AUSN | автоматизированная упрощенная система налогообложения (АУСН) |
Доходы и расходы
Показатели рассчитываются по «Отчету о финансовых результатах» (форма по ОКУД 0710002):
- Доходы = сумма по кодам 2110, 2310, 2320, 2340
- Расходы = сумма по кодам 2120, 2210, 2220, 2330, 2350
Доходы:
2110 Выручка 2310 Доходы от участия в других организациях 2320 Проценты к получению 2340 Прочие доходы
Расходы:
2120 Себестоимость продаж 2210 Коммерческие расходы 2220 Управленческие расходы 2330 Проценты к уплате 2350 Прочие расходы
Доходы и расходы заполнены примерно у 60% действующих компаний (такая полнота данных в налоговой).
Недостоверные сведения об организации
Налоговая может признать сведения об учредителе, руководителе или адресе организации недостоверными. Тогда в ответе будут заполнены соответствующие поля:
data.founders[ ].invalidity data.managers[ ].invalidity data.address[ ].invalidity
Поле invalidity
— это объект с такими свойствами:
Поле | Тип данных | Описание |
---|---|---|
code | string(50) | код причины недостоверности PARTY — обращение лица или организации FTS — проверка налоговой COURT — решение суда OTHER — прочие причины |
decision └ court_name └ number └ date | object string(100) string(255) long | решение суда (только для code = COURT) — наименование суда — номер судебного решения — дата судебного решения |
Если хотя бы один учредитель, руководитель или адрес организации признан недостоверным, для организации в целом вернется маркер data.invalid = true
. Если недостоверных данных нет — будет data.invalid = null
.
Формат даты
Даты регистрации и ликвидации — количество миллисекунд от 01.01.1970. Хранится в UTC.
Для JavaScript преобразуется в дату так:
var ticks = 989784000000; var date = new Date(ticks);
Для PHP:
$ticks = 989784000000; $sec = $ticks / 1000; echo date("d.m.Y", $sec);
Для Java:
long ticks = 989784000000; Calendar cal = Calendar.getInstance(); cal.setTimeInMillis(ticks);
Для C#:
long ticks = 989784000000; DateTime date = (new DateTime(1970, 1, 1)).AddMilliseconds(ticks);
Примеры
Запрос по ИНН
{ "query": "7725002343" }
Запрос по ОГРН
{ "query": "1027739468877" }
{ "suggestions": [ { "value": "ООО \"СТЕКЛОКОН\"", "unrestricted_value": "ООО \"СТЕКЛОКОН\"", "data": { "kpp": "772501001", "capital": null, "management": { "name": "Овсепян Хачатур Меликович", "post": "Директор" }, "branch_type": "MAIN", "branch_count": 0, "source": null, "qc": null, "hid": "85db648b39e183fc974a9c5711475cf4ace02101bb28695fb7b55d7c25c5c6eb", "type": "LEGAL", "state": { "status": "ACTIVE", "actuality_date": 1488326400000, "registration_date": 728179200000, "liquidation_date": null }, "opf": { "type": null, "code": "12300", "full": "Общество с ограниченной ответственностью", "short": "ООО" }, "name": { "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"СТЕКЛОКОН\"", "short_with_opf": "ООО \"СТЕКЛОКОН\"", "latin": null, "full": "СТЕКЛОКОН", "short": "СТЕКЛОКОН" }, "inn": "7725002343", "ogrn": "1027739468877", "okpo": null, "okved": null, "okveds": null, "authorities": null, "documents": null, "licenses": null, "address": { "value": "г Москва, Даниловская наб, д 2 к 4", "unrestricted_value": "г Москва, Даниловский р-н, Даниловская наб, д 2 к 4", "data": { "postal_code": "115114", "country": "Россия", "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "region_kladr_id": "7700000000000", "region_with_type": "г Москва", "region_type": "г", "region_type_full": "город", "region": "Москва", "area_fias_id": null, "area_kladr_id": null, "area_with_type": null, "area_type": null, "area_type_full": null, "area": null, "city_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "city_kladr_id": "7700000000000", "city_with_type": "г Москва", "city_type": "г", "city_type_full": "город", "city": "Москва", "city_area": "Южный", "city_district_fias_id": null, "city_district_kladr_id": null, "city_district_with_type": "Даниловский р-н", "city_district_type": "р-н", "city_district_type_full": "район", "city_district": "Даниловский", "settlement_fias_id": null, "settlement_kladr_id": null, "settlement_with_type": null, "settlement_type": null, "settlement_type_full": null, "settlement": null, "street_fias_id": "fb4d2fdd-0b4a-4e8d-b8cd-e7a28cfd5798", "street_kladr_id": "77000000000115400", "street_with_type": "Даниловская наб", "street_type": "наб", "street_type_full": "набережная", "street": "Даниловская", "house_fias_id": "cb4d5826-4621-4eca-b60b-5957eaf6c9aa", "house_kladr_id": "7700000000011540004", "house_type": "д", "house_type_full": "дом", "house": "2", "block_type": "к", "block_type_full": "корпус", "block": "4", "flat_type": null, "flat_type_full": null, "flat": null, "flat_area": null, "square_meter_price": "177863", "flat_price": null, "postal_box": null, "fias_id": "cb4d5826-4621-4eca-b60b-5957eaf6c9aa", "fias_level": "8", "kladr_id": "7700000000011540004", "capital_marker": "0", "okato": "45296559000", "oktmo": "45914000", "tax_office": "7725", "tax_office_legal": null, "timezone": "UTC+3", "geo_lat": "55.7083638", "geo_lon": "37.6421572", "beltway_hit": "IN_MKAD", "beltway_distance": null, "qc_geo": "0", "qc_complete": "5", "qc_house": "2", "history_values": null, "unparsed_parts": null, "source": "114115 ГОРОД МОСКВА, НАБЕРЕЖНАЯ ДАНИЛОВСКАЯ, дом 2 корп 4", "qc": "0" } }, "phones": null, "emails": null, "ogrn_date": 1035763200000, "okved_type": null } } ] }
- No labels