Валидация адреса в корзине Tilda: подсказки DaData

Как это выглядит в корзине

Зачем валидировать адрес в ST100

Свободный ввод в корзине Tilda даёт опечатки, дома без корпуса и пустой индекс. Менеджер потом звонит «уточните адрес», курьер не находит дом, посылка возвращается.

KitAddr подключает подсказки и проверку DaData: адрес только из ФИАС/ГАР, с домом или участком. Индекс, регион и город заполняются сами — в CRM и службы доставки уходят нормальные поля.

• Одно поле «Адрес доставки» вместо четырёх разрозненных
• Неизвестный или неполный адрес не проходит до отправки заказа
• Токен DaData на сервере KitAddr — не светится в браузере покупателя
• Типовая корзина ST100 без правки дизайна блока

Чем это отличается от «вставить виджет DaData в Tilda»

Прямой JS DaData в Zero Block обычно требует своего кода, ключ часто оказывается в браузере, а поля ST100 (индекс, регион, город) всё равно заполняют руками или дописывают скрипт.

KitAddr сделан под корзину ST100: одно умное поле, раскладка по вашим переменным, проверка дома, опционально ПВЗ СДЭК / Почты / Яндекс. Ключ DaData лежит на сервере.

Что видит покупатель

1. В корзине — поле «Адрес доставки» вместо «индекс / регион / город / улица».
2. Начинает вводить — подсказки из справочника ФИАС/ГАР.
3. Выбирает вариант с домом или участком — индекс, регион и город заполняются сами.
4. Только улица без дома — заказ не уйдёт, пока не укажут номер.

Какие поля уходят в заказ

После выбора подсказки виджет заполняет переменные корзины (имена можно уточнить сканером в ЛК):

Если адрес разбит на «Улица / Дом / Квартира» — в ЛК нажмите «Сканировать поля»: маппинг подстроится.

Жёсткий и мягкий режим

В настройках сайта можно:

• Требовать выбор из подсказок — покупатель не отправит свободный текст (удобно при дорогой доставке).
• Разрешить ручной ввод — для редких адресов, СНТ и частных случаев, когда справочник молчит.

По умолчанию дом или участок обязателен: «Москва, Тверская» без номера не считается готовым адресом.

Что понадобится

1. Магазин на Tilda с корзиной ST100
2. Аккаунт на dadata.ru и API-ключ «Подсказок»
3. Аккаунт KitAddr (пробный период без карты)

Про стоимость. Платите тариф KitAddr (умный адрес входит уже в «Старт»). Ключ DaData ваш: у них есть бесплатный план подсказок; виджет реже ходит в API — большинству магазинов на Tilda обычно хватает без оплаты DaData. Актуальные лимиты — на dadata.ru/pricing.

Подключение за 10 минут

1. В KitAddr добавьте сайт (домен без https:// и www) и вставьте ключ DaData.
2. В корзине ST100 — скрытое поле: имя TILDA_ADDR_ANCHOR, значение 1.
3. Скрипт в HEAD сайта (кнопка «Скопировать» в разделе «Установка» ЛК).
4. Опубликуйте Tilda и откройте корзину — появится умный адрес.

Подробный справочник полей и модулей ПВЗ — в документации (для настройки в кабинете).

Проверка после публикации

1. Откройте корзину на опубликованном сайте (не только превью редактора).
2. Введите адрес с домом — в данных заказа должны быть индекс, регион, город и улица.
3. Выберите улицу без дома — виджет должен попросить номер.
4. Не заполняется — сверьте Origin домена в ЛК и якорь TILDA_ADDR_ANCHOR=1.

ПВЗ СДЭК и другие службы — по желанию

Умный адрес работает сам. Если нужен выбор пункта на карте — включите модуль в кабинете:

• СДЭК Тильда ПВЗ
• Почта России
• Яндекс.Доставка ПВЗ

Ключи служб доставки в Tilda не нужны — достаточно вариантов доставки, поля кода пункта и скрипта KitAddr.

Частые ошибки

• Нет якоря — без TILDA_ADDR_ANCHOR=1 виджет не активируется.
• Не тот ключ DaData — нужен API-ключ подсказок, не секретный ключ стандартизации; email на DaData подтверждён.
• Домен с www — в ЛК укажите тот Origin, с которого реально открывается корзина.
• Только превью Tilda — проверяйте на опубликованной странице.