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

1. Введение

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

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

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

• КПП

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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