API

O‘zbekcha

Русский

O‘zbekcha

Русский

Mavzu

Kirimlar ​

Yetkazib beruvchidan omborga tovar kelishi hujjatlari. Kirim waiting_for_confirmation holatida yaratiladi va faqat yakunlangandan keyin qoldiq, narx va yetkazib beruvchi balansini o‘zgartiradi.

MetodManzilVazifasi
PATCH/company/trade/purchase/{model}/completeKirimni yakunlash
PATCH/company/trade/purchase/{model}/cancelKirimni bekor qilish
GET/company/trade/purchase/{model}/productsKirim tovarlari
GET/company/trade/purchaseKirimlar ro‘yxati
GET/company/trade/purchase/{model}Kirim tafsilotlari
POST/company/trade/purchaseKirim yaratish
PUT/company/trade/purchase/{model}Kirimni tahrirlash

Kirimni yakunlash ​

PATCH/company/trade/purchase/{model}/complete

Kirimni waiting_for_confirmationdan completedga o‘tkazadi: tovar omborga tushadi, tovarlarning sotuv narxlari yangilanadi, yetkazib beruvchi ko‘rsatilgan bo‘lsa uning balansi bo‘yicha operatsiya yaratiladi. UZS dan boshqa valyuta uchun kompaniyada kurs o‘rnatilgan bo‘lishi kerak.

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"
}

Kirimni bekor qilish ​

PATCH/company/trade/purchase/{model}/cancel

Kirimni canceled holatiga o‘tkazadi. Faqat waiting_for_confirmation holatidagi kirim uchun; qoldiqlar o‘zgarmaydi.

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"
}

Kirim tovarlari ​

GET/company/trade/purchase/{model}/products

Kirim qatorlarining sahifalanmagan oddiy ro‘yxati: nomi, shtrix-kod, kirim narxi, miqdor va sana.

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
[].namestringNomlanish
[].full_textstringTo'liq matn
[].barcodestringShtrix kod
[].purchase_pricestringSotib olish narxi
[].quantitystringMiqdori
[].created_atstringYaratilgan
json
[
    {
        "name": "Product 1",
        "full_text": "Product 1",
        "barcode": "0000000000001",
        "purchase_price": "1000.00",
        "quantity": "1.0000",
        "created_at": "2026-09-30 12:47:59"
    },
    {
        "name": "Product 1-1",
        "full_text": "Product 1-1 full text",
        "barcode": "0000000000011",
        "purchase_price": "2000.00",
        "quantity": "2.0000",
        "created_at": "2026-09-30 12:47:59"
    }
]

Kirimlar ro‘yxati ​

GET/company/trade/purchase

Kirimlar sahifalab va filtrlar bilan. Qo‘shimcha ravishda joriy oy (month) va kun (day) uchun total: yakunlangan kirimlarning valyutalar bo‘yicha summasi va kelgan birliklar umumiy soni.

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[creator_id]Yaratuvchi — aniq qiymat
filter[company_id]Kompaniya — aniq qiymat
filter[stock_id]Ombor — aniq qiymat
filter[supplier_id]Yetkazib beruvchi — aniq qiymat
filter[inventory_id]Inventarizatsiya — aniq qiymat
filter[name]Nomlanish — qator qismi bo‘yicha qidiruv
filter[datetime]Sana va vaqt — davr: [0] — dan, [1] — gacha (Y-m-d)
filter[currency]Valyuta — 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: creator.profile, company, company.director.profile, stock, supplier, inventory
pageSahifa raqami, 1 dan
page-sizeSahifadagi yozuvlar soni, ko‘pi bilan 20
http
GET /company/trade/purchase?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[].creator_idintegerYaratuvchi
data[].company_idintegerKompaniya
data[].stock_idintegerOmbor
data[].supplier_idintegerYetkazib beruvchi
data[].inventory_idnullInventarizatsiya
data[].namestringNomlanish
data[].datetimestringSana va vaqt
data[].currencystringValyuta
data[].statusstringStatus
data[].purchase_priceintegerSotib olish narxi
data[].sale_priceintegerSotish narxi
data[].created_atstringYaratilgan
data[].updated_atstringYangilangan
data[].sale_price_uzsinteger
json
{
    "data": [
        {
            "id": 1,
            "creator_id": 2,
            "company_id": 1,
            "stock_id": 1,
            "supplier_id": 1,
            "inventory_id": null,
            "name": "Purchase 1",
            "datetime": "2026-09-30 12:47:59",
            "currency": "uzs",
            "status": "waiting_for_confirmation",
            "purchase_price": 5000,
            "sale_price": 5900,
            "created_at": "2026-09-30 12:47:59",
            "updated_at": "2026-09-30 12:47:59",
            "sale_price_uzs": 5900
        }
    ],
    "links": {
        "first": "https://api.wasyt.uz/company/trade/purchase?page=1",
        "last": "https://api.wasyt.uz/company/trade/purchase?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/company/trade/purchase",
        "per_page": 20,
        "to": 1,
        "total": 1
    },
    "total": {
        "month": {
            "purchase_price": [],
            "products_quantity": "0"
        },
        "day": {
            "purchase_price": [],
            "products_quantity": "0"
        }
    }
}

