BTS Express

BTS Express bilan integratsiya buyurtma rasmiylashtirishda O‘zbekiston bo‘ylab yetkazib berish narxini hisoblaydi, BTS da jo‘natma yaratadi, yorliqlarni chop etadi va posilka yo‘lda bo‘lgan paytda buyurtmani holatlar bo‘yicha o‘zi o‘tkazadi.

Bu sahifa nima uchun kerak#

• BTS akkauntini API login va paroli orqali ulash.
• Jo‘natuvchini ko‘rsatish: ism, telefon, manzil, viloyat va shahar.
• Posilka BTS ga qanday topshirilishi va xaridor uni qanday olishini tanlash.
• Buyurtma holati bo‘yicha jo‘natmalarni avtomatik yaratishni sozlash.
• Holatlar darhol kelishi uchun webhookni ro‘yxatdan o‘tkazish.
• Barcha BTS jo‘natmalarini ko‘rish, yorliqlarni chop etish va xatolarni topish.

Qayerdan topish mumkin#

• O‘rnatish, sozlash va o‘chirish — Dasturlar → BTS Express. O‘rnatilgandan so‘ng sozlamalar shakli shu sahifaning o‘zida, dastur kartochkasi ostida paydo bo‘ladi, sarlavhada esa Jo‘natmalar va O‘chirish tugmalari chiqadi. Yetkazib berish usullari → Xizmatni ulash → BTS bandi ham shu sahifaga olib boradi.
• BTS jo‘natmalari — alohida menyu bandi yo‘q. Sahifa do‘koningiz admin panelidagi /shipping/bts-delivery/shipments manzilida ochiladi. Undagi BTS sozlamalari tugmasi sozlamalari bor dastur sahifasiga qaytaradi.
• Buyurtma bo‘yicha jo‘natma — buyurtma kartochkasidagi BTS Express bloki.

Kim ko‘radi#

• Dasturni o‘rnatish, sozlash va o‘chirish hamda jo‘natmalar ro‘yxatini ochish «Управлять интеграциями доставки» (Yetkazib berish integratsiyalarini boshqarish) huquqi bor xodimlarga ruxsat etilgan. Dastur sahifasining o‘zi Dasturlar bo‘limida joylashgan, shuning uchun «Управлять приложениями и интеграциями» (Dasturlar va integratsiyalarni boshqarish) huquqi ham kerak. Bu huquqsiz Xizmatni ulash menyusida BTS bandi ham, dastur sahifasida tugmalar ham bo‘lmaydi. Rollar tahririda huquqlar rus tilida ko‘rsatiladi.
• Buyurtma kartochkasidagi BTS Express bloki integratsiya yoqilgan bo‘lsa, xodimda «Изменить заказ» (Buyurtmani o‘zgartirish) va «Управлять интеграциями доставки» huquqlari bo‘lsa va buyurtma olib ketish uchun bo‘lmasa ko‘rinadi.
• Jo‘natmalar ro‘yxatidagi Holatni yangilash va Bekor qilish tugmalari uchun «Изменить заказ» huquqi ham kerak.

Integratsiya barcha tariflarda mavjud.

Sahifa bilan tanishuv#

1. Ulanish — Muhit (Test (apitest.bts.uz) yoki Ishchi), Login, Parol va Ulanishni tekshirish tugmasi.
2. Jo‘natuvchi — Ism yoki nomi, Telefon, Manzil, Viloyat, Shahar / tuman va Jo‘natma BTS ga qanday topshiriladi. BTS ma’lumotnomalarini yuklash tugmasi viloyatlar, shaharlar, filiallar, qadoqlar va jo‘natma turlarini yuklaydi.
3. Jo‘natma parametrlari — Xaridorga standart yetkazish, Standart qadoq, Standart jo‘natma turi, Qabul qilishda jo‘natmani suratga olish va Imzolangan yuk xatini qaytarish belgilari, Buyurtma to‘lov usuli aniqlanmasa maydoni va Ombor kodi (wcs_code).
4. Jo‘natmalarni avtomatik yaratish — buyurtma qaysi holatga o‘tganda jo‘natma o‘zi yaratiladi.
5. Holatlar haqida bildirishnomalar — Webhook manzili va Webhookni ro‘yxatdan o‘tkazish tugmasi.
6. Integratsiya holati — Integratsiya faol belgisi.

Qanday bajariladi#

BTS Express’ni ulash#

