BTS API Docs

Buyurtmani tahrirlash

POST /v1/order/edit-international?orderId=<orderId>

Ushbu method orqali tizimdagi mavjud buyurtma ma’lumotlarini tahrirlash amalga oshiriladi.

Mijoz buyurtma identifikatori (order ID) orqali mavjud buyurtmani topadi va mahsulotlar, jo‘natuvchi yoki qabul qiluvchi ma’lumotlari hamda yetkazib berish parametrlarini yangilashi mumkin. Shuningdek, buyurtmaning topshirish va qabul qilish usullari ham o‘zgartirilishi mumkin:

Buyurtmani topshirish turi (pickupType):

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

Agar yuborilgan ma’lumotlar to‘g‘ri bo‘lsa, buyurtma muvaffaqiyatli yangilanadi va tizim yangilangan holatni qaytaradi.

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/edit-international?orderId=<orderId>

Full URL


                        https://apitest.bts.uz:28345/v1/order/edit-international?orderId=<orderId>

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 Updated",
    "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": 0,
    "piece": 1,
    "packageId": 4,
    "postTypeId": 1,
    "postTypeOther": null
  }
}

Field	Type	Description
`orderId` *	integer	Tahrirlanadigan buyurtma ID. Path: /v1/order/edit-international/{orderId}
`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 yangilandi.",
    "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 Updated",
            "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": "0.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	Waybill barcode
`data[clientId]`	string	Hamkor ichki identifikatori
`data[customer][id]`	integer	BTS mijoz 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)