Professional Documents
Culture Documents
KILAVUZU
Şubat 2023
ANKARA
GELİR İDARESİ BAŞKANLIĞI
Uygulama ve Veri Yönetimi Daire Başkanlığı (III)
Yayım
Versiyon Eklenen/Silinen/Değişen Bölüm Açıklama
Tarihi
1.0 17.02.2023 -- Kılavuzun ilk yayım tarihi
509 Sıra No.lu Vergi Usul Kanunu Genel Tebliğin “IV.1.3. e-Faturada Bulunması Gereken
Bilgiler”, “IV.2.3. e-Arşiv Faturada Bulunması Gereken Bilgiler”, “IV.3.3. e-İrsaliyede Bulunması
Gereken Bilgiler”, “IV.4.3. e-Serbest Meslek Makbuzunda Bulunması Gereken Bilgiler”, “IV.5.3.
e-Müstahsil Makbuzunda Bulunması Gereken Bilgiler”, “IV.8.3. e-Sigorta Komisyon Gider
Belgesinde Bulunması Gereken Bilgiler”, “IV.10.3. e-Döviz Alım-Satım Belgesinde Bulunması
Gereken Bilgiler” ve “IV.12.3. e-Adisyon Belgesinin Düzenlenmesi ve Belgede Bulunması
Gereken Bilgiler” başlıklı bölümlerinde “Başkanlık sistemlerinden elektronik ortamda
sorgulanması, doğrulanması ve görüntülenmesine imkân vermek üzere, Başkanlık tarafından
bilgi içeriği belirlenen karekod veya barkod (Başkanlık tarafından ebelge.gib.gov.tr adresinden
yapılan duyuruda belirtilecek tarihten itibaren).” Açıklaması yapılmış olup e-belgelerde
bulunması gereken bilgi olarak düzenlenmiştir.
Bu kapsamda işbu kılavuz e-fatura, e-arşiv fatura, e-irsaliye, e-serbest meslek makbuzu, e-
müstahsil makbuzu, e-sigorta komisyon gider belgesi, e-döviz ve kıymetli maden alım satım
belgesi ve e-adisyon belgesi olarak düzenlenen e-belgelerde yer alacak karekod alanında hangi
bilgilerin yer alacağı ve bu bilgilerin veri standartları konusunda mükelleflerimizi
bilgilendirmek amacıyla hazırlanmıştır.
e-Fatura belgesinde Karekod üzerinde bulunması gereken bilgiler ve bu bilgilerin UBL alan
adları, karekod alan adları ve kullanım açıklamaları aşağıdaki tabloda gösterilmektedir.
AccountingCustomerPar
Mükellefin 10 haneli vergi kimlik numarası.
Alıcı VKN ty/Party/PartyIdentifica “avkntckn” “PartyIdentification/ID” elemanının
tion/ID “schemeID” özelliği zorunludur.
AccountingCustomerPar
Mükellefin 11 haneli T.C. Kimlik Numarası.
Alıcı TCKN ty/Party/PartyIdentifica “avkntckn” “PartyIdentification/ID” elemanının
tion/ID “schemeID” özelliği zorunludur.
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":"TEMELFATURA",
"tip":"SATIS",
"tarih":"2022-08-17",
"no":"GIB2022000000001",
"ettn":"04e26a62-7c00-46d0-878c-6f7c60834525",
"parabirimi":"TRY",
"malhizmettoplam":"1000.00",
"kdvmatrah(8)":"1000.00",
"hesaplanankdv(8)":"80.00",
"vergidahil":"1080.00",
"odenecek":"1080.00"}
e-Arşiv fatura belgesinde Karekod üzerinde bulunması gereken bilgiler ve bu bilgilerin UBL alan
adları, karekod alan adları ve kullanım açıklamaları aşağıdaki tabloda gösterilmektedir.
AccountingSupplierPart
Mükellefin 11 haneli TC kimlik numarası.
Gönderen TCKN y/Party/PartyIdentificati “vkntckn” “PartyIdentification/ID” elemanının
on/ID “schemeID” özelliği zorunludur.
AccountingCustomerPar
Mükellefin 10 haneli vergi kimlik numarası.
Alıcı VKN ty/Party/PartyIdentifica “avkntckn” “PartyIdentification/ID” elemanının
tion/ID “schemeID” özelliği zorunludur.
Kullanılan senaryodur.
SENARYO ProfileID “senaryo”
Kullanım/Örnek: EARSIVFATURA
Bu elemanda UBL-TR içerisinde yer alan
fatura tiplerine ait kodlar yazılacaktır.
InvoiceTypeCode Kullanım/Örnek:
FATURA TİPİ “tip”
Satış/İade/Tevkifat/İstisna/Özel
Matrah/İhraç Kayıtlı/Hal Tipi Fatura Satış/Hal
Tipi Fatura Komisyoncu
Belgenin düzenlenme tarihi.
FATURA TARİHİ IssueDate “tarih”
Kullanım/Örnek: Yıl-Ay-Gün
Üç haneli alfanumerik birim kod ile 4 hanesi
belgenin düzenlendiği yılı gösteren 13 haneli
FATURA NO ID “no” müteselsil numaranın birleşiminden
meydana gelen Belge Numarası.
Kullanım/Örnek: GIB2021000000001
Evrensel Tekil Tanımlama Numarası.
ETTN UUID “ettn” Kullanım/Örnek: 534C0F4F-1064-4F9C-
AB66-84C19C741C28
Belgenin Para Birimi
Belge Para Birimi DocumentCurrencyCode “parabirimi”
Kullanım/Örnek: TRY / USD / EUR
LegalMonetary/LineExte
Mal Hizmet Tutarı “malhizmettoplam” Mal Hizmet Toplam Tutar
nsionAmount
Mal Hizmet KDV
TaxTotal/TaxSubTotal/T
“kdvmatrah()” Mal Hizmet KDV Matrahı
Matrahı axableAmount
Hesaplanan KDV Tutarı TaxTotal/TaxAmount “hesaplanankdv ()” Hesaplanan KDV Toplam Tutar
LegalMonetary/TaxInclu
Vergi Dahil Toplam
“vergidahil” Vergiler Dahil Toplam Tutar
Tutar siveAmount
LegalMonetary/Payable
Ödenecek Tutar “odenecek” Ödenecek Tutar
Amount
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":"EARSIVFATURA",
"tip":"SATIS",
"tarih":"2022-08-17",
"no":"GIB2022000000011",
"ettn":"04e26a62-7c00-45d0-968c-6f7c60834525",
"parabirimi":"TRY",
"kdvmatrah(8)":"500.00",
"hesaplanankdv (8)":"40.00",
"vergidahil":"540.00",
"odenecek":"540.00"}
e-İrsaliye belgesinde Karekod üzerinde bulunması gereken bilgiler ve bu bilgilerin UBL alan
adları, karekod alan adları ve kullanım açıklamaları aşağıdaki tabloda gösterilmektedir.
Shipment/Delivery/Carr
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":"TEMELIRSALIYE",
"tip":"SEVK",
"tarih":"2022-08-17",
"no":"IRS2022000000001",
"ettn":"04e35a51-7c00-45d0-968c-6f7c60834525",
"sevktarihi":"2022-08-17",
"sevkzamani":"09:32:13",
"tasiyicivkn":"1111111111",
"plaka":"06AA0606"}
e-SMM belgesinde Karekod üzerinde bulunması gereken bilgiler ve bu bilgilerin adları, karekod
alan adları ve kullanım açıklamaları aşağıdaki tabloda gösterilmektedir.
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"tarih":"2022-08-17",
"no":"GIB2022000000001",
"ettn":"05e37a73-8c10-46d0-878c-6f7c60834525",
"parabirimi":"TRY",
"brutucret":"1000.00",
"tahsilkdv":"90.00",
"kdvtevkifat":"90.00",
"gvstopaj":"200.00",
"kdvtutari":"180.00",
"netucret":"800.00",
"tahsilat":"890.00"}
AccountingSupplierPart
Mükellefin 11 haneli TC kimlik numarası.
GönderenTCKN y/Party/PartyIdentificati “vkntckn” “PartyIdentification/ID” elemanının
on/ID “schemeID” özelliği zorunludur.
AccountingCustomerPar
Mükellefin 10 haneli vergi kimlik numarası.
AlıcıVKN ty/Party/PartyIdentifica “avkntckn” “PartyIdentification/ID” elemanının
tion/ID “schemeID” özelliği zorunludur.
AccountingCustomerPar
Mükellefin 11 haneli TC kimlik numarası.
AlıcıTCKN ty/Party/PartyIdentifica “avkntckn” “PartyIdentification/ID” elemanının
tion/ID “schemeID” özelliği zorunludur.
Kullanılan senaryodur.
SENARYO ProfileID “senaryo”
Kullanım/Örnek: EARSIVBELGE
Bu elemanda UBL-TR içerisinde yer alan
TİPİ CreditNoteTypeCode “tip” fatura tiplerine ait kodlar yazılacaktır.
Kullanım/Örnek: MUHTAHSILMAKBUZU
Belgenin düzenlenme tarihi.
BELGE TARİHİ IssueDate “tarih”
Kullanım/Örnek: Yıl-Ay-Gün
Üç haneli alfanumerik birim kod ile 4 hanesi
belgenin düzenlendiği yılı gösteren 13 haneli
BELGE NO ID “no” müteselsil numaranın birleşiminden
meydana gelen Belge Numarası.
Kullanım/Örnek: GIB2021000000001
Evrensel Tekil Tanımlama Numarası.
ETTN UUID “ettn” Kullanım/Örnek: 534C0F4F-1064-4F9C-
AB66-84C19C741C28
Belgenin Para Birimi
Belge Para Birimi DocumentCurrencyCode “parabirimi”
Kullanım/Örnek: TRY / USD / EUR
Mal Hizmet Toplam LegalMonetaryTotal/Lin
“malhizmettoplam” Mal Hizmet Toplam Tutarı
Tutarı eExtensionAmount
TaxTotal/TaxSubTotal/T
GV Stopaj Tutarı “gvstopaj” Gelir Vergisi Stopaj Toplam Tutarı
axAmount
TaxTotal/TaxSubTotal/T
Mera Fonu Ücreti “merafonu” Mera Fonu Toplam Tutarı
axAmount
TaxTotal/TaxSubTotal/T
Borsa Tescil Ücreti “borsatescilucreti” Borsa Tescil Ücreti Toplam Tutarı
axAmount
Hesaplanan SGK Prim TaxTotal/TaxSubTotal/T
"sgkprimkesintisi" Hesaplanan SGK Prim Kesintisi
Kesintisi axAmount
LegalMonetaryTotal/Pa
Ödenecek Tutar “odenecek” Ödenecek Tutar
yableAmount
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":"EARSIVBELGE",
"tip":"MUHTAHSILMAKBUZU",
"tarih":"2022-08-17",
"no":"GIB2022000000001",
"ettn":"04e35a62-7c00-45d0-968c-6f7c60834525",
"parabirimi":"TRY",
"malhizmettoplam":"5000.00",
"gvstopaj":"200.00",
"merafonu":"100.00",
"borsatescilucreti":92.00",
"sgkprimkesintisi":"100.00",
"odenecek":"4508.00"}
Kullanılan senaryodur.
SENARYO ProfileID “senaryo”
Kullanım/Örnek: EARSIVFATURA
"avkntckn": "1234567890",
"senaryo": "EARSIVBELGE",
"tip": "SIGORTAKOMISYONGIDERBELGESI",
"tarih": "2022-03-17",
"no": "GIB2022000000001",
"ettn": "7ef629d7-5fea-4102-86d4-6620c963b071",
"parabirimi": "TRY",
"istihsalkomisyon": "50",
"iptalkomisyon": "40",
"toplamkomisyon": "10" }
e-Döviz ve Kıymetli Maden Alım Satım belgesinde Karekod üzerinde bulunması gereken bilgiler
ve bu bilgilerin UBL alan adları, karekod alan adları ve kullanım açıklamaları aşağıdaki tabloda
gösterilmektedir.
EDOVIZBELGE Senaryosunda;
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":"EDOVIZBELGE",
"tip":"ALIM",
"tarih":"2022-08-17",
"no":"GIB2022000000001",
"ettn":"04e26a62-7c00-46d0-878c-6f7c60834525",
"miktari(EUR)":"100.00",
"uygulanankur":"18.6543",
"dovizkarsiligi":"98.00",
"tlkarsiligi":"1865.43",
"ödenecek(TRY)":"1865.43"}
EKIYMETLIMADENBELGE Senaryosunda;
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":" EKIYMETLIMADENBELGE",
"tip":"ALIM",
"tarih":"2022-08-17",
"no":"GIB2022000000001",
"ettn":"04e26a62-7c00-46d0-878c-6f7c60834525",
"miktari(22C_XAU)":"5",
"birimfiyat":" 1754.38596",
"ödenecek(TRY)":"8775.00"}
e-Adisyon belgesinde Karekod üzerinde bulunması gereken bilgiler ve bu bilgilerin UBL alan
adları, karekod alan adları ve kullanım açıklamaları aşağıdaki tabloda gösterilmektedir.
{"vkntckn":"1111111111",
"avkntckn":"1111111111",
"senaryo":"EARSIVBELGE",
"tip":"ADISYON",
"tarih":"2022-08-17",
"no":"GIB2022000000001",
"ettn":"04e26a62-7c00-46d0-878c-6f7c60834525",
"ödenecek(TRY)":"1080.00"}