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

Подключение KitAddr

Готовый сценарий — корзина Tilda ST100: умный адрес и ФИО через DaData, опционально выбор ПВЗ СДЭК и отделений Почты. Токен DaData остаётся на сервере KitAddr и в браузер покупателя не отдаётся. Другой магазин или CMS — подключим персонально.

Короткие гайды: умный адрес, чеклист ST100, СДЭК ПВЗ, Почта России, Яндекс ПВЗ · все гайды

Базовое подключение

01

Укажите домен

В ЛК добавьте сайт и укажите домен без https:// и www (например myshop.ru). Один домен — один аккаунт: он сразу привязывается к вам.

Виджет отвечает только на запросы с Origin этого домена и вашим site-key. Отдельный мета-тег для подтверждения не нужен.

02

Токен DaData

Подсказки адреса и ФИО идут с вашего аккаунта DaData. Ключ хранится на сервере KitAddr и в браузер покупателя не отдаётся.

  1. Зарегистрируйтесь на dadata.ru и подтвердите email.
  2. В кабинете DaData скопируйте API-ключ «Подсказок» (не секретный ключ стандартизации).
  3. Вставьте в ЛК KitAddr → сайт → Основные.

У DaData есть бесплатный план подсказок (лимиты — на dadata.ru). KitAddr реже дергает API — большинству магазинов на Tilda обычно хватает без оплаты DaData.

03

Якорь в форме ST100

Скрытое поле говорит виджету, какую форму считать корзиной. Без него KitAddr ничего не меняет на странице.

Имя TILDA_ADDR_ANCHORЗначение 1
Поля для ввода
#1 ИМЯ ФИО*
#2 СКРЫТОЕ ПОЛЕ =
ТипСкрытое поле
Имя переменной
Значение
#3 ПОЛЕ В ОДНУ СТРОКУ Почтовый индекс
#4 ПОЛЕ В ОДНУ СТРОКУ Регион/область/район
#5 ПОЛЕ В ОДНУ СТРОКУ Населённый пункт
#6 ПОЛЕ В ОДНУ СТРОКУ Улица, дом, корпус/строение, квартира/офис

Значение должно быть именно 1. Поле можно поставить в начале или в конце списка полей формы.

04

Поля адреса и ФИО

В типичном ST100 достаточно стандартных имён. Виджет подменяет их одним полем «Адрес доставки» и при выборе подсказки заполняет скрытые слоты.

Name / FIO ФИО POSTCODE / index индекс REGION регион TOWN / city город ADDRESS / address улица, дом PVZ_CODE код пункта
  • Если адрес разбит (Улица / Дом / Квартира) — просканируйте поля: маппинг подстроится сам.
  • То же для раздельного ФИО (Фамилия / Имя / Отчество).
  • «Проверить корзины» покажет, на каких страницах есть якорь; «Живой сканер» — если форма только в JS.
  • В заказ уходят только поля из ST100. Код пункта — только в PVZ_CODE (или имя из ЛК); лишние поля виджет не создаёт.
05

Скрипт в HEAD

Один тег на весь сайт. Ключ pk_… — в разделе «Установка» сайта в ЛК.

<script
  src="https://kitaddr.ru/widget.js"
  data-site-key="pk_ВАШ_КЛЮЧ"
  defer
></script>

Копировать widget.js на чужой домен бесполезно: Origin должен совпадать с доменом из ЛК.

СДЭК, Почта и Яндекс.Доставка

Как это устроено

Покупатель выбирает способ доставки в ST100. KitAddr смотрит на название этого способа и решает: показать только умный адрес или ещё кнопку выбора пункта.

  • СДЭК до ПВЗ — адрес (чтобы понять район) → кнопка «Выбрать пункт» → код ПВЗ в заказ.
  • СДЭК до постамата — то же, но на карте только постаматы СДЭК.
  • СДЭК курьер — только адрес, без кнопки ПВЗ.
  • Обычная Почта России — только адрес, разнесённый по вашим полям формы (индекс, регион, город, улица).
  • До востребования / отделение — кнопка выбора отделения.
  • Постомат — кнопка выбора постомата.
  • Яндекс.Доставка до ПВЗ — адрес → кнопка → пункт на карте → код в заказ. Гайд: Яндекс ПВЗ.

Всё настраивается в ЛК сайта и в полях корзины ST100 — в Tilda достаточно вариантов доставки, скрытого поля кода пункта и скрипта KitAddr.

