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

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.

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",
  "isTest": 1,
  "pickupType": "courier",
  "sender": {
    "name": "ACME MChJ Updated",
    "phone": "+998901112233",
    "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,
    "postTypeOther": null
  }
}

Field	Type	Description
`clientId`	string	Hamkorning ichki mijoz / buyurtma identifikatori
`isTest`	integer	Test buyurtma belgisi. 1 — test, 0 yoki yuborilmasa — oddiy buyurtma
`pickupType` *	enum	Buyurtmani topshirish turi. ENUM: {'courier', 'branch'} courier — kuryer mijoz qo'lidan oladi branch — mijoz o'zi filialga topshiradi
`senderDate`	string	Jo'natish sanasi. Format: Y-m-d. Yuborilmasa — bugungi sana
`receiverDate`	string	Yetkazib berish sanasi. Format: Y-m-d. Yuborilmasa — bugungi sana
`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 yangilandi.",
    "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 Updated",
            "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": "+998901112233"
        },
        "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