Page tree
Skip to end of metadata
Go to start of metadata

Ищет организацию по ИНН либо ОГРН.

Доступен только через API (jQuery-плагин не поддерживается).

При наличии у организации филиалов поиск может вернуть несколько объектов. В таких случаях можно ограничить поиск по типу огранизации – type, типу филиала – branch_type, либо КПП – kpp. А начиная с версии подсказок 19.8 список организаций сортируется по типу филиала – сначала головная организация, затем филиалы.

Поиск выполняется по точному совпадению идентификатора, не по вхождению. Если в ЕГРЮЛ есть компания с ИНН 7725002343 и ИП с ИНН 772500234318, то findById по 7725002343 вернет только компанию.

Запрос

Для пользователей подсказок DaData.ru:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "7719402047" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party

Для пользователей standalone-подсказок:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "7719402047" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/party

Заголовки

ЗаголовокОписание
Content-Type

Тип данных в запросе: application/json или application/xml

Accept
Тип данных в ответе: application/json или application/xml
Authorization

API-ключ в формате: Token ВАШ_КЛЮЧ

Только для пользователей подсказок DaData.ru

Параметры

ПараметрОбязательный?Описание
queryдаИНН или ОГРН
branch_typeнетТип филиала (MAIN, BRANCH)
kppнетКПП организации (начиная с версии подсказок 19.4)
typeнетТип организации

Ответ

Возвращает объект организации, который соответствует указанному коду:

 Показать

ПолеОписание
valueНаименование организации одной строкой (как показывается в списке подсказок)
unrestricted_valueНаименование компании одной строкой (полное)

data.address

Адрес
└ value

— адрес одной строкой:

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

стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ

└ unrestricted_value

— адрес одной строкой (полный, от региона)
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ

└ data

гранулярный адрес

└ data.source

— исходный адрес одной строкой как в ЕГРЮЛ

└ data.qc

— код качества адреса (начиная с версии 19.1)

  • 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

disqualified

Руководитель

— ФИО руководителя

— должность руководителя

— true, если в состав руководства входят дисквалифицированные лица (начиная с версии 19.7)

data.name

└ full

└ full_with_opf

└ latin

└ short

└ short_with_opf

Наименование

— полное наименование

— полное наименование с ОПФ

— наименование на латинице (не заполняется)

— краткое наименование

— краткое наименование с ОПФ

data.okpoКод ОКПО (не заполняется)

data.finance

└ tax_system

└ income

└ expense

└ debt

└ penalty

Финансовая информация (начиная с версии 19.7)

— Система налогообложения организации

— доходы по данным бухгалтерской отчетности за позапрошлый год

расходы по данным бухгалтерской отчетности за позапрошлый год

задолженность по налоговым платежам за позапрошлый год

— наложенные штрафы за позапрошлый год

data.okvedКод ОКВЭД
data.okved_type

Версия справочника ОКВЭД (2001 или 2014)

data.opf

└ code

└ full

└ short

└ type

Организационно-правовая форма

— код ОКОПФ

— полное название ОПФ

— краткое название ОПФ

— версия справочника ОКОПФ

data.state

└ actuality_date

└ registration_date

└ liquidation_date

└ status

Состояние

— дата актуальности сведений

— дата регистрации

— дата ликвидации

— статус организации

  • ACTIVE — действующая
  • LIQUIDATING — ликвидируется
  • LIQUIDATED — ликвидирована
  • REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией
data.type

Тип организации

  • LEGAL — юридическое лицо
  • INDIVIDUAL — индивидуальный предприниматель
data.employee_countКоличество сотрудников (начиная с версии 19.7)
Дополнительные поля, заполняются в зависимости от тарифа «Дадаты» *
Заполняются при выборе конкретной подсказки в jQuery плагине или через метод API  findById . До этого они пустые.
Тарифы «Расширенный» и «Всё включено»

data.okveds[ ]

└ main

└ type

└ code

└ name

Коды ОКВЭД дополнительных видов деятельности

— основной или нет (true / false)

— версия справочника ОКВЭД (2001 или 2014)

— код по справочнику

— наименование по справочнику

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.managers[ ]

└ ogrn

└ inn

└ name

└ fio

└ post

└ hid

└ type


Руководители компании

— ОГРН руководителя (для юрлиц)

— ИНН руководителя

— наименование руководителя (для юрлиц)

— ФИО руководителя (для физлиц)

— должность руководителя (для физлиц)

— внутренний идентификатор

— тип руководителя

    • EMPLOYEE — сотрудник
    • FOREIGNER — иностранный гражданин
    • LEGAL — юрлицо

data.capital

└ type

└ value

Уставной капитал компании

— тип капитала

— размер капитала


Документы

data.documents.fts_registration

└ type

└ series

└ number

└ issue_date

└ issue_authority

Свидетельство о регистрации в налоговой

— тип документа (= FTS_REGISTRATION)

— серия документа

— номер документа

— дата выдачи

— код подразделения

data.documents.pf_registration

Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration

data.documents.sif_registration

Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration

data.documents.smb

└ type

└ category

└ issue_date

Запись в реестре малого и среднего предпринимательства (19.6+)

— тип документа (= SMB)

категория (MICRO, SMALL, MEDIUM)

дата включения организации в реестр

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

* Для «коробки» возвращаются все дополнительные поля.

Формат даты

Даты регистрации и ликвидации — количество миллисекунд от 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