Appiko Loyalty для МойСклад

Коннектор позволяет начислять и списывать бонусы Appiko Loyalty в кассе МойСклад.

К сведению

Подписка Appiko Loyalty и подписка на коннектор внутри МойСклад оплачиваются отдельно. Одна подписка не активирует другую.

Коннектор работает с кабинетом Appiko Loyalty. Подключение каталога и заказов Telegram-магазина настраивается по отдельной инструкции.

Appiko Loyalty — отдельный продукт внутри Appiko: его кабинет, участники и балансы не относятся к Telegram-магазину. В Telegram-магазине нет настройки бонусов, а установка этого коннектора не включает бонусы в заказах магазина.

Что понадобится

• Аккаунт МойСклад с правами администратора и касса МойСклад.
• Кабинет Appiko Loyalty. Его можно создать при подключении.
• Для проверки бонусов — включённая программа и зарегистрированный участник.

Как подключить

Если кабинет Loyalty уже есть

1. Войдите в Appiko Loyalty как владелец нужного кабинета и откройте Интеграции.
2. В блоке МойСклад нажмите Создать код, затем Копировать код.
3. Установите приложение Appiko Loyalty из каталога решений МойСклад.
4. Откройте установленное приложение в МойСклад, вставьте код в поле Код из Appiko и нажмите Подключить.
5. Проверьте название подключённого кабинета.

Если вы начинаете из каталога МойСклад

1. Установите Appiko Loyalty и откройте окно приложения в МойСклад.
2. Нажмите Нет кабинета в Appiko — создать. Appiko откроется в отдельной вкладке.
3. Войдите в Appiko, укажите название и нажмите Создать и получить код. Если кабинеты уже есть, выберите нужный и нажмите Получить код.
4. Скопируйте код и вернитесь в МойСклад.
5. Вставьте его в поле Код из Appiko, нажмите Подключить и проверьте название кабинета.

Совет

Код содержит 8 символов, действует 15 минут и используется один раз. Если он истёк, создайте Новый код в разделе Интеграции Appiko Loyalty. Вручную получать API-токен МойСклад для подключения не нужно.

Привязка кабинета и управление точками выполняются в окне МойСклад. Программу, карты и правила бонусов настраивайте в Appiko Loyalty. Перейти в подключённый кабинет можно кнопкой Открыть в Appiko.

Если связь с МойСклад прервалась после ввода кода, в окне решения появится Подключение не завершено. Нажмите Повторить подключение — новый код не нужен. Если окно закрыто, снова откройте решение из МойСклад.

Точки продаж

Один аккаунт МойСклад подключается к одному кабинету Loyalty. Покупки автоматически обрабатывает единственная программа этого кабинета. При её включении или приостановке переподключать МойСклад не нужно. Клиенты, карты, операции и интеграции остаются общими для кабинета.

1. В окне решения МойСклад выберите, нужно ли Автоматически включать новые точки.
2. Откройте интеграцию в кассе МойСклад. Точка появится после первого обращения кассы.
3. Снова откройте окно решения в МойСклад и проверьте список точек.
4. Включите нужные точки или отключите те, которые не должны работать с Loyalty.

Новые точки автоматически включаются только при включённом переключателе. Точка, которую отключили вручную, не включится автоматически.

Все включённые точки используют общую базу клиентов и правила работающей программы Appiko Loyalty.

Сменить кабинет или отключить интеграцию

В окне приложения МойСклад нажмите Отключить кабинет. Получите код нужного кабинета в Appiko Loyalty и подключите его в том же окне. Удалять приложение из каталога для смены кабинета не нужно.

При приостановке подписки коннектора касса перестаёт работать с Appiko Loyalty. После возобновления ранее завершённое подключение восстанавливается; настройки точек и бонусные балансы сохраняются.

После удаления и повторной установки приложения пройдите подключение заново. При подключении того же кабинета в том же аккаунте МойСклад восстанавливаются выбор точек и настройка Использовать правила товаров. Отключённые вручную точки остаются отключёнными. Правила категорий и товаров сохраняются в кабинете. Удаление коннектора не удаляет кабинет Appiko Loyalty и его участников.

Списание по телефону

Лимит не задаётся при подключении МойСклад. В новой программе списание по номеру телефона выключено по умолчанию. При этом касса может находить клиента по телефону и начислять ему бонусы. Для списания нужен QR-код бонусной карты.

Чтобы разрешить кассирам списание по телефону:

