3.1.8 Dinosoft POS Propay P100 Entegrasyonu

Dinosoft Propay Gateway, RESPOS'ta kesilen satışları Profilo Propay P1000 ECR yazar kasaya ağ üzerinden gönderir.

Akış: RESPOS → Dinosoft Propay Gateway (bilgisayar) → Propay yazar kasa (Wi-Fi veya USB). Gateway, cihazın yanıtını RESPOS'a geri bildirir; satış başarılıysa RESPOS fişi tamamlanmış sayar.

Gereksinimler

Gereksinim	Açıklama
İşletim sistemi	Windows 8 / Server 2012 veya üzeri (Windows 7 desteklenmez)
.NET Framework	4.7.2 veya üzeri
Ağ	Kasa bilgisayarı ve yazar kasa aynı yerel ağda (Wi-Fi) ya da USB ile bağlı
Lisans	Dinosoft lisansı; açılışta internet üzerinden doğrulanır
Yazar kasa	Açık, kağıdı takılı, satış ekranında

1. Kurulum

1.1 Ağ hazırlığı

1. Yazar kasayı işletmenin Wi-Fi ağına bağlayın. Cihazda Ayarlar > Ağ ve İnternet bölümünden bağlantı türü olarak Wi-Fi seçin.
2. RESPOS'un çalıştığı bilgisayarı aynı ağa bağlayın.
3. Misafir ağı veya istemci izolasyonu (Client Isolation) açık olmamalıdır; bu ayarlar cihazla bilgisayarın konuşmasını engeller.
4. Cihazda Servis Menü > Harici Entegrasyon ekranını açıp yazılan yerel IP adresini not edin.
5. IP'nin değişmemesi için modemde cihazın MAC adresine sabit IP rezervasyonu yapılması önerilir.

USB ile bağlantıda kablo takılı olmalı ve bilgisayarda RNDIS ağ bağdaştırıcısı görünmelidir.

Dikkat: Bu ekranda yazan port 3001'dir; bu, yalnızca eşleştirme sırasında kullanılan porttur. RESPOS ayarlarına girilecek port 3000'dir. Ekranda gördüğünüz numarayı RESPOS'a yazmayın.

1.2 Cihaz IP'sinin RESPOS'a tanımlanması

Gateway, yazar kasanın IP adresini ve seri numarasını RESPOS'taki kasa ayarlarından okur. Bu bilgileri her kasa bilgisayarında RESPOS'tan bir kez girin:

1. RESPOS ana ekranında Ayarlar düğmesine basın.
2. Yazarkasa alanından PROPAY'i seçin.
3. Yazarkasa Ayarları düğmesine basın.
4. Açılan ekranda alanları doldurun:
   • Yazarkasa Seri No: cihazın etiketindeki seri numarası
   • Ip: cihazın Harici Entegrasyon ekranında yazan IP adresi (1.1, 4. adım)
   • Port: 3000 (otomatik gelir, değiştirmeyin)
5. Yeşil onay düğmesiyle kaydedin, ardından Ayarlar ekranında Kaydet ve Çık'a basın.

Cihazın IP adresi değişirse aynı ekrandan Ip alanını güncelleyin ve gateway'i yeniden başlatın.

1.3 Uygulamanın kurulması

1. Partner panelinden Dinosoft Propay GMP3 Gateway Setup düğmesine tıklayıp kurulum dosyasını indirin.
2. İnen kurulum dosyasını çalıştırın ve adımları tamamlayın. Kurulum masaüstüne Dinosoft Propay Gateway kısayolu oluşturur ve uygulamayı bilgisayar açılışında otomatik başlayacak şekilde ayarlar.
3. Windows Güvenlik Duvarı veya antivirüs izin isterse İzin ver'i seçin. Uygulama cihaza 3000 ve 3001 portlarından bağlanır.

1.4 Ekran ve durum satırı

Uygulama açılınca lisansı doğrular, cihaza bağlanır ve sağ alttaki bildirim alanına (tepsi) iner. Pencereyi tepsi ikonuna sağ tıklayıp Göster ile açabilirsiniz; ▼ düğmesi tekrar gizler.

