API

O‘zbekcha

Русский

O‘zbekcha

Русский

Mavzu

Inkassatsiyalar ​

Inkassatsiya — pulni savdo kassasidan asosiy kassaga topshirish. Pul savdo kassasidan darhol yechiladi va asosiy kassa qabul qilguncha yoki inkassatsiya bekor qilinguncha tasdiq kutadi (status = on_hold).

MetodManzilVazifasi
GET/company/cashbox/collection/not-collected-amountsInkassatsiya qilinmagan summalar
PATCH/company/cashbox/collection/{model}/completeInkassatsiyani qabul qilish
PATCH/company/cashbox/collection/{model}/cancelInkassatsiyani bekor qilish
GET/company/cashbox/collectionInkassatsiyalar ro‘yxati
GET/company/cashbox/collection/{model}Inkassatsiya
POST/company/cashbox/collectionInkassatsiya yaratish

Inkassatsiya qilinmagan summalar ​

GET/company/cashbox/collection/not-collected-amounts

?cashbox_id= dagi kassaning joriy qoldiqlari «to‘lov turi → valyuta → summa» matritsasi ko‘rinishida; yo‘q juftliklar nol bilan to‘ldiriladi. cashbox_id siz barcha summalar nolga teng.

Sarlavhalar (headers) ​

SarlavhaQiymatTavsif
AuthorizationBearer {token}POST /common/auth/login dan olingan token
Acceptapplication/jsonJavob JSON da
Accept-LanguageruXabarlar va nomlar tili: ru, uz, oz

So‘rov parametrlari ​

ParametrTavsif
cashbox_idKassa
http
GET /company/cashbox/collection/not-collected-amounts?cashbox_id=2

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
bankobjectBank
bank.uzsinteger
bank.usdinteger
bank.eurinteger
bank.rubinteger
cardobject
card.uzsstring
card.usdinteger
card.eurinteger
card.rubinteger
cashobject
cash.uzsstring
cash.usdinteger
cash.eurinteger
cash.rubinteger
systemobject
system.uzsinteger
system.usdinteger
system.eurinteger
system.rubinteger
json
{
    "bank": {
        "uzs": 0,
        "usd": 0,
        "eur": 0,
        "rub": 0
    },
    "card": {
        "uzs": "3000.00",
        "usd": 0,
        "eur": 0,
        "rub": 0
    },
    "cash": {
        "uzs": "1000.00",
        "usd": 0,
        "eur": 0,
        "rub": 0
    },
    "system": {
        "uzs": 0,
        "usd": 0,
        "eur": 0,
        "rub": 0
    }
}

Inkassatsiyani qabul qilish ​

PATCH/company/cashbox/collection/{model}/complete

Asosiy kassa pulni olganini tasdiqlaydi: inkassatsiya va uning tranzaksiyalari completed holatiga o‘tadi, pul asosiy kassaga kirim qilinadi. Faqat on_hold holatidan mumkin, aks holda 400.

Formadan (multipart/form-data) PATCH metodi POST + ?_method=PATCH parametri bilan yuboriladi.

Sarlavhalar (headers) ​

SarlavhaQiymatTavsif
AuthorizationBearer {token}POST /common/auth/login dan olingan token
Acceptapplication/jsonJavob JSON da
Accept-LanguageruXabarlar va nomlar tili: ru, uz, oz

Yo‘l parametrlari ​

ParametrTavsif
modelYozuv ID si

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
messagestringXabar
json
{
    "message": "Success"
}

Inkassatsiyani bekor qilish ​

PATCH/company/cashbox/collection/{model}/cancel

on_hold holatidagi inkassatsiyani bekor qiladi: tranzaksiyalar canceled holatiga o‘tadi va pul savdo kassasiga qaytadi. Boshqa holatdan — 400.

Formadan (multipart/form-data) PATCH metodi POST + ?_method=PATCH parametri bilan yuboriladi.

Sarlavhalar (headers) ​

SarlavhaQiymatTavsif
AuthorizationBearer {token}POST /common/auth/login dan olingan token
Acceptapplication/jsonJavob JSON da
Accept-LanguageruXabarlar va nomlar tili: ru, uz, oz

Yo‘l parametrlari ​

ParametrTavsif
modelYozuv ID si

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
messagestringXabar
json
{
    "message": "Success"
}

