Kasa iki şey yapar: fişi gönderir, öneriyi alır
Entegrasyonun kalbi burası. Kasa yazılımınız satış tamamlandığında fişi gönderir; ödeme adımından önce de sepeti gönderip öneri alır. İkisi ayrı uçlardır ve ayrı ayrı devreye alınabilir.
Ne gidiyor, ne geliyor
Siz gönderiyorsunuz
Ürün, adet, tutar, zaman, mağaza, kasa ve varsa müşteri tanımlayıcısı.
Ödeme başlamadan önce o anki sepet gönderilir.
Biz dönüyoruz
Her satır; ürün, uygunluk değeri ve kaynağıyla birlikte döner. Kaç öneri istediğinizi siz belirtirsiniz.
Öneri yanıtında döner. Satış fişe dönüştüğünde bu kimliği fişle geri gönderin; kabul ölçümü buna bağlıdır.
Kim yapar, ne kadar iş
POS tedarikçiniz ya da kendi yazılım ekibiniz. İş, iki uca istek atmak ve dönen listeyi ekranda göstermekten ibaret — mimari değişiklik gerektirmez.
- Yöntem
- HTTPS üzerinden JSON, kimlik doğrulamalı
- Anahtar
- Panelden üretilir, mağaza bazlı yetkilendirilir
- Gecikme
- Kasada saniyenin altında hedeflenir; ödeme adımını bloke etmez
- Hata durumu
- Servis yanıt veremezse kasa net bir hata alır, belirsiz bekleyiş olmaz
POST /api/recommend
X-Api-Key: <mağaza anahtarınız>
{
"basket": ["TK-100", "KS-750"],
"store_id": "merkez-01",
"top_k": 3
}POS ve kasa yazılımları hakkında sık sorulanlar
Kasa yazılımımızı değiştirmemiz gerekir mi?
Hayır. Mevcut kasanıza iki HTTP çağrısı eklenir. Öneri gösterimi de kasanın kendi ekranında, sizin tasarımınızla yapılır — biz bir arayüz dayatmıyoruz.
Önce hangisini devreye alalım?
Genelde fiş akışı. Fişler birikmeden öneri üretilemez; birkaç haftalık geçmiş yüklendiğinde ya da aktığında öneri ucu anlamlı sonuç vermeye başlar. Karar kimliğini geri gönderme adımı en sona bırakılabilir ama bırakılmamalı — ölçüm ona bağlı.
İnternet kesilirse kasa durur mu?
Hayır. Öneri isteği başarısız olduğunda kasa akışı devam eder; sadece öneri gösterilmez. Fiş akışı da kuyruklanabilir ve bağlantı geldiğinde gönderilebilir.
Teknik ekibinizle konuşalım.
Uçların sözleşmesini paylaşalım, entegrasyonun ne kadar iş olduğunu birlikte görelim.
- Kart bilgisi istemiyoruz
- Kurulum dakikalar sürer
- Kimliksiz müşteride de çalışır