Sitenin çalışması için zorunlu çerezleri kullanıyoruz. İzin verirseniz, siteyi geliştirmek amacıyla sayfa içi tıklamalarınızı ve anonim ekran hareketi kaydını toplarız; reklamlarımızın işe yarayıp yaramadığını görmek için de Google Ads reklam ölçümü çerezlerini kullanırız: hesap açıldığı ya da “Sizi Arayalım” talebi bırakıldığı Google’a bildirilir, Google bunu kendi reklam tıklamalarıyla eşleştirir. Kayıtlarda yazdığınız metinler maskelenir; adınız, e-postanız ve telefonunuz Google’a gönderilmez. Ayrıntı: Çerez Politikası.
Cookies, visit analytics and ad measurement
We use essential cookies to run the site. With your permission, to improve the site we also collect your clicks and an anonymous recording of screen movements, and to see whether our ads work we use Google Ads measurement cookies: Google is told that an account was created or a “Call Me Back” request was left, and matches this with its own ad clicks. Text you type is masked in recordings; your name, email and phone number are never sent to Google. Details: Privacy Policy: Cookies.
e-Fatura zarfı, imzalı fatura XML’inin sıkıştırılıp içine konduğu ve GİB üzerinden alıcıya taşındığı elektronik pakettir.
Son güncelleme · 5 Kasım 2026
e-Fatura Zarfı, imzalanmış ya da mali mühürle onaylanmış fatura XML’inin ZIP ile sıkıştırılıp konduğu ve GİB üzerinden alıcının posta kutusuna taşındığı XML paketidir. GİB kılavuzlarında ZARF (StandardBusinessDocument) olarak geçer. Mektup zarfı gibi düşünebilirsiniz: içindeki belge faturadır, zarf ise onu taşıyan, göndereni ve alıcıyı gösteren kaptır.
Zarfın da kendi tekil numarası vardır. Bazı entegratör ekranlarında bu numara “zarf ETTN” ya da “zarf numarası” diye görünür; ancak faturanın ETTN’si değildir.
Zarf nasıl işler?
Gönderici birim faturayı UBL-TR biçiminde oluşturur, imzalar ya da mühürler, ZIP ile sıkıştırıp zarfa koyar ve GİB’in Merkez birimine gönderir; bu zarfın türü SENDERENVELOPE’dur.
Merkez zarfı XSD ve Schematron kontrolünden geçirir, imza ve mühür varlığını (doğrulamasını değil), gönderici ve alıcı adreslerini kontrol eder; göndericiye sistem yanıtı (SYSTEMENVELOPE) döner.
Kontrolleri geçen zarf aynen alıcının posta kutusuna iletilir; posta kutusu da kendi kontrolünü yapıp sistem yanıtı gönderir.
Ticari faturada alıcının KABUL ya da RED uygulama yanıtı ayrı bir zarfla (POSTBOXENVELOPE) satıcıya döner.
Zarfın üzerinde neler yazar?
GİB’in e-Fatura paketindeki örnek zarfın başlığında gönderenin etiketi (urn:mail:defaultgb@… biçiminde), alıcının posta kutusu etiketi (urn:mail:defaultpk@…), iki tarafın unvanı ve VKN/TCKN’si, zarfın UUID biçimindeki kendi kimlik numarası, zarf türü ve oluşturulma zamanı yer alır. Altındaki paket bölümünde içerdiği belgelerin türü ve sayısı yazılır.
Aynı örnekte zarfın kimlik numarası ile içindeki faturanın ETTN’si farklı değerlerdir. Bu yüzden faturayı ararken, iade faturasında atıf yaparken ya da muhasebe kaydında zarf numarasını değil, faturanın ETTN’sini kullanın.
Zarf durumu ne anlatır?
Entegratör ekranlarındaki zarf durumu, belgenin GİB’e ve alıcıya ulaşıp ulaşmadığını gösterir. GİB kılavuzu sistem yanıtını, fatura ya da uygulama yanıtı içeren zarfların durumlarıyla ilgili olarak birimlerden gönderilen cevap mesajı olarak tanımlar. Merkez kontrolünü geçemeyen zarf alıcının posta kutusuna iletilmez; hata ayrıntısı sistem yanıtındadır.
TicariHub zarfı kendisi göndermez; faturayı kendi entegratör hesabınıza iletir ve zarflama gönderici birim olan entegratörünüzde yapılır. Bağlantı koparsa yeniden gönderimden önce entegratöre belgenin oluşup oluşmadığı sorulur ve ETTN aynı kalır; böylece aynı sipariş için ikinci fatura oluşmaz.
Sık Sorulan Sorular
Fatura zarf numarası nedir?
Faturayı taşıyan zarfın kendi tekil kimlik numarasıdır; GİB’in örnek zarfında UUID biçimindedir. Zarfın takibi için kullanılır. Faturanın kimliği olan ETTN’den ayrı bir numaradır.
Zarf ETTN ile fatura ETTN aynı mı?
Hayır. GİB’in e-Fatura paketindeki örnekte zarfın kimlik numarası ile içindeki faturanın ETTN’si farklı değerlerdir. Faturayı bulmak, sorgulamak ya da kaydetmek için faturanın ETTN’sini kullanın.
Zarf GİB’den dönerse fatura alıcıya ulaşır mı?
Ulaşmaz. GİB kılavuzuna göre Merkez, kontrollerden geçen zarfı alıcının posta kutusuna iletir; geçemeyen zarf için göndericiye sistem yanıtı döner. Hatanın nedenini entegratörünüzün panelinde görüp düzeltmeniz gerekir.
Kaynaklar
Mevzuat değişebilir; uygulamadan önce güncel hâlini kaynaktan ya da mali müşavirinizden doğrulayın.
