Сохранить/Добавить мягкий чек

Метод: PUT или POST

Адресация: http://{IP-адрес службы SetKit}:8081/set-kit/softcheques/{ШК мягкого чека}

Request Content-Types: application/json

Описание:

Пример создания мягкого чека в Postman:

Получить мягкий чек в определённом статусе по его guid

Метод: GET

Адресация: http://{IP-адрес службы SetKit}:8081/set-kit/softcheques/{guid}/status/{status}

Request Content-Types: application/json

Описание: возвращает чек с указанным guid

Код ответа: 200 (Чек найден)

Пример работы с запросом чека по статусу в Postman

Получить мягкий чек по guid

Метод: GET

Адресация: http://{IP-адрес службы SetKit}:8081/set-kit/softcheques/{guid}/

Request Content-Types: application/json

Описание: возвращает чек с указанным guid

Код ответа: 200 (Чек найден)

Пример работы с запросом чека по статусу в Postman:

Обновить чек - изменить данные чека

Метод: PUT

Адресация: http://{IP-адрес службы SetKit}:8081/set-kit/softcheques/{guid}/

Request Content-Types: application/json

Описание: поиск в хранилище локальной версии чека по guid и обновление записи. Если чека не существует, то произойдет его создание. 

Пример работы с запросом в Postman:

Удалить мягкий чек

Метод: DELETE

Адресация: http://{IP-адрес службы SetKit}:8081/set-kit/softcheques/{guid}/

Request Content-Types: application/json

Описание: переводит чек в статус deleted, и после этого его невозможно получить извне. После удаления, guid можно использовать для другого чека.

Код ответа: 200 (Чек найден)

Получить мягкий чек по номеру телефону

Метод: GET

Адресация: http://172.29.16.51:8081/set-kit/softcheques?phone=79991112233&status=READY_TO_PAYMENT

Request Content-Types: application/json

Описание: возвращает чек с указанным номером мобильного телефона phone

Код ответа: 200 (Чек найден)

Пример работы с запросом чека по статусу в Postman:

1. Создаем мягкий чек №771389 в SetKit следующего содержания:

• Штучный товар
• Расчет скидок разрешен
• Редактирование мягкого чека разрешено

{
    "guid": "ext-01",
    "shopNumber": null,
    "status": "READY_TO_PAYMENT",
    "dateCreated": 1517481826629,
    "isEditable": true,
    "totalPrice": 611,
    "discountsValue": 0,
    "additionalInfo": "additional information",
    "positions": [
        {
            "positionOrder": 1,
            "code": "45034",
            "departNumber": 1,
            "barcode": "4810167000258",
            "quantity": 2,
            "unitPrice": 305.5,
            "vat": 5,
            "vatValue": 20,
            "discountValue": 0,
            "totalPrice": 611,
            "isFixedPrice": false,
            "isFixedDiscounts": null,
            "additionalInfo": "Кейс 1. Восстановление, аннулирование и гашение мягкого чека на кассе",
            "positionDiscounts": null
        }
    ]
}

2. На кассе по штрих-коду вызываем мягкий чека №771389 и проверяем, что он полностью был восстановлен на кассе.

3. Проверяем, что статус МЧ в SetKit, он изменился на PAYMENT, это означает что чек вызван на кассе.

4. Аннулируем чек и проверяем, что статус мягкого чека изменился в SetKit на READY_TO_PAYMENT, это означает, что его снова можно вызвать для продажи

5. По кнопке на прикассовой клавиатуре вызываем окно ввода мягкого чека.

6. Вводим номер мягкого чека без префикса его штрих-кода и нажимаем ВВОД для вызова и видим, что мягкий чек отобразился на кассе.

7. Изменяем количество товаров в из мягкого чека и добавляем новую позицию.

8. Нажимаем кнопку РАСЧЕТ и проверяем, что для каждой из позиций были применены скидки.

9. Производим регистрацию чека.

10. Проверяем в службе SetKit, что чеку присвоен статус COMPLETED, это означает, что он оплачен.

1. Создаем МЧ №773390 в SetKit следующего содержания:

• Товары штучные. Скидки и цены предрасчитаны (цены в составе мягкого чека на позиции уже являются скидочными).
• Расчет скидок запрещен
• Редактирование МЧ запрещено

2. На кассе вызываем мягкий чек №773390.

3. Мягкий чек появился на кассе.

4. Если попробовать выделить товарную позицию и нажать клавишу ВВОД, то появится сообщение о том, что нельзя редактировать позиции.

5. Добавляем товар для которого, отдельная рекламная акция. Также рекламная акция есть и для товаров из мягкого чека.

6. Нажимаем кнопку РАСЧЕТ и видим, что скидка применилась только на товар добавленный на кассе, а не на те, что из мягкого чека.

7. Регистрируем чек и видим также, что сработала только скидка на товар, который был добавлен не из мягкого чека.

9. Проверяем, что в службе мягких чеков статус изменился на COMPLETED, это означает, что он был оплачен.

Обработка добавления акцизных марок из мягкого чека

Настройка и использование

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

2. Создаем мягкий чек с №771290 в SetKit следующего содержания

• Товары штучный, алкогольный (акцизный).
• Расчет скидок разрешен
• Редактирование МЧ разрешено

{
    "guid": "ext-01",
    "shopNumber": null,
    "status": "READY_TO_PAYMENT",
    "dateCreated": 1517481826629,
    "isEditable": true,
    "totalPrice": 611,
    "discountsValue": 0,
    "additionalInfo": "additional information",
    "positions": [
         {
            "positionOrder": 1,
            "code": "45034",
            "departNumber": 1,
            "barcode": "4810167000258",
            "quantity": 2,
            "unitPrice": 305.5,
            "vat": 5,
            "vatValue": 20,
            "discountValue": 0,
            "totalPrice": 611,
            "isFixedPrice": false,
            "isFixedDiscounts": null,
            "additionalInfo": "Кейс 2. Работа с акцизными алкогольными товарами из МЧ на кассе"
            
        },
        {
            "positionOrder": 2,
            "code": "45037",
            "departNumber": 1,
            "barcode": "5099873089798",
            "quantity": 1,
            "unitPrice": 305.5,
            "vat": 5,
            "vatValue": 20,
            "discountValue": 0,
            "totalPrice": 611,
            "isFixedPrice": false,
            "isFixedDiscounts": null,
            "additionalInfo": "Кейс 2. Работа с акцизными алкогольными товарами из МЧ на кассе",
            "positionDiscounts": null
        }
    ]
}

3. На кассе вызываем мягкий чек №771290.

4. Появляется форма для ввода штрих-кода алкогольного товара.

5. Сканируем штрих-код алкогольного товара, затем акцизную марку.

6. Появляется сообщение о возрасте покупателя и нажимаем кнопку ВВОД.

7. Появляется стандартное поле для изменения количества товара, если это разрешено настройками привилегии кассира. Нажимаем кнопку ВВОД.

8. Сканируем акцизную марку алкогольного товара.

9. Алкогольный товар вместе со штучным добавлены в основной чек.

10. Нажимаем кнопку РАСЧЕТ и регистрируем чек.

11. Чек в службе мягких чеков SetKit изменился на статус COMPLETED, это означает, что он был оплачен.

Подключение

Воспользуйтесь PgAdmin-клиентом для подключения к БД PostgreSQL

Подключитесь к серверу СУБД PostgreSQL на котором установлены базы данных сервера SetRetail10

База данных со всеми данными по мягкими чеками называется set-kit-db:

Таблицы

Номер мягкого чека присваивается к каждой добавляемой позиции основного чека на кассе.

База данных

Касса

cash → ch_session → soft_check_number

Сервер

set_operday → od_position → soft_check_number

Пример чека отправленного в ERP

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="2">
    <purchase tabNumber="1" userName="Иванов Иван Иванович" operationType="true" operDay="2018-02-12+03:00" shop="3552" cash="1" shift="1" number="6" saletime="2018-02-13T16:06:36.510+03:00" begintime="2018-02-13T16:06:31.085+03:00" amount="611.0" discountAmount="0.0" inn="132423423423">
        <positions>
            <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="2.0" cost="305.5" nds="18.0" ndsSum="93.2" discountValue="0.0" costWithDiscount="305.5" amount="611.0" softCheckNumber="771374" dateCommit="2018-02-13T16:06:31.088+03:00"/>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="700.0" description="Оплата наличными"/>
            <payment typeClass="CashChangePaymentEntity" amount="89.0" description=""/>
        </payments>
    </purchase>   
</purchases>