Parameters for setting up connection to cash register, terminal and scanner

Материал из Servio Doc
Перейти к: навигация, поиск

Параметры настройки подключения к кассе, POS-терминалу и сканеру

Ниже приведены параметры настройки файлов конфигурации:

ServiceSettings.xml

Clipboard.png Параметры, относящиеся к настройке автозакрытия смены:
  • <ShiftCloseTime>;
  • <LastShiftClosingDate>;
  • <WaitAfterClosingShift>;
  • <CashOutBeforeShiftClose>;
  • <CashOutType>3</CashOutType>;
  • <FractionalCoins>;
  • <XReportBeforeShiftClose>;
  • <LastShiftClosedAutomatically>;
  • <TrackBeforeAutoShiftClosing>

описаны в статье «Автозакрытие смены в сервисе ФР».

Секция <ServiceSettings> — операции с ФР
<ServiceSettings> — Начало секции
<IpAddress>адрес (например 10.2.7.200)</IpAddress> — Внутренний IP-адрес подключения кассы. Определяется через cmd/ipconfig
<ComPort>номер порта (например, 3)</ComPort> — COM-port подключения ФР к компьютеру
<ComBods>скорость обмена (например, 115200)</ComBods> — Скорость обмена данными между кассой и службой ФР
<Debug>True</Debug> — Включение/отключение расширенного логирования
<GroupArticles>False</GroupArticles> — Включение/отключение объединения услуг в чеке ФР. Правила объединения услуг задаются в секциях <JoinArticleSettings>
<IsReceiptTimeoutClose>True</IsReceiptTimeoutClose> — Действие с чеком в случае истечения времени ожидания. True - чек закрывается, False - чек аннулируется;
<CashierName /> — ФИО кассира. Если заполнено, передаётся на печать в чеке
<CashierId>0</CashierId> — ID кассира в HMS Servio (Настройки/Персонал/Пользователь. Номер в выбранной кассе). Передаётся на печать в чеке, если параметр <CashierName> не заполнен
<DetailingReciepts>True</DetailingReciepts> — Не используется. На печать чека не влияет
<LoggingDetailsReceipts>True</LoggingDetailsReceipts> — Включение/отключение логирования детализации чеков
<WaitBeforeStartService>0</WaitBeforeStartService> — Включение/отключение паузы перед запуском сервиса, сек. Может быть полезна службы при запуске на медленных терминалах
<IpPort>Номер порта (Например, 2003)</IpPort> — Порт прослушивания IP-адреса кассы
<CheckTimezoneTransitionTime /> — Время проверки перехода на летнее/зимнее время
<SendCustomerEmail>True</SendCustomerEmail> — Включение/отключение отправки чеков на адрес электронной почты плательщика при её наличии в счете
<SendCustomerPhoneInsteadEmail>False</SendCustomerPhoneInsteadEmail> — Включение/отключение отправки чеков по SMS на номер телефона плательщика при его наличии в счёте, вместо отправке по электронной почте
<SuffixForArticle /> — Суффикс для расширения артикула
<IsPrintDocument>True</IsPrintDocument> — Включение/отключение отправки чека ФР на сервис печати
<PrinterServiceIpPort>IP-адрес (например, 127.0.0.1:8636)</PrinterServiceIpPort> — IP-адрес и номер порта сервиса печати
<PrinterName>POS-80-Series</PrinterName> — Не используется
</ServiceSettings> — Окончание секции
Секция <PosTerminalSettings> — операции с банковским терминалом
<PosTerminalSettings> — Начало секции
<PosComPort>номер порта (например, 9)</PosComPort> — Номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
<PosTimeOut>таймаут (например, 90000)</PosTimeOut> — Таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
<PrintPosReceipt>True</PrintPosReceipt> — Включение/отключение печати чека банковского терминала на принтере ФР;
<PrintPosReceiptInCheck>true</PrintPosReceiptInCheck> — Включение/отключение печати чека банковского терминала вместе с чеком ФР
<CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant> — Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный номер «Идентификатор мерчанта» (Настройки/Оборудование/Кассы/Тип оплат с группой оплат «Кредитная карта»)
<PosPaidTypes>№№ групп (например: 1, 2)</PosPaidTypes> — Список групп оплат, доступные для обработки на POS-терминале:
  • 0 — Наличные;
  • 1 — Банковская карта;
  • 2 — Безналичные;
  • 3 — Бонусы;
  • 4 — Депозитный счёт;
  • 5 — Оплата сертификатом
