# Подключённые кассы Mercury-POS

**Раздел:** **Розница** (roznitsa.md)

Здесь настраиваются кассовые компьютеры, на которых установлена программа Mercury-POS. Каждый компьютер регистрируется отдельно: у него свой номер кассы, серийный номер и настройки обмена. На одном магазине может работать несколько касс. Через облако Mercury программа передаёт на них товары и цены, а получает от них чеки и Z-отчёты. Здесь же настраивается оплата по СБП через PayMaster и другие параметры кассовой программы.

## Как устроен обмен между программами
В Меркурии-ИИ вы ведёте товары, цены и складской учёт, а на кассовом компьютере работает отдельная программа **Mercury-POS**. Она предназначена непосредственно для работы кассира: продажи, расчёт с покупателями, закрытие смен и печать чеков.

Меркурий-ИИ не подключается к кассовому компьютеру напрямую. Обмен между программами происходит через **облачный сервер Mercury**. Он служит посредником: принимает данные от ERP и передаёт их установленным кассовым программам, а затем получает от них информацию о продажах.

### Что передаётся между программами
Обмен выполняется через интернет. Кассовая программа периодически связывается с облаком, проверяет наличие новых данных и отправляет накопленную информацию. Поэтому компьютер с Mercury-POS не обязан постоянно находиться на связи с окном Меркурия-ИИ.

### Как программа понимает, какой кассе предназначены данные
У каждой кассовой установки есть уникальный **серийный номер из 12 символов**. Он должен совпадать в двух местах: в карточке кассы в Меркурии-ИИ и в настройках Mercury-POS на кассовом компьютере.

По этому номеру облако определяет, какой именно кассе нужно передать прайс или команду. URL облачного сервера и ключ доступа выдаёт администратор инфраструктуры.

## Где найти список касс
Откройте **Розница → Справочники → Кассы Mercury-POS**. Здесь находятся все кассовые компьютеры, зарегистрированные для выбранного магазина.

Есть и второй способ открыть этот справочник: **Справочники → Кассы Mercury-POS**. В этом режиме можно просматривать кассы сразу всех магазинов компании, переносить их между складами и выполнять массовые операции.

Кнопка **?** в углу вкладки открывает эту инструкцию.

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

### Кассы текущего магазина
Если открыть справочник через меню **Розница**, программа покажет кассы только того склада, который выбран в верхней части Меркурия-ИИ.

### Кассы всех магазинов
Если открыть справочник через общее меню **Справочники**, в списке будут кассы всех магазинов компании.

Таким образом, если у компании несколько магазинов и в каждом установлено по несколько кассовых компьютеров, все они будут видны в одном общем списке.

## Список подключённых касс
В таблице отображаются зарегистрированные кассовые компьютеры. Каждая строка — отдельная установка Mercury-POS, а не магазин целиком. Если в магазине работают три кассовых компьютера, в справочнике должны быть три отдельные записи.

Над таблицей находятся кнопки управления, а внизу — переключение между страницами списка. Если касс ещё нет или поиск не дал результатов, программа покажет сообщение **«Касс нет»**.

Чтобы добавить новую кассу или изменить существующую, откройте её карточку. Для этого можно выделить строку и нажать **Изменить** либо дважды щёлкнуть по строке мышью.

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

## Действия со списком
Над таблицей расположены инструменты для управления кассами:

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

Поиск проверяет следующие данные:

Поиск не зависит от регистра букв. Например, запрос «касса» найдёт и «Касса», и «касса». При изменении запроса программа возвращается на первую страницу списка.

## Колонки таблицы
Состав таблицы можно настроить через меню **Колонки**. Оставьте только те сведения, которые нужны вам для повседневной работы. Ширину столбцов можно менять: для этого перетащите мышью границу между заголовками.

### В режиме одного магазина

### В режиме всех магазинов
В таблице появляются те же колонки, но дополнительно отображается **Склад** — название магазина, к которому привязана касса.

Выбранная строка подсвечивается. Двойной щелчок по ней открывает карточку кассы.

## Перемещение по списку с клавиатуры
Если таблица активна, можно перемещаться между кассами с помощью клавиатуры:

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

Горячие клавиши работают, когда активна сама таблица. Если курсор находится в поле ввода, списке или на кнопке, стрелки работают как обычно для этого элемента и не переключают выбранную кассу.

## Карточка кассы
Карточка описывает один конкретный кассовый компьютер с установленной программой Mercury-POS. Здесь указываются его принадлежность к магазину, номер, серийный номер и дополнительные настройки.

