NAV undefined
undefined O'zbekcha English Русский
bash

Kirish

Api Url http://wms.bts.uz:8040

Version 1.0 End point http://wms.bts.uz:8040

Fulfillment WMS

Http request

POST /auth

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/auth/login" \
--header  "accept: "application/json"
--header  "Content-Type: "application/json"
--data '{
    "login": "login",
    "password": "password"
}'

SUCCESS:


  {
    "access_token": "string",
    "refresh_token": "string"
  }
Parameter Type Description
login string Foydalanuvchi nomini tuldrish shart
password string Parolni tuldirish shart

Yetkazib beruvchi xaridor

Http request

GET v1/purveyor/index

curl \
--request GET \
--url "http://wms.bts.uz:8040/v1/purveyor/index" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"

SUCCESS:


  {
    "message": "Data successfully retrieved.",
    "data": {
        "items": [
            {
                "id": 12,
                "group": "string",
                "code": "string",
                "name": "string",
                "full_name": "string",
                "name_eng": "string",
                "contractBankDetail": {
                    "id": 9,
                    "supplier_buyer_id": 12,
                    "contract_number": "string",
                    "contract_date": "2024-10-10",
                    "bank_details": "string",
                    "contact_info": "string",
                    "additional_details": "string",
                    "main_delivery_address": "string"
                },
                "entityType": {
                    "id": 9,
                    "stock_percentage": "20.00",
                    "stock_expiry": 0,
                    "supplier_buyer_id": 12,
                    "legal_entity": true
                },
                "supplierBuyerStatus": {
                    "id": 9,
                    "supplier_buyer_id": 12,
                    "is_supplier": true,
                    "is_buyer": true,
                    "depositor": true
                },
                "taxInfo": {
                    "id": 9,
                    "supplier_buyer_id": 12,
                    "inn": "string",
                    "kpp": "string",
                    "okpo": "string"
                },
                "_links": {
                    "self": {
                        "href": "http://wms.bts.uz:8040/v1/purveyor/view?id=12"
                    }
                }
            }
        ],
        "_links": {
            "self": "/v1/purveyor/index?page=1",
            "first": "/v1/purveyor/index?page=1",
            "last": "/v1/purveyor/index?page=1"
        },
        "_meta": {
            "totalCount": 11,
            "pageCount": 1,
            "currentPage": 1,
            "perPage": 20
        }
    }
}
Parameter Type Description
group string Mahsulot guruhi
code string Mahsulot kodi
name string Mahsulot nomi
full_name string Mahsulotning to'liq nomi
name_eng string Inglizcha nom (mahsulotning ingliz tilidagi nomi)
stock_percentage string Yaroqlilik zaxirasi foizi
stock_expiry string Yaroqlilik muddati
legal_entity boolean Yuridik/jismoniy shaxs (Да/Нет)
inn integer Soliq to'lovchining identifikatsiya raqami
kpp integer Kompaniya ro'yxatidan o'tgan kod
okpp integer Yetkazib beruvchi
is_buyer boolean Xaridor (Да/Нет)
main_delivery_address string Asosiy yetkazib berish manzili
depositor boolean Omborchi (mahsulot uchun javobgar omborchi)
contract_number integer Shartnoma raqami
contract_date string Shartnoma sanasi
bank_details string Bank rekvizitlari
contact_info string Aloqa ma'lumotlari
additional_details string Qo'shimcha rekvizitlar
is_supplier boolean Yetkazib beruvchi (Да/Нет)

Qabul qilinishi kerak bo'lgan tovarlar statusini yangilash

Http request

POST v1/purveyor/status

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/purveyor/status" \
--header  "Authorization\: "Bearer token"
--header  "accept\: "application/json"
--header  "Content-Type\: "application/json"
--data '{
    "status" => [
                  {"id": 1,"status": "ok"},
                  {"id": 2,"status": "ok"}
       ]
}'

SUCCESS:


{
  "message": "supplier-buyers successfully updated to delivered status"
}
Parameter Type Description
status array Bazangizga muvaffaqiyatli saqlangan purveyor IDlarini OK statusi bilan yuborishingiz kerak bo'ladi.

Mahsulot

Http request

GET v1/product/index

curl \
--request GET \
--url "http://wms.bts.uz:8040/v1/product/index" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"

