Teknik Temel
GİB Referansı
GİB paketi, kullanım yöntemi, teknik gereksinimler ve resmi kaynaklar.
GİB Paketi
GİB'in yayımladığı e-Arşiv paketi; UBL-TR 1.2.1 şema tanımlarını, e-Arşiv Fatura'ya özgü ProfileID değerini, eArşiv rapor şemasını (EArsiv.xsd) ve web servis tanımını (EArsivWs.wsdl) içerir.
Kullanım Yöntemi
e-Arşiv Fatura uygulamasına dahil olmak için mükellefin (VUK 509 madde IV.2.2) önce e-Fatura uygulamasına dahil olması, e-Arşiv Fatura düzenleyebilme hazırlıklarını tamamlaması ve GİB'e başvuru yapması gerekir. Mükellefler bu süreci GİB tarafından yetkilendirilmiş Özel Entegratörler aracılığıyla ya da GİB'in e-Belge portali üzerinden yürütebilir. VBT Yazılım bu süreçte Özel Entegratör konumundadır.
Teknik Gereksinimler
Teknik gereksinimler, UBL üretimi ile GİB'e günlük yapılan eArşiv rapor bildiriminin aynı veri setinden tutarlı şekilde beslenmesini sağlar.
UBL Belge Standardı
e-Arşiv Fatura, e-Fatura ile aynı UBL 2.1 Invoice doküman tipi üzerinden ifade edilir; ayrım ProfileID alanındadır.
| Alan | Değer |
|---|---|
UBLVersionID | 2.1 |
CustomizationID | TR1.2.1 |
ProfileID | EARSIVFATURA |
Invoice tipidir; belgeyi e-Arşiv yapan ayırt edici alan ProfileID=EARSIVFATURA değeridir.Taraf Kimlik Tipleri
UBL-TR'nin PartyIdentification şema kodları bu belgede şu şekilde kullanılır:
| Taraf | SchemeId | Açıklama |
|---|---|---|
Satıcı (AccountingSupplierParty) | VKN | e-Arşiv Fatura uygulamasına dahil mükellefin vergi kimlik numarası |
Alıcı (AccountingCustomerParty) | VKN veya TCKN | e-Fatura uygulamasına kayıtlı olmayan vergi mükellefi (VKN) veya nihai tüketici (TCKN) |
INV0221 hata koduyla reddedilir. Bkz. e-Arşiv Fatura Nedir? — Teknik Kimlik.Tevkifat (Withholding Tax)
UBL şemasındaki WithholdingTaxTotal alanı, belge seviyesinde tevkifat bilgisi taşınması gereken durumlarda kullanılır. Bu alan doldurulduğunda toplamlar, LegalMonetaryTotal/PayableAmount değerindeki net ödenecek tutarla uyumlu kalmalıdır.
TaxTotal altında, tevkifat ise WithholdingTaxTotal altında taşındığında aynı ekonomik tutar iki kez düşülmemelidir; PayableAmount tek net sonucu göstermelidir.Belge Toplamları
Belge toplamları, ürün satırları, vergi alt toplamları ve varsa tevkifat alanlarının tek net ödenecek tutara bağlandığı noktadır.
GİB Rapor Alanları
Fatura imzalandıktan sonra geçerli, iptal ve itiraz kayıtları eArsivRaporu içinde toplanarak GİB'e iletilir. Rapordaki fatura elemanı (GİB e-Arşiv Teknik Kılavuzu §3.3.2), her fatura için şu alanları taşır:
| Alan | Açıklama |
|---|---|
faturaNo | Fatura numarası |
faturaUUID | Fatura ETTN'i |
faturaTip | Fatura tipi (örn. istisna) |
gonderimSekli | KAGIT veya ELEKTRONIK — sınırlandırılmış değer kümesi |
dosyaAdi | Faturanın oluşturulduğu formattaki dosya adı |
ozetDeger | Mali mühürle imzalanmış faturanın SHA-256 özet değeri (hex) |
duzenlenmeTarihi / duzenlenmeZamani | Düzenleme tarih ve saati |
toplamTutar / toplamIskonto / odenecekTutar | Vergi hariç toplam, toplam iskonto ve ödenecek tutar |
paraBirimi / dovizKuru | ISO 4217 para birimi ve TL karşılığı kur (TL faturada 1) |
imzaZamani | Faturanın imzalandığı zaman |
İptal ve İtiraz Raporu
İptal edilen faturalar için rapora ayrı bir faturaIptal elemanı, itiraz edilen faturalar için ise faturaitiraz elemanı eklenir (GİB e-Arşiv Teknik Kılavuzu §3.3.2.27, §3.3.3). Bu elemanlar, iptalin/itirazın GİB'e bildirimini taşır; iptal veya itirazın kendisi ayrı bir yasal süreçtir. Ayrıntılı durum modeli için İptal ve İtiraz Durum Takibi sayfasına bakın.
itirazYontemi alanı, 6102 sayılı Türk Ticaret Kanunu madde 18/3 uyarınca geçerli itiraz kanallarından hangisinin kullanıldığını taşır: KEP, NOTER, TELGRAF, TAAHHUTLU_MEKTUP.Resmi Kaynaklar
- VUK Genel Tebliği (Sıra No: 509) — "IV.2. e-Arşiv Fatura Uygulaması" bölümü (madde IV.2.1–IV.2.5)
- VUK Genel Tebliği (Sıra No: 589, 31/12/2025 tarih ve 33124 5. Mükerrer sayılı Resmî Gazete) — kağıt fatura tutar sınırının basit usul/işletme hesabı mükellefleri için 31/12/2026'ya uzatılması
- GİB e-Arşiv Teknik Kılavuzu V1.18 (Ağustos 2025)
- ebelge.gib.gov.tr