Cart.Cancel

O‘z integratsiyasining saqlangan savatini bekor qiladi.

Integratsiyaning Bearer tokenini HTTP sarlavhasida yuboring. Batafsil — API avtorizatsiyasi.

Kirish parametrlari

Nomi Ma’lumot turi Majburiyligi Tavsif
id string external_id o‘rniga Mahalliy savat ID; bo‘sh bo‘lmagan satr, 100 belgigacha
external_id string id o‘rniga Cart.Add tashqi identifikatori; bo‘sh bo‘lmagan satr, 100 belgigacha

Faqat bitta parametrni uzating: id yoki external_id. Tashqi identifikator faqat joriy integratsiya savatlari orasida qidiriladi. Ikkalasi yoki hech biri berilmasa 701003, savat topilmasa yoki boshqa integratsiyaga tegishli bo‘lsa 701001 qaytariladi.

So‘rov namunasi

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8
{
    "jsonrpc": "2.0",
    "method": "Cart.Cancel",
    "params": {
        "id": "0123456789abcdef0123456789abcdef"
    },
    "id": 2
}
{
    "jsonrpc": "2.0",
    "method": "Cart.Cancel",
    "params": {
        "external_id": "ORDER-2026-001"
    },
    "id": 2
}

Chiqish parametrlari

Nomi Ma’lumot turi Tavsif
cart_id string Cart.Add qaytargan mahalliy savat ID
status string Savat holati: open, process, finished yoki canceled
receipt_id string yoki null Yakunlangan chek ID; yakunlanguncha null
created_at string Yaratish vaqti, kassa mahalliy vaqti, YYYY-MM-DD HH:mm:ss
updated_at string Yangilash vaqti, kassa mahalliy vaqti, YYYY-MM-DD HH:mm:ss
total int64 Savat summasi, chegirmadan keyin, tiyinda
items array Savat pozitsiyalari
items[].item_id int64 Cart.Add uchun mahalliy tovar ID
items[].name string Tovar nomi
items[].barcode string Shtrixkod; mavjud bo‘lmasa bo‘sh
items[].icps string IKPU kodi
items[].price int64 Birlik narxi, tiyinda
items[].quantity int64 Birlikning mingdan bir ulushidagi miqdor; 1000 — bir birlik
items[].discount int64 Butun pozitsiya chegirmasi, tiyinda
items[].amount int64 Chegirmadan keyingi summa, tiyinda
items[].vat_value int64 QQS foizning yuzdan bir ulushida; -1 — QQSsiz
items[].package_code string yoki null Qadoq kodi; mavjud bo‘lmasa null
items[].label string Birlik markirovkasi; mavjud bo‘lmasa bo‘sh

Natija Cart.Get bilan bir xil, status — canceled. Pozitsiyalar saqlanadi. Takroriy bekor qilish canceled holatini qaytaradi. Qo‘shish taqiqlanadi; davom etish uchun yangi savat yarating. Metod to‘lov yoki fiskal chekni bekor qilmaydi.

API orqali faqat open savat bekor qilinadi; process va finished uchun 703102 qaytadi. process holatida kassir savdo oynasida to‘lanmagan chekni bekor qilishi mumkin.

Javob namunasi

{
    "jsonrpc": "2.0",
    "result": {
        "cart_id": "0123456789abcdef0123456789abcdef",
        "status": "canceled",
        "receipt_id": null,
        "created_at": "2026-11-12 10:00:00",
        "updated_at": "2026-11-12 10:05:00",
        "total": 10000,
        "items": [
            {
                "item_id": 101,
                "name": "Тестовый товар",
                "barcode": "4780000000000",
                "icps": "00000000000000000",
                "price": 10000,
                "quantity": 1000,
                "discount": 0,
                "amount": 10000,
                "vat_value": 0,
                "package_code": null,
                "label": ""
            }
        ]
    },
    "ok": true,
    "id": 2
}

Xatolar: umumiy; 701003 — id/external_id berilmagan, noto‘g‘ri yoki ikkalasi berilgan; 701001 — savat yo‘q yoki boshqa integratsiyaniki.