SUCCESS:


  {
    "message": "Data successfully retrieved.",
    "data": {
        "items": [
            {
                "id": 39,
                "supplier_buyer_id": 5,
                "group": "stringcceee",
                "code": "stringcccee",
                "name": "stringcceee",
                "full_name": "string",
                "gtin": "112",
                "article": "string",
                "nomenclature_type": "11",
                "unit": "22",
                "comment": "string",
                "productPackagin": {
                    "id": 7,
                    "product_id": 39,
                    "base_packaging": "string",
                    "billing_packaging": "string",
                    "report_packaging": "string"
                },
                "productShelfLive": {
                    "id": 10,
                    "product_id": 39,
                    "shelf_life_stock": "22.00",
                    "min_shelf_life_stock": "0.00",
                    "shelf_life_deviation_days": 2,
                    "shelf_life_period": 2,
                    "min_shelf_life_period": 2,
                    "shelf_life_deviation_period": 2,
                    "storage_period_days": 2,
                    "specification": "string",
                    "temperature_mode": "string"
                },
                "productTechnical": {
                    "id": 18,
                    "product_id": 39,
                    "weight": "88.000",
                    "net_weight": "55.000",
                    "volume": "77.000",
                    "net_volume": "44.000",
                    "is_set": true,
                    "kis_code": "99",
                    "default_status": "string"
                },
                "_links": {
                    "self": {
                        "href": "http://wms.bts.uz:8040/v1/product/view?id=39"
                    }
                }
            }
        ],
        "_links": {
            "self": "/v1/product/index?page=1",
            "first": "/v1/product/index?page=1",
            "last": "/v1/product/index?page=1"
        },
        "_meta": {
            "totalCount": 3,
            "pageCount": 1,
            "currentPage": 1,
            "perPage": 20
        }
    }
}
Parameter Type Description
group string Mahsulot guruhi
code string Mahsulot kodi
name string Mahsulot nomi
full_name string Mahsulotning to'liq nomi
gtin integer GTIN (Global Trade Item Number - xalqaro savdo birligi raqami)
article string Mahsulot artikuli (artikul raqami)
nomenclature_type string Nomenklatura turi (mahsulotning turi)
shelf_life_stock integer Yaroqlilik zaxirasi (mahsulotning maksimal saqlash muddati)
abc_class string ABC sinfi (ABC tahlili bo'yicha mahsulot klassifikatsiyasi)
kis_code string KIS kodi (Kompyuter axborot tizimi kodi)
comment string Izoh (qo'shimcha izoh yoki sharh)
is_set boolean To'plam (komplektmi yoki yo'qmi) 1 yoki 0
weight integer Og'irlik (mahsulotning og'irligi)
net_weight integer Netto og'irlik (qadoqdagi sof og'irlik)
min_shelf_life_stock string Minimal yaroqlilik zaxirasi (qabul qilish paytidagi minimal saqlash muddati)
name_eng string Inglizcha nom (mahsulotning ingliz tilidagi nomi)
tsd_name string TSD nomi (terminal yoki skanerlarda ishlatiladigan nom)
volume integer Hajm (mahsulot hajmi)
net_volume integer Netto hajm (qadoqdagi sof hajm)
shelf_life_deviation_days string Yaroqlilik muddatining chetlashishi kunlarda (maximal og'ish)
min_shelf_life_period integer Minimal yaroqlilik zaxirasi muddati (qabul qilish paytidagi minimal yaroqlilik muddati)
shelf_life_deviation_period string Yaroqlilik muddatining chetlashishi davri (maksimal og'ish davri)
depositor string Omborchi (mahsulot uchun javobgar omborchi)
seasonal_abc_coefficient integer Mavsumiy ABC koeffitsienti (mavsumiy mahsulotlarning ABC tahlili bo'yicha koeffitsienti)
specification string Spetsifikatsiya (mahsulot tavsifi yoki texnik talablari)
storage_period_days string Saqlash muddati kunlarda (mahsulotning maksimal saqlash muddati)
default_status string Sukut bo'yicha status (mahsulotning boshlang'ich holati)
temperature_mode string Harorat rejimi (mahsulotni saqlash harorati)
base_packaging string Asosiy o'ram (mahsulotning asosiy qadoqlanishi)
billing_packaging string Billing uchun o'ram (billing jarayonida foydalaniladigan o'ram)
report_packaging string Hisobot uchun o'ram (hisobotlar uchun ishlatiladigan o'ram)
unit integer O'lchov birligi (masalan, kg, dona, litr)

Qabul qilinishi kerak bo'lgan mahsulotlar statusini yangilash

Http request

POST v1/product/status

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/product/status" \
--header  "Authorization\: "Bearer token"
--header  "accept\: "application/json"
--header  "Content-Type\: "application/json"
--data '{
    "status" => [
                  {"id": 1,"status": "ok"},
                  {"id": 2,"status": "ok"}
       ]
}'

SUCCESS:


{
  "message": "products successfully updated to delivered status"
}
Parameter Type Description
status array Bazangizga muvaffaqiyatli saqlangan product IDlarini OK statusi bilan yuborishingiz kerak bo'ladi.

Yetkazib beruvchi

Http request

GET v1/receiving-goods/index

