Getir Yemek ile çalışan restoran ve kafelerin sipariş akışını otomatikleştirmek için API entegrasyonu kritik bir adımdır. Siparişlerin manuel girilmesi hem zaman kaybına hem de hatalı hazırlamaya yol açar; entegre sistemler bu riski ortadan kaldırır ve mutfağa doğru bilgiyi anında iletir. Bu rehber, Getir Yemek API'sinin nasıl çalıştığını, hangi verileri taşıdığını ve işletmenizde hangi adımlarla devreye alınacağını açıklar.
Getir Yemek API'si ne işe yarar
Getir Yemek API'si, müşterinin uygulamada verdiği siparişi doğrudan restoran yönetim yazılımına aktarır. Sipariş içeriği (ürünler, ekstra malzemeler, özel notlar), müşteri adresi, ödeme yöntemi ve teslimat tipi (kurye veya gel-al) tek bir veri paketi halinde gelir. Yazılım bu paketi ayrıştırır, mutfak ekranına veya yazıcıya gönderir ve hazırlık sürecini başlatır. Manuel adisyon girişi olmadığı için garson veya kasa personeli siparişle uğraşmaz; ekip yalnızca hazırlamaya odaklanır.
API aynı zamanda restorandan Getir Yemek'e geri bildirim gönderir: sipariş onayı, hazırlık süresi tahmini, stok tükenmesi veya iptal bildirimi bu kanaldan iletilir. Müşteri uygulamada siparişinin hangi aşamada olduğunu canlı olarak görür; bu şeffaflık şikâyet oranını düşürür. Entegre sistemlerde kurye çağrısı da otomatik tetiklenebilir; sipariş hazır olduğunda yazılım Getir Yemek'e sinyal gönderir ve kurye yola çıkar.
API entegrasyonunun teknik yapısı
Getir Yemek, restoran yazılımlarına REST tabanlı bir API sunar. Sipariş verileri JSON formatında gelir ve yazılımın bu veriyi ayrıştırıp kendi veri tabanına yazması beklenir. Entegrasyon için Getir Yemek'ten bir API anahtarı (token) alınır; bu anahtar her istekte kimlik doğrulama için kullanılır. Yazılım, belirli aralıklarla Getir Yemek sunucusunu sorgular (polling) veya Getir Yemek yeni siparişi doğrudan yazılımın webhook adresine gönderir (push). Webhook yöntemi daha hızlıdır; sipariş anında yazılıma düşer.
Veri akışı şu şekilde ilerler: müşteri Getir Yemek uygulamasında siparişi tamamlar, ödeme onaylanır ve sipariş Getir Yemek sunucusuna kaydedilir. Sunucu, yazılımın webhook URL'sine POST isteği gönderir; istek içinde sipariş numarası, ürün listesi, fiyat, adres ve teslimat tipi bulunur. Yazılım bu isteği alır, sipariş kaydını oluşturur ve Getir Yemek'e HTTP 200 yanıtı döner. Yanıt dönmezse Getir Yemek birkaç kez daha deneme yapar; bu nedenle yazılımın webhook endpoint'i kararlı ve hızlı çalışmalıdır.
Veri alanları ve eşleştirme
API'den gelen sipariş verisi, yazılımın kendi ürün kodlarıyla eşleştirilmelidir. Getir Yemek'te her ürünün benzersiz bir ID'si vardır; yazılım bu ID'yi kendi menü veritabanındaki ürün ile ilişkilendirir. Eşleştirme kurulumu sırasında yapılır: Getir Yemek menüsündeki "Tavuk Burger" yazılımda "TAVUK-001" koduyla tanımlıysa, bu ilişki bir eşleştirme tablosunda saklanır. Sipariş geldiğinde yazılım ID'ye bakar, karşılık gelen ürünü bulur ve adisyona ekler. Eşleştirme hatalıysa sipariş yanlış ürünle hazırlanır veya hiç hazırlanamaz; bu nedenle kurulum sonrası test siparişleriyle tüm menü kontrol edilmelidir.
Ekstra malzemeler (örneğin "ekstra peynir", "soğansız") de aynı mantıkla eşleştirilir. Getir Yemek'te seçenek grupları (modifier groups) ve seçenekler (modifiers) vardır; yazılım bu yapıyı kendi reçete veya not sistemine aktarır. Bazı yazılımlar ekstraları ayrı satır kalemi olarak adisyona ekler, bazıları ürün notuna yazar. Hangi yöntem kullanılırsa kullanılsın, mutfak ekranında veya fişte ekstra açıkça görünmelidir.
Kurulum ve devreye alma süreci
Getir Yemek API entegrasyonu için öncelikle Getir Yemek İşletme Ortağı Portalı'ndan API erişimi talep edilir. Portal üzerinden restoran bilgileri ve menü yüklenir; menü onaylandıktan sonra API anahtarı oluşturulur. Yazılım sağlayıcısı bu anahtarı alır ve kendi sistemine tanımlar. Estorix gibi bulut tabanlı sistemlerde bu adım uzaktan yapılır; işletme sahibinin teknik bilgiye ihtiyacı yoktur. Kurulum genellikle on dakika içinde tamamlanır; ardından test siparişleri verilir.
Test aşamasında şu kontroller yapılır: sipariş yazılıma düşüyor mu, ürün isimleri doğru mu, fiyatlar eşleşiyor mu, ekstra malzemeler görünüyor mu, müşteri adresi ve telefon numarası okunuyor mu, ödeme yöntemi (kredi kartı veya kapıda ödeme) doğru işaretleniyor mu. Her test siparişi sonrası mutfak fişi veya ekran çıktısı kontrol edilir. Hata varsa eşleştirme tablosu düzeltilir ve test tekrarlanır. Tüm menü kalemleri test edildikten sonra entegrasyon canlıya alınır.
| Kurulum Aşaması | Sorumlu | Tahmini Süre |
|---|---|---|
| Getir Yemek portalında menü yükleme ve onay | İşletme / Getir Yemek | 1-3 gün |
| API anahtarı alma ve yazılıma tanımlama | Yazılım sağlayıcısı | 10-15 dakika |
| Ürün ve ekstra eşleştirme | Yazılım sağlayıcısı | 20-30 dakika |
| Test siparişleri ve kontrol | İşletme + yazılım sağlayıcısı | 30-60 dakika |
| Canlıya geçiş ve ilk gün izleme | İşletme | 1 gün |
Sipariş durumu güncellemeleri
Entegre sistemlerde restoran, siparişin durumunu Getir Yemek'e geri bildirir. Sipariş yazılıma düştüğünde "onaylandı" sinyali gönderilir; müşteri uygulamada "Restoranınız siparişinizi hazırlıyor" mesajını görür. Hazırlık tamamlandığında "hazır" durumu iletilir ve kurye çağrısı tetiklenir. İptal veya stok tükenmesi durumunda "iptal edildi" sinyali ve iptal nedeni gönderilir; müşteriye anında bildirim gider ve ödeme iade edilir.
Durum güncellemeleri müşteri deneyimini doğrudan etkiler. Güncelleme gönderilmezse müşteri siparişin durumunu bilemez ve çağrı merkezini arar; bu hem Getir Yemek'in hem restoranın iş yükünü artırır. Yazılım, durum değişikliklerini otomatik olarak API'ye iletmelidir; manuel güncelleme gerektiren sistemler operasyonel hata riski taşır. Paket servis programı kullanan işletmeler, tüm pazaryeri siparişlerini tek ekrandan yönetir ve durum güncellemelerini merkezi olarak gönderir.
Menü senkronizasyonu ve fiyat yönetimi
Getir Yemek menüsü, restoran yazılımındaki menü ile senkronize tutulmalıdır. Ürün ismi, açıklaması, fiyatı veya stok durumu değiştiğinde her iki tarafta da güncelleme yapılır. Bazı yazılımlar menü senkronizasyonunu API üzerinden otomatik yapar; ürün yazılımda pasife alındığında Getir Yemek'te de otomatik olarak stokta yok işaretlenir. Otomatik senkronizasyon yoksa işletme sahibi her değişikliği hem yazılımda hem Getir Yemek portalında manuel olarak yapmalıdır; bu iş yükü arttıkça tutarsızlık riski artar.
Fiyat farklılaştırması yapan işletmeler dikkatli olmalıdır. Getir Yemek'te uygulanan fiyat, yazılımdaki fiyattan farklıysa adisyon tutarı ile tahsilat uyuşmaz. Komisyon hesabı da karışır; Getir Yemek komisyonu müşteriye gösterilen fiyat üzerinden kesilir. Fiyat tutarlılığını sağlamak için yazılımın Getir Yemek fiyatını otomatik çekmesi veya işletmenin her iki tarafta da aynı fiyatı girmesi gerekir. Entegrasyonlar sayfasında diğer pazaryerleri ile birlikte merkezi fiyat yönetimi seçenekleri bulunur.
Sık yapılan hatalar
En yaygın hata, ürün eşleştirmesinin eksik veya yanlış yapılmasıdır. Menüde yeni bir ürün eklendiğinde yazılımda eşleştirme güncellenmezse sipariş yazılıma düşmez veya "bilinmeyen ürün" olarak işaretlenir. Mutfak bu siparişi göremez ve müşteri siparişini alamaz. Eşleştirme kontrolü, menü her değiştiğinde tekrarlanmalıdır.
İkinci yaygın hata, webhook endpoint'inin düşmesi veya yavaş yanıt vermesidir. Yazılım sunucusu çökerse veya ağ bağlantısı kesilirse Getir Yemek siparişi gönderemez; sipariş kaybolur veya geç ulaşır. Yazılım sağlayıcısı, webhook endpoint'ini izlemeli ve kesinti durumunda alarm kurmalıdır. Bulut tabanlı sistemler bu açıdan daha güvenlidir; Estorix gibi platformlar yüksek erişilebilirlik sunar ve kesinti riski düşüktür.
Üçüncü hata, durum güncellemelerinin gönderilmemesidir. Sipariş hazır olduğunda "hazır" sinyali gönderilmezse kurye geç çağrılır ve teslimat gecikir. Müşteri memnuniyetsizliği artar ve restoran puanı düşer. Yazılım, sipariş durumu değiştiğinde otomatik güncelleme göndermeli; manuel işlem gerektirmemelidir.
Dördüncü hata, test siparişlerinin atlanmasıdır. Entegrasyon canlıya alınmadan önce tüm menü kalemleri, ekstra seçenekleri ve özel durumlar (örneğin "soğansız", "az acılı") test edilmelidir. Test atlanırsa ilk gerçek siparişte hata ortaya çıkar; müşteri olumsuz deneyim yaşar ve restoran itibar kaybeder.
Performans ve izleme
Entegre sistemlerde sipariş akışı sürekli izlenmelidir. Yazılım, gelen sipariş sayısını, ortalama işleme süresini ve hata oranını raporlamalıdır. Sipariş düşme süresi (Getir Yemek'ten yazılıma ulaşma süresi) birkaç saniye olmalıdır; gecikme varsa ağ veya sunucu sorunu araştırılır. Hata oranı (başarısız webhook çağrıları, eşleşmeyen ürünler) izlenir ve sıfıra indirilmeye çalışılır.
Yoğun saatlerde API trafiği artar; yazılım bu yükü kaldırabilmelidir. Cuma ve cumartesi akşamları dakikada onlarca sipariş gelebilir; yazılım her siparişi anında işlemeli ve mutfağa iletmelidir. Gecikme olursa mutfak siparişleri sırayla göremez ve hazırlık karışır. Restoran raporlama modülü, sipariş akışını saatlik ve günlük olarak analiz eder; darboğazlar tespit edilir ve kapasite planlaması yapılır.
Çoklu pazaryeri yönetimi
Getir Yemek ile birlikte Yemeksepeti, Trendyol Yemek ve Migros Yemek kullanan işletmeler, tüm siparişleri tek bir yazılımda toplamalıdır. Her pazaryerinin ayrı tablet veya bilgisayardan takip edilmesi operasyonel karmaşa yaratır; siparişler atlanır, hazırlık süreleri karışır ve mutfak verimsiz çalışır. Entegre sistemler, tüm pazaryerlerinden gelen siparişleri tek ekranda gösterir; mutfak hangi siparişin hangi kanaldan geldiğini bilmeden sırayla hazırlar.
Merkezi yönetim aynı zamanda stok senkronizasyonunu kolaylaştırır. Bir ürün tükendiğinde yazılım tüm pazaryerlerinde otomatik olarak stokta yok işaretler; her kanalda ayrı güncelleme yapmaya gerek kalmaz. Fiyat ve menü değişiklikleri de merkezi olarak yapılır ve tüm kanallara dağıtılır. Getir Yemek entegrasyonu sayfasında bu süreçlerin detayları bulunur.
Sık sorulan sorular
Getir Yemek API entegrasyonu için teknik bilgi gerekir mi?
Hayır, işletme sahibinin teknik bilgiye ihtiyacı yoktur. Yazılım sağlayıcısı entegrasyonu kurar, ürün eşleştirmesini yapar ve test siparişlerini kontrol eder. İşletme yalnızca Getir Yemek portalında menüyü onaylar ve API anahtarını yazılım sağlayıcısına iletir. Kurulum sonrası sistem otomatik çalışır.
Sipariş yazılıma düşmezse ne yapmalıyım?
Önce internet bağlantısını ve yazılımın çalışır durumda olduğunu kontrol edin. Sorun devam ederse yazılım sağlayıcısının destek hattını arayın; webhook endpoint'i veya API anahtarı kontrol edilir. Getir Yemek siparişi birkaç kez deneme yaptığı için kısa süreli kesintilerde sipariş kaybolmaz, ancak uzun kesintilerde manuel giriş gerekebilir.
Menü değişikliklerini nasıl senkronize ederim?
Yazılımınız otomatik menü senkronizasyonu destekliyorsa değişiklik yazılımda yapılır ve Getir Yemek'e otomatik aktarılır. Desteklemiyorsa hem yazılımda hem Getir Yemek portalında manuel güncelleme yapmanız gerekir. Otomatik senkronizasyon iş yükünü azaltır ve tutarsızlık riskini ortadan kaldırır.
Getir Yemek komisyonu nasıl hesaplanır?
Getir Yemek, müşteriye gösterilen sipariş tutarı üzerinden komisyon keser. Komisyon oranı işletmenin Getir Yemek ile yaptığı sözleşmeye göre değişir. Yazılım, komisyon tutarını otomatik hesaplayıp raporlara yansıtabilir; böylece net gelir kolayca görülür. Komisyon hesabı için yazılımın Getir Yemek sipariş tutarını doğru okuması gerekir.
Birden fazla şubem varsa her şube için ayrı entegrasyon gerekir mi?
Evet, her şubenin Getir Yemek'te ayrı bir hesabı ve API anahtarı vardır. Yazılım, her şubeyi ayrı tanımlar ve siparişleri doğru şubeye yönlendirir. Merkezi yönetim sistemi kullanan işletmeler, tüm şubelerin siparişlerini tek ekrandan izler ve raporları birleştirir; ancak API entegrasyonu şube bazında kurulur.
Getir Yemek API entegrasyonu, sipariş akışını otomatikleştirir ve operasyonel hataları ortadan kaldırır. Doğru kurulum ve sürekli izleme ile entegrasyon sorunsuz çalışır; işletme manuel iş yükünden kurtulur ve müşteri memnuniyeti artar. Detaylı bilgi ve demo talebi için iletişime geçebilirsiniz.
