Официальные данные (ИНН)
Примечание
Источник — ЕГРЮЛ/ЕГРИП через DaData.ru. Метод доступен только на российском контуре (do.freshoffice.ru); на do.workzeal.com вернёт ошибку.
Карточка по ИНН или ОГРН
GET https://do.freshoffice.ru/company/lookup?inn=7736207543
Возвращает официальные сведения о компании или ИП: наименование, коды, юридический адрес, статус, руководителя. Ничего в CRM не записывает — полученные данные передаются в добавление контрагента (блок Paymentdetails) или в реквизиты существующего.
Query Parameters
| Name | Type | Description |
|---|---|---|
| inn | String | ИНН (10 или 12 цифр) или ОГРН. Обязателен, если не передан name |
Поиск по названию
GET https://do.freshoffice.ru/company/lookup?name=Ромашка&count=5
Возвращает список кандидатов с ИНН и адресом — чтобы выбрать нужную компанию и запросить её карточку по ИНН.
Query Parameters
| Name | Type | Description |
|---|---|---|
| name | String | Название или его часть. Обязателен, если не передан inn |
| count | Int | Сколько кандидатов вернуть (по умолчанию 5, максимум 20) |
Поля ответа
| Имя | Описание |
|---|---|
| name | Краткое наименование с формой собственности, например ООО "Ромашка" |
| full_name | Полное наименование |
| opf | Форма собственности (ООО, ИП, АО...) |
| type | LEGAL — юридическое лицо, INDIVIDUAL — ИП |
| inn, kpp, ogrn, ogrn_date | Коды и дата ОГРН |
| status | ACTIVE — действующая, LIQUIDATING, LIQUIDATED, BANKRUPT, REORGANIZING |
| registration_date, liquidation_date | Даты регистрации и ликвидации |
| address, postal_code, region, city | Юридический адрес и его части |
| okved | Основной ОКВЭД |
| okpo, oktmo, okato | Коды статистики (только в карточке по ИНН) |
| branch_type, branch_count | Головная организация или филиал, число филиалов |
| director, director_post | Руководитель и должность |
| emails, phones, sites | Контакты из реестров |
| employee_count | Среднесписочная численность |
Пустые поля в ответ не попадают. Руководитель, контакты, численность и сайты выдаются в зависимости от тарифа DaData — на базовом тарифе их нет.
Пример
curl --location --request GET 'https://do.freshoffice.ru/company/lookup?inn=7736207543' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX'
Ответ
{
"status": "success",
"error": "",
"code": null,
"rows": 0,
"pages": 0,
"page": 0,
"value": "{ \"name\": \"ООО \\\"ЯНДЕКС\\\"\", \"inn\": \"7736207543\", \"kpp\": \"770401001\", \"ogrn\": \"1027700229193\", \"status\": \"ACTIVE\", \"address\": \"г Москва, ул Льва Толстого, д 16\", ... }"
}
// value - JSON-объект карточки (по ИНН) или JSON-массив кандидатов (по названию)
// status "Error" - компания не найдена или метод недоступен в этом регионе