</PosTerminalSettings> — Окончание секции
<JoinArticleSettings> — объединение услуг для печати в чеке
Устаревшее!
Секции <JoinArticleSettings> — объединение услуг для печати в чеке. Группы секций с двумя услугами. В чеке печатается услуга с MainArticleName
<JoinArticleSettings> — Начало секции
<MainArticleName>название услуги (например, Проживание)</MainArticleName> — ТОЧНОЕ название основной услуги, которая должна печататься в чеке
<JoinArticleName>название услуги (например, Ранний заезд)</JoinArticleName> — ТОЧНОЕ название услуги, которая не должна печататься в чеке
</JoinArticleSettings></PosComPort> — Окончание секции
Актуальное!
Секция <JoinArticleSettings> — объединение услуг для печати в чеке. В чеке печатается услуга с MainArticleCode
<JoinArticleSettings> — Начало секции
<MainArticleCode>(например: 100)</MainArticleCode> — В примере 100 — код услуги «Проживание»
<JoinServicesCodes>(перечисление услуг, например: 321, 320, 323)</JoinServicesCodes> — В примере:
321 — код услуги «Обед»;
320 — код услуги «Завтрак»;
323 — код услуги «Ужин»
При наличии в начислениях любого набора услуг (100+321 или 100+320+321+323) в чеке печатается услуга с MainServiceCode
Количественные значения объединяемых услуг могут быть любыми и не совпадать с количеством основной услуги
<JoinServicesClassesIDs>(перечисление классов услуг, например: 1, 3, 21) </JoinServicesClassesIDs> — В примере:
1 — код класса услуг «Основные услуги»;
3 — код класса услуг «Питание»;
21 — код класса услуг «Продажа товаров»
Все услуги перечисленных классов объединяются и суммируются с услугой в MainServiceCode. Услуги остальных классов печатаются отдельными строками
</JoinArticleSettings></PosComPort> — Окончание секции
Обработка секции производится последовательно, сначала услуги в теге JoinServicesCodes, затем оставшиеся услуги классов JoinServicesClassesIDs

Touch-M_FR-K_Settings.xml

В файле Touch-M_FR-K_Settings задаются параметры настройки, относящиеся к ФР "Штрих", распространяемом на территории России

Секция <Touch-M_FR-K_Settings>
<Settings> — Начало секции
<Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/>

<Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/>

— Группы тегов соответствия настроек HMS Servio и ФР «Штрих», где:
TaxShtrih.png
  • FiscalTaxScheme — номер фискальной схемы в HMS Servio (Бухгалтерия/Налги/Налоги): фискальная налоговая схема, установленная для определённого налога
  • DeviceFiscalTaxScheme — номер ряда из таблице налоговых ставок в Драйвере ФР Штрих

Тегов соответствия может быть несколько
На рисунке приведён пример таблицы налоговых ставок

  • PaymentItemSign - признак предмета расчета. Значение может быть жестко задано (см. список ниже); если значение не задано, оно подставляется автоматически из поля «Код» налоговой группы (Бухгалтерия/Налоги/Налоговые группы), установленной для услуги / товара. Используются не все предусмотренные законодательством коды.
    Возможные значения:
Название, примечание Значение реквизита Коды в HMS «Servio» Значение в печатном чеке
Товар, Реализация товара (кроме подакцизного) 1 Goods, Product Товар (Т)
Услуга. Выполнение услуг 4 Service, HotelService, Extras, RestarauntService Услуга (У)
Внереализационный доход. Получение внерелизационного дохода 15 Penalty Внереализационный доход
Курортный сбор 18 TouristTax Курортный сбор
Маркированные товары 33 Код зашит в службе Маркированный товар (ТМ)
Clipboard.png Логика настройки параметра «PaymentItemSign» следующая:
— если значение передается из HMS «Servio», в данном файле конфигурации значения не устанавливаются;
— если значение из HMS «Servio» не передается (например, ресторанная система), в данной секции устанавливается соответствие признака предмета расчета налоговой группе или, если используется только одна налоговая группа, значение параметра устанавливается в теге «Advanced».
<Settings> — Окончание секции
<Security>

    <PwdOpr>1</PwdOpr>
    <PwdAdm>29</PwdAdm>
    <PwdSys>30</PwdSys>
    <PwdFisc>0</PwdFisc>
</Security>

— Пароль ролей пользователей для выполнения операций на ФР:
  • <PwdOpr>1</PwdOpr> — пароль кассира;
  • <PwdAdm>29</PwdAdm> — пароль администратора;
  • <PwdSys>30</PwdSys> — пароль налоговой инспекции и выполнения служебных операций (X-отчёт, Z-отчёт);
  • <PwdFisc>0</PwdFisc> — пароль техника

