Parameters for setting up connection to cash register and terminal — различия между версиями
Материал из Servio Doc
(→ServiceSettings.xml) |
|||
| Строка 27: | Строка 27: | ||
| Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><ServiceSettings></b> — операции с ФР | | Style="background-color:gainsboro" colspan="3" align="Center" |Секция <b><ServiceSettings></b> — операции с ФР | ||
| + | |- | ||
| + | | style="padding-left:0.5em" |<nowiki><ServiceSettings></nowiki> | ||
| + | | style="padding-left:0.5em" | — | ||
| + | | style="padding-left:0.5em" |начало секции; | ||
|- | |- | ||
| Строка 101: | Строка 105: | ||
| style="padding-left:0.5em" |<span style="color:red"> ;</span> | | style="padding-left:0.5em" |<span style="color:red"> ;</span> | ||
|- | |- | ||
| − | + | | 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="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" |<nowiki><PosComPort>номер порта (например, 9)</PosComPort></nowiki> | ||
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
| style="padding-left:0.5em" |номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет; | | style="padding-left:0.5em" |номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет; | ||
|- | |- | ||
| − | |||
| style="padding-left:0.5em" |<nowiki><PosTimeOut>таймаут (например, 90000)</PosTimeOut></nowiki> | | style="padding-left:0.5em" |<nowiki><PosTimeOut>таймаут (например, 90000)</PosTimeOut></nowiki> | ||
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
| style="padding-left:0.5em" |таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет; | | style="padding-left:0.5em" |таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет; | ||
|- | |- | ||
| − | |||
| style="padding-left:0.5em" |<nowiki><PrintPosReceipt>True</PrintPosReceipt></nowiki> | | 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" |Включение/отключение печати чека банковского терминала на принтере ФР; | | style="padding-left:0.5em" |Включение/отключение печати чека банковского терминала на принтере ФР; | ||
|- | |- | ||
| − | |||
| style="padding-left:0.5em" |<nowiki><PrintPosReceiptInCheck>true</PrintPosReceiptInCheck></nowiki> | | 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" |Включение/отключение печати чека банковского терминала вместе с чеком ФР | | style="padding-left:0.5em" |Включение/отключение печати чека банковского терминала вместе с чеком ФР | ||
|- | |- | ||
| − | |||
| style="padding-left:0.5em" |<nowiki><CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant></nowiki> | | style="padding-left:0.5em" |<nowiki><CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant></nowiki> | ||
| style="padding-left:0.5em" | — | | style="padding-left:0.5em" | — | ||
| style="padding-left:0.5em" |Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный неверный номер «Идентификатор мерчанта» (Настройки/ОБорудование/Кассы/Тип оплат с группой оплат «Кредитная карта») | | style="padding-left:0.5em" |Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный неверный номер «Идентификатор мерчанта» (Настройки/ОБорудование/Кассы/Тип оплат с группой оплат «Кредитная карта») | ||
| + | |- | ||
| + | | style="padding-left:0.5em" |<nowiki><PosPaidTypes>1</PosPaidTypes></nowiki> | ||
| + | | style="padding-left:0.5em" | — | ||
| + | | style="padding-left:0.5em" |<span style="color:red"> ?</span> | ||
| + | |- | ||
| + | | Style="background-color:gainsboro" colspan="3" align="Center" |Секции <span id = "JoinArticleSettings"></span id> <b><JoinArticleSettings></b> — объединение услуг для печати в чеке. Группы секций с двумя услугами. В чеке печатается услуга с MainArticleName | ||
| + | |- | ||
| + | | style="padding-left:0.5em" |<nowiki><JoinArticleSettings></nowiki> | ||
| + | | style="padding-left:0.5em" | — | ||
| + | | style="padding-left:0.5em" |начало секции | ||
| + | |- | ||
| + | | style="padding-left:0.5em" |<nowiki><MainArticleName></nowiki><b>ТОЧНОЕ</b> название услуги (например, Проживание)<nowiki></MainArticleName></nowiki> | ||
| + | | style="padding-left:0.5em" | — | ||
| + | | style="padding-left:0.5em" |Название основной услуги, которая будет печататься в чеке | ||
| + | |- | ||
| + | | style="padding-left:0.5em" |<nowiki><JoinArticleName></nowiki><b>ТОЧНОЕ</b> название услуги (например, Ранний заезд)<nowiki></JoinArticleName></nowiki> | ||
| + | | style="padding-left:0.5em" | — | ||
| + | | style="padding-left:0.5em" |Название услуги, которая будет скрыта в чеке (не будет печататься в чеке) | ||
| + | |- | ||
| + | | style="padding-left:0.5em" |<nowiki></JoinArticleSettings></PosComPort></nowiki> | ||
| + | | style="padding-left:0.5em" | — | ||
| + | | style="padding-left:0.5em" |окончание секции | ||
|} | |} | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
===Алгоритм закрытия:=== | ===Алгоритм закрытия:=== | ||
Версия 11:23, 7 июня 2022
Параметры настройки подключения к кассе и POS-терминалу
Ниже приведены параметры настройки файлов конфигурации:
- ServiceSettings.xml — единый конфигурационный файл;
- Touch-M_FR-K_Settings.xml — файл настройки подключения к ФР «Штрих».
ServiceSettings.xml
|
Параметры, относящиеся к настройке автозакрытия смены:
описаны в статье «Автозакрытие смены в сервисе ФР». |
| Секция <ServiceSettings> — операции с ФР | ||
| <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> | — | ; |
| </ServiceSettings> | — | окончание секции; |
| Секция <PosTerminalSettings> — операции с банковским терминалом | ||
| <PosComPort>номер порта (например, 9)</PosComPort> | — | номер порта подключения POS-терминала при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет; |
| <PosTimeOut>таймаут (например, 90000)</PosTimeOut> | — | таймаут на проведение операции POS-терминалом при подключении напрямую. При взаимодействии через библиотеки параметр значения не имеет; |
| <PrintPosReceipt>True</PrintPosReceipt> | — | Включение/отключение печати чека банковского терминала на принтере ФР; |
| <PrintPosReceiptInCheck>true</PrintPosReceiptInCheck> | — | Включение/отключение печати чека банковского терминала вместе с чеком ФР |
| <CloseReceiptWithIncorrectMerchant>False</CloseReceiptWithIncorrectMerchant> | — | Разрешение/запрет закрытия чека банковского терминала, если в настройке операции с группой оплат «Кредитная карта» введён неверный неверный номер «Идентификатор мерчанта» (Настройки/ОБорудование/Кассы/Тип оплат с группой оплат «Кредитная карта») |
| <PosPaidTypes>1</PosPaidTypes> | — | ? |
| Секции <JoinArticleSettings> — объединение услуг для печати в чеке. Группы секций с двумя услугами. В чеке печатается услуга с MainArticleName | ||
| <JoinArticleSettings> | — | начало секции |
| <MainArticleName>ТОЧНОЕ название услуги (например, Проживание)</MainArticleName> | — | Название основной услуги, которая будет печататься в чеке |
| <JoinArticleName>ТОЧНОЕ название услуги (например, Ранний заезд)</JoinArticleName> | — | Название услуги, которая будет скрыта в чеке (не будет печататься в чеке) |
| </JoinArticleSettings></PosComPort> | — | окончание секции |
Алгоритм закрытия:
Во время, заданное в 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 (например, портье закрыл смену вручную), то первая из открывшихся смен закроется автоматически.
|
|
К одной службе ФР (к одной кассе) может быть подключено несколько POS-систем, например: HMS и RestoranPOS-системы не имеют информации о работе службы ФР. |
