Центр поддержки kilbil

To Kaiten

Интеграция с интернет-магазином 1С-Битрикс

Возможности модуля интеграции интернет-магазина 1С-Битрикс с kilbil

Модуль связывает интернет-магазин на 1С-Битрикс с системой лояльности kilbil и автоматизирует всю работу с бонусами на стороне сайта. Покупатель копит и тратит бонусы, применяет промокоды и получает скидки, а магазин не ведет двойной учёт — все операции синхронизируются с kilbil автоматически.

Модуль работает "из коробки": после установки достаточно указать API-ключ kilbil, и интеграция начинает действовать на регистрации, авторизации, в корзине, на оформлении заказа и в личном кабинете.

175852ac-876b-11f1-9050-fa163e2ff576



Авторизация клиентов

  • Автоматическая регистрация клиента в kilbil по номеру телефона при регистрации на сайте.

  • Привязка существующего клиента kilbil к пользователю сайта при авторизации и изменении профиля.

  • Сохранение идентификатора клиента kilbil в профиле пользователя — повторный поиск не требуется.

Скидки и бонусы на оформлении заказа

  • Автоматические скидки по правилам kilbil.

  • Применение промокодов с пересчетом суммы заказа.

  • Оплата заказа бонусами с ограничением максимального процента списания (% настраивается).

  • Пересчет итоговой суммы и суммы оплаты при изменении состава заказа.

  • Размер скидки из kilbil отображается отдельной строкой в блоке оформления заказа.

Передача данных заказа

  • При оформлении заказа данные по нему передаются в kilbil: начисление и списание бонусов происходит на стороне системы лояльности.

  • Надежная обработка: при сбое связи операция повторяется, предусмотрен резервный сценарий.

Личный кабинет покупателя

  • Готовый компонент для вывода текущего баланса бонусов и истории операций по клиенту (данные подтягиваются из kilbil автоматически).

  • Компонент размещается на любой странице сайта, предусмотрена адаптивная вёрстка.


Как работает модуль интеграции интернет-магазина 1С-Битрикс с kilbil

Клиент выбирает товар на сайте.

► До перехода на этап оформления заказа, выбора адреса, способа доставки и способа оплаты клиент авторизуется по номеру телефона (если ранее он не был зарегистрирован в программе лояльности, то регистрируется и сразу же становится участником программы лояльности)

► Если клиенту доступны бонусы, то они отразятся под полем ввода бонусов для списания. Бонусы можно списать, нажав кнопку Применить. Сумма бонусов для списания отобразится в форме.

8feb9c50-876b-11f1-9050-fa163e2ff576


Как подключить интернет-магазин 1С-Битрикс к Платформе kilbil


1. Создайте в Личном кабинете kilbil точку продаж - Интернет-магазин.

Интернет-магазин подключается к kilbil, как Точка продаж (по аналогии с обычной кассой в офлайн-магазине).

Как добавить торговую точку в этой статье.


2. Обратитесь на линию техподдержки и получите API-ключ для интеграции Интернет-магазина.

Внимание! При генерации API-ключа для Интернет-магазина будет включена опция "Интеграция API" = 1500 р. в мес. (15000 р. при оплате за год).


3. Купите Модуль интеграции kilbil.ru с 1С-Битрикс.

Для приобретения модуля интеграции оставьте заявку здесь. Стоимость "Модуля интеграции с интернет-магазином 1С-Битрикс" = 41 290 р. в 1-й год (2-й год и далее обновление модуля со скидкой 50%).

Внимание! Оплата за модуль осуществляется напрямую технологическому партнеру kilbil. Техническая поддержка модуля: support@ox8.ru.


4. Установите модуль. Откройте настройки модуля:

  • Укажите API-ключ kilbil.

  • Включите/отключите нужные функции (скидки, промокоды, оплата бонусами) и проверьте CSS-селекторы блока итогов под ваш шаблон оформления (при необходимости).


5. Разместите компонент личного кабинета kilbil на нужной странице (раздел компонентов "OX8 → kilbi").


6. В системе лояльности kilbil должна быть такая же товарная номенклатура, как на сайте (можно импортировать через выгрузку в файл формата csv штатными средствами).

Обязательно присутствие поля код товара: поле служит связкой при сопоставлении и поиске товаров с сайта в системе лояльности kilbil.


7. На сайте обязательно должна быть установлена система авторизации пользователя по номеру телефона.

  • Идентификация пользователя, который ранее уже был зарегистрирован в программе лояльности, идет по номеру телефона.

  • Клиент должен быть авторизован перед оформлением товара в корзине.


26ce718e-876b-11f1-9050-fa163e2ff576



Параметры настроек модуля

Все параметры задаются на странице настроек модуля (раздел "Настройки" в карточке модуля):

  • API-ключ kilbil — ключ доступа к API системы лояльности

  • Базовый URL API — адрес API kilbil

  • Макс. процент оплаты бонусами — ограничение доли заказа, оплачиваемой бонусами (по умолчанию = 30%).

  • Количество retry при сбоях — число повторов запроса при ошибке связи

  • Расширенное логирование — включение подробных логов для диагностики

  • Путь к каталогу логов — расположение файлов логов

  • URL страницы оформления — адрес страницы оформления заказа

  • Переключатели функций: Автоматические скидки, Промокоды, Оплата бонусами, Панель бонусов в админке — каждую возможность можно включить или отключить независимо

  • CSS-селекторы блока итогов и строки "Итого" — для точной вставки строки скидки в нестандартных шаблонах оформления

3b5979ee-876b-11f1-9050-fa163e2ff576


Совместимость модуля

  • 1С-Битрикс: "Малый бизнес" / "Бизнес"

  • Совместим с типовыми шаблонами оформления заказа; селекторы блока итогов настраиваются для кастомных шаблонов

  • PHP 8.x

  • Модуль "Интернет магазин" — обязателен

  • Модуль "Торговый каталог" (catalog) — обязателен

  • Для корректной работы модуля необходима авторизация по номеру телефона

  • Клиент должен быть авторизован перед оформлением товара в корзине


Внимание! Модуль не работает с быстрым заказом.



Нет специалистов по сайту? → С подключением поможет наш технологический партнер!


Если модификации модуля не требуется, то модуль устанавливается в течении 1-3 рабочих дней (с настройками поможет технологический партнер).

Если необходимы доработки модуля, то наш партнер оперативно оценит объем работ и срок их реализации. На старте вы будете точно знать стоимость работ и сроки реализации. Четко и без сюрпризов.

За подробной информацией обратитесь к менеджеру или оставьте заявку на сайте.



Есть свои разработчики? → Интегрируйте по API


Для интеграции необходимо использовать Документацию API. Для разработчиков и интеграторов.


Для подключения тестовой триал-лицензии на интернет-магазин на этапе отладки необходимо обратиться в техническую поддержку.

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