Buyurtmalar

1. Umumiy

Barcha so'rovlar {BASE_URL}/api/v2/orders/... manziliga yuboriladi. Bazaviy URL va token Starex tomonidan beriladi.

Authorization: Bearer {TOKEN}
Content-Type: application/json
Accept: application/json
Accept-Language: uz

Metodlar ro'yxati:

2. Yetkazish turi

service maydoni jo'natma qayerga yetkazilishini belgilaydi va boshqa qaysi maydonlar majburiy bo'lishini aniqlaydi.

Tuman va filial ID'lari Ma'lumotnomalar bo'limidagi API'lardan olinadi.

3. Narxni hisoblash

Jo'natma yaratishdan oldin yetkazish narxini hisoblab olish uchun.

POST {BASE_URL}/api/v2/orders/calculate

So'rov parametrlari

So'rov namunasi

POST {BASE_URL}/api/v2/orders/calculate
Authorization: Bearer {TOKEN}
Content-Type: application/json

{
  "sender_district_id": 12,
  "sender_address": "Amir Temur ko'chasi, 1",
  "receiver_district_id": 45,
  "receiver_address": "Mustaqillik ko'chasi, 20",
  "weight": 1.5,
  "service": 1
}

Javob (200)

{
  "success": true,
  "data": {
    "price": 4500000,
    "from_town": { "code": 3922, "name": "TASHKENT" },
    "to_town": { "code": 3969, "name": "SAMARKAND" },
    "mass": 1.5,
    "service": { "code": 1, "name": "Kuryerlik yetkazish" }
  }
}

4. Buyurtma yaratish

Yangi jo'natma yaratadi va shtrix-kod (barcode) qaytaradi.

POST {BASE_URL}/api/v2/orders/create

So'rov parametrlari

^* Texnik jihatdan bo'sh qoldirish mumkin, lekin bu holda jo'natma manzilsiz ketadi — doim 1 yoki 2 yuboring.

^** receiver_person yoki receiver_company dan kamida bittasi bo'lishi shart.

So'rov namunasi (uyigacha)

POST {BASE_URL}/api/v2/orders/create
Authorization: Bearer {TOKEN}
Content-Type: application/json

{
  "sender_district_id": 12,
  "sender_person": "Ali Valiyev",
  "sender_phone": "998901234567",
  "sender_address": "Amir Temur ko'chasi, 1",
  "receiver_district_id": 45,
  "receiver_person": "Vali Aliyev",
  "receiver_phone": "998907654321",
  "receiver_address": "Mustaqillik ko'chasi, 20",
  "weight": 1.5,
  "service": 1
}

So'rov namunasi (PVZgacha)

{
  "sender_district_id": 12,
  "sender_person": "Ali Valiyev",
  "sender_phone": "998901234567",
  "receiver_branch_id": 7,
  "receiver_person": "Vali Aliyev",
  "receiver_phone": "998907654321",
  "weight": 1.5,
  "service": 2
}

Javob (200)

{
  "success": true,
  "data": {
    "order_code": "AB123456789UZ",
    "price": 4500000,
    "api_response": {
      "orderNo": "123456",
      "barcode": "AB123456789UZ",
      "error": 0,
      "errorMessage": null,
      "errorMessageRu": null,
      "orderPrice": 45000
    }
  }
}

Xatolik bilan qaytgan javob namunasi:

{
  "success": true,
  "data": {
    "order_code": null,
    "price": null,
    "api_response": {
      "orderNo": null,
      "barcode": null,
      "error": 1,
      "errorMessage": "Wrong town code",
      "errorMessageRu": "Неверный код города",
      "orderPrice": null
    }
  }
}

5. Jo'natma holatlari

Bitta jo'natma bo'yicha holatlar tarixini shtrix-kod orqali qaytaradi.

GET {BASE_URL}/api/v2/orders/trace

GET {BASE_URL}/api/v2/orders/trace?barcode=AB123456789UZ
Authorization: Bearer {TOKEN}
Accept: application/json

Javob (200)

{
  "success": true,
  "data": {
    "barcode": "AB123456789UZ",
    "date": "2026-06-10 09:00:00",
    "weight": 1.5,
    "recipient": "Vali Aliyev",
    "trace": [
      { "code": 1, "name": "Новый",     "advanced": "NEW",      "statetime": "2026-06-10 09:00:00", "branch": "Toshkent markaziy ombori", "description": "Buyurtma qabul qilindi" },
      { "code": 9, "name": "Доставлен", "advanced": "COMPLETE", "statetime": "2026-06-15 14:30:00", "branch": "Samarqand filiali",        "description": "Qabul qiluvchiga topshirildi" }
    ]
  }
}

Shtrix-kod topilmasa:

{
  "success": false,
  "error": {
    "code": -404,
    "message": "Ma'lumot topilmadi"
  }
}

6. Holat kodlari

Jo'natmaning har bir holati raqamli code bilan belgilanadi. Bu kodlar bir xil ma'noda uchta joyda ishlatiladi:

• Jo'natma holatlari javobidagi trace[].code;
• Webhook ichidagi state;
• Holatlar ma'lumotnomasidagi code.

Kodlarning ma'nosini olish uchun ma'lumotnoma so'rovi:

GET {BASE_URL}/api/v2/dictionaries/states

{
  "success": true,
  "data": [
    { "code": 0, "name": "Ожидает синхронизации", "advanced": "AWAITING_SYNC" },
    { "code": 1, "name": "Новый",                  "advanced": "NEW" },
    { "code": 9, "name": "Доставлен",              "advanced": "COMPLETE" }
  ]
}

7. Xatoliklar

Xatolik bo'lganda javobda success = false bo'ladi va error obyekti qaytadi:

{
  "success": false,
  "error": {
    "code": -2006,
    "message": "Tuman tanlanishi shart"
  }
}