Kirim tafsilotlari ​

GET/company/trade/purchase/{model}

Bitta kirim: ombor, yetkazib beruvchi, valyuta, holat va kirim hamda sotuv narxlaridagi summalar.

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
idintegerID
creator_idintegerYaratuvchi
company_idintegerKompaniya
stock_idintegerOmbor
supplier_idintegerYetkazib beruvchi
inventory_idnullInventarizatsiya
namestringNomlanish
datetimestringSana va vaqt
currencystringValyuta
statusstringStatus
purchase_priceintegerSotib olish narxi
sale_priceintegerSotish narxi
created_atstringYaratilgan
updated_atstringYangilangan
stockobject
stock.idintegerID
stock.creator_idintegerYaratuvchi
stock.company_idintegerKompaniya
stock.namestringNomlanish
stock.is_availableboolean
stock.created_atstringYaratilgan
stock.updated_atstringYangilangan
stock.is_deletedboolean
supplierobject
supplier.idintegerID
supplier.creator_idintegerYaratuvchi
supplier.company_idintegerKompaniya
supplier.namestringNomlanish
supplier.full_namestringFISH
supplier.typestringTuri
supplier.phonestringTelefon
supplier.additional_phonesarrayQo‘shimcha telefonlar
supplier.innstringINN
supplier.addressstringManzil
supplier.categorynullKategoriya
supplier.currencynullValyuta
supplier.currenciesarrayValyutalar
supplier.bank_accountnullHisob raqami
supplier.mfonullMFO
supplier.bank_namenullBank nomi
supplier.photonull
supplier.photo_thumbsarray
supplier.start_balancesobject
supplier.start_balances.eurinteger
supplier.start_balances.rubinteger
supplier.start_balances.usdinteger
supplier.start_balances.uzsinteger
supplier.start_balance_set_atnull
supplier.created_atstringYaratilgan
supplier.updated_atstringYangilangan
supplier.is_deletedboolean
sale_price_uzsinteger
json
{
    "id": 1,
    "creator_id": 2,
    "company_id": 1,
    "stock_id": 1,
    "supplier_id": 1,
    "inventory_id": null,
    "name": "Purchase 1",
    "datetime": "2026-09-30 12:47:59",
    "currency": "uzs",
    "status": "waiting_for_confirmation",
    "purchase_price": 5000,
    "sale_price": 5900,
    "created_at": "2026-09-30 12:47:59",
    "updated_at": "2026-09-30 12:47:59",
    "stock": {
        "id": 1,
        "creator_id": 2,
        "company_id": 1,
        "name": "Stock 1",
        "is_available": true,
        "created_at": "2026-09-30 12:47:59",
        "updated_at": "2026-09-30 12:47:59",
        "is_deleted": false
    },
    "supplier": {
        "id": 1,
        "creator_id": 2,
        "company_id": 1,
        "name": "Supplier 1",
        "full_name": "Full name 1",
        "type": "person",
        "phone": "998000000001",
        "additional_phones": [
            "998000000011",
            "998000000012"
        ],
        "inn": "000000001",
        "address": "Address 1",
        "category": null,
        "currency": null,
        "currencies": [],
        "bank_account": null,
        "mfo": null,
        "bank_name": null,
        "photo": null,
        "photo_thumbs": [],
        "start_balances": {
            "eur": 0,
            "rub": 0,
            "usd": 0,
            "uzs": 1000
        },
        "start_balance_set_at": null,
        "created_at": "2026-09-30 12:47:58",
        "updated_at": "2026-09-30 12:47:58",
        "is_deleted": false
    },
    "sale_price_uzs": 5900
}

