Receipt.Get

Ushbu kassaning chekini ID yoki cheklar ro‘yxatini davr bo‘yicha, jumladan integratsiyadan tashqarida yaratilgan cheklarni qaytaradi.

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

Kirish parametrlari

Nomi Ma’lumot turi Majburiyligi Tavsif
id string Davr o‘rniga Chek ID, 100 belgigacha; Cart.Get qaytargan receipt_id ham qabul qilinadi
date_from string id bo‘lmasa Davr boshi kiritiladi, YYYY-MM-DD HH:mm:ss, kassa mahalliy vaqti
date_to string id bo‘lmasa Davr oxiri kiritilmaydi; shu format, date_from dan katta
page int32 Ixtiyoriy 1 dan boshlanadi, sukutda 1
page_size int32 Ixtiyoriy 1–30, sukutda 30

Bo‘sh bo‘lmagan id yoki davrning ikkala maydonini yuboring. Ikkala rejimni birlashtirib bo‘lmaydi. ID bo‘yicha page faqat 1; natija shakli saqlanadi: page, page_size, total: 1 va items ichida bitta chek. Topilmagan ID — 701001; noto‘g‘ri ID yoki aralash filtrlar — 701003.

Davr bo‘yicha yangi cheklar avval; vaqti bir xil bo‘lsa ID bo‘yicha barqaror tartib. Mavjud bo‘lmagan sahifa items: [] qaytaradi. So‘rovlar orasida yangi chek qo‘shilsa sahifalar siljishi mumkin; ketma-ket yuklash uchun tugagan davrni ishlating.

So‘rov namunasi

Authorization: Bearer <integration-token>
Content-Type: application/json;charset=utf-8
{
    "jsonrpc": "2.0",
    "method": "Receipt.Get",
    "params": {
        "id": "0123456789abcdef0123456789abcdef"
    },
    "id": 3
}
{
    "jsonrpc": "2.0",
    "method": "Receipt.Get",
    "params": {
        "date_from": "2026-11-01 00:00:00",
        "date_to": "2026-11-02 00:00:00",
        "page": 1,
        "page_size": 30
    },
    "id": 3
}

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 Filtrga mos cheklar soni
items array Cheklar ro‘yxati
items[].id string Chek ID
items[].code string Tashqi chek kodi; mavjud bo‘lmasa bo‘sh
items[].date_time string Chek vaqti, kassa mahalliy vaqti, YYYY-MM-DD HH:mm:ss
items[].type int32 0 — oddiy; 1 — avans; 2 — kredit
items[].is_return boolean Qaytarish belgisi
items[].receipt_no string Fiskal chek raqami o‘rniga *** niqobi
items[].terminal_id string Fiskal modul ID
items[].fiscal_sign string Fiskal belgi o‘rniga *** niqobi
items[].qr_url string QR-kod havolasi o‘rniga *** niqobi
items[].amount int64 Chegirmadan keyingi summa, tiyinda
items[].payments array Chek to‘lovlari; to‘lov ma’lumotlari bo‘lmasa bo‘sh massiv
items[].payments[].type int32 To‘lov turi: 0 — boshqa/aniqlanmagan; 1 — naqd; 2 — bank kartasi yoki to‘lov tizimi; 3 — bonus
items[].payments[].name string Saqlangan to‘lov usuli nomi; bo‘lmasa bo‘sh satr
items[].payments[].amount int64 To‘lov summasi tiyinda
items[].payments[].card_type int32 or null Karta turi: 1 — korporativ; 2 — shaxsiy; 3 — ijtimoiy; ko‘rsatilmasa null
items[].payments[].rrn string Operatsiya RRN raqami; bo‘lmasa bo‘sh satr
items[].positions array Chek tarkibi saqlangan tartibda; tarkib bo‘lmasa bo‘sh massiv
items[].positions[].name string Sotish vaqtidagi nomi
items[].positions[].barcode string Shtrix-kod; bo‘lmasa bo‘sh satr
items[].positions[].icps string IKPU
items[].positions[].quantity int64 Miqdor mingdan bir ulushlarda; 1000 = bir birlik
items[].positions[].price int64 Birlik narxi tiyinda, butun tiyingacha yaxlitlangan
items[].positions[].discount int64 Butun pozitsiya chegirmasi tiyinda
items[].positions[].other int64 Pozitsiya summasidan boshqa chegirish tiyinda
items[].positions[].amount int64 Chegirma va boshqa chegirishdan keyingi pozitsiya summasi tiyinda
items[].positions[].vat_value int64 QQS foizning yuzdan bir ulushlarida; -1 — QQSsiz
items[].positions[].package_code string or null Qadoq kodi; bo‘lmasa null
items[].positions[].label string Markirovka kodi; bo‘lmasa bo‘sh satr

Natija: page, page_size, total (davrdagi barcha cheklar), items. Har bir chek: id, code (tashqi kod yoki bo‘sh), date_time (mahalliy YYYY-MM-DD HH:mm:ss), type (0 oddiy, 1 avans, 2 kredit), is_return, receipt_no, terminal_id, fiscal_sign, qr_url, amount (chegirmadan keyingi tiyin; qaytarish belgisi alohida).

ID va davr bo‘yicha so‘rovlarda receipt_no, fiscal_sign, qr_url har doim *** qaytaradi. To‘liq rekvizitlar qog‘oz chekda chop etiladi. Chek ID va qolgan maydonlar niqoblanmaydi.

positions ID bo‘yicha ham, davr ro‘yxatida ham qaytariladi. Qiymatlar chek rasmiylashtirilgan vaqtda saqlangan, joriy tovar ma’lumotlariga bog‘liq emas. Pozitsiya summasi butun miqdorning dastlabki summasidan discount va other ayirilgan qiymat; price alohida yaxlitlanadi.

payments massivi chekda saqlangan to‘lovlarni, jumladan bir nechta usuldagi aralash to‘lovni qaytaradi. U ID bo‘yicha ham, davr bo‘yicha ham mavjud. Bank kartasi raqami javobga kiritilmaydi.

Javob namunasi

{
    "jsonrpc": "2.0",
    "result": {
        "page": 1,
        "page_size": 30,
        "total": 1,
        "items": [
            {
                "id": "0123456789abcdef0123456789abcdef",
                "code": "SALE-001",
                "date_time": "2026-11-01 12:00:00",
                "type": 0,
                "is_return": false,
                "receipt_no": "***",
                "terminal_id": "TEST000000001",
                "fiscal_sign": "***",
                "qr_url": "***",
                "amount": 10000,
                "positions": [
                    {
                        "name": "Sinov tovari",
                        "barcode": "4780000000000",
                        "icps": "00000000000000000",
                        "quantity": 1000,
                        "price": 10000,
                        "discount": 0,
                        "other": 0,
                        "amount": 10000,
                        "vat_value": 0,
                        "package_code": null,
                        "label": ""
                    }
                ],
                "payments": [
                    {
                        "type": 1,
                        "name": "Naqd",
                        "amount": 4000,
                        "card_type": null,
                        "rrn": ""
                    },
                    {
                        "type": 2,
                        "name": "Bank kartasi",
                        "amount": 6000,
                        "card_type": 2,
                        "rrn": "123456789012"
                    }
                ]
            }
        ]
    },
    "ok": true,
    "id": 3
}

Takroriy so‘rov cheklar ma’lumotini o‘zgartirmaydi. Xatolar: umumiy, 701003 — davr/page/page_size noto‘g‘ri.