BTS API Docs

Calculator

POST /v1/order-calculate/index

Ushbu bo‘lim orqali buyurtma uchun taxminiy yetkazib berish narxi va xizmat parametrlari hisoblanadi.

Bu endpoint buyurtma yaratmaydi — faqat kiritilgan ma’lumotlar asosida hisob-kitob qiladi. Hisoblashda jo‘natuvchi va qabul qiluvchi manzillari, yuk parametrlari hamda yetkazib berish usullari inobatga olinadi:

Buyurtmani topshirish turi (pickup_type):

self — mijoz buyurtmani o‘zi ofisga olib keladi
courier — kuryer buyurtmani mijoz qo‘lidan olib ketadi

Buyurtmani qabul qilish turi (dropoff_type):

courier — buyurtma kuryer orqali manzilga yetkaziladi
branch — buyurtma filialdan olib ketiladi

Javobdagi ma’lumotlar is_multiple qiymatiga bog‘liq bo‘ladi:

is_multiple = false — yagona hisob-kitob varianti qaytariladi
is_multiple = true — bir nechta yetkazib berish yoki tarif variantlari ro‘yxat ko‘rinishida qaytariladi

Ushbu endpoint faqat hisoblash uchun mo‘ljallangan va tizimda buyurtma yaratmaydi.

API Server


                    https://apitest.bts.uz:28345/

Base Path


                    /v1/order-calculate/index

Full URL


                        https://apitest.bts.uz:28345/v1/order-calculate/index

Authentication Bearer Token

Headers

Header

Value

Req.

Authorization

Bearer {token}

🔒

Content-Type

application/json

🔒

application/json

🔒

language

uz

🔒

{
    "senderCityCode": "1001",
    "receiverCityCode": "7001",
    "pickup_type": "branch",
    "dropoff_type": "branch",
    "is_multiple_cost": 1,
    "weight": 2,
    "volume": {
        "x": 10,
        "y": 10,
        "z": 10
    }
}

Field	Type	Description
`senderCityCode` *	string	Filial code
`receiverCityCode` *	string	Qabul qiluvchi filial code
`pickup_type` *	string	Yuborish turi, ENUM type ('courier', 'branch', 'self')
`dropoff_type` *	string	Qabul qilish turi, ENUM type ('courier', 'branch', 'self')
`is_multiple_cost`	integer	0-> faqat belgilangan yo'nalish bo'yicha 1ta qiymat qaytadi 1-> barcha narxlar chiqadi
`weight` *	float	Buyurtma o'g'irligi
`volume`	object	Volume ichida [x,y,z] larga qiymat berish kerak

RESPONSE

Example
Schema

HTTP 200

Response Body

{
    "status": true,
    "message": "success.retrieved",
    "status_code": 200,
    "data": {
        "branch_to_branch": {
            "available": true,
            "price": 76000,
            "reason": null
        },
        "branch_to_courier": {
            "available": true,
            "price": 83000
        },
        "courier_to_branch": {
            "available": true,
            "price": 108000
        },
        "courier_to_courier": {
            "available": true,
            "price": 138000
        }
    }
}

No schema defined.

Example
Schema

HTTP 422

Response Body

{
    "status": false,
    "message": "error.validation",
    "status_code": 422,
    "errors": {
        "senderCityCode": [
            "«Sender City Code» to`ldirish shart."
        ]
    }
}

No schema defined.