Программа лояльности Kilbil в магазине на 1С-Битрикс: возможности модуля и установка

Заказ приходит в админку магазина на Битриксе, а в комментарии покупателя строчка: «спишите мои бонусы, там около четырёх тысяч». Менеджер открывает Kilbil в соседней вкладке, смотрит баланс, руками считает новую сумму, перезванивает, согласовывает цену. Потом кто-то должен не забыть провести это списание в самой программе лояльности. Иногда забывает.

Так живёт магазин, у которого розница работает на Kilbil, а сайт про эту программу ничего не знает. Мы сделали модуль, который убирает ручную работу: он связывает интернет-магазин на «1С-Битрикс: Управление сайтом» с Kilbil, и бонусы начинают работать в корзине сайта так же, как на кассе. Готовое решение для этой задачи лежит у нас в Маркете: модуль интеграции Битрикса с Kilbil. Дальше разбираем связку по частям.

Розница на Kilbil, магазин на 1С-Битрикс, между ними ничего

Картина почти всегда одинаковая. Несколько розничных точек, в них работает Kilbil. Отдельно интернет-магазин на Битриксе, который делали в другое время и другими руками. Канала связи между системами нет ни одного.

Дальше идёт цепочка мелких потерь. Клиент копит баллы офлайн и не может потратить их онлайн. Заказ с сайта в Kilbil не попадает, поэтому в программе лояльности покупатель как будто ничего не покупал: уровень не растёт, данные о нём остаются неполными. Промокод, выданный в программе лояльности, сайт не принимает, потому что про него не знает.

Потом появляются костыли, и в Битриксе они узнаваемые. Кто-то пытается повторить бонусную механику правилами работы с корзиной: заводит правило на скидку, вручную сверяет его с уровнями в Kilbil, забывает поправить после изменения условий. Кто-то принимает заказ по телефону и проводит через розничную кассу, лишь бы баллы посчитались. Оба варианта стоят денег: вы платите временем сотрудников или лояльностью клиента.

Модуль закрывает ровно эту дыру. Он не переписывает вашу программу лояльности и не заменяет Kilbil, а делает сайт таким же участником программы, как торговую точку. Состав и условия смотрите на карточке модуля интеграции с Kilbil для 1С-Битрикс.

Что делает модуль лояльности для 1С-Битрикс

Ниже только то, что модуль умеет сейчас, без планов и обещаний на будущее.

Привязка клиента по номеру телефона

Телефон в бонусных программах работает идентификатором, Kilbil тут не исключение. Модуль регистрирует и привязывает клиентов по номеру: человек оформляет заказ, указывает телефон, и его учётная запись на сайте связывается с карточкой в Kilbil. Постоянный покупатель вашего магазина у дома при первом же заказе онлайн оказывается не новичком, а клиентом с накопленной историей.

Скидки и промокоды в штатном поле Битрикса

Расчёт скидок и промокодов идёт в штатном поле сайта, том самом, куда покупатель и так вводит код. Второй блок с подписью «а сюда впишите код от бонусной программы» рядом не появляется. Клиент вводит промокод, поле его принимает, сумма пересчитывается.

Списание бонусов Kilbil и ожидаемое начисление

Ради этих двух вещей программу лояльности обычно и заводят. Покупатель списывает накопленные баллы в счёт заказа. Он же видит ожидаемое начисление, то есть сколько баллов вернётся после покупки.

Второй пункт недооценивают. Строчка «вам вернётся 640 бонусов» рядом с итогом корзины работает как спокойный аргумент добавить ещё одну позицию, и она не обещает ничего сверх ваших собственных правил.

Бонусы Kilbil в личном кабинете магазина на Битриксе

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

Передача продаж и возвратов через очередь

Заказы с сайта уходят в Kilbil, возвраты уходят туда же и той же дорогой. Передача идёт через очередь, и про этот механизм стоит поговорить отдельно, что мы и делаем в следующем разделе.

Границу обозначим сразу. Модуль работает с программой лояльности, а не с товарным учётом. Обмен номенклатурой, ценами и остатками с 1С решает другая задача и другое решение, про него у нас есть отдельный материал: интеграция интернет-магазина с 1С. Там про товары и склад, здесь про клиентов и баллы. Обе интеграции спокойно живут на одном сайте.

Списание бонусов в Битриксе и статус заказа

Раздел выглядит техническим, но он про деньги. Прочитайте, даже если обычно такие места пролистываете.

Что происходит, когда обрывается связь

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

Сайт остаётся в неведении. Списание прошло или нет? Если повторить запрос, можно списать баллы дважды. Если не повторять, баллы останутся на счёте, а заказ уедет со скидкой. Оба исхода бьют по вашему карману, просто с разных сторон.

Очередь снимает эту неопределённость. Операция не выполняется на лету, она встаёт в список задач с отметкой о состоянии. Не получилось сейчас, система повторяет попытку позже и фиксирует состояние операции. Оформление заказа при этом не блокируется ожиданием ответа Kilbil, покупатель проходит оформление обычным порядком.

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

Почему начисление привязано к статусу заказа в Битриксе

Вторая защита работает через статус проведения заказа. Начисление и списание в Kilbil происходят не в момент оформления, а только когда заказ переходит в статус, который выбрал администратор в настройках модуля.

Статусы заказа в Битриксе вы и так настраиваете под свой процесс, и модуль опирается на них, а не на собственную выдуманную логику. Возьмём заказ, оформленный в 23:40, с тремя тысячами списанных баллов. Утром менеджер перезванивает и выясняет, что нужного размера нет, заказ отменяется. При списании прямо на оформлении баллы пришлось бы возвращать руками, а клиент всё это время смотрел бы на минус в кабинете. Умножьте на число несостоявшихся заказов за месяц.

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

