Page History
Netsis e-İrsaliye Entegrasyon Test Süreçleri ile ilgili ayrıntılı bilgiye bu dokümandan ulaşabilirsiniz.
Netsis e-İrsaliye Entegrasyon test Süreçleri dokümanı; Entegrasyon lisansına (Online e-İrsaliye) sahip, Entegrasyon çalışmalarına başlayacağı 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ıranın takip edilmesi gerekir:
- e-İrsaliye uygulamasından yararlanmak isteyen mükelleflerin öncelikle e-Fatura kullanıcısı olması gerekir.
- Netsis programının 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çerir.
| Info |
|---|
| Detaylı bilgi için bakınız; https://ebelge.gib.gov.tr/dosyalar/kilavuzlar/EirsaliyeUygulamasiBasvuruRehberiveKilavuzu_V1.pdfirsaliyeUygulamasiBasvuruRehberiveKilavuzu_V1.pdf tıklayınız. |
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 İrsaliye uygulamasına dahil olmak için Başkanlığa hitaben bir dilekçe ve ekinde yer alan test tanım formu ile başvurmaları gerekmektedirbaşvurması gerekir.
...
| Info |
|---|
| Test Tanım Formu |
...
| için tıklayınız. |
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ı gerekmektedirgerekir.
Entegrasyon çalışmalarına
...
başlayacağı bilgisi Başkanlık tarafından kendisine bildirilen kullanıcılar, kendi bilgi işlem sistemleri aracılığı ile e-İrsaliye gönderip
...
almaları için öncelikle sistemlerinde gerekli altyapıyı
...
oluşturmaları gerekir. Bu nedenle kullanıcıların, 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şlaması gerekir.
...
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.
...
Gelir idaresinin açıkladığı test
...
adımlarının detaylı açıklaması için tıklayınız. Dokümanın ilk 4 bölümü, ön hazırlık ve erişim testleri hakkında bilgi
...
verir. 8
...
'inci bölümde ise, Netsis uygulamasında yapılması gereken e-İrsaliye test adımları ile ilgili bilgiler
...
bulunur.
...
| Warning |
|---|
| Test adımlarına geçilmeden önce |
...
| 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 |
...
| edilmesi gerekir. Kontrol edilecek adres için tıklayınız. Bu link, her iki makineden de açıldığında aşağıdaki gibi bir sayfa ekrana 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 |
...
| gerekli düzeltmelerin sağlanması gerekir. 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ırbulunur. Bu rollerden Gönderici Birim, e; e-Fatura ve e-İrsaliyeyi İrsaliye'yi göndermeyi, Posta Kutusu, e; e-Fatura ve e-İrsaliyeyi İrsaliye'yi almayı, Merkez ise, ; Posta Kutusu ile Gönderici Birim arasındaki iletişimi sağlamaktadırsağlar.
Bu amaçla e-Fatura , ve e-İrsaliye Uygulamasına entegre olmak isteyen kurumlar için, Gelir İdaresi Başkanlığı tarafında tarafından iki adet kullanıcı açılır. Birisi Başkanlık bünyesinde bulunan portal kullanıcısı Portal Kullanıcısı, diğeri ise firmanın bilgi işlem sistemi ile entegre çalışan firmanın (Firmanın kendisini ifade eden entegrasyon kullanıcısıdır.
) Entegrasyon Kullanıcısı'dır. Entegrasyon testleri kontrol edilirken bu iki kullanıcı arasındaki irsaliyeler dikkate alınmaktadıralınır. Entegrasyon çalışmalarına başlayabileceği başlanacağı bilgisi kendisine bildirilen kuruma, bu iki kullanıcıya ait bilgiler Gelir İdresi İdaresi Başkanlığı tarafından iletilir. Bu aşamadan sonra Ee-irsaliye İrsaliye testlerine başlanabilirbaşlanır.
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. İdaresi Test Portalı'na giriş yapılır. 
Gelir İdaresi Başkanlığı Test
...
Portalı'na giriş yapıldıktan sonra
...
portal üzerinden irsaliye
...
göndermek ve
...
almak için, Test
...
Araçları → Araçlar → Kullanıcı Bilgileri →"e-İrsaliye Kullanmak İstiyorum"
...
seçeneğinin seçilmesi gerekir. 
Netsis
...
İçinde e-İrsaliye Test Adımları şunlardır:
- Bu kullanıcı Kullanıcı bilgisinin Netsis veritabanı altında TBLEIRSCARI tablosuna Tablosu'na ve e-irsaliye mükellefleri listesine manuel eklenmesi gerekmektedir. İrsaliye Mükellefleri Listesi'ne manuel (elle) eklenmesi gerekir.
Ö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 gerekmektedirFatura modülünden Satış İrsaliyesi oluşturmak için, Cari Hesap, Unvan, Adres ve Vergi Numarası bilgilerinin tanımlanması gerekir.
- e-Fatura Parametrelerinde Parametreleri ekranından "e-İrsaliye Kullanılsın" parametresinin işaretlenmesi seçilmesi ve e-İrsaliye belgesi için 3 karakterlik belge birim kodu girilmelidirüç karakterden oluşan Belge Birim Kodu bilgisinin girilmesi gerekir.
Gönderici Birim Çalışma Testleri
Fatura
...
Modülü'nden yukarıda tanımlanan test
...
cari hesabına satış irsaliyesi kesilip, "Toplu e-İrsaliye Oluşturma" ekranında taslak
...
oluşturulup, "Gönder" butonu ile şema ve schematron kontrolünden
...
geçirilen, onaylı e-İrsaliye içeren
...
ve GİB 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
...
Kutusu'nda "Sorgula" işleminin mutlaka yapılması gerekir. e-İrsaliye
...
Belgesi'ni ve Zarf'ını aldıklarına dair Gelir İdaresi ve
...
Test Kullanıcı Hesabı'ndan gönderilen sistem
...
yanıtlarının, Netsis
...
programı içinden başarılı bir şekilde
...
alınması gerekir. "Sistem
...
Yanıtları" bölümünde
...
iki adet sistem
...
yanıtının görülmesi gerekir.
...
Giden
...
Kutusu Zarf Listesi kısmında gönderilen zarfın
...
, Durum kolonunda "1300"
...
, Açıklama kolonunda ise, "BAŞARIYLA TAMAMLANDI"
...
bilgisinin görülmesi gerekir.
...
...
Firmanın, Gelir İdaresi Test
...
Portalı'ndaki Posta Kutusu hesabına göndermiş olduğu zarfı, Gelen
...
Kutusu → Zarf Bazında Listeleme ekranından
...
sorgulaması ve Belge Bazında Listeleme
...
ekranından e-İrsaliye'yi görüntülemesi gerekir.
Posta Kutusu Birim Çalışma Testleri aşağıdaki şekildedir:
- Posta kutusu testi Kutusu Testi ile, alış irsaliyesini irsaliyesinin uygun bir şekilde alınıp alınamadığı alınmadığı kontrol edilmektediredilir. Dolayısıyla Dolayısı ile bu işlemler işlemlerin Gelir İdaresi Test Portalı'ndan yapılmalıdıryapılması gerekir. Bu işleme öncelikle Portalın irsaliye oluştur , Portal'ın "İrsaliye Oluştur" menüsünden irsaliye oluşturularak başlanmalıdırbaşlanması gerekir.
- Bu ekrandan Ekrandan irsaliye kaydedilirken VKN/TCKN alanına mükellefin gerçek vergi numarası numarasının (Netsis → Şirket/Şube Parametre Tanımları erkanında girilen → Vergi Kimlik Numarası/TC T.C. Kimlik Numarası) girilmelidir. Bunun dışında ekrandaki girilmesi gerekir. Ekrandaki diğer zorunlu alanlar girilerek e-İrsaliye oluşturulup oluşturulur ve gönderilir.
- Portaldan Portal'dan gönderilen e-İrsaliye ve zarfı Zarf, Netsis fatura modülünde Fatura → e-İrsaliye İşlemleri>eİşlemleri → e-İrsaliye Gelen Kutusu>Zarf Kutusu → Zarf Bazında Gelen/İrsaliye Bazında Gelen ekranlarından izlenir. Gelen kutusunda Kutusu'nda sorgulama işlemi işleminin mutlaka yapılmalıdıryapılması gerekir.
- Gelir İdaresi Test Portalı'ından gönderilen e-İrsaliye ve Zarfı Zarf; şema, schematron ve mühür kontrolünden geçirilerek, Netsis içerisine içine başarılı bir şekilde alınmalıdıralınır. Gelen e-İrsaliyenin zarfının
...
- Durum kolonunda "1300" ve Açıklama kolonunda "BAŞARI İLE İŞLENDİ"
...
- ifadesinin görülmesi gerekir. Gelen e-
...
- İrsaliye ve
...
- Zarf'ı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, Portal'ının Gönderici Birim hesabından Hesabı'ndan, gönderilmiş zarfın durumunu Gelen Kutusu>Posta Kutusu → Posta Kutusu Yanıtları menüsünden ilgili kayda tıklanarak görüntülemelidirtıklayarak görüntüleyebilir.
ISS
...
İçin Eklenmesi Gereken Roles ve Features Listesi, ISS sunucusuna
...
e-
...
Fatura Web Servis Kurulumu
...
İçin İşlem Adımları, SSL Sertifika Yükleme/Binding İşlemi ve e-İrsaliye
...
Sertifika Tanımlama e-Fatura Web Servis Kurulumu
...
Denetim Masası>Program ekle/Kaldır/ Windows özelliklerini aç/kapat kısmından Öncesi ISS İçin Eklenmesi Gereken Roles ve Features Listesi Denetim Masası → Program Ekle/Kaldır, Windows Özelliklerini Aç/Kapat kısmından yapılır.
ISS
...
Sunucusuna e-Fatura Web Servis Kurulumu İçin İşlem Adımları şunlardır:
| Info |
|---|
Örnek Web Servis uç noktası için tıklayınız. |
- 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.
...
- İşlem sonrasında varsayılan kurulum gerçekleşir. Kurulum
...
- sonrası 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.
- C:\inetpub\wwwroot altında Marti adında bir klasör oluşturulur.
...
- Web Servis Kurulumu ile gelen NetsisEFatura klasörü bu
...
- dizinin altına taşınır.
- NetsisEfatura
...
- klasörünün altında bununan Web.config
...
- dosyasının içinden ilgili database ayarları yapılır.
- 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.
- ApplicationPools'a tıklanır. NetsisEFaturaPool
...
- ismi değiştirilerek edilerek MartiPool yapılır.
- Cmd.exe yönetici olarak çalıştırılır. C:\Windows\System32\İnetsrv> altında aşağıdaki komut çalıştırılarak
...
- mevcut NetsisEFatura poolu Marti/NetsisEFatura altında oluşturulur.
...
- appcmd set app "Default Web Site/NetsisEFatura" -path:/Marti/NetsisEfatura
...
- ISS restart edilir.
- 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.
...
- Ardından Marti altındaki NetsisEFatura için
...
- Browse denilerek
...
- ve 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 adımları aşağıdaki şekildedir:
- 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
- Default Web Site üstünde Bindings işlemi ile eklenen SSL sertifikası bağlanır.
Ardından web servis
- Web Servis uç noktalarına test zarfı gönderilerek kontrol edilir.
e-İrsaliye Gönderimi
...
İçin Sertifika Tanımlama
e-İrsaliye uygulaması Uygulaması, e-Fatura Uygulaması için tanımlanan sertifika ayarlarını kullanmaktadırkullanır. Ee-irsaliye İrsaliye gönderimi için, Netsisin Netsis'in 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
| Info |
|---|
| Tanımlama sırasında Mali Mühür |
...
| 'ün makineye takılı olması |
...
| gerekir. |
...
| Info |
|---|
e-İrsaliye |
...
Test Süresi boyunca "Test Kullanımı" |
...
parametresinin işaretli |
...
olması gerekir.
|