При создании новой записи заголовок карточки будет **«Новая касса»**, при изменении существующей — **«Изменить кассу»**.

В карточке есть основная часть с настройками и боковая колонка со ссылкой на установщик Mercury-POS и видео по установке.

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

**Важно:** серийный номер должен содержать ровно 12 символов. Пока он не заполнен полностью, блок команд облака в карточке не отображается. Проверьте, чтобы номер в Меркурии-ИИ и на кассовом компьютере совпадал символ в символ.

### PayMaster — оплата по СБП
В этом блоке настраивается приём оплаты по СБП через PayMaster. Для каждой кассы используется собственный QR-стикер, который заранее создаётся в личном кабинете PayMaster и размещается рядом с кассовым компьютером.

Речь идёт о статическом QR-коде на табличке: касса передаёт сумму покупки, а покупатель сканирует QR-код своим банковским приложением. Кассовая программа проверяет, прошла ли оплата.

Настройки PayMaster передаются в Mercury-POS вместе со следующим прайсом. Поэтому после изменения стикера, merchantId или токена обязательно **отправьте прайс на кассу**.

Если параметры PayMaster уже заданы для оплаты интернет-витрины, merchantId и токен можно не дублировать в каждой карточке кассы. Подробнее — в инструкции **«PayMaster для витрины»** (vitrina-oplata-paymaster.md).

### Автоматическая загрузка чеков и дополнительные настройки

## Команды для кассовой программы
Если касса уже зарегистрирована и её серийный номер заполнен полностью, в карточке появляется блок **«Команды облака Mercury-POS»**.

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

Команды отправляются в облако, а не выполняются непосредственно на компьютере из окна Меркурия-ИИ. Кассовая программа получит запрос при следующем обмене с облаком.

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

### Установка Mercury-POS
В боковой части карточки находится справочная информация для установки кассовой программы. Эти сведения не сохраняются в карточке кассы.

### Сохранение изменений
Если сохранить данные не удалось, программа покажет сообщение об ошибке. Проверьте указанные значения и повторите сохранение.

## Восстановление чеков, Z-отчётов и получение лога
Из карточки кассы можно отправить три вида запросов в облако: восстановить чеки, восстановить Z-отчёты или получить лог кассовой программы.

При нажатии соответствующей кнопки откроется окно, в котором нужно указать период или дату.

### Восстановление чеков и Z-отчётов
Для восстановления данных задайте начало и конец периода:

Команда отправляется в облако отдельно для каждого дня выбранного интервала.

### Получение лога
Для запроса журнала работы кассовой программы нужно указать одну дату. Период в этом случае не задаётся.

Когда файл лога будет подготовлен, программа предоставит ссылку для его открытия в новой вкладке. Лог может пригодиться при разборе проблем с обменом или работой Mercury-POS.

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

## Окно обмена с облаком
При отправке прайса, загрузке чеков и выполнении других операций через облако открывается окно **«Облако Mercury-POS»**. В нём отображается ход выполнения операции.

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

## Установка и настройка Mercury-POS на кассовом компьютере
Mercury-POS — отдельная программа, которую нужно установить непосредственно на компьютер, используемый кассиром. Для каждого такого компьютера создаётся собственная запись в справочнике касс Меркурия-ИИ.

### Порядок установки

### Как сопоставить номера
В настройках Mercury-POS используются два номера, которые важно не перепутать:

Серийный номер — отдельный идентификатор из 12 символов. Он также должен совпадать с записью в Меркурии-ИИ.

**Чеки не приходят в Меркурий-ИИ?**

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

Если чеки нужно восстановить, отправьте команду **«Восстановить чеки»**. После этого дождитесь нового сеанса продаж или перезапустите Mercury-POS. Затем на вкладке «Розница» нажмите **«Загрузить Z-отчёты и чеки»**, чтобы получить данные из облака в журналы Меркурия-ИИ.

## Отправка товаров и цен на кассы
Чтобы кассовые компьютеры могли продавать актуальные товары, из Меркурия-ИИ нужно отправить на них прайс. В нём находятся товары, цены и дополнительные настройки, необходимые программе Mercury-POS.

Для каждой кассы формируется архив `PRICE-new.zip`. Внутри находится база данных SQLite с каталогом товаров и настройками кассовой программы.

### Какие товары попадают в прайс
На кассу выгружаются товары, у которых в прайс-листе **текущего склада** (marketing.md) установлена расходная цена **больше нуля**.

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

### Передача признака маркировки
Для маркированных товаров есть дополнительное условие. Чтобы признак маркировки попал в кассовую программу, в карточке соответствующего склада на вкладке **«Касса»** должен быть указан токен API «Честный знак».