Durum satırı	Anlamı
HAZIR! (yeşil)	Cihaza bağlı, satış alınabilir
İŞLEM SÜRÜYOR... (turuncu)	Cihazda bir işlem devam ediyor
Bağlanılıyor... (turuncu)	Bağlantı koptu, yeniden deneniyor
YAZARKASA BAĞLANTISI YOK! (kırmızı)	Cihaza ulaşılamıyor (bkz. Sorun giderme)
Lisans doğrulanamadı (kırmızı)	Lisans sorunu; yetkili ile iletişime geçin
Cihaz IP adresi tanımlı değil! (kırmızı)	Bölüm 1.2'deki IP girilmemiş

Pencere sekmeleri: Init (anlık log), Cihaz Bilgisi, Ayarlar, Raporlar. Uygulamayı tamamen kapatmak için GATEWAY KAPAT düğmesini veya tepsi menüsünden Çıkış'ı kullanın.

2. Cihaz eşleştirme

Eşleştirme bir kez yapılır; sonraki açılışlarda cihaza otomatik bağlanılır.

2.1 İlk eşleştirme

1. Cihazda Servis Menü > Harici Entegrasyon ekranını açın ve bu ekranda bırakın.
2. Masaüstündeki Dinosoft Propay Gateway kısayoluyla uygulamayı başlatın (açıksa kapatıp yeniden açın). Kayıtlı eşleştirme yoksa uygulama otomatik olarak eşleştirme isteği gönderir; durum satırında Eşleşme yapılıyor. Lütfen bekleyiniz! yazar.
3. Cihaz ekranı Harici Bağlantı'ya geçer ve bağlantı kurulduğunda Bağlantı Başarılı • İşlem Bekleniyor görünür. Init sekmesinde Eşleştirme tamamlandı. Cihaz seri no: ... satırı yazılır.
4. Güvenlik kontrolü: Log'daki seri numarasını cihazın etiketi üzerindeki seri numarasıyla karşılaştırın. Farklıysa eşleştirmeyi hemen sıfırlayın (2.3) ve yetkiliye haber verin.
5. Cihazda ana menüden Satış Ekranına geçin. Durum satırı HAZIR! olduğunda RESPOS'tan satış yapılabilir.

Eşleştirme sırasında cihazda sırasıyla şu iki ekran görünür:

2.2 Yeniden eşleştirme

Cihaz değiştiğinde, cihaz sıfırlandığında veya uygulama sertifika hatası verip yeniden eşleştirme istediğinde:

1. Cihazda Servis Menü > Harici Entegrasyon ekranını açın.
2. Gateway penceresinde Cihaz Bilgisi sekmesinden Yeniden Eşleştir düğmesine basın.
3. 2.1'deki 3–5. adımları uygulayın.

2.3 Eşleştirmeyi sıfırlama

Ayarlar sekmesindeki Eşleştirmeyi Sıfırla düğmesi kayıtlı eşleştirmeyi siler; yetkili şifresi ister. Sıfırlamadan sonra cihaz servis moduna alınıp 2.1'deki gibi yeniden eşleştirilmelidir.

3. RESPOS'tan satış, ödeme ve iptal

Satış her zamanki gibi RESPOS'tan yapılır; gateway fişi cihaza gönderir ve cihazın sonucunu RESPOS'a bildirir.

3.1 Satış adımları

1. Cihazın Satış Ekranında olduğunu ve gateway durum satırının HAZIR! olduğunu kontrol edin.
2. RESPOS'ta ürünleri ekleyip ödeme tipini seçin ve satışı tamamlayın.
3. Kart ödemesinde işlem cihaz ekranında devam eder; müşteri kartını cihaza okutur. Gateway yanıt için en fazla 180 saniye bekler.
4. Fiş cihazdan basılır ve RESPOS satışı tamamlanmış olarak kaydeder. Hata olursa RESPOS'ta cihazın hata mesajı görünür.

3.2 Ödeme tipi eşleşmesi

RESPOS'ta ödeme alırken bastığınız ödeme düğmesine göre fişte şu ödeme tipi yazar:

