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.