Публичное пространство

SetKit ◾️ Добавление мягкого чека с ценами из справочника товаров магазина

Owned by Ксения Лебедева
Last updated: апр. 20, 2024 by Парень Александр
8 min read

SR-6858 - Получение подробных данных проблемы… СТАТУС

CR-10475 - Получение подробных данных проблемы… СТАТУС

10.3.31.0

SETKIT 3.11.0

Только для клавиатурных касс и SetTouch.

Описание

Начиная с версии 10.3.31.0 появилась возможность загружать на кассу мягкий чек без указания цен с последующей подстановкой актуальных цен из справочника товаров магазина.

Ценность

Товары из мягкого чека при загрузке на кассу могут получать цены из справочника товаров магазина.

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

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

Создан мягкий чек без указания цен на товарные позиции (unitPrice = null и totalPrice = null).

{
    "guid": "16771233333",
    "status": "READY_TO_PAYMENT", 
    "dateCreated": "2023-06-05 11:17",
    "isEditable": true,
    "totalPrice": null,
    "discountsValue": 0,
    "additionalInfo": "",
    "positions": [
        {
            "positionOrder": 2,
            "code": "45033",
            "barcode": "45033",
            "quantity": 1,
            "unitPrice": null,
            "discountValue": 0,
            "totalPrice": null,
            "isFixedPrice": true,
            "isFixedDiscounts": true,
            "calculationMethod": 4
        },
        {
            "positionOrder": 1,
            "code": "45034",
            "barcode": "45034",
            "quantity": 2,
            "unitPrice": null,
            "discountValue": 0,
            "totalPrice": null,
            "isFixedPrice": true,
            "isFixedDiscounts": true,
            "calculationMethod": 4
        }
    ],
    "client": {
        "firstName": "Павел",
        "middleName": "Тест",
        "lastName": "Тест",
        "email": "pavel@mail.ru",
        "phone": "79111234567",
        "clientNotificationType": "BY_EMAIL"
    },
    "operationType": 1,
    "prePayment": 0,
    "receiptEditable": true,
    "positionsAddingAllowed": false
}

Клавиатурная касса

1. Покупатель на кассе предоставляет кассиру номер заказа или номер телефона.

2. Кассир переходит в меню и нажимает кнопку Поиск мягкого чека.


3. Далее кассир добавляет мягкий чек (сканирует штрихкод номера мягкого чека/вводит номер вручную/ищет по номеру телефона покупателя).


4. Касса находит мягкий чек и добавляет позиции в кассовый чек с ценами из справочника товаров базы магазина.

5. Кассир переходит к расчёту.

SetTouch

1. Покупатель на кассе предоставляет кассиру номер заказа или номер телефона.

2. Кассир нажимает кнопку вызова мягкого чека.


3. Далее кассир добавляет мягкий чек (сканирует штрихкод номера мягкого чека/вводит номер вручную/ищет по номеру телефона покупателя).


4. Касса находит мягкий чек и добавляет позиции в кассовый чек с ценами из справочника товаров базы магазина.

5. Кассир переходит к расчёту.

Возвраты

Возврат производится стандартным способом SetKit ◾️ Возврат товаров на кассе, полученных из мягкого чека.

Примеры отрицательных сценариев

Запрет добавления заказа без цен в чек при отсутствии цен на позиции в справочнике и запрете редактирования заказа

1. Внешняя система присылает в SetKit созданный заказ без указания цен на позиции и запретом удаления позиций:

{
    "guid": "777111",
    "status": "READY_TO_PAYMENT",
    "dateCreated": "2023-06-05 11:17",
    "isEditable": false,
    "totalPrice": null,
    "discountsValue": 0,
    "additionalInfo": "",
    "positions": [
        {
            "positionOrder": 2,
            "code": "85226264",
            "barcode": "85226264",
            "quantity": 1,
            "unitPrice": null,
            "discountValue": 0,
            "totalPrice": null,
            "isFixedPrice": true,
            "isFixedDiscounts": true,
            "calculationMethod": 4
        },
        {
            "positionOrder": 1,
            "code": "4100113677",
            "barcode": "4100113677",
            "quantity": 2,
            "unitPrice": null,
            "discountValue": 0,
            "totalPrice": null,
            "isFixedPrice": true,
            "isFixedDiscounts": true,
            "calculationMethod": 4
        }
    ],
    "client": {
        "firstName": "Павел",
        "middleName": "Тест",
        "lastName": "Тест",
        "email": "pavel@mail.ru",
        "phone": "79111234567",
        "clientNotificationType": "BY_EMAIL"
    },
    "operationType": 1,
    "prePayment": 0,
    "receiptEditable": false,
    "positionsAddingAllowed": false
}

