Ödeal A910S – KobiJet Entegrasyonu: Kurulum Rehberi

Bu rehber, KobiJet kullanan bir işyerinde Ödeal A910S ödeme cihazının KobiJet ile birlikte çalışması için gerekenleri anlatır. Entegrasyon kurulduğunda KobiJet'te kesilen satış cihaza otomatik gönderilir, müşteri ödemeyi cihazda yapar ve sonuç KobiJet'e kendiliğinden döner.

1. Gereksinimler

• Ödeal A910S cihaz: Cihazın profili Device2Device (D2D) olmalıdır. Cihazı Ödeal'den alırken bunu belirtin.
• Ödeal işyeri portal hesabı: portal.odeal.com adresine giriş için kullanıcı adı ve şifre.
• İnternet bağlantısı: Hem cihazda hem de KobiJet'in çalıştığı bilgisayarda internet olmalıdır. Cihaz ile bilgisayarın aynı ağda olması gerekmez, iletişim Ödeal sunucusu üzerinden yapılır.
• Güncel KobiJet sürümü: Ödeal desteği olan sürüm kurulu olmalıdır.
• Güncel KDV oranları: Stok kartlarındaki KDV oranları güncel olmalıdır (%1, %10 veya %20). Eski %8 ve %18 oranları faturada sorun çıkarır.

2. Ödeal servis anahtarlarını alın

1. https://portal.odeal.com/giris adresine işyerinin portal bilgileriyle giriş yapın.
2. Sol alttaki Ayarlar → Entegrasyon Bilgileri menüsüne girin.
3. Sağdaki ekranda "Fiziksel Ürün" sekmesini seçin. Anahtarlar mutlaka bu sekmeden alınmalıdır. "Diğerleri" sekmesindeki anahtarlar cihaz için değildir; onlar kullanılırsa satışlar "profil tipi device to device olmalıdır" (2040) hatası verir.
4. Fiziksel Ürün sekmesinde, KobiJet'e bağlanacak cihazın satırındaki iki anahtarı kopyalayın:

• API Key: Tireli, kısa anahtar.
• Secret Key: Uzun anahtar. Ekranda noktalı görünür, yanındaki kopyala simgesiyle alınır.

İşyerinde birden fazla cihaz varsa her cihazın anahtarları ayrıdır. Doğru cihazın satırını seçtiğinizden emin olun. Bu anahtarlar işyerine özeldir, başkasıyla paylaşmayın.

3. Cihazda cihaz kodu oluşturun

1. Cihazdaki Ödeal uygulamasına giriş yapın.
2. Sol üstteki menüden Cihazlarım bölümüne girin.
3. Bir cihaz kodu oluşturun. Kod yalnızca harf ve rakamdan oluşmalıdır, örneğin KBJ01.
4. Kodu not edin. KobiJet ayarına büyük-küçük harf dahil birebir aynı yazılacaktır.

Cihazlarım menüsü görünmüyorsa cihazın profili D2D olarak ayarlanmamıştır. Ödeal çağrı merkezini arayın, cihazın arkasındaki fiziksel seri numarasını vererek profilin D2D yapılmasını isteyin.

4. KobiJet ayarlarını yapın

KobiJet'in kurulu olduğu klasördeki SWAP klasörüne ODEALConfig.ini adında bir dosya oluşturun ve içine şunu yazın:

[ODEAL]
URL=https://api.odeal.com
MerchantKey=API Key buraya
SecretKey=Secret Key buraya
CihazKodu=Cihazlarım'da oluşturduğunuz kod buraya
BeklemeSn=180
SorguAraligiSn=3
KartOdemeTipi=CREDITCARD
YemekKartiOdemeTipi=FOOD_CARD

• API Key MerchantKey satırına, Secret Key SecretKey satırına yazılır. Anahtarların yerleri karışırsa entegrasyon çalışmaz.
• URL satırı aynen bu şekilde kalmalıdır. Sonuna /api/v1 eklemeyin.
• Anahtarları değiştirdiyseniz ve dosyada [IZLEME] bölümü varsa, o bölümü silin.
• KobiJet yerel ayarlarında Yazarkasa türü olarak ODEAL A910S, Son işlem olarak YNÖKC Fişi Yazdır seçin.

