# Веб-касса

Веб-касса — касса программы лояльности в браузере: на планшете, ноутбуке или компьютере кассира. Она нужна точке, где
касса магазина не подключена к Rebonus. Кассир находит участника, начисляет и списывает баллы, регистрирует новых
участников и оформляет возвраты. Сама веб-касса ничего не продаёт: она не принимает оплату и не печатает фискальных
чеков. Покупку пробивают на кассе магазина как обычно, а в веб-кассе отмечают её для баллов.

## Перед началом

- **Правила программы опубликованы.** Без них касса не рассчитает покупку, а без опубликованных правил программы и
  согласия на обработку персональных данных не зарегистрирует участника. См.
  [«Программа лояльности»](/docs/merchants/program/).
- **Есть касса вида «Веб-касса»:** «Организация» → «Кассы» → «Добавить кассу». К одной такой кассе можно привязать
  несколько устройств точки.
- **Подключён SMS-канал**, если программа подтверждает кодом телефон новых участников или оплату баллами. Коды уходят
  через ваш аккаунт у SMS-провайдера, см. [«Сообщения»](/docs/merchants/messages/).
- **Браузер** — любой современный, с включённым JavaScript. Касса работает в одной вкладке браузера.

Страницы «Веб-касса» → «Устройства», «Кассиры» и «Смены» видят все сотрудники мерчанта. Привязывать устройства, заводить
кассиров и закрывать смены могут «Владелец» и «Администратор»; кабинет попросит подтвердить это кодом из
приложения-аутентификатора или паролем. Роли описаны на странице [«Кабинет магазина»](/docs/merchants/).

## Привязка устройства

Устройство — это браузер, который стал кассой. Его привязывают одноразовым кодом.

1. Откройте «Веб-касса» → «Устройства» → «Привязать устройство».
2. Выберите «Касса» и «Программа», впишите «Название устройства», например «Планшет у входа».
3. Кабинет покажет «Код привязки», «Ссылка для устройства» и «QR-код со ссылкой». Код показывается один раз,
   действует 10 минут и подходит только один раз.
4. На устройстве откройте ссылку или наведите камеру на QR-код: касса привяжется сама. Можно и вручную: на странице
   кассы, на экране «Привязка кассы», введите код и нажмите «Привязать». Код можно набирать строчными буквами и с
   пробелами.

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

В списке «Устройства» видно, к какой кассе и программе привязано устройство, его открытая смена, кто и когда его
привязал и когда оно последний раз обращалось к серверу. Столбец «Состояние»:

| Состояние | Что значит |
|---|---|
| «Работает» | Устройство привязано и может работать. |
| «Не используется» | Не работает: его касса отключена — заработает, когда кассу включат, — или устройством не пользовались 180 дней: такое привязывают заново. |
| «Отозвано» | Устройство отозвали. В списке оно остаётся ещё 30 дней. |

Привязка хранится в данных браузера. Если их очистить, устройство придётся привязать заново, а прежнее — отозвать.

## Кассиры и PIN-коды

Кассир — это не сотрудник с входом в кабинет, а имя и PIN-код, которым он открывает смену.

- **Добавить кассира:** «Веб-касса» → «Кассиры» → «Добавить кассира», поля «Кассир» (имя), «PIN-код» и «Точка».
  PIN-код — от 4 до 8 цифр, не одна и та же цифра и не цифры по порядку: 1111 и 1234 не подойдут. Сообщите его
  кассиру: в кабинете PIN-код больше не увидеть.
- **Точка.** Если поле пустое, кассир работает во всех точках, если выбрано — только на устройствах этой точки.
- **Изменить:** в строке кассира — «Переименовать», «Сменить PIN-код», «Отключить» и «Включить». Отключённый кассир не
  откроет смену, а его открытые смены сразу закроются.
