Инструкция администратора

История изменений

1. Введение

Метафора Касса — это программное обеспечение для автоматизации торговых точек с поддержкой маркировки товаров через систему «Честный знак».

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

ПО Метафора Касса состоит из двух компонентов:

• Касса — клиентское приложение, устанавливаемое на каждую кассу;
• Сервер — серверное приложение, устанавливается на выделенную рабочую станцию или сервер. Допускается установка на одну из касс.

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

Перед началом установки рекомендуется ознакомиться с разделом 3. Выбор топологии развёртывания и определить подходящую схему для вашей инфраструктуры.

2. Требования к системе

Минимальные системные характеристики для установки и стабильной работы серверной части — Метафора Сервер:

Минимальные системные характеристики для установки и стабильной работы клиентской части — Метафора Касса:

2.1. Списки используемых сетевых соединений:

• Сервер лицензирования: https://license.m-tsr.ru:443
• Для работы с маркированным товаром список хостов и портов содержится в инструкциях к ТС ПИоТ.

3. Выбор топологии развёртывания

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

3.1. Всё-в-одном

Сервер и касса установлены на одном компьютере.

Подходит для: одной кассы в одной торговой точке в малом бизнесе.

Плюсы:

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

Риски:

• Нет резервирования или обмена данными с внешней системой.
• Выход ПК из строя без резервирования означает одновременную потерю данных, кассы и сервера.

Рекомендации:

• Обеспечьте резервирование БД PostgreSQL на внешний ресурс для восстановления в случае выхода из строя.

Для нескольких магазинов:

• Ручной импорт и экспорт товаров для ручного управления номенклатурой доступен. Можно синхронизировать данные файловым обменом и загрузкой вручную или собственными средствами автоматизации.

3.2. Классическая

Сервер установлен на отдельном ПК (далее — сервере) в торговой точке. Кассы подключаются к нему по локальной сети через API URL.

Подходит для: любого количества касс в одной торговой точке.

Плюсы:

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

Риски:

• Выход из строя сервера или проблемы в локальной сети магазина приводят к остановке продаж на всех кассах.

Рекомендации:

• Обеспечьте резервирование БД PostgreSQL на внешний ресурс для восстановления в случае выхода из строя сервера.
• Установите источник бесперебойного питания (UPS) на сервер.
• Обеспечьте надёжную локальную сеть между кассами и сервером.

Для нескольких магазинов:

• Ручной импорт и экспорт товаров для ручного управления номенклатурой доступен. Можно синхронизировать данные между серверами файловым обменом и загрузкой вручную или собственными средствами автоматизации.

3.3. Классическая с 1С как центральной системой

Для каждой торговой точки устанавливается отдельный Метафора Сервер. 1С выступает центральной системой управления: передаёт номенклатуру, цены, акции и программу лояльности на каждый сервер.

Подходит для: торговых сетей с произвольным количеством касс с действующей системой 1С.

Плюсы:

• Управление номенклатурой, ценами, программой лояльности, акциями и отчётность ведутся привычно в 1С.
• Обмен данными между Метафора Сервер производится с помощью 1С.
• При потере связи 1С с Метафора Сервер продажи на точке не прекращаются, временно приостанавливается обмен по чекам, товарам и лояльности.
• Для менеджера магазина доступна информационная составляющая Метафора Сервер, отчетность, управление пользователями.

Риски и рекомендации топологии Классическая актуальны и для данной топологии.

3.4. Единый сервер в офисе компании, облаке или ЦОД

Метафора Сервер размещён в облаке (Метафора или клиента) или в центральном офисе клиента. Кассы обращаются к серверу через интернет.

Плюсы:

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

Риски:

• Разрыв интернет-соединения приводит к остановке продаж на всех кассах.

Рекомендации:

• Организуйте резервный канал связи (например, 4G-роутер).
• Настройте мониторинг интернет-канала.

4. Подготовка к установке

4.1. Установка PostgreSQL

Для работы Метафора Сервер требуется установленная база данных PostgreSQL.

Скачивание установщика

• Перейдите на официальный сайт PostgreSQL:
  https://www.postgresql.org/download/windows.
