Cart.Get

Joriy integratsiyaning savat tarkibi va holatini mahalliy yoki tashqi identifikator bo‘yicha qaytaradi.

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

Kirish parametrlari

Nomi Ma’lumot turi Majburiyligi Tavsif
id string Ikkisidan biri Cart.Add qaytargan cart_id; 100 belgigacha
external_id string Ikkisidan biri Muvaffaqiyatli Cart.Add so‘rovining external_id qiymati; 100 belgigacha

Faqat bitta bo‘sh bo‘lmagan identifikator yuboring. external_id — Cart.Add orqali savat yaratishda berilgan kalit. Boshqa integratsiya savatlariga kirish yo‘q.

Mahalliy ID uchun: "params":{"id":"0123456789abcdef0123456789abcdef"}.

So‘rov namunasi

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8
{
    "jsonrpc": "2.0",
    "method": "Cart.Get",
    "params": {
        "external_id": "ORDER-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_id, status, receipt_id, created_at, updated_at (kassaning mahalliy vaqti, YYYY-MM-DD HH:mm:ss), total, items. Pul — tiyinda; miqdor — birlikning mingdan bir ulushida. Pozitsiya: item_id, name, barcode, icps, price, quantity, discount, amount, vat_value, package_code, label.

Holatlar: open — rasmiylashtirish kutilmoqda, bekor qilish mumkin; process — kassir rasmiylashtirmoqda; finished — fiskal chek yakunlangan; canceled — bekor qilingan. Yakunlanguncha receipt_id null, keyin chek ID qiymatini oladi. Chekni Receipt.Get orqali "params":{"id":"<receipt_id>"} bilan oling. To‘lov xatosi savatni finished holatiga o‘tkazmaydi.

Javob namunasi

{
    "jsonrpc": "2.0",
    "result": {
        "cart_id": "0123456789abcdef0123456789abcdef",
        "status": "finished",
        "receipt_id": "fedcba9876543210fedcba9876543210",
        "created_at": "2026-11-13 10:00:00",
        "updated_at": "2026-11-13 10:05:00",
        "total": 10000,
        "items": [
            {
                "item_id": 101,
                "name": "Sinov tovari",
                "barcode": "4780000000000",
                "icps": "00000000000000000",
                "price": 10000,
                "quantity": 1000,
                "discount": 0,
                "amount": 10000,
                "vat_value": 0,
                "package_code": null,
                "label": ""
            }
        ]
    },
    "ok": true,
    "id": 2
}

Takroriy so‘rov to‘lov yoki chek yaratmaydi. Xatolar: umumiy xatolar; 701003 — noto‘g‘ri yoki ikkita identifikator; 701001 — savat topilmadi yoki boshqa integratsiyaga tegishli.