# Касса МоегоСклада

Касса МоегоСклада начисляет и списывает баллы программы сама: при продаже она вызывает сервер платформы по Loyalty API
МоегоСклада. Мерчанту ничего не нужно разрабатывать или устанавливать: он ставит решение платформы из каталога решений
МоегоСклада и вводит код из кабинета. Устройство подключения описано в [ADR-0027](../../adr/0027-moysklad.md).

## Публикация решения (один раз, владелец продукта)

1. Получить доступ в личный кабинет разработчика МоегоСклада: заполнить анкету по ссылке из
   [документации](https://dev.moysklad.ru/doc/api/vendor/1.0/) (раздел «Личный кабинет разработчика»). Доступ приходит
   на почту в течение нескольких дней.
2. Создать черновик **серверного** решения. Дескриптор — [descriptor.xml](descriptor.xml); в обоих адресах заменить
   `https://loyal.example` на адрес платформы (`APP_URL`). Решению нужно только чтение точек продаж.
3. Перенести в настройки окружения платформы id решения, его appUid (`алиас.разработчик`) и секретный ключ со
   страницы черновика:

   ```
   MOYSKLAD_APP_ID=…
   MOYSKLAD_APP_UID=…
   MOYSKLAD_SECRET_KEY=…
   MOYSKLAD_APP_NAME=«название решения в каталоге»
   ```

   Без первых трёх платформа не отвечает на запросы МоегоСклада, а страница «МойСклад» в кабинете говорит, что решение
   ещё не опубликовано.
4. Проверить на своём аккаунте МоегоСклада. Неопубликованное решение ставится только на аккаунт разработчика, подписка
   длится 24 часа и продлевается. Проверка:
   - установить решение;
   - получить код подключения в кабинете мерчанта и ввести его в окне решения;
   - включить программу лояльности решения в настройках скидок;
   - пробить чек.

   Логи запросов МоегоСклада к решению — в кабинете разработчика, «Решения → решение → Логи».
5. Отправить решение на модерацию.

## Что делает мерчант

1. В МоёмСкладе ставит решение из каталога решений.
2. В кабинете программы на странице «Интеграция → МойСклад» выбирает:
   - программу;
   - точку, кассами которой станут магазины МоегоСклада.

   Затем нажимает «Получить код подключения».
3. Администратор аккаунта МоегоСклада открывает решение и вводит код. Код действует 30 минут и подходит один раз.
4. В МоёмСкладе в настройках скидок мерчант включает программу лояльности решения.

Магазины МоегоСклада становятся кассами выбранной точки. На странице «МойСклад» любой магазин переносится в другую точку,
а «Отключить» сразу закрывает кассам доступ к программе.

## Что делает касса

Касса МоегоСклада обращается к программе по адресу, который получила при подключении. На каждый запрос она получает
ответ в форматах Loyalty API 1.0, отказы — с текстом для кассира.

- **Поиск покупателя** — по телефону, номеру карты или коду из приложения участника. Касса получает id участника как id
  покупателя и номер его дисконтной карты.
- **Регистрация** — если программа подтверждает телефон кодом, касса запрашивает код (`counterparty/verify`), кассир
  вводит его, и покупатель вступает в программу. Без кода регистрация не проходит.
- **Баланс** — сколько баллов у покупателя.
- **Расчёт продажи** — скидки акций и списание баллами как скидка позиций. Цена со скидкой — за единицу. Позицию в
  штуках, сумму которой единицы не делят до копейки, программа возвращает двумя позициями.
- **Код списания** — на телефон участника, с суммой баллов; его сверяет касса. Без кода, если его требуют правила
  программы, продажа со списанием не проходит.
- **Продажа и возврат** — продажа регистрируется один раз и сразу подтверждается. Если с расчёта баланс покупателя или
  правила изменились и программа не может списать столько баллов, сколько сняла касса, продажа не регистрируется, и
  касса получает отказ «Баллы не списаны». Покупатель, которого программа не знает, получает скидки акций, но не баллы.
  Возврат забирает баллы за возвращённые товары. Возврат продажи, которую программа не знает, баллы не трогает, и
  страница «МойСклад» его считает.
- **Подарочные сертификаты** — программа их не выпускает.

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

## Готовность

- **9.2-1 — готово:**
  - решение в каталоге;
  - подключение аккаунта;
  - магазины как кассы.
- **9.2-2 — готово:** запросы кассы — поиск покупателя, регистрация, баланс, расчёт, коды подтверждения, продажа,
  возврат.
- **Перед публикацией** проверить на отладочном аккаунте места, которые документация МоегоСклада оставляет открытыми
  (список — в [ADR-0027](../../adr/0027-moysklad.md), «Последствия»).
