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

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

Могут быть заполнены следующие поля:

  • для юридических лиц:
    • наименование;
    • юридический адрес;
    • КПП;
    • ОГРН/ОГРНИП;
    • ФИО и должность директора;
    • дата основания;
  • для индивидуальных предпринимателей:
    • наименование;
    • ОГРН/ОГРНИП;
    • ФИО индивидуального предпринимателя.

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

Принцип работыLink to Принцип работы

При заполнении формы пользователь указывает ИНН. Чтобы подставить данные, BILLmanager проверяет наличие записи об ИНН в своей базе данных:

  • если в базе данных записи нет или дата записи неактуальна, то BILLmanager отправляет запрос на получение данных от сервиса DaData и сохраняет их в базу данных;
  • если в базе данных есть запись с актуальной датой, то BILLmanager подставляет данные, сохранённые в базе данных.

НастройкиLink to Настройки

Чтобы установить модуль, перейдите в раздел Интеграция → Модули → установите Автозаполнение данных плательщиков по ИНН.

Чтобы перейти к настройкам, нажмите значок рядом с модулем:

  • API-ключ — укажите ключ для совершения запросов в сервис DaData. Подробнее см. документацию DaData;
  • Только при создании — активируйте опцию, чтобы использовать подстановку данных только при создании плательщика;
  • Расширенные параметры поиска — активируйте опцию, чтобы использовать расширенный поиск организаций и индивидуальных предпринимателей по параметрам: ИНН, КПП, ОГРН, Фамилия, Название организации и т.д.;
  • Поиск по активным и головным организациям — активируйте опцию, чтобы поиск выполнялся только по активным и головным организациям. Например, если не активировать опцию, поиск будет выдавать в результатах филиалы компании и компании, проходящие банкротство;

  • Использовать автоподстановку падежей — активируйте опцию, чтобы для подстановки ФИО директора в различных падежах использовать API "Стандартизация" сервиса DaData. Подробнее см. информацию на сайте сервиса.

    • Секретный ключ — укажите секретный ключ из личного кабинета сервиса DaData, чтобы выполнять API запросы для опции "Автоподстановка падежей". Подробнее см. документацию DaData;
  • Количество дней хранения данных — укажите количество дней, в течение которых BILLmanager не будет запрашивать данные у сервиса DaData повторно, а будет использовать сохранённые данные. При значении 0 дней запросы к сервису DaData будут отправляться с каждой подстановкой данных. Значение по умолчанию 30 дней.

ДополнительноLink to Дополнительно

ЛогированиеLink to Логирование

Логи взаимодействия биллинговой платформы с модулем "Автозаполнение данных плательщиков по ИНН" записываются в лог-файл /usr/local/mgr5/var/billmgr.log.

База данныхLink to База данных

Таблицы, обеспечивающие кэширование запросов:

  • vatnum_autocomplete — запись об ИНН, имеет поля:
    • id — внутренний идентификатор;
    • vatnum — ИНН;
    • profile_type — тип плательщика;
    • last_update_date — дата последней выгрузки;
  • vatnum_autocomplete_param — параметры, выгруженные для ИНН, имеет поля:
    • id — внутренний идентификатор;
    • vatnum_autocomplete — id соответствующей записи в vatnum_autocomplete;
    • intname — внутреннее имя параметра;
    • value — значение параметра.