Sipariş Örneği
Gerçek Bir Sipariş Gönderimi (Payload)
Aşağıda, BK Yemek sisteminden POS entegrasyonuna gönderilen gerçek bir sipariş datası yer almaktadır.
JSON formatında iletilir ve https://bkyemek.com/api/v1/restoran_pos_giris endpoint’ine POST edilir.
{
"siparis_id": 308,
"restoran_id": 2,
"siparis_tutari": 450.0,
"odeme_tutari": 450.0,
"odeme_tipi": "Kapıda Kart ile Ödeme",
"adres_id": 77,
"musteri_adi": "Demo A.",
"musteri_telefon": "+90 55********",
"adres": "Yu*** Em** Cad. Kay*** Sok.",
"adres_aciklama": "Feyzullah mahallesi kar******* sok****** gir**** so***** ik**** b*** ",
"adres_ilce": "Maltepe",
"adres_mahalle": "Feyzullah Mah.",
"adres_latitude": 37.4219,
"adres_longitude": 29.1268,
"adres_bina": "Ef** ***",
"adres_kat": "7",
"adres_daire": "1*",
"restoran_adi": "Bur*** T***",
"restoran_telefon": "+90 54********",
"restoran_adres": "Feyzullah Mahallesi mu******** ka********* sok***** gi***** so***** ik**** bi****",
"restoran_il": "İstanbul",
"restoran_ilce": "Maltepe",
"restoran_enlem": 40.927604591,
"restoran_boylam": 29.1268372536,
"kurye_not": "Zile basmayın olur mu?",
"zile_basma": "Evet",
"kapida_birak": "Hayır",
"servis_getirme": "Evet",
"siparis_tarihi": "2025-07-19 12:33:50",
"siparis_durumu": "Restoran Onayı Bekliyor",
"kurye_tipi": "Restoran Getirsin",
"kurye_adi": "",
"kurye_telefon": "",
"siparis_icerikleri": [
{
"urun_adi": "Barbekü Burger",
"tercihler_adi": "120 gr",
"cikarilacaklar_adi": "Turşu, Soğan",
"urun_not": "Sıcak gelsin",
"adet": 1
}
]
}
Yanıt Beklentisi (Response)
Eğer sipariş verisi doğruysa POS sistemi şu şekilde bir HTTP 200 yanıtı döndürmelidir:
{
"success": true,
"message": "Sipariş alındı."
}
NOT: zile_basma, kapida_birak, servis_getirme alanları boolean değil string ("Evet" / "Hayır") olarak gönderilmektedir.
POS tarafı bunu karşılayacak şekilde kontrol etmelidir.
Sipariş Durumu Güncelleme Örnekleri
Aşağıdaki örneklerde BK sisteminin, POS tarafına /durum_guncelle endpoint’ine gönderdiği durumu bildiren JSON yapıları gösterilmektedir.
Gönderimler, https://bkyemek.com/api/v1/restoran_pos_giris/durum_guncelle adresine yapılır.
1. Siparişiniz Hazırlanıyor
{
"siparis_id": 308,
"yeni_durum": "Siparişiniz Hazırlanıyor"
}
2. Siparişiniz Kuryeye Teslim Edildi
{
"siparis_id": 308,
"yeni_durum": "Siparişiniz Kuryeye Teslim Edildi",
"kurye_teslim_tarihi": "2025-07-19 12:36:15"
}
3. Teslim Edildi
{
"siparis_id": 308,
"yeni_durum": "Teslim Edildi",
"teslim_tarihi": "2025-07-19 12:45:02"
}
4. İptal Edildi
{
"siparis_id": 309,
"yeni_durum": "İptal Edildi"
}
Yanıt Beklentisi
POS sistemi tüm bu güncellemelere aşağıdaki gibi yanıt vermelidir:
{
"success": true,
"message": "Sipariş durumu güncellendi."
}