İçeriğe geç
KuryeSoft

Siparişler

Sipariş yaşam döngüsü

Bir sipariş gönderildiği andan teslim edilene ya da iptal edilene kadar dokuz durumdan birinde bulunur. Durum status alanındadır.
Sipariş durumları sırasıyla: Bekliyor, Kurye atandı, Kurye kabul etti, Kurye işletmede, Yolda, Adreste, Teslim edildi. Teslimden önce her aşamada iptal edilebilir; paket yoldayken teslim edilemedi olarak kapanabilir; kurye kaldırılırsa sipariş beklemeye döner.

Durumlar

pending
Anlamı:Bekliyor. Sipariş alındı, kurye aranıyor ya da atama bekliyor.
Zaman damgası · webhook:created_at · order.created, order.unassigned
assigned
Anlamı:Kurye atandı. Sipariş bir kuryeye verildi, kuryenin kabulü bekleniyor.
Zaman damgası · webhook:assigned_at · order.assigned
accepted
Anlamı:Kurye kabul etti. Kurye siparişi kabul etti, işletmeye gidiyor.
Zaman damgası · webhook:accepted_at · order.assigned, order.accepted
at_restaurant
Anlamı:Kurye işletmede. Kurye işletmeye vardı, paketi bekliyor.
Zaman damgası · webhook:arrived_restaurant_at · order.courier_arrived
picked_up
Anlamı:Yolda. Paket teslim alındı, kurye müşteriye gidiyor.
Zaman damgası · webhook:picked_up_at · order.picked_up
at_customer
Anlamı:Adreste. Kurye teslimat adresine vardı.
Zaman damgası · webhook:arrived_customer_at · order.at_customer
delivered
Anlamı:Teslim edildi. Sipariş müşteriye teslim edildi. Sonuç durumudur.
Zaman damgası · webhook:delivered_at · order.delivered
cancelled
Anlamı:İptal edildi. Sipariş iptal edildi; sebep cancel_reason alanındadır. Sonuç durumudur.
Zaman damgası · webhook:cancelled_at · order.cancelled
failed
Anlamı:Teslim edilemedi. Kurye siparişi teslim edemedi (müşteriye ulaşılamadı vb.); sebep cancel_reason alanındadır. Sonuç durumudur.
Zaman damgası · webhook:cancelled_at · order.failed

delivered, cancelled ve failed sonuç durumlarıdır; sipariş bunlardan birine geçtiğinde sorgulamayı bırakabilirsiniz. status_label her durumun Türkçe adını verir.

Geçişler

Atama

Kurye firması siparişi iki yoldan biriyle kuryeye verir:

  • Teklif: sistem uygun kuryelere süreli teklif gönderir; kabul eden kurye siparişi alır. Bu yolda sipariş pending durumundan doğrudan accepted durumuna geçer; tek webhook olayı order.assigned'dır (gövdedeki status değeri accepted).
  • Doğrudan atama: sistem ya da yönetici siparişi bir kuryeye verir (assigned, olay order.assigned); kurye uygulamada kabul edince accepted olur (olay order.accepted).
İpucu:

Bu yüzden olay adına değil, gövdedeki order.status değerine göre işlem yapın. Olay adı neyin olduğunu söyler; durum siparişin şu an nerede olduğunu.

Kurye değişimi ve kaldırılması

  • Kurye değiştirilirse yeni kurye için yeniden order.assigned gelir. Paket teslim alınmadan önce değişirse durum assigned ya da accepted olur; paket yoldayken değişirse durum korunur.
  • Kurye siparişten alınırsa (yalnızca paket teslim alınmadan önce) sipariş pending durumuna döner, olay order.unassigned gelir ve atama yeniden başlar.

İptal

Sipariş teslim edilene kadar iptal edilebilir. İşletme adına (bu API ile ya da işletme panelinden) iptal ise kurye firmasının ayarıyla sınırlıdır:

Kurye atanmadan önce
API ile iptal edilebilen durumlar:pending
Kurye atandıktan sonra
API ile iptal edilebilen durumlar:pending, assigned
Kurye kabul ettikten sonra (varsayılan)
API ile iptal edilebilen durumlar:pending, assigned, accepted
Kurye işletmeye vardıktan sonra
API ile iptal edilebilen durumlar:… ve at_restaurant
Paket yola çıktıktan sonra
API ile iptal edilebilen durumlar:… ve picked_up

Sınır aşıldığında iptal çağrısı 403 FORBIDDEN döner; iptal için kurye firmasıyla iletişime geçilmelidir. Firma, işletmenin iptal yetkisini tamamen de kapatabilir. Kurye firması ise her aşamada iptal edebilir; bu iptaller de size order.cancelled olarak gelir.

Teslim edilemedi

Kurye adrese ulaştığı halde teslim edemezse (müşteriye ulaşılamadı, adres bulunamadı vb.) sipariş failed olur. Sebep cancel_reason, zamanı cancelled_at alanındadır. Paketin işletmeye geri getirilmesi ve ücret, kurye firmasıyla aranızdaki kurallara bağlıdır.

Yönetici düzeltmeleri

Kurye uygulamayı kullanamadığında ya da yanlış işlem yaptığında yönetici durumu panelden elle değiştirebilir. Nadiren sonuçlanmış bir sipariş de düzeltme için yeniden açılabilir (ör. yanlışlıkla "teslim edildi" işaretlenmişse). Entegrasyonunuz durumu her zaman en son gelen bilgiye göre güncellemeli, sonuç durumunu kesin varsaymamalıdır.

İptal ve ücret

İptal edilen ya da teslim edilemeyen siparişin işletmeye ücretlendirilip ücretlendirilmeyeceğini kurye firması belirler (varsayılan: iptalde, paket teslim alındıysa ücret alınır; teslim edilemeyen siparişte ücret alınır). Bu bilgiler API yanıtında yer almaz; işletmenin cari hesabında görünür.