- **Неверные PIN-коды.** После пяти неверных подряд кассир блокируется на 15 минут, время видно в столбце «Заблокирован
  до». «Сменить PIN-код» снимает блокировку сразу. Ещё касса считает неверные PIN-коды на самом устройстве: после 20
  неверных за 15 минут, у каких бы кассиров их ни вводили, ввод PIN-кода на нём останавливается до конца этих 15 минут.

## Смена

Кассир выбирает себя на экране «Кто работает?», вводит PIN-код кнопками на экране или цифрами клавиатуры и нажимает
«Открыть смену». Пока смена идёт, вверху экрана написано «Кассир: …» и есть кнопки «Итоги смены», «Заблокировать» и
«Закрыть смену».

- **Блокировка.** Через 10 минут без касаний и нажатий смена блокируется сама, кнопка «Заблокировать» — сразу. Чтобы
  продолжить, кассир вводит PIN-код и нажимает «Разблокировать». После обновления страницы касса тоже спрашивает
  PIN-код.
- **Другой кассир.** Кнопка «Другой кассир» на экране PIN-кода возвращает к выбору кассира. Когда другой кассир
  открывает свою смену, прежняя закрывается: на устройстве открыта не больше чем одна смена. Только что добавленного
  кассира касса покажет после этой кнопки или после обновления страницы.
- **Закрытие.** «Закрыть смену» спрашивает подтверждение. Чтобы работать дальше, кассир откроет новую смену.
- **Из кабинета.** Смену, которую забыли закрыть, закрывают в «Веб-касса» → «Смены» → «Закрыть смену». Касса на этом
  устройстве сразу перестаёт работать, пока кассир не откроет новую смену своим PIN-кодом.

### Итоги смены

«Итоги смены» показывают, что сделано на этом устройстве с начала смены: чеки и их сумма, сколько из них с участником
программы, скидки, начислено и оплачено баллами, возвраты и сколько баллов при них списано и возвращено клиентам.
После закрытия смены итоги остаются на экране выбора кассира, пока их не скроют кнопкой «Скрыть итоги». Итоги
заблокированной смены видны только после PIN-кода её кассира.

В кабинете, в «Веб-касса» → «Смены», — все открытые смены и закрытые за последние 30 дней, не больше 500: кто работал,
на каком устройстве, идёт смена, заблокирована или закрыта и почему. Итоги — в столбцах «Чеков», «С картой», «Сумма»
(после скидок), «Баллами» и «Возвратов»; они обновляются раз в минуту.

## Поиск участника

В блоке «Участник» кассир выбирает, по чему искать: «Телефон», «Карта» или «Код из приложения». Затем вводит значение и
нажимает «Найти».

- **Телефон** — в любом привычном виде: +7 900 000-00-00, 8 900 000-00-00 или десять цифр мобильного номера.
  **Карта** — номер карты программы, от 6 до 20 цифр.
- **Код из приложения** — восемь цифр. Покупатель открывает их кнопкой «Показать код» в
  [кабинете покупателя](/docs/merchants/card/), на сайте или в приложении магазина. Код действует две минуты.
- **Сканер штрихкодов**, который вводит текст как клавиатура, читает карту и QR-код покупателя прямо в поле, какую бы
  вкладку ни выбрали.
- **Камера.** Кнопка «Камера» есть, только если браузер умеет читать коды с камеры: так умеет Chrome на Android,
  ChromeOS и macOS. В браузерах на iPhone и iPad, в Firefox и в Chrome на Windows и Linux её нет — там остаются сканер
  и ввод вручную. Изображение с камеры не покидает устройство. Камера гаснет, как только код прочитан или кассир нажал
  «Отменить».

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

## Новый участник

Если по телефону никого не нашли, касса предложит «Зарегистрировать +7 …». Есть и кнопка «Новый участник». В форме —
«Телефон», «Имя (необязательно)», «Код приглашения (необязательно)» и документы программы. Правила программы и согласие
на обработку персональных данных отмечены «(обязательно)», согласия на рекламу — по желанию клиента. Текст документа
открывается кнопкой «Показать текст»: покажите его клиенту.

