Общие сведения

Для удобства использования все настройки Artix Control Center разделены тематически и доступны в отдельных пунктах меню "Настройки сервера".

Выберите необходимый пункт раздела "Настройки сервера":

На странице расположены:

1. Панель управления. Содержит функции: "Изменить" и "Обновить таблицу".
2. Таблица настроек. Список всех настроек.
3. Информационная панель. Содержит информацию о выбранной настройке: значение, ключ и тип.
4. Описание. Содержит название и кратное описание настройки.

Просмотр информации о параметре

Чтобы просмотреть информацию о параметре, выберите из списка нужный объект, в правой части экрана отобразится информация о настройке:

Добавление и редактирование параметра

Для добавления нового параметра нажмите кнопку "Добавить" .

Редактирование существующего параметра производится путем выбора объекта из таблицы и нажатия кнопки "Изменить" .

Внесите необходимые изменения и сохраните их:

На странице расположены:

• 1 – Кнопка выхода без сохранения.
• 2 – Кнопка сохранения изменений.

Чтобы включить/выключить параметр, нажмите на соответствующий переключатель .

Удаление параметра

Удаление существующего параметра производится путем выбора объекта из таблицы и нажатия кнопки "Удалить" .

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

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

При нажатии на ссылку в новой вкладке будет открыто окно редактирования объекта, уберите упоминание о параметре и сохраните изменения. Закройте сообщение, нажав кнопку , и повторите удаление параметра.

Обновление списка настроек

Чтобы актуализировать все данные в таблице, нажмите кнопку "Обновить таблицу" .

Справочники

• Выгружать справочники после создания объекта, принимающего справочники. Включение выгрузки справочников после создания объекта.
• Http-префикс для ссылки на справочник. Http-префикс для пути, который будет указан в теле сообщения как ссылка для скачивания при условии передачи справочников по http, есть поддержка макроподставновок `{host}` и `{port}`.
  
• Директория для помещения справочников (Http). Директория, в которую будут помещаться справочники при условии передачи справочников по http.
• Сигнал на кассу для мгновенного получения справочников. Посылать ли сигналы на кассу на получение справочников сразу после помещения сообщения в очередь.
  
• Включение записи логов по отправке справочника на кассу. Используется при передаче справочников через файловую систему. Если справочник передается через URL, а эта настройка не включена, то устаревшие справочники не будут перемещаться в архив.
• Количество одновременно выполняемых задач на генерацию справочников. По умолчанию разрешено одновременное выполнение 2-х задач. При изменении настройки требуется перезагрузка сервера.
• Количество одновременно выполняемых задач по отправке сигналов на кассы для загрузки справочников. По умолчанию разрешена одновременная отправка не более 4-х сигналов. При изменении настройки требуется перезагрузка сервера.
• Количество одновременно выполняемых задач по прогрузке справочников на весы. По умолчанию разрешена одновременная отправка не более 4-х сигналов. При изменении настройки требуется перезагрузка сервера.

Продажи

• Выгружать продажи при обнаружении закрытой смены. При включенной настройке Artix Control Center инициирует выгрузку продаж при обнаружении на кассе закрытой смены.
• Когда запрашивать продажи за прошлый период, если время последней неизвестно. Допустимые значения лежат в диапазоне от 0 до 336.
  
• Количество одновременно выполняемых задач на загрузку продаж. По умолчанию разрешено одновременное выполнение 2-х задач. При изменении настройки требуется перезагрузка сервера.

• Количество одновременно выполняемых задач по инициализации выгрузки продаж на кассе. По умолчанию разрешено одновременное выполнение 4-х задач. При изменении настройки требуется перезагрузка сервера.

• Не загружать продажи, если код кассы на КС и в файле продаж не совпадают.

  • Если настройка отключена (значение по умолчанию), то при получении файлов продаж, в которых код кассы отличен от кода кассы на КС, данные будут загружены в КС (в ту БД, которая указана в режиме загрузки продаж).
    

  • Если настройка включена, то продажи в БД КС не загружаются.