Kirim yaratish ​

POST/company/trade/purchase

Tovar qatorlari bilan waiting_for_confirmation holatidagi kirim yaratadi; qoldiqlar faqat yakunlangandan keyin o‘zgaradi. Qatorning sotuv narxi kirim narxidan past emas, valyuta yetkazib beruvchining hisob-kitob valyutasiga mos, sana — bir oydan eski emas va kelajakda emas. name bo‘lmasa raqam avtomatik beriladi; is_last_step true bo‘lishi kerak.

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
company_idintegerHaKompaniya. Foydalanuvchiga ochiq mavjud yozuv ID si
stock_idintegerHaOmbor. Foydalanuvchiga ochiq mavjud yozuv ID si
supplier_idintegerYo‘qYetkazib beruvchi. Foydalanuvchiga ochiq mavjud yozuv ID si
namestringYo‘qNomlanish. Maks. 255 belgi
datetimestring (date)Yo‘qSana va vaqt. Format Y-m-d H:i:s. Kamida joriy sana. Ko‘pi bilan joriy sana
currencystringHaValyuta. Mumkin qiymatlar: uzs, usd, eur, rub
productsobject[]HaMahsulotlar. Maks. 5000 ta element
products[].idintegerYo‘qID
products[].product_idintegerHaTovar. Takrorlanmasin
products[].purchase_pricenumberHaSotib olish narxi. Verguldan keyin 2 tagacha raqam. Kamida 0.01. 999999999999.99 dan oshmasin
products[].sale_pricenumberHaSotish narxi. Verguldan keyin 2 tagacha raqam. Kamida 0.01. 999999999999.99 dan oshmasin. products[].purchase_price dan katta yoki teng
products[].quantitynumberHaMiqdori. Verguldan keyin 4 tagacha raqam. Kamida 0.0001
is_last_stepbooleanYo‘qtrue bo‘lishi shart
json
{
    "company_id": 1,
    "stock_id": 1,
    "supplier_id": 1,
    "name": "Purchase 3",
    "datetime": "2026-09-30 12:54:27",
    "currency": "uzs",
    "products": [
        {
            "product_id": 1,
            "purchase_price": 3000,
            "sale_price": 3900,
            "quantity": 3
        },
        {
            "product_id": 2,
            "purchase_price": 4000,
            "sale_price": 5600,
            "quantity": 4
        },
        {
            "product_id": 3,
            "purchase_price": 1,
            "sale_price": 2,
            "quantity": 3
        }
    ],
    "is_last_step": 1
}
bash
curl -X POST "https://api.wasyt.uz/company/trade/purchase" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"company_id":1,"stock_id":1,"supplier_id":1,"name":"Purchase 3","datetime":"2026-09-30 12:54:27","currency":"uzs","products":[{"product_id":1,"purchase_price":3000,"sale_price":3900,"quantity":3},{"product_id":2,"purchase_price":4000,"sale_price":5600,"quantity":4},{"product_id":3,"purchase_price":1,"sale_price":2,"quantity":3}],"is_last_step":1}'

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
company_idintegerKompaniya
stock_idintegerOmbor
supplier_idintegerYetkazib beruvchi
namestringNomlanish
datetimestringSana va vaqt
currencystringValyuta
updated_atstringYangilangan
created_atstringYaratilgan
creator_idintegerYaratuvchi
idintegerID
purchase_priceintegerSotib olish narxi
sale_priceintegerSotish narxi
sale_price_uzsinteger
json
{
    "company_id": 1,
    "stock_id": 1,
    "supplier_id": 1,
    "name": "Purchase 3",
    "datetime": "2026-09-30 12:54:27",
    "currency": "uzs",
    "updated_at": "2026-09-30 12:54:27",
    "created_at": "2026-09-30 12:54:27",
    "creator_id": 2,
    "id": 130,
    "purchase_price": 25003,
    "sale_price": 34106,
    "sale_price_uzs": 34106
}

