BTS API Docs

Buyurtma yaratish

POST /v1/order/add-international

Ushbu method orqali tizimda yangi buyurtma yaratiladi.

Buyurtma yaratishda mijoz mahsulot ma’lumotlarini, jo‘natuvchi va qabul qiluvchi ma’lumotlarini hamda yetkazib berish parametrlarini yuboradi. Shuningdek, buyurtmaning qanday topshirilishi va qanday qabul qilinishi ko‘rsatiladi:

Buyurtmani topshirish turi (pickupType):

self — mijoz buyurtmani o‘zi ofis (filial) ga olib kelib topshiradi
courier — kuryer buyurtmani mijoz qo‘lidan olib ketadi

Agar barcha ma’lumotlar to‘g‘ri bo‘lsa, buyurtma muvaffaqiyatli yaratiladi va unga maxsus buyurtma raqami biriktiriladi. Ushbu raqam orqali buyurtma holatini kuzatish mumkin.

Agar majburiy maydonlar to‘ldirilmagan yoki noto‘g‘ri qiymatlar yuborilgan bo‘lsa, tizim xatolik sababini ko‘rsatgan holda javob qaytaradi.

* 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/add-international

Full URL


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

Authentication Bearer Token

Headers

Header

Value

Req.

Authorization

Bearer {access_token}

🔒

Content-Type

application/json

🔒

application/json

🔒

language

uz

🔒

{
  "clientId": "1001",
  "pickupType": "courier",
  "sender": {
    "name": "ACME MChJ",
    "phone": "+998901112233",
    "address": "Toshkent, Chilonzor",
    "cityCode": "2502"
  },
  "receiver": {
    "name": "John Doe",
    "phone": "+12025550123",
    "phone1": null,
    "countryCode": "004",
    "cityCode": "004011",
    "province": "California",
    "address": "1 Main Street, Apt 5",
    "postalCode": "90001"
  },
  "cargo": {
    "weight": 1.5,
    "volume": 8850,
    "piece": 1,
    "packageId": 4,
    "postTypeId": 1,
    "postTypeOther": null
  }
}

Field	Type	Description
`clientId`	string	Hamkor ichki identifikatori
`pickupType` *	enum	Topshirish turi. ENUM: {'courier','self'}
`sender[name]` *	string	Yuboruvchi F.I.O / tashkilot (max 255)
`sender[phone]` *	string	Yuboruvchi telefon (+998…, max 45)
`sender[address]` *	string	Yuboruvchi manzili
`sender[cityCode]` *	string	Yuboruvchi UZ shahar kodi. Katalogdagi «Shahar(tumanlar)» dagi code
`receiver[name]` *	string	Qabul qiluvchi F.I.O (max 150)
`receiver[phone]` *	string	Qabul qiluvchi telefon
`receiver[phone1]`	string	Qo‘shimcha telefon
`receiver[countryCode]` *	string	Mamlakat kodi. Katalogdagi «Davlatlar» dagi code
`receiver[cityCode]` *	string	Chet el shahar kodi. Katalogdagi «Xorijiy shaharlar» dagi code
`receiver[province]` *	string	Viloyat / shtat
`receiver[address]` *	string	Chet el to‘liq manzil
`receiver[postalCode]` *	string	Pochta indeksi
`cargo[weight]` *	float	Og‘irlik kg, min 0.01
`cargo[volume]`	float	Hajm. Default: 0
`cargo[piece]`	integer	Joylar soni. Default: 1
`cargo[packageId]` *	integer	Qadoq turi ID. Katalogdagi «Qadoqlash turlari» dagi id
`cargo[postTypeId]` *	integer	Jo‘natma turi ID. Katalogdagi «Yuborish turlari» dagi id
`cargo[postTypeOther]`	string	Boshqa jo‘natma turi izohi

RESPONSE

Example
Schema

HTTP 200

Response Body