Inkassatsiyalar ro‘yxati ​

GET/company/cashbox/collection

Foydalanuvchiga ochiq kassalar bo‘yicha inkassatsiyalar. Sahifadan tashqari javobda total — filtrlar hisobga olingan holda holat va valyuta bo‘yicha guruhlangan summalar (total.on_hold.uzs va h.k.).

Sarlavhalar (headers) ​

SarlavhaQiymatTavsif
AuthorizationBearer {token}POST /common/auth/login dan olingan token
Acceptapplication/jsonJavob JSON da
Accept-LanguageruXabarlar va nomlar tili: ru, uz, oz

So‘rov parametrlari ​

ParametrTavsif
filter[id]ID — aniq qiymat
filter[company_id]Kompaniya — aniq qiymat
filter[creator_id]Yaratuvchi — aniq qiymat
filter[cashbox_id]Kassa — aniq qiymat
filter[status]Status — aniq qiymat
filter[created_at]Yaratilgan — davr: [0] — dan, [1] — gacha (Y-m-d)
sort[]Saralash, - — kamayish bo‘yicha: id, -id
with[]Bog‘liq ma’lumotlarni qo‘shish: company, creator.profile, cashbox
pageSahifa raqami, 1 dan
page-sizeSahifadagi yozuvlar soni, ko‘pi bilan 20
http
GET /company/cashbox/collection?sort[0]=id&sort[1]=-id

Javob · 200 ​

Sahifalangan javob: yozuvlar data[] ichida, sahifalash links va meta da.

