Vergi Usul Kanunu (VUK) 507 numaralı tebliği ile uyumlu PavoPay Uygulaması ile Harici Uygulamaların entegrasyonu kapsamında entegrasyonumuzu anlatır dökümandır.  Burada Bilnex ile olan bağlantı ayarları, hata kodları ve gerekli servislerin kurulumu anlatılacaktır.

Cihazın öncelikle entegrasyona hazır hale getirilmesi gerekir. Aşağıdaki bilgileri Pavo operasyon birimine iletmek gerekir. ( Operasyon PAVO  +90 533 053 80 92)

Kullanıcı Adı ve Soyadı, Mail Adresi ve Cihaz Seri Numarası

Yukardaki bilgileri operasyona mesaj ile ilettikten sonra cihaz üzerinden kullanıcı adı ve telefon numaranız ile (sms onayları isteyecektir) cihaz üzerinden şifre belirlemeniz için sistem sizi yönlendirecektir. Şifre belirleyip sisteme giriş yaptıktan sonra cihaz ekranında alt bölümde “Harici Entegrasyon Rest” yazısını göreceksiniz.

Bilnex Bağlantı Ayarları

Bilnex web sayfasında sağ üstteki Destek menüsünden Google Drive linkini tıklayın.

Açılan yeni sayfada sırasıyla V3 => 32Bit => 4_Bilnex Servis (ÖKC) => BilnexOkcKurulumSetup.msi dosyasını indirin. Servis kurulum ve lisanslama işlemlerini yapın..

Ökc kurulumunda şunlara dikkat edilmesi gerekir;

• Cihaz kurulumunda aşağıdaki gibi ayarlanmalıdır.

Kurulum yolu:  Bilnex programının kurulu olduğu klasörde olmalıdır.

Cihaz Ip: Cihazın aldığı ıp adresi yazılır.

Cihaz Port: 4567 Sabit yazılır.

Cihaz No: Cihazın altında bulunan (SN) seri numarası bu alana yazılır.

Parmak İzi: BLX olarak sabit kalmasında fayda var. Fingerprint değeri olarak kullanılan bu değer haberleşmede kullanılmaktadır. Eşleşmemesi durumunda istek geri çevrilecektir.

Bu tanımlamalardan sonra İleri butonuyla ilerleyerek kurulumu tamamlayın ve lisanslama işlemlerini yapın. Kurulum otomatik güncel verisyonu indirecek ve kuracaktır.

Kurulum Sonrası Servis Bağlantı Ayarları

Kurulum sonrası aşağıdaki gibi Bilnex Servis Bağlantı programı açılacaktır. Kurulum esnasında yapılan ayarlar ile aşağıdaki veriler otomatik gelir.
Unutmayın bu sekmede yazılan veriler Pavo cihazının verileridir.

Kaydet yaptıktan sonra “Servis Bilgileri”  sekmesine geçin.

Servis Bilgileri sekmesinde Servis IP Adresi servisin kurulduğu Bilgisayarın Ip adresi olacaktır. Ökc kurulumu esnasında servis otomatik kurulacaktır, fakat Ip adresi sabit değilse bilgisayar Ip adresini mutlaka sabit hale getirin.

Ayarları kayıt ettikten sonra Başlat ile servisi aktif edin. Windows servisi arka planda çalışacaktır. Uygulamanın açık olması gerekmiyor.

Bağlantının başarlı sonuçlandığını anlamak için swagger ile test etmek gerekir. Bunun için aşağıdaki gibi ekrana gelen mesaja Evet deyin.

Açılan sayfada “Try it out” tıkladığınızda cihazdan sorgulama yapacak ve cihaz bilgilerini size gösterecektir.  Marka Model yazan bölümler boş ise başarısız olmuş demektir.

Bilnex Üzerinde Yapılması Gereken Tanımlamalar

Yeni Nesi Çdeme Kaydedici (ÖKC) Cihaz Tanımlarına girerek her cihaz için bir tanımlama yapmak gerekir.

Ökc tanımlarında;

Tipi: Pavo Vuk507 seçili olmalı

Servis Adresi: Servisin kurulu olduğu cihaz Ip adresi yazılmalı.  Tek bilgisayarda birden fazla Pavo cihazı kullanıldığı durumlarda her bilgisayarda servisin kurulduğu Ip adresi olmalı. Fakat her bilgisayarda ayrı ayrı cihazların olduğu senaryoda her terminal için yani her kasa için ayrı ayrı ökc kurulumu yapmak gerekir. Dolayısı ile hangi cihaz ile haberleşecek ise ilgili cihaz Ip adresi yazılmalı.

Bilnex Servisin kullan: Güncel yapıda tüm ökc ler ile Servisler marifeti ile bağlantı yapıldığında bu seçenek otomatik işaretli gelecektir. Kaldırılmış ise mutlaka işaretleyin.

Bu Bilgisayarda Tanımlı Cihaz: Her kasa için ayrı tanımlama yapılabileceğinden hangi terminalde hangi kasa kullanılacak ise o bilgisayarda Düzelt kaydet yapmak gerek. Bu sayede posterminal.ini dosyasına pc ile ökc yi eşitleyen satırı yazacaktır.

Tüm tanımlamalar bu kadar. Stoklar ve Kdv Departman Tanımları hazır ise satışa başlanabilir.

Ökc bağlantı tipi kullanılarak Pavo cihazlar ile haberleştiğimiz için Bilnex tarafında Kdv Departman Tanımlarına ihtiyacımız var. Departman tanımlamalarını açın.

Kdv Departman Tanımlarını otomatik cihazdan çekmek için “Ökcden Getir” butonu kullanılır. Cihazdaki Kdv Bilgilerine göre otomatik departman tanımları oluşturulacaktır.

Fakat stokların Kdv Departmanlarıyla eşleştirilmesi otomatik yapılmamaktadır. Bu eşleşme manuel olarak veya aşağıdaki sorgu ile KDV Oranına göre otomatik eşleştirilecek şekilde toplu yapılabilir. Bu sorguyu çalıştırmadan mutlaka yedek alın.

UPDATE STOK SET POS_KDV_DEPARTMAN = (SELECT TOP 1 SIRA FROM POS_KDV_DEPARTMAN
WHERE POS_KDV_DEPARTMAN.SATIS_KDV1=STOK.SATIS_KDV1)

İşlemlerin yapılışını izlemek için tıklayın.

Not:

• Cihaz üzerinde Banka Uygulamaları yüklenmemiş ise mevzuat gereği hiç bir ödeme türüyle satışa izin vermeyecektir. Yani nakit satışa da izin vermeyecektir. Pavo cihaz üzerinde Banka Uygulamalarının olup olmadığını kontrol etmek için aşağıdaki yönergeyi izleyebilirsiniz.
  Videoyu izlemek için tıklayın.