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

Материал из Servio Doc
Перейти к: навигация, поиск
(ServiceSettings.xml)
Строка 22: Строка 22:
 
описаны в статье [[Автозакрытие смены в сервисе ФР|«Автозакрытие смены в сервисе ФР»]].
 
описаны в статье [[Автозакрытие смены в сервисе ФР|«Автозакрытие смены в сервисе ФР»]].
 
}}
 
}}
 
Секция <code><b><nowiki><ServiceSettings.xml></nowiki></b></code>:
 
  
 
{| border="1" style="border-collapse:collapse; margin-top:0.5em" width:70%
 
{| border="1" style="border-collapse:collapse; margin-top:0.5em" width:70%
 
|-
 
|-
! Style="background-color:gainsboro" colspan="3" |Начало секции <b><ServiceSettings.xml></b>
 
  
 +
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><ServiceSettings></b> — операции с ФР
 
|-
 
|-
| style="padding-left:0.5em" |<nowiki><IpAddress>10.2.7.200</IpAddress></nowiki>
+
 
 +
| style="padding-left:0.5em" |<nowiki><IpAddress>адрес (например 10.2.7.200)</IpAddress></nowiki>
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" |внутренний адрес подключения кассы. Определяется через cmd/ipconfig;
 
| style="padding-left:0.5em" |внутренний адрес подключения кассы. Определяется через cmd/ipconfig;
 
|-
 
|-
| style="padding-left:0.5em" |<nowiki><ComPort>3</ComPort></nowiki>
+
| style="padding-left:0.5em" |<nowiki><ComPort>номер порта (например, 3)</ComPort></nowiki>
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" |COM-port подключения ФР к компьютеру;
 
| style="padding-left:0.5em" |COM-port подключения ФР к компьютеру;
 
|-
 
|-
| style="padding-left:0.5em" |<nowiki><ComBods>115200</ComBods></nowiki>
+
| style="padding-left:0.5em" |<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" |скорость обмена данными между кассой и службой ФР;
Строка 101: Строка 100:
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" | —
 
| style="padding-left:0.5em" |<span style="color:red"> ;</span>
 
| style="padding-left:0.5em" |<span style="color:red"> ;</span>
 +
|-
 +
 +
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><PosTerminalSettings></b> — операции с банковским терминалом
 +
|-
 +
 +
| style="padding-left:0.5em" |<nowiki><PosComPort>номер порта (например, 9)</PosComPort></nowiki>
 +
| style="padding-left:0.5em" | —
 +
| style="padding-left:0.5em" |номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
 +
|-
 +
 +
| style="padding-left:0.5em" |<nowiki><PosTimeOut>таймаут (например, 90000)</PosTimeOut></nowiki>
 +
| style="padding-left:0.5em" | —
 +
| style="padding-left:0.5em" |таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
 +
|-
 +
 +
| style="padding-left:0.5em" |<nowiki><PrintPosReceipt>True</PrintPosReceipt></nowiki>
 +
| style="padding-left:0.5em" | —
 +
| style="padding-left:0.5em" |Включение/отключение печати чека банковского терминала на принтере ФР;
 +
|-
 +
 +
| style="padding-left:0.5em" |<nowiki><PrintPosReceiptInCheck>true</PrintPosReceiptInCheck></nowiki>
 +
| style="padding-left:0.5em" | —
 +
| style="padding-left:0.5em" |Включение/отключение печати чека банковского терминала вместе с чеком ФР
 +
|-
 +
 +
| style="padding-left:0.5em" |<nowiki><CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant></nowiki>
 +
| style="padding-left:0.5em" | —
 +
| style="padding-left:0.5em" |Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный неверный номер «Идентификатор мерчанта» (Настройки/ОБорудование/Кассы/Тип оплат с группой оплат «Кредитная карта»)
 +
 
|}
 
|}
 +
 +
<PosTerminalSettings>    <PosComPort>9</PosComPort>    <PosTimeOut>90000</PosTimeOut>    <PrintPosReceipt>True</PrintPosReceipt>    <PrintPosReceiptInCheck>true</PrintPosReceiptInCheck>    <CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant>    <PosPaidTypes>1</PosPaidTypes>  </PosTerminalSettings>
 +
  
  

Версия 11:03, 7 июня 2022

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

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

  • ServiceSettings.xml — единый конфигурационный файл;
  • Touch-M_FR-K_Settings.xml — файл настройки подключения к ФР «Штрих».

ServiceSettings.xml

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

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