Javob maydonlari
MaydonTuriTavsif
dataobject[]Ma'lumotlar
data[].idintegerID
data[].company_idintegerKompaniya
data[].creator_idintegerYaratuvchi
data[].cashbox_idintegerKassa
data[].statusstringStatus
data[].commentstringIzoh
data[].transactions_dataobject[]
data[].transactions_data[].idintegerID
data[].transactions_data[].typestringTuri
data[].transactions_data[].amountintegerSumma
data[].transactions_data[].statusstringStatus
data[].transactions_data[].commentstringIzoh
data[].transactions_data[].currencystringValyuta
data[].transactions_data[].source_idintegerManba
data[].transactions_data[].additionalstring
data[].transactions_data[].cashbox_idintegerKassa
data[].transactions_data[].company_idintegerKompaniya
data[].transactions_data[].created_atstringYaratilgan
data[].transactions_data[].creator_idintegerYaratuvchi
data[].transactions_data[].updated_atstringYangilangan
data[].transactions_data[].source_typestringManba
data[].transactions_data[].payment_typestringTo'lov turi
data[].additionalobject
data[].additional.on_hold_afterarray
data[].additional.balances_afterarray
data[].created_atstringYaratilgan
data[].updated_atstringYangilangan
json
{
    "data": [
        {
            "id": 1,
            "company_id": 1,
            "creator_id": 2,
            "cashbox_id": 2,
            "status": "on_hold",
            "comment": "Comment 1",
            "transactions_data": [
                {
                    "id": 1,
                    "type": "income",
                    "amount": 1000,
                    "status": "completed",
                    "comment": "Comment 1",
                    "currency": "uzs",
                    "source_id": 1,
                    "additional": "{\"balances_after\":[],\"on_hold_after\":[]}",
                    "cashbox_id": 1,
                    "company_id": 1,
                    "created_at": "2026-09-30 12:47:58",
                    "creator_id": 2,
                    "updated_at": "2026-09-30 12:47:58",
                    "source_type": "reason",
                    "payment_type": "cash"
                },
                {
                    "id": 2,
                    "type": "outcome",
                    "amount": 2000,
                    "status": "canceled",
                    "comment": "Comment 2",
                    "currency": "usd",
                    "source_id": 1,
                    "additional": "{\"balances_after\":[],\"on_hold_after\":[]}",
                    "cashbox_id": 1,
                    "company_id": 1,
                    "created_at": "2026-09-30 12:47:58",
                    "creator_id": 2,
                    "updated_at": "2026-09-30 12:47:58",
                    "source_type": "supplier",
                    "payment_type": "cash"
                }
            ],
            "additional": {
                "on_hold_after": [],
                "balances_after": []
            },
            "created_at": "2026-09-30 12:47:58",
            "updated_at": "2026-09-30 12:47:58"
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/company/cashbox/collection?page=1",
        "last": "https://api.wasyt.uz/company/cashbox/collection?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/company/cashbox/collection",
        "per_page": 20,
        "to": 1,
        "total": 1
    },
    "total": {
        "on_hold": {
            "uzs": "1000",
            "usd": "2000"
        }
    }
}

Inkassatsiya ​

GET/company/cashbox/collection/{model}

Bitta inkassatsiya, uning tranzaksiyalari (transactions_data) va yaratilgan paytdagi kassa qoldiqlari surati (additional) bilan.

Sarlavhalar (headers) ​

SarlavhaQiymatTavsif
AuthorizationBearer {token}POST /common/auth/login dan olingan token
Acceptapplication/jsonJavob JSON da
Accept-LanguageruXabarlar va nomlar tili: ru, uz, oz

Yo‘l parametrlari ​

ParametrTavsif
modelYozuv ID si

So‘rov parametrlari ​

ParametrTavsif
cashbox_idKassa
http
GET /company/cashbox/collection/not-collected-amounts?cashbox_id=2

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
bankobjectBank
bank.uzsinteger
bank.usdinteger
bank.eurinteger
bank.rubinteger
cardobject
card.uzsstring
card.usdinteger
card.eurinteger
card.rubinteger
cashobject
cash.uzsstring
cash.usdinteger
cash.eurinteger
cash.rubinteger
systemobject
system.uzsinteger
system.usdinteger
system.eurinteger
system.rubinteger
json
{
    "bank": {
        "uzs": 0,
        "usd": 0,
        "eur": 0,
        "rub": 0
    },
    "card": {
        "uzs": "3000.00",
        "usd": 0,
        "eur": 0,
        "rub": 0
    },
    "cash": {
        "uzs": "1000.00",
        "usd": 0,
        "eur": 0,
        "rub": 0
    },
    "system": {
        "uzs": 0,
        "usd": 0,
        "eur": 0,
        "rub": 0
    }
}

Inkassatsiya yaratish ​

POST/company/cashbox/collection

Savdo kassasini inkassatsiya qiladi: naqd pul — transactions dagi summalar bilan (har bir valyutaga bitta qator), barcha musbat naqdsiz qoldiqlar esa avtomatik to‘liq qo‘shiladi. Naqd summa qoldiqdan oshmasligi kerak, UZS uchun undan ko‘pi bilan 100 000 ga kam bo‘lishi mumkin, boshqa valyutalar uchun — faqat butun qoldiq. Pul kassadan darhol yechiladi, inkassatsiya on_hold holatida yaratiladi.

Sarlavhalar (headers) ​

SarlavhaQiymatTavsif
AuthorizationBearer {token}POST /common/auth/login dan olingan token
Acceptapplication/jsonJavob JSON da
Accept-LanguageruXabarlar va nomlar tili: ru, uz, oz

So‘rov tanasi ​

MaydonTuriMajburiyTavsif
cashbox_idintegerHaKassa. Foydalanuvchiga ochiq mavjud yozuv ID si
commentstringYo‘qIzoh. Maks. 1000 belgi
transactionsobject[]Yo‘qInkassatsiya qilinadigan naqd pul, har bir valyutaga bir qator
transactions[].currencystringHaValyuta. Takrorlanmasin. Mumkin qiymatlar: uzs, usd, eur, rub
transactions[].amountnumberHaSumma. Verguldan keyin 2 tagacha raqam. Kamida 0.01. 999999999999.99 dan oshmasin
json
{
    "cashbox_id": 2,
    "comment": "Comment 3",
    "transactions": [
        {
            "currency": "uzs",
            "amount": 300
        }
    ]
}
bash
curl -X POST "https://api.wasyt.uz/company/cashbox/collection" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"cashbox_id":2,"comment":"Comment 3","transactions":[{"currency":"uzs","amount":300}]}'

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
cashbox_idintegerKassa
commentstringIzoh
statusstringStatus
updated_atstringYangilangan
created_atstringYaratilgan
company_idintegerKompaniya
creator_idintegerYaratuvchi
idintegerID
transactions_dataobject[]
transactions_data[].additionalobject
transactions_data[].additional.balances_afterobject
transactions_data[].additional.balances_after.cashobject
transactions_data[].additional.balances_after.cash.uzsstring
transactions_data[].additional.balances_after.cardobject
transactions_data[].additional.balances_after.card.uzsstring
transactions_data[].additional.on_hold_afterobject
transactions_data[].additional.on_hold_after.outcomeobject
transactions_data[].additional.on_hold_after.outcome.cashobject
transactions_data[].source_dataobject
transactions_data[].source_data.collection_idinteger
transactions_data[].source_data.codestringKod
transactions_data[].cashbox_idintegerKassa
transactions_data[].creator_idintegerYaratuvchi
transactions_data[].commentstringIzoh
transactions_data[].typestringTuri
transactions_data[].payment_typestringTo'lov turi
transactions_data[].currencystringValyuta
transactions_data[].amountintegerSumma
transactions_data[].statusstringStatus
transactions_data[].source_typestringManba
transactions_data[].source_idintegerManba
transactions_data[].updated_atstringYangilangan
transactions_data[].created_atstringYaratilgan
transactions_data[].company_idintegerKompaniya
transactions_data[].idintegerID
additionalobject
additional.balances_afterobject
additional.balances_after.cashobject
additional.balances_after.cash.uzsstring
additional.balances_after.cardobject
additional.balances_after.card.uzsstring
additional.on_hold_afterobject
additional.on_hold_after.outcomeobject
additional.on_hold_after.outcome.cardobject
additional.on_hold_after.outcome.card.uzsstring
additional.on_hold_after.outcome.cashobject
additional.on_hold_after.outcome.cash.uzsstring
json
{
    "cashbox_id": 2,
    "comment": "Comment 3",
    "status": "on_hold",
    "updated_at": "2026-09-30 12:51:11",
    "created_at": "2026-09-30 12:51:11",
    "company_id": 1,
    "creator_id": 2,
    "id": 2,
    "transactions_data": [
        {
            "additional": {
                "balances_after": {
                    "cash": {
                        "uzs": "700.00"
                    },
                    "card": {
                        "uzs": "3000.00"
                    }
                },
                "on_hold_after": {
                    "outcome": {
                        "cash": {
                            "uzs": "300.00"
                        }
                    }
                }
            },
            "source_data": {
                "collection_id": 2,
                "code": "CT-2-1877742370559153"
            },
            "cashbox_id": 2,
            "creator_id": 2,
            "comment": "Comment 3",
            "type": "outcome",
            "payment_type": "cash",
            "currency": "uzs",
            "amount": 300,
            "status": "on_hold",
            "source_type": "collection",
            "source_id": 1,
            "updated_at": "2026-09-30 12:51:11",
            "created_at": "2026-09-30 12:51:11",
            "company_id": 1,
            "id": 4
        },
        {
            "additional": {
                "balances_after": {
                    "cash": {
                        "uzs": "700.00"
                    },
                    "card": {
                        "uzs": "0.00"
                    }
                },
                "on_hold_after": {
                    "outcome": {
                        "card": {
                            "uzs": "3000.00"
                        },
                        "cash": {
                            "uzs": "300.00"
                        }
                    }
                }
            },
            "source_data": {
                "collection_id": 2,
                "code": "CT-2-1877742370583008"
            },
            "cashbox_id": 2,
            "creator_id": 2,
            "comment": "Comment 3",
            "type": "outcome",
            "payment_type": "card",
            "currency": "uzs",
            "amount": 3000,
            "status": "on_hold",
            "source_type": "collection",
            "source_id": 1,
            "updated_at": "2026-09-30 12:51:11",
            "created_at": "2026-09-30 12:51:11",
            "company_id": 1,
            "id": 5
        }
    ],
    "additional": {
        "balances_after": {
            "cash": {
                "uzs": "700.00"
            },
            "card": {
                "uzs": "0.00"
            }
        },
        "on_hold_after": {
            "outcome": {
                "card": {
                    "uzs": "3000.00"
                },
                "cash": {
                    "uzs": "300.00"
                }
            }
        }
    }
}

Xato misoli · 422 ​

json
{
    "message": "Значение поля Сумма не может быть больше 0.",
    "errors": {
        "transactions.1.amount": [
            "Значение поля Сумма не может быть больше 0."
        ]
    }
}