Подсказки и автозаполнение DaData: адреса, ИНН, банки

Адреса и реквизиты без ошибок: покупатель выбирает, модуль заполняет

Ошибка в адресе — это возврат, ошибка в ИНН или КПП — переделанные документы. Модуль подключает к полям магазина сервис подсказок DaData: покупатель начинает вводить адрес, ИНН или БИК, выбирает вариант из списка, и связанные поля заполняются сами — от индекса и региона до КПП, ОГРН и корреспондентского счёта.

Зачем магазину подсказки DaData

Адрес с опечаткой, индекс не от той улицы, ИНН с лишней цифрой — каждую такую ошибку менеджер потом ищет руками, а курьер или бухгалтерия расплачиваются за неё временем. Проще подставлять сразу правильные данные: DaData хранит адреса, организации и банки в справочниках, а модуль показывает их покупателю прямо в поле по мере ввода.

Поле «ИНН» на оформлении заказа: по названию или номеру DaData показывает организации с ИНН, КПП и городом.

Адреса, организации, банки, ФИО и e-mail

Модуль работает с пятью справочниками DaData, и каждое поле профиля можно связать с любым из них:

• •  Адреса. Подсказки по мере ввода с учётом типа поля: страна, регион, город вместе с посёлками и сёлами, улица, дом, квартира. Выбор адреса заполняет индекс, город, регион и страну, а оформление заказа пересчитывает доставку.
• •  Организации. Поиск по названию, ИНН или ОГРН; из подсказки берутся короткое или полное название с формой собственности, ИНН, КПП, ОГРН, тип (юридическое лицо или ИП), юридический адрес и индекс.
• •  Банки. Поиск по названию или БИК; подставляются название банка, БИК и корреспондентский счёт.
• •  ФИО. Имя, фамилия и отчество по мере ввода — в профиле, при регистрации и в форме обратного звонка.
• •  E-mail. Подсказка домена после «@» — меньше писем, отправленных в никуда.

Адрес доставки: подсказки по мере ввода, дом и улица выбираются из списка.

После выбора адреса заполнены город, регион и страна, список способов доставки пересчитан.

Реквизиты для счёта — из ИНН и БИК

Штатная форма оплаты «Выставить счёт» модуля «Российские способы оплаты» знает только организацию, ИНН и одно текстовое поле банковских реквизитов. Модуль дополняет её полями, которые нужны бухгалтерии, и заполняет их из подсказок:

• •  ИНН подставляет название организации, КПП, юридический адрес, индекс и тип плательщика; БИК — наименование банка и корреспондентский счёт; расчётный счёт покупатель вводит сам.
• •  Юридическое лицо или ИП. Тип определяется по выбранной подсказке, его можно переключить вручную. У предпринимателя КПП нет — поле скрывается; по настройке скрывается и название организации.
• •  «Банковские реквизиты» собираются сами из банка, БИК, корреспондентского и расчётного счетов — печатный счёт и письма модуля оплат работают без изменений.
• •  Дополнительные поля сохраняются с заказом; КПП печатается в счёте рядом с ИНН.
• •  Поля формы счёта подключаются одной настройкой — без правки шаблонов и без сопоставления полей профиля.

Форма «Выставить счёт»: после выбора ИНН и БИК заполнены организация, КПП, адрес, тип плательщика, банк и корреспондентский счёт.

Индивидуальный предприниматель: тип переключился по подсказке, КПП и название организации скрыты.

Предупреждения по данным ЕГРЮЛ

DaData отдаёт вместе с организацией её состояние в реестре, и модуль показывает его сразу под полем — до того, как заказ оформлен и счёт выставлен:

• •  организация ликвидирована, ликвидируется или реорганизуется;
• •  выбран филиал, а не головная организация;
• •  сведения об организации или её адресе помечены в ЕГРЮЛ как недостоверные.

Под полем ИНН — предупреждение по данным ЕГРЮЛ: организация ликвидирована.

Заказ в панели и печатный счёт

Всё, что выбрал покупатель, доезжает до менеджера: реквизиты плательщика показаны в заказе с понятными подписями — КПП, БИК, банк, корреспондентский и расчётный счета, тип плательщика. Печатный счёт из панели и из письма покупателю содержит ИНН с КПП и банковские реквизиты одной строкой.

