API: поиск аффилированных компаний

Часто учредитель или директор не ограничивается участием в одном юрлице, а фигурирует в нескольких. Порой — в десятках разных компаний. Знать об этом полезно как для оценки надёжности контрагента, так и для более эффективного маркетинга и продаж. Чтобы облегчить поиск аффилированных компаний, «Дадата» находит организации по ИНН учредителей и руководителей.

Ищет по ИНН физлиц и юрлиц.

Как вызвать

Чтобы вызвать метод, и подтвердите почту.

В параметре query укажите ИНН учредителя или руководителя компании:

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findAffiliated/party
            
            
                
                    { "query": "7736207543" }

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

// https://github.com/hflabs/dadata-csharp

var token = "${API_KEY}";
var api = new SuggestClientAsync(token);
var response = await api.FindAffiliated("7736207543");
var party = response.suggestions[0].data;

var url = "http://suggestions.dadata.ru/suggestions/api/4_1/rs/findAffiliated/party";
var token = "${API_KEY}"; 
var query = "7736207543";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token 
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));

// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new \Dadata\DadataClient($token, null);
$result = $dadata->findAffiliated("7736207543");

# https://github.com/hflabs/dadata-py

from dadata import Dadata
token = "${API_KEY}"
dadata = Dadata(token)
result = dadata.find_affiliated("7736207543")

Укажите при вызове:

Content-Type: application/json.
Accept: application/json.
${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

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

Название	Тип	Обяз.?	По умолч.	Описание
query	string	✓		Текст запроса
count	number		10	Количество результатов (максимум — 20)
scope	array [string]		FOUNDERS, MANAGERS	Где искать — среди учредителей (`FOUNDERS`), руководителей (`MANAGERS`), или и тех, и других (по умолчанию). См. примеры

Ограничение области поиска

По умолчанию метод ищет как среди учредителей, так и среди руководителей. Если требуется искать только среди учредителей, укажите scope = FOUNDERS:

{
    "query": "7736207543",
    "scope": ["FOUNDERS"]
}

Аналогично — если требуется искать только среди руководителей:

{
    "query": "7736207543",
    "scope": ["MANAGERS"]
}

Что в ответе

Объект с массивом организаций в поле suggestions:

{
    "suggestions": [
        {
            "value": "ООО \"ДЗЕН.ПЛАТФОРМА\"",
            "unrestricted_value": "ООО \"ДЗЕН.ПЛАТФОРМА\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЕДАДИЛ\"",
            "unrestricted_value": "ООО \"ЕДАДИЛ\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЗНАНИЕ\"",
            "unrestricted_value": "ООО \"ЗНАНИЕ\"",
            "data": { ... }
        },
        {
            "value": "ООО \"НАПА\"",
            "unrestricted_value": "ООО \"НАПА\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЯНДЕКС.ДРАЙВ\"",
            "unrestricted_value": "ООО \"ЯНДЕКС.ДРАЙВ\"",
            "data": { ... }
        }
    ]
}

По каждой организации возвращается ограниченный набор полей:

Название	Описание
value	Наименование компании
unrestricted_value	= value

data.inn	ИНН
data.kpp	КПП
data.ogrn	ОГРН
data.hid	Внутренний идентификатор в Дадате
data.type	Тип организации LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель

	Коды статистики (только для действующих организаций и ИП):
data.okato	Код ОКАТО
data.oktmo	Код ОКТМО
data.okpo	Код ОКПО
data.okogu	Код ОКОГУ
data.okfs	Код ОКФС

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

data.branch_count	Количество филиалов
data.branch_type	Тип подразделения MAIN — головная организация BRANCH — филиал

data.address.value	Aдрес одной строкой: адрес организации для юридических лиц; город проживания для индивидуальных предпринимателей. стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.

data.state	Состояние
└ actuality_date	— дата последних изменений
└ registration_date	— дата регистрации
└ liquidation_date	— дата ликвидации
└ status	— статус организации ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована BANKRUPT — банкротство REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией
└ code	— детальный статус

data.invalid	Признак недостоверных сведений об организации (true/null)

Чтобы получить все поля, выберите конкретную компанию из ответа и вызовите метод Организация по ИНН.

Примеры вызова

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

Входит в состав годовой подписки на тарифе «Максимальный». На остальных тарифах недоступен.