Описание

Плагин предназначен для подключения терминалов Jusan PAX в кассовую программу SetRetail10 для осуществления приема оплаты по банковским картам и приема QR-платежей Jusan.

Файл плагина включен в дистрибутив, начиная с версии 10.4.22.0.

Важно!

Особенности работы терминала:

В ответе терминала не предусмотрена информация о Номере терминала, соответственно она не записывается в транзакции.
Для того, чтобы получить ответ от терминала, кассир должен нажать на экране кнопку «Закрыть» или «На главную».
Если в ходе операции был разрыв связи, то операцию следует завершить вручную. В Интеграции не предусмотрено запроса статуса последней транзакции.

Настройки

Сервер

1. На сервере SetCentrum перейдите в Интеграция → Внешние процессинги → кликните .

2. В поиске наберите jusa → кликните Платежные системы → наберите jusa → установите Jusan POS → кликните .

3. Кликните по процессингу Jusan POS.

4. На вкладке общие установите номера магазинов, затем параметры нахождения конфигурационного файла на кассе:

Путь до файла конфигурации (Linux) - /home/tc/storage/crystal-cash/banks/jusan/config.json
Путь до файла конфигурации (Windows) - c://.../home/tc/storage/crystal-cash/banks/jusan/config.json

5. Установите параметры на вкладке JUSAN POS ОПЛАТА → кликните .

6. Перейдите в Кассовый модуль → Шаблоны касс → кликните на требуемом шаблоне в контекстном меню Редактировать.

7. ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Типы оплат → установите флажок Jusan POS Оплата → кликните .

Касса

1. На кассе создайте папку процессинга:

sudo mkdir /home/tc/storage/crystal-cash/jusan/aisino

2. Скачайте файл конфигурации и скопируйте его в папку с процессингом:

Описание параметров config.json

Параметр	Значение	Описание

Параметр	Значение	Описание
ip	"http://ХХ.ХХ.ХХ.ХХ:8080"	Указывается IP-адрес банковского терминала в локальной сети, используется, когда продажа идет от одного юридического лица.
clientPropertiesByTaxCode	{"100940003111":{"ip":"http://192.168.0.209:8080"},"100940003222":{"ip":"http://192.168.0.209:8080"}}	Параметр указывается вместо "ip", когда используются несколько юридических лиц на кассе. Содержит объекты с ИИН/БИН организации и её IP-адресом терминала.
readTimeout	180000	Время ожидания ответа на запрос от терминала при успешном установлении связи с терминалом (в миллисекундах).
connectionTimeout	5000	Время ожидания установки соединения с терминалом (в миллисекундах).
transactionTime	181000	Общее время транзакции оплаты или возврата (в миллисекундах).
language	"MIX"	Язык печати слип-чека на POS-принтере. Значения: "KAZ" – казахский, "RUS" – русский, "MIX" – казахский и русский.
printSlip	true	При установлении значения false, слип-чек не будет печататься на POS-принтере.
cancelMethod	"refund"	Параметр определяет метод аннулирования принятой оплаты. Значения: "refund" – аннулирование с подтверждением от покупателя; "reversal" – аннулирование без подтверждения покупателя.
trimTrailingZeros	true	Обязательный параметр для Jusan Bank, по которому передается сумма без копеек (т.е. без ".00" в конце).
manualConfirmation	false	При значении true, есть возможность ручного подтверждения неуспешной транзакции после ввода секретного пароля systemPassword. Окно может появиться при отсутствии связи с терминалом или в случаях, когда транзакция началась, но не было получено ответа об успешном завершении транзакции.
systemPassword	"123456789"	Секретный пароль для использования при ручном подтверждении (manualConfirmation).
showSumEnterForm	false	При установке значения true, после выбора типа оплаты, будет возможность указать сумму оплаты выбранного типа. Используется для частичной оплаты чека.
activeSumEnterFormPayment	false	Когда установлено `showSumEnterForm = true`, выводится клавиатура для ввода суммы. Если этот параметр установлен в true, вы можете редактировать сумму оплаты. Если false – значение не редактируется и всегда равно сумме оплаты.
activeSumEnterFormRefund	false	Когда установлено `showSumEnterForm = true`, выводится клавиатура для ввода суммы. Если этот параметр установлен в true, вы можете редактировать сумму возврата. Если false – значение не редактируется и всегда равно сумме в возврате.

Пример файла конфигурации:

{
  "ip": "http://ХХ.ХХ.ХХ.ХХ:8080",
  "clientPropertiesByTaxCode": {
    "100940003111": {
      "ip": "http://192.168.0.209:8080"
    },
    "100940003222": {
      "ip": "http://192.168.0.209:8080"
    }
  },
  "readTimeout": 180000,
  "connectionTimeout": 5000,
  "transactionTime": 181000,
  "language": "MIX",
  "printSlip": true,
  "cancelMethod": "refund",
  "trimTrailingZeros": true,
  "manualConfirmation": false,
  "systemPassword": "123456789",
  "showSumEnterForm": false,
  "activeSumEnterFormPayment": false,
  "activeSumEnterFormRefund": false
}

Настройте типы оплаты “уши“ в файле конфигурации.

Откройте файл конфигурации на редактирование, командой:

sudo mkdir /home/tc/storage/crystal-cash/web/config/paymentTypeRanks.json

4. Вставьте или отредактируйте следующую конфигурацию, добавив нужный сервис:

 {
    "paymentTypesRanks": [
        {
            "paymentId": "kz.jusan.pos.payment",
            "fastAccessRank": 3,
            "rank": 3
        },
        {
            "paymentId": "CashPaymentEntity",
            "fastAccessRank": 1,
            "rank": 1
        },
        {
            "paymentId": "ExternalBankTerminalPaymentEntity",
            "rank": 4
        }
    ],
    "paymentTypesWithCounterpartyRanks": [
        {
            "paymentId": "kz.jusan.pos.payment",
            "fastAccessRank": 3,
            "rank": 3
        },
        {
            "paymentId": "CashPaymentEntity",
            "fastAccessRank": 1,
            "rank": 1
        },
        {
            "paymentId": "ExternalBankTerminalPaymentEntity",
            "rank": 4
        }
    ]
}

5. На кассе войдите в Настройки → Внешние системы.

6. Активируйте процессинг Jusan Pay.

7. При оплате выберите Jusan POS Оплата.

SetRetail10 ◾️ Эквайринговый плагин Jusan PAX

Описание

Настройки

Сервер

Касса