Дальше всё зависит от настройки программы: «Программа лояльности» → «Программы» → «Настроить регистрацию». Текущий
выбор виден в столбце «Регистрация на кассе». Менять его могут «Владелец» и «Администратор».

- **«Подтверждать телефон кодом»** — так по умолчанию. Кассир нажимает «Отправить код клиенту», клиент называет код из
  сообщения, кассир вводит его в поле «Код подтверждения» и нажимает «Зарегистрировать». Код доказывает, что согласие
  дал владелец номера. Без SMS-канала касса не регистрирует и пишет «Коды не отправляются: в кабинете не подключён
  канал для SMS…».
- **«Регистрировать без кода»** — кассир сверяет номер с клиентом и нажимает «Зарегистрировать». Касса показывает и
  записывает только обязательные согласия, а поля «Код приглашения» в форме нет: кассир может ошибиться номером или
  ввести чужой, и тогда приветственный бонус получит чужой или выдуманный номер.

Если участник с этим телефоном уже есть, касса продолжит покупку с ним, а его согласия не изменятся. Если документы
программы обновились, пока форма была открыта, касса покажет новую редакцию и попросит отметить согласия снова. Код
приходит только на мобильные номера России (+7 9…).

## Покупка

1. Найдите участника. Без участника покупка пройдёт без баллов.
2. В блоке «Покупка» введите сумму и нажмите «Рассчитать». Касса покажет «К оплате» и «Будет начислено».
3. Если клиент платит баллами, спишите их, как описано ниже.
4. Нажмите «Провести чек». Касса проводит чек сразу и пишет, например: «Чек … проведён: 1 250,00 ₽, списано 300
   баллов, начислено 62 балла».
5. Возьмите с клиента сумму «К оплате» на кассе магазина.

Если после расчёта изменить сумму или участника, расчёт отменяется. Если чек прошёл не так, как его рассчитали
(например, за это время изменились правила или баланс), касса предупредит: «Чек проведён не так, как был рассчитан…
Возьмите с клиента сумму по чеку».

Веб-касса передаёт покупку одной суммой, без списка товаров. Поэтому акции и карты штампов, которые зависят от
конкретных товаров или категорий, на ней не срабатывают. Начисление по правилам, уровни и бонусы работают как обычно.
По той же причине не действуют ограничения каталога («Не участвует в программе», «Минимальная цена»): вводите сумму
только тех товаров, которые участвуют в программе.

### Оплата баллами

Если у участника есть баллы, после расчёта касса пишет «Можно списать до … баллов». Кассир вводит число в поле
«Сколько баллов» и нажимает «Списать» или сразу нажимает «Списать все доступные». Если правила позволяют меньше, касса
скажет, сколько спишется. Строка вида «Списывается 300 баллов — 300,00 ₽» показывает, на сколько уменьшится сумма к
оплате. Кнопка «Без списания» отменяет списание.

Нужен ли код от клиента, решает правило «Код подтверждения при оплате баллами» в «Правила программы» → «Оплата
баллами»:

- **«Не нужен»** — касса списывает без кода.
- **«На кассе — если участника нашли не по коду из приложения (по телефону, карте, номеру) или ввели вручную…»** — без
  кода можно, только если код из приложения отсканировали сканером или камерой. Найденному по телефону, по карте или по
  коду, набранному вручную, нужен код из сообщения. Сайт и приложение магазина (кассы «Интернет-магазин» и «Мобильное
  приложение»), куда покупатель вошёл в свой аккаунт, списывают без кода; веб-касса — нет.
- **«Всегда»** — код нужен при каждой оплате баллами.

Когда код нужен, касса пишет «Списание подтверждается кодом, который придёт клиенту». Кассир нажимает «Отправить код
клиенту», клиент называет код, кассир вводит его и нажимает «Подтвердить» — только тогда становится доступна кнопка
«Провести чек». Код может прийти и в Telegram или в чат бота программы в MAX: касса пишет, куда он ушёл. Если код не
пришёл, нажмите «Отправить код ещё раз» — повторный придёт по SMS. Код подтверждает определённое число баллов: если
пересчитать покупку, понадобится новый. У участника без телефона списание с кодом недоступно. Замороженный участник
баллы не тратит.