1. BTS dan API login va parolini oling — ular shartnoma tuzilganda beriladi.
2. Dasturlar → BTS Express ni oching, O‘rnatish tugmasini bosing va tasdiqlang. O‘rnatish oynasida hech narsa to‘ldirish shart emas — undan so‘ng shu sahifada BTS sozlamalari shakli paydo bo‘ladi.
3. Muhit ni tanlang, Login va Parol ni kiriting. Ulanishni tekshirish tugmasini bosing.
4. BTS ma’lumotnomalarini yuklash tugmasini bosing.
5. Jo‘natuvchi blokini to‘ldiring: ism, telefon, manzil, so‘ng Viloyat va Shahar / tuman ni tanlang.
6. Jo‘natma BTS ga qanday topshiriladi da variantlardan birini tanlang: BTS kuryeri bizdan olib ketadi, Istalgan filialga o‘zimiz olib boramiz yoki Tanlangan filialga topshiramiz. Oxirgisi uchun BTS filiali ni tanlang.
7. Jo‘natma parametrlari ni tekshiring va Jo‘natmalarni avtomatik yaratish blokida holatni tanlang.
8. Integratsiya faol ni belgilang va Saqlash tugmasini bosing. Ungacha xizmat o‘rnatilgan, lekin ishlamaydi.
9. Holatlar haqida bildirishnomalar blokida Webhookni ro‘yxatdan o‘tkazish tugmasini bosing.
10. Yetkazib berish usullari sahifasida Tashqi xizmat turidagi, BTS Express xizmatli usul qo‘shing — usiz mijoz buyurtma rasmiylashtirishda BTS ni ko‘rmaydi.

BTS Express’ni o‘chirish#

1. Dasturlar → BTS Express ni oching va O‘chirish tugmasini bosing.
2. O‘chirishni tasdiqlang.

Ulanish sozlamalari o‘chiriladi, BTS buyurtma rasmiylashtirishda taklif qilinmaydi. Hozir yo‘ldagi jo‘natmalar endi yangilanmaydi — bunday buyurtmalarning holatini qo‘lda o‘zgartiring. Jo‘natmalar tarixi saqlanadi. BTS kabinetidagi webhook manzili yaroqsiz bo‘ladi: qayta o‘rnatganda webhookni yana ro‘yxatdan o‘tkazing.

Buyurtmani BTS orqali avtomatik jo‘natish#

Mijoz BTS orqali yetkazib berishni tanlagan bo‘lsa, buyurtmani Buyurtma quyidagi holatga o‘tganda BTS da jo‘natma yaratish da ko‘rsatilgan holatga o‘tkazing (sukut bo‘yicha «Yig‘ilgan»). Jo‘natma o‘zi yaratiladi, BTS Express blokida shtrix-kod va holat paydo bo‘ladi.

«Yangi» holati tanlangan bo‘lsa, onlayn to‘lovli buyurtma (Payme, Click va h.k.) BTS ga darhol emas, faqat to‘lov tasdiqlangandan keyin yuboriladi — to‘lanmagan buyurtma jo‘natilmaydi. Qabul qilinganda to‘lanadigan buyurtmalar darhol yuboriladi.

Jo‘natmani qo‘lda yaratish#

Shu yo‘l bilan BTS usulidagi buyurtmalarnigina emas, yetkazib beriladigan istalgan buyurtmani BTS orqali jo‘natish mumkin.

1. Buyurtma kartochkasini oching va BTS Express blokida Jo‘natma yaratish tugmasini bosing.
2. Xaridorga yetkazish, Og‘irlik, kg, Joylar soni, Qadoq va Jo‘natma turi ni tekshiring. Og‘irlik buyurtmadagi mahsulotlar bo‘yicha to‘ldiriladi.
3. Buyurtma manzilida koordinatalar bo‘lmasa, xaridorning Viloyat va Shahar / tuman ini tanlang. Tanlangan shahar koordinatalardan ustun turadi: manzil koordinatalari noaniq bo‘lsa ham uni ko‘rsating. Filialga yetkazish uchun BTS filiali ni tanlang.
4. To‘rtta variantning narxini ko‘rish uchun Hisoblash tugmasini bosing: do‘kon tomonidan filial yoki kuryer va xaridor tomonidan filial yoki eshikkacha kuryer. Sizning variantingiz belgilab qo‘yiladi.
5. Jo‘natma yaratish tugmasini bosing.

