# МойСклад

Касса МоегоСклада может сама начислять и списывать баллы программы: покупатель называет телефон или показывает карту,
а касса считает скидку. Для этого в МоёмСкладе ставят решение платформы из каталога решений и подключают его кодом из
кабинета — без разработки.

> Решение ещё не опубликовано в каталоге решений МоегоСклада. Подключить кассу можно будет после публикации, а эта
> страница описывает, как всё будет работать. Пока решения в каталоге нет, страница «Интеграция» → «МойСклад» в
> кабинете пишет: «Подключить кассу МоегоСклада пока нельзя: решение платформы ещё не опубликовано в каталоге решений
> МоегоСклада».

## Что умеет касса

- **Найти покупателя** — по телефону, номеру карты или коду для кассы из кабинета покупателя. Касса видит имя
  участника, а если имени нет, — «Участник программы» и частично скрытый номер телефона.
- **Зарегистрировать** нового участника. Он принимает правила программы и даёт согласие на обработку персональных
  данных, поэтому оба документа должны быть опубликованы. Если программа подтверждает телефон кодом («Регистрация на
  кассе» в «Программах»), касса запрашивает код: покупателю приходит SMS на мобильный номер России, кассир вводит код,
  и без него участник не зарегистрируется.
- **Показать баланс** — сколько баллов у покупателя.
- **Рассчитать продажу** — скидки акций и оплату баллами как скидку на позиции; цена со скидкой — за единицу. Позицию в
  штуках, сумму которой нельзя разделить на единицы до копейки, программа возвращает двумя позициями.
- **Запросить код для оплаты баллами**, если его требуют правила программы. Участнику приходит SMS с суммой, например
  «Код для списания 1 500 баллов: …», а тому, кто подключил MAX в кабинете покупателя внутри MAX, — сообщение в MAX.
  Код сверяет касса МоегоСклада.
- **Провести продажу** — один раз и сразу подтверждённой. Баллы за покупку начисляются по правилам программы.
- **Провести возврат** — программа забирает баллы за возвращённые товары.

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

Код для оплаты баллами задаёт «Код подтверждения при оплате баллами» в «Правилах программы». На кассе МоегоСклада он
нужен при каждой оплате баллами и в варианте «Всегда», и в варианте «На кассе — если участника нашли не по коду из
приложения…»:
касса называет участника не кодом из приложения. Если у товаров должны быть свои категории или ограничения, заведите
их в каталоге программы («Программа лояльности» → «Товары») с артикулом — id ассортимента МоегоСклада.

## Что нужно заранее

- Программа с опубликованными правилами и документами согласий ([«Программа лояльности»](/docs/merchants/program/)).
- Точка продаж, кассами которой станут магазины МоегоСклада («Организация» → «Точки»).
- Работающий SMS-канал, если программа подтверждает телефон или оплату баллами кодом
  ([«Сообщения»](/docs/merchants/messages/)).
- Администратор аккаунта МоегоСклада: подключить решение может только он.

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

1. В МоёмСкладе установите решение платформы из каталога решений. Его название появится на странице «МойСклад» в
   кабинете после публикации.
2. В кабинете: «Интеграция» → «МойСклад» → «Получить код подключения». В полях «Программа» и «Точка для новых
   магазинов» выберите программу и точку — кассами этой точки станут магазины МоегоСклада.
3. Администратор аккаунта МоегоСклада открывает решение в МоёмСкладе (каталог решений → решение → «Начать работу»),
   вводит «Код подключения» и нажимает «Подключить». Окно решения действует 30 минут — потом его открывают заново.
4. В МоёмСкладе в настройках скидок включите программу лояльности решения.

Код показывается один раз, действует 30 минут и подходит один раз. Не передавайте его никому, кроме администратора
вашего аккаунта МоегоСклада: с ним чужой аккаунт получит доступ к баллам участников. Пока код ждёт, на странице видно,
до какого времени он действует; если он мог попасть к посторонним, отмените его: «Ещё» → «Отменить код».

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

Если окно решения отказывает:

