Обновлено:
KitAddr — сервис по подписке для интернет-магазинов на Tilda: добавляет в корзину ST100 выбор пункта выдачи СДЭК, Почты России и Яндекс.Доставки на карте, цену доставки курьером по зонам, выбор даты и времени доставки и подсказки адреса. Подключается одним скриптом в HEAD сайта, без своего кода.
Ниже — установка в корзину Tilda ST100, имена полей и настройка модулей: пункты выдачи СДЭК, Почты и Яндекса, зоны доставки своего курьера, дата и время доставки, подсказки адреса и ФИО. Не Tilda — адаптируем модули бесплатно, если это технически возможно: платите только подписку.
Короткие гайды: доставка на Тильде, подсказки адреса, чеклист ST100, СДЭК ПВЗ, Почта России, Яндекс ПВЗ, зоны доставки · все гайды
В ЛК добавьте сайт и укажите домен без https:// и www (например myshop.ru). Один домен — один аккаунт: он сразу привязывается к вам.
Виджет отвечает только на запросы с Origin этого домена и вашим site-key. Отдельный мета-тег для подтверждения не нужен.
Подсказки адреса и ФИО идут с вашего аккаунта DaData. Свой ключ DaData лучше подключить сразу — он нужен после пробного периода. Ключ хранится на сервере KitAddr и в браузер покупателя не отдаётся.
У DaData есть бесплатный план подсказок (лимиты — на dadata.ru). KitAddr реже дергает API — большинству магазинов на Tilda обычно хватает без оплаты DaData.
Скрытое поле говорит виджету, какую форму считать корзиной. Без него KitAddr ничего не меняет на странице.
TILDA_ADDR_ANCHORЗначение 1Значение должно быть именно 1. Поле можно поставить в начале или в конце списка полей формы.
В типичном ST100 достаточно стандартных имён. Виджет подменяет их одним полем «Адрес доставки» и при выборе подсказки заполняет скрытые слоты.
Name / FIO ФИО
POSTCODE / index индекс
REGION регион
TOWN / city город
ADDRESS / address улица, дом
PVZ_CODE код пункта
PVZ_CODE (или имя из ЛК); лишние поля виджет не создаёт.Один код на весь сайт. Ключ pk_… — в разделе «Установка» сайта в ЛК. Виджет грузится с CDN, а если он недоступен — с kitaddr.ru.
<script>
(function kitaddrLoader(d, w, key, urls, ms, cfg, decide, arm){if(w.__kitaddrGate)return;var i=0, done=false, timer, ui;var g=w.__kitaddrGate={v:1, armed:!!arm, words:cfg.words||[], contact:cfg.contact||'', state:'pending', reason:''};function set(st, r){g.state=st;g.reason=r;if(ui)ui();}function lost(code){try{w.localStorage.setItem('kitaddr.guard', JSON.stringify({code:code, at:+new Date()}));}catch(e){}g.fail(code);}function old(){if(w.__tildaAddrScriptLoaded&&!(w.TILDA_ADDR&&w.TILDA_ADDR.gateApi))g.disarm();}g.ready=function(){if(g.state!='disarmed')set('ready', '');};g.disarm=function(){set('disarmed', '');};g.fail=function(r){if(g.state=='pending'||g.state=='failed')set('failed', r||'server');};function next(){if(done||i>=urls.length)return;clearTimeout(timer);var last=i==urls.length-1, s=d.createElement('script');s.src=urls[i++];s.async=true;s.setAttribute('data-site-key', key);s.setAttribute('data-kitaddr-v', '3');s.onload=function(){done=true;clearTimeout(timer);old();};s.onerror=function(){if(!last)return next();clearTimeout(timer);if(!done)lost('script_blocked');};timer=setTimeout(function(){if(!last)return next();if(!done)lost('script_timeout');}, ms);(d.head||d.documentElement).appendChild(s);}function retry(){if(w.__tildaAddrScriptLoaded)return w.location.reload();i=0;done=false;set('pending', '');next();}try{if(arm)ui=arm(d, w, g, decide, retry, lost, old, cfg);}catch(e){}next();})(document, window, 'pk_ВАШ_КЛЮЧ', ["https://cdn.kitaddr.ru/widget.js","https://kitaddr.ru/widget.js"], 5000, {});
</script>Копировать widget.js на чужой домен бесполезно: Origin должен совпадать с доменом из ЛК.
Покупатель выбирает способ доставки в ST100. KitAddr смотрит на название этого способа и решает: показать только умный адрес или ещё кнопку выбора пункта.
Всё настраивается в ЛК сайта и в полях корзины ST100 — в Tilda достаточно вариантов доставки, скрытого поля кода пункта и скрипта KitAddr.
PVZ_CODE) и добавьте в ST100 поле с тем же именем — лучше скрытое.Правила смотрят на поле ST100 типа «Варианты доставки» (имя переменной часто DELIVERY_TYPE): KitAddr читает выбранную строку из вариантов ответа и подключает нужный режим — но только если модуль СДЭК/Почта/Яндекс включён в ЛК. Это поле KitAddr не перезаписывает.
Доставка СДЭК до ПВЗ =300.до пвз и т.п.).В правиле указывайте уникальную часть названия. Срабатывает самое длинное совпадение. Не используйте голые слова «сдэк» или «почта».
| Название в ST100 | Поведение | Подстрока в правиле |
|---|---|---|
| СДЭК: Доставка до ПВЗ от 1 дня… | Адрес + кнопка ПВЗ | до пвз, до пункта |
| СДЭК: Доставка до постамата… | Адрес + кнопка постамата | до постамата, в постамат |
| СДЭК: Курьерская доставка… | Только адрес | — (правило не нужно) |
| Почта России от 2 дней… | Только адрес | — (правило не нужно) |
| Почта до востребования… | Адрес + отделение | до востребования |
| Доставка в постомат… | Адрес + постомат | постомат, почтомат |
| Яндекс Доставка до ПВЗ… | Адрес + кнопка ПВЗ | яндекс, yandex |
Код пункта пишется только в поле из ЛК (по умолчанию PVZ_CODE). Добавьте его в ST100: Контент → Поля для ввода → Скрытое (или обычное поле, если нужен ручной ввод кода). Виджет не создаёт дубли вроде PICKUP_CODE / CDEK_PVZ.
пн–пт с 9:00–20:00, сб–вс с 10:00–18:00.Модуль для магазинов со своим курьером: районы рисуются на карте в кабинете, у каждого своя цена, порог бесплатной доставки, минимальный заказ и срок. В корзине вместо обычного поля адреса сразу появляется карточка «Ввести адрес на карте»; после выбора адреса виджет подставляет цену зоны выбранному способу доставки — Tilda сама пересчитывает итог. Выберет покупатель ПВЗ или самовывоз — карточка уступит место обычному полю.
Подробный разбор с примерами — в гайде Зоны доставки на Тильде.
DELIVERY_TYPE), заведите один способ без цены, например «Доставка курьером».Остальные способы — ПВЗ, самовывоз, СДЭК — модуль не трогает. Зоны совместимы с картой пунктов выдачи: под каждый способ корзина показывает свой интерфейс.
Модуль для своего курьера: в корзине появляются ближайшие свободные дни и интервалы, покупатель выбирает день и время. Рабочие дни, интервалы, «на сегодня — до 12:00», срок подготовки и закрытые даты задаются в редакторе расписания; календарь считается по часовому поясу магазина.
DELIVERY_TIME — в него придёт выбор текстом, например «сб, 26 сентября, 14:00–18:00», при точном времени — «сб, 26 сентября, к 19:30». Имя можно сменить в редакторе расписания; виджет поле сам не создаёт.ЛК сайта → Модули → «Доставка» → «Бесплатная доставка»: порог для всех способов, а для отдельных — своя сумма по слову в названии способа. Считаем по сумме товаров со скидкой, без доставки; под способами покупатель видит «До бесплатной доставки осталось 450 ₽». У способа по зонам действует порог зоны.
ЛК сайта → Модули → «Покупатель» → «Реквизиты по ИНН». Покупатель вводит ИНН — название компании, КПП и юридический адрес подставляются сами из DaData по вашему ключу.
Поля добавляете в ST100 сами; виджет находит их по имени переменной (INN, KPP, COMPANY, ORG) или по подписи («ИНН», «КПП», «Название компании», «Организация», «Юридический адрес», «ОГРН»). Подписано иначе — впишите имя в «Дополнительно — поля реквизитов».
Квартира и заметки дописываются в поле адреса одной строкой: «ул Ленина, д 5, кв 12 · подъезд 2, этаж 5». Есть в форме отдельное поле «Квартира» — квартира уйдёт и туда. Переключатели — в «Модули» → «Покупатель».
PVZ CODE, без дублей.Не появился виджет — проверьте: домен в ЛК совпадает с сайтом, якорь TILDA_ADDR_ANCHOR=1, токен DaData, активная подписка, скрипт в HEAD.
Кнопка ПВЗ на курьере — в правиле слишком широкая подстрока (например только «сдэк»). Уточните до до пвз.
Нет точек в списке — укажите адрес / «Найти» / геолокацию и убедитесь, что выбран подходящий вариант доставки.
Несколько полей с одним кодом — в ST100 лишние поля; оставьте одно PVZ_CODE.
Виджет есть не во всех корзинах — посмотрите строку «Корзины» в «Здоровье сайта» в ЛК: KitAddr сам обходит сайт и показывает страницы с корзиной, где виджет не включён. Добавьте якорь в нужные корзины — без него корзина остаётся обычной Tilda.
Включите «Debug в консоли» в настройках сайта, если нужно разобрать запрос в DevTools.