Режима «баллы двигаются прямо в момент оформления» в модуле нет намеренно. Так работают наивные интеграции, и заканчивается это ручными откатами по каждому отменённому заказу.

Мы обычно советуем статус оплаты, если у вас предоплата, и статус выдачи, если много заказов с оплатой при получении. Настройка меняется в любой момент, переустанавливать модуль ради этого не нужно.

Требования к магазину на 1С-Битрикс

Площадку лучше проверить до покупки. Список короткий.

Ключевая строчка здесь вторая. В младших редакциях «1С-Битрикс: Управление сайтом» модулей интернет-магазина и торгового каталога нет, а без них модуль не заработает. Не полагайтесь на название редакции по памяти: откройте список установленных модулей в своей админке и убедитесь, что оба на месте.

Исходящие соединения на обычном хостинге открыты. На выделенном сервере с настроенным файрволом внешние запросы часто зарезаны, и тогда сайт не свяжется с сервисом лояльности. Один вопрос администратору снимает проблему заранее.

Кроме сервера подготовьте три вещи: API-ключ Kilbil из вашего аккаунта сервиса, лицензионный ключ Advenity, который выдаётся после покупки, и свежую резервную копию сайта. Понадобится и доступ: права администратора в админке плюс доступ к файлам сайта по FTP, SFTP или через файловый менеджер хостинга. Копию делайте всегда, даже когда установка выглядит безобидно. Правило дешевле любой аварии, и мы подробно писали про него в материале про обслуживание сайта.

Установка модуля Kilbil в 1С-Битрикс

Порядок действий выглядит так.

1. Распакуйте папку advenity.kilbil из архива в <корень сайта>/local/modules/advenity.kilbil/. Именно в local, туда, где в Битриксе живут собственные решения проекта.
2. В админке откройте раздел Marketplace, пункт «Установленные решения», найдите «Интеграция интернет-магазина с Kilbil» и нажмите установку.
3. Перейдите в Настройки, затем в Настройки модулей, и введите лицензионный ключ Advenity.
4. Введите API-ключ Kilbil и нажмите «Проверить соединение». Кнопка сразу покажет, видит ли сервер сервис лояльности. Если связи нет, вернитесь к пункту про исходящие HTTPS.
5. Настройте функции модуля, выберите статус проведения заказа, укажите пути страниц и CSS-селекторы вашего шаблона.
6. Откройте страницу личного кабинета /personal/bonus/ и убедитесь, что баланс, уровень и история операций отображаются.
7. Сделайте тестовый заказ, переведите его в настроенный статус и проверьте, что операция появилась в Kilbil.

Полная инструкция лежит в архиве вместе с модулем. Последние два шага не пропускайте: тестовый заказ снимает вопрос «а точно ли всё работает» до первого живого покупателя, а не после его звонка.

Нестандартный шаблон магазина на Битриксе

Коробочные шаблоны Битрикса встречаются всё реже. У магазина обычно либо переделанный шаблон, либо покупной, либо написанный с нуля под задачи бизнеса. Поэтому модуль не привязан жёстко к разметке: пути страниц и CSS-селекторы вынесены в настройки.

По-человечески это значит вот что. Модулю нужно понимать, куда на странице корзины поставить блок со списанием бонусов и где искать поле промокода. В типовом шаблоне эти места известны, в вашем они могут называться иначе. Вместо правки кода модуля вы указываете нужный селектор в настройках, и блок встаёт на место.

Если про CSS-селекторы вы слышите впервые, спросите того, кто делал или обслуживает сайт: верстальщик найдёт нужный селектор в инспекторе браузера. Наша поддержка тоже подскажет, что вписать, если пришлёте ссылку на страницу корзины.

Отдельная история начинается там, где корзина собрана на скриптах и обновляется без перезагрузки страницы. Такое встречается на кастомных фронтендах поверх Битрикса. Здесь может понадобиться дополнительная настройка на стороне вашего шаблона, и это уже не установка, а небольшая доработка: мы берёмся за такие задачи в рамках разработки и доработки магазинов.

Цена модуля лояльности для Битрикс, лицензия и поддержка

Модуль стоит 4990 рублей. Покупка разовая, вы получаете лицензионный ключ Advenity и вводите его в настройках модуля.

В стоимость входит помощь с установкой. Мы не оставляем вас наедине с архивом и инструкцией: если модуль не встаёт, не подхватывается ключ или не проходит проверка соединения, напишите, разберёмся. Поддержка тоже включена, отдельной подписки за неё нет.

Модуль разработали мы сами, сами же его сопровождаем и знаем изнанку. Это совсем другая ситуация, чем покупка решения у неизвестного автора, когда на вопрос «почему не списываются баллы» ответить некому. Написать нам можно на hello@advenity.ru или в Telegram, все контакты собраны на странице контактов.

Если магазин работает не на Битриксе, а на WooCommerce, для него есть отдельное решение с той же логикой: плагин синхронизации Kilbil с WooCommerce за 1190 рублей, а как он устроен, мы разобрали в статье про Kilbil и WooCommerce. Остальные наши готовые решения собраны в Маркете.

Перед покупкой пройдите короткий чек-лист. Проверьте требования по таблице выше, уточните у хостера исходящие соединения, возьмите API-ключ в аккаунте Kilbil. После этого оформляйте покупку на странице модуля интеграции с Kilbil для 1С-Битрикс, и мы вместе доведём установку до рабочего состояния. Сомневаетесь, подходит ли решение вашему проекту, напишите до покупки и опишите, как устроен магазин: честно скажем, хватит ли модуля или потребуется доработка.