RESPOS'ta seçilen ödeme	Fişte yazan ödeme tipi
Nakit	Nakit
Kredi kartı (bankaya bağlı ödeme)	Kredi Kartı
Yemek kartı / yemek çeki	Yemek Çeki
Havale/EFT	Havale/EFT
Açık hesap (cari)	Kredili/Vadeli Hesap
Puan ile ödeme	Desteklenmez, satış hata verir

Yemek kartları marka ayırt edilmeden fişe Yemek Çeki olarak yazılır.

3.3 Belge türleri

RESPOS'ta seçilen belge türü cihaza şu şekilde gider:

RESPOS belge türü	Cihazda
Fiş (varsayılan)	Mali fiş
Fatura	Kağıt fatura
e-Fatura	e-Fatura
e-Arşiv	e-Arşiv fatura
e-İrsaliye	e-İrsaliyeli fatura
Cari tahsilat	Cari hesap tahsilatı
Avans	Avans tahsilatı
Yemek kartı belgesi	Yemek kartı belgesi (yalnızca yemek kartı/çeki ile ödenir)

Fatura tahsilatı belgesi bu entegrasyonda desteklenmez. Fatura türlerinde RESPOS'taki müşteri bilgileri (VKN/TCKN, unvan, adres) eksiksiz olmalıdır.

3.4 Belge iptali

RESPOS'tan belge iptali yapıldığında cihazdaki açık fiş iptal edilir. Ödemesi tamamlanmış, basılmış bir mali fiş iptal edilemez; kart işlemlerinin geri alınması için Bölüm 4.2'deki İşlem İptali (Void) veya İade işlemleri kullanılır.

3.5 Yarım kalan fişler ve bağlantı kopması

• Yeni satış gönderilmeden önce cihazdaki belge durumu kontrol edilir. Cihazda aynı tutarlı yarım fiş varsa yalnızca ödemesi gönderilir; farklı tutarlı yarım fiş varsa iptal edilip yeni satış gönderilir.
• Satış sırasında bağlantı koparsa veya süre dolarsa ödeme asla otomatik tekrarlanmaz (çift çekim olmaması için). Gateway yeniden bağlanıp cihazdaki gerçek durumu okur ve RESPOS'a bildirir.
• Sonuçtan emin değilseniz satışı tekrar etmeden önce Cihaz Bilgisi > Belge Durumu ile fişin durumunu kontrol edin.

4. Raporlar ve yönetim işlemleri

Rapor, POS ve kasiyer işlemleri gateway penceresinden yapılır. Bu işlemler için cihaz Satış Ekranında olmalıdır. Z raporu, gün sonu, iptal/iade, ön provizyon, kısım silme ve eşleştirme sıfırlama gibi geri alınamayan işlemler yetkili şifresi ister.

4.1 X ve Z raporu

1. Gateway penceresinde Raporlar sekmesini açın.
2. Gün içi ara toplam için X Raporu'na basın; rapor cihazdan basılır.
3. Gün kapanışı için Z Raporu'na basın, yetkili şifresini girin ve onaylayın. Z No ve fiş no ekranda gösterilir ve log'a yazılır.

4.2 POS menü işlemleri

Raporlar sekmesindeki düğmeler cihazın banka POS menüsünü tetikler:

Düğme	İşlev
Son Slip	Son kart slibinin kopyasını basar
Gün Sonu	Banka gün sonu (mutabakat) yapar
Ara Rapor	Banka ara raporu
Son Mutabakat Slibi	Son gün sonu slibini tekrar basar
İşlem İptali (Void)	Gün sonu yapılmamış kart işlemini iptal eder
Eşleşen İade	Orijinal işleme bağlı iade
Eşleşmeyen İade	Orijinal işlem bilgisi olmadan iade
Taksit Sorgulama	Kartın taksit seçeneklerini sorgular
Puan Sorgulama	Kart puanını sorgular
Ön Provizyon / Ön Provizyon İptali	Provizyon alır veya iptal eder

