Автозаполнение данных по ИНН

1. Введение

КОСКО BPM позволяет автоматически заполнять данные организации через ввод ИНН. По ИНН можно автоматически получать следующие данные:

  • Полное наименование организации

  • Краткое наименование организации

  • КПП

  • Форматированный адрес организации

  • Информацию о сотрудниках

Для получения информации по ИНН КОСКО BPM использует сторонний сервис «DaData». Полный перечень данных, которые можно получить, описан в документации к API сервиса.

Автоматическое получение данных по ИНН избавляет от ручного заполнения и форматирует заполняемые данные единым образом, позволяя избавиться от возможных опечаток.

2. Принцип работы

При заполнении поля с ИНН сценарий КОСКО BPM обращается за данными по организации к сервису «DaData». При наличии в базе, сервис возвращает КОСКО BPM компанию с заданным ИНН со следующим перечнем данных. Полученные данные обрабатываются сценарием и записываются в создаваемую запись каталога.

3. Реализация

Определитесь с перечнем данных по организации, который вы хотите получать. Далее создайте (отредактируйте) каталог, в который вы хотите записывать полученные данные. Например, для получения информации по наименованиям, КПП и адресу организации добавьте в каталог следующие поля (или создайте новый каталог с этими же полями):

Картинка1

  • Краткое наименование (текст)
    Описание: Краткое наименование компании. Заполняется автоматически по ИНН.
    Настройки: Текст.

  • Полное наименование (текст)
    Описание: Полное наименование компании. Заполняется автоматически по ИНН.
    Настройки: Многострочный текст.

  • ИНН (текст)
    Описание: ИНН организации. Используется для поиска компании, задается вручную.
    Настройки: Текст по маске, маска ввода: 1111111111.

  • КПП (текст)
    Описание: КПП организации. Заполняется автоматически по ИНН.
    Настройки: Текст.

  • Адрес (адрес)
    Описание: Адрес организации. Заполняется автоматически по ИНН.
    Настройки: Вставьте в текстовое поле ваш API токен сервиса «DaData». Как получить?

3.1. Событие для запуска автозаполнения

Для запуска сценария по автозаполнению данных используется событие с типом «Изменено поле во время редактирования», которое отслеживает изменение поля с ИНН. Пример события:

Картинка2

При изменении поля с ИНН в карточке каталога событие запускает сценарий автозаполнения.

3.2. Сценарий автозаполнения

Сценарий для автозаполнения записи данными по организации выглядит следующим образом:

Картинка3

Сценарий выполняет:

  • Проверку на введенный ИНН. Если поле с ИНН не заполнено, то сценарий завершится.

  • Проверку введенного значения ИНН. Если введенное значении ИНН некорректно (длина не равна 10 символам), то сценарий сообщит об этом сотруднику и завершит работу.

  • Получение данных по компании. Компонентом «Запрос к API dadata.ru» сценарий обращается к сервису «DaData» и пытается получить данные о компании по ИНН. Формат получаемых данных – JSON. Описание.

  • Если сервис смог найти компанию по ИНН, то происходит дальнейшая обработка полученного JSON (сопоставление его атрибутов с id полей каталога). Если сервис не смог найти компанию или вернул ошибочный ответ, то сценарий завершается.

  • После обработки полученного JSON сценарий записывает необходимые значения в текущую запись.

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

  • Компонент params. Замените тестовые id полей в переменной «fields» на id полей вашего каталога согласно описанию компонента. В переменной «token» после слова «Token» через пробел укажите ваш API токен сервиса «DaData». Как получить?

4.1. Тестирование

Создайте новую запись в созданном (измененном) каталоге и введите корректный ИНН. Кликните за пределы поля ввода или нажмите на «молнию». Если все сделано верно, то поля каталога автоматически заполнятся данными по компании:

Картинка4