Skip to content

QNB Finans Firması tarafından temin edilen Gelir İdaresi Başkanlığı E-Fatura, E-Arşiv ve E-Müstahsil Web Servislerinin nasıl kullanılacağına dair bir fikir edinilmesi açısından hazırlanmış bir Windows Form Uygulaması

Notifications You must be signed in to change notification settings

coderserdar/QNBFinansGIB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QNB Finans GİB (Gelir İdaresi Başkanlığı) E-Fatura, E-Arşiv ve E-Müstahsil Web Servis Uygulaması

GitHub stars GitHub forks GitHub watchers GitHub repo size GitHub language count GitHub top language GitHub last commit GitHub issues

Bu bir Windows Form uygulamasıdır ve içerisinde genel olarak QNB Finans firması üzerinden GİB (Gelir İdaresi Başkanlığı)'e ait olan E-Fatura, E-Arşiv ve E-Müstahsil web servislerine göndermek üzere kesilen faturaların ve müstahsil makbuzlarının XML dosyalarını oluşturma, servis üzerinde PDF veya ZIP formatlarında önizlemesini yapma, hazırlanan XML dosyalarını GİB tarafına gönderme gibi işlemlerin yapılmasını sağlamaktadır. Örnek olarak yine tarafımca yazılan Türkiye Şeker Fabrikaları A.Ş. bünyesindeki yapı kullanılmıştır. Olabildiğince açıklama satırları yazılarak hazırlanmış bir uygulamadır. C# programlama dili ile .NET 4 framework üzerinde Visual Studio 2017 IDEsi kullanılarak hazırlanmıştır. Apache 2.0 lisansına sahip olup, bu projedeki kaynak kodları kendi projelerinizde sorunsuzca kullanabilirsiniz.

Sistem Hakkında :

Programlama Dili .NET Versiyonu Geliştirme Ortamı
C# 4.5 Visual Studio 2017

Bu uygulamada aşağıdaki işlemler gerçekleştirilebilmektedir.

  • Gelir İdare Başkanlığı E-Fatura ve E-Arşiv web servislerine kesilen fatura ile ilgili bilgilerin doğru bir şekilde gönderilebilmesi için XML (UBL) dosyaları oluşturabilme
    • Daha önceden bu servis üzerinden gönderilen faturaların çıktısının ideal olarak alınabilmesi için Belge Oid denilen alanlarının temin edilmesi
  • Gelir İdare Başkanlığı E-Müstahsil web servisine müstahsil makbuzu ile ilgili bilgilerin doğru bir şekilde gönderilebilmesi için XML (UBL) dosyaları oluşturabilme
  • Eğer daha önceden gönderildiyse gönderilen faturanın veya müstahsil makbuzunun, gönderilmediyse hazırlanan XML (UBL) dosyasının GİB portalında nasıl görüneceğine dair PDF veya ZIP formatında önizleme yapabilme
  • Hazırlanan XML (UBL) dosyasının GİB E-Fatura ve E-Arşiv servisine (fatura kesilen tüzel kişinin E-Fatura mükellefi olup olmamasına bağlı olarak) veya E-Müstahsil servisine gönderilmesi
  • Fatura veya Makbuzları silmeye çalışırken, daha önce başarılı bir şekilde GİB servislerine gönderilip gönderilmediğinin kontrol edilmesi
  • Belli bir tarihten sonra E-Fatura Mükellefi olan kullanıcıların listesi (ListBox içerisinde gösteriliyor)
  • Belli bir tarihten sonra E-Fatura Mükellefi olan kullanıcıların listesini kullanıcının istediği klasöre TXT dosyası olarak çıkarabilmesi
  • Kullanıcının bu mükellef listesini ekrandan temizleyebilmesi