• Нажмите Download the installer.
• Выберите и загрузите последнюю стабильную версию.

Установка

• Запустите установочный файл от имени администратора:
• Щелкните правой кнопкой по файлу установщика.
• Выберите Запуск от имени администратора.
• В появившемся окне нажмите Next.
• Убедитесь, что все предлагаемые компоненты выбраны. Нажмите Next.
• Укажите путь установки или оставьте значение по умолчанию. Нажмите Next.
• Задайте пароль для пользователя postgres (запомните его — он потребуется позже). Нажмите Next.
• Оставьте локаль по умолчанию. Нажмите Next.
• Укажите порт подключения (по умолчанию: 5432). При необходимости — измените. Нажмите Next.
• Проверьте параметры установки и нажмите Next.
• Начнётся установка. Дождитесь её завершения.
• Откажитесь от запуска Stack Builder, уберите галочку и нажмите Finish.

Завершение

PostgreSQL установлен и готов к использованию. Запомните логин, пароль и порт для подключения, указанные во время установки — они понадобятся при настройке Метафора Сервер.

Резервное копирование базы данных

Рекомендуется настроить регулярное резервное копирование для защиты данных.

• Используйте утилиту pg_dump для создания резервных копий или иное программное обеспечение для резервирования данных.
• Настройте расписание резервирования. Для pg_dump это можно сделать средствами Планировщика Windows. Рекомендуемая частота — ежедневно.
• Храните резервные копии на отдельном физическом носителе или в сетевом хранилище.

4.2. Установка локального модуля «Честный знак»

Локальный модуль «Честный знак» (ЛМ ЧЗ) необходим для проверки маркированной продукции в офлайн-режиме. Можно установить на любое устройство в локальной сети, доступное с касс Метафора. Допускается установка на том же устройстве, где работает Метафора Сервер или на любую из касс, также возможна установка на каждой кассе торговой точки.

Режимы работы с «Честным знаком»

Проверка кодов маркировки выполняется через компонент ТС ПИоТ в одном из двух режимов:

• Онлайн-режим — система обращается с помощью компонента ТС ПИоТ к серверам «Честного знака» через интернет. Используется при наличии стабильного соединения.
• Локальный модуль — система обращается с помощью компонента ТС ПИоТ к локально установленному модулю, хранящему актуальную базу кодов маркировки. Применяется при отсутствии интернета.

Скачивание установщика

• Перейдите на официальный сайт:

https://честныйзнак.рф/local-module

• Выберите подходящую версию для вашей операционной системы.
• Скачайте установочный файл.

Установка

• Запустите установочный файл.
• В первом окне нажмите Далее.
• Создайте профиль администратора, укажите для него имя (логин) и пароль для доступа к локальному модулю. Нажмите Далее.

• Выберите папку установки или оставьте путь по умолчанию. Добавьте сервисы Локального Модуля в автозапуск, убедитесь, что установлена галочка. Нажмите Далее.
• Укажите адрес сервера «Честного знака» для обновления Локального модуля:
• Продуктивный контур — https://rsapi.crpt.ru
• Тестовый контур — https://suz-rsapi.sandbox.crptech.ru

Нажмите Далее.

• Если у вас используется прокси для выхода в сеть Интернет, укажите их в соответствующие поля и нажмите Далее.
• Нажмите Начать для запуска установки.
• По завершении нажмите Готово.

Завершение

Локальный модуль «Честный знак» успешно установлен и готов к использованию. Запомните имя профиля (логин) и пароль, указанные во время установки — они понадобятся при настройке компонента ТС ПИоТ и Метафора Касса.

5. Установка Метафора Сервер

Метафора Сервер является основным компонентом системы и должен быть установлен до первого запуска клиента Метафора Касса

Запуск установщика

• Найдите файл установщика (где X.Y.Z — актуальный номер версии), например: metafora-server-X.Y.Z.exe.
• Щелкните правой кнопкой мыши по файлу.
• Выберите Запуск от имени администратора.

Установка