Gerekli bilgiler (tutar, onay kodu vb.) açılan pencerede istenir. Gateway'in döndüğü yanıt işlemin başladığını bildirir; sonucu cihaz ekranından takip edin.

4.3 Cihaz Bilgisi sekmesi

• Belge Durumu: cihazdaki güncel fişin durumunu gösterir.
• Kısımları Getir, KDV Oranlarını Getir, Kasiyerleri Getir, Banka Listesi: cihazdaki tanımları listeler.
• Yeniden Eşleştir: Bölüm 2.2.

4.4 Kasiyer ve kısım işlemleri (Ayarlar sekmesi)

• Kasiyer Girişi: Kasiyer Id ve 4 haneli şifre ile cihazda kasiyer oturumu açar.
• Kasiyer Ekle / Kasiyer Düzenle: Kasiyer adı, 4 haneli şifre ve cihazın yönetici şifresi ile kasiyer tanımlar veya günceller.
• Kısım Ekle: Kısım no, ad, birim (Adet/Kilo), KDV %, fiyat ve fiyat limiti girilerek cihaza kısım tanımlanır.
• Kısım Sil: Kısım no ile tanımı siler (yetkili şifresi ister).

Şifreler log dosyasına maskelenerek yazılır.

5. Sorun giderme

Belirti	Olası neden	Çözüm
YAZARKASA BAĞLANTISI YOK! / Bağlantı kurulamadı!	Cihaz ve bilgisayar farklı ağda, IP değişmiş veya cihaz kapalı	Aynı Wi-Fi ağında olduğunuzu kontrol edin; Servis Menü > Harici Entegrasyon ekranındaki güncel IP'yi RESPOS'ta Ayarlar > Yazarkasa Ayarları > Ip alanına girin; misafir ağı/istemci izolasyonunu kapatın. USB'de kablo ve RNDIS bağdaştırıcısını kontrol edin
Eşleşme yapılamadı! / cihazda bağlantı başarılı ekranı çıkmıyor	Harici Entegrasyon ekranı açık değil veya 3001 portu engelli	Eşleştirmeden önce cihazda Servis Menü > Harici Entegrasyon ekranını açın; Güvenlik Duvarı/antivirüste 3000 ve 3001 portlarına izin verin
Cihaz IP adresi tanımlı değil!	RESPOS Yazarkasa Ayarları'nda Ip alanı boş	Bölüm 1.2
Lisans doğrulanamadı	İnternet yok veya lisans tanımsız	İnternet bağlantısını kontrol edin; Dinosoft destek ile görüşün
Bu işletim sistemi desteklenmiyor	Windows 7 veya daha eski	Windows 8 / 10 / 11'e yükseltin
RESPOS'tan gönderilen fiş çıkmıyor / Yazarkasa cevap vermedi	Cihaz ayar, servis menüsü veya kilit ekranında	Cihazı Satış Ekranına alın
Yazarkasa kağıdı bitti	Kağıt yok veya yazıcı hatası	Kağıt takın, satışı tekrar gönderin
Önceki fiş halen açık / Cihazda açık belge var	Cihazda tamamlanmamış fiş var	Fişi cihazda tamamlayın veya iptal edin, sonra tekrar deneyin
Ödeme aracısı yazarkasada tanımlı değil	RESPOS ödeme tipinin cihazda karşılığı yok	Bölüm 3.2'deki tipleri kullanın veya yetkiliden eşleme isteyin
Sertifika hatası / yeniden eşleştirme istendi	Cihaz sıfırlanmış veya değiştirilmiş	Bölüm 2.2 ile yeniden eşleştirin

Log dosyaları ve destek

• Anlık işlem geçmişi gateway penceresinin Init sekmesinde görünür.
• Ayrıntılı log, uygulama klasöründe günlük olarak dinosoftPropay_<YYYY-AA-GG>.txt adıyla tutulur ve 30 gün saklanır.
• Destek talebinde Init sekmesindeki ekranın görüntüsünü ve ilgili günün log dosyasını Dinosoft destek ekibine iletin. Sürüm bilgisi pencere başlığında ve ? düğmesinde yazar.