OX8.RU: Интеграция с системой лояльности Kilbil
от OX8.RU
Технические данные
Дата публикации:
21.07.2026
Версия:
1.0.0
Адаптивность:
Нет
Поддержка композита:
Нет
Число установок:
Менее 50 раз
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
Интеграция интернет-магазина с программой лояльности Kilbil: регистрация клиентов, автоматические скидки и промокоды, оплата бонусами на оформлении заказа, передача данных продажи в Kilbil и личный кабинет с балансом и историей бонусов.Модуль связывает интернет-магазин на 1С-Битрикс с системой лояльности "Kilbil" и автоматизирует всю работу с бонусами на стороне сайта. Покупатель копит и тратит бонусы, применяет промокоды и получает скидки, а магазин не ведёт двойной учёт — все операции синхронизируются с Kilbil автоматически.
Модуль работает «из коробки»: после установки достаточно указать API-ключ Kilbil, и интеграция начинает действовать на регистрации, авторизации, в корзине, на оформлении заказа и в личном кабинете.
Возможности
- Автоматическая регистрация покупателя в Kilbil по номеру телефона при регистрации на сайте
- Привязка существующего клиента Kilbil к пользователю сайта при авторизации и изменении профиля
- Сохранение идентификатора клиента Kilbil в профиле пользователя — повторный поиск не требуется
Скидки и бонусы на оформлении заказа
- Автоматические скидки по правилам Kilbil
- Применение промокодов с пересчётом суммы заказа
- Оплата заказа бонусами с ограничением максимального процента списания (настраивается, по умолчанию 30%)
- Корректный пересчёт итоговой суммы и суммы оплаты при изменении состава заказа
- Отдельной строкой отображается размер скидки Kilbil в блоке оформления
Передача данных заказа
- При оформлении заказа, данные по нему передаётся в Kilbil: начисление и списание бонусов проходят на стороне системы лояльности
- Надёжная обработка: при сбое связи операция повторяется, предусмотрен резервный сценарий
Личный кабинет покупателя
- Готовый компонент для вывода текущего баланса бонусов и истории операций
- Размещается на любой странице сайта, адаптивная вёрстка
Все параметры задаются на странице настроек модуля (раздел «Настройки» в карточке модуля):
- 1С-Битрикс: «Малый бизнес» / «Бизнес»
- Совместим с типовыми шаблонами оформления заказа; селекторы блока итогов настраиваются для кастомных шаблонов
- PHP 8.x
- Модуль «Интернет магазин» — обязателен
- Модуль «Торговый каталог» (catalog) — обязателен
- Данный модуль не работает с быстрым заказом.
- Для правильной работы модуля необходима авторизация по номеру телефона (условия работы с Kilbil)
- Клиент должен быть авторизован перед оформлением товара в корзине
Установка
1. Установите модуль в разделе «Marketplace → Установленные решения».
2. Откройте настройки модуля, для этого в административном разделе сайта, в боковом меню выберите "Настройки" → "Настройки продукта" → "Настройки модулей" → "OX8.RU: Интеграция с системой лояльности Kilbil" и укажите API-ключ Kilbil.
3. При необходимости включите/отключите нужные функции (скидки, промокоды, оплата бонусами) и проверьте CSS-селекторы блока итогов под ваш шаблон оформления.
4. Разместите компонент личного кабинета Kilbil на нужной странице (раздел компонентов «OX8 → Kilbil»).
5. В системе лояльности Kilbil должна присутствовать такая же товарная номенклатура как на сайте (можно импортировать через выгрузку в файл формата csv штатными средствами. Обязательно присутствие поля код товара, оно служит связкой при сопоставлении и поиске товаров с сайта в системе лояльности
6. Идентификация пользователя (старого) ведется с помощью номера телефона. Поэтому на сайте должна быть установлена система авторизации пользователя по номеру телефона.
7. Данный модуль не работает с быстрым заказом.
8. Клиент должен быть авторизован перед оформлением товара в корзине
Процесс начисления скидок, бонусов и использования промокодов:
Клиент должен выбрать товар. Товар так же должен присутствовать в номенклатуре системы лояльности KilBil. Для того чтобы была возможность начисления скидок и применения правил системы лояльности KilBil клиент должен авторизироваться/зарегистрироваться по номеру телефона до момента этапа оформления заказа, выбора адреса, способа доставки и способа оплаты. Если доступны бонусы то они отразятся под полем ввода бонусов для списания. Бонусы можно списать нажав кнопку применить. Сумма бонусов для списания отобразится в форме.
- API-ключ Kilbil — ключ доступа к API системы лояльности
- Базовый URL API — адрес API Kilbil
- Макс. процент оплаты бонусами — ограничение доли заказа, оплачиваемой бонусами
- Количество retry при сбоях — число повторов запроса при ошибке связи
- Расширенное логирование — включение подробных логов для диагностики
- Путь к каталогу логов — расположение файлов логов
- URL страницы оформления — адрес страницы оформления заказа
- Переключатели функций: Автоматические скидки, Промокоды, Оплата бонусами, Панель бонусов в админке — каждую возможность можно включить или отключить независимо
- CSS-селекторы блока итогов и строки «Итого» — для точной вставки строки скидки в нестандартных шаблонах оформления
- 1С-Битрикс: «Малый бизнес» / «Бизнес»
- Совместим с типовыми шаблонами оформления заказа; селекторы блока итогов настраиваются для кастомных шаблонов
- PHP 8.x
- Модуль «Интернет магазин» — обязателен
- Модуль «Торговый каталог» (catalog) — обязателен
- Данный модуль не работает с быстрым заказом.
- Для правильной работы модуля необходима авторизация по номеру телефона (условия работы с Kilbil)
- Клиент должен быть авторизован перед оформлением товара в корзине
Установка
1. Установите модуль в разделе «Marketplace → Установленные решения».
2. Откройте настройки модуля, для этого в административном разделе сайта, в боковом меню выберите "Настройки" → "Настройки продукта" → "Настройки модулей" → "OX8.RU: Интеграция с системой лояльности Kilbil" и укажите API-ключ Kilbil.
3. При необходимости включите/отключите нужные функции (скидки, промокоды, оплата бонусами) и проверьте CSS-селекторы блока итогов под ваш шаблон оформления.
4. Разместите компонент личного кабинета Kilbil на нужной странице (раздел компонентов «OX8 → Kilbil»).
5. В системе лояльности Kilbil должна присутствовать такая же товарная номенклатура как на сайте (можно импортировать через выгрузку в файл формата csv штатными средствами. Обязательно присутствие поля код товара, оно служит связкой при сопоставлении и поиске товаров с сайта в системе лояльности
6. Идентификация пользователя (старого) ведется с помощью номера телефона. Поэтому на сайте должна быть установлена система авторизации пользователя по номеру телефона.
7. Данный модуль не работает с быстрым заказом.
8. Клиент должен быть авторизован перед оформлением товара в корзине
Процесс начисления скидок, бонусов и использования промокодов:
Клиент должен выбрать товар. Товар так же должен присутствовать в номенклатуре системы лояльности KilBil. Для того чтобы была возможность начисления скидок и применения правил системы лояльности KilBil клиент должен авторизироваться/зарегистрироваться по номеру телефона до момента этапа оформления заказа, выбора адреса, способа доставки и способа оплаты. Если доступны бонусы то они отразятся под полем ввода бонусов для списания. Бонусы можно списать нажав кнопку применить. Сумма бонусов для списания отобразится в форме.
Техническая поддержка бесплатных решений (а так же помощь в установке) осуществляется на платной основе по e-mail: support@ox8.ru
При каждом обращении обязательно предоставьте следующие данные:
При каждом обращении обязательно предоставьте следующие данные:
- Адрес сайта.
- Логин и пароль для доступа в административный раздел 1С-Битрикс.
- Адрес сервера, логин и пароль для доступа к сайту по FTP или SSH.
- Описание проблемы и как ее воспроизвести.
- Скриншоты экрана с ошибкой.
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
пример: https://www.site.ru