Bu uygulamada bazı dikkat edilmesi gereken önemli noktalar bulunmaktadır. Bunlar aşağıda belirtilmiştir;

  • Önemli Not: 01.01.2023 tarihinden itibaren %2lik bir Konaklama Vergisi getirildiği için, programda Konaklama Vergisine uygun olacak şekilde gerekli güncellemeler gerçekleştirilmiştir. E-Fatura ve E-Arşiv servislerine gönderilen Fatura XML dosyaları içerisinde konaklama vergisi ile ilgili alanların eklenmesi sağlanmıştır.
  • Öncelikle web servis adresleri Service Reference yerine Web Reference olarak eklenmelidir.
    • Diğer türlü çalışması mümkün değildir (Ya da en azından ben beceremedim)
  • Giden Fatura ana nesnesinde bulunan GIB Numarası alanı XML ve matbu çıktı için önem taşımaktadır.
    • Formatı faturayı gönderen kurumun kısaltması 3 harf, faturanın yılı 4 karakter ve geri kalan 9 hane de faturanın sıra numarası vb. olaack şekildedir. Mesela ERP2022000000001 gibi. Ancak burada XML oluşturulurken eğer faturanın düzenlenme tarihi 2021 ise ve GIB numarasında 2022 yazıyorsa sistem hata vermektedir. Ayrıca GIB numarası üzerinden tekillik kontrolü de yapıldığı için bu konuda özen gösterilmesi gerekmektedir.
    • Aynı GİB veya Müstahsil Makbuzu numarasını birden çok göndermeye kalktığımız zaman hata alabiliriz. Bu durum fatura veya makbuzun id bilgisi için de geçerlidir. Gerçi son güncellemede GİB-Makbuz numarası sorununu rastgele vererek hallettim. Ama bu konu ile ilgili bir exception alırsanız id bilgilerini değiştirmeniz sorunu çözecektir.
  • Önizleme kısmında E-Fatura sistemi için Belge Oid adı verilen alan oldukça önemlidir.
    • Bu da tekil bir değer olmaktadır. XML dosyası E-Fatura servisine gönderildiği zaman, işlem başarılı ise servisten bu değer dönmektedir. Bu değerin bir şekilde fatura içerisinde kaydedilmesi önemlidir. Çünkü önizleme yapılırken bu bilgi gönderilirse Mali Değer İçermez adındaki filigran çıktıda görünmez. Ama eğer bu bilgi yoksa, sistemdeki çıktı alınırken yukarıda bahsedilen filigran çıktıda görünür
  • Müstahsil Makbuzu ana nesnesinde bulunan Müstahsil Makbuzu No alanı XML ve matbu çıktı için önem taşımaktadır.
    • Formatı makbuzu kesen kurumun kısaltması 3 harf, makbuzun yılı 4 karakter ve geri kalan 9 hane de makbuzun sıra numarası vb. olaack şekildedir. Mesela ERP2022000000001 gibi. Ancak burada XML oluşturulurken eğer makbuzun tarihi 2021 ise ve GIB numarasında 2022 yazıyorsa sistem hata vermektedir. Ayrıca GIB numarası üzerinden tekillik kontrolüde yapıldığı için bu konuda özen gösterilmesi gerekmektedir.
  • Sistemde XML çıktısı için QNB Finans portalı üzerinde kendinize bir şablon oluşturmanız faydalı olacaktır. Bu şablonda faturadaki veya müstahsil makbuzundaki hangi bilgilerin nerede görüneceği, logonun nasıl olacağı vb. bilgileri ayarlayabilmektesiniz. Şu anda projede Türkşeker şablonu kullanılmaktadır. Ama bunu kendinize göre ayarlayabilirsiniz.
  • Bir faturanın çıktısı alınırken bazı istisnai durumlar söz konusu olabilmektedir. Mesela gönderilen faturadaki tüzel kişi fatura tarihinde e-fatura mükellefi olmayıp sonrasında mükellef olmuş olabilir. Bu yüzden Önizleme metodlarında en son eklenen kayıtlı kullanıcı listesi çalıştırılarak, eğer bu listede firmanın vergi numarası varsa E-Fatura değilse E-Arşiv çıktısı alınması mantıklı olacaktır. Ben şimdilik eski usülde bıraktım.
  • Olabildiğince kodlarda kontroller konuldu ancak herhangi bir durumda exception vb. oluşursa kodu debug ederek hatanın nerede olduğunu kontrol edebilirsiniz.
  • Kendi kullandığınız bazı alanlar XML içerisine tag ile konulmamış olabilir. Mesela Tevkifat kesintileri konulmamış olabilir. Burada en sık kullanılan alanlar üzerinden XML oluşturulmaya çalışıldı
    • Burada deneme yanılma yöntemi uygulayabilirsiniz. Ya da ben fırsat buldukça uygulamayı güncellemeye çalışacağım

Dokümantasyon ve Örnek Ekran Görüntüleri

Kaynak kod hakkında, web servis metotları ile ilgili olarak hazırlanmış dokümanlara ve örnek XML dosyalarına Dokümantasyon kısmından ulaşabilirsiniz. Burada özellikle Kaynak Kod Dokümantasyonu önem taşımaktadır. Bu PDF dosyası üzerinden kaynak kodları inceleyebilirsiniz. Diğer PDF dosyalarında da web servis metotlarına ilişkin bilgiler yer almaktadır. Bu PDF dosyaları üzerinden kaynak kodları inceleyebilirsiniz. PDF dosyası Hyperlink desteklediği için doküman üzerinden kodlara, fonksiyonlara vb. gidebilirsiniz. Kaynak kod içerisinde olabildiğince detaylı bir şekilde açıklama satırları yazmaya çalıştım.

Programla ilgili örnek ekran görüntüleri aşağıdadır

About

QNB Finans Firması tarafından temin edilen Gelir İdaresi Başkanlığı E-Fatura, E-Arşiv ve E-Müstahsil Web Servislerinin nasıl kullanılacağına dair bir fikir edinilmesi açısından hazırlanmış bir Windows Form Uygulaması

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages