Sifarişin icrası

Regionlara icra olunan sifariş sizə Sadarak hubunda təhvil verilir və müştərinin qapısında bitir. Bu səhifə sizin payınıza düşən hissədir: sifarişi harada təhvil alırsınız, hansı hadisələri bildirirsiniz və sifariş vəziyyət maşını sizdən hansı keçidləri qəbul edir.

Sifarişi harada təhvil alırsınız

Kuryerlər malları taxçalardan huba gətirir, hub hər sətri qəbula skan edir və sifarişi bağlamalara yığır — hər birinin ES-1042-P1 formasında kodu olur. Yalnız bundan sonra yükləyəcək bir şey olur.

lifecycle

RUNNER_PICKUP → AT_HUB → PACKED → EN_ROUTE → DELIVERED

Hubda təhvil aldığınız sifariş PACKED statusundadır. AT_HUB isə qəbul edilib, amma hələ qablaşdırılmayıb: bağlamalar hələ yoxdur, ona görə maşına qoyulacaq heç nə yoxdur.

Təyinat qablaşdırmadan əvvəl də ola bilər

Operator sifarişi açarınıza bu statuslarda təhvil verə bilər: AT_HUB, PACKED. Buna görə order.assigned_to_partner vebhuku hub hələ qablaşdırarkən sizə çata bilər — bunu xəbərdarlıq sayın və maşın göndərməzdən əvvəl sifarişin qablaşdırılmasını gözləyin.

Bildirdiyiniz hadisələr

logistics:write scope-u ilə POST /v1/partner/orders/:code/events. Hər type dəqiq bir keçidə uyğun gəlir; keçid PARTNER aktoru ilə edilir və partnyor adınızla qeyd olunur:

Bildirdiyiniz hadisələr
type	Mənası
`PICKED_UP`	Bağlamalar hubdakı təhvil skanı ilə maşına yükləndi. Sifariş SCANNED_TO_VAN olur.
`EN_ROUTE`	Bağlamalar müştəriyə yola düşdü. Öz maşınınıza yükləyirsinizsə, bunu birbaşa PACKED statusundan bildirin.
`DELIVERED`	Müştəriyə təhvil verildi. Nağd ödənişli sifarişdə codCollectedQepik göndərin — qəpiklə tam ədəd, yəni 4750 = 47.50 ₼.
`FAILED`	Çatdırılma baş tutmadı. Təkrar cəhd edənə və ya geri qaytarana qədər sifariş sizdə qalır.

Qəbul etdiyimiz keçidlər

Partnyor açarından API-nin qəbul etdiyi bütün from → to cütləri, bildiriş sırası ilə:

transitions

PICKED_UP  PACKED         → SCANNED_TO_VAN
EN_ROUTE   PACKED         → EN_ROUTE        (yalnız partnyor)
EN_ROUTE   SCANNED_TO_VAN → EN_ROUTE
DELIVERED  EN_ROUTE       → DELIVERED
FAILED     EN_ROUTE       → FAILED

PACKED → EN_ROUTE yalnız sizindir. Regionlara icra olunan sifariş hubdan sizin öz maşınınızla çıxır, ona görə heç vaxt SCANNED_TO_VAN-dan keçmir — bu status bağlamaların Turanyol mikroavtobusuna skan edildiyini bildirir və o darvaza bizimdir. Platformada başqa heç bir aktor bu keçidi edə bilməz.

Nə vaxt rədd edirik

Yuxarıdakı cədvəldən kənar hər şey rədd edilir və sifariş öz statusunda qalır — mümkün olmayan keçid heç vaxt sifarişi pozmur.

ERR_INVALID_TRANSITION

Sifariş vəziyyət maşını cari statusdan bu keçidi rədd edir.

ERR_PARTNER_ORDER_NOT_ASSIGNED

Sifariş sizin partnyor hesabınıza təyin olunmayıb.

ERR_API_KEY_SCOPE

Açar etibarlıdır, lakin bu endpointin tələb etdiyi scope-u daşımır.

Tam xəta kataloquna baxın

Çatdırılmanı bildirmək

Sifariş kodu bağlama etiketindəki koddur (ES-1042), sifariş id-si deyil.

bash

curl -sS -X POST "https://api.turanyol.com/v1/partner/orders/ES-1042/events" \
  -H "X-Api-Key: $ESADARAK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"DELIVERED","codCollectedQepik":4750}'