2. Покупатель на кассе предоставляет кассиру номер заказа или номер телефона, по которому можно найти чек.

3. Кассир производит поиск МЧ (сканирует ШК МЧ/вводит номер вручную в окне поиска МЧ/ищет по номеру телефона покупателя).

4. Касса находит МЧ и не находит товар в справочнике товаров базы магазина на одну/несколько позиций.

5. Касса выводит информационное сообщение об ошибке кассиру.

6. Касса не добавляет МЧ.

Запрет добавления товаров без цен в чек при отсутствии в справочнике

1. Внешняя система присылает в SetKit созданный заказ без указания цен на позиции:

{
    "guid": "777111",
    "status": "READY_TO_PAYMENT",
    "dateCreated": "2023-06-05 11:17",
    "isEditable": true,
    "totalPrice": null,
    "discountsValue": 0,
    "additionalInfo": "",
    "positions": [
        {
            "positionOrder": 2,
            "code": "85226264",
            "barcode": "85226264",
            "quantity": 1,
            "unitPrice": null,
            "discountValue": 0,
            "totalPrice": null,
            "isFixedPrice": true,
            "isFixedDiscounts": true,
            "calculationMethod": 4
        },
        {
            "positionOrder": 1,
            "code": "4100113677",
            "barcode": "4100113677",
            "quantity": 2,
            "unitPrice": null,
            "discountValue": 0,
            "totalPrice": null,
            "isFixedPrice": true,
            "isFixedDiscounts": true,
            "calculationMethod": 4
        }
    ],
    "client": {
        "firstName": "Павел",
        "middleName": "Тест",
        "lastName": "Тест",
        "email": "pavel@mail.ru",
        "phone": "79111234567",
        "clientNotificationType": "BY_EMAIL"
    },
    "operationType": 1,
    "prePayment": 0,
    "receiptEditable": true,
    "positionsAddingAllowed": false
}

2. Покупатель на кассе предоставляет кассиру номер заказа или номер телефона, по которому можно найти чек.

3. Кассир производит поиск МЧ (сканирует ШК МЧ/вводит номер вручную в окне поиска МЧ/ищет по номеру телефона покупателя).

4. Касса находит МЧ и не находит товар в справочнике товаров базы магазина на одну/несколько позиций.

5. Касса выводит информационное сообщение об ошибке кассиру.

6. Кассир нажимает НЕТ.

7. Касса не добавляет МЧ.

Ограничения

  • Функциональность работает только для клавиатурных касс и SetTouch.

  • Поля со скидками в МЧ возвращаться со значением 0, если цена отсутствует.

Настройка

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

За включение/отключение работы валидатора отвечает свойство -validation.unitPriceRequired в соответствии с правилом:

  • если -validation.unitPriceRequired=true (по умолчанию), выполняется проверка на то, чтобы unitPrice и totalPrice не были равны null;
  • если -validation.unitPriceRequired=false, проверка не выполняется.

1. Откройте командную строку.

2. Перейдите к редактированию docker-compose.yml с помощью команды:

sudo mcedit /home/setkit/docker_compose/docker-compose.yml

2. Добавьте свойство -validation.unitPriceRequired=false

3. Сохраните файл клавишей F2 → выйдите из Midnight Commander клавишей F10 в командную строку.

4. Перезапустите Docker. 

  • Перейдите в папку docker_compose:
cd /home/setkit/docker_compose/
  • Выполните команду:
docker-compose stop
  • После отображения статуса done, выполните команду:
docker-compose up -d

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

© 1994-2023, ООО «Кристалл Сервис Интеграция».
Все права защищены..

Политика обработки персональных данных