Автозаполнение данных по ИНН
Last updated
Last updated
Бипиум позволяет автоматически заполнять данные организации через ввод ИНН. По ИНН можно автоматически получать следующие данные:
Полное наименование организации
Краткое наименование организации
КПП
Форматированный адрес организации
Информацию о сотрудниках
Для получения информации по ИНН Бипиум использует сторонний сервис «DaData». Полный перечень данных, которые можно получить, описан в документации к API сервиса.
Автоматическое получение данных по ИНН избавляет от ручного заполнения и форматирует заполняемые данные единым образом, позволяя избавиться от возможных опечаток.
При заполнении поля с ИНН сценарий Бипиума обращается за данными по организации к сервису «DaData». При наличии в базе, сервис возвращает Бипиуму компанию с заданным ИНН со следующим перечнем данных. Полученные данные обрабатываются сценарием и записываются в создаваемую запись каталога.
Определитесь с перечнем данных по организации, который вы хотите получать. Далее создайте (отредактируйте) каталог, в который вы хотите записывать полученные данные. Например, для получения информации по наименованиям, КПП и адресу организации добавьте в каталог следующие поля (или создайте новый каталог с этими же полями):
Краткое наименование (текст) Описание: Краткое наименование компании. Заполняется автоматически по ИНН. Настройки: Текст.
Полное наименование (текст) Описание: Полное наименование компании. Заполняется автоматически по ИНН. Настройки: Многострочный текст.
ИНН (текст) Описание: ИНН организации. Используется для поиска компании, задается вручную. Настройки: Текст по маске, маска ввода: 1111111111.
КПП (текст) Описание: КПП организации. Заполняется автоматически по ИНН. Настройки: Текст.
Адрес (адрес) Описание: Адрес организации. Заполняется автоматически по ИНН. Настройки: Вставьте в текстовое поле ваш API токен сервиса «DaData». Как получить?
Для запуска сценария по автозаполнению данных используется событие с типом «Изменено поле во время редактирования», которое отслеживает изменение поля с ИНН. Пример события:
При изменении поля с ИНН в карточке каталога событие запускает сценарий автозаполнения.
Сценарий для автозаполнения записи данными по организации выглядит следующим образом:
Сценарий выполняет:
Проверку на введенный ИНН. Если поле с ИНН не заполнено, то сценарий завершится.
Проверку введенного значения ИНН. Если введенное значении ИНН некорректно (длина не равна 10 символам), то сценарий сообщит об этом сотруднику и завершит работу.
Получение данных по компании. Компонентом «Запрос к API dadata.ru» сценарий обращается к сервису «DaData» и пытается получить данные о компании по ИНН. Формат получаемых данных – JSON. Описание.
Если сервис смог найти компанию по ИНН, то происходит дальнейшая обработка полученного JSON (сопоставление его атрибутов с id полей каталога). Если сервис не смог найти компанию или вернул ошибочный ответ, то сценарий завершается.
После обработки полученного JSON сценарий записывает необходимые значения в текущую запись.
В сценарии необходимо изменить следующие компоненты:
Компонент params. Замените тестовые id полей в переменной «fields» на id полей вашего каталога согласно описанию компонента. В переменной «token» после слова «Token» через пробел укажите ваш API токен сервиса «DaData». Как получить?
Создайте новую запись в созданном (измененном) каталоге и введите корректный ИНН. Кликните за пределы поля ввода или нажмите на «молнию». Если все сделано верно, то поля каталога автоматически заполнятся данными по компании: