Модуль "Автозаполнение данных плательщиков по ИНН" позволяет использовать справочный сервис DaData, чтобы заполнять формы данными о компании или плательщике по указанному ИНН.
Могут быть заполнены следующие поля:
- для юридических лиц:
- наименование;
- юридический адрес;
- КПП;
- ОГРН/ОГРНИП;
- ФИО и должность директора;
- дата основания;
- для индивидуальных предпринимателей:
- наименование;
- ОГРН/ОГРНИП;
- ФИО индивидуального предпринимателя.
Автозаполнение работает во всех формах, где необходимо указать ИНН.
Принцип работы
При заполнении формы пользователь указывает ИНН. Чтобы подставить данные, BILLmanager проверяет наличие записи об ИНН в своей базе данных:
- если в базе данных записи нет или дата записи неактуальна, то BILLmanager отправляет запрос на получение данных от сервиса DaData и сохраняет их в базу данных;
- если в базе данных есть запись с актуальной датой, то BILLmanager подставляет данные, сохранённые в базе данных.
Настройки
Чтобы установить модуль, перейдите в раздел Интеграция → Модули → установите Автозаполнение данных плательщиков по ИНН.
Чтобы перейти к настройкам, нажмите значок 
рядом с модулем:
- API-ключ — укажите ключ для совершения запросов в сервис DaData. Подробнее см. документацию DaData;
- Только при создании — активируйте опцию, чтобы использовать подстановку данных только при создании плательщика;
- Расширенные параметры поиска — активируйте опцию, чтобы использовать расширенный поиск организаций и индивидуальных предпринимателей по параметрам: ИНН, КПП, ОГРН, Фамилия, Название организации и т.д.;
- Поиск по активным и головным организациям — активируйте опцию, чтобы поиск выполнялся только по активным и головным организациям. Например, если не активировать опцию, поиск будет выдавать в результатах филиалы компании и компании, проходящие банкротство;
-
Использовать автоподстановку падежей — активируйте опцию, чтобы для подстановки ФИО директора в различных падежах использовать API "Стандартизация" сервиса DaData. Подробнее см. информацию на сайте сервиса.
- Секретный ключ — укажите секретный ключ из личного кабинета сервиса DaData, чтобы выполнять API запросы для опции "Автоподстановка падежей". Подробнее см. документацию DaData;
- Количество дней хранения данных — укажите количество дней, в течение которых BILLmanager не будет запрашивать данные у сервиса DaData повторно, а будет использовать сохранённые данные. При значении 0 дней запросы к сервису DaData будут отправляться с каждой подстановкой данных. Значение по умолчанию 30 дней.
Дополнительно
Логирование
Логи взаимодействия биллинговой платформы с модулем "Автозаполнение данных плательщиков по ИНН" записываются в лог-файл /usr/local/mgr5/var/billmgr.log.
База данных
Таблицы, обеспечивающие кэширование запросов:
- vatnum_autocomplete — запись об ИНН, имеет поля:
- id — внутренний идентификатор;
- vatnum — ИНН;
- profile_type — тип плательщика;
- last_update_date — дата последней выгрузки;
- vatnum_autocomplete_param — параметры, выгруженные для ИНН, имеет поля:
- id — внутренний идентификатор;
- vatnum_autocomplete — id соответствующей записи в vatnum_autocomplete;
- intname — внутреннее имя параметра;
- value — значение параметра.