Yorliqni chop etish#

• Bitta buyurtma uchun: BTS Express blokida Yorliqni chop etish yoki Katta yo‘l varaqasi tugmasini bosing. Yorliq yangi oynada ochiladi, blokda esa Yorliqni ochish tugmasi paydo bo‘ladi.
• Bir nechta buyurtma uchun: BTS jo‘natmalari sahifasida qatorlarni belgilang va Yorliqlarni chop etish tugmasini bosing. Bir martada — 100 tadan ko‘p bo‘lmagan jo‘natma.

Jo‘natmani bekor qilish yoki qaytarishni rasmiylashtirish#

1. BTS Express blokida Bekor qilish tugmasini bosing va tasdiqlang. Tugma faqat posilka jo‘natuvchida turgan paytda ishlaydi.
2. Posilka allaqachon BTS da bo‘lsa, Qaytarishni rasmiylashtirish tugmasini bosing, Qaytarish sababi ni tanlang, kerak bo‘lsa Izoh yozing va Qaytarishni rasmiylashtirish tugmasini bosing.

Jo‘natmani topish#

1. /shipping/bts-delivery/shipments ni oching.
2. Jo‘natmani buyurtma raqami yoki shtrix-kod bo‘yicha toping yoki ro‘yxatni BTS holati va yaratilgan sana bo‘yicha filtrlang. Holat filtrida BTS tasdiqlashini kutmoqda va Xatoli variantlari ham bor.

Bu qanday ishlaydi#

• Savatdagi narx. BTS Express usuli uchun do‘kon mijoz manziliga eng yaqin BTS filialini topadi va shu filial tumanini oladi. BTS sizning shahringizdan eshikkacha kuryer orqali yetkazish narxini posilka BTS ga qanday topshirilishini hisobga olib hisoblaydi. Og‘irlik — mahsulotlar og‘irliklari yig‘indisi, keyin jo‘natmaga ham aynan shu og‘irlik yuboriladi; mahsulot og‘irligi ko‘rsatilmagan bo‘lsa, 0,5 kg olinadi. Manzilda koordinatalar bo‘lmasa, eng yaqin filial 60 km dan uzoq bo‘lsa yoki BTS rad etsa, usul mijozga taklif qilinmaydi.
• Jo‘natma qachon yaratiladi. Avtomatik — BTS yetkazib berish usulidagi buyurtma tanlangan holatga o‘tganda va integratsiya faol bo‘lsa. Variantlar: «Yangi», «Qabul qilingan», «Ishlov berilmoqda», «Yig‘ilgan» yoki Avtomatik yaratmaslik (faqat buyurtmadan qo‘lda). «Yangi» holatida onlayn to‘lovli buyurtma to‘lov tasdiqlanishini kutadi. Buyurtmada amaldagi jo‘natma bo‘lsa, ikkinchisi yaratilmaydi.
• BTS ga nima yuboriladi. Sozlamalardagi jo‘natuvchi; xaridorning ismi, telefoni va manzili; siz tanlagan shahar, u tanlanmagan bo‘lsa — manzil koordinatalari; buyurtmadagi mahsulotlar alohida pozitsiyalar sifatida; og‘irlik, qadoq va jo‘natma turi.
• Qabul qilinganda to‘lov. Buyurtma naqd yoki qabul qilishda karta bilan to‘lanadigan bo‘lsa va hali to‘lanmagan bo‘lsa, BTS kuryeri buyurtmaning yetkazib berish bilan birga to‘liq summasini oladi. Onlayn to‘langan buyurtmalar qabul qilinganda to‘lovsiz jo‘natiladi. Buyurtma to‘lov usuli aniqlanmasa, Buyurtma to‘lov usuli aniqlanmasa sozlamasi qo‘llanadi.
• Buyurtma holatlari o‘zi o‘zgaradi. BTS holatlari nomlari faqat rus tilida ko‘rsatiladi, shuning uchun ular quyida qavs ichida tarjimasi bilan berilgan:

Buyurtma oldingi holatga qaytmaydi va allaqachon bekor qilingan bo‘lsa, unga tegilmaydi. Har bir o‘zgarish buyurtma tarixiga «через BTS Express» (BTS Express orqali) belgisi bilan yoziladi, bildirishnomalar yoqilgan bo‘lsa, mijoz buyurtma holati haqida odatiy xabarni oladi.

