Parameters for setting up connection to cash register and terminal — различия между версиями
(→ServiceSettings.xml) |
|||
(не показаны 42 промежуточных версий 1 участника) | |||
Строка 4: | Строка 4: | ||
Ниже приведены параметры настройки файлов конфигурации: | Ниже приведены параметры настройки файлов конфигурации: | ||
− | * ServiceSettings.xml — единый конфигурационный файл; | + | * [[#ServiceSettings.xml|ServiceSettings.xml]] — единый конфигурационный файл; |
− | * Touch-M_FR-K_Settings.xml — файл настройки подключения к ФР «Штрих». | + | * [[#Touch-M_FR-K_Settings.xml|Touch-M_FR-K_Settings.xml]] — файл настройки подключения к ФР «Штрих». |
+ | <span id="ServiceSettings.xml"> | ||
===ServiceSettings.xml=== | ===ServiceSettings.xml=== | ||
Строка 23: | Строка 24: | ||
}} | }} | ||
− | + | {| border="1" style="border-collapse:collapse; margin-top:0.5em" | |
− | + | ||
− | {| 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" |<nowiki>< | + | | style="padding-left:0.5em; width: 45%"|<nowiki><ServiceSettings></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |Начало секции |
|- | |- | ||
− | | style="padding-left: | + | | 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" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |Внутренний IP-адрес подключения кассы. Определяется через cmd/ipconfig |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><ComPort>номер порта (например, 3)</ComPort></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |COM-port подключения ФР к компьютеру |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><ComBods>скорость обмена (например, 115200)</ComBods></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |Скорость обмена данными между кассой и службой ФР |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><Debug>True</Debug></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |Включение/отключение расширенного логирования |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><GroupArticles>False</GroupArticles></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" |< | + | | style="padding-left:0.5em" |Включение/отключение объединения услуг в чеке ФР. Правила объединения услуг задаются в секциях [[#JoinArticleSettings|<nowiki><JoinArticleSettings></nowiki>]] |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><IsReceiptTimeoutClose>True</IsReceiptTimeoutClose></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |Действие с чеком в случае истечения времени ожидания. True - чек закрывается, False - чек аннулируется; |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><CashierName /></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" | | + | | style="padding-left:0.5em" |ФИО кассира. Если заполнено, передаётся на печать в чеке |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><CashierId>0</CashierId></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | | style="padding-left:0.5em" |< | + | | style="padding-left:0.5em" |ID кассира в HMS Servio (Настройки/Персонал/Пользователь. Номер в выбранной кассе). Передаётся на печать в чеке, если параметр <CashierName> не заполнен |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><DetailingReciepts>True</DetailingReciepts></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Не используется. На печать чека не влияет | |
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><LoggingDetailsReceipts>True</LoggingDetailsReceipts></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Включение/отключение логирования детализации чеков | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><WaitBeforeStartService>0</WaitBeforeStartService></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Включение/отключение паузы перед запуском сервиса, сек. Может быть полезна службы при запуске на медленных терминалах | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><IpPort>Номер порта (Например, 2003)</IpPort></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Порт прослушивания [[#IP-адрес|IP-адреса]] кассы | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><CheckTimezoneTransitionTime /></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Время проверки перехода на летнее/зимнее время | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><SendCustomerEmail>True</SendCustomerEmail></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Включение/отключение отправки чеков на адрес электронной почты плательщика при её наличии в счете | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><SendCustomerPhoneInsteadEmail>False</SendCustomerPhoneInsteadEmail></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Включение/отключение отправки чеков по SMS на номер телефона плательщика при его наличии в счёте, вместо отправке по электронной почте | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><SuffixForArticle /></nowiki> |
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
− | + | | style="padding-left:0.5em" |Суффикс для расширения артикула | |
− | + | ||
− | | style="padding-left:0.5em" | | + | |
|- | |- | ||
− | | style="padding-left: | + | | style="padding-left:2em" |<nowiki><IsPrintDocument>True</IsPrintDocument></nowiki> |
| style="padding-left:0.5em" | — | | 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)</JJoinServicesCodes></nowiki> | ||
+ | | style="padding-left:0.5em" | — | ||
+ | | style="padding-left:0.5em" |В примере: <br/>321 — код услуги «Обед»; <br/>320 — код услуги «Завтрак»; <br/>323 — код услуги «Ужин» <br/> При наличии в начислениях любой пары услуг (100+321 или 100+320 или 100+323) в чеке печатается услуга с MainServiceCode | ||
+ | |- | ||
+ | | 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=" | + | |- |
+ | | 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" |Начало секции | ||
+ | |- | ||
+ | | 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 - признак предмета расчета. Значение может быть жестко задано (см. список ниже); если значение не задано, оно подставляется автоматически из поля «Код» налоговой группы (Бухгалтерия/Налоги/Налоговые группы), установленной для услуги / товара. Используются не все предусмотренные законодательством коды.<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> | ||
+ | <PwdOpr>1</PwdOpr><br> | ||
+ | <PwdAdm>29</PwdAdm><br> | ||
+ | <PwdSys>30</PwdSys><br> | ||
+ | <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 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> <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" | — | ||
+ | | style="padding-left:0.5em" |Начало секции | ||
+ | |- | ||
+ | | style="padding-left:0.5em"| <nowiki><ProxyServerSetting ProxyServerHostNameOrIPAddress="example.com" ProxyServerPort="XXXX"/></nowiki><br> | ||
+ | | style="padding-left:0.5em" | — | ||
+ | | style="padding-left:0.5em" |Тег подключения к прокси-службе сервера, где: | ||
+ | * ProxyServerHostNameOrIPAddress — имя DNS или IP-адрес сервера | ||
+ | * ProxyServerPort — номер порта подключения прокси-службы сервера | ||
+ | |- | ||
+ | | style="padding-left:0.5em; width: 40%"| <nowiki><LocalServicesSettings></nowiki> | ||
+ | | style="padding-left:0.5em" | — | ||
+ | | style="padding-left:0.5em" |Начало секции | ||
+ | |- | ||
+ | | style="padding-left:0.5em"| <nowiki><LocalServiceSetting ClientKey="unic_hotel_key" LocalServiceIPAddress="XX.XX.XX.XX" LocalServicePort="XXXX"/></nowiki><br> | ||
+ | | style="padding-left:0.5em" | — | ||
+ | | 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%"| <nowiki></LocalServicesSettings></nowiki> | ||
+ | | style="padding-left:0.5em" | — | ||
+ | | style="padding-left:0.5em" |Окончание секции | ||
+ | |- | ||
+ | | style="padding-left:0.5em; width: 40%"|<nowiki></Settings></nowiki> | ||
+ | | style="padding-left:0.5em" | — | ||
+ | | style="padding-left:0.5em" |Окончание секции | ||
+ | |} |
Текущая версия на 15:21, 6 сентября 2023
Параметры настройки подключения к кассе и POS-терминалу
Ниже приведены параметры настройки файлов конфигурации:
- ServiceSettings.xml — единый конфигурационный файл;
- Touch-M_FR-K_Settings.xml — файл настройки подключения к ФР «Штрих».
ServiceSettings.xml
Параметры, относящиеся к настройке автозакрытия смены:
описаны в статье «Автозакрытие смены в сервисе ФР». |
Секция <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-терминале:
|
</PosTerminalSettings> | — | Окончание секции |
<JoinArticleSettings> — объединение услуг для печати в чеке | ||
Устаревшее! Секции <JoinArticleSettings> — объединение услуг для печати в чеке. Группы секций с двумя услугами. В чеке печатается услуга с MainArticleName | ||
<JoinArticleSettings> | — | Начало секции |
<MainArticleName>название услуги (например, Проживание)</MainArticleName> | — | ТОЧНОЕ название основной услуги, которая должна печататься в чеке |
<JoinArticleName>название услуги (например, Ранний заезд)</JoinArticleName> | — | ТОЧНОЕ название услуги, которая не должна печататься в чеке |
</JoinArticleSettings></PosComPort> | — | Окончание секции |
Актуальное! Секция <JoinArticleSettings> — объединение услуг для печати в чеке. В чеке печатается услуга с MainArticleCode | ||
<JoinArticleSettings> | — | Начало секции |
<MainArticleCode>(например: 100)</MainArticleCode> | — | В примере 100 — код услуги «Проживание» |
<JoinServicesCodes>(например: 321, 320, 323)</JJoinServicesCodes> | — | В примере: 321 — код услуги «Обед»; 320 — код услуги «Завтрак»; 323 — код услуги «Ужин» При наличии в начислениях любой пары услуг (100+321 или 100+320 или 100+323) в чеке печатается услуга с MainServiceCode |
</JoinArticleSettings></PosComPort> | — | Окончание секции |
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 и ФР «Штрих», где:
Тегов соответствия может быть несколько
| ||||||||||||||||||||||
<Settings> | — | Окончание секции | ||||||||||||||||||||||
<Security> <PwdOpr>1</PwdOpr> |
— | Пароль ролей пользователей для выполнения операций на ФР:
Значения паролей не меняются | ||||||||||||||||||||||
<Advanced IsRecalcDiscountPrice="False" Timeout="10000" IsPOSTerminalPrintDublicate="False" QuantityFeedDocumentBeforeCut="4" PaymentItemSign=""/> | — | Расширенные настройки:
|
Подключение прокси-службы
Прокси-служба предназначена для установления соединения оборудования на объектах с сервером без предоставления оборудованию "белых" IP-адресов. Как результат, оборудование может продолжать функционировать в случае обрыва внешнего интернет-соединения при переключении, например, на WiFi, в том числе, раздаваемый со смартфона.
Прокси-служба состоит из серверной и клиентской частей.
Серверная часть устанавливается на сервере. В данном документе настройка не рассматривается.
Клиентская часть устанавливается на компьютерах с подключенным оборудованием. Рекомендуется устанавливать отдельным каталогом в каталог со службами HMS Servio. Например: C:\HMS_Servio\HMSServioProxyClient.
Переключение на прокси-службу состоит из трёх этапов:
- Настройка конфигурационного файла прокси-клиент.
- Перенастройка подключения в HMS Servio (Настройки/Оборудование). В поле «IP-адрес сервера» вводится внутренний IP-адрес сервера и уникальный ключ:
- Перенастройка конфигурационного файла
ServiceSettings
службы печати чеков. В теге <IpAddress> вводится локальный IP:
<IpAddress>127.0.0.1</IpAddress>.
HMSServioProxyClient.exe.xml
В конфигурационном файле HMSServioProxyClient.exe.xml задаются настройки подключения клиента
Секция <Settings> | ||
<Settings> | — | Начало секции |
<ProxyServerSetting ProxyServerHostNameOrIPAddress="example.com" ProxyServerPort="XXXX"/> |
— | Тег подключения к прокси-службе сервера, где:
|
<LocalServicesSettings> | — | Начало секции |
<LocalServiceSetting ClientKey="unic_hotel_key" LocalServiceIPAddress="XX.XX.XX.XX" LocalServicePort="XXXX"/> |
— | Тег подключения локальных служб оборудования. Настройки подключения каждого вида оборудования вводятся отдельной строкой:
|
</LocalServicesSettings> | — | Окончание секции |
</Settings> | — | Окончание секции |