• В окне мастера нажмите Далее.
• Ознакомьтесь с лицензионным соглашением и нажмите Принимаю условия, затем Далее.
• Выберите каталог установки или оставьте путь по умолчанию. Нажмите Установить.
• Дождитесь завершения установки.
• Установите флажок Запустить POS Server и нажмите Готово.

Завершение

Метафора Сервер установлен и готов к первому запуску.

6. Первый запуск Метафора Сервер и активация

После установки всех компонентов необходимо провести первичную настройку Метафора Сервер.

6.1. Запуск и авторизация

Запуск Метафора Сервер

• Найдите значок Метафора Сервер в меню «Пуск» или на рабочем столе и запустите его.
• В системном трее (в панели задач) нажмите стрелку Показать скрытые значки.
• Щёлкните значок Метафора Сервер и выберите Настройки.

Настройка соединения с PostgreSQL

• Убедитесь, что указан правильный порт, тот на котором работает PostgreSQL (по умолчанию: 5432).
• Введите имя пользователя: postgres.
• Введите пароль, заданный при установке PostgreSQL.
• Нажмите Сохранить.

Запуск сервера и админ-панели

• После сохранения Настроек сервер запускается автоматически.
• Управлять запуском или остановкой сервера можно в системном трее.
• Выберите значок Метафора Сервер, нажмите Запустить сервер или Остановить сервер.
• После запуска снова нажмите на значок и выберите Открыть админ-панель.
• В браузере откроется страница авторизации на сервере.
• Учетные данные администратора по умолчанию:
• Логин: root
• Пароль: password

6.2. Активация и обновление лицензии

Активация лицензии

При первом запуске, после авторизации, система покажет страницу с информацией о том, что лицензия неактивна:

Если сервер подключён к интернету:

• Скопируйте значение из поля UUID.
• Используя логин и пароль, которые вы получили вместе с лицензией, перейдите в свой Личный кабинет по адресу https://license.m-tsr.ru.
• На главной странице найдите плитку с вашей лицензией и нажмите на нее или кнопку Подробнее.

• На вкладке Узлы нажмите на кнопку Добавить узел.
• Введите UUID устройства и нажмите кнопку Добавить узел.
• Вернитесь к вашему серверу на первый шаг и нажмите кнопку Онлайн активация.

Если интернет в момент активации отсутствует:

• Нажмите Офлайн активация → Скачать Ключ-Запрос.
• Скопируйте файл на внешний носитель (например, флешку).
• Подключите флешку к устройству с доступом к интернету.
• Используя логин и пароль, которые вы получили вместе с лицензией, перейдите в свой Личный кабинет по адресу https://license.m-tsr.ru.
• На главной странице найдите плитку с вашей лицензией и нажмите на нее или кнопку Подробнее.
• На вкладке Узлы нажмите на кнопку Добавить узел.
• В разделе Ключ запроса выберите файл сохраненный на флешку и нажмите кнопку Добавить узел.
• После этого будет скачан файл активации лицензии, сохраните его также на флешку, вернитесь к вашему серверу и нажмите кнопку Загрузить Лицензию.
• Выберите файл активации лицензии сохраненный на флешку, после этого вы будете направлены на страницу Лицензии на сервере.

Обновление лицензии

Если лицензия ещё не истекла, и вы уже оплатили продление лицензии:

• Перейдите в Система → Лицензии.
• Нажмите Продлить лицензию.

Если лицензия уже истекла:

• Действуйте в соответствии со стандартным процессом активации, описанным ранее.

7. Подготовка Метафора Сервер для запуска и базовой проверки Метафора Касса

7.1. Типы цен

Для настройки первого магазина необходимо указание двух типов цен:

• Тип первой цены — цена, используемая для учёта исходной стоимости товара (например, цена по которой товар впервые поступил в продажу)
• Тип розничной цены — цена, по которой товар будет добавлен в чек на кассе.

Розничная цена может совпадать с первой, когда товар только вводится в продажу — это основной сценарий. Впоследствии, если сделать Розничную цену для товара меньше Первой, то на кассе для кассира и покупателя на дисплее покупателя будет отражена данная разница.

В системе можно создавать произвольное количество Типов цен для разных бизнес-сценариев.

7.2. Создание первого магазина на сервере