• Holatlarni yangilash. Webhook ro‘yxatdan o‘tgan bo‘lsa, BTS o‘zgarishlarni o‘zi yuboradi. Bundan tashqari, do‘kon soatiga ikki marta 30 daqiqadan ko‘proq yangilik bo‘lmagan jo‘natmalarni tekshiradi. Jo‘natma yaratilganidan keyin 30 kun ichida yakunlanmasa, u bo‘yicha avtomatik tekshiruv to‘xtaydi — holatlar tarixida bu haqda yozuv paydo bo‘ladi. Holatni yangilash tugmasi holatni darhol so‘raydi.
• Do‘konda buyurtmani bekor qilish. Buyurtmani bekor qilsangiz va posilka hali jo‘natuvchida bo‘lsa, BTS dagi jo‘natma o‘zi bekor qilinadi. BTS posilkani allaqachon olib ketgan bo‘lsa, BTS Express blokida xato paydo bo‘ladi — qaytarishni rasmiylashtiring.
• Parol saqlashda BTS ga kirish orqali tekshiriladi. Saqlangandan keyin u ko‘rsatilmaydi; bo‘sh maydon «saqlanganini qoldirish» degani.

Cheklovlar va muhim jihatlar#

• BTS jo‘natmani faqat «У отправителя» (jo‘natuvchida) holatida bekor qiladi. Undan keyin — faqat qaytarish.
• Buyurtma manzilida koordinatalar bo‘lmasa, mijozda telefon bo‘lmasa yoki Xaridorga standart yetkazish da BTS filialiga tanlangan bo‘lsa, jo‘natma avtomatik yaratilmaydi: xaridor filiali faqat qo‘lda tanlanadi. Bunday hollarda BTS Express bloki «Yuborilmagan» holatida qoladi, sababi esa buyurtma tarixida paydo bo‘ladi — jo‘natmani buyurtma kartochkasidan yarating.
• Savatdagi narx sukut bo‘yicha filialga yetkazish tanlangan bo‘lsa ham doim eshikkacha kuryer uchun hisoblanadi.
• Bekor qilingandan yoki saqlash muddati tugagandan keyin Yangi jo‘natma yaratish tugmasini bosish mumkin.
• Jo‘natma yozib qo‘yilgan, lekin BTS uni tasdiqlamagan bo‘lsa («BTS tasdiqlashini kutmoqda» holati), Jo‘natma yaratish ni yana bosing — do‘kon avval u BTS da yaratilgan-yaratilmaganini tekshiradi. Bir sutka davomida do‘kon bunday jo‘natmalarni soatiga ikki marta BTS da o‘zi qidiradi va topilganlarini ulaydi.
• Platformada BTS ishchi API manzili sozlanmagan bo‘lsa, Ishchi muhit mavjud emas. Unda faqat test muhiti ishlaydi.
• Login yoki muhit o‘zgartirilsa, webhookni qayta ro‘yxatdan o‘tkazish kerak.

Ko‘p beriladigan savollar#

Saqlashda «BTS login yoki parolni qabul qilmadi» chiqyapti. Nimani tekshirish kerak? Login va parol bo‘shliqlarsiz nusxalanganini va bu juftlik tanlangan Muhit uchun berilganini: test ma’lumotlari ishchi muhitga mos kelmaydi va aksincha.

Nega savatda BTS orqali yetkazib berish yo‘q? Integratsiya faol belgilanganini va Yetkazib berish usullari sahifasida BTS Express xizmatli yoqilgan usul borligini tekshiring. Mijoz manzilida koordinatalar, yaqin atrofda esa BTS filiali bo‘lishi kerak.

Webhookni ro‘yxatdan o‘tkazish shartmi? Usiz ham holatlar yangilanadi — avtomatik tekshiruv orqali taxminan har 30 daqiqada. Webhook bilan buyurtma «Yetkazib berilmoqda» va «Yetkazib berildi» holatlariga deyarli darhol o‘tadi.

Viloyat va shaharlar ro‘yxatidagi «Saqlangan kod» nimani bildiradi? BTS ma’lumotnomalari yuklanmagan yoki ularda bu kod endi yo‘q. BTS ma’lumotnomalarini yuklash tugmasini bosing va qiymatni qaytadan tanlang.

Bog‘liq maqolalar#

• Yetkazib berish usullari
• Buyurtma kartochkasi
• Buyurtma bildirishnomalari
• Yandex Delivery