Item.Get

Kassadagi barcha joriy tovarlarni, jumladan qo‘lda va boshqa integratsiyalar orqali yaratilgan tovarlarni sahifalab qaytaradi. O‘chirilgan tovarlar qaytarilmaydi. Har bir tovar bir marta ko‘rsatiladi.

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

Kirish parametrlari

Nomi Ma’lumot turi Majburiyligi Tavsif
page int32 Ixtiyoriy 1 dan boshlanadi; standart 1
page_size int32 Ixtiyoriy 1–30; standart 30

params obyekti majburiy, birinchi sahifa uchun {} yuborish mumkin. Tartib — item_id o‘sishi bo‘yicha. Natija: page, page_size, total (barcha mavjud tovarlar soni), items. Ro‘yxatdan tashqari sahifada items bo‘sh. So‘rovlar orasida katalog o‘zgarsa, sahifalar siljishi mumkin. Joriy narxlar oldingi savatlardagi narxlarni o‘zgartirmaydi.

So‘rov namunasi

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8
{
    "jsonrpc": "2.0",
    "method": "Item.Get",
    "params": {
        "page": 1,
        "page_size": 30
    },
    "id": 1
}

Chiqish parametrlari

Nomi Ma’lumot turi Tavsif
page int32 Joriy sahifa raqami, 1 dan
page_size int32 Sahifa hajmi, 1 dan 30 gacha
total int64 Barcha mavjud tovarlar soni
items array Tovarlar ro‘yxati
items[].external_id string Umumiy tashqi kalit; berilmagan yoki eski ziddiyat hal qilinmagan bo‘lsa bo‘sh
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[].price int64 Birlik narxi, tiyinda
items[].vat_value int64 yoki null QQS foizning yuzdan bir ulushida; -1 — QQSsiz; null — mavjud emas
items[].icps string IKPU kodi
items[].package_code string yoki null Qadoq kodi; mavjud bo‘lmasa null
items[].unit_kkm_code int64 O‘lchov birligi kodi
items[].owner_type int32 -1 — berilmagan; 0 — oldi-sotdi; 1 — ishlab chiqarish; 2 — xizmatlar
items[].is_labeled boolean Markirovkali tovar belgisi
items[].label_required boolean yoki null Markirovka talabi; null bo‘lsa is_labeled ishlatiladi

Javob namunasi

{
    "jsonrpc": "2.0",
    "result": {
        "page": 1,
        "page_size": 30,
        "total": 1,
        "items": [
            {
                "external_id": "SKU-001",
                "item_id": 101,
                "name": "Sinov tovari",
                "barcode": "4780000000000",
                "price": 10000,
                "vat_value": 0,
                "icps": "00000000000000000",
                "package_code": null,
                "unit_kkm_code": 1,
                "owner_type": 0,
                "is_labeled": false,
                "label_required": null
            }
        ]
    },
    "ok": true,
    "id": 1
}

Takroriy so‘rov tovarlarni o‘zgartirmaydi. Xatolar: umumiy xatolar; 701003 — sahifa parametrlari noto‘g‘ri.