• Разрешать возврат в любом магазине. При включенной настройке возврат по чеку на другой кассе может быть выполнен для любого магазина, если выгрузка продаж с кассы настроена только в БД All. Возврат в любом магазине возможен, если используются только GLOBAL_MYSQL и/или GLOBAL_PSQL режимы загрузки продаж. 
• Режим загрузки продаж. Загрузка продаж может производиться в несколько БД, для этого необходимо перечислить нужные базы через запятую:
  • STORE_MYSQL – Загружать продажи в БД магазина (MYSQL).
  • GLOBAL_MYSQL – Загружать продажи в глобальную БД (MYSQL).
  • GLOBAL_PSQL – Загружать продажи в глобальную БД (PostgreSQL).

По умолчанию "GLOBAL_MYSQL,STORE_MYSQL". Если параметр не задан, то загрузка продаж не производится ни в одну из БД.
Если в настройке указано только значение GLOBAL_PSQL, то сверка продаж и отчет о продажах формируется на основании БД PostgreSQL.
При использовании файлового обмена с АСТУ выгрузка продаж через exchangers из БД PostgreSQL не выполняется. Exchangers выполняет выгрузку только из СУБД MySQL. БД магазина имеет более высокий приоритет.
В случае выгрузки продаж через SOAP используются любые БД, которые указаны в настройке. 

• Отображать данные о продажах. Настройка используется для возможности скрывать и отображать данные продаж в сводной таблице.
• Загружать остатки для товаров из продаж. Настройка используется для возможности загружать и не загружать остатки товаров из продаж.
• Отображать чеки, не вернувшиеся от ОФД. Настройка используется для возможности отображения признака не вернувшихся чеков от ОФД.
  
• Мастер токен для проверки чеков в ФНС. Необходимо указать мастер токен. MASTER TOKEN - это уникальный ключ, полученный от ФНС и предназначенный для получения информации о чеках из ФНС. Настройка используется для функционала "Получить чек из ФНС". Подробнее можно прочитать в разделе "Назначение вкладок для объектов торговой сети".
• Количество попыток получения информации о чеке в ФНС. Задается количество попыток запроса информации о чеке из ФНС по выбранному документу в разделе <Сверка продаж>. Подробнее можно прочитать в разделе "Назначение вкладок для объектов торговой сети".
• Периодичность попыток получения инфомрации о чеке в ФНС. Задается периодичность попыток запроса информации о чеке из ФНС по выбранному документу в разделе <Сверка продаж>, в миллисекундах. Подробнее можно прочитать в разделе "Назначение вкладок для объектов торговой сети".

Миграция БД

Миграция предназначена для поддержания структуры баз данных в актуальном состоянии, чтобы базы данных соответствовали текущей версии кассового сервера. Подробнее можно прочитать в разделе "Миграция БД".

Пользователи

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

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

При добавлении пользователя заполните необходимые поля:

• Логин – уникальное имя пользователя, необходимое для авторизации в Artix Control Center. Длина логина не может превышать 32 символа, при заполнении поля разрешено использовать латинские буквы, цифры, символы "-" и "_".
• Пароль – используется для защиты информации от несанкционированного доступа. Длина пароля не может превышать 32 символа, при заполнении поля разрешено использовать русские и латинские буквы, цифры, символы "-" и "_".
• Подтверждение пароля – данное поле предназначено для повторного ввода пароля, чтобы исключить ошибку ввода.
• Роли пользователя – роли пользователя определяют набор действий, разрешённых для выполнения пользователем, возможно выбрать несколько ролей.
• Правила доступа – правила доступа, которые назначаются пользователю, выбираются из списка.

Роли пользователей

Роль – совокупность правил, регламентирующих порядок и условия доступа пользователей к объектам торговой сети. Роли определяют набор действий, разрешённых для выполнения пользователями над объектами данных.

