Перейти к основному содержимому
Версия: 1.9.0

Интеграция с DaData

В приложении B2B CRM вам доступны интеграции с сервисом DaData. Интеграции позволяют при указании ИНН или Электронной почты автоматически заполнять поля формы таблицы Компании клиентов (crm_customer_company) и дочерних таблиц значениями, полученными из внешней системы DaData.

Активация интеграций​

подсказка

Требуемые роли: admin, crm_admin.

Чтобы активировать интеграцию на вашем экземпляре, выполните следующие шаги:

  1. Зарегистрируйтесь на сайте провайдера API.

  2. Подтвердите вашу электронную почту.

  3. Перейдите в личный кабинет.

  4. В секции Ключи нажмите сгенерировать под API-ключом. Скопируйте созданный ключ.

  5. Откройте запись интеграции DaData: Company by TIN, расположенную по адресу {URL вашего экземпляра}/record/crm_integration/174057052208423233. Когда интеграция активна, после указания ИНН на форме таблицы Компании клиентов (crm_customer_company) или дочерней таблицы автоматически заполняются поля:

    • Полное наименование
    • Наименование
    • Веб-сайт
    • Электронная почта
    • Телефон
    • Генеральный директор
    • Выручка, млн
    • Доходы, млн
    • Расходы, млн
    • Отрасли по ОКВЭД
    • Адрес
    • Количество филиалов
    • Детализированный статус компании
    • Среднесписочная численность работников
    • Домен

  6. Вставьте скопированный ключ в поле Токен доступа. Убедитесь, что флажок Активна отмечен, и нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

  7. (опционально) Повторите шаги 5-6 для интеграции DaData: Company by email, расположенной по адресу {URL вашего экземпляра}/record/crm_integration/174057052208423233. Для работы этой интеграции также необходимо указать Секретный ключ из личного кабинета DaData в третьей строке скрипта интеграции.

Когда интеграция активна, система будет производить запрос к внешней системе для поиска компании по указанной электронной почте, если не удалось найти компанию по ИНН, после чего на основе полученных данных будут автоматически заполнены поле ИНН и остальные поля, перечисленные для интеграции DaData: Company by TIN.

В результате на форме таблицы Компании клиентов и дочерних таблиц автоматически заполнятся указанные поля при соблюдении всех следующих условий:

  • заполнено поле ИНН или Электронная почта (в зависимости от того, какая интеграция активна);
  • вы сохранили запись;
  • в системе DaData есть запись с такими ИНН или электронной почтой.

Если хотя бы одно из условий не соблюдается, поля не заполняются автоматически.

внимание

При наличии активной интеграции каждое сохранение записи таблицы Компании клиентов (crm_customer_company) и дочерних таблиц запускает синхронизацию с сервисом DaData. Если значения полей, которые обновляются через интеграцию, отличаются от полученных данных, эти значения будут перезаписаны.

Деактивация интеграции​

Чтобы деактивировать интеграцию, перейдите на форму интеграции, снимите флажок Активна и нажмите Сохранить или Сохранить и выйти.

Возможные ошибки​

При возникновении ошибок в работе интеграции в Основной журнал добавляется соответствующая запись:

Запись Основного журналаКод ответаОписание
Connected to {url}. The request body is missing. Query data: {"query": }200Успешное подключение к API с некорректным телом запроса.
Connection to {url} failed. The request is invalid. Query data: {"query": }400Неуспешное подключение к API. Некорректный запрос.
Connection to {url} failed. The request is missing an API key or secret key. Query data: {"query": }401Неуспешное подключение к API. В запросе отсутствует API-ключ или секретный ключ, или в запросе указан несуществующий ключ.
Connection to {url} failed. The email is not confirmed, the balance is insufficient to process the request, or the API key is invalid. Please confirm your email, refill your balance, or check your API key. Query data: {"query": }403Неуспешное подключение к API. Не подтверждена почта или недостаточно средств для обработки запроса. Необходимо пополнить баланс в DaData.
Connection to {url} failed. The request must use the POST method. Query data: {"query": }405Неуспешное подключение к API. Запрос сделан с методом, отличным от POST.
Connection to {url} failed. Too many requests per second or new connections per minute. Try again later. Query data: {"query": }429Неуспешное подключение к API. Слишком много запросов в секунду или новых соединений в минуту.
Connection failed to {url}. Internal service error. Query data: {"query": }500, 502, 503, 504Неуспешное подключение к API. Произошла внутренняя ошибка сервиса.