Для входа в кассу ее потребуется привязать к магазину, поэтому его предварительно необходимо создать.

• Перейдите в Система → Магазины админ-панели.
• Нажмите Добавить магазин.
• Заполните необходимые поля.
• Нажмите Добавить.

7.3. Создание пользователей и управление ролями на сервере

В системе после установки создан пользователь root, его невозможно удалить. Рекомендуем изменить пароль этого пользователя и сохранить новый пароль в надёжном месте.

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

Система позволяет назначить на пользователя несколько ролей. Таким образом в зависимости от сценариев в вашем бизнесе можно создать одного пользователя и назначить на него все три роли. Или назначить каждую роль произвольному количеству пользователей.

Создание пользователей

• Перейдите в Пользователи в админ-панели.
• Нажмите Добавить пользователя.
• Заполните Имя пользователя, Пароль, Имя и Фамилию .
• Выберите одну или несколько Ролей и Магазин.
• По завершении нажмите Добавить.

Требования к паролям

Для управления уровнем безопасности возможно задавать минимальные правила для сложности или сроку паролей. Управлять этим можно в Настройках:

• Перейдите в Система → Настройки в админ-панели. И перейдите на вкладку Безопасность и нажмите на иконку карандаша напротив параметра user_security (группа настроек парольной политики).
• Отредактируйте необходимые параметры и нажмите Сохранить.

Управление ролями

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

7.4. Добавление первого товара

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

• Перейдите в раздел Товары в навигации админ-панели.
• Нажмите Добавить товар.
• Откроется форма с двумя вкладками: Основная информация и Цены.

Вкладка Основная информация

Дополнительные поля:

• Превью — фотография товара (опционально). Нажмите Выбрать Фото для загрузки.
• Цвет — цветовая метка для удобства поиска (опционально).
• Статус — оставьте Активный для доступности на кассе.

Вкладка Цены

• Перейдите на вкладку Цены.
• Добавьте строки Первая цена и Розничная цена — введите значение в поле Цена.
• Для удаления лишней строки цены нажмите иконку корзины справа.
• Нажмите Добавить.

8. Подготовка Метафора Касса для запуска и базовой проверки

8.1. Установка Метафора Касса на кассовом ПК

Запуск установщика

• Найдите файл установщика (где X.Y.Z — актуальный номер версии), например: metafora-pos-X.Y.Z.exe.
• Щелкните правой кнопкой мыши по файлу.
• Выберите Запуск от имени администратора.

Установка

• В окне мастера нажмите Далее.
• Ознакомьтесь с лицензионным соглашением и нажмите Принимаю условия, затем Далее.
• Выберите каталог установки или оставьте путь по умолчанию. Нажмите Установить.
• Дождитесь завершения установки.
• По завершении нажмите Готово.

Завершение

Метафора Касса установлена и готова к первому запуску.

8.2. Подготовка к работе ККТ Атол

Перед первым запуском кассы убедитесь, что ККТ физически подключена к ПК и прошла фискальную регистрацию в ФНС (выполняется сервисным инженером или через личный кабинет ФНС).

Предварительные условия

• ФН (фискальный накопитель) установлен и ККТ и зарегистрирован в ФНС.
• Данные ОФД (оператора фискальных данных) известны, обмен с ОФД настроен и работает.
• ККТ подключена к ПК (USB или COM-порт).

Интеграция между Метафора Касса и драйвером ККТ Атол реализована через службу Web Requests. После подключения ККТ к ПК необходимо установить последнюю версию драйвера ККТ Атол.

Служба Web Requests требует дополнительной лицензии Атол для работы такой интеграции, но при этом лицензия является бесплатной, если используется 1 ККТ на 1 кассу.

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

• При установке драйвера убедитесь, что для установки выбран компонент Web Requests (по умолчанию он выключен).

• На последнем шаге выберите Запустить и настроить Web Requests.

• Далее откроется окно браузера по адресу: http://127.0.0.1:16732
• Для работы службы требуется создать пользователя этой службы.
• Откройте командную строку Windows или PowerShell от имени Администратора.
• Последовательно выполните:

• где user и password — это ваши логин и пароль, которые вы будете использовать дальше для работы со службой, запомните их;
• путь к драйверу может отличаться в зависимости от вашего выбора при установке драйвера ККТ Атол или разрядности ОС Windows.
• Далее настройка описана в разделе Первый запуск Метафора Касса.
• Больше информации о службе и ее актуальную документацию вы можете найти по ссылке https://app.swaggerhub.com/apis-docs/atol-dev/fptr-web-requests/1.0.4.0.

8.3. Подготовка к работе ТС ПИоТ. ЕСМ (АО «ЕСП»)

• ТС ПИоТ — Техническое Средство Получения Информации о Товаре.
• ЕСМ — Единый Сервисный Модуль. Компонент ТС ПИоТ от АО «ЕСП», который выполняет проверку кодов маркировки.

Модуль устанавливается на каждой кассе торговой точки и выступает посредником: касса отправляет запрос в ТС ПИоТ, тот проверяет код в онлайн режиме в ГИС МТ ЦРПТ «Честный знак» и возвращает статус товара. Если связи временно нет, то перенаправляет запрос в Локальный модуль «Честного знака» и возвращает его ответ.

8.4. Подготовка к работе интегрированных EFT (банковских терминалов)

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

• EFT — Electronic Funds Transfer, электронный перевод денежных средств.
• Интегрированный терминал — когда касса и терминал единая система. Когда кассир нажимает «Оплата картой», сумма автоматически уходит на терминал. После того как покупатель приложил карту и банк ответил, результат (одобрено / отказано) возвращается обратно в кассу. Кассир ничего не вводит вручную.
• Неинтегрированный терминал — когда касса и терминал не подключены друг к другу, два абсолютно независимых устройства, которые ничего друг другу не передают. Кассир видит сумму на экране кассы, вручную набирает её на терминале, покупатель платит. После этого кассир сам нажимает «Готово» в кассе.

В общем случае подключение и настройка терминала производится сервисной компанией или представителем банка, в котором заказана услуга эквайринга. В Метафора Касса по умолчанию включена опция неинтегрированного терминала, для включения интеграции со Сбером или Альфа-Банком необходимо в Настройках кассы выбрать необходимую опцию. Подробности в разделе Первый запуск Метафора Касса.

8.5. СБП — Система быстрых платежей

Оплата через СБП позволяет покупателю расплатиться, отсканировав QR-код в приложении банка.

Метод визуализации QR-кода для покупателя

В зависимости от сценария и набору настроенной периферии есть несколько вариантов отображения QR-кода:

• На экране дисплея покупателя. Если полноцветный дисплей покупателя (второй монитор) входит в тариф, подключен и выбран в настройках Метафора Касса.
• Печать на ККТ. В случаях, когда дисплей покупателя недоступен, QR-код печатается и передается покупателю для сканирования.
• На экране КСО. При сценарии самообслуживания покупателя.

Получение реквизитов

Для подключения СБП необходимо получить реквизиты у платёжного агрегатора Paymaster:

• Merchant ID — идентификатор торговца.
• Секретный ключ — для подписи запросов.

Обратитесь к менеджеру в Paymaster или в службу поддержки агрегатора. После получения реквизитов внесите их в настройки кассы в поле СБП. Подробности в разделе Первый запуск Метафора Касса.

• На экране авторизации нажмите на кнопку Пуск в правом верхнем углу и далее нажмите Настройки кассы.
• Введите логин и пароль пользователя, у которого есть доступ к Настройкам приложения в соответствии с настройкой Ролей.
• Нажмите Продолжить.

На следующем экране заполните:

• Нажмите Сохранить. После этого информация по кассе с ее уникальными UUID передаются на сервер. Вы увидите сообщение о том, что касса не привязана к магазину. Далее необходимо выполнить последний шаг на сервере.

8.6. Привязка кассы к магазину

После установки приложения Метафора Касса на кассовый ПК и его первичной настройки кассу необходимо привязать к необходимому магазину на сервере:

• Зайдите в админ-панель и авторизуйтесь.
• Перейдите в Система → Кассы.
• Нажмите на нужную кассу (по ID или иконке карандаша).
• В выпадающем списке выберите магазин.
• Нажмите Сохранить.