При добавлении роли пользователя заполните необходимое поле:

• Наименование – наименование роли пользователя. Длина наименования не может превышать 32 символа, при заполнении поля разрешено использовать латинские буквы, цифры, символы "-" и "_".

Далее задайте права для роли. Основной перечень прав отображается во вкладке "Роли и права пользователя". Перечень прав включает в себя:

• Управление кассами – разрешено добавление/редактирование/удаление касс, выгрузка справочников на кассы, а также загрузка продаж.
• Администрирование сервера – доступ к сервисным инструментам кассового сервера, редактированию пользователей, миграции БД.
• Администрирование конфигураций – доступ к конфигурациям, добавление/редактирование/удаление конфигураций.
• Изменение статуса маркированных товаров – доступ к статусам маркированных товаров, просмотр/изменение статусов.
• Удаление кассовых смен – разрешено удаление кассовых смен во вкладке "Продажи".

Во вкладке "Роли для LM" устанавливаются роли, определяющие доступ к различным функциям при работе в Artix Loyalty Management. Описание ролей приведено в документации системы лояльности LM.

• Заведение акций
• Подтверждение акций
• Управление картами
• Просмотр карт
• Управление клиентами
• Просмотр клиентов
• Управление группами карт
• Просмотр групп карт
• Старший оператор КЦ
• Оператор КЦ
• Оператор лояльности
• Системная
• Управление бонусами карт
• Просмотр бонусов карт
• Управление группами сертификатов
• Просмотр групп сертификатов
• Управление балансом сертификатов
• Управление организациями
• Просмотр организаций
• Удаление купонов

Во вкладке "Доступ к секциям в LM" для системы лояльности Artix Loyalty Management дополнительно настраиваются права доступа к различным разделам системы:

• Скидки
• Начисление бонусов
• Списание бонусов
• Реклама
• Карты
• Сертификаты
• Администрирование
• Купоны
• Периодические начисления бонусов

Чтобы просмотреть перечень прав для роли пользователя, выберите из списка нужный объект, в правой части экрана отобразится информация о группе прав:

Правила доступа

Возможность управления магазинами для пользователя регулируется правилами доступа:

При добавлении правила доступа заполните необходимые поля:

• Название – название правила доступа. Используется для группировки магазинов по некоторому признаку. Длина названия не может превышать 32 символа, при заполнении поля разрешено использовать русские и латинские буквы, цифры, символы "-" и "_".
• Описание – данное поле предназначено для внесения каких-либо дополнительных примечаний по правилу доступа.
• Тип – тип работы правила доступа. Доступные значения: "по локациям" и "по магазинам", выбирается из списка.
• Регионы – список регионов, сортировка осуществляется по алфавиту. Список регионов соответствует стране, которая была выбрана в настройках Artix Control Center.
• Населенные пункты – список населенных пунктов, доступен после выбора региона. Сортировка населенных пунктов осуществляется по алфавиту.
• Список доступных магазинов – список магазинов, удовлетворяющих заданным условиям.

Для типа правила доступа "По локациям" ниже в таблице будут отображены магазины, в реквизитах которых указан заданная локация:

Для типа правила доступа "По магазинам" ниже в таблице будут отображены магазины, из которых необходимо выбрать разрешенные для управления:

Форматы обмена

Раздел настроек "Форматы обмена" содержит информацию о доступных форматах обмена для загрузки справочников из АСТУ на КС и для выгрузки продаж с КС в АСТУ.

Для обмена данными на Artix Control Center могут использоваться следующие форматы файлового обмена:

• для загрузки справочников из АСТУ на КС:
  • artixinterchange,
  • atol,
  • crystal,
  • oracle,
  • sap,
  • shtrihm,
  • supermag,
  • supermag4.
• для выгрузки продаж с КС в АСТУ:
  • artixinterchange,
  • atol,
  • atol-astor,
  • crystal,
  • ns2000,
  • oracle,
  • pilot,
  • sap,
  • shtrihm,
  • supermag.

