BTS API Docs

Calculator

POST /v1/order-calculate/international

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 (pickupType):

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

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

* Yetkazib berish muddatlari Toshkent shahridan jo‘natiladigan yuklar uchun ish kunlarida ko‘rsatilgan bo‘lib, faqat poytaxt shaharlariga yetkazib berish uchun amal qiladi. Boshqa shaharlarga yetkazib berishda muddat yana 2–4 kunga uzayadi.

API Server


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

Base Path


                    /v1/order-calculate/international

Full URL


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

Authentication Bearer Token

Headers

Header

Value

Req.

Authorization

Bearer {access_token}

🔒

Content-Type

application/json

🔒

application/json

🔒

language

uz

🔒

{
  "weight": 1.5,
  "volume": 7500,
  "senderCityCode": "2502",
  "receiverCountryCode": "004",
  "receiverCityCode": "004011",
  "postTypeId": 1,
  "pickupType": "courier",
  "piece": 1
}

Field	Type	Description
`weight` *	float	Og‘irlik kg, min 0.01
`volume`	float	Hajm
`senderCityCode` *	string	Yuboruvchi shahar kodi. Katalogdagi «Shahar(tumanlar)» dagi code
`receiverCountryCode` *	string	Qabul qiluvchi mamlakat kodi. Katalogdagi «Davlatlar» dagi code
`receiverCityCode` *	string	Qabul qiluvchi shahar kodi. Katalogdagi «Xorijiy shaharlar» dagi code
`postTypeId` *	integer	Jo‘natma turi ID. Katalogdagi «Yuborish turlari» dagi id
`pickupType` *	enum	ENUM: {'self','courier'}
`piece`	integer	Joylar. Default: 1
`senderDate`	string	Y-m-d. Default: bugun

RESPONSE

Example
Schema

HTTP 200

Response Body

{
    "status": true,
    "message": "Ma’lumot muvaffaqiyatli olindi.",
    "status_code": 200,
    "data": {
        "summaryPrice": 100000,
        "estimatedDeliveryDate": {
            "min": "08.08.2026",
            "max": "10.08.2026"
        },
        "requestData": {
            "senderDate": "2026-07-29",
            "pickupType": "courier",
            "senderCityCode": "2502",
            "receiverCountryCode": "004",
            "receiverCityCode": "004011",
            "weight": 1.5,
            "volume": 7500,
            "postTypeId": 1,
            "piece": 1
        }
    }
}

Field	Type	Description
`status`	boolean	So'rov muvaffaqiyatli bajarilganligi (true/false)
`message`	string	Javob xabari
`status_code`	integer	HTTP status kodi
`data[summaryPrice]`	string	Hisoblangan narx
`data[requestData][senderDate]`	string	Hisob sanasi
`data[requestData][pickupType]`	enum	self \| courier
`data[requestData][senderCityCode]`	string	Yuboruvchi shahar kodi. Katalogdagi «Shahar(tumanlar)»
`data[requestData][receiverCountryCode]`	string	Mamlakat kodi. Katalogdagi «Davlatlar»
`data[requestData][receiverCityCode]`	string	Shahar kodi. Katalogdagi «Xorijiy shaharlar»
`data[requestData][weight]`	float	Og‘irlik
`data[requestData][volume]`	float	Hajm
`data[requestData][postTypeId]`	integer	postTypeId. Katalogdagi «Yuborish turlari»
`data[requestData][piece]`	integer	Joylar
`data[estimatedDeliveryDate][min]`	string	Yetkazib berishning taxminiy sanasi (dan)
`data[estimatedDeliveryDate][max]`	string	Yetkazib berishning taxminiy sanasi (gacha)