Настройка один раз

  1. ЛК сайта → Поля и модули → включите сценарии СДЭК, Почта и/или Яндекс.
  2. Ниже настройте правила под строки из поля «Варианты доставки» в ST100 (или скопируйте пример из ЛК).
  3. Задайте имя поля для кода пункта (по умолчанию PVZ_CODE) и добавьте в ST100 поле с тем же именем — лучше скрытое.
  4. По желанию оставьте «Город по IP»: карта сразу откроется около города покупателя без запроса GPS.

Как назвать доставку в Tilda

Правила смотрят на поле ST100 типа «Варианты доставки» (имя переменной часто DELIVERY_TYPE): KitAddr читает выбранную строку из вариантов ответа и подключает нужный режим — но только если модуль СДЭК/Почта/Яндекс включён в ЛК. Это поле KitAddr не перезаписывает.

  1. В корзине откройте поле «Варианты доставки» → в вариантах ответа добавьте строки вроде Доставка СДЭК до ПВЗ =300.
  2. В ЛК включите модуль и укажите подстроки правила (до пвз и т.п.).
  3. Опубликуйте сайт — при выборе этого варианта появится кнопка пункта (или останется только адрес).

В правиле указывайте уникальную часть названия. Срабатывает самое длинное совпадение. Не используйте голые слова «сдэк» или «почта».

Название в ST100ПоведениеПодстрока в правиле
СДЭК: Доставка до ПВЗ от 1 дня… Адрес + кнопка ПВЗ до пвз, до пункта
СДЭК: Доставка до постамата… Адрес + кнопка постамата до постамата, в постамат
СДЭК: Курьерская доставка… Только адрес — (правило не нужно)
Почта России от 2 дней… Только адрес — (правило не нужно)
Почта до востребования… Адрес + отделение до востребования
Доставка в постомат… Адрес + постомат постомат, почтомат
Яндекс Доставка до ПВЗ… Адрес + кнопка ПВЗ яндекс, yandex

Код пункта пишется только в поле из ЛК (по умолчанию PVZ_CODE). Добавьте его в ST100: Контент → Поля для ввода → Скрытое (или обычное поле, если нужен ручной ввод кода). Виджет не создаёт дубли вроде PICKUP_CODE / CDEK_PVZ.

Карта пункта

  • Поиск адреса понимает ввод в неправильной раскладке (латиница вместо кириллицы).
  • Кнопка с прицелом — геолокация браузера; опция «Город по IP» открывает карту около города без запроса GPS.
  • График работы показывается компактно: пн–пт с 9:00–20:00, сб–вс с 10:00–18:00.

Рекомендации

Корзина и UX

  • Держите умный адрес всегда: он нужен и для курьера, и чтобы найти ближайшие ПВЗ.
  • В названиях доставок пишите явно «до ПВЗ», «курьер», «до востребования», «постомат» — так проще правила и понятнее покупателю.
  • Штатное поле Tilda «Пункт получения» при активном правиле KitAddr скрывается, чтобы не дублировать выбор.
  • Кнопка пункта появляется только после выбора подходящего способа доставки — не прячьте адрес «ради красоты»: без него поиск ближайших точек хуже.

Качество заказов

  • Для дорогих заказов включите «Требовать выбор из подсказок» — меньше кривых адресов в CRM.
  • После сканера проверьте маппинг на реальной корзине: индекс и город должны заполняться из одной подсказки.
  • В «Данных» заказа должен быть один код пункта — не заводите в ST100 несколько полей под один и тот же код.
  • Отключить всё разом: снимите «Подсказки адреса» в модулях — корзина снова станет обычной Tilda.

Проверка и частые проблемы

  1. Опубликуйте сайт Tilda.
  2. Откройте корзину ST100 с якорем.
  3. Должно появиться поле «Адрес доставки»; при выборе «до ПВЗ» — кнопка пункта.
  4. Выберите пункт → в заказе в «Данных» один PVZ CODE, без дублей.

Не появился виджет — проверьте: домен в ЛК совпадает с сайтом, якорь TILDA_ADDR_ANCHOR=1, токен DaData, активная подписка, скрипт в HEAD.

Кнопка ПВЗ на курьере — в правиле слишком широкая подстрока (например только «сдэк»). Уточните до до пвз.

Нет точек в списке — укажите адрес / «Найти» / геолокацию и убедитесь, что выбран подходящий вариант доставки.

Несколько полей с одним кодом — в ST100 лишние поля; оставьте одно PVZ_CODE.

Включите «Debug в консоли» в настройках сайта, если нужно разобрать запрос в DevTools.

Перейти в кабинет →