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

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.

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": "+998900000000",
    "address": "Toshkent, Chilonzor",
    "cityId": 195
  },
  "receiver": {
    "name": "John Doe",
    "phone": "+12025550123",
    "phone1": null,
    "countryId": 1,
    "cityId": 3627,
    "province": "California",
    "address": "1 Main Street, Apt 5",
    "postalCode": "90001"
  },
  "cargo": {
    "weight": 1.5,
    "volume": 0,
    "piece": 1,
    "packageId": 8,
    "postTypeId": 1
  }
}

Field	Type	Description
`clientId`	string	Hamkorning ichki mijoz / buyurtma identifikatori
`pickupType` *	enum	Buyurtmani topshirish turi. ENUM: {'courier', 'branch'} courier — kuryer mijoz qo'lidan oladi branch — mijoz o'zi filialga topshiradi
`sender[name]` *	string	Yuboruvchi F.I.O yoki tashkilot nomi (max 255)
`sender[phone]` *	string	Yuboruvchi telefon raqami. Format: +998901234567 (max 45)
`sender[address]` *	string	Yuboruvchi manzili. Ixtiyoriy: lat;long koordinata qo'shilishi mumkin
`sender[cityId]` *	integer	Yuboruvchi shahar ID (O'zbekiston City.id, kod emas)
`receiver[name]` *	string	Qabul qiluvchi F.I.O (max 150)
`receiver[phone]` *	string	Qabul qiluvchi telefon raqami
`receiver[phone1]`	string	Qabul qiluvchining qo'shimcha telefon raqami
`receiver[countryId]` *	integer	Qabul qiluvchi mamlakat ID (directory countries.id)
`receiver[cityId]` *	integer	Qabul qiluvchi shahar ID (CountryCity.id). receiver[countryId] ga tegishli bo'lishi shart
`receiver[province]` *	string	Qabul qiluvchi viloyat / shtat nomi
`receiver[address]` *	string	Qabul qiluvchining chet el to'liq manzili
`receiver[postalCode]` *	string	Qabul qiluvchi pochta indeksi
`cargo[weight]` *	float	Jo'natma og'irligi, kg. Min: 0.01
`cargo[volume]`	float	Jo'natma hajmi. Yuborilmasa — 0
`cargo[piece]`	integer	Jo'natmalar (joylar) soni. Yuborilmasa — 1
`cargo[packageId]` *	integer	Qadoq turi ID (Package.id)
`cargo[postTypeId]` *	integer	Jo'natma turi ID (PostType.id)
`cargo[postTypeOther]`	string	Boshqa jo'natma turi uchun izoh (max 255)

RESPONSE

Example
Schema

HTTP 200

Response Body

{
    "status": true,
    "message": "Muvaffaqiyatli yaratildi.",
    "status_code": 200,
    "data": {
        "orderId": 4295353,
        "barcode": "01994295353",
        "clientId": "1001",
        "customer": {
            "id": 939,
            "name": "Yusufjon Ismatov TEST"
        },
        "status": {
            "id": 1,
            "info": "У отправителя (У ОТПРАВИТЕЛЯ)"
        },
        "cost": "100000.00",
        "sender": {
            "senderReal": "ACME MChJ",
            "senderDelivery": 1,
            "senderDate": "2026-07-28",
            "region": {
                "id": 6,
                "name": "город Ташкент"
            },
            "city": {
                "id": 195,
                "name": "Учтепа тумани",
                "regionId": 6
            },
            "branch": {
                "id": 108,
                "name": "QUSHBEGI (SKLAD)"
            },
            "address": "Toshkent, Chilonzor",
            "phone": "+998900000000"
        },
        "receiver": {
            "name": "John Doe",
            "receiverPhone": "+12025550123",
            "receiverPhone1": null,
            "receiverDelivery": 1,
            "receiverDate": "2026-07-28",
            "country": {
                "id": 1,
                "name": "Amerika Qushma Shtatlari"
            },
            "city": {
                "id": 3627,
                "name": ""
            },
            "address": "1 Main Street, Apt 5",
            "province": "California",
            "postal_code": "90001"
        },
        "mail": {
            "weight": "1.500",
            "piece": 1,
            "volume": "0.000",
            "package": {
                "id": 8,
                "name": "BTS Пакет"
            },
            "postType": {
                "id": 1,
                "name": "ДРУГОЕ"
            },
            "postTypeOther": null
        }
    }
}

Field	Type	Description
`status`	boolean	So'rov muvaffaqiyatli bajarilganligi (true/false)
`message`	string	Javob xabari (masalan: Muvaffaqiyatli yaratildi.)
`status_code`	integer	HTTP status kodi
`data[orderId]`	integer	Yaratilgan buyurtma ID
`data[barcode]`	string	Buyurtma shtrix-kodi (waybill barcode)
`data[clientId]`	string	Hamkorning ichki mijoz / buyurtma identifikatori
`data[customer][id]`	integer	BTS mijoz (customer) ID
`data[customer][name]`	string	BTS mijoz nomi
`data[status][id]`	integer	Buyurtma status ID
`data[status][info]`	string	Buyurtma status matni (tilga moslashtirilgan, joylashuv qo'shilishi mumkin)
`data[cost]`	string	Hisoblangan yetkazib berish narxi (masalan: 100000.00)
`data[sender][senderReal]`	string	Yuboruvchi F.I.O / tashkilot nomi
`data[sender][senderDelivery]`	integer	Topshirish turi: 1 — courier, 0 — branch
`data[sender][senderDate]`	string	Jo'natish sanasi (Y-m-d)
`data[sender][region][id]`	integer	Yuboruvchi viloyat / shahar ID
`data[sender][region][name]`	string	Yuboruvchi viloyat / shahar nomi
`data[sender][city][id]`	integer	Yuboruvchi shahar (tuman) ID
`data[sender][city][name]`	string	Yuboruvchi shahar (tuman) nomi
`data[sender][city][regionId]`	integer	Yuboruvchi shaharning region ID si
`data[sender][branch][id]`	integer	Yuboruvchi filial ID (courier bo'lsa null bo'lishi mumkin)
`data[sender][branch][name]`	string	Yuboruvchi filial nomi
`data[sender][address]`	string	Yuboruvchi manzili
`data[sender][phone]`	string	Yuboruvchi telefon raqami
`data[receiver][name]`	string	Qabul qiluvchi F.I.O
`data[receiver][receiverPhone]`	string	Qabul qiluvchi telefon raqami
`data[receiver][receiverPhone1]`	string	Qabul qiluvchining qo'shimcha telefon raqami
`data[receiver][receiverDelivery]`	integer	Yetkazib berish turi kodi
`data[receiver][receiverDate]`	string	Yetkazib berish sanasi (Y-m-d)
`data[receiver][country][id]`	integer	Qabul qiluvchi mamlakat ID
`data[receiver][country][name]`	string	Qabul qiluvchi mamlakat nomi (tilga moslashtirilgan)
`data[receiver][city][id]`	integer	Qabul qiluvchi shahar ID (CountryCity.id)
`data[receiver][city][name]`	string	Qabul qiluvchi shahar nomi (tilga moslashtirilgan)
`data[receiver][address]`	string	Qabul qiluvchining chet el manzili
`data[receiver][province]`	string	Qabul qiluvchi viloyat / shtat
`data[receiver][postal_code]`	string	Qabul qiluvchi pochta indeksi
`data[mail][weight]`	string	Jo'natma og'irligi (kg)
`data[mail][piece]`	integer	Jo'natmalar (joylar) soni
`data[mail][volume]`	string	Jo'natma hajmi
`data[mail][package][id]`	integer	Qadoq turi ID
`data[mail][package][name]`	string	Qadoq turi nomi
`data[mail][postType][id]`	integer	Jo'natma turi ID
`data[mail][postType][name]`	string	Jo'natma turi nomi
`data[mail][postTypeOther]`	string	Boshqa jo'natma turi izohi