You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Bu doküman, Netsis' te Entegrasyon lisansına (Online e-İrsaliye) sahip, Entegrasyon çalışmalarına başlayabileceği Başkanlık tarafından kendisine bildirilen ve hali hazırda e-Fatura uygulamasını kullanan mali mühürleri kendilerine ulaşan mükelleflerin, e-İrsaliye test çalışmalarını açıklamak amacıyla hazırlanmıştır. Gerekli ön hazırlıklar ve entegrasyon testleri için aşağıdaki sıra takip edilmelidir.
e-İrsaliye uygulamasından yararlanmak isteyen mükelleflerin öncelikle e-Fatura kullanıcısı olmaları gerekmektedir. Netsis içerisinde e-İrsaliye uygulamasında kullanılan yöntem, e-Fatura uygulamasında kullanılan yöntemle aynı olmak zorundadır.
Gelir İdaresi' nin yayınladığı e-İrsaliye başvuru dokümanı, kullanılan yönteme göre başvuru süreçleri hakkında kısa bilgiler içermektedir. {+}https://ebelge.gib.gov.tr/dosyalar/kilavuzlar/E+https://ebelge.gib.gov.tr/dosyalar/kilavuzlar/E-irsaliyeUygulamasiBasvuruRehberiveKilavuzu_V1.pdfirsaliyeUygulamasiBasvuruRehberiveKilavuzu_V1.pdf[ |https://ebelge.gib.gov.tr/dosyalar/kilavuzlar/E-irsaliyeUygulamasiBasvuruRehberiveKilavuzu_V1.pdf]

Başkanlığa e-İrsaliye Entegrasyon Yöntemi Başvurusu


e-Fatura uygulamasında hali hazırda entegrasyon yöntemini kullanan mükelleflerin, e-irsaliye uygulamasına dahil olmak için Başkanlığa hitaben bir dilekçe ve ekinde yer alan test tanım formu ile başvurmaları gerekmektedir.

• Test Tanım Formu ➔ https://test.efatura.gov.tr/entegrasyonbasvuru/BasvuruWS_SSL.jsp[ |https://test.efatura.gov.tr/entegrasyonbasvuru/BasvuruWS_SSL.jsp]


