Настройка POS-терминалов R-Keeper

В отличие от других торговых систем, в R-Keeper для получения данных используется фиксированный порт, на который посылают пакеты данных несколько терминальных устройств или касс; номер терминала записан внутри пакета транзакции.

Из-за этой особенности на сервере используется скрипт автоматизации, принимающий транзакцию R-Keeper, анализирующий её содержимое и перенаправляющий её в соответствующий терминал ActivePOS.

Настройка сервера для протокола R-Keeper состоит из трёх шагов:

  1. Настройка терминалов

    POS-терминалы R-Keeper должны быть настроены следующим образом:

    • IP-адрес - не заполнен
    • Порт на 60000 больше номера терминала (например: терминал 13 - порт 60013, терминал 37 - порт 60037)
    • TCP/UDP - протокол UDP

  2. Скрипт перенаправления

    Скрипт перенаправления можно найти в примерах:

    Подключение терминала R-Keeper к скрипту сопровождается всплывающим сообщением:

    По умолчанию сервер ожидает данные на порту 4444; при необходимости Вы можете настроить этот порт, отредактировав следующие строки:

  3. Настройка конфигурационного файла

    Для корректной обработки транзакций R-Keeper необходимо отредактировать файл pos-rkeeper.ini, находящийся в папке сервера.

    Файл записан в формате INI и имеет следующую структуру:

    • [CashMachines]

      - название группы терминалов (например, [Group1])

    • terminal_ids="1,2,5,7"

      - список терминалов в данной группе

      Запись terminal_ids="*" будет означать все номера терминалов, не указанные явно в конфигурационном файле

    • date_format="dd.MM.yyyy"

      - формат даты

    • time_format="h:mm:ss"

      - формат времени

    • FN_RECEIPT_BEGIN_MIN=100

      FN_RECEIPT_BEGIN_MAX=100

      - диапазон FunctionNumber для события "Новый чек"

    • FN_RECEIPT_END_MIN=10

      FN_RECEIPT_END_MIN=10

      - диапазон FunctionNumber для события "Закрытие чека"

    • FN_POSITION_ADD_MIN=101

      FN_POSITION_ADD_MAX=105

      - диапазон FunctionNumber для события "Добавление позиции"

    • FN_PRINT_MIN=200

      FN_PRINT_MAX=999

      - диапазон FunctionNumber для события "Комментарий"

    • FN_RECEIPT_DISCOUNT_MIN=4

      FN_RECEIPT_DISCOUNT_MAX=4

      - диапазон FunctionNumber для события "Применение скидки к чеку"

    • FN_CANCEL_BEGIN_MIN=0

      FN_CANCEL_BEGIN_MAX=0

      - диапазон FunctionNumber для события "Новый чек «Отмена»"

    • FN_CANCEL_POSITION_MIN=6

      FN_CANCEL_POSITION_MAX=6

      - диапазон FunctionNumber для события "Отмена позиции"

    • FN_CANCEL_END_MIN=0

      FN_CANCEL_END_MAX=0

      - диапазон FunctionNumber для события "Закрытие чека «Отмена»"

    Подсказка

    Пример конфигурации находится в файле pos-rkeeper.sample.ini в папке сервера

    Для определения границ диапазонов необходимо либо проанализировать дампы протокола, либо обратиться к документации и настройкам используемых устройств.

    Предупреждение

    Для каждой группы терминалов должны быть заданы все параметры. Если Вы не знаете диапазон - заполните его нулями.

    Подсказка

    Для корректной работы диапазоны разных событий не должны пересекаться.

    Строка файла настройки, начинающаяся с символа «;» является комментарием и не анализируется.

    Для проверки измененных настроек нет необходимости перезапускать сервер, достаточно выключить и включить настраиваемый терминал ActivePOS.

См. также