Public release from ruodoo-project: 19.0 - 2026-07-26 21:17:35 UTC

dadata_connector/README.md

@@ -0,0 +1,83 @@
+# 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)