Установка завершена

Комплекс ПО Метафора Касса успешно установлен и готов к первому запуску и проверке.

9. Настройки Метафора Сервер

Все настройки доступны в разделе Система → Настройки админ-панели. Параметры в инструкции сгруппированы по функциональным блокам.

9.1. Поведение кассы

9.2. Базовая программа лояльности (БПЛ)

9.3. Интеграция с 1С для обмена товарами и чеками

9.4. Программа лояльности 1С

Используется при интеграции с внешней системой лояльности на базе 1С. Не применяется при работе с базовой программой лояльности (см. п.9.2)

9.5. Подарочные сертификаты 1С

9.6. SMS-уведомления

Используются для отправки OTP-кодов через сервис SMS Traffic - https://smstraffic.ru u при списании бонусов (интеграция с 1С).

9.7. Безопасность

10. Настройка интеграции с 1С

Раздел описывает настройку обмена на стороне 1С. Интеграция реализована как расширение конфигурации «Metafora POS» — оно содержит всю бизнес-логику обмена с POS-сервером (выгрузка ассортимента, приём чеков, лояльность). Расширение дополняет параметры подключения, задаваемые в Метафора Сервер: сервер хранит адрес и токен, а 1С формирует выгрузку ассортимента и принимает чеки.

Поддерживаемые типовые конфигурации:

• Розница, ред. 2.3 (включая «Магазин одежды и обуви»),
• Розница 3.0,
• Управление нашей фирмой 3.0,
• Управление торговлей 11

Настройка выполняется в два этапа: в режиме Конфигуратора и в пользовательском режиме.

10.1. Подключение расширения «Metafora POS»

Конфигурация → Расширения конфигурации → Добавить новое расширение.

В окне Новое расширение указать:

• Имя MetaforaPOS,
• Синоним Metafora POS,
• Префикс mpos_,
• Назначение «Дополнение».

Затем Конфигурация → Загрузить конфигурацию из файла → файл MetaforaPOS.cfe.

Согласиться на обновление конфигурации базы данных (F7). После загрузки расширение должно быть «Активно».

10.2. Публикация базы 1С на веб-сервере

Публикация открывает POS-серверу HTTP-доступ к данным 1С. Предварительно на машине с сервером 1С устанавливается веб-сервер (например, Apache).

• Запустить 1С от имени администратора.
• Администрирование → Публикация на веб-сервере.
• На вкладке HTTP-сервисы указать имя базы (латиницей), тип веб-сервера и каталог.
• Установить галочки на всех сервисах и «Публиковать HTTP-сервисы расширений по умолчанию».
• Нажать «Опубликовать».

После публикации доступ возможен по адресу https://<IP>:<port>/<base>/<method>:

10.3. Справочник «Кассовые сервера»

Описывает подключение к каждому POS-серверу (пользовательский режим, справочники расширения «Metafora POS»).

10.4. Справочник «Правила определения ассортимента»

Определяет, какие товары попадают в выгрузку.

Варианты отбора по остаткам:

• Только с остатками или движениями за N месяцев — товары, имеющие остаток сейчас либо движения за последние N месяцев.
• Только с остатками — только товары с текущим остатком.
• Без ограничений — выгружаются все товары.

10.5. Справочник «Правила соответствия объектов»

Сопоставляет объекты 1С с объектами POS-системы. Группы соответствий:

Магазины: Магазин · Id pos · Розничные цены (текущая цена реализации) · Первые цены (зачёркнутая цена на ценнике) · Организация · Помещение (склад торгового зала).

Кассы POS: Id pos · Магазин · Касса ККМ в 1С.

Эквайринговые терминалы: id Pos (серийный номер кассы) · Магазин (обязательно — во избежание коллизий при перемещении терминала) · Эквайринговый терминал.

Виды оплаты: id Pos · Вид оплаты.

Причины возвратов: id Pos (на данный момент «Истина» = брак, «Ложь» = иная причина) · Причина возврата. Группа отсутствует в конфигурациях, где в чеке нет указания причины возврата.

