Parameters for setting up connection to cash register and terminal

Материал из Servio Doc
Перейти к: навигация, поиск

Параметры настройки подключения к кассе и 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> — операции с ФР
<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 (например, портье закрыл смену вручную), то первая из открывшихся смен закроется автоматически.

Clipboard.png К одной службе ФР (к одной кассе) может быть подключено несколько POS-систем, например: HMS и RestoranPOS-системы не имеют информации о работе службы ФР.
Источник — «http://doc.servio.ru/index.php?title=Parameters_for_setting_up_connection_to_cash_register_and_terminal&oldid=5678»