Söyle Gelir Geliştiriciler

Sipariş durumları

Durumlar

status Anlamı Açık mı
placed Sipariş verildi, işletmenin onayını bekliyor Evet
accepted İşletme onayladı Evet
preparing Hazırlanıyor Evet
ready Hazır: teslimatta kurye, gel alda müşteri bekleniyor; restoranda servis edilecek Evet
picked_up Kurye teslim aldı, yolda Evet
delivered Teslim edildi (gel alda müşteriye verildi, restoranda servis edildi) Hayır
rejected İşletme reddetti Hayır
cancelled İptal edildi (müşteri, işletme ya da "müşteri gelmedi") Hayır
delivery_failed Teslim edilemedi Hayır
placed ──► accepted ──► preparing ──► ready ──► picked_up ──► delivered
  │                                                  └──────► delivery_failed
  ├──► rejected
  └──► cancelled   (placed, accepted, preparing ya da ready iken)

Gel alda ready → delivered (hand_over); restoranda accepted / preparing / ready → delivered (serve). Hangi API'nin hangi geçişi yapabildiği İşletme ve POS API ve Kurye API sayfalarındadır.

Kim ne yapabilir

Geçiş İşletme / POS Kurye firması Müşteri
Onayla, reddet Evet — —
Hazırlanıyor, hazır Evet — —
Teslim alındı, teslim edildi, teslim edilemedi Evet Yalnız kendisine gelen siparişte —
İptal Yola çıkmadan önce — Yalnız işletme onaylamadan önce
Gel al teslim, masaya servis, müşteri gelmedi Evet — —

Sipariş türleri

fulfilment Anlamı Kurye
delivery Adrese teslimat Var: işletmenin kuryesi, anlaşmalı kurye firması ya da bağlı kurye firması
pickup Gel al: müşteri işletmeden alır Yok
dine_in Restoranda: masada (at_table) ya da "geliyorum" (arriving, geliş saatiyle) Yok

"Müşteri gelmedi" (no_show) gel alda sipariş hazır olduktan, restoranda "geliyorum" siparişinde geliş saatinden sonra platformun bekleme süresi dolunca işaretlenebilir.

Ödeme

payment_method Anlamı Kuryenin tahsil edeceği
cash Kapıda nakit Sipariş toplamı (total)
card Kapıda kart (POS cihazıyla) Sipariş toplamı (total)
online Siparişte kartla ödendi Yok

Kurye API'sindeki payment.amount_to_collect kuryenin kapıda alacağı tutarı doğrudan verir.

Teslim kodu

Her teslimat siparişinin dört haneli bir teslim kodu vardır. Kod müşteriye yalnız sipariş yoldayken (picked_up) gösterilir; kurye teslimde kodu müşteriden alır. Kurye API'sinde deliver adımı bu kod olmadan yapılamaz. Sipariş başına yanlış deneme sınırlıdır; sınır aşılınca kod bir süre kilitlenir.

Taşıyıcı

Teslimat siparişinin aynı anda tek bir taşıyıcısı olur:

  • Sistem kuryesi: işletmenin kendi kuryesi ya da anlaşmalı kurye firmasının Söyle Gelir'e kayıtlı kuryesi. Siparişte courier alanı dolar.
  • Bağlı kurye firması: işletmenin entegre ettiği kurye firması. Sipariş işletme onaylayınca firmaya geçer; siparişte delivery_partner alanı dolar.

İşletme kendi kuryesini atarsa sipariş kurye firmasından geri alınır; firma da siparişi teslim almadan işletmeye geri verebilir.