Если токен не задан, весь ассортимент этого склада выгружается на кассы как немаркированный. В таком случае одной отметки «Маркируемый товар» в карточке товара недостаточно.

### Отправка прайса на кассы текущего магазина
Вместе с прайсом передаётся файл `ver1.ver` с датой обновления. После успешной отправки дата обновляется в колонке **«Прайс обновлён»** и в карточке кассы.

### Отправка прайса на все магазины
Если нужно обновить данные сразу во всей компании, откройте справочник касс в режиме **всех складов** и нажмите **Отправить всем прайс**.

Меркурий-ИИ последовательно обработает магазины, у которых есть зарегистрированные кассы. Для каждого склада будет сформирован отдельный прайс с его товарами и ценами. Затем файлы будут отправлены соответствующим кассовым компьютерам.

### Что ещё входит в прайс
Помимо товаров и цен, в архив передаются дополнительные данные для работы Mercury-POS:

## Выгрузка прайса на USB-флешку
Если кассовый компьютер не может получить прайс через интернет или нужно обновить его вручную, можно скачать архив на компьютер и перенести его на кассу с помощью USB-флешки.

Для этого на вкладке **Розница** нажмите **Скачать прайс локально**.

Программа сформирует ZIP-архив с тем же содержимым, что и при отправке через облако для текущего склада: товары, цены, операторы, округление, дисконтные карты и другие настройки.

Разница только в способе доставки: при локальной выгрузке файл скачивается на ваш компьютер, а не отправляется в облако. Дальше его можно перенести на кассовый компьютер вручную.

## Операторы кассовой программы
Пользователи, которые работают в Mercury-POS, ведутся отдельно от обычных пользователей Меркурия-ИИ. Для них предусмотрен справочник **«Операторы касс»** (operatory-kass.md).

При формировании прайса операторы текущего склада автоматически включаются в него. В кассовой базе они записываются в таблицу `users` внутри файла `PRICE-new.DB`.

Если вы изменили список операторов и не хотите заново отправлять весь прайс, можно воспользоваться отдельной кнопкой **«Отправить на кассы»** в журнале операторов. В этом случае данные передаются отдельным файлом `newoperat.s3`.

Подробнее о создании и настройке пользователей кассовой программы — в инструкции **«Операторы касс»** (operatory-kass.md).

## Как работает оплата через PayMaster
Mercury-POS поддерживает оплату по СБП через PayMaster с помощью QR-кода на физической табличке рядом с кассой.

Это не QR-код, который касса каждый раз генерирует на экране. Используется заранее созданный и распечатанный статический QR-код. Кассовая программа передаёт сумму покупки в PayMaster, а покупатель сканирует табличку и оплачивает заказ через банковское приложение.

### Настройка оплаты

### Как проходит оплата
**Важно: у каждой кассы должна быть собственная табличка и свой Id стикера.** Нельзя использовать один и тот же QR-код на двух кассах. Если обе кассы будут отправлять суммы на один стикер, новый платёж может заменить предыдущий.

## Дисконтные карты
Если магазин использует дисконтные карты, их данные можно передавать в Mercury-POS вместе с прайсом.

Карты ведутся в разделе **Розница → Дисконтные карты** (diskontnye-karty.md). В прайс попадают номер карты, ФИО владельца и процент скидки. В кассовой базе эти данные записываются в таблицу `bd_disc_card`.

Чтобы карты передавались на кассу, у соответствующего склада должна быть включена настройка **«Разрешить дисконтные карты»**.

Если вы добавили новые карты, изменили существующие или включили эту настройку, отправьте прайс на кассы ещё раз. Только после обновления прайса кассовая программа получит актуальный список.

## Дисконтная программа
Если в Меркурии-ИИ включена **дисконтная программа** (loyalty.md), при отправке прайса на кассы вместе с товарами передаются и параметры, необходимые Mercury-POS для работы с бонусным балансом и API программы.

Настройки записываются в базу прайса, в таблицу `bd_params`. Для каждого склада автоматически формируются следующие значения:

Если адрес API не задан, кассовая программа использует старый адрес `https://skidkabot.ru`.

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

**После первого включения дисконтной программы обязательно отправьте прайс на все кассы.** До обновления прайса кассовые компьютеры не получат новые параметры.

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

При удалении из справочника исчезает только запись о подключённой кассе. **Сами чеки и Z-отчёты не удаляются.** Исторические документы сохраняются в журналах, но связь с удалённой кассой у них больше не будет отображаться.

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

## Полезные инструкции