Пользователи: Id pos · Пользователь (кассир/продавец). Требования к настройке пользователей зависят от конфигурации 1С.

Склады: список складов, по которым выгружаются остатки.

Дополнительно: «Скидка для корректировки расхождения сумм чека» — элемент справочника, применяемый при устранении разницы сумм чека POS и 1С.

10.6. Регламентные задания обмена

Автоматизируют обмен. Настраиваются через внешнюю обработку mpos_Регламенты — она предоставляет интерфейс для настройки расписания, однако вся бизнес-логика обмена реализована в расширении Metafora POS. Обработка лишь вызывает методы расширения.

1. Добавить обработку: Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки.
2. Настроить расписание для каждой задачи и сохранить настройки.
3. Форму ручного запуска опубликовать нужным пользователям (раздел задаётся в реквизите «Размещение»).

Автоматизируемые процессы:

• Выгрузка ассортимента, цен и остатков
• Загрузка продаж за прошлый день с формированием ОРП
• Загрузка продаж за текущий день с формированием ОРП
• Загрузка чеков продаж за текущий день
• Обработка очереди сообщений POS

10.7. Работа с функционалом обмена

Обработка «mpos. Обмен с сервером POS»

Ручной обмен между 1С и POS-сервером с контролем каждого этапа: загрузка → сопоставление → формирование документов.

Параметры загрузки: POS-сервер · Период · Магазин · «Обновлять сводные документы за день» · «Отключить типовую проверку заполнения чеков».

Команды: Получить данные POS (заполнение таблиц обработки) → Подобрать данные POS (сопоставление по правилам соответствия) → Создать/обновить данные 1С (формирование документов).

Регистр сведений «mpos. Сообщения POS»

Накапливает сообщения о новых кассовых операциях от POS для последующей загрузки. Реквизиты: идентификатор сообщения, кассовый сервер, дата сообщения, тип сообщения, тело (id операции в JSON), дата обработки, признак и описание ошибки.

Обработку можно запустить вручную из формы списка: «Запустить обработку сообщений» (все необработанные) или «Обработать сообщение» (выбранное). При включённой константе «Обрабатывать сообщения POS при получении» необработанные сообщения обрабатываются автоматически при поступлении нового.

Справочник «mpos. Логи»

История обмена. Записи формируются только по серверам с признаком «Вести лог». Содержит общие реквизиты (кассовый сервер, даты начала/завершения, длительность, ответственный, признак ошибки), вкладки «Запрос» и «Ответ» (метод, тело, заголовки, код состояния: 2xx — успех, 4xx — ошибка клиента, 5xx — ошибка сервера). Пакетные запросы группируются по родительскому — для просмотра развернуть родительский элемент.

10.8. Особенности для разных типовых конфигураций

Требование к данным пользователя (реквизит «Продавец» в «Чек ККМ»):

Устранение разницы сумм чека (POS против рассчитанного в 1С) — добавлением скидки по позициям:

• Розница 2.3 / УТ 11: при ручных скидках — ручной, иначе автоматической; вид скидки — по настройке «Скидка для корректировки расхождения сумм чека» (для УТ 11 настройка обязательна; для Розницы 2.3 при отсутствии — «Округление в пользу покупателя»).
• Розница 3.0 / УНФ 3.0: всегда ручной скидкой, настройка отсутствует.

Выгрузка остатков: в «Розница 2.3» учёт ведётся по складам — выгружается остаток склада, указанного как «Помещение» магазина (реквизиты склада подменяются на реквизиты магазина). В остальных конфигурациях выгружаются данные складов.

Типы создаваемых документов по операциям POS:

11. Лицензирование и Тарификация функций

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

• Количество Касс в состоянии active по всем серверам в рамках одной лицензии.
• Количество Магазинов, используемых по всем серверам в рамках одной лицензии.
• Количество Пользователей в рамках одного сервера.
• Возможность создавать или редактировать Роли.
• Возможность использовать Программу лояльности, как Базовую, так и Расширенные интеграции, например с 1С.
• Возможность учета Складов, обмена информацией об остатках и визуализации этой информации на кассе.
• Возможность использования Полноцветного дисплея покупателя.

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