В разделе "Форматы обмена" созданы и преднастроены все поддерживаемые сервером форматы обмена:

При добавлении формата обмена заполните необходимые поля:

• ID – уникальный идентификатор формата обмена. Нельзя задать самостоятельно и изменить.
• Название – название формата обмена. Длина названия не может превышать 32 символа, при заполнении поля разрешено использовать русские и латинские буквы, цифры, символы "-" и "_".
• Описание – данное поле предназначено для внесения каких-либо дополнительных примечаний по формату обмена.
• Тип формата обмена – тип обмена, который будет использоваться для передачи/получения данных между КС и АСТУ, выбирается из списка.
• Тип объекта – выбирается из списка, может принимать значения - справочники (для магазинов), продажи (для касс).

В зависимости от выбранного типа объекта ниже будут отображены параметры формата обмена: 

• для типа объекта "Продажи":
  
• для типа объекта "Справочники":
  

Сервера Artix Loyalty

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

Стыковка кассового и бонусного сервера (далее БС) осуществляется в Artix Control Center через раздел "Сервера Artix Loyalty":

При добавлении/редактировании сервера заполните необходимые поля:

• Идентификатор – уникальный идентификатор сервера. Длина допустимого значения 2, возможные значения от 1 до 99.
• Тип сервера – выберите тип сервера из выпадающего списка. При выборе типа сервера автоматически будут прописаны дефолтные порты:
  • бонусный сервер (порт для администрирования – 7760, порт для работы – 7761);
  • сервер сертификатов (порт для администрирования – 7780, порт для работы – 7781);
  • бонусный и сервер сертификатов (порт для администрирования – 7770, порт для работы – 7771);
  • сервер купонов (порт для администрирования – 7790, порт для работы – 7791).
• Название – название сервера. Длина названия не может превышать 20 символов, при заполнении поля разрешено использовать русские и латинские буквы, цифры, символы "-" и "_".
• Хост – хост сервера в сети. Длина хоста не может превышать 20 символов. По умолчанию "localhost".
• Порт для администрирования – порт для администрирования сервера (создания и изменения статуса карт/сертификатов/купонов).
• Порт для работы – порт для работы сервера (начисления, списания и изменения баланса карт/сертификатов/купонов).
• Время ожидания – время ожидания запроса от сервера, в миллисекундах. По умолчанию "5000".
• Терминал для операции – терминал, от имени которого могут выполняться операции по начислению или заведению карт. Для проведения операций со счетами бонусных карт и подарочных сертификатов выбранный терминал должен быть активен, при этом касса может быть как включена, так и выключена. Терминал для проведения операций с бонусами берется из ID кассы.

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

Если сервер недоступен, то будет выведено предупреждение:

Статус создания терминала сохраняется в БД Mongo для каждого сервера. В случае ошибки или недоступности сервера попытка заведения терминала повторяется 8 раз. Если для какой-либо кассы терминал не был создан, то после перезапуска сервера выполняется повторная попытка заведения терминала.

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

Акцизная продукция

Раздел настроек "Алкогольная продукция" предназначен для контроля продажи акцизной продукции:

• Проверять список разрешенных к продаже акцизных марок образца 2016 года алкогольной продукции. По умолчанию "Не проверять".
• Контроль алкокодов при продаже акцизной продукции (только для алкоголя с акцизной маркой образца 2016 года). По умолчанию выключена.
• Проверять список разрешенных к продаже акцизных марок нового образца 2018 года алкогольной продукции. По умолчанию "Не проверять".
• Проверять список разрешенных к продаже акцизных марок табачной продукции. По умолчанию "Не проверять".
• Проверять список разрешенных к продаже кодов маркировки обуви. По умолчанию "Не проверять".
• Проверять список разрешенных к продаже кодов маркировки лекарств. По умолчанию "Не проверять".
• Использовать коды магазина при проверке разрешенных к продаже акцизных марок. По умолчанию выключена.
• Контроль остатков при продаже алкогольной акцизной продукции. По умолчанию "Не проверять".
• Контроль остатков при продаже табачной продукции. По умолчанию "Не проверять".
• Отображать реквизиты ЕГАИС в веб. Включите настройку, чтобы получить возможность заполнять данные для передачи данных продаж в ЕГАИС.