## Возврат

Веб-касса не печатает чеков, поэтому возврат ищут не по номеру чека, а по покупкам участника.

1. Найдите участника и нажмите «Возврат покупки».
2. Выберите покупку и нажмите «Вернуть». В списке — покупки участника на всех кассах программы, новые сверху.
3. «Вернуть всё — товары на …» возвращает всё, что осталось от покупки. Покупку одной суммой, как их проводит
   веб-касса, можно вернуть и частично: введите «Сумма товаров, ₽» и нажмите «Вернуть часть». Чек из нескольких
   позиций, проведённый на другой кассе, здесь возвращается только целиком.
4. Касса попросит подтвердить возврат и назовёт сумму товаров и сколько вернуть клиенту деньгами. Часть покупки,
   оплаченная баллами, деньгами не возвращается.
5. После возврата касса скажет, сколько начисленных баллов списано и сколько баллов вернулось клиенту. Деньги
   возвращают на кассе магазина.

Как пересчитываются баллы при возврате, задают правила программы в разделе «Возвраты». Покупку без участника на
веб-кассе не вернуть: баллов за неё не было.

## Работа без связи

Касса считает, что связи нет, если сервер не ответил или браузер сообщил, что сеть пропала. Тогда на экране появляется
«Нет связи с сервером…», а рядом с «Рассчитать» — кнопка «Записать без связи».

- **Что можно записать.** Только покупку участника и только с начислением баллов. Оплатить баллами, получить скидку
  акции, зарегистрировать участника или оформить возврат без связи нельзя. Участник — тот, чей телефон или номер карты
  введён или отсканирован, или найденный до обрыва связи. Код из приложения без связи не принимается: он истечёт
  раньше, чем чек уйдёт на сервер.
- **Где хранится.** На самом устройстве, в данных браузера, не дольше 72 часов. Что старше, касса удаляет и говорит,
  сколько удалено: баллы за эти покупки не начислятся. Участника в таких чеках касса показывает маской телефона или
  последними цифрами карты.
- **Когда чеки уходят на сервер.** Сами, как только вернётся связь и на устройстве открыта смена, или по кнопке
  «Отправить сейчас». Баллы начисляются, когда сервер примет чек, а временем покупки остаётся время продажи. Дважды чек
  не пройдёт.
- **Очередь.** Кнопка «Очередь» показывает каждый записанный чек: «ждёт отправки», «отправлен, сервер его записывает»
  или «не принят» с причиной. Непринятый чек остаётся в списке, пока кассир его не уберёт кнопкой «Убрать». Баллы за
  такую покупку можно начислить вручную в [карточке участника](/docs/merchants/members/).
- **После перезагрузки страницы** записанные чеки сами не уходят: касса пишет, сколько их ждёт проверки, а кассир
  проверяет их в «Очереди» и нажимает «Отправить проверенные».
- **Чего делать нельзя.** Открыть или разблокировать смену без связи нельзя: PIN-код проверяет сервер. Не очищайте
  данные браузера, пока чеки не ушли, иначе они пропадут. Если закрыть смену с чеками в очереди, они уйдут, когда на
  этом устройстве снова откроют смену.

Иногда ответ сервера теряется, и неизвестно, прошёл ли чек. Тогда касса пишет «Сервер не ответил, и неизвестно, прошёл
ли чек. Нажмите «Провести чек» ещё раз: повтор не проведёт его дважды». Чек остаётся на экране, пока его не проведут
снова или не отменят кнопкой «Отмена». Чек, который только начислял баллы, можно поставить в очередь кнопкой «Записать
в очередь без связи». С возвратом так же: «Повторить возврат» не вернёт товары дважды.

## Отзыв устройства

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

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

## Если что-то не так

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