curl \
--request GET \
--url "http://wms.bts.uz:8040/v1/receiving-goods/index" \
--header  "Authorization: "Bearer token"
--header  "accept: "application/json"
--header  "Content-Type: "application/json"

SUCCESS:


  {
    "message": "Data successfully retrieved.",
    "data": {
        "items": [
            {
                "id": 10,
                "number": "string",
                "date": "2024-11-11",
                "counterparty": "string",
                "arrival_date": "2024-11-11",
                "comment": "string",
                "vehicle_model": "string",
                "vehicle_number": "string",
                "driver_name": "string",
                "driver_document": "string",
                "contract_number": "string",
                "contract_date": "2024-11-11",
                "acceptance_gate": null,
                "nomenclature": "string",
                "quantity": 20,
                "price": "200.00",
                "total_amount": "2000.00",
                "supplierDetail": {
                    "id": 7,
                    "supplier_id": 10,
                    "kis_number": null,
                    "kis_date": "2024-11-11",
                    "accept_by_places": true,
                    "vehicle_type": null,
                    "vat_rate": "20.00",
                    "vat_amount": "30.00",
                    "price_includes_vat": true,
                    "discount_amount": "40.00",
                    "under_delivery_percent": "25.00",
                    "over_delivery_percent": "50.00"
                },
                "supplierPackage": {
                    "id": 1,
                    "supplier_id": 10,
                    "nomenclature_package": "string11",
                    "package_quantity": 0
                },
                "_links": {
                    "self": {
                        "href": "http://wms.bts.uz:8040/v1/receiving-goods/view?id=10"
                    }
                }
            }
        ],
        "_links": {
            "self": "/v1/receiving-goods/index?page=1",
            "first": "/v1/receiving-goods/index?page=1",
            "last": "/v1/receiving-goods/index?page=1"
        },
        "_meta": {
            "totalCount": 2,
            "pageCount": 1,
            "currentPage": 1,
            "perPage": 20
        }
    }
}
Parameter Type Description
number integer Yetkazib berish raqami
date string Yetkazib berish sanasi
counterparty string Kontragent (yukni yetkazib beruvchi tashkilot)
arrival_date string Yuk qabul qilingan sana
comment string Izoh (qo'shimcha izoh yoki sharh)
vehicle_model string Transport vositasining modeli
vehicle_number integer Transport vositasining davlat raqami
driver_name string Haydovchining to'liq ismi
driver_document string Haydovchiga tegishli hujjat (pasport, litsenziya va h.k.)
contract_number integer Shartnoma raqami
contract_date string Shartnoma sanasi
nomenclature string Nomenklatura (yukning turi yoki mahsulotlar ro‘yxati)
quantity integer Mahsulot miqdori
price integer Mahsulotning bir dona yoki birlik narxi
total_amount integer Jami summa (narx * miqdor)
kis_number integer KIS tizimidagi buyurtma raqami
kis_date string KIS tizimida buyurtma kiritilgan sana
accept_by_places boolean Yuk joylari bo‘yicha qabul qilish (true/false)
vehicle_type string Transport vositasi turi (masalan, yuk mashinasi, avtobus)
vat_rate integer QQS stavkasi (foizda)
vat_amount integer QQS summasi
price_includes_vat boolean Narxga QQS kiritilganmi (true/false)
discount_amount integer Chegirma summasi
under_delivery_percent integer Yetkazib berilmagan mahsulot foizi
over_delivery_percent integer Ortiqcha yetkazib berilgan mahsulot foizi
nomenclature_package string Nomenklatura qadoqlanishi turi
package_quantity integer Qadoqlar soni

Qabul qilinishi kerak bo'lgan tovarlar statusini yangilash

Http request

POST v1/receiving-goods/status

curl \
--request POST \
--url "http://wms.bts.uz:8040/v1/receiving-goods/status" \
--header  "Authorization\: "Bearer token"
--header  "accept\: "application/json"
--header  "Content-Type\: "application/json"
--data '{
    "status" => [
                  {"id": 1,"status": "ok"},
                  {"id": 2,"status": "ok"}
       ]
}'

SUCCESS:


{
  "message": "supplier successfully updated to delivered status"
}
Parameter Type Description
status array Bazangizga muvaffaqiyatli saqlangan receiving_goods IDlarini OK statusi bilan yuborishingiz kerak bo'ladi.

Xatoliklar

Xatolik kodi Ma'nosi
400 Bad Request -- Your request sucks
401 Unauthorized -- Your API key is wrong
403 Forbidden -- The kitten requested is hidden for administrators only
404 Not Found -- The specified kitten could not be found
405 Method Not Allowed -- You tried to access a kitten with an invalid method
406 Not Acceptable -- You requested a format that isn't json
410 Gone -- The kitten requested has been removed from our servers
429 Too Many Requests -- You're requesting too many kittens! Slow down!
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarially offline for maintanance. Please try again later.
bash