Модуль связывает интернет-магазин на 1С-Битрикс с системой лояльности "Kilbil" и автоматизирует всю работу с бонусами на стороне сайта. Покупатель копит и тратит бонусы, применяет промокоды и получает скидки, а магазин не ведёт двойной учёт — все операции синхронизируются с Kilbil автоматически.
Модуль работает «из коробки»: после установки достаточно указать API-ключ Kilbil, и интеграция начинает действовать на регистрации, авторизации, в корзине, на оформлении заказа и в личном кабинете.
Возможности
- Автоматическая регистрация покупателя в Kilbil по номеру телефона при регистрации на сайте
- Привязка существующего клиента Kilbil к пользователю сайта при авторизации и изменении профиля
- Сохранение идентификатора клиента Kilbil в профиле пользователя — повторный поиск не требуется
Скидки и бонусы на оформлении заказа
- Автоматические скидки по правилам Kilbil
- Применение промокодов с пересчётом суммы заказа
- Оплата заказа бонусами с ограничением максимального процента списания (настраивается, по умолчанию 30%)
- Корректный пересчёт итоговой суммы и суммы оплаты при изменении состава заказа
- Отдельной строкой отображается размер скидки 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 клиент должен авторизироваться/зарегистрироваться по номеру телефона до момента этапа оформления заказа, выбора адреса, способа доставки и способа оплаты. Если доступны бонусы то они отразятся под полем ввода бонусов для списания. Бонусы можно списать нажав кнопку применить. Сумма бонусов для списания отобразится в форме.
При каждом обращении обязательно предоставьте следующие данные:
- Адрес сайта.
- Логин и пароль для доступа в административный раздел 1С-Битрикс.
- Адрес сервера, логин и пароль для доступа к сайту по FTP или SSH.
- Описание проблемы и как ее воспроизвести.
- Скриншоты экрана с ошибкой.
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.