Genel Tanıtım (TR)
Sunucu entegrasyonu
Giriş
Bu bölüm ile amaçlanan, harici otomasyon sistem geliştiricilerinin, genel bir bakış açısı ile sistem mimarisi, iş akışları, sistemler arasında paylaşılan veri içeriklerini, farklı kullanım senaryolarını tanıyıp geliştirmeye geçmeden önce sistemi tanımasıdır.
Harici otomasyon geliştiricileri, sistemi tanıdıktan sonra geliştirme sürecini geliştirici dokümanı sayfasından devam edecektir.
Sistem Mimarisi
Temel iş akışı ve veri yapısı
Geliştirici dokümanında detaylarını bulabileceğiniz Token X API ve Webhooklarının kullanarak harici otomasyon sistemi kendi üzerinde oluşan sipariş/çekleri Token OKC ye iletebilir. Token OKC de bütün ödeme tipleri desteklenebilecek şekilde ödeme alınır. Ödeme sonrasında fiş ve/veya Fatura oluşturulur. Siparişe ait ödeme ve fatura bilgileri harici sisteme geri dönülür.
Get Fiscal Parameters: Harici sistem ile Token OKC nin mali olarak eşleşmesi için zorunlu adımdır bu adım sonunda cihazın içinde kayıltı ürünler ve kısımlar harici sisteme aktarılır.
POST Basket
Harici sistem de oluşan siparişi, Token X API ya Token Integration protocol yapısına uygun olarak aşağıdaki gibi geçilir.
Sepete ait bilgiler ( müşteri bilgileri (optional), ürünler, indirim, tutar ...)
Ödeme yöntemini talebi (KK, Nakit, yemek kartı gibi) (opsiyoneldir. Bu alan geçilmezse tüm ödeme seçimleri Token OKC den yapılabilir)
Sektöre özel bilgi alanları ( Masa, kasiyer ismi, note alanı)
Kasada (anında) yada Masada(listele) ödeme yöntemi seçimi
Harici sisteme sipariş başarı ile Token X sistemine aldığı bilgisi hemen dönülür.
Token OKC platformunda Ödeme ve Mali işlemler çalışır.
Harici sistem webhookda asenkron gelecek ödeme ve mali işlem sonucunu bekler.
Token X sistemi Token Integration temel protokolü uyumlu geri sonuçu harici sisteme geri iletirilir.
Ödeme bilgileri (Ödeme türü, Varsa BKM ID, Tutar )
Fiş bilgileri (Fiş no, Z no, Ekü no)
Fatura bilgileri (UUID ...)
Bağlantı Konfigurasyonları
Kablosuz entegrasyon ile işyerinde ki bir çok bağlantı senaryo desteklenebilmektedir.
Bir harici otomasyondan cihazından birden fazla OKC ye bağlanabilme
Birden fazla harici otomasyon cihazının bir OKC ye bağlanabilmesi
Harici otomasyon sisteminden şube bazlı(örneğin internet siparişleri, kapıda ödeme) OKClere bağlanabilmesi
Ödeme tahsilat yöntemine göre konfigurasyonlar
Kasada Ödeme: Siparişi gönder OKC üzerinden hemen ödeme al
Harici otomasyon sisteminden, Token X API ları aracalığı ile OKC ye gelen siparişin işyeri kullanıcısı veya iş yeri müşteri tarafından çekilmesi için bu ekrana dokunmak yeterlidir.
Sipariş OKC ye indikten sonra Token OKC ödeme geçidi ekranına geçilir. Bu aşamadan sonra ödeme tipine göre ödeme akışı, ödeme sonrası fiş ve/veya E-fatura oluşturulur.
Masada/Kapıda Ödeme alma: Siparişi gönder OKC üzerinde siparişlerin listelenmesi sonra ödeme alınması
Harici otomasyon sisteminden, Token X API ları aracalığı ile OKC ye gelen siparişin işyeri kullanıcısı veya iş yeri müşteri tarafından çekilmesi için bu ekrana dokunmak yeterlidir.
Sipariş OKC ye indikten sonra Token OKC de sipariş(çekler) listelenir.
Bu aşamadan sonra ödeme tipine göre ödeme akışı, ödeme sonrası fiş ve/veya e-fatura oluşturulur. Mali belge ile ödeme sonlandırılana kadar sipariş/çek diğer cihazlar için kilitli tutulur.
Last updated
