Просмотр исходного текста страницы Parameters for setting up connection to cash register and terminal

<u><big><big>'''Параметры настройки подключения к кассе и POS-терминалу'''</big></big></u>

<div style="clear: right; margin-bottom: 0.5em; float: right; padding: 0.5em 0 0.8em 1.4em; position: fixed; top: 50px; right: 10px; background: none;" class="toclimit-4">__TOC__</div>

Ниже приведены параметры настройки файлов конфигурации:
* [[#ServiceSettings.xml|ServiceSettings.xml]] — единый конфигурационный файл;
* [[#Touch-M_FR-K_Settings.xml|Touch-M_FR-K_Settings.xml]] — файл настройки подключения к ФР «Штрих».

<span id="ServiceSettings.xml">
===ServiceSettings.xml===

{{Вставка  
|рис = [[File:Clipboard.png|frameless|30px|link=]]  |текст = Параметры, относящиеся к настройке автозакрытия смены:
* <nowiki><ShiftCloseTime></nowiki>; <br>
* <nowiki><LastShiftClosingDate></nowiki>; <br>
* <nowiki><WaitAfterClosingShift></nowiki>; <br>
* <nowiki><CashOutBeforeShiftClose></nowiki>; <br>
* <nowiki><CashOutType>3</CashOutType></nowiki>; <br>
* <nowiki><FractionalCoins></nowiki>; <br>
* <nowiki><XReportBeforeShiftClose></nowiki>; <br>
* <nowiki><LastShiftClosedAutomatically></nowiki>; <br>
* <nowiki><TrackBeforeAutoShiftClosing></nowiki>
описаны в статье [[Автозакрытие смены в сервисе ФР|«Автозакрытие смены в сервисе ФР»]].
}}

{| border="1" style="border-collapse:collapse; margin-top:0.5em" 
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><ServiceSettings></b> — операции с ФР
|-
| style="padding-left:0.5em; width: 45%"|<nowiki><ServiceSettings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Начало секции
|-
| style="padding-left:2em" |<span id="IP-адрес"><nowiki><IpAddress>адрес (например 10.2.7.200)</IpAddress></nowiki></span>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Внутренний IP-адрес подключения кассы. Определяется через cmd/ipconfig
|-
| style="padding-left:2em" |<nowiki><ComPort>номер порта (например, 3)</ComPort></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |COM-port подключения ФР к компьютеру
|-
| style="padding-left:2em" |<nowiki><ComBods>скорость обмена (например, 115200)</ComBods></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Скорость обмена данными между кассой и службой ФР
|-
| style="padding-left:2em" |<nowiki><Debug>True</Debug></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение расширенного логирования
|-
| style="padding-left:2em" |<nowiki><GroupArticles>False</GroupArticles></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение объединения услуг в чеке ФР. Правила объединения услуг задаются в секциях [[#JoinArticleSettings|<nowiki><JoinArticleSettings></nowiki>]]
|-
| style="padding-left:2em" |<nowiki><IsReceiptTimeoutClose>True</IsReceiptTimeoutClose></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Действие с чеком в случае истечения времени ожидания. True - чек закрывается, False - чек аннулируется;
|-
| style="padding-left:2em" |<nowiki><CashierName /></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |ФИО кассира. Если заполнено, передаётся на печать в чеке
|-
| style="padding-left:2em" |<nowiki><CashierId>0</CashierId></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |ID кассира в HMS Servio (Настройки/Персонал/Пользователь. Номер в выбранной кассе). Передаётся на печать в чеке, если параметр <CashierName> не заполнен
|-
| style="padding-left:2em" |<nowiki><DetailingReciepts>True</DetailingReciepts></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Не используется. На печать чека не влияет
|-
| style="padding-left:2em" |<nowiki><LoggingDetailsReceipts>True</LoggingDetailsReceipts></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение логирования детализации чеков
|-
| style="padding-left:2em" |<nowiki><WaitBeforeStartService>0</WaitBeforeStartService></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение паузы перед запуском сервиса, сек. Может быть полезна службы при запуске на медленных терминалах
|-
| style="padding-left:2em" |<nowiki><IpPort>Номер порта (Например, 2003)</IpPort></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Порт прослушивания [[#IP-адрес|IP-адреса]] кассы
|-
| style="padding-left:2em" |<nowiki><CheckTimezoneTransitionTime /></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Время проверки перехода на летнее/зимнее время
|-
| style="padding-left:2em" |<nowiki><SendCustomerEmail>True</SendCustomerEmail></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение отправки чеков на адрес электронной почты плательщика при её наличии в счете
|-
| style="padding-left:2em" |<nowiki><SendCustomerPhoneInsteadEmail>False</SendCustomerPhoneInsteadEmail></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение отправки чеков по SMS на номер телефона плательщика при его наличии в счёте, вместо отправке по электронной почте
|-
| style="padding-left:2em" |<nowiki><SuffixForArticle /></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Суффикс для расширения артикула
|-
| style="padding-left:2em" |<nowiki><IsPrintDocument>True</IsPrintDocument></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение отправки чека ФР на сервис печати
|-
| style="padding-left:2em" |<nowiki> <PrinterServiceIpPort>IP-адрес (например, 127.0.0.1:8636)</PrinterServiceIpPort></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |IP-адрес и номер порта сервиса печати
|-
| style="padding-left:2em" |<nowiki> <PrinterName>POS-80-Series</PrinterName></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Не используется
|-
| style="padding-left:0.5em" |<nowiki></ServiceSettings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Окончание секции
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><PosTerminalSettings></b> — операции с банковским терминалом
|-
| style="padding-left:0.5em" |<nowiki><PosTerminalSettings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Начало секции
|-
| style="padding-left:2em" |<nowiki><PosComPort>номер порта (например, 9)</PosComPort></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
|-
| style="padding-left:2em" |<nowiki><PosTimeOut>таймаут (например, 90000)</PosTimeOut></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
|-
| style="padding-left:2em" |<nowiki><PrintPosReceipt>True</PrintPosReceipt></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение печати чека банковского терминала на принтере ФР;
|-
| style="padding-left:2em" |<nowiki><PrintPosReceiptInCheck>true</PrintPosReceiptInCheck></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Включение/отключение печати чека банковского терминала вместе с чеком ФР
|-
| style="padding-left:2em" |<nowiki><CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный номер «Идентификатор мерчанта» (Настройки/Оборудование/Кассы/Тип оплат с группой оплат «Кредитная карта»)
|-
| style="padding-left:2em" |<nowiki><PosPaidTypes>№№ групп (например: 1, 2)</PosPaidTypes></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Список групп оплат, доступные для обработки на POS-терминале:<br>
* 0 — Наличные;
* 1 — Банковская карта;
* 2 — Безналичные;
* 3 — Бонусы;
* 4 — Депозитный счёт;
* 5 — Оплата сертификатом
|-
| style="padding-left:0.5em" |<nowiki></PosTerminalSettings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Окончание секции
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |<span id = "JoinArticleSettings"></span id> <b><JoinArticleSettings></b> — объединение услуг для печати в чеке
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |'''''Устаревшее!''''' <span style="color:gray"> <br/>Секции <b><JoinArticleSettings></b> — объединение услуг для печати в чеке. Группы секций с <b>двумя</b> услугами. В чеке печатается услуга с MainArticleName
|-
| style="padding-left:0.5em; color:darkgray" |<nowiki><JoinArticleSettings></nowiki>
| style="padding-left:0.5em; color:darkgray" | —
| style="padding-left:0.5em; color:darkgray" |Начало секции
|-
| style="padding-left:2em; color:darkgray" |<nowiki><MainArticleName>название услуги (например, Проживание)</MainArticleName></nowiki>
| style="padding-left:0.5em; color:darkgray" | —
| style="padding-left:0.5em; color:darkgray" |<b>ТОЧНОЕ</b> название основной услуги, которая должна печататься в чеке
|-
| style="padding-left:2em; color:darkgray" |<nowiki><JoinArticleName>название услуги (например, Ранний заезд)</JoinArticleName></nowiki>
| style="padding-left:0.5em; color:darkgray" | —
| style="padding-left:0.5em; color:darkgray" |<b>ТОЧНОЕ</b> название услуги, которая не должна печататься в чеке
|-
| style="padding-left:0.5em; color:darkgray" |<nowiki></JoinArticleSettings></PosComPort></nowiki>
| style="padding-left:0.5em; color:darkgray" | —
| style="padding-left:0.5em; color:darkgray" |Окончание секции
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |'''''Актуальное!''''' <br/>Секция <b><JoinArticleSettings></b> — объединение услуг для печати в чеке. В чеке печатается услуга с MainArticleCode
|-
| style="padding-left:0.5em" |<nowiki><JoinArticleSettings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Начало секции
|-
| style="padding-left:2em" |<nowiki><MainArticleCode>(например: 100)</MainArticleCode></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |В примере 100 — код услуги «Проживание»
|-
| style="padding-left:2em" |<nowiki><JoinServicesCodes>(например: 321, 320, 323)</JoinServicesCodes></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |В примере: <br/>321 — код услуги «Обед»; <br/>320 — код услуги «Завтрак»; <br/>323 — код услуги «Ужин» <br/> При наличии в начислениях любого набора услуг (100+321 или 100+320+321+323) в чеке печатается услуга с MainServiceCode <br/>'''Количественные значения объединяемых услуг могут быть любыми и не совпадать с количеством основной услуги'''
|-
| style="padding-left:0.5em" |<nowiki></JoinArticleSettings></PosComPort></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Окончание секции
|}

<span id="Touch-M_FR-K_Settings.xml">

===Touch-M_FR-K_Settings.xml===

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

{| border="1" style="border-collapse:collapse; margin-top:0.5em" 
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><Touch-M_FR-K_Settings></b>
|-
| style="padding-left:0.5em; width: 40%"|<nowiki><Settings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Начало секции
|-
| style="padding-left:0.5em"|<nowiki><Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/></nowiki><br>
<nowiki><Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Группы тегов соответствия настроек HMS Servio и ФР «Штрих», где:
[[File:TaxShtrih.png|border|right|270px|frameless|link=]]
* FiscalTaxScheme — номер фискальной схемы в HMS Servio (Бухгалтерия/Налги/Налоги): фискальная налоговая схема, установленная для определённого налога
* DeviceFiscalTaxScheme — номер ряда из таблице налоговых ставок в Драйвере ФР Штрих
Тегов соответствия может быть несколько<br>
На рисунке приведён пример таблицы налоговых ставок
* PaymentItemSign - признак предмета расчета. Значение может быть жестко задано (см. список ниже); если значение не задано, оно подставляется автоматически из поля «Код» налоговой группы (Бухгалтерия/Налоги/Налоговые группы), установленной для услуги&nbsp;/&nbsp;товара. Используются не все предусмотренные законодательством коды.<br/> Возможные значения: 
{| class="wikitable" border="1"
|-
! style="padding-left:0.5em | Название, примечание
! style="padding-left:0.5em | Значение реквизита
! style="padding-left:0.5em | Коды в HMS «Servio»
! style="padding-left:0.5em | Значение в печатном чеке
|-
| style="padding-left:0.5em; align="Center" | Товар, Реализация товара (кроме подакцизного)
| style="padding-left:0.5em; align="Center" | 1
| style="padding-left:0.5em; align="Center" | Goods, Product
| style="padding-left:0.5em; align="Center" | Товар (Т)
|-
| style="padding-left:0.5em; align="Center" | Услуга. Выполнение услуг
| style="padding-left:0.5em; align="Center" | 4
| style="padding-left:0.5em; align="Center" | Service, HotelService, Extras, RestarauntService
| style="padding-left:0.5em; align="Center" | Услуга (У)
|-
| style="padding-left:0.5em; align="Center" | Внереализационный доход. Получение внерелизационного дохода
| style="padding-left:0.5em; align="Center" | 15
| style="padding-left:0.5em; align="Center" | Penalty
| style="padding-left:0.5em; align="Center" | Внереализационный доход
|-
| style="padding-left:0.5em; align="Center" | Курортный сбор
| style="padding-left:0.5em; align="Center" | 18
| style="padding-left:0.5em; align="Center" | TouristTax
| style="padding-left:0.5em; align="Center" | Курортный сбор
|}
{{Вставка |рис = [[Image:Clipboard.png|frameless|30px|link=]] |текст = Логика настройки параметра «PaymentItemSign» следующая: <br/> — если значение передается из HMS «Servio», в данном файле конфигурации значения не устанавливаются; <br/> — если значение из HMS «Servio» не передается (например, ресторанная система), в данной секции устанавливается соответствие признака предмета расчета налоговой группе или, если используется только одна налоговая группа, значение параметра устанавливается в теге «Advanced».
}}
|-
| style="padding-left:0.5em; width: 40%"|<nowiki><Settings></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Окончание секции
|-
| style="padding-left:2em"|<nowiki><Security></nowiki><br>
&nbsp;&nbsp;&nbsp;&nbsp;<PwdOpr>1</PwdOpr><br>
&nbsp;&nbsp;&nbsp;&nbsp;<PwdAdm>29</PwdAdm><br>
&nbsp;&nbsp;&nbsp;&nbsp;<PwdSys>30</PwdSys><br>
&nbsp;&nbsp;&nbsp;&nbsp;<PwdFisc>0</PwdFisc><br>
</Security>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Пароль ролей пользователей для выполнения операций на ФР:
* <PwdOpr>1</PwdOpr> — пароль кассира;
* <PwdAdm>29</PwdAdm> — пароль администратора;
* <PwdSys>30</PwdSys> — пароль налоговой инспекции и выполнения служебных операций (X-отчёт, Z-отчёт);
* <PwdFisc>0</PwdFisc> — пароль техника
Значения паролей не меняются
|-
| style="padding-left:0.5em|<nowiki><Advanced IsRecalcDiscountPrice="False" Timeout="10000" IsPOSTerminalPrintDublicate="False" QuantityFeedDocumentBeforeCut="4" PaymentItemSign=""/></nowiki>
| style="padding-left:0.5em" | —
| style="padding-left:0.5em" |Расширенные настройки:
* IsRecalcDiscountPrice — пересчитывать или не пересчитывать значение скидки;
* Timeout — значение таймаута на проведение операций ФР;
* IsPOSTerminalPrintDublicate — печать копии чека POS-терминала. Относится только к интегрированным терминалам;
* QuantityFeedDocumentBeforeCut — количество строк прогона бумаги перед обрезкой чека. По умолчанию «4». Для терминалов Штрих-М Сити значение «6». Для терминалов Штрих-01Ф-Лайт (с лентой шириной 58 мм) значение «6» 
|}

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

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

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

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

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

Переключение на прокси-службу состоит из трёх этапов:
# Настройка конфигурационного файла [[#HMSServioProxyClient.exe.xml|прокси-клиент]].
# Перенастройка подключения в HMS Servio (Настройки/Оборудование). В поле «IP-адрес сервера» вводится '''внутренний''' IP-адрес сервера и уникальный ключ: [[File:Proxy.png|x50px|link=]]
# Перенастройка конфигурационного файла <code>ServiceSettings</code> службы печати чеков. В теге [[#IP-адрес|<Nowiki><IpAddress></Nowiki>]] вводится локальный IP: <br> &nbsp;&nbsp;&nbsp;&nbsp;<Nowiki><IpAddress>127.0.0.1</IpAddress></Nowiki>.

===HMSServioProxyClient.exe.xml===

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

{| border="1" style="border-collapse:collapse; margin-top:0.5em" 
|-
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><Settings></b>
|-
| style="padding-left:0.5em; width: 40%"|<nowiki><Settings></nowiki>
| style="padding-left:0.5em" | —&nbsp;
| style="padding-left:0.5em" |Начало секции
|-
| style="padding-left:0.5em"|&nbsp;&nbsp;<nowiki><ProxyServerSetting ProxyServerHostNameOrIPAddress="example.com"  ProxyServerPort="XXXX"/></nowiki><br>
| style="padding-left:0.5em" | —&nbsp;
| style="padding-left:0.5em" |Тег подключения к прокси-службе сервера, где:
* ProxyServerHostNameOrIPAddress — имя DNS или IP-адрес сервера 
* ProxyServerPort — номер порта подключения прокси-службы сервера
|-
| style="padding-left:0.5em; width: 40%"|&nbsp;&nbsp;<nowiki><LocalServicesSettings></nowiki>
| style="padding-left:0.5em" | —&nbsp;
| style="padding-left:0.5em" |Начало секции
|-
| style="padding-left:0.5em"|&nbsp;&nbsp;&nbsp;&nbsp;<nowiki><LocalServiceSetting ClientKey="unic_hotel_key" LocalServiceIPAddress="XX.XX.XX.XX" LocalServicePort="XXXX"/></nowiki><br>
| style="padding-left:0.5em" | —&nbsp;
| style="padding-left:0.5em" |Тег подключения локальных служб оборудования. Настройки подключения каждого вида оборудования вводятся отдельной строкой:
* ClientKey="unic_hotel_key" — '''уникальный''' ключ для перенаправления данных с сервера к указанной локальной службе. Уникальность ключа должна поддерживаться строго: и в сети отелей, и внутри отеля для разного вида оборудования;
* LocalServiceIPAddress="127.0.0.1" — локальный IP-адрес. В случае подключения прокси-службы, в файле конфигурации <code>ServiceSettings.xml</code> службы FR должен также быть указан локальный IP-адрес в теге <Nowiki><IpAddress>127.0.0.1</IpAddress></Nowiki>;
* LocalServicePort="XXXX" — порт подключения службы, которой пересылаются данные от сервера
|-
| style="padding-left:0.5em; width: 40%"|&nbsp;&nbsp;<nowiki></LocalServicesSettings></nowiki>
| style="padding-left:0.5em" | —&nbsp;
| style="padding-left:0.5em" |Окончание секции
|-
| style="padding-left:0.5em; width: 40%"|<nowiki></Settings></nowiki>
| style="padding-left:0.5em" | —&nbsp;
| style="padding-left:0.5em" |Окончание секции
|}