Аудит

Раздел настроек "Аудит" предназначен для задания правил отслеживания действий пользователя.

Аудит действий на КС позволяет логировать все запросы к кассовому серверу и результаты выполнения этих запросов. Для хранения логов используется коллекция audit БД artixcs СУБД Mongo.

При необходимости аудит может быть настроен таким образом, чтобы не логировать все запросы и обрезать слишком длинные запросы/ответы:

• Список REST методов, которые не надо писать в аудит. Необходимо перечислить через запятую. По умолчанию GET.

• Список URL префиксов, которые не надо писать в аудит. Необходимо перечислить через запятую. По умолчанию не пишутся запросы по фильтрации дерева, установке и обновлению статусов.

• Максимальная длина тела запроса и ответа, для записи в аудит. Если указанное значение будет превышено, то в аудит будет записано обрезанное тело запроса (ответа). По умолчанию 1000.

Весы

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

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

  Для весов DIGI синхронизация выполняется с точностью до минуты (особенности работы протокола).
• Передавать дробную цену на весы. Определяет формат передаваемой цены.
• Префикс штрих-кода для штучного товара на весах. Префикс штрих-кода состоит из 2-х символов и используется при идентификации товара на кассе.

• Префикс штрих-кода для весового товара на весах. Префикс штрих-кода состоит из 2-х символов и используется при идентификации товара на кассе.

СМС

• Тип СМС шлюза. Зависит от шлюза, который используется торговой сетью. Выбирается из списка.
• URL шлюза для отправки СМС. Адрес смс-шлюза.
• Имя отправителя СМС, которое увидит получатель. Может быть указано имя бренда или торговой сети.
• Маска телефона для отправки СМС. Маска, по которой будет определен номер телефона при вводе.
• Преобразование телефона для отправки СМС. Общий вид, к которому будет преобразован номер телефона для отправки смс.

• Текст для СМС в формате SpEL. Доступны поля подстановки из объекта карты и поле verifyCode - код подтверждения. Поля карты необходимо указывать в формате card.number. Текст для смс указывается в одинарных кавычках. Отдельные элементы текста для смс соединяются между собой символом конкатенации +. Разрешено использование выражений java, например, false ? 'trueExp' : 'falseExp'. Более детальное описание приведено в документации формата SpEL. 

  Пример текста для смс

  'Для карты ' + card.number + ' код подтверждения: ' + verifyCode

  При составлении текста для смс через карту можно использовать поля клиента:

  Пример текста смс

  'Уважаемый ' + card.client.name + '! Ваш код подтверждения: ' + verifyCode

• Идентификатор отправителя СМС, по которому шлюз определяет источник отправки СМС. По умолчанию используется CashServer.

• Ключ для авторизации на СМС шлюзе. Ключ, по которому шлюз будет авторизовать отправителя.

• Пароль для авторизации на СМС шлюзе в отдельном поле при необходимости (только для SMS_TRAFFIC). Пароль, по которому шлюз будет авторизовать отправителя. Данное поле необходимо, если у клиента в аутентификационном ключе отсутствует спец.символ ":", по которому идёт разделение на логин и пароль.
  • если в ключе для авторизации присутствует спец.символ ":", то логин и пароль будут взяты из настройки "Ключ для авторизации на СМС шлюзе";
  • если в ключе для авторизации отсутствует спец.символ ":", то логин будет взят из настройки "Ключ для авторизации на СМС шлюзе", а пароль из настройки "Пароль для авторизации на СМС шлюзе".

