Parameters for setting up connection to cash register and terminal — различия между версиями

Материал из Servio Doc
Перейти к: навигация, поиск
(→‎Touch-M_FR-K_Settings.xml)
(→‎Touch-M_FR-K_Settings.xml)
Строка 187: Строка 187:
 
| style="padding-left:0.5em"|<nowiki><Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/></nowiki><br>
 
| style="padding-left:0.5em"|<nowiki><Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/></nowiki><br>
 
<nowiki><Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/></nowiki>
 
<nowiki><Tax FiscalTaxScheme="№ схемы" DeviceFiscalTaxScheme="№ схемы" PaymentItemSign=""/></nowiki>
−
 
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" |Группы тегов соответствия настроек HMS Servio и ФР «Штрих», где:
 
| style="padding-left:0.5em" |Группы тегов соответствия настроек HMS Servio и ФР «Штрих», где:
Строка 195: Строка 194:
 
Тегов соответствия может быть несколько<br>
 
Тегов соответствия может быть несколько<br>
 
На рисунке приведён пример таблицы налоговых ставок
 
На рисунке приведён пример таблицы налоговых ставок
−
* PaymentItemSign - признак предмета расчета. Значение может быть жестко задано (см. список ниже); если значение не задано, оно подставляется автоматически из поля «Код» налоговой группы (Бухгалтерия/Налоги/Налоговые группы), установленной для услуги&nbsp;/&nbsp;товара. Используются не все предусмотренные законодательством коды.<br/> Возможные значения: Товар (1), Подакцизный товар (2), Работа (3), Услуга (4), Ставка азартной игры (5), Выигрыш азартной игры (6), Лотерейный билет (7), Выигрыш лотереи (8), Предоставление РИД (9), Платеж (10), Агентское вознаграждение (11), Составной предмет расчета (12), Иной предмет расчета (13), Имущественное право (14), Внереализационный доход (15), Страховые взносы (16), Торговый сбор (17), Курортный сбор (18)
+
* 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" | Курортный сбор
 +
|}
 
|-
 
|-
 
| style="padding-left:0.5em; width: 40%"|<nowiki><Settings></nowiki>
 
| style="padding-left:0.5em; width: 40%"|<nowiki><Settings></nowiki>

Версия 12:27, 6 сентября 2023

Параметры настройки подключения к кассе и 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> — объединение услуг для печати в чеке. Группы секций с двумя услугами. В чеке печатается услуга с MainArticleName
<JoinArticleSettings> — начало секции
<MainArticleName>название услуги (например, Проживание)</MainArticleName> — ТОЧНОЕ название основной услуги, которая должна печататься в чеке
<JoinArticleName>название услуги (например, Ранний заезд)</JoinArticleName> — ТОЧНОЕ название услуги, которая не должна печататься в чеке
</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 и ФР «Штрих», где:
TaxShtrih.png
  • FiscalTaxScheme — номер фискальной схемы в HMS Servio (Бухгалтерия/Налги/Налоги): фискальная налоговая схема, установленная для определённого налога
  • DeviceFiscalTaxScheme — номер ряда из таблице налоговых ставок в Драйвере ФР Штрих

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

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

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