Herkese selam ederim;
Zamanında bende bu işi yapmak istemiştim...
Eğer uygulamayı tek bir firma için yapıyorsanız ve/veya bu uygulama için her yıl ücret almayacaksanız bu işlemi yapmak çok makul görünmüyor. Sonrasında da zaten bu işten vazgeçtim.
Bu işi en iyi yapan firmalardan birisi İngenico (Worldline). (Şahsi kanaatim)
İngenico (Worldline) yazarkasa POS cihazlarınızın otomasyon sistemleri (ERP, restoran yazılımları vb.) ile konuşması için GMP3 (Güvenli Mesajlaşma Protokolü) gerekli. Bunun için de firmadan GMP3 lisansı (ücretli mukabilinde) alınması gerekiyor. Bu ücret yıllık isteniyor bildiğim kadarı ile.
Şimdi sizin için AI a sordum. Cevaplar aşağıdaki gibidir.
Entegrasyon işlemleri genellikle şu güncel modeller için geçerlidir
- İDE280 (Masaüstü)
- iWE280 (Mobil)
- Move/5000F (Yeni Nesil Mobil)
... ancak bir yazılımcı olarak işin teknik ve bürokratik tarafında dikkat etmeniz gereken kritik bir detay daha var: Hash Onayı.
Kendi yazdığınız yazılımı bir yazarkasa ile konuşturmak için izlemeniz gereken tam yol haritası şöyledir:
- GMP3 Lisansı ve Aktivasyon
İlk adım cihazın dış dünyaya kapılarını açmasıdır.
Satın Alma: ikasa.com.tr üzerinden giriş yaparak "GMP3 Hizmet Bedeli" ni ödemeniz gerekir.
Bağlantı Tipi: Satın alma sırasında "Kablolu" (USB/RS232/Ethernet) veya "Kablosuz" (IP üzerinden) seçeneklerinden birini seçersiniz.
Parametre Yükleme: Ödemeden yaklaşık 24-48 saat sonra cihaz üzerinden "Parametre Yükleme" yaparak lisansı cihaza çekmeniz gerekir.
- Yazılım Entegrasyonu (Teknik Kısım)
Yazılımınızın cihazla haberleşmesi için Worldline'ın (Ingenico) sunduğu DLL veya SDK dosyalarına ihtiyacınız olacak.
Haberleşme: Genellikle TCP/IP veya Seri Port (COM) üzerinden XML tabanlı komutlar gönderilir.
Örnek Akış: Yazılımınızdan "Satış Tutarı: 100 TL, KDV: %20" gibi bir komutu gönderirsiniz, cihaz bunu alır, ödemeyi çeker ve mali fişi keser.
- Kritik Adım: Uygulama Kaydı ve "Hash" Tanımlama
Kendi yazılımınızı kullandığınız için Ingenico'nun sisteminde yazılımınızın "tanımlı" olması gerekir.
Hash Değeri: Yazılımınızın .exe dosyasının benzersiz kimliği (Hash değeri) Ingenico tarafına bildirilmelidir.
Güvenlik Onayı: Eğer yazılımınız Ingenico sisteminde kayıtlı değilse, cihaz bağlantı kursa bile "Bilinmeyen Uygulama" veya "Yetkisiz Erişim" hatası verebilir.
İzlemeniz Gereken Önerilen Yol
Kendi yazılımınız için şu adımları takip etmenizi öneririm:
- Worldline (iKasa) Destek Hattı (0850 250 40 30) ile görüşerek "Kendi satış yazılımımı entegre etmek istiyorum, geliştirici dokümanlarını ve SDK' yı nasıl temin edebilirim?" diye sorun.
- Yazılımınızı Ingenico' nun test ortamında veya bir demo cihazda simüle edin.
- Entegrasyon bittiğinde, yazılımınızın Hash değerini sisteme tanımlatmak için resmi başvurunuzu yapın
Filemaker ile mümkün olup olmadığını sordum
FileMaker kullanarak geliştirilen bir uygulama ile İngenico (Worldline) yazarkasa entegrasyonu yapmak teknik olarak mümkündür, ancak FileMaker' ın doğası gereği bu süreç standart bir .exe uygulamasına göre biraz daha farklı bir mimari gerektirir.
Bu entegrasyonun sağlıklı çalışması için izleyebileceğiniz yöntemler ve dikkat etmeniz gerekenler şunlardır:
- Haberleşme Yöntemi ve Eklenti İhtiyacı
FileMaker, yerleşik fonksiyonlarıyla doğrudan TCP/IP soketleri üzerinden düşük seviyeli (raw) XML verisi gönderip almakta zorlanabilir. İngenico'nun GMP3 protokolü ise genellikle TCP/IP üzerinden XML tabanlı komutlarla çalışır.
MBS (Monkeybread Software) Plug-in: FileMaker dünyasında bu tür donanım entegrasyonları için en çok tercih edilen araçtır. MBS Plugin'in TCP/IP fonksiyonları sayesinde yazarkasa ile doğrudan soket bağlantısı kurabilir ve komut gönderebilirsiniz.
Troi Serial Plug-in: Eğer cihazı USB/Seri port üzerinden bağlayacaksanız bu eklentiyi kullanabilirsiniz.
-
"Hash Onayı" ve Ara Yazılım (Middleware) Çözümü
İngenico sistemleri, güvenlik nedeniyle sadece "kayıtlı ve onaylı" uygulamaların fiş kesmesine izin verir. FileMaker dosyaları (.fmp12) tek başına bir .exe olmadığı için doğrudan Hash kaydı yapılması teknik olarak güçtür.
Ara Yazılım Kullanmak: En yaygın çözüm, FileMaker ile yazarkasa arasına küçük bir "köprü" uygulama koymaktır. Örneğin, .NET veya Delphi ile yazılmış, sadece yazarkasa ile konuşan ve FileMaker'dan gelen bir metin dosyasını veya HTTP isteğini bekleyen bir ara yazılım (GMPJobListener gibi) kullanabilirsiniz.
Hash Kaydı: Eğer ara yazılım kullanırsanız, İngenico'ya bu ara yazılımın .exe dosyasını onaylatmanız yeterli olur.
-
Uygulama Adımları
Lisans: İlk aşamada bahsettiğimiz GMP3 Hizmet Lisansı her durumda satın alınmalıdır.
Bağlantı Ayarları: Cihazın IP adresini sabitleyin (Statik IP). FileMaker tarafında oluşturacağınız script, bu IP adresine ve ilgili porta (genellikle 4444 veya benzeri) XML paketini gönderecektir.
Daha soracağımız sorulara göre bu yazışma uzar gider.
En azından bir fikir edinilmesi açısından faydalı olacağını umuyorum.
Herkese hayırlı günler dilerim.
Saygılarımla.