documentation
Calculator

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

  • 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.

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
🔒
Accept
application/json
🔒
language
uz
🔒

REQUEST

{
  "weight": 1.5,
  "senderCityId": 195,
  "receiverCountryId": 1,
  "receiverCityId": 3627,
  "postTypeId": 1,
  "pickupType": "courier",
  "piece": 1,
  "isCompany": 0
}
Field Type Description
weight * float Jo'natma og'irligi, kg. Min: 0.01
volume float Jo'natma hajmi
senderCityId * integer Yuboruvchi shahar ID (O'zbekiston City.id)
receiverCountryId * integer Qabul qiluvchi mamlakat ID (countries.id)
receiverCityId * integer Qabul qiluvchi shahar ID (CountryCity.id)
postTypeId * integer Jo'natma turi ID (PostType.id)
pickupType * enum Topshirish turi. ENUM: {'self', 'courier'} self — mijoz o'zi ofisga olib keladi courier — kuryer mijoz qo'lidan oladi
receiverDelivery integer Yetkazib berish turi: 0 / 1 / 2
piece integer Joylar soni. Yuborilmasa — 1
senderDate string Jo'natish sanasi. Format: Y-m-d. Yuborilmasa — bugungi sana
isCompany integer 1 bo'lsa mijoz (customer) narxnomasidan hisoblanadi. Default: 0
customerId integer Mijoz ID. isCompany=1 da ishlatiladi; bo'sh bo'lsa JWT dagi customer olinadi

RESPONSE

HTTP 200
Response Body
{
    "status": true,
    "message": "Ma’lumot muvaffaqiyatli olindi.",
    "status_code": 200,
    "data": {
        "summaryPrice": 100000,
        "requestData": {
            "senderDate": "2026-07-28",
            "pickupType": "courier",
            "senderCityId": 195,
            "receiverCountryId": 1,
            "receiverCityId": 3627,
            "receiverDelivery": null,
            "weight": 1.5,
            "volume": null,
            "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 tarif narxi (masalan: 150000.00)
data[requestData][senderDate] string Hisobda ishlatilgan jo'natish sanasi (Y-m-d)
data[requestData][pickupType] enum Hisobda ishlatilgan topshirish turi: self | courier
data[requestData][senderCityId] integer Hisobda ishlatilgan yuboruvchi shahar ID
data[requestData][receiverCountryId] integer Hisobda ishlatilgan qabul qiluvchi mamlakat ID
data[requestData][receiverCityId] integer Hisobda ishlatilgan qabul qiluvchi shahar ID
data[requestData][receiverDelivery] integer Hisobda ishlatilgan yetkazib berish turi (yuborilmasa null)
data[requestData][weight] float Hisobda ishlatilgan og'irlik (kg)
data[requestData][volume] float Hisobda ishlatilgan hajm (yuborilmasa null)
data[requestData][postTypeId] integer Hisobda ishlatilgan jo'natma turi ID
data[requestData][piece] integer Hisobda ishlatilgan joylar soni