1. Главная
  2. Документация
  3. InSales
  4. Интеграции kilbil с интернет-магазином на InSales

Интеграции kilbil с интернет-магазином на InSales

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

1. Регистрация и управление бонусными картами

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

2. Отображение бонусного баланса

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

3. Начисление и списание бонусов

  • Автоматическое начисление: После каждой покупки бонусные баллы будут автоматически добавляться на счет клиента.
  • Использование бонусов: Покупатели смогут применять накопленные бонусы для получения скидок при последующих покупках.

4. Персонализированные предложения и акции

  • Сегментация клиентов: На основе покупательской активности и предпочтений система сможет предлагать индивидуальные акции и скидки.
  • Уведомления: Интеграция позволит отправлять персонализированные предложения через email или push-уведомления.

5. История транзакций

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

6. Реферальная программа

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

Реализация этих функций потребует разработки и внедрения соответствующих компонентов на стороне фронтенда интернет-магазина. Рекомендуется обратиться к специалистам, знакомым с платформой InSales и API сервиса kilbil, для качественной интеграции и настройки всех возможностей программы лояльности.

Для интеграции сервиса kilbil с интернет-магазином на платформе InSales с помощью API, рекомендуется следующий пошаговый сценарий:

1. Регистрация и настройка аккаунта в kilbil

Зарегистрируйтесь на платформе kilbil и настройте личный кабинет, следуя инструкциям на официальном сайте.

2. Получение API-ключей kilbil

В личном кабинете kilbil перейдите в раздел управления API и сгенерируйте необходимые ключи для аутентификации запросов.

3. Настройка API в InSales

  • В панели администратора InSales перейдите в раздел “Настройки” > “API-доступ”.
  • Создайте новый ключ API, предоставив необходимые права доступа для взаимодействия с kilbil.

4. Разработка или настройка интеграционного модуля

  • Поскольку готового модуля для интеграции kilbil с InSales может не существовать, потребуется разработать кастомное решение.
  • Используйте API InSales для управления клиентами и заказами.
  • Реализуйте обработку событий в InSales (например, создание заказа, регистрация нового клиента) с отправкой соответствующих данных в kilbil для начисления бонусов или применения скидок.
  • Обработка событий через Webhook. Настройте обработчики в InSales для автоматических действий

5. Тестирование интеграции

  • Проведите тестирование разработанного решения, проверяя корректность передачи данных между InSales и kilbil.
  • Убедитесь, что бонусы начисляются и списываются правильно, а данные о клиентах синхронизируются без ошибок.
  • Обработка ошибок при статусах 4xx/5xx проверьте:
    Корректность токена kilbil;
    Лимит запросов InSales (не более 500/5 минут)
  • Регулярно отслеживайте работу системы, обращая внимание на возможные сбои или неточности в данных.

6. Особенности InSales

  • Формат данных: InSales поддерживает как JSON, так и XML. Рекомендуется использовать JSON для совместимости с kilbil.
  • Интеграция с кассами: Если магазин использует кассы (АТОЛ, Эвотор), синхронизируйте данные через общий API kilbil. Для касс без интеграции используйте мобильное приложение Кассир kilbil.

7. Поддержка и обновления

  • Документация: Официальное API InSales;
  • Документация kilbil.

Готовые решения:
Если требуется ускорить интеграцию, используйте шаблон модуля для Битрикс с адаптацией под REST-API InSales. Для кастомных сценариев обратитесь к партнерам kilbil или IT-специалистам нашей компании.

 

Инструкция по интеграции с примерами

 

1. Настройка бонусного баланса клиента

Получение текущего баланса:

GET /api/loyalty/clients?phone={номер_телефона}
  • Если номер_телефона не указан, используется аутентифицированный пользователь.
  • Ответ от kilbil:
{
  "bonusBalance": 1500,
  "status": "active"
}

Доступные для списания бонусы (с учетом корзины):

  1. Получите товары из корзины InSales:
GET /admin/orders/current.json
  1. Отправьте данные в kilbil для расчета:
POST /api/loyalty/calculate-bonuses

Тело запроса:

{
  "products": [
    {"id": "123", "price": 5000},
    {"id": "456", "price": 3000}
  ]
}

2. Работа с корзиной и товарами

Расчет бонусов для товаров:

POST /api/loyalty/products/calculate

Пример запроса:

{
  "items": [
    {"product_id": 123, "quantity": 2},
    {"product_id": 456, "quantity": 1}
  ]
}

Синхронизация данных:

  • Для товаров используйте периодическую синхронизацию через:
GET /admin/products.json?updated_since=2023-01-01
  • Обновляйте в kilbil поля: external_id, price, stock_quantity.

3. Регистрация пользователей

Автоматическая при создании клиента:
Настройте вебхук в InSales:

Событие: client/create
URL: https://your-server.ru/kilbil-register

Пример обработчика:

POST /api/loyalty/clients

Тело запроса:

{
  "phone": "79001234567",
  "email": "client@mail.ru",
  "birthday": "1990-01-01"
}

С SMS-подтверждением:

  1. Инициируйте регистрацию:
POST /api/loyalty/clients/register
  1. Подтвердите код:
POST /api/loyalty/clients/confirm

Тело:

{
  "phone": "79001234567", 
  "code": "123456"
}

4. Обработка заказов

Начисление бонусов:
Настройте вебхук для события order/paid:

POST /api/loyalty/transactions

Тело:

{
  "order_id": "INSALES-12345",
  "amount": 5000,
  "client_phone": "79001234567"
}

Списание бонусов:
Добавьте в процесс оформления заказа:

POST /api/loyalty/transactions/withdraw

Тело:

{
  "order_id": "INSALES-12345",
  "bonus_amount": 300,
  "client_phone": "79001234567"
}

5. Особенности InSales

1. Формат телефона:
Приводите номера к формату 7XXXXXXXXXX (без “+” и скобок).

2. Кастомные поля:
Добавьте в настройках клиента:

  • kilbil_bonus_balance (числовое)
  • kilbil_client_id (текстовое)

3. Лимиты API:

  • Не более 500 запросов/5 минут
  • Используйте X-InSales-Api-Version: 2.0 в заголовках

6. Примеры реализации

Отображение баланса в ЛК:

{% raw %}
{% if customer.kilbil_bonus_balance %}
  Ваши бонусы: {{ customer.kilbil_bonus_balance }}
{% endif %}
{% endraw %}

Обработка оплаты бонусами:

InSales.Checkout.addCustomField({
  type: 'checkbox',
  name: 'use_bonuses',
  label: 'Списать бонусы'
});

7. Тестирование

  1. Создайте тестовый заказ с ценой > 1000 ₽
  2. Проверьте:
    • Начисление бонусов через 5-10 мин
    • Обновление баланса в карточке клиента
    • Логи в kilbil (раздел “Интеграции → Журнал событий”)

Документация:

Нужна интеграция kilbil и InSales?

Получите оценку стоимости в течение 30 минут!