Siparişler
Sipariş yaşam döngüsü
status alanındadır.Durumlar
pendingcreated_at · order.created, order.unassignedassignedassigned_at · order.assignedacceptedaccepted_at · order.assigned, order.acceptedat_restaurantarrived_restaurant_at · order.courier_arrivedpicked_uppicked_up_at · order.picked_upat_customerarrived_customer_at · order.at_customerdelivereddelivered_at · order.deliveredcancelledcancel_reason alanındadır. Sonuç durumudur.cancelled_at · order.cancelledfailedcancel_reason alanındadır. Sonuç durumudur.cancelled_at · order.faileddelivered, 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ş
pendingdurumundan doğrudanaccepteddurumuna geçer; tek webhook olayıorder.assigned'dır (gövdedekistatusdeğeriaccepted). - Doğrudan atama: sistem ya da yönetici siparişi bir kuryeye verir (
assigned, olayorder.assigned); kurye uygulamada kabul edinceacceptedolur (olayorder.accepted).
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.assignedgelir. Paket teslim alınmadan önce değişirse durumassignedya daacceptedolur; paket yoldayken değişirse durum korunur. - Kurye siparişten alınırsa (yalnızca paket teslim alınmadan önce) sipariş
pendingdurumuna döner, olayorder.unassignedgelir 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:
pendingpending, assignedpending, assigned, acceptedat_restaurantpicked_upSı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.