Сервер касс — различия между версиями

Материал из TaxiMaster
Перейти к: навигация, поиск
(Настройки сервера касс в ТМ)
(Настройка облачного сервера касс)
 
(не показано 10 промежуточных версий этого же участника)
Строка 17: Строка 17:
  
 
== Настройка локального сервера касс ==
 
== Настройка локального сервера касс ==
'''Настройки сервера касс''' (TMCashierServer) - приложение для интеграции с локальными устройствами ККТ. Данное приложение устанавливается вместе с серверной частью Такси-Мастер.
+
Настройка работы сервера касс производится в [[Панель управления ТМ|Панели управления ТМ]] на странице "Сервер касс".
  
{{info|В локальном сервере касс доступна интеграция с устройствами АТОЛ 11Ф и АТОЛ 20Ф. Рекомендуется использовать только указанные модели устройств. <br />
+
== Добавление устройства ==
 +
Добавить устройство ККТ можно в [[Панель управления ТМ|Панели управления ТМ]] на странице "Сервер касс" на вкладке "Устройства".
 +
 
 +
{{info|В локальном сервере касс доступна интеграция с устройствами:
 +
* АТОЛ 11Ф
 +
* АТОЛ 15Ф
 +
* АТОЛ 20Ф
 +
* АТОЛ 22Ф
 +
* (АТОЛ FPrint-22ПТК)
 +
* АТОЛ 25Ф
 +
* АТОЛ 27Ф
 +
* АТОЛ 30Ф
 +
* АТОЛ 50Ф
 +
* АТОЛ 52Ф
 +
* АТОЛ 55Ф
 +
* АТОЛ 60Ф
 +
* АТОЛ 77Ф
 +
* АТОЛ 90Ф
 +
* АТОЛ 91Ф
 +
* АТОЛ 92Ф
 +
 
 +
Рекомендуется использовать только указанные модели устройств. <br />
  
 
Для работы с устройствами АТОЛ необходимо дополнительно установить на компьютер драйвер ККТ АТОЛ версии 10. <br />
 
Для работы с устройствами АТОЛ необходимо дополнительно установить на компьютер драйвер ККТ АТОЛ версии 10. <br />
Строка 25: Строка 46:
 
Скачать нужный драйвер можно с сайта АТОЛ (https://is.gd/c2I4CD). Устанавливать необходимо 32-х битную версию драйвера.
 
Скачать нужный драйвер можно с сайта АТОЛ (https://is.gd/c2I4CD). Устанавливать необходимо 32-х битную версию драйвера.
 
}}
 
}}
 
[[Файл:Настройка локального сервера касс.png|центр]]
 
 
Сервер касс:
 
* '''Путь''' - расположение файла TMCashierServer.exe.
 
* '''Локальный порт''' - порт для взаимодействия с TMServer. По умолчанию номер порта 30001. <br />
 
 
TMServer:
 
* '''Адрес''' TMServer-а.
 
* '''Порт TM API'''.
 
* '''API ключ TMПлатформы''' - совпадает с {{путь|Файл - Настройки - ТМПлатформа - API-ключ}}.<br />
 
 
Устройства:
 
* Список устройств ККТ и их текущие статусы отображаются в таблице.
 
  
 
[[Файл:Добавление устройства ККТ.png|центр]]
 
[[Файл:Добавление устройства ККТ.png|центр]]
Строка 49: Строка 56:
 
** Ethernet - устройство ККТ подключено Ethernet сеть, тогда указывается IP и порт ККТ.
 
** Ethernet - устройство ККТ подключено Ethernet сеть, тогда указывается IP и порт ККТ.
 
* '''Устанавливать флаг "электронный чек"''' - устанавливается, если печатать бумажный чек не нужно. Но, если в заказе не указан номер телефона и/или email, то бумажный чек будет печататься в любом случае.
 
* '''Устанавливать флаг "электронный чек"''' - устанавливается, если печатать бумажный чек не нужно. Но, если в заказе не указан номер телефона и/или email, то бумажный чек будет печататься в любом случае.
 +
* '''Номер телефона по умолчанию''', если в заказе не определен номер телефона и E-mail.
 
* '''Активно''' - признак активности ККТ.
 
* '''Активно''' - признак активности ККТ.
  
 
== Настройка облачного сервера касс ==
 
== Настройка облачного сервера касс ==
'''Облачный сервер касс''' - веб-сервис, который позволяет взаимодействовать TMServer-у службы такси с сервисами онлайн касс. Доступна интеграция с сервисом АТОЛ Онлайн. <br />
+
'''Облачный сервер касс''' - веб-сервис, который позволяет взаимодействовать TMServer-у службы такси с сервисами онлайн касс.  
  
Настройка облачного сервера касс производится специалистами ООО БИТ «Мастер».
+
Доступна интеграция с сервисом [https://www.atol.ru/catalog/atol-online/ АТОЛ Онлайн].
 +
 
 +
Для фискализации как наличных, так и безналичных платежей, при заключении договора с АТОЛ, нужно выбрать тип облачной кассы "АТОЛ Казначей ФА".<br />
 +
 
 +
Настройка взаимодействия облачного сервера касс с Такси-Мастер производится специалистами ООО БИТ «Мастер».
  
 
== Настройки сервера касс в ТМ ==
 
== Настройки сервера касс в ТМ ==
Использование сервера касс включается в {{путь|Файл - Настройки - Сервер касс}} (данный раздел отображается только при наличии специальной лицензии в ключе).  
+
Использование сервера касс включается [[Справочник "Группы экипажей"#Сервер касс|в карточке группы экипажей на вкладке "Сервер касс"]].
 +
 
 +
Настройки сервера касс находятся в {{путь|Файл - Настройки - Сервер касс}} (данный раздел отображается только при наличии специальной лицензии в ключе).  
  
 
[[Файл:Настройки сервера касс в ТМ.png|центр]]
 
[[Файл:Настройки сервера касс в ТМ.png|центр]]
  
* '''Использовать сервер касс''' - регулирует включение/выключение функционала, связанного с проведением фискальных операций.
 
 
* '''Адрес''' и '''порт''' локального сервера касс.
 
* '''Адрес''' и '''порт''' локального сервера касс.
 
* '''Атрибут, обозначающий, что по заказу нужно делать фискальную операцию''' - атрибут заказа, при наличии которого по заказу всегда будет происходить фискализация.
 
* '''Атрибут, обозначающий, что по заказу нужно делать фискальную операцию''' - атрибут заказа, при наличии которого по заказу всегда будет происходить фискализация.
Строка 69: Строка 82:
  
 
== Настройки сервера касс в группах экипажей ==
 
== Настройки сервера касс в группах экипажей ==
В карточке [[Справочник "Группы экипажей"#Сервер касс|группы экипажей на вкладке '''Сервер касс''']] можно настроить взаимодействие группы экипажей и сервера касс.
+
В карточке [[Справочник "Группы экипажей"#Сервер касс|группы экипажей на вкладке '''Сервер касс''']] можно включить использование сервера касс и настроить взаимодействие группы экипажей и сервера касс.
  
 
== Отображение фискальных операций ==
 
== Отображение фискальных операций ==
Созданные фискальные операции и их статус можно увидеть в ТМ в окне "Клиенты - Фискальные операции":
+
Созданные фискальные операции и их статус можно увидеть в ТМ Рабочее место в окне "'''Клиенты''' - '''Фискальные операции'''":
  
 
[[Файл:Окно Клиенты - Фискальные операции.png|центр]]
 
[[Файл:Окно Клиенты - Фискальные операции.png|центр]]
Строка 83: Строка 96:
 
Экран печати чека будет появляться после нажатия кнопки "Успешно" в экране завершения поездки при условии, что в настройках [[TMDriver]] выбран какой-то принтер, или если по заказу должна проводиться фискальная операция.
 
Экран печати чека будет появляться после нажатия кнопки "Успешно" в экране завершения поездки при условии, что в настройках [[TMDriver]] выбран какой-то принтер, или если по заказу должна проводиться фискальная операция.
  
[[Файл:Работа с фискальными чеками в TMDriver.png|центр|250px]]
+
Пока в TMDriver отображается экран печати чека, заказ в ТМ находится в состоянии типа "В работе". Заказ будет завершаться в ТМ только после закрытия этого экрана. Для экрана печати чека действует автозакрытие по настройке из групп экипажей {{путь|Модуль "Связь с водителями" - Общие - При открытии чека заказа в TMDriver автоматически завершать заказ успешно через N секунд}}.
  
Пока в TMDriver отображается экран печати чека, заказ в ТМ находится в состоянии типа "В работе". Заказ будет завершаться в ТМ только после закрытия этого экрана. Для экрана печати чека действует автозакрытие по настройке из групп экипажей {{путь|Модуль "Связь с водителями" - Общие - При открытии чека заказа в TMDriver автоматически завершать заказ успешно через N секунд}}.<br />
+
Если у водителя нет своего ККТ, и по заказу требуется фискальная операция, то при переходе в экран печати чека TMDriver будет отправлять в сервер запрос на проведение фискальной операции. После этого будет включаться ожидание результата в течение времени, которое задается в группе экипажей в настройке {{путь|Сервер касс - Минимальное время ожидания фискальных данных для печати чека в TMDriver}}. До истечения этого времени нельзя будет закрыть экран печати чека. Если за указанное время результат проведения фискальной операции так и не будет получен, то можно будет распечатать на Bluetooth-принтере обычный чек без фискальных данных.
  
Если у водителя нет своего ККТ, и по заказу требуется фискальная операция, то при переходе в экран печати чека TMDriver будет отправлять в сервер запрос на проведение фискальной операции. После этого будет включаться ожидание результата в течение времени, которое задается в группе экипажей в настройке {{путь|Сервер касс - Минимальное время ожидания фискальных данных для печати чека в TMDriver}}. До истечения этого времени нельзя будет закрыть экран печати чека. Если за указанное время результат проведения фискальной операции так и не будет получен, то можно будет распечатать на блютуз принтере обычный чек без фискальных данных.<br />
+
После успешного проведения фискальной операции через сервер касс, в TMDriver на экране печати чека будет отображаться QR-код для проверки чека. Такой же точно код будет выводиться и в бумажный чек, если делается печать чека на принтере. Пассажир сможет через специальное приложение (https://play.google.com/store/apps/details?id=ru.fns.billchecker&hl=ru, https://itunes.apple.com/ru/app/проверка-кассового-чека-в-фнс-россии/id1169353005?mt=8) распознать QR-код.
  
После успешного проведения фискальной операции через сервер касс, в TMDriver на экране печати чека будет отображаться QR-код для проверки чека. Такой же точно код будет выводиться и в бумажный чек, если делается печать чека на принтере. Пассажир сможет через специальное приложение (https://play.google.com/store/apps/details?id=ru.fns.billchecker&hl=ru, https://itunes.apple.com/ru/app/проверка-кассового-чека-в-фнс-россии/id1169353005?mt=8) распознать QR-код.<br />
+
{|
 +
|-
 +
|[[Файл:Работа с фискальными чеками в TMDriver.png|центр|250px]]
 +
|[[Файл:Работа с фискальными чеками в TMDriver - детализация.png|центр|250px]]
 +
|[[Файл:Работа с фискальными чеками в TMDriver - qr.png|центр|250px]]
 +
|}
  
 
При открытии экрана печати чека может автоматически срабатывать печать чека на принтере в зависимости от настройки в группах экипажей {{путь|Сервер касс - Печать чека в TMDriver}}. Если фискальная операция проводится через сервер касс, то автоматическая печать сработает только после получения результата проведения фискальной операции.<br />
 
При открытии экрана печати чека может автоматически срабатывать печать чека на принтере в зависимости от настройки в группах экипажей {{путь|Сервер касс - Печать чека в TMDriver}}. Если фискальная операция проводится через сервер касс, то автоматическая печать сработает только после получения результата проведения фискальной операции.<br />
Строка 99: Строка 117:
 
Если данная настройка будет включена, то при печати чека сначала будет выводиться стандартная детализация поездки, далее, если у водителя имеется свой ККТ, то будет печататься стандартный фискальный чек, формат которого определяется ККТ. <br />
 
Если данная настройка будет включена, то при печати чека сначала будет выводиться стандартная детализация поездки, далее, если у водителя имеется свой ККТ, то будет печататься стандартный фискальный чек, формат которого определяется ККТ. <br />
  
Если же у водителя нет своего ККТ, и фискальная операция проводится через сервер касс, то будет напечатана копия фискального чека, формат которого задается в скрипте тарифа. <br />
+
Если же у водителя нет своего ККТ, и фискальная операция проводится через сервер касс, то будет напечатана копия фискального чека, формат которого задается в скрипте тарифа. <br />
  
 
В скриптах тарифов для TMDriver существуют функции для получения данных о фискальной операции, проведенной через сервер касс.
 
В скриптах тарифов для TMDriver существуют функции для получения данных о фискальной операции, проведенной через сервер касс.
 +
 +
[[Категория:Параметры ТМ]]
 +
[[Категория:Серверы]]
 +
[[Категория:Панель управления ТМ]]

Текущая версия на 16:32, 16 февраля 2022

Сервер касс - компонент Такси-Мастер, с помощью которого можно подключить контрольно-кассовую технику (ККТ) и формировать фискальные чеки.

Сервер касс может быть:

  • локальным, когда служба такси имеет собственную контрольно-кассовую технику.
  • облачным, когда служба такси арендует контрольно-кассовую технику в каком-либо облачном сервисе (АТОЛ Онлайн).

При использовании сервера касс в ТМ на главной панели будет отображаться статус локального и/или облачного сервера касс.

Отображение сервера касс в ТМ.png

Цвет индикатора будет зависеть от статусов устройств ККТ:

  • Зеленый - все ККТ работают.
  • Желтый - не все ККТ работают.
  • Красный - все ККТ не работают.

Статусы конкретных ККТ можно увидеть в подсказке, появляющейся при наведении курсора мыши на индикатор статуса сервера касс.

Настройка локального сервера касс

Настройка работы сервера касс производится в Панели управления ТМ на странице "Сервер касс".

Добавление устройства

Добавить устройство ККТ можно в Панели управления ТМ на странице "Сервер касс" на вкладке "Устройства".

Интересная информация
В локальном сервере касс доступна интеграция с устройствами:
  • АТОЛ 11Ф
  • АТОЛ 15Ф
  • АТОЛ 20Ф
  • АТОЛ 22Ф
  • (АТОЛ FPrint-22ПТК)
  • АТОЛ 25Ф
  • АТОЛ 27Ф
  • АТОЛ 30Ф
  • АТОЛ 50Ф
  • АТОЛ 52Ф
  • АТОЛ 55Ф
  • АТОЛ 60Ф
  • АТОЛ 77Ф
  • АТОЛ 90Ф
  • АТОЛ 91Ф
  • АТОЛ 92Ф

Рекомендуется использовать только указанные модели устройств.

Для работы с устройствами АТОЛ необходимо дополнительно установить на компьютер драйвер ККТ АТОЛ версии 10.

Скачать нужный драйвер можно с сайта АТОЛ (https://is.gd/c2I4CD). Устанавливать необходимо 32-х битную версию драйвера.

Добавление устройства ККТ.png
  • Наименование - произвольное название устройства ККТ.
  • Код группы - необязательная настройка. Она нужна для привязки ККТ к определенным группам экипажей. Например, когда на одной базе ТМ работают разные службы такси, каждая из которых имеет свои ККТ.
  • Налоговая ставка.
  • Тип соединения:
    • COM - устройство ККТ подключено к этому же компьютеру через COM порт, тогда дополнительно указывается номер COM порта.
    • Ethernet - устройство ККТ подключено Ethernet сеть, тогда указывается IP и порт ККТ.
  • Устанавливать флаг "электронный чек" - устанавливается, если печатать бумажный чек не нужно. Но, если в заказе не указан номер телефона и/или email, то бумажный чек будет печататься в любом случае.
  • Номер телефона по умолчанию, если в заказе не определен номер телефона и E-mail.
  • Активно - признак активности ККТ.

Настройка облачного сервера касс

Облачный сервер касс - веб-сервис, который позволяет взаимодействовать TMServer-у службы такси с сервисами онлайн касс.

Доступна интеграция с сервисом АТОЛ Онлайн.

Для фискализации как наличных, так и безналичных платежей, при заключении договора с АТОЛ, нужно выбрать тип облачной кассы "АТОЛ Казначей ФА".

Настройка взаимодействия облачного сервера касс с Такси-Мастер производится специалистами ООО БИТ «Мастер».

Настройки сервера касс в ТМ

Использование сервера касс включается в карточке группы экипажей на вкладке "Сервер касс".

Настройки сервера касс находятся в «Файл - Настройки - Сервер касс» (данный раздел отображается только при наличии специальной лицензии в ключе).

Настройки сервера касс в ТМ.png
  • Адрес и порт локального сервера касс.
  • Атрибут, обозначающий, что по заказу нужно делать фискальную операцию - атрибут заказа, при наличии которого по заказу всегда будет происходить фискализация.
  • Атрибут, обозначающий, что по заказу не нужно делать фискальную операцию - атрибут заказа, при наличии которого по заказу не будет происходить фискализация.
  • Атрибут, обозначающий, что водитель имеет собственное устройство ККТ - если водитель имеет данный атрибут, то TMDriver будет сам печатать фискальный чек через свой ККТ, и при завершении заказа с этим водителем уже не будет проводиться фискальная операция через сервер касс.
  • Правило для преобразования префиксов номеров телефонов - правило преобразования номера телефона клиента в правильный формат, чтобы на этот номер телефона можно было отправить СМС с информацией о чеке.

Настройки сервера касс в группах экипажей

В карточке группы экипажей на вкладке Сервер касс можно включить использование сервера касс и настроить взаимодействие группы экипажей и сервера касс.

Отображение фискальных операций

Созданные фискальные операции и их статус можно увидеть в ТМ Рабочее место в окне "Клиенты - Фискальные операции":

Окно Клиенты - Фискальные операции.png

При двойном клике по ИД заказа можно открыть карточку заказа.

Старые фискальные операции можно удалить через TMAdmin.

Работа с фискальными чеками в TMDriver

Экран печати чека будет появляться после нажатия кнопки "Успешно" в экране завершения поездки при условии, что в настройках TMDriver выбран какой-то принтер, или если по заказу должна проводиться фискальная операция.

Пока в TMDriver отображается экран печати чека, заказ в ТМ находится в состоянии типа "В работе". Заказ будет завершаться в ТМ только после закрытия этого экрана. Для экрана печати чека действует автозакрытие по настройке из групп экипажей «Модуль "Связь с водителями" - Общие - При открытии чека заказа в TMDriver автоматически завершать заказ успешно через N секунд».

Если у водителя нет своего ККТ, и по заказу требуется фискальная операция, то при переходе в экран печати чека TMDriver будет отправлять в сервер запрос на проведение фискальной операции. После этого будет включаться ожидание результата в течение времени, которое задается в группе экипажей в настройке «Сервер касс - Минимальное время ожидания фискальных данных для печати чека в TMDriver». До истечения этого времени нельзя будет закрыть экран печати чека. Если за указанное время результат проведения фискальной операции так и не будет получен, то можно будет распечатать на Bluetooth-принтере обычный чек без фискальных данных.

После успешного проведения фискальной операции через сервер касс, в TMDriver на экране печати чека будет отображаться QR-код для проверки чека. Такой же точно код будет выводиться и в бумажный чек, если делается печать чека на принтере. Пассажир сможет через специальное приложение (https://play.google.com/store/apps/details?id=ru.fns.billchecker&hl=ru, https://itunes.apple.com/ru/app/проверка-кассового-чека-в-фнс-россии/id1169353005?mt=8) распознать QR-код.

Работа с фискальными чеками в TMDriver.png
Работа с фискальными чеками в TMDriver - детализация.png
Работа с фискальными чеками в TMDriver - qr.png

При открытии экрана печати чека может автоматически срабатывать печать чека на принтере в зависимости от настройки в группах экипажей «Сервер касс - Печать чека в TMDriver». Если фискальная операция проводится через сервер касс, то автоматическая печать сработает только после получения результата проведения фискальной операции.

Формат печатаемого чека задается скриптом тарифа.

В параметрах стандартного и расширенного тарифов существует настройка «Параметры для печати чека - Печатать детализацию поездки».

Если данная настройка будет включена, то при печати чека сначала будет выводиться стандартная детализация поездки, далее, если у водителя имеется свой ККТ, то будет печататься стандартный фискальный чек, формат которого определяется ККТ.

Если же у водителя нет своего ККТ, и фискальная операция проводится через сервер касс, то будет напечатана копия фискального чека, формат которого задается в скрипте тарифа.

В скриптах тарифов для TMDriver существуют функции для получения данных о фискальной операции, проведенной через сервер касс.