# DaData Connector
name: dadata_connector
version: 19.0.2025.12.03
author: MK.Lab


### 1. Общее описание

Модуль подключает сервис DaData к карточкам контрагентов Odoo. При вводе Tax ID в поле появляется кнопка поиска — нажав её, пользователь получает данные об организации из реестра и может автоматически заполнить всю карточку: название, адрес, КПП, ОКВЭД, руководителя и другие реквизиты.

### 2. Установка

1. Установите Python-пакет на сервере:
```
pip install dadata==21.10.1
```

2. Скопируйте папку `dadata_connector` в директорию `addons`

3. Перезапустите сервер Odoo

4. Обновите список приложений: **Настройки → Приложения → Обновить список**

5. Найдите **«DaData Connector»** и установите

6. Укажите токен DaData: **Настройки → Интеграции → DaData token**

> Токен можно получить на сайте [dadata.ru](https://dadata.ru) после регистрации. Бесплатный план включает 10 000 запросов в день.

![img_5.png](img_5.png)

### 3. Функциональность

3.1 Что заполняется автоматически:

| Поле в карточке | Откуда берётся |
|---|---|
| Название | Краткое наименование с ОПФ (для юрлиц) или ФИО (для ИП) |
| ИНН | Из реестра DaData |
| КПП | Только для юридических лиц |
| ОГРН | Из реестра DaData |
| ОКПО | Из реестра DaData |
| ОКВЭД | Основной вид деятельности |
| Форма собственности | По коду ОКОПФ |
| Страна, регион, город | Из юридического адреса |
| Улица, дом, квартира | Из юридического адреса |
| Почтовый индекс | Из юридического адреса |
| Руководитель | Создаётся как отдельный контакт-сотрудник |

3.2 Статус организации:

В окне подтверждения отображается текущий статус организации:

| Статус | Отображение |
|---|---|
| Активна | Зелёный цвет |
| Ликвидируется / Ликвидирована / Банкротство / Реорганизация | Красный цвет |

### Пример использования

### Открыть карточку контрагента

Перейдите в **Контакты** и откройте существующего контрагента или создайте нового.

![img_1.png](img_1.png)

### Ввести ИНН и нажать поиск

В поле **Tax ID** (ИНН) введите идентификационный номер налогоплательщика для организации и нажмите иконку поиска справа от поля.

![img_2.png](img_2.png)

### Проверить найденные данные

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

![img_3.png](img_3.png)

### Проверить результат

Карточка контрагента заполнится автоматически. Если у организации есть руководитель — он будет добавлен как отдельный контакт в раздел «Контакты» карточки.

![img_4.png](img_4.png)