5. İlk test

1. Kurulum bitince KobiJet'ten 1 TL'lik nakit bir satış yapın. Nakit satışta cihaz ödemeyi kendisi tamamlar ve KobiJet'te "Ödeme alındı" mesajı görünür.
2. Ardından küçük tutarlı bir kartlı satış deneyin. Cihazda kart okutma ekranı doğrudan açılmalıdır.

Canlı ortamda yapılan test satışları da gerçek satıştır. Ödeal bu satışlar için e-Arşiv fatura keser.

6. Günlük kullanımda bilinmesi gerekenler

• Ödeme tipi: KobiJet'te nakit seçilen satış cihazda otomatik tamamlanır. Kart seçilen satışta cihaz kart okutma ekranını açar.
• Bekleme süresi: KobiJet ödemeyi 180 saniye bekler. Bu süre içinde ödeme yapılmazsa ya da ödeme başarısız olursa satış komple iptal edilir.
• Cihaz ekranı: İptal edilen satışın ekranı cihazda açık kalabilir. Kasiyer bu ekranı X ile kapatmalı, o ekrandan ödeme almamalıdır. Böyle bir ekrandan yine de ödeme alınırsa KobiJet bir sonraki satışta uyarı verir. Uyarı çıkarsa ilgili belgenin tahsilatını kontrol edin.
• Fatura: Ödeal her ödeme için e-Arşiv/e-Fatura belgesini kendisi keser. KobiJet bu satışlar için ayrıca fatura kesmez.
• İade: İade işlemi KobiJet'ten yapılmaz. Gerekirse belge KobiJet'te iptal edilir, iade ise cihazdan elle yapılır. Cihazdan gün sonu alındıktan sonra o günün işlemleri iptal edilemez.
• Yemek kartı: Yemek kartıyla yapılan tahsilatlarda ödeme tipi şimdilik cihazda seçilir.

7. Sık karşılaşılan hatalar

"Profil tipi device to device olmalıdır" (Hata kodu: 2040)

Sebep: Anahtarlar portalda "Diğerleri" sekmesinden alınmış ya da cihazın profili D2D değil.

Çözüm: Anahtarları portalda Ayarlar → Entegrasyon Bilgileri → Fiziksel Ürün sekmesinden tekrar alıp ini dosyasına yazın. Sorun devam ederse Ödeal çağrı merkezinden profilin D2D yapılmasını isteyin.

"Belirtilen organizasyona ait profil bulunamadı" (Hata kodu: 2018)

Sebep: API Key ve Secret Key yanlış yazılmış ya da yerleri karışmış.

Çözüm: ini dosyasındaki iki anahtarı portalın Fiziksel Ürün sekmesindeki değerlerle karşılaştırın. API Key MerchantKey satırına, Secret Key SecretKey satırına yazılmalıdır.

"Unauthorized access" (Hata kodu: 10003)

Sebep: Anahtar satırlarından biri boş.

Çözüm: ini dosyasında MerchantKey ve SecretKey satırlarının dolu olduğunu kontrol edin.

Satış cihaza düşmüyor

Sebep: KobiJet'teki cihaz kodu, cihazdaki kodla aynı değil.

Çözüm: ini dosyasındaki CihazKodu satırı, cihazda Cihazlarım bölümündeki kodla büyük-küçük harf dahil birebir aynı olmalıdır.

Cihazda "Cihazlarım" menüsü görünmüyor

Sebep: Cihazın profili D2D değil.

Çözüm: Ödeal çağrı merkezini arayın, cihazın fiziksel seri numarasını vererek profilin D2D yapılmasını isteyin.

Kartlı ödemede "RED – BAĞLANTI YOK"

Sebep: Cihaz bankaya bağlanamıyor.

Çözüm: Cihazın internet bağlantısını kontrol edin. Sorun devam ederse Ödeal'i arayın.

"Ödeme süresi doldu"

Sebep: 180 saniye içinde ödeme yapılmadı.

Çözüm: Cihazda açık kalan eski ödeme ekranını X ile kapatın, ardından satışı KobiJet'ten yeniden başlatın.