{
    "status": true,
    "message": "Muvaffaqiyatli yaratildi.",
    "status_code": 200,
    "data": {
        "orderId": 4295379,
        "barcode": "25994295379",
        "clientId": "1001",
        "customer": {
            "id": 939,
            "name": "Yusufjon Ismatov TEST"
        },
        "status": {
            "code": 100,
            "info": "Yuboruvchida (У ОТПРАВИТЕЛЯ)"
        },
        "cost": "100000.00",
        "createdAt": "2026-07-29 10:02:57",
        "senderDate": "2026-07-29",
        "receiverDate": "2026-07-29",
        "pickupType": "courier",
        "tracking": "",
        "sender": {
            "name": "ACME MChJ",
            "region": {
                "code": "25",
                "name": "Джизакская область"
            },
            "city": {
                "code": "2502",
                "name": "Арнасой туман"
            },
            "branch": {
                "id": 458,
                "name": "ARNASOY"
            },
            "address": "Toshkent, Chilonzor",
            "phone": "+998901112233"
        },
        "receiver": {
            "name": "John Doe",
            "phone": "+12025550123",
            "phone1": null,
            "country": {
                "code": "004",
                "name": "Albaniya"
            },
            "city": {
                "code": "004011",
                "name": "Berat County"
            },
            "address": "1 Main Street, Apt 5",
            "province": "California",
            "postalCode": "90001"
        },
        "cargo": {
            "weight": "1.500",
            "piece": 1,
            "volume": "8850.000",
            "package": {
                "id": 4,
                "name": "СУМКА"
            },
            "postType": {
                "id": 1,
                "name": "ДРУГОЕ"
            },
            "postTypeOther": null
        },
        "estimatedDeliveryDate": {
            "min": "08.08.2026",
            "max": "10.08.2026"
        }
    }
}

Field	Type	Description
`status`	boolean	So'rov muvaffaqiyatli bajarilganligi (true/false)
`message`	string	Javob xabari
`status_code`	integer	HTTP status kodi
`data[orderId]`	integer	Buyurtma ID
`data[barcode]`	string	Jo'natma shtrix-kodi
`data[clientId]`	string	Hamkor ichki identifikatori
`data[customer][id]`	integer	BTS customer ID
`data[customer][name]`	string	BTS mijoz nomi
`data[status][code]`	integer	Status kodi
`data[status][info]`	string	Status matni (lokalizatsiya + joylashuv)
`data[cost]`	string	Yetkazib berish narxi
`data[createdAt]`	string	Yaratilgan vaqt (Y-m-d H:i:s)
`data[senderDate]`	string	Jo‘natish sanasi (Y-m-d)
`data[receiverDate]`	string	Yetkazib berish sanasi (Y-m-d)
`data[pickupType]`	enum	Topshirish turi: courier \| self
`data[tracking]`	string	Tracking URL
`data[sender][name]`	string	Yuboruvchi nomi
`data[sender][region][code]`	string	Yuboruvchi viloyat kodi. Katalogdagi «Viloyatlar»
`data[sender][region][name]`	string	Yuboruvchi viloyat nomi
`data[sender][city][code]`	string	Yuboruvchi shahar kodi. Katalogdagi «Shahar(tumanlar)» dagi code
`data[sender][city][name]`	string	Yuboruvchi shahar nomi
`data[sender][branch][id]`	integer	Filial ID
`data[sender][branch][name]`	string	Filial nomi
`data[sender][address]`	string	Yuboruvchi manzili
`data[sender][phone]`	string	Yuboruvchi telefoni
`data[receiver][name]`	string	Qabul qiluvchi nomi
`data[receiver][phone]`	string	Qabul qiluvchi telefoni
`data[receiver][phone1]`	string	Qo‘shimcha telefon
`data[receiver][country][code]`	string	Mamlakat kodi. Katalogdagi «Davlatlar» dagi code
`data[receiver][country][name]`	string	Mamlakat nomi
`data[receiver][city][code]`	string	Chet el shahar kodi. Katalogdagi «Xorijiy shaharlar» dagi code
`data[receiver][city][name]`	string	Chet el shahar nomi
`data[receiver][address]`	string	Chet el manzil
`data[receiver][province]`	string	Viloyat / shtat
`data[receiver][postalCode]`	string	Pochta indeksi
`data[cargo][weight]`	float	Og‘irlik (kg)
`data[cargo][piece]`	integer	Joylar soni
`data[cargo][volume]`	float	Hajm
`data[cargo][package][id]`	integer	Qadoq turi ID. Katalogdagi «Qadoqlash turlari»
`data[cargo][package][name]`	string	Qadoq turi nomi. Katalogdagi «Qadoqlash turlari»
`data[cargo][postType][id]`	integer	Jo‘natma turi ID. Katalogdagi «Yuborish turlari»
`data[cargo][postType][name]`	string	Jo‘natma turi nomi. Katalogdagi «Yuborish turlari»
`data[cargo][postTypeOther]`	string	Boshqa jo‘natma turi izohi
`data[estimatedDeliveryDate][min]`	string	Yetkazib berishning taxminiy sanasi (dan)
`data[estimatedDeliveryDate][max]`	string	Yetkazib berishning taxminiy sanasi (gacha)