Genel Tanıtım (TR)
Last updated
Last updated
Bu bölüm ile harici otomasyon sistem geliştiricilerinin genel bir bakış açısı ile sistem mimarisini, iş akışlarını, sistemler arasında paylaşılan veri içeriklerini, farklı kullanım senaryolarını tanıyıp geliştirmeye geçmeden önce sistemi tanıması amaçlanmıştır.
Harici otomasyon geliştiricileri, sistemi tanıdıktan sonra geliştirme sürecini Geliştirici Dokümanı sayfasından devam edecektir.
Geliştirici dokümanında detaylarını bulabileceğiniz Token X API ve webhooklarını kullanarak harici otomasyon sistemi kendi üzerinde oluşan sipariş/çekleri Token ÖKC'ye iletebilir. Token ÖKC'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 ÖKC'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'a Token Integration protokol 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 ÖKC'den yapılabilir)
Sektöre özel bilgi alanları (Masa, kasiyer ismi, note alanı)
Kasada (anında) ya da Masada (listele) ödeme yöntemi seçimi
Harici sisteme sipariş başarı ile Token X sistemine aldığı bilgisi hemen dönülür.
Token ÖKC 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 iletilir.
Ödeme bilgileri (ödeme türü, varsa BKM ID, tutar )
Fiş bilgileri (fiş no, Z no, ekü no)
Fatura bilgileri (fatura numarası, ETTN, ...)
Kablosuz entegrasyon ile işyerindeki birçok bağlantı senaryo desteklenebilmektedir.
Bir harici otomasyondan cihazından birden fazla ÖKC'ye bağlanabilme
Birden fazla harici otomasyon cihazının bir ÖKC'ye bağlanabilmesi
Harici otomasyon sisteminden şube bazlı (örneğin internet siparişleri, kapıda ödeme) ÖKC'lere bağlanabilmesi
Kasada Ödeme: Siparişi gönder ÖKC üzerinden hemen ödeme al
"Sepet ödemesini hemen al" modunda çalışan Token ÖKC'ye harici otomasyon sisteminden gönderilen siparişin, herhangi bir tuşa basmaya gerek olmadan anlık olarak ödeme ve mali işlemler adımına geçişi sağlanır.
Sipariş ÖKC'ye indikten sonra Token ÖKC ödeme geçidi ekranına geçilir. Bu aşamadan sonra ödeme tipine göre ödeme tamamlanır. Ödeme sonrası fiş veya e-fatura oluşturulur.
Masada/Kapıda Ödeme alma: Siparişi gönder ÖKC üzerinde siparişlerin listelenmesi sonra ödeme alınması
Harici otomasyon sisteminden şube (branch-id) için oluşturulan siparişler, şubede bulunan "Birden fazla sepeti listele" modunda çalışan Token ÖKC'lerde listelenir.
Bu aşamadan sonra ödeme tipine göre ödeme akışı, ödeme sonrası fiş veya e-fatura oluşturulur. Mali belge ile ödeme sonlandırılana kadar sipariş diğer cihazlar için kilitli tutulur.
Token ÖKC'nin harici otomasyon sistemine tanıtılması
Token ÖKC'de bulunan TokenX-Connect (Wireless) uygulaması ilk açıldığında ya da TokenX-Connect (Wireless) uygulamasında sol üstte bulunan ikona tıklandığında bir QR kod gösterilir. Bu kod içerisinde API isteklerinde kullanılacak AV ile başlayan terminal id bilgisi, şube id bilgisi ve işyeri id bilgisi yer almaktadır. Harici otomasyon sistemi, "merchantId_branchId_terminalId" formatındaki QR kodu okuyarak, terminal ve şube bilgisini alıp API isteklerinde bu bilgileri kullanabilmektedir.
Sepet modunun ayarlanması
Kasada ödeme ve masada ödeme metotları arasında geçiş yapmak için TokenX-Connect (Wireless) uygulamasında sağ üstte bulunan ikona tıklanabilir.