Подробнее о настройке СМС-шлюза и работе с картами клиента можно прочитать в разделе "Карты клиента".

VNC и SSH

• Глобальный пароль для VNC. Заданный пароль используется для осуществления удаленного доступа к кассе по сети.
  

• Порт для подключения по SSH. Заданный порт используется для подключения к кассе по ssh-протоколу.

• Пользователь для подключения по SSH. Заданный пользователь используется для подключения к кассе по ssh-протоколу.

• Пароль для подключения по SSH. Заданный пароль используется для подключения к кассе по ssh-протоколу.

Подробнее о работе с кассой через VNC и SSH можно прочитать в разделе "Назначение вкладок для объектов торговой сети".

Прайсчекеры

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

• Шаблон вывода стоимости товара от прайсчекера. Позволяет задавать шаблон, в котором на экран прайсчекера будет выведена стоимость товара.

  Реализовано для моделей прайсчекера Newland 304 и 704.

Паппет

• IP адрес и порт puppet сервера. Содержит адрес, по которому будет доступен puppet сервер.

Active Directory

В Artix Control Center поддержана возможность авторизации пользователей, данные которых хранятся в Active Directory. Для того чтобы авторизация была осуществлена под логином и паролем из Active Directory, необходимо в настройках сервера перейти в раздел "Active Directory", включить авторизацию в ActiveDirectory и задать параметры подключения:

• Включить авторизацию в ActiveDirectory. Настройка включает возможность авторизации в Artix Control Center, используя логин и пароль из БД Active Directory.

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

• Имя сервера для подключения к ActiveDirectory. Параметр является необязательным для заполнения.

Пример настроек:

Для авторизации пользователя через Active Directory необходимо, чтобы группы у пользователя Active Directory совпадали с ролями в Artix Control Center. Проверка прав пользователя происходит при каждой попытке авторизации.

При авторизации через Active Directory могут быть выведены следующие ошибки:

• если Active Directory недоступна по какой-либо причине, то будет выведено сообщение:
  
• если в настройках сервера не задан домен для подключения к Active Directory, то будет выведено сообщение:
  
• если нет совпадения между группами пользователя в Active Directory и ролями в Artix Control Center, то будет выведено сообщение:
  
• при вводе неверных данных будет выведено сообщение:
  

Прочее

• Запускать миграцию при старте КС. По умолчанию включена.
• Формат названий системных меток дисконта. Функционал описан в разделе "Метки для Artix Loyalty".
• Включить аутентификацию в REST API. При включенной настройке для пользователей узлов, заведенных на КС, аутентификация выполняется автоматически. Если доступ запрашивается с неизвестного для КС ip-адреса, то при аутентификации необходимо указать логин и пароль пользователя. Доступ к REST API предоставляется в соответствии с правами пользователя.
• Сохранять историю изменений справочников карт и клиентов в БД. После изменения параметра необходимо провести миграцию БД справочников.
• Включение отображения задач трансфера в планировщике. Включение отображения задач трансфера в планировщике (раздел "Расписание").
• URL-адрес сервиса, для отправки уведомлений об изменении онлайн-чеков. Сервис отправляет запрос на внешний сервис, в виде "http://<host>:<port>/event/onlineCheck". По умолчанию адрес не задан.
• Начальное значение порядкового номера для счет-фактуры (УПД). По умолчанию "1".
• Маска для формирования номера счет-фактуры (УПД). Задается в формате SpEL при использовании подстановок, которые берутся из БД Dictionaries таблицы waybillNumbers. По умолчанию "serialnum + '/' + shopcode".
• Страна, в которой находится сеть магазинов. В зависимости от настройки при выборе локации магазина будут отображаться только те регионы, которые соответствуют стране в данной настройке.
• Обозначение валюты для отображения в веб-интерфейсе. Настройка для указания названия валюты. По умолчанию "руб.".