Документация BILLmanager 6

Модуль "Автозаполнение данных плательщиков по ИНН"

Модуль работает только с данными лиц, зарегистрированных на территории Российской Федерации.

Модуль "Автозаполнение данных плательщиков по ИНН" позволяет использовать справочный сервис 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 — значение параметра.