Секция <ServiceSettings> — операции с ФР
<IpAddress>адрес (например 10.2.7.200)</IpAddress> внутренний адрес подключения кассы. Определяется через cmd/ipconfig;
<ComPort>номер порта (например, 3)</ComPort> COM-port подключения ФР к компьютеру;
<ComBods>скорость обмена (например, 115200)</ComBods> скорость обмена данными между кассой и службой ФР;
<Debug>True</Debug> включение/отключение расширенного логирования;
<GroupArticles>False</GroupArticles> включение/отключение объединения услуг в чеке ФР. Правила объединения услуг задаются в секциях <JoinArticleSettings>;
<IsReceiptTimeoutClose>True</IsReceiptTimeoutClose>  ;;
<CashierName /> ФИО кассира;
<DetailingReciepts>True</DetailingReciepts>  ;;
<LoggingDetailsReceipts>True</LoggingDetailsReceipts>  ;
<WaitBeforeStartService>0</WaitBeforeStartService>  ;
<IpPort>2003</IpPort>  ;
<CheckTimezoneTransitionTime />  ;
<SendCustomerEmail>True</SendCustomerEmail> Отправлять чек на адрес электронной почты плательщика при её наличии в счете
<SendCustomerPhoneInsteadEmail>False</SendCustomerPhoneInsteadEmail> Отправлять чек по SMS на номер телефона плательщика при его наличии в счёте, вместо отправке по электронной почте
<SuffixForArticle />  ;
<IsPrintDocument>True</IsPrintDocument> Печатать чек ;
<PrinterServiceIpPort>127.0.0.1:8636</PrinterServiceIpPort>  ;
<PrinterName>POS-80-Series</PrinterName>  ;
Секция <PosTerminalSettings> — операции с банковским терминалом
<PosComPort>номер порта (например, 9)</PosComPort> номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
<PosTimeOut>таймаут (например, 90000)</PosTimeOut> таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет;
<PrintPosReceipt>True</PrintPosReceipt> Включение/отключение печати чека банковского терминала на принтере ФР;
<PrintPosReceiptInCheck>true</PrintPosReceiptInCheck> Включение/отключение печати чека банковского терминала вместе с чеком ФР
<CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant> Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный неверный номер «Идентификатор мерчанта» (Настройки/ОБорудование/Кассы/Тип оплат с группой оплат «Кредитная карта»)
<PosTerminalSettings>    <PosComPort>9</PosComPort>    <PosTimeOut>90000</PosTimeOut>    <PrintPosReceipt>True</PrintPosReceipt>    <PrintPosReceiptInCheck>true</PrintPosReceiptInCheck>    <CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant>    <PosPaidTypes>1</PosPaidTypes>  </PosTerminalSettings>


<JoinArticleSettings>

Алгоритм закрытия:

Во время, заданное в ShiftCloseTime, запускается процедура закрытия смены в сервисе ФР.
Печатается X-отчёт, затем Z-отчёт.
Для ФР «Мария 301МТМ»: если в CashOutBeforeShiftClose установлено «True», выполняется служебное изъятие средств. Тип служебного изъятия определяется параметром CashOutType: 1 - вся сумма в смене, 2 - за исключением разменной монеты, 3- раздельно (сначала разменная монета, потом остальное).
Сумма разменной монеты (остаток после закрытия смены) устанавливается в параметре FractionalCoins. Для всех ФР, за исключением «Мария 301МТМ», устанавливается значение «0».
С начала автозакрытия в течение времени (в минутах), заданного в WaitAfterClosingShift, сервис ФР не отвечает ни на какие запросы. Это время требуется для выполнения служебных операций.
По окончании времени ShiftCloseTime + WaitAfterClosingShift можно начинать выполнение операций с ФР.
Операции закрытия смены фиксируются в log-файле службы ФР.

В запросе статуса ФР по команде DeviceInfo выводится информация по автозакрытию смены:

  • WaitAfterClosingShift — заблокирован ли ФР после автозакрытия смены;
  • LastAutoClosingShiftDate — дата последнего удачного автозакрытия смены;
  • NextAutoClosingShiftDate — дата следующего автозакрытия смены;
  • OpenSessionSumm — средства в ФР в текущей смене.

Особенности:

Если в настройке кассы в HMS («Настройки/Оборудование/Кассы») не установлен флаг «Раздельное закрытие смен», то выполнение Z-отчета по кассе закроет фискальную смену в HMS.
Если в момент начала автозакрытия нет открытых фискальных смен HMS (например, портье закрыл смену вручную), то первая из открывшихся смен закроется автоматически.

Clipboard.png К одной службе ФР (к одной кассе) может быть подключено несколько POS-систем, например: HMS и RestoranPOS-системы не имеют информации о работе службы ФР.