1. В Appiko Loyalty откройте Программы лояльности → Настроить программу → Базовый кешбэк.
2. В блоке Списание в кассах МойСклад включите Разрешить списание по подтверждённому телефону.
3. Укажите Лимит списания по телефону, ₽ и сохраните правила.

Одна настройка действует во всех аккаунтах и точках продаж МойСклад, подключённых к этому кабинету Loyalty. Повторять её при подключении нового аккаунта не нужно: он сразу использует текущее правило программы.

Правила товаров

Сразу после подключения бонусы начисляются и списываются для всего чека. Синхронизировать каталог для этого не нужно.

Чтобы настроить отдельные категории и товары:

1. Откройте интеграцию МойСклад в кабинете Appiko Loyalty.
2. Включите «Использовать правила товаров».
3. Дождитесь завершения синхронизации каталога.
4. Выберите, где начислять и списывать баллы.

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

Как найти клиента в кассе

Касса может найти участника программы двумя способами:

• отсканировать QR-код бонусной карты Appiko Loyalty;
• ввести полный подтверждённый номер телефона клиента.

Телефон должен точно совпадать с подтверждённым номером в Appiko Loyalty. Клиенты, добавленные сотрудником или импортированные из файла, сразу считаются подтверждёнными и доступны для поиска. Поиск по части номера не используется.

Создание обычного покупателя (контрагента) в МойСклад не регистрирует его в Appiko Loyalty и не создаёт ему бонусный счёт. В кассе показываются только уже зарегистрированные участники Appiko с подтверждённым телефоном или бонусной картой. Если у такого участника уже есть ровно один покупатель в МойСклад с тем же полным номером, интеграция безопасно связывает существующие записи вместо создания дубля. При нескольких совпадениях она не выбирает покупателя наугад.

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

1. Соберите чек в кассе МойСклад.
2. Найдите клиента по QR-коду или точному номеру телефона.
3. Выполните пересчёт чека и проверьте доступную сумму списания.
4. Проведите продажу.

В режиме «Списывать» баллы распределяются по подходящим позициям чека, а кешбэк начисляется на оставшуюся сумму с учётом правил товаров. После проведения продажи списание и начисление отображаются в истории Appiko Loyalty.

При списании по телефону действует лимит из правил программы. Если клиент хочет списать больше этого лимита, отсканируйте QR-код его карты. Для QR-кода этот дополнительный лимит не применяется. Баланс, максимальная часть покупки бонусами и правила товаров продолжают действовать при любом способе поиска.

К сведению

Коннектор не делит товарные позиции в чеке. Если выбранную сумму нельзя точно распределить по существующим позициям с учётом цены и количества, Appiko уменьшит списание до ближайшей меньшей суммы, которую можно применить точно.

При списании баллов начисление рассчитывается на оставшуюся сумму покупки с учётом правил программы. Если касса передала начисление с отброшенной дробной частью балла, Appiko сохраняет точное начисление по своим правилам. Например, при остатке 1498 ₽ и ставке 5% начисляется 74,90 балла.

Если сервис временно недоступен

• Начисление не блокирует продажу. Чек можно провести, а бонусы будут начислены после восстановления связи.
• Списание требует подтверждения Appiko Loyalty. Если проверить баланс и правила не удалось, бонусная скидка не применяется и бонусы не списываются.
• Обработка полного возврата продолжится после восстановления связи.

Возврат

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

Внимание

Частичный возврат не поддерживается. При частичном возврате бонусный баланс автоматически не корректируется.

Тарифы коннектора

Стоимость, пробный период и условия коннектора смотрите в карточке решения МойСклад перед подключением. Подписка Appiko Loyalty оформляется отдельно в кабинете Loyalty. Одна подписка не заменяет другую.

Что проверить, если бонусы не работают

Ситуация	Что проверить
Код не принят	Создайте новый код в нужном кабинете Appiko Loyalty и используйте его в течение 15 минут
Время настройки истекло	Снова откройте приложение из МойСклад
Список точек пуст	Откройте интеграцию на кассе, затем повторно откройте окно решения в МойСклад
Бонусы не работают ни на одной точке	Проверьте подписки Appiko Loyalty и коннектора, а также включение программы
Клиент не найден	Введите полный подтверждённый телефон или отсканируйте актуальный QR-код карты
Не получается списать по телефону	В разделе Базовый кешбэк проверьте разрешение и лимит списания по телефону; для большей суммы используйте QR-код
В отдельной кассе нет программы	Проверьте, включена ли соответствующая точка продаж
Баланс не изменился после возврата	Убедитесь, что оформлен полный возврат исходной продажи