Kurumsal · Entegrasyon
Bağlanan kanallar
Yemeksepeti, Getir Yemek, Trendyol Yemek ve Migros Yemek siparişi adisyona düşer. Telefon, kart, yazıcı ve başka kasa da aynı düzene bağlanır.
Bağlantı
Entegrasyon nasıl açılır
-
1
Restoran kaydı ve eşleşme
Restoran AdisGo’da hesabını açar ve bir kurye firmasıyla eşleşmeyi onaylar. Eşleşme yoksa dışarıdan gelen teslimat içeri alınmaz.
-
2
API anahtarı üretilir
Restoran panelinde, lojistik ayarlarındaki Harici POS API alanından entegrasyon oluşturulur. Anahtar ve gizli anahtar verilir. Gizli anahtar yalnızca o anda görünür; yazılımın sunucusunda saklanır.
-
3
Dış sipariş izni açılır
Aynı sayfada “Harici POS API → kurye havuzu” açık olmalıdır. Kapalıysa istek kabul edilmez.
-
4
Yazılım teslimatı gönderir
Karşı yazılım, sipariş hazır olunca AdisGo’ya teslimat kaydı açar. İş, eşleşen kurye firmasının operasyonuna düşer. Durum, aynı anahtarla geri okunur.
Kurye API
Adres /api/delivery/v1/jobs. İstek, restoranın anahtarıyla yapılır. Başlıklar X-Api-Key ve X-Api-Secret olur. Gövde JSON’dur.
Gövdede dış sipariş numarası, müşteri adı, telefon, alış adresi, teslimat adresi, tutar ve ödeme yöntemi bulunur. Adreslerin konumu varsa enlem ve boylam da yazılır. İsteğe bağlı geri çağrı adresi, durum değişince karşı yazılıma haber vermek içindir.
Kayıt açılınca yanıtta teslimat kimliği döner. Aynı kimlik /api/delivery/v1/jobs/{id} adresinden okunur. Anahtar yalnızca o restoranın işini görür.
POST /api/delivery/v1/jobs
X-Api-Key: restoranın anahtarı
X-Api-Secret: gizli anahtar
{
"externalOrderId": "KASA-1042",
"customerName": "Ayşe Yılmaz",
"customerPhone": "05xx",
"pickupAddress": "Şube adresi",
"deliveryAddress": "Müşteri adresi",
"orderAmount": 240,
"paymentMethodKey": "cash"
}
Diğer kapılar
Paketten yazıcıya
Paket platformları
Yemeksepeti, Getir Yemek, Trendyol Yemek ve Migros Yemek siparişi, şubenin webhook adresine düşer. Adres /api/marketplace/webhook/{platform}/{şube} biçimindedir. İstek, şubenin webhook sırrıyla doğrulanır. Ürün adları paneldeki ürünlerle eşlenmiş olmalıdır.
Caller ID
Telefon santrali, çalan numarayı /api/caller-id/incoming adresine yollar. Başlık X-Caller-Id-Key olur. Numara kayıtlı müşteriyse paket ekranında kartı açılır.
Masaüstü bağlantı
Mutfak ve adisyon yazıcısı, kasa bilgisayarındaki AdisGo köprüsüyle çalışır. Köprü, şube oturumuyla buluta bağlanır ve fişi yerel yazıcıya basar. Ayrı bir yazıcı markası gerekmez.
Kurye uygulaması
Kurye konumunu ve vardiyasını AdisGo uygulamasından iletir. Konum, firma haritasında görünür. Dış yazılımın kurye konumunu ayrıca göndermesine gerek yoktur.