Xato misoli · 422 ​

json
{
    "message": "Допустимые значения для Валюта: uzs, usd, rub.",
    "errors": {
        "currency": [
            "Допустимые значения для Валюта: uzs, usd, rub."
        ]
    }
}

Kirimni tahrirlash ​

PUT/company/trade/purchase/{model}

Kirim va uning qatorlarini yaratishdagi qoidalar bilan to‘liq qayta yozadi. Faqat waiting_for_confirmation holatida ruxsat etiladi; bo‘sh name avvalgi raqamni saqlaydi.

Formadan (multipart/form-data) PUT metodi POST + ?_method=PUT 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

So‘rov tanasi ​

MaydonTuriMajburiyTavsif
company_idintegerHaKompaniya. Foydalanuvchiga ochiq mavjud yozuv ID si
stock_idintegerHaOmbor. Foydalanuvchiga ochiq mavjud yozuv ID si
supplier_idintegerYo‘qYetkazib beruvchi. Foydalanuvchiga ochiq mavjud yozuv ID si
namestringYo‘qNomlanish. Maks. 255 belgi
datetimestring (date)Yo‘qSana va vaqt. Format Y-m-d H:i:s. Kamida joriy sana. Ko‘pi bilan joriy sana
currencystringHaValyuta. Mumkin qiymatlar: uzs, usd, eur, rub
productsobject[]HaMahsulotlar. Maks. 5000 ta element
products[].idintegerYo‘qID
products[].product_idintegerHaTovar. Takrorlanmasin
products[].purchase_pricenumberHaSotib olish narxi. Verguldan keyin 2 tagacha raqam. Kamida 0.01. 999999999999.99 dan oshmasin
products[].sale_pricenumberHaSotish narxi. Verguldan keyin 2 tagacha raqam. Kamida 0.01. 999999999999.99 dan oshmasin. products[].purchase_price dan katta yoki teng
products[].quantitynumberHaMiqdori. Verguldan keyin 4 tagacha raqam. Kamida 0.0001
is_last_stepbooleanYo‘qtrue bo‘lishi shart
json
{
    "company_id": 1,
    "stock_id": 1,
    "supplier_id": 1,
    "name": "Purchase 1",
    "datetime": "2026-09-30 12:54:31",
    "currency": "uzs",
    "products": [
        {
            "id": 1,
            "product_id": 1,
            "purchase_price": 1000,
            "sale_price": 1100,
            "quantity": 1
        },
        {
            "id": 2,
            "product_id": 2,
            "purchase_price": 2000,
            "sale_price": 2400,
            "quantity": 2
        }
    ],
    "is_last_step": 1
}
bash
curl -X PUT "https://api.wasyt.uz/company/trade/purchase/1" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"company_id":1,"stock_id":1,"supplier_id":1,"name":"Purchase 1","datetime":"2026-09-30 12:54:31","currency":"uzs","products":[{"id":1,"product_id":1,"purchase_price":1000,"sale_price":1100,"quantity":1},{"id":2,"product_id":2,"purchase_price":2000,"sale_price":2400,"quantity":2}],"is_last_step":1}'

Javob · 200 ​

Javob maydonlari
MaydonTuriTavsif
idintegerID
creator_idintegerYaratuvchi
company_idintegerKompaniya
stock_idintegerOmbor
supplier_idintegerYetkazib beruvchi
inventory_idnullInventarizatsiya
namestringNomlanish
datetimestringSana va vaqt
currencystringValyuta
statusstringStatus
purchase_priceintegerSotib olish narxi
sale_priceintegerSotish narxi
created_atstringYaratilgan
updated_atstringYangilangan
sale_price_uzsinteger
json
{
    "id": 1,
    "creator_id": 2,
    "company_id": 1,
    "stock_id": 1,
    "supplier_id": 1,
    "inventory_id": null,
    "name": "Purchase 1",
    "datetime": "2026-09-30 12:54:31",
    "currency": "uzs",
    "status": "waiting_for_confirmation",
    "purchase_price": 5000,
    "sale_price": 5900,
    "created_at": "2026-09-30 12:47:59",
    "updated_at": "2026-09-30 12:54:31",
    "sale_price_uzs": 5900
}