Организация по ИНН или ОГРН
Находит компанию или ИП по ИНН или ОГРН. Возвращает все доступные сведения о компании, в отличие от метода suggest, который возвращает только базовые поля.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Пример запроса:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "7707083893" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party
Или:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "1027700132195" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party
Головные организации и филиалы
Если у компании есть филиалы, запрос вернёт несколько объектов. Если нужна только головная организация, укажите дополнительный параметр branch_type
:
{ "query": "7707083893", "branch_type": "MAIN" }
Чтобы найти конкретный филиал, укажите дополнительный параметр kpp
:
{ "query": "7707083893", "kpp": "540602001" }
К сожалению, для 50% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы с помощью данного метода найти не получится.
Юрлица и индивидуальные предприниматели
Чтобы искать только среди юрлиц, либо только среди индивидуальных предпринимателей, укажите параметр type
:
# Юрлица { "query": "7707083893", "type": "LEGAL" } # Индивидуальные предприниматели { "query": "784806113663", "type": "INDIVIDUAL" }
Что в ответе
Пример ответа
{ "suggestions": [ { "value": "ООО \"МОТОРИКА\"", "unrestricted_value": "ООО \"МОТОРИКА\"", "data": { "kpp": "402701001", "capital": { "type": "УСТАВНЫЙ КАПИТАЛ", "value": 12000 }, "management": { "name": "Алексеев Денис Сергеевич", "post": "ДИРЕКТОР", "disqualified": null }, "founders": [ { "inn": "402708415215", "fio": { "surname": "Алексеев", "name": "Денис", "patronymic": "Сергеевич", "gender": "MALE", "source": "АЛЕКСЕЕВ ДЕНИС СЕРГЕЕВИЧ", "qc": null }, "hid": "e803b2ab9d94c7cc9b5d6a881ec811c25697cd00c220ca31d197ae0a855a5e79", "type": "PHYSICAL", "share": null } ], "managers": [ { "inn": "402708415215", "fio": { "surname": "Алексеев", "name": "Денис", "patronymic": "Сергеевич", "gender": "MALE", "source": "АЛЕКСЕЕВ ДЕНИС СЕРГЕЕВИЧ", "qc": null }, "post": "ДИРЕКТОР", "hid": "6a82d08f1a055dbf026d664cf9db243392ed207d6ccc15345d7c3c52d7a8192e", "type": "EMPLOYEE" } ], "branch_type": "MAIN", "branch_count": 0, "source": null, "qc": null, "hid": "938542c99ff6853be22eee49e9344f3bf102dae0dd2e6dae17772b7048f8f5fa", "type": "LEGAL", "state": { "status": "ACTIVE", "actuality_date": 1559692800000, "registration_date": 1334880000000, "liquidation_date": null }, "opf": { "type": "2014", "code": "12300", "full": "Общество с ограниченной ответственностью", "short": "ООО" }, "name": { "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"МОТОРИКА\"", "short_with_opf": "ООО \"МОТОРИКА\"", "latin": null, "full": "МОТОРИКА", "short": "МОТОРИКА" }, "inn": "4028051108", "ogrn": "1124028002273", "okpo": null, "okved": "45.3", "okveds": [ { "main": true, "type": "2014", "code": "45.3", "name": "Торговля автомобильными деталями, узлами и принадлежностями" }, ... ], "authorities": { "fts_registration": { "type": "FEDERAL_TAX_SERVICE", "code": "4027", "name": "Инспекция Федеральной налоговой службы по Ленинскому округу г. Калуги", "address": "248600,г Калуга,пер Воскресенский,28,,,,,," }, "fts_report": { "type": "FEDERAL_TAX_SERVICE", "code": "4027", "name": "Инспекция Федеральной налоговой службы по Ленинскому округу г. Калуги", "address": null }, "pf": { "type": "PENSION_FUND", "code": "050025", "name": "Управление Пенсионного фонда Российской Федерации по г.Калуга", "address": null }, "sif": { "type": "SOCIAL_INSURANCE_FUND", "code": "4000", "name": "Государственное учреждение - Калужское региональное отделение Фонда социального страхования Российской Федерации", "address": null } }, "documents": { "fts_registration": { "type": "FTS_REGISTRATION", "series": "40", "number": "001280927", "issue_date": 1334880000000, "issue_authority": "4028" }, "pf_registration": { "type": "PF_REGISTRATION", "series": null, "number": "050025062068", "issue_date": 1342569600000, "issue_authority": "050025" }, "sif_registration": { "type": "SIF_REGISTRATION", "series": null, "number": "400049189240001", "issue_date": 1342569600000, "issue_authority": "4000" }, "smb": { "category": "MICRO", "type": "SMB", "series": null, "number": null, "issue_date": 1469998800000, "issue_authority": null } }, "licenses": null, "finance": { "tax_system": "USN", "income": 0, "expense": 0, "debt": 12400, "penalty": null }, "address": { "value": "г Калуга, ул Вишневского, д 17, кв 55", "unrestricted_value": "248007, Калужская обл, г Калуга, ул Вишневского, д 17, кв 55", "data": { ... } }, "phones": null, "emails": null, "ogrn_date": 1334880000000, "okved_type": "2014", "employee_count": 0 } } ] }
Название | Описание | |
---|---|---|
Базовые поля, заполняются для всех тарифов | ||
value | Наименование компании | |
unrestricted_value | = value | |
data.address | Адрес | |
└ value | — адрес одной строкой:
|
|
└ unrestricted_value | — адрес одной строкой (полный, с индексом) стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ. |
|
└ data | — гранулярный адрес | |
└ data.source | — адрес одной строкой как в ЕГРЮЛ | |
└ data.qc | — код проверки адреса
0 — адрес распознан уверенно 1 или 3 — требуется ручная проверка |
|
data.branch_count | Количество филиалов | |
data.branch_type | Тип подразделения
MAIN — головная организация BRANCH — филиал |
|
data.inn | ИНН | |
data.kpp | КПП | |
data.ogrn | ОГРН | |
data.ogrn_date | Дата выдачи ОГРН | |
data.hid | Уникальный идентификатор в Дадате | |
data.management | Руководитель | |
└ name | — ФИО руководителя | |
└ post | — должность руководителя | |
data.name | Наименование | |
└ full_with_opf | — полное наименование с ОПФ | |
└ short_with_opf | — краткое наименование с ОПФ | |
└ latin | — наименование на латинице (не заполняется) | |
└ full | — полное наименование | |
└ short | — краткое наименование | |
data.okpo | Код ОКПО (не заполняется) | |
data.okved | Код ОКВЭД | |
data.okved_type | Версия справочника ОКВЭД (2001 или 2014) | |
data.opf | Организационно-правовая форма | |
└ code | — код ОКОПФ | |
└ full | — полное название ОПФ | |
└ short | — краткое название ОПФ | |
└ type | — версия справочника ОКОПФ (99, 2012 или 2014) | |
data.state | Состояние | |
└ actuality_date | — дата актуальности сведений | |
└ registration_date | — дата регистрации | |
└ liquidation_date | — дата ликвидации | |
└ status | — статус организации
ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией |
|
data.type | Тип организации
LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель |
|
Дополнительные поля, заполняются в зависимости от тарифа Заполняются при выборе конкретной подсказки. До этого они пустые. |
||
Тарифы «Расширенный» и «Всё включено» | ||
data.employee_count | Среднесписочная численность работников | |
data.finance.tax_system | Система налогообложения
ENVD — единый налог на вмененный доход (ЕНВД) ESHN — единый сельскохозяйственный налог (ЕСХН) SRP — система налогообложения при выполнении соглашений о разделе продукции (СРП) USN — упрощенная система налогообложения (УСН) ENVD_ESHN — ЕНВД + ЕСХН USN_ENVD — УСН + ЕНВД |
|
data.okved | Код ОКВЭД | |
data.okveds[ ] | Коды ОКВЭД дополнительных видов деятельности | |
└ main | — основной или нет (true / false) | |
└ type | — версия справочника ОКВЭД (2001 или 2014) | |
└ code | — код по справочнику | |
└ name | — наименование по справочнику | |
data.authorities | Сведения о налоговой, ПФР и ФСС | |
data.authorities.fts_registration | ИФНС регистрации | |
└ type | — код гос. органа | |
└ code | — код отделения | |
└ name | — наименование отделения | |
└ address | — адрес отделения одной строкой | |
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 | — краткое наименование страны | |
Только «Всё включено» | ||
data.founders[ ] | Учредители компании | |
└ ogrn | — ОГРН учредителя (для юрлиц) | |
└ inn | — ИНН учредителя | |
└ name | — наименование учредителя (для юрлиц) | |
└ fio | — ФИО учредителя (для физлиц) | |
└ hid | — внутренний идентификатор | |
└ type | — тип учредителя (LEGAL / PHYSICAL) | |
data.management.disqualified | Наличие дисквалифицированных лиц в руководстве компании.
Возвращает true при наличии, иначе null . |
|
data.managers[ ] | Руководители компании | |
└ ogrn | — ОГРН руководителя (для юрлиц) | |
└ inn | — ИНН руководителя | |
└ name | — наименование руководителя (для юрлиц) | |
└ fio | — ФИО руководителя (для физлиц) | |
└ post | — должность руководителя (для физлиц) | |
└ hid | — внутренний идентификатор | |
└ type | — тип руководителя
EMPLOYEE — сотрудник FOREIGNER — иностранный гражданин LEGAL — юрлицо |
|
data.capital | Уставной капитал компании | |
└ type | — тип капитала | |
└ value | — размер капитала | |
data.finance | Финансовые показатели за год | |
└ income | — доходы по бух. отчетности | |
└ expense | — расходы по бух. отчетности | |
└ debt | — недоимки по налогам | |
└ penalty | — налоговые штрафы | |
data.documents | Документы | |
data.documents.fts_registration | Свидетельство о регистрации в налоговой | |
└ type | — тип документа (= FTS_REGISTRATION) | |
└ series | — серия документа | |
└ number | — номер документа | |
└ issue_date | — дата выдачи | |
└ issue_authority | — код подразделения | |
data.documents.pf_registration | Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration | |
data.documents.sif_registration | Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration | |
data.documents.smb | Запись в реестре малого и среднего предпринимательства | |
└ type | — тип документа (= SMB) | |
└ category | — категория предприятия (MICRO, SMALL или MEDIUM) | |
└ issue_date | — дата регистрации в реестре | |
data.licenses[ ] | Лицензии | |
└ series | — серия документа | |
└ number | — номер документа | |
└ issue_date | — дата выдачи | |
└ issue_authority | — название выдавшего органа | |
└ suspend_date | — дата приостановки | |
└ suspend_authority | — название приостановившего органа | |
└ valid_from | — дата начала действия | |
└ valid_to | — дата окончания действия | |
└ activities[ ] | — перечень лицензируемых видов деятельности | |
└ addresses[ ] | — перечень адресов, по которым действует лицензия | |
Не используются | ||
data.founders[ ].share | ||
data.phones[ ] | ||
data.emails[ ] | ||
data.source | ||
data.qc |
Источники данных:
- ЕГРЮЛ и ЕГРИП Налоговой службы
- Реестр филиалов иностранных юрлиц
- Сведения ЕГРН об иностранных организациях
- Реестр субъектов малого и среднего предпринимательства
- Сведения о среднесписочной численности работников организации
- Сведения о специальных налоговых режимах
- Сведения о доходах и расходах по данным бухгалтерской отчетности
- Сведения о суммах недоимки и задолженности
- Сведения о налоговых правонарушениях
- Юрлица, в состав исполнительных органов которых входят дисквалифицированные лица
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.