- «Подключить программу лояльности может только администратор аккаунта МоегоСклада.»
- «Код не подошёл: он неверный, уже использован или устарел.» — получите новый код в кабинете.
- «Решение не установлено на этом аккаунте или приостановлено.» — установите или возобновите его в каталоге решений.
- «Этот аккаунт МоегоСклада уже подключён к программе другого мерчанта.»
- «К этой программе уже подключён другой аккаунт МоегоСклада.» — отключите его на странице «МойСклад».

## Магазины — кассы точек продаж

После подключения на странице видно «Аккаунт», «Программа», «Точка для новых магазинов», «Состояние» и время
подключения. Каждый магазин МоегоСклада становится кассой вида «Касса» в точке для новых магазинов: по ней идут чеки,
начисления и [отчёты по точкам](/docs/merchants/reports/). Магазин появляется в таблице «Магазины МоегоСклада» при
подключении или с первым запросом его кассы; новый магазин начинает работать с программой через несколько минут после
того, как появился в МоёмСкладе. Кассами становятся только магазины, которые МойСклад числит за вашим аккаунтом, — не
больше 500.

- «Перенести в точку» — новые чеки магазина пойдут в выбранную точку, прежние останутся там, где были. Если касса
  магазина отключена, перенос в его же точку включит её снова.
- «Ещё» → «Точка для новых магазинов» — куда попадут новые магазины; те, что уже есть, остаются на месте.
- Если точку для новых магазинов закрыли, новые магазины не подключатся: выберите другую.

## Возвраты

Возврат забирает баллы за возвращённые товары по продаже, на которую он ссылается. Если МойСклад не назвал продажу
или её уже вернули, возврат на кассе проходит, но баллы не трогает. Такие возвраты считает строка «Возвраты без баллов
за 30 дней» на странице «МойСклад». Если баллы нужно забрать, спишите их вручную в карточке участника: «Действия» →
«Скорректировать баллы» ([«Участники»](/docs/merchants/members/)).

## Безопасность

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

## Что видит кассир

| Сообщение кассы | Что это значит |
|---|---|
| «Покупатель не найден» | покупатель не участвует в программе: найдите его заново по телефону или номеру карты |
| «Карта заблокирована» | участник заблокирован в программе |
| «Нужен мобильный номер» | для кода нужен мобильный номер России (+7 9…) |
| «Нет документов программы» | не опубликованы правила программы или согласие на обработку персональных данных |
| «Программа не запущена» | правила программы не опубликованы |
| «Баллы не списаны» | баланс или правила изменились после расчёта: продажа в программе не зарегистрирована |
| «Недостаточно баллов», «Акция изменилась» | пересчитайте продажу |
| «Списание не подтверждено» | запросите код для оплаты баллами и введите его |
| «Код не подходит» | код истёк или выдан на другую сумму: пересчитайте продажу и запросите новый код |
| «Коды временно не отправляются» | отправка кодов остановлена — смотрите «Лимиты кодов» на странице «Каналы» |
| «Коды не отправляются» | не подключён канал для кодов подтверждения |
| «Точка продаж не подключена» | точка магазина закрыта в кабинете или касс уже слишком много |
| «Нет доступа к программе лояльности» | аккаунт отключён от программы: подключите его заново |
| «Программа лояльности не работает» | решение не запущено на аккаунте МоегоСклада или мерчант закрыт |

## Отключение

«Ещё» → «Отключить»: кассы МоегоСклада сразу перестают начислять и списывать баллы, а код подключения, если он ждёт,
перестаёт действовать. Чтобы подключить снова, получите новый код; в МоёмСкладе решение можно удалить или подключить
заново. Отключить МойСклад можно и тогда, когда работа мерчанта приостановлена.

Если решение удалили в МоёмСкладе, подключение пропадает, и после новой установки аккаунт подключают новым кодом. Если
решение приостановлено, касса получает отказ, подключение сохраняется, а «Состояние» на странице «МойСклад» — «не
работает: решение приостановлено или не настроено в МоёмСкладе».