Учёт активных касс при превышении лимита лицензии.

Активной считается касса, которая имеет состояние active на сервере. При превышении лимита лицензии система автоматически оставляет активными N самых свежих по временной метке (timestamp) касс в пределах всего парка — учёт ведётся сквозным образом по всем кассам всех магазинов и серверов компании, а не по каждому серверу отдельно. Кассы с более старой временной меткой перехода в active деактивируются автоматически и при попытке работы потребуют повторной активации.

12. Управление обновлениями (OTA) Метафора Сервер и Метафора Касса

12.1. Принцип работы обновлений

Обновления доставляются последовательно по цепочке:

Сервер лицензирования → Метафора Сервер → Касса

Метафора Сервер автоматически проверяет наличие новых версий при наличии подключения к интернету. Со стороны вендора публикуются обновления только необходимой ветки для клиента, если это предусмотрено. В ином случае публикуется общий продуктивный релиз. Метафора Касса обращается за обновлениями на Сервер, к которому привязана.

12.2. Проверка наличия обновления

• Перейдите в Система → Обновления.
• Текущая версия и доступные обновления отображаются на странице.
• Нажмите Проверить обновления для принудительной проверки.

12.3. Установка и откат обновления Метафора Сервер

Обновление

Обновление для сервера скачивается на Метафора Сервер и установка обновления доступна из раздела Обновления. Запуск обновления производится вручную по решению пользователя. Доступ в Обновления регулируется соответствующей характеристикой доступа, доступной в настройке Ролей.

• В разделе Обновления нажмите Установить напротив предлагаемой версии сервера.
• Дождитесь завершения установки и автоматического перезапуска сервера.

Откат обновления

• Остановите серверное приложение: завершите процесс или службу pos-server.exe и процесс pos-server-desktop (через Диспетчер задач или services.msc).
• Найдите дистрибутив необходимой версии для отката.
• Можно найти локально в папке %ProgramData%\POSMetafora\storage\updates\pos_server.
• Или скачать из раздела Приложения Личного кабинета по адресу https://license.m-tsr.ru.
• Восстановить дамп БД PostgreSQL.
• Запустите инсталлятор из необходимого дистрибутива и установите Метафора Сервер поверх.
• Запустите Метафора Сервер, предыдущие настройки применятся.
• Проверьте состояние после отката.

12.4. Установка и откат обновления Метафора Касса

Обновление

Обновление для кассы скачивается на Метафора Сервер и установка обновления доступна из раздела Настроек кассы. Запуск обновления производится вручную с терминала по решению пользователя. Доступ в Настройки кассы регулируется соответствующей характеристикой доступа, доступной в настройке Ролей.

• На экране авторизации нажмите на кнопку Пуск в правом верхнем углу и далее нажмите Настройки кассы.
• Введите логин и пароль пользователя, у которого есть доступ к Настройкам приложения в соответствии с настройкой Ролей.
• Нажмите Продолжить.
• Прокрутите вниз страницы и нажмите Проверить обновления.
• После скачивания пакета обновления с сервера вы увидите сообщение, предлагающее Перезапустить и Установить обновление.
• После завершения процесса установки запустите Метафора Касса.

Откат обновления

• Выйдите из приложения Метафора Касса.
• Найдите дистрибутив необходимой версии для отката.
• Можно найти на сервере локально в папке %ProgramData%\POSMetafora\storage\updates\pos_terminal.
• Или скачать из раздела Приложения Личного кабинета по адресу https://license.m-tsr.ru.
• Скопируйте резервную копию локальной БД из папки %localappdata%\metafora-pos_backups в %appdata%\metafora-pos, обратите внимание что в конечном пути файл должен называться pos.db.
• Запустите инсталлятор из необходимого дистрибутива и установите Метафора Касса поверх.
• Запустите Метафора Касса, предыдущие настройки применятся.
• Проверьте состояние после отката.

13. Поддержка Метафора Касса и База знаний

Рекомендуем просмотреть раздел Помощь на сайте https://metafora-pos.ru или обратиться в службу поддержки по адресу электронной почты: sd@m-tsr.ru