Значения паролей не меняются

<Advanced IsRecalcDiscountPrice="False" Timeout="10000" IsPOSTerminalPrintDublicate="False" QuantityFeedDocumentBeforeCut="4" PaymentItemSign=""/> — Расширенные настройки:
  • IsRecalcDiscountPrice — пересчитывать или не пересчитывать значение скидки;
  • Timeout — значение таймаута на проведение операций ФР;
  • IsPOSTerminalPrintDublicate — печать копии чека POS-терминала. Относится только к интегрированным терминалам;
  • QuantityFeedDocumentBeforeCut — количество строк прогона бумаги перед обрезкой чека. По умолчанию «4». Для терминалов Штрих-М Сити значение «6». Для терминалов Штрих-01Ф-Лайт (с лентой шириной 58 мм) значение «6»

Подключение прокси-службы

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

Прокси-служба состоит из серверной и клиентской частей.

Серверная часть устанавливается на сервере. В данном документе настройка не рассматривается.

Клиентская часть устанавливается на компьютерах с подключенным оборудованием. Рекомендуется устанавливать отдельным каталогом в каталог со службами HMS Servio. Например: C:\HMS_Servio\HMSServioProxyClient.

Переключение на прокси-службу состоит из трёх этапов:

  1. Настройка конфигурационного файла прокси-клиент.
  2. Перенастройка подключения в HMS Servio (Настройки/Оборудование). В поле «IP-адрес сервера» вводится внутренний IP-адрес сервера и уникальный ключ: Proxy.png
  3. Перенастройка конфигурационного файла ServiceSettings службы печати чеков. В теге <IpAddress> вводится локальный IP:
        <IpAddress>127.0.0.1</IpAddress>.

HMSServioProxyClient.exe.xml

В конфигурационном файле HMSServioProxyClient.exe.xml задаются настройки подключения клиента

Секция <Settings>
<Settings> —  Начало секции
  <ProxyServerSetting ProxyServerHostNameOrIPAddress="example.com" ProxyServerPort="XXXX"/>
 —  Тег подключения к прокси-службе сервера, где:
  • ProxyServerHostNameOrIPAddress — имя DNS или IP-адрес сервера
  • ProxyServerPort — номер порта подключения прокси-службы сервера
  <LocalServicesSettings> —  Начало секции
    <LocalServiceSetting ClientKey="unic_hotel_key" LocalServiceIPAddress="XX.XX.XX.XX" LocalServicePort="XXXX"/>
 —  Тег подключения локальных служб оборудования. Настройки подключения каждого вида оборудования вводятся отдельной строкой:
  • ClientKey="unic_hotel_key" — уникальный ключ для перенаправления данных с сервера к указанной локальной службе. Уникальность ключа должна поддерживаться строго: и в сети отелей, и внутри отеля для разного вида оборудования;
  • LocalServiceIPAddress="127.0.0.1" — локальный IP-адрес. В случае подключения прокси-службы, в файле конфигурации ServiceSettings.xml службы FR должен также быть указан локальный IP-адрес в теге <IpAddress>127.0.0.1</IpAddress>;
  • LocalServicePort="XXXX" — порт подключения службы, которой пересылаются данные от сервера
  </LocalServicesSettings> —  Окончание секции
</Settings> —  Окончание секции

Подключение сканера

В гостиницы поставляются сканеры модели «Проводной 2D сканер Proton ICS-1290» В Диспетчере устройств сканер отображается в секции «POS Barcode Scanner» как "Сканер штрихкодов POS HID" (HID — Human Interface Device).

Идентификатор сканера записывается в файле конфигурации HMS Servio Cashier.exe.config Модуля кассира в секции <USBHIDBarcodReaderConfiguration>.
Пример: <USBHIDBarcodReaderConfiguration VIDPIDDeviceID="HID\VID_060E&‎amp;‎PID_16DA&‎amp;‎REV_00=1"‎ />

ID сканера можно найти в свойствах оборудования в разделе «ИД оборудования»

ServioCashierDeviceManager.png

В зависимости от партии поставки идентификаторы сканеров могут различаться.

Внимание! В файле конфигурации в теге <USBHIDBarcodReaderConfiguration> после символа «&» должно быть введено amp;‎

Источник — «http://doc.servio.ru/index.php?title=Parameters_for_setting_up_connection_to_cash_register,_terminal_and_scanner&oldid=6622»