Оглавление
1 этап. Настройки в YC
3 этап. Синхронизация данных
Текущий способ интеграции с YC работает через API на базе бонусных карт Yclients.
Это делает интеграцию более стабильной и понятной в поддержке: проще подключается и не будет слетать.
Бонусы будут отображаться не только в браузере, но и в приложении на смартфоне.
Примечание: 01.04.24г. В Yclients обновилось окно записи, в связи, с переходом на новый интерфейс, поэтому теперь у нас новый способ интеграции.
1 этап. Настройки в YC
1.1. Новый тип карт
Для начала работы в новой интеграции необходимо настроить новый тип карт. Этот тип карт будет автоматически применяться к каждому клиенту, зарегистрированному в бонусной программе.
Важно! Новый тип карты подключается в основном магазине. При этом карта действует во всех филиалах.
Далее описаны этапы настройки.
1. Перейти в раздел “Настройки” - “Лояльность” и выбрать кнопку “Настроить” для вкладки “Карты лояльности, скидки и кэшбэк”.
У вас должны быть полные права Администратора.
2. Перейти во вкладку “Типы карт” и нажать на кнопку “Добавить тип карты”
3. Создать новую карту samosale - название с маленькой буквы samosale
4. Выбрать “Активные филиалы”
Отметить галочкой все филиалы
5. Автоматический выпуск - “Выдавать в любом филиале”
6. Сгорание всех неиспользованных баллов - “Не применять”
7. Ограничения применения - “Любые услуги” и “Любые товары” (При желании можно настроить ограничения на некоторые услуги или товары. Это настраивается в yclients)
8. Ограничение оплаты баллами - эту цифру нужно поставить такой же, как настроено в кабинете Samosale
Значение в поле “Ограничение оплаты баллами” берется из кабинета Samosale в разделе “Лояльность” - “Настройки” - “Можно оплатить бонусами до”. В двух сервисах это число должно быть одинаковым.
9. Сохранить настройку карты
1.2. Подключение приложения
В основном магазине и в каждом филиале необходимо подключить интеграцию.
Для этого сначала в основном магазине, потом для каждого филиала отдельно необходимо сделать следующие действия.
Важно! В момент нажатия кнопки “Подключить” происходит редирект в ЛК Samosale и филиал Yclients привязывается к кабинету, в котором есть авторизация в момент нажатия (следите, чтобы был открыт только один кабинет Samosale)
Пример: если у вас для каждого филиала свой отдельный ЛК в Samosale, то необходимо авторизоваться и войти в нужный ЛК Samosale для филиала X, переключиться на филиал X в Yclients и подключить приложение.
1. Перейти в раздел Интеграция - Уведомления
2. Найти SAMOSALE
3. Подключить
4. Если приложение ранее было подключено, отключить. И заново подключить
5. Нажмите кнопку “Продолжить” - необходимо дать доступ Samosale к разделам Yclients
6. После подключения обновить страницу в Yclients и убедиться, что подключение прошло успешно.
Если будет информация об ошибках, переподключите приложение еще раз
Если повторное переподключение не помогло, напишите нам в поддержку https://t.me/SamosaleSupport_Bot ;
Один из примеров ошибки - "Требуется активация приложения"
На скриншоте пример успешного подключения.
7. Также проверьте в кабинете Samosale - должен отобразится номер филиала, который подключен
8. Подключение для каждого филиала отдельно!
Филиал переключается в левом верхнем углу настроек в Yclients
1.3. Вебхуки
Проверить, что подключились вебхуки. Для этого перейти в раздел “Настройки”
Минимальный набор сущностей, необходимый в настройках Webhooks для корректной работы интеграции YC.
События по записям - на данном этапе для корректной работы будет достаточно.
2 этап. Проверить настройки в ЛК Samosale
Необходимо проверить настройки в ЛК Samosale. Есть инструменты, которые не будут поддерживаться в новой интеграции. Их необходимо отключить в кабинете SAMOSALE
Особенности работы этих инструментов описаны в статье Особенности интеграции
1. Подтверждение при списании бонусов необходимо отключить
2. Не будет работать процент максимальной скидки, потому что на стороне YCLIENTS будут рассчитываться бонусы.
При этом настройка по кэшбэк будет работать.
Пока нет синхронизации товаров (это работало аналогично в старой версии интеграции) Товары будут приходить из пробитых чеков.
3. В секретных уровнях не будет учитываться процент списания
Начисление бонусных баллов происходит согласно уровню лояльности покупателя (в том числе секретного уровня)
Списание только согласно настройке в личном кабинете Yclients
Значение мы берем из личного кабинета SAMOSALE
3 этап. Синхронизация данных
1 способ. Синхронизацию можно запустить в настройках ЛК Samosale.
2 способ. Синхронизация происходит во время записи и во время проведения оплаты, начисления бонусов (и других изменений по балансу)
Примечание: при синхронизации, если у клиента заполнено поле Имя в Yclients, то значение этого имени останется без изменений, не будет замены на имя из Samosale (c 27.03.24г сделали в приоритете данные Yclients)
3.1 Синхронизация в настройках ЛК
1. После всех настроек нужно зайти в кабинет Samosale и в настройках интеграции Yclients нажать на кнопку “Запустить задачу синхронизации клиентов”
ВАЖНО!
Если у вас несколько филиалов в Yclients, то необходимо настроить все филиалы и запускать синхронизацию после подключения приложения во всех филиалах YC!
При большом количестве филиалов, мы подключаем каждый по отдельности. Синхронизация обрабатывается по очереди - сначала один филиал, потом автоматически встает на обработку другой.
Примечание: в обновлении от 03.12.2025 добавлена возможность запускать синхронизацию баланса по клиенту нажатием кнопки в карточке клиента.
Процесс представлен в статье.
2. После этого действия данные по клиентам из ЛК Samosale синхронизируются с Yclients
- передается анкета клиента
- всем покупателям/клиентам в Yclients будет выдана наша карта SAMOSALE
- на карту будут начислены бонусы (будет указано, что бонусы появились в результате синхронизации)
Синхронизация из настроек в ЛК Samosale односторонняя.
Берутся все клиенты из Samosale и перебираются, есть ли такие клиенты на стороне YC.
Если на стороне YC нет клиента, то мы пропускаем синхронизацию.
3. Процесс синхронизации может занимать от 10 - 30 минут до нескольких часов.
Общее время зависит от количества клиентов в базе и количества филиалов:
- около 50 клиентов в минуту
- в каждом филиале синхронизация идет отдельно
Во время синхронизации работать можно, просто если покупатели/клиенты не просинхронизрованы еще, у них не получится списать бонусы - в YC не будет информации по бонусам.
Пример: Если в базе 1500 клиентов и два филиала, то кол-во клиентов для синхронизации будет 3000. На весь процесс уйдет не меньше 1 часа.
Процесс синхронизации можно отслеживать в файле с логами (в колонке “Результат”) В конец лога построчно записывается новая информация: телефон - филиал - статус синхронизации.
Если информация не меняется на протяжении некоторого времени, то в синхронизации произошла ошибка.
4. По завершению процесса статус изменится на “Завершен”
5. Проверьте синхронизацию. В файле с логами напротив номеров клиентов должно быть ОК.
3.2 Синхронизация во время записи
Во время записи и во время проведения оплаты/начисления бонусов происходит синхронизация данных. Номер карты в карточке YC и карточке Samosale должны совпадать.
Возможны небольшие задержки в отображении начисленных бонусов в YC (30сек-1мин)
Проверка
Для проверки можно взять выборочно 2-3-х клиентов из Samosale, зайти в Yclients и проверить информацию по бонусам у этих клиентов.
1. Клиенты — Клиентская база
2. Карточка клиента в YC - Лояльность. Бонус должен отображаться
После проверки можно начинать работать с интеграцией.
Если вы не нашли ответ на свой вопрос, задайте его нам в Telegram @SamosaleSupport_Bot 😃