• •  Подсказки работают и в панели администратора: в карточке покупателя и компании, при создании и редактировании заказа менеджером.
• •  Тип плательщика в заказе показан словами — «Юр. лицо» или «ИП», а не кодом.

Заказ в панели администратора: реквизиты плательщика с подписями.

Напечатанный счёт: ИНН с КПП покупателя и банковские реквизиты одной строкой.

Любое поле — по правилу

Поля, которых нет в профиле покупателя, подключаются правилами: раздел «Покупатели → Подсказки DaData». Правило — это CSS-селектор поля, справочник и значение, которое подставлять; правила можно связывать между собой, как поля профиля.

• •  Готовый набор для штатных форм «Обратный звонок» и «Купить в один клик»: имя и e-mail подсказываются сразу после установки набора.
• •  Правило действует на витрине или в панели администратора и включается отдельно.
• •  Несколько полей, найденных одним селектором, получают одинаковые подсказки — удобно для форм конструктора форм и сторонних модулей.

Правила для полей форм: селектор, справочник, значение поля, где действует.

Карточка правила: селектор, справочник DaData, значение и связанные правила.

Окно «Заказать звонок»: подсказка имени по правилу из готового набора.

Настройка полей профиля

У каждого поля профиля в панели появляется вкладка «Сопоставление DaData». В ней выбирается справочник, значение из подсказки, поля-родители, из чьих подсказок заполняется это поле, и поля, при изменении которых его значение очищается.

• •  Так строится цепочка «ИНН → название, КПП, ОГРН, тип организации» или «Адрес → индекс, город, регион, страна»: покупатель выбирает одну подсказку, остальные поля заполняются.
• •  Подсказки можно выключить для поля, оставив только автозаполнение от родителей — так настраивают КПП и ОГРН, которые никто не вводит руками.
• •  Работает в профиле, при регистрации, в оформлении заказа в один шаг и в панели администратора.

Вкладка «Сопоставление DaData» у поля «ИНН»: справочник организаций, значение «ИНН», заполнение по выбору в поле «Компания».

Оформление заказа после выбора организации и банка: название, КПП, ОГРН, тип, банк и корреспондентский счёт заполнены.

Настройки, лимит запросов и права

• •  Два ключа из личного кабинета DaData и кнопка проверки: модуль делает тестовый запрос и показывает остаток запросов на сегодня.
• •  Экономия лимита. Всё, что есть в самой подсказке, подставляется без второго запроса; дозапрос полных данных включается отдельно и только там, где нужен. На каждый ввод уходит один запрос, повторные подсказки с тем же значением не показываются.
• •  Город по IP-адресу. Пустой город доставки заполняется по геолокации DaData вместе с регионом, страной и индексом; заполненные поля не трогаются. Запрос бесплатный.
• •  Форма «Выставить счёт»: подсказки, дополнительные поля, что скрывать у ИП и сборка банковских реквизитов — четыре настройки.
• •  Права администраторов: просмотр и управление правилами выдаются группам администраторов отдельно.

Настройки модуля: ключи, проверка API, дозапрос данных, предупреждения и город по IP-адресу.

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

Что нового в версии 1.2

• •  Подсказки и дополнительные поля в форме оплаты «Выставить счёт»: ИНН, КПП, БИК, банк, корреспондентский и расчётный счета, тип плательщика; банковские реквизиты собираются сами, КПП печатается в счёте.
• •  Предупреждения по данным ЕГРЮЛ: ликвидация, филиал, недостоверные сведения и адрес.
• •  Правила для любых полей витрины и панели по CSS-селектору и готовый набор для форм «Обратный звонок» и «Купить в один клик».
• •  В списке подсказок — название организации или банка, ИНН, КПП и город, а не только значение поля.
• •  Город доставки по IP-адресу посетителя.
• •  Тип организации показывается словами; границы адресных подсказок учитывают тип поля, поле «Город» предлагает и посёлки.
• •  Оформление заказа в один шаг: выбор подсказки сохраняет данные и пересчитывает доставку, страна и регион подставляются, виджет создаётся один раз.
• •  Дозапрос полных данных выключен по умолчанию — дневной лимит DaData расходуется вдвое медленнее.
• •  Модуль переведён на схему 4.0 CS-Cart: установщик, права, страница правил в меню «Покупатели».

Частые вопросы