Test Tanım Formu uygulamanın test ortamına bağlantı kuracağı sunucu ve istemci IP adresleri ile web servis uç noktalarının belirtildiği formdur. Test tanım formunda yer alan IP numaraları ile canlı ortamda kullanılan IP numaralarının farklı olması gerekmektedir.

  • Entegrasyon çalışmalarına başlayabileceği Başkanlık tarafından kendisine bildirilen kullanıcılar, kendi bilgi işlem sistemleri aracılığı ile e-İrsaliye gönderip alabilmeleri için öncelikle sistemlerinde gerekli altyapıyı oluşturmalıdır. Bu nedenle kullanıcıların, www.ebelge.gov.tr[ |http://www.ebelge.gov.tr/] adresinde yer alan teknik kılavuzlarda açıklanan servislere ve altyapıya yönelik hazırlıklarını tamamladıktan sonra entegrasyon çalışmalarına başlayabilirler.


  • Başvurusu uygun bulunan mükelleflerin entegrasyon testlerinde kullanacakları test hesapları Başkanlık tarafından tanımlanır ve mükellefe e-posta ile bildirilir.



  • !!! Test adımlarına geçilmeden önce mutlaka hem Netsis web servisinin kurulu olduğu makinede hem de faturaları mühürleyip gönderme işlemini yapan Netsis istemci makinesinde aşağıdaki adrese girilip sayfanın açılıp açılmadığı kontrol edilmelidir.


{+}https://merkeztest.efatura.gov.tr/EFaturaMerkez/services/EFatura?wsdl+[ |https://merkeztest.efatura.gov.tr/EFaturaMerkez/services/EFatura?wsdl]
Bu link her iki makineden de açıldığında aşağıdaki gibi bir sayfa gelmiyorsa, bu durumda test tanım formlarında belirtilen IP ve servis uç noktası adresleri için GİB tarafında gerekli kontrollerin yapılması ve gerekiryorsa düzeltilmesi gerekmektedir. Sayfa her iki makineden de düzgün bir şekilde açılıyorsa test adımlarına başlanabilir.

Gönderici Birim, Merkez ve Posta Kutusu Rolleri


e-Fatura ve e-İrsaliye Uygulamasında Gönderici Birim, Merkez ve Posta Kutusu olmak üzere 3 temel rol bulunmaktadır. Bu rollerden Gönderici Birim, e-Fatura ve e-İrsaliyeyi göndermeyi, Posta Kutusu, e-Fatura ve e-İrsaliyeyi almayı, Merkez ise, Posta Kutusu ile Gönderici Birim arasındaki iletişimi sağlamaktadır.
Bu amaçla e-Fatura, e-İrsaliye Uygulamasına entegre olmak isteyen kurumlar için, Gelir İdaresi Başkanlığı tarafında iki adet kullanıcı açılır. Birisi Başkanlık bünyesinde bulunan portal kullanıcısı, diğeri ise firmanın bilgi işlem sistemi ile entegre çalışan firmanın kendisini ifade eden entegrasyon kullanıcısıdır.
Entegrasyon testleri kontrol edilirken bu iki kullanıcı arasındaki irsaliyeler dikkate alınmaktadır. Entegrasyon çalışmalarına başlayabileceği kendisine bildirilen kuruma bu iki kullanıcıya ait bilgiler Gelir İdresi Başkanlığı tarafından iletilir. Bu aşamadan sonra E-irsaliye testlerine başlanabilir.

Gelir İdaresi Başkanlığı Test Portalına Giriş


  • Entegrasyon başvurusu onaylandığında Gelir İdaresi Başkanlığı ilgili mükellef için, test amaçlı bir kullanıcı yaratır. Aşağıdaki örnekte görüldüğü gibi Gelir İdaresi Başkanlığı tarafından test kullanıcı bilgileri ve portal şifre bilgileri iletilir.



Bu kullanıcı ile, Gelir idaresinin test portalına {+}https://gbpktest.efatura.gov.tr/efatura/+[ |https://gbpktest.efatura.gov.tr/efatura/] giriş yapılabilmelidir.

  • Gelir İdaresi Başkanlığı Test Portalına giriş yapıldıktan sonra, portal üzerinden irsaliye gönderebilmek ve alabilmek için, Test Araçları>Araçlar>Kullanıcı Bilgileri "e-İrsaliye Kullanmak İstiyorum" parametresi işaretlenmelidir.





Netsis içerisinde E-İrsaliye Test Adımları


  • Bu kullanıcı bilgisinin Netsis veritabanı altında TBLEIRSCARI tablosuna e-irsaliye mükellefleri listesine manuel eklenmesi gerekmektedir. Örnek SQL cümlesi aşağıdadır.


INSERT INTO NETSIS..TBLEFIRSCARI(IDENTIFIER,ALIAS,TITLE,EFATTYPE,TARIH,PROFILEID,AKTIF) VALUES ('1111111000','urn:mail:[email protected]','LOGO TEST IRSALIYE','OZEL','2020-01-
01','0','E')

  • Bu işlemden sonra test kullanıcısının vergi numarasıyla Netsis fatura modülünde satış irsaliyesi kesmek için cari hesap kartı tanımlanması, ünvan adres ve vergi numarası bilgilerinin girilmesi gerekmektedir.



  • e-Fatura Parametrelerinde "e-İrsaliye Kullanılsın" parametresinin işaretlenmesi ve e-İrsaliye belgesi için 3 karakterlik belge birim kodu girilmelidir.




Gönderici Birim Çalışma Testleri


  • Fatura modülünden yukarıda tanımlanan test carisine satış irsaliyesi kesilip, Toplu e-İrsaliye Oluşturma ekranında taslak oluşturup, gönder işlemi ile şema ve schematron kontrolünden geçmiş onaylı e-İrsaliye içeren GIB Test Portalı' nda giriş yapılan test kullanıcı hesabına gönderilir.




  • Bu işlem sonucunda Netsis fatura modülünde e-İrsaliye İşlemleri>e-İrsaliye Giden Kutusu>Zarf Bazında Giden/İrsaliye Bazında Giden ekranlarında gönderilen e-İrsaliye ve Zarfı izlenir. Giden kutusunda sorgula işlemi mutlaka yapılmalıdır.


  • e-İrsaliye belgesi ve zarfını aldıklarına dair Gelir İdaresi ve test kullanıcı hesabından gönderilen sistem yanıtları Netsis içerisinden başarılı bir şekilde alınmalıdır. Sistem yanıtları bölümünde 2 adet sistem yanıtı görülmelidir.


  • Giden kutusunda Zarf Listesi kısmında gönderilen zarfın durum kolonunda "1300" ve Açıklama kolonunda ise, "BAŞARIYLA TAMAMLANDI" bilgisi görülmelidir.


  • Firma, Gelir İdaresi Test Portalındaki Posta Kutusu hesabına göndermiş olduğu zarfı Gelen Kutusu>Zarf Bazında Listeleme ekranından sorgulamalı ve Belge Bazında Listeleme ekranında eİrsaliyeyi görüntülemelidir.




Posta Kutusu Birim Çalışma Testleri


  • Posta kutusu testi ile, alış irsaliyesini uygun bir şekilde alınıp alınamadığı kontrol edilmektedir. Dolayısıyla bu işlemler Gelir İdaresi Test Portalı' ndan yapılmalıdır. Bu işleme öncelikle Portalın irsaliye oluştur menüsünden irsaliye oluşturularak başlanmalıdır.




  • Bu ekrandan irsaliye kaydedilirken VKN/TCKN alanına mükellefin gerçek vergi numarası (Netsis Şirket/Şube Parametre Tanımları erkanında girilen Vergi Kimlik Numarası/TC Kimlik Numarası) girilmelidir. Bunun dışında ekrandaki zorunlu alanlar girilerek e-İrsaliye oluşturulup gönderilir.


  • Portaldan gönderilen e-İrsaliye ve zarfı Netsis fatura modülünde e-İrsaliye İşlemleri>e-İrsaliye Gelen Kutusu>Zarf Bazında Gelen/İrsaliye Bazında Gelen ekranlarından izlenir. Gelen kutusunda sorgulama işlemi mutlaka yapılmalıdır.


  • Gelir İdaresi Test Portalı' ından gönderilen e-İrsaliye ve Zarfı şema, schematron ve mühür kontrolünden geçirilerek Netsis içerisine başarılı bir şekilde alınmalıdır. Gelen e-İrsaliyenin zarfının

durum kolonunda "1300" ve Açıklama kolonunda "BAŞARI İLE İŞLENDİ" ifadesi görülmelidir. Ayrıca gelen e-irsaliye ve zarfının mükellef tarafından başarılı bir şekilde alındığına dair sistem yanıtı gönderilir.

  • Firma, Gelir İdaresi Test Portalında, Gönderici Birim hesabından gönderilmiş zarfın durumunu Gelen Kutusu>Posta Kutusu Yanıtları menüsünden ilgili kayda tıklanarak görüntülemelidir.




ISS için eklenmesi gereken roles ve features listesi, ISS sunucusuna E-fatura Web Servis Kurulumu işlem adımları, SSL Sertifika Yükleme/Binding İşlemi ve e-İrsaliye sertifika tanımlama


  • E-Fatura Web Servis Kurulumu öncesinde ISS için eklenmesi gereken roles ve features listesi:


Denetim Masası>Program ekle/Kaldır/ Windows özelliklerini aç/kapat kısmından



  • ISS sunucusuna E-fatura WebServis kurulumu için işlem adımları


( örnek web servis uç noktası ➔https://efatura.besice.com.tr/Marti/NetsisEFatura/EfaturaService.asmx[ |https://efatura.besice.com.tr/Marti/NetsisEFatura/EfaturaService.asmx])


ISS sunucusunda EfaturaSetup.exe çalıştırılır. Bu işlem sırasında mali mühürün takılmasına gerek yoktur. Sonrasında default kurulum gerçekleşir. Kurulum sonrasında C:\inetpub\wwwroot altında NetsisEFatura klasörü oluşur. ISS üzerinde Default Web Site altında NetsisEFatura satırı ve ApplicationPool için NetsisEFatura adında uygulama havuzu oluşur.


  1. C:\inetpub\wwwroot altında Marti adında bir klasör oluşturulur. Webservis kurulumu ile gelen NetsisEFatura klasörü bu dizin altına taşınır.



NetsisEfatura klasörü altında bununan Web.config dosyası içerisinden ilgili database ayarları yapılır.

  1. ISS tarafına geçilir. ISS durdurulur. Default Web Site altında oluşan NetsisEFatura üzerinde Advanced Settings ekranında Application Pool olarak DefaultAppPool seçilir.


Physical path kısmında ise, C:\inetpub\wwwroot\Marti\NetsisEFatura seçilip kaydedilir.



  1. ApplicationPools a tıklanır. NetsisEFaturaPool rename edilerek MartiPool yapılır.





  1. Cmd.exe yönetici olarak çalıştırılır. C:\Windows\System32\İnetsrv> altında aşağıdaki komut çalıştırılarak mevcuttaki NetsisEFatura poolu Marti/NetsisEFatura altında oluşturulur.


appcmd set app "Default Web Site/NetsisEFatura" -path:/Marti/NetsisEfatura

  1. IIS restart edilir.
  2. Default Web Site altında oluşan Marti klasörü altındaki NetsisEFatura üzerinde advanced settings ekranında application pool olarak oluşan MartiPool seçilir.




  1. Sonrasında Marti altındaki NetsisEFatura için browse denilerek browser da gelen adresin sonuna EfaturaService.asmx yazılarak erişimin sağlanıp sağlanmadığı kontrol edilir.



  • SSL sertifika yükleme ve Binding İşlemi


ISS üzerinde Server Certificates > Complete Certificate Request işlem adımından ilgili sertifika yüklenir.
Friendly name kısmına SSL' in bağlanacağı adres bilgisi yazılır.

Daha sonra Default Web Site üstünde Bindings işlemi ile eklenen SSL sertifikası bağlanır.

Ardından web servis uç noktalarına test zarfı gönderilerek kontrol edilir.

  • e-İrsaliye Gönderimi için Sertifika Tanımlama


e-İrsaliye uygulaması e-Fatura Uygulaması için tanımlanan sertifika ayarlarını kullanmaktadır. E-irsaliye gönderimi için, Netsisin kurulu olduğu dizinde Servis Klasörü altında EFaturaAyarlar.exe dosyası yönetici olarak çalıştırılıp, Yeni Sertifika Tanımlama ekranı açılır.
!!!Bu ekran üzerinde tanımlama sırasında Mali Mühür makinaya takılı olması gerekmektedir.
!!!e-İrsaliye test süreci boyunca "Test Kullanımı" parametresi işaretli olmalıdır.