Описание

Начиная с версии 10.4.6.0 можно восстанавливать на кассе мягкий чек, в котором товарные позиции переданы без указания штрихкода (barcode), только с артикулом (code) - поиск таких товаров на кассе будет происходить корректно.

Общее правило: для каждой товарной позиции мягкого чека должно быть задано свойство code и/или barcode, в противном случае чек не пройдёт валидацию при отправке в SetKit.

Ценность

Проверка корректности мягкого чека на этапе отправки в SetKit.
Упрощение работы с заказами.

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

Положительный сценарий

Состав мягкого чека

Внешняя система присылает в SetKit созданный заказ, в состав которого входят три товара:

позиция 1 - с указанием только штрихкода barcode;
позиция 2 - с указанием только артикула code;
позиция 3 - c указанием и штрихкода, и артикула.

{
	"status": "READY_TO_PAYMENT",
	"dateCreated": "2023-02-05 14:00",
	"isEditable": true,
    "receiptEditable": true,
	"totalPrice": 148.96,
	"discountsValue": 0.0,
	"positions": [
		{
			"positionOrder": 1,
			"barcode": "4810167000258",
			"quantity": 1,
			"unitPrice": 18.00,
			"discountValue": 0.0,
			"totalPrice": 18.00,
			"canChangePrice": false,
			"isFixedPrice": false,
			"isFixedDiscounts": false
		},
		{
			"positionOrder": 2,
			"code": "45010",
			"quantity": 1,
			"unitPrice": 102.16,
			"discountValue": 0.0,
			"totalPrice": 102.16,
			"canChangePrice": false,
			"isFixedPrice": false,
			"isFixedDiscounts": false
		},
		{
			"positionOrder": 3,
			"code": "45033",
			"barcode": "4607141310331",
			"quantity": 1,
			"unitPrice": 28.80,
			"discountValue": 0.0,
			"totalPrice": 28.80,
			"canChangePrice": false,
			"isFixedPrice": false,
			"isFixedDiscounts": false
		}
	],
	"client": {
		"guid": "100021",
		"phone": "9111500964",
		"cardNumber": "9000000010",
		"email": "test@test.ru",
		"firstName": "Oleg",
		"lastName": "Olegov"
	}
}

Работа на кассе

1. Кассир восстанавливает на кассе мягкий чек путём сканирования штрихкода или через окно поиска но номеру заказа/телефона.

2. Касса производит поиск товаров по штрихкоду/артикулу, указанным в мягком чеке, и добавляет заказ в чек.

3. Кассир рассчитывает покупателя.

Отрицательный сценарий

Внешняя система отправляет в SetKit созданный заказ, в состав которого входят два товара:

позиция 1 - с указанием штрихода barcode;
позиция 2 - без указания штрихкода или артикула.

{
	"status": "READY_TO_PAYMENT",
	"dateCreated": "2023-02-05 14:00",
	"isEditable": true,
    "receiptEditable": true,
	"totalPrice": 148.96,
	"discountsValue": 0.0,
	"positions": [
		{
			"positionOrder": 1,
			"barcode": "4810167000258",
			"quantity": 1,
			"unitPrice": 18.00,
			"discountValue": 0.0,
			"totalPrice": 18.00,
			"canChangePrice": false,
			"isFixedPrice": false,
			"isFixedDiscounts": false
		},
		{
			"positionOrder": 2,
			"quantity": 1,
			"unitPrice": 102.16,
			"discountValue": 0.0,
			"totalPrice": 102.16,
			"canChangePrice": false,
			"isFixedPrice": false,
			"isFixedDiscounts": false
		}
	],
	"client": {
		"guid": "100021",
		"phone": "9111500964",
		"cardNumber": "9000000010",
		"email": "test@test.ru",
		"firstName": "Oleg",
		"lastName": "Olegov"
	}
}

SetKit возвращает сообщение об ошибке "Мягкий чек не прошел валидацию":

{
	"code": "1030",
	"message": "Мягкий чек не прошел валидацию.",
	"errors": [
    "'code' или 'barcode' должен быть заполнен"
	]
}

SetKit ◾️ Передача товаров в мягком чеке без указания штрихкода