1 Описание
2 Настройки
- 2.1 Сервер
- 2.2 Касса
3 Автоматический выбор плагинной оплаты при вызове заказа из SetKit

Описание

Плагин предназначен для взаимодействия с SetRetail10 для фиксации факта продажи товара через сервис, для которого нет промышленной интеграции в кассовом ПО.

Продажа фиксируется как безналичная оплата, что при загрузке в ERP позволяет зафиксировать задолженность за Сервисом, которому был передан товар.

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

Использование данного плагина, требует повышенного внимания к ведению кассовой дисциплины, так как предосталяет возможность кассиру осуществлять бесконтрольный отпуск товара.

Настройки

Сервер

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

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

3. Кликните по процессингу Оплата доставки.

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

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

5. Установите параметры на вкладке ОПЛАТА ДОСТАВКИ → кликните .

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

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

Касса

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

mkdir /home/tc/storage/crystal-cash/banks/delivery

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

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

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

Параметр	Значение	Описание
showSumEnterForm	false или true	При установке значения true, после выбора типа оплаты, будет возможность указать сумму оплаты выбранного типа. Используется для частичной оплаты чека
deliveryInfo	Секция для перечисления сервисов	В разделе перечисляются все сервисы, по которым требуется фиксировать продажу по чекам на кассе
name	Пример: Glovo	Наименование, которое отражается на кассе
code	Пример: code_wolt	Код доставки
bankId	Пример: bank_id_wolt	Код BankID, который передается в чеке при загрузке в ERP

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

{
  "showSumEnterForm": false,
  "deliveryInfo": [
    {
      "name": "Glovo",
      "code": "code_glovo",
      "bankId": "bank_id_glovo"
    },
    {
      "name": "Wolt",
      "code": "code_wolt",
      "bankId": "bank_id_wolt"
    }
  ]
}

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

Выполните скрипт для добавления типа оплаты kz.prosystems.set.delivery.payment в базе данных set.

Подробнее SetTouch ◾️ Кнопки типов оплат.

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

6. Активируйте процессинг Оплата доставки.

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

8. Далее выберите систему доставки и произведите оплату.

Автоматический выбор плагинной оплаты при вызове заказа из SetKit

https://crystals.atlassian.net/browse/CR-12944

https://crystals.atlassian.net/browse/SRTG-337

10.4.22.0

Описание

Функциональность позволяет автоматически добавлять в чек предоплату (оплату), указанную в мягком чеке (заказе) SetKit, при его вызове на кассе. Система идентифицирует тип оплаты через плагин доставки и автоматически зачитывает сумму, избавляя кассира от необходимости выбирать тип оплаты вручную.

Ценность

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

Примеры работы

Сценарий 1. Полная предоплата заказа

Покупатель полностью оплачивает заказ на сайте.
Кассир на кассе вводит номер заказа или сканирует его штрихкод.
Касса загружает состав заказа (мягкий чек) в статусе READY_TO_PAYMENT.
Касса автоматически определяет тип оплаты из свойств заказа и добавляет его в чек.
Чек закрывается автоматически и фискализируется.

Сценарий 2. Частичная предоплата заказа

Покупатель вносит часть суммы за заказ на сайте.
Кассир вызывает заказ на кассе.
Касса автоматически добавляет сумму предоплаты в чек.
На экране кассы отображается остаток суммы к оплате.
Кассир выбирает доступный тип оплаты (например, Наличные или Карта) для доплаты остатка.
После внесения всей суммы чек фискализируется.

Пример шаблона данных SetKit

После сканирования ШК указанного чека тип доставки плагин определит автоматически и не покажет меню выбора, а сразу перейдет к оплате.

Для автоматического выбора типа доставки необходимо в параметрах мягкого чека указать code из доставки, указанной в конфиге плагина set-retail-delivery.

Пример JSON создания мягкого чека и автоматического выбора доставки “Доставка 2“

{
    "guid": "SK13825978379560",
    "status": "READY_TO_PAYMENT",
    "dateCreated": "2021-08-03 14:45",
    "isEditable": true,
    "totalPrice": 14.23,
    "discountsValue": 0,
    "additionalInfo": "additional information",
    "location": "СПб",
    "positions": [
        {
            "positionOrder": 1,
            "code": "4600001000007",
            "departNumber": 1,
            "barcode": "4600001000007",
            "quantity": 1.000,
            "unitPrice": 14.23,
            "vat": 5.0,
            "vatValue": 20,
            "discountValue": 0,
            "totalPrice": 14.23,
            "isFixedPrice": false,
            "additionalInfo": "клиент 1. хороший клиент"
        }
    ],
    "payments": [
        {
            "typeId": "kz.prosystems.set.delivery.payment",
            "amount": 100,
            "properties": [
                {
                    "key": "delivery.type",
                    "value": "delivery2"
                }
            ]
        }
    ],
    "client": {
        "guid": "0001",
        "cardNumber": "780014086163",
        "firstName": "Виталий",
        "middleName": "Олегович",
        "lastName": "Denisov",
        "email": "email_for_test@crystals.ru",
        "phone": "78121112233",
        "accumulation": 25000,
        "bonusBalance": 5000,
        "juristicDetails": {
            "inn": 1212121212,
            "organizationName": "Corporation Co."
        }
    }
}

Пример экспорта чека в ERP

При экспорте данных передается информация о плагинной оплате:

<payments>
    <payment typeClass="kz.prosystems.set.delivery.payment" amount="1000" description="Оплата доставки">
        <plugin-property key="deliveryId" value="delivery_yandex"/>
    </payment>
</payments>

Примеры отрицательных сценариев и возможных ошибок

В свойствах (properties) не передан признак оплаты: если в JSON заказа указан typeId плагина, но не заполнен delivery.type, касса не сможет определить тип автоматически и выведет кассиру меню ручного выбора.
Несоответствие статуса: если заказ передан в статусе, отличном от READY_TO_PAYMENT, автоматическое добавление оплаты может не сработать.

Ограничения

Функциональность реализована только для плагина kz.prosystems.set.delivery.payment.
Работает только для заказов в статусе READY_TO_PAYMENT.
Важно: при передаче оплаты в блоке payments, в поле prePayment необходимо передавать «0» или не передавать эту сущность вовсе.
Для РФ: если предоплата передается в блоке payments (а не в поле prePayment), при экспорте в ERP сумма будет классифицирована как «безналичный расчет», а не как «зачет предоплаты».

Настройка

Настройка на сервере

Настройте процессинг Оплата доставки (см. SetRetail10 ◾️ Платежный плагин Delivery )

Конфигурация файла config.json

Создайте файл по указанному выше пути со следующим содержанием:

Параметр "showSumEnterForm": false обязателен для корректной автоматической работы.

{
    "showSumEnterForm": true,
    "deliveryInfo": [
        {
            "name": "Доставка 1",
            "code": "delivery1",
            "bankId": "bankId1"
        },
        {
            "name": "Доставка 2",
            "code": "delivery2",
            "bankId": "bankId2"
        }
    ]
}

SetRetail10 ◾️ Платежный плагин Delivery

Описание

Настройки

Сервер

Касса

Автоматический выбор плагинной оплаты при вызове заказа из SetKit

Описание

Ценность

Примеры работы

Сценарий 1. Полная предоплата заказа

Сценарий 2. Частичная предоплата заказа

Пример шаблона данных SetKit

Пример экспорта чека в ERP

Примеры отрицательных сценариев и возможных ошибок

Ограничения

Настройка

Настройка на сервере

Конфигурация файла config.json

Статьи по теме