e ArsivKilavuzu v1.0

e-Ariv Klavuzu Mart 2014

Versiyon : 1.0 1/28

ELEKTRONK ARV KILAVUZU

Mart 2014

ANKARA


Versiyon : 1.0 2/28

GELR DARES BAKANLII

Denetim ve Uyum Ynetimi Daire Bakanl


Versiyon : 1.0 3/28

Versiyon Yaym Tarihi

Eklenen/Silinen/Deien Blm

Aklama

1.0 25.03.2014 -- Klavuzun ilk yaym tarihi


Versiyon : 1.0 4/28

1 Giri ......................................................................................................................... 7

2 e-Ariv Raporu Veri Format.................................................................................... 8

3 Elektronik Ariv Raporu ........................................................................................... 9

3.1 XSD Gsterimi .............................................................................................. 9

3.2 Elektronik Ariv Raporu Elemanlar-Genel ................................................... 9

3.3 Elektronik Ariv Raporu Elemanlar-Detay ................................................. 10

3.3.1 baslik ...................................................................................................... 10

3.3.1.1 versiyon ............................................................................................. 10

3.3.1.2 mukellef ............................................................................................ 11

3.3.1.3 hazirlayan .......................................................................................... 11

3.3.1.4 raporNo ............................................................................................. 11

3.3.1.5 donemBaslangicTarihi ...................................................................... 11

3.3.1.6 donemBitisTarihi ............................................................................... 12

3.3.1.7 bolumBaslangicTarihi........................................................................ 12

3.3.1.8 bolumBitisTarihi ................................................................................ 12

3.3.1.9 bolumNo ........................................................................................... 12

3.3.1.10 Signature ...................................................................................... 12

3.3.2 fatura ..................................................................................................... 13

3.3.2.1 faturaNo ............................................................................................ 13

3.3.2.2 gonderimSekli ................................................................................... 14

3.3.2.3 dosyaAdi ........................................................................................... 14

3.3.2.4 ozetDeger.......................................................................................... 14

3.3.2.5 duzenlenmeTarihi ............................................................................. 14

3.3.2.6 duzenlenmeZamani .......................................................................... 15

3.3.2.7 toplamTutar ...................................................................................... 15


Versiyon : 1.0 5/28

3.3.2.8 odenecekTutar .................................................................................. 15

3.3.2.9 paraBirimi ......................................................................................... 15

3.3.2.10 vergiBilgisi .................................................................................... 16

3.3.2.11 vergilerToplami ............................................................................ 16

3.3.2.12 vergi.............................................................................................. 16

3.3.2.13 tevkifat ......................................................................................... 17

3.3.2.14 aliciBilgileri ................................................................................... 17

3.3.2.14.1 tuzelKisi ........................................................................................ 17

3.3.2.14.2 gercekKisi ..................................................................................... 18

3.3.2.14.3 tesisatNumarasi ........................................................................... 18

3.3.2.14.4 internetSatisBilgi .......................................................................... 18

3.3.2.14.5 webAdresi .................................................................................... 19

3.3.2.14.6 odemeSekli ................................................................................... 19

3.3.2.14.7 odemeAracisiAdi .......................................................................... 19

3.3.2.14.8 odemeTarihi ................................................................................. 19

3.3.2.14.9 gonderiBilgileri ............................................................................. 20

3.3.2.15 ynOkcFisBilgisi .............................................................................. 20

3.3.3 faturaIptal .............................................................................................. 21

3.3.3.1 faturaNo ............................................................................................ 21

3.3.3.2 iptalTarihi .......................................................................................... 21

3.3.3.3 toplamTutar ...................................................................................... 22

4 Elektronik Ariv Raporunun Hazrlanmas............................................................. 22

5 Elektronik Ariv Raporlarnn Bakanlk Sistemine Aktarm ................................. 22

6 e-Ariv Fatura Standard ....................................................................................... 24

7 e-Ariv zni Alan zel Entegratrlerin Hizmet Verdii Mkelleflerin Bildirimi ..... 25


Versiyon : 1.0 6/28

8 Sistem Bilgi/Hata Kodlar ...................................................................................... 26

9 Test ve Onay .......................................................................................................... 27


Versiyon : 1.0 7/28

1 Giri 433 sra numaral Vergi Usul Kanunu Genel Teblii ile getirilen Elektronik Ariv

Uygulamas kapsamnda faturalarn ve e-Ariv Raporunun oluturulmas, mali mhr

veya NES ile zaman damgal ekilde imzalanmas ve oluturulan raporlarn Bakanlk

sistemine aktarlmas sreleri bu klavuzda aklanmtr.

Klavuzda yer alan aklamalarn anlalabilmesi iin XML (eXtensible Markup

Language-Geniletilebilir aretleme Dili) ve ad geen dier kavramlar hakknda

temel dzeyde bilgi sahibi olunmas gerekmektedir.

Klavuzlarda verilen rnekler, ema yapsnda yer alan elemanlarn kullanmn eklini

gsterme amacyla hazrlanm olup, mkelleflerin hazrlayaca raporlarda

elemanlarn kullanm bakmndan balayc deildir.

Uygulama kapsamnda dzenlenen faturalara ilikin raporlarn Bakanlk sistemine

aktarm muhafaza ve ibraz devlerini ortadan kaldrmamaktadr.


Versiyon : 1.0 8/28

2 e-Ariv Raporu Veri Format Elektronik Ariv Uygulamas kapsamnda retilen belgelere ilikin belli bilgilerin aylk

rapor eklinde oluturulmas, rapor formatnda bulunan elemanlarn kullanm

eklinin aklanmas, XSD ( XML Schema Definition- XML ema Gsterimi) gsterimi,

elemanlarn tanmlanmas, kardinaliteleri ve rnek kullanmlarnn gsterimi bu

blmde aklanmtr.

e-Ariv Paketi ierisinde yer alan aylk rapora ilikin her bir eleman aklanrken

aadaki tablo yaps kullanlmtr.

[Eleman: Ad] [Eleman: Tanm]

Kardinalite Bu blmde elemann kardinalitesi sunulmaktadr. Kardinaliteler aadaki ekilde olabilir: Zorunlu(1): Eleman zorunlu ve mutlaka bir tane bulunmak zorundadr. Zorunlu(1..n): Eleman zorunlu ve en az bir tane bulunmak zorundadr. Eleman birden fazla tekrarlayabilir. Seimli(0..1): Eleman seimlidir ve en ok bir tane bulunabilir. Seimli(0..n): Eleman seimlidir ve birden fazla tekrarlayabilir.

Aklama Elemann ne amala kullanld bu blmde aklanmaktadr.

Kullanm Elemann nasl kullanlaca, dier elemanlar arasndaki ilikiler, elemann veri tipi, elemandaki kstlar detayl olarak bu blmde aklanr.

rnek Eleman iin bir veya daha ok XML rnei bu blmde sunulmaktadr.


Versiyon : 1.0 9/28

3 Elektronik Ariv Raporu

3.1 XSD Gsterimi

e-Ariv paketinde yer alan rapor belgesine ait XSD emasnn ana elemanlarnn

gsterimi aadaki gibidir.

3.2 Elektronik Ariv Raporu Elemanlar-Genel

eArsivRaporu belgesine ait XSD emasnda yer alan ana elemanlarn ieriine ilikin

aklamalar, aadaki tabloda yer almaktadr.

No Eleman Ad erik

1 baslik Rapora ait balk verileri

2 fatura Fatura verileri

3 faturaIptal ptal edilmi faturaya ait veriler

Tabloda yer alan ana elemanlarn her birine ait aklamalar izleyen blmde

yaplacaktr. Aklama yntemi olarak ncelikle elemann ad, aklamas, kullanm

ekli ve rneklere yer verilecektir.


Versiyon : 1.0 10/28

3.3 Elektronik Ariv Raporu Elemanlar-Detay

3.3.1 baslik

baslik Balk

Diyagram

Kardinalite Zorunlu (1)

Aklama Bu eleman, balk bilgilerinin tand gruptur.

3.3.1.1 versiyon

Version Versiyon Numaras

Kardinalite Zorunlu(1)

Aklama Rapor belgesinin versiyon numaras yazlacaktr. Bu deer 1.0 dr.

Kullanm 1.0

rnek 1.0



3.3.1.2 mukellef

mukellef Mkellef


Aklama Raporun sahibi mkellefin VKN ya da TCKN'sinin yazlaca alandr. Gerek/Tzel durumuna gre seilmelidir.

Kullanm Nmerik

rnek 9999999999 ya da 99999999999

3.3.1.3 hazirlayan

hazirlayan Hazrlayan


Aklama Raporu hazrlayan mkellefin kendisi ise kendi VKN ya da TCKN'sinin, zel entegratr ise zel entegratrn VKNsinin yazlaca alandr. Gerek veya Tzel kiilik durumuna gre seilmelidir.

Kullanm Nmerik

rnek 9999999999 ya da 99999999999

3.3.1.4 raporNo

raporNo Rapor Numaras


Aklama Rapor numaras tekil olan GUID formatnda olmaldr. Byk-kk harf duyarll bulunmaktadr.

Kullanm Alfa nmerik

rnek 229ABF7D-16EF-498A-8FCE-0CAC221459CC

3.3.1.5 donemBaslangicTarihi

donemBaslangicTarihi Dnem Balang Tarihi


Aklama e-Ariv Raporunun dnem balang tarihi yazlmaldr.

Kullanm Yl-Ay-Gn (YYYY-AA-GG)

rnek 2013-08-01



3.3.1.6 donemBitisTarihi

donemBitisTarihi Dnem Biti Tarihi


Aklama e-Ariv Raporunun dnem biti tarihi yazlmaldr.


rnek 2013-08-07

3.3.1.7 bolumBaslangicTarihi

bolumBaslangicTarihi Blm Balang Tarihi


Aklama Bu elemana ariv dosyasnn birden ok blme ayrlmas halinde ilgili blmn balang tarihi yazlacaktr. Tek blm ise dnem balang tarih ile ayn olacaktr.


rnek 2013-08-01

3.3.1.8 bolumBitisTarihi

bolumBitisTarihi Blm Biti Tarihi


Aklama Bu elemana ariv dosyas blmlere ayrldysa ilgili blmn biti tarihi yazlacaktr. Tek blm ise dnem biti tarih ile ayn olacaktr.


rnek 2013-08-01

3.3.1.9 bolumNo

bolumNo Blm Numaras


Aklama Bu elemana ariv dosyas blmlere ayrldysa ilgili blmn blm numaras yazlacaktr. Tek blm ise 1 yazlacaktr.

Kullanm Nmerik

rnek 1

3.3.1.10 Signature

Signature mza Bilgisi


Aklama Bu elemanda XADES-A imza bilgisi yer alacaktr.



3.3.2 fatura

fatura Fatura

Diyagram

Kardinalite Zorunlu (0..n)

Aklama Bu eleman fatura zet bilgilerinin tand elemandr.

3.3.2.1 faturaNo

faturaNo Fatura Numaras


Aklama Bu elemana fatura numaras yazlacaktr.

Kullanm Alfa nmerik

rnek CDE2013000000001



3.3.2.2 gonderimSekli

gonderimSekli Gnderim ekli


Aklama

Bu elemana faturann gnderim ekli yazlmaldr. Aadaki deerleri almak zorundadr. KAGIT ELEKTRONIK

Kullanm Snrlandrlm

rnek KAGIT

3.3.2.3 dosyaAdi

dosyaAdi Dosya Ad


Aklama Bu elemana faturann oluturulduu formattaki dosya ad yazlacaktr.

Kullanm fatura.pdf

rnek fatura.pdf

3.3.2.4 ozetDeger

ozetDeger zet Deer


Aklama Bu elemana mali mhrle ya da nitelikli elektronik sertifika ile zaman damgal olarak imzalanm faturann SHA-256 hash deeri yazlacaktr.

Kullanm Hex formatnda olmaldr.

rnek 688787d8ff144c502c7f5cffaafe2cc588d86079f9de88304c26b0cb99ce91c6

3.3.2.5 duzenlenmeTarihi

duzenlemeTarihi Dzenleme Tarihi


Aklama Bu elemana faturann dzenleme tarihi yazlacaktr.


rnek 2013-08-01



3.3.2.6 duzenlenmeZamani

duzenlemeZamani Dzenleme Zaman


Aklama Bu elemana faturann dzenleme zaman yazlacaktr.

Kullanm Saat:Dakika:Saniye (SS-DD-SnSn)

rnek 14:20:00

3.3.2.7 toplamTutar

toplamTutar Fatura Toplam Tutar


Aklama Bu elemana faturann vergi hari toplam tutar girilecektir.

Kullanm Nmerik

rnek 1500

3.3.2.8 odenecekTutar

odenecekTutar Fatura denecek Tutar


Aklama Bu elemana faturann denecek tutar girilecektir.

Kullanm Nmerik

rnek 1500

3.3.2.9 paraBirimi

paraBirimi Fatura Para Birimi


Aklama Bu elemana faturada kullanlacak para birimi girilmelidir. ISO 4217 Standardndan alnmaldr.

Kullanm Alfanmerik

rnek TRY



3.3.2.10 vergiBilgisi

vergiBilgisi Vergi Bilgisi

Diyagram


Aklama Bu elemana faturann vergi bilgileri girilecektir.

3.3.2.11 vergilerToplami

vergilerToplami Vergiler Toplam


Aklama Bu elemanda faturadaki vergilerin genel toplam yazlacaktr.

Kullanm Nmerik

rnek 300

3.3.2.12 vergi

vergi Vergi Bilgileri

Kardinalite Zorunlu (1..n)

Aklama Bu elemanda vergi kodu, tutar, oran ve matrah bilgileri bulunacaktr. Vergi kodu olarak e-Fatura Uygulamas Kod Listeleri dokmanndaki kodlar kullanlmaldr.

Kullanm matrah, zorunlu(1) : Vergi matrah vergiKodu, zorunlu(1) : Verginin kodu vergiTutari, zorunlu(1) : Vergi tutar vergiOrani, seimli(0..1) : Vergi oran

rnek 1000 0015 180 18



3.3.2.13 tevkifat

tevkifat Tevkifat Bilgileri

Kardinalite Seimli (0..n)

Aklama

Bu elemanda tevkifat ile ilgili tevkifat kodu, tutar, oran bilgileri bulunacaktr. Tevkifat kodu alanna nternet Vergi Dairesi Beyanname Dzenleme Programnda yaynlanan kodlardan ilgili olan yazlmaldr. Bu elemana ayrca, Gelir ve Kurumlar Vergisi kapsamnda yaplan stopaj bilgileri de muhtasar beyannamede yaynlanan deme tr kodlar kullanlarak yazlacaktr.

Kullanm tevkifatKodu, zorunlu(1) : Tevkifat kodu tevkifatTutar, zorunlu(1) : Tevkifat tutari tevkifatOrani, zorunlu(1) : Tevkifat oran

rnek 410 36 20

3.3.2.14 aliciBilgileri

aliciBigileri Alc Bilgileri

Diyagram


Aklama

Bu elemanda faturann alcsna ait bilgilere yer verilecektir. Alcnn tzel kii ya da gerek kii olmasna gre bilgilerin yazmna dikkat edilmelidir.

3.3.2.14.1 tuzelKisi

tuzelKisi Tuzel Kii

Kardinalite Seimli (0..1)

Aklama Alc, tzel kii ise ilgili bilgiler yazlmaldr.

Kullanm vkn: Vergi kimlik numaras unvan: Tzel kii unvan



3.3.2.14.2 gercekKisi

gercekKisi Gerek Kii


Aklama Alc, gerek kii ise ilgili bilgiler yazlmaldr.

Kullanm tckn: Vatandalk numaras adiSoyadi: Ad soyad yazlacaktr.

3.3.2.14.3 tesisatNumarasi

tesisatNumarasi tesisatNumarasi


Aklama

Telefon, gsm, elektrik, su, gaz, internet, televizyon abonelii gibi abonelik esasna gre fatura dzenleyen mkelleflerin mterileri adna tahsis ettikleri tesisat, hizmet veya hat numaralarn bu alana yazmalar zorunludur. nemli Not: Bu eleman ema kurallar gerei seimlik olarak kullanlmaktadr. Abone faturas dzenleyenler bu alana doru bilgileri yazmakla ykmldr.

Kullanm

3.3.2.14.4 internetSatisBilgi

internetSatisBilgi nternet Sat Bilgileri

Diyagram


Aklama

nternet zerinden gerekletirilen satlara ait faturalarda bu gruba ait elemanlara gerekli bilgilerin yazlmas zorunludur. nemli Not: Bu eleman ema kurallar gerei seimlik olarak kullanlmaktadr. 433 no.lu Vergi Usul Kanunu Genel Teblii uyarnca; nternet zerinden sat yapanlar, bu alana doru bilgileri yazmakla ykmldr.



3.3.2.14.5 webAdresi

webAdresi Web Adresi


Aklama Bu elemana al veri yaplan web sitesinin adresi yazlacaktr.

Kullanm Alfa nmerik

rnek http://www.abcdefg.com.tr

3.3.2.14.6 odemeSekli

odemeSekli deme ekli


Aklama

Bu elemana deme ekli yazlmaldr. Deer olarak KREDIKARTI/BANKAKARTI, EFT/HAVALE KAPIDAODEME ODEMEARACISI DIGER - "Bu alana aklama girilmelidir" deerlerini alabilir. DIGER seildiinde yaplan deme ekli mutlaka yazlmaldr.

Kullanm Snrlandrlm

rnek KREDIKARTI/BANKAKARTI DIGER deme ynteminin ad

3.3.2.14.7 odemeAracisiAdi

odemeAracisiAdi deme Aracs Ad


Aklama rn bedeli bir deme platformu ya da deme aracs zerinden tahsil ediliyorsa bu platformun ya da aracnn ad veya unvan yazlacaktr.

Kullanm Serbest metin

rnek XYXdeme platformu

3.3.2.14.8 odemeTarihi

odemeTarihi deme Tarihi


Aklama Bu elemana demenin yapld tarih yazlmaldr


rnek 2013-08-01



3.3.2.14.9 gonderiBilgileri

gonderiBilgileri Gnderi Bilgileri

Diyagram


Kullanm

gonderimTarihi, zorunlu(1) : Bu elemana gnderinin yapld veya sata konu hizmetin ifa edildii tarih Yl-Ay-Gn (YYYY-AA-GG) formatnda yazlmaldr. gonderiTasiyan, zorunlu(1) : Gnderi tayana ait bilgiler yazlacaktr.

Aklama

Bu elemana rnn alcya gnderildii tarih ve tayc bilgileri yazlmaldr. rn mkellefin kendisi tarafndan alcya teslim ediliyorsa kendisine ait bilgiler yazlacaktr. Kargo veya Lojistik kurumu ile tama yaptrlyorsa bu kurumun bilgileri yazlacaktr.

rnek

2013-08-05 9999999999 XYZ Kargo A..

3.3.2.15 ynOkcFisBilgisi

ynOkcFisBilgisi Yeni Nesil deme Kaydedici Cihaz Fi Bilgisi

Diyagram


Aklama

3100 sayl Kanun ve 426 sra numaral Vergi Usul Kanunu Genel Teblii kapsamnda yaplan dzenlemelere uygun olarak deme kaydedici cihazlardan (yeni nesil dhil) bilgi fii dzenlenmesi halinde; (satn yazarkasadan yaplmas ve elektronik ortamda iletilen e-ariv faturas ile belgelendirme durumu)

Fatura dzenleme srecinin bir paras olan bilgi fiinde yer alan yukardaki bilgilerin bu elemanda gsterilmesi zorunludur.



Bilgi fiinde yer alan ve bu elemanda gsterilen okcSeriNo, zNo, fisNo ve fisTarih bilgileri ait olduu fatura zerinde de mutlaka gsterilmelidir.

Kullanm okcSeriNo, zorunlu(1) : 12 haneli Cihaz Seri No zNo, zorunlu(1) : Z Numaras fisNo, zorunlu(1) : Bilgi Fii Numaras fisTarih, zorunlu(1) : Bilgi Fiinin Tarihi

rnek AS0000031178 34 2 2014-01-26

3.3.3 faturaIptal

faturaIptal Fatura ptal

Diyagram

Kardinalite Seimli (0..n)

Aklama Bu elemana dzenlendikten sonra eitli nedenlerle iptal edilen faturalara ait bilgiler yazlacaktr.

3.3.3.1 faturaNo

faturaNo Fatura No


Aklama Bu elemana iptal edilen faturann numaras yazlacaktr.

Kullanm Alfa nmerik

rnek FGH2013000000001

3.3.3.2 iptalTarihi

iptalTarihi ptal Tarihi


Aklama Bu elemana iptal edilen faturann tarihi yazlacaktr.


rnek 2013-09-02



3.3.3.3 toplamTutar

toplamTutar Fatura Toplam Tutar


Aklama Bu elemana iptal edilen faturann vergi hari toplam tutar girilecektir.

Kullanm Nmerik

rnek 2000

4 Elektronik Ariv Raporunun Hazrlanmas Elektronik Ariv raporu aylk olarak bu klavuzun 3.3 maddesindeki bilgilere ve klavuz

ekindeki emada belirtilen standartlara gre hazrlanmal ve XADES-A standard

kullanlarak mali mhr ile imzalanmaldr.

5 Elektronik Ariv Raporlarnn Bakanlk Sistemine Aktarm

e-Ariv izni alan mkellefler ve e-ariv hizmeti verme konusunda Bakanlktan izin

alan zel entegratrler, elektronik ortamda oluturduklar belgelere ilikin olarak,

Bakanln www.efatura.gov.tr internet adresinde yaymlanan veri format ve

standardna uygun e-Ariv Raporunu aylk olarak oluturup takip eden ayn 15 nci

gn saat 24:00a kadar bu klavuzda belirlenen yntemle Bakanlk sistemine

aktaracaklardr. Raporlar, aktarm sresi ierisinde mali mhr ya da NES ile zaman

damgal olarak onaylanmak zorundadr.

Gnderim web servis zerinden salanacaktr. Bakanln belirledii web servis

tanmlar dorultusunda e-ariv izni alan mkellef veya e-ariv hizmeti veren izin

alm zel entegratr, verileri gndermek iin e-ariv rapor web servis istemcisi

hazrlayacaktr. Web servis tanm e-ariv paketinde belirtilen wsdl tanmnda

mevcuttur. Sz konusu wsdle mkellefler, ayrca

https://test.efatura.gov.tr/earsiv/services/EArsivWsPort?wsdl adresinden

ulaabilecektir. e-Ariv izni alanlar gnderim IP'sini Bakanla bildireceklerdir.



Bakanlktan e-ariv hizmeti verme iin izin alan zel entegratrler e-fatura

platformu HR-XML bildirimi ile hizmet verdikleri mkellefleri Bakanlk sistemine

bildireceklerdir.

Gnderim servisinde sendDocumentFile ve getBatchStatus olmak zere iki metot

bulunmaktadr. sendDocumentFile metodu, UUID formatnda olmas gereken dosya

ismini ve gnderilmesi gereken dosyann DataHandler'n alr. Gnderilmesi gereken

dosya ziplenmi olmaldr. Zip dosyas iinde ayn isimde XML dosyas bulunmaldr.

Zipli dosyann ak boyutu en fazla 100Mb olmaldr. Eer bu boyutu geiyorsa rapor

blnmelidir. Bu XML http://www.efatura.gov.tr adresinde yaynlanan eArsiv

paketindeki eArsiv.xsd emasna gre hazrlanmaldr. getBatchStatus metodu, input

parametresi olarak paket ID almaktadr. Paketin durumunu sorgularken

kullanlmaldr.

Webservis gvenlii, WSS kullanlarak SOAP mesajndaki TimeStamp ve Body bloklar

mali mhr ya da NES ile imzalanarak salanmaldr. Headerdaki imza alannn

signature key identifier' DirectReference olmaldr. mzann canonicalization metod

algoritmas "http://www.ws.org/2001/10/xml-exc-c14n#" olmas tavisye edilir.

Signature metod algoritmas "http://www.w3.org/2001/04/xmldsig-more#rsa-

sha256" olmaldr.

zel entegratrlerden e-ariv hizmeti alan mkellefler, istemeleri halinde izin alm

baka zel entegratre gei yapabilirler. Bu gei ay sonu itibariyle yaplabilir.

Eer byle bir gei planlanyorsa, mkellefin o ayn paketlerini blmeden bulunduu

zel entegratrle tamamn gnderip, yeni ayda yeni zel entegratrle paketlerini

gndermeye devam etmesi gerekmektedir.



6 e-Ariv Fatura Standard Kullanlan elektronik belge format, zerinde mali mhr/NES tamaya, belge

zerinde dorulamaya, grntlemeye, istenen ilenebilir veri formatn tamaya ve

kt bask almaya imkn veren genel tannrla sahip bir format olmaldr.

e-Ariv uygulamasna geen mkellefler, e-ariv kapsamnda dzenledikleri

faturalarda e-fatura uygulamasnda kullandklar birim kodlardan farkl birim kodlar

belirleyerek kullanacaklardr.

zin alan mkellefler ve zel entegratrler internet zerinden yaplan satlar iin

sadece bu satlara zg, dier satlardan ayr birim kod veya kodlar belirleyerek

fatura numaras yapsnda kullanmaldr.

e-Ariv kapsamnda elektronik olarak gnderilecek fatura ilenebilir veri olarak XML

veri tamaldr. XML verinin iinde en az aadaki alanlar bulunmaldr.

Fatura No

Dzenleme Tarihi

Dzenleyen VKN/TCKN

Alc VKN/TCKN

denecek Tutar

Varsa faturann son deme tarihi



XML verinin ema detay (faturaOzet.xsd) e-ariv paketide mevcuttur.

Fatura format olarak UBL-TR fatura format kullanlyorsa, ek XML veri tanmasna

gerek yoktur. Faturann alcya elektronik ortamda iletilmesi durumunda ileti

mesajnda UBL-TR formatnn grntlenmesinin, imza/mhr dorulamasnn ve

gerektiinde kat kt alnmasnn(internet zerinden yaplan satta mal iadesi

durumu gibi) nasl yaplacana dair bilgi verilmeli, alc Bakanln

www.efatura.gov.tr adresinden sunduu e-fatura grntleme arac hakknda

bilgilendirilmelidir.

Bu veriler ariv imza standard kullanlarak mali mhr/ NES ile imzalanmaldr.

7 e-Ariv zni Alan zel Entegratrlerin Hizmet Verdii Mkelleflerin Bildirimi

e-Ariv hizmeti vermek iin izin alan zel entegratrler, e-ariv hizmeti verdikleri

mkellefleri hizmet vermeye balamadan nce Bakanla bildirmek zorundadrlar.

Bildirim, e-Fatura Uygulamas zel Entegrasyon Klavuzunun 5. maddesinde geen

zel Entegratr Tarafndan Mkellef Bilgisi Aktarm kurallarna uygun ekilde

yaplacaktr. e-Ariv bildirimi iin zarf iindeki Identifier alanna earchive yazlmaldr.

e-Ariv hizmeti vermek iin izin alacak zel entegratrle kullanc bildirime ve silme

testlerinden gemelidirler.



8 Sistem Bilgi/Hata Kodlar

KOD AIKLAMA

getBatchStatus

15 Paket ilenmeye baland

150 Ayn Paket ID

151 Dosya okunamad

152 Zip dosyas alamad

153 Pakette birden fazla dosya var

154 mza dorulanamad

155 Balk XML validasyon hatas aklamas

156 Uyumsuz dokman versiyon tipi

157 XML validasyon hatas aklamas

158 Balk paket ID ile paket adlandrlmas uyumsuz

159 mza bulunamad

160 XML veritaban yazm hatas

161 Okuma hatas

162 Veritaban hatas

163 Sistem hatas

164 Pakette dosya yok

165 Max dosya boyutu hatas



166 stek imzas ve paket imzas uyumuyor

167 mza sahibi ile hazrlayan VKN/TCKN uyumuyor

sendDocument

000 Dosya Kaydedildi

001 Gnderici imza yetkisi yok

002 Attachment null olamaz

003 Paket ID bo olamaz

004 Paket daha nceden gnderilmi

005 Paket dosyas bo olamaz

006 Dosya bulunamad + (Aklama)

007 IO Error

008 Error

9 Test ve Onay e-Ariv izni almak isteyen mkelleflerin ve zel entegratrlerin, bu klavuzda

anlatld ekilde, test ortamndaki e-arsiv webservis metotlarn sorunsuz bir ekilde

kullanabiliyor olmas gerekmektedir. Servisleri sorunsuz bir ekilde kullanabilen

mkellefin/zel entegratrn, durumunu Gelir daresi Bakanlna bildirmesi ve

gerek ortama gei talep etmesi gerekmektedir. Gelir daresi Bakanlnca, onay

talep eden mkellefin/zel entegratrn e-Arsiv Webservis kullanm verileri, fatura

ve rapor rnekleri incelenir,(rnekler, Teblide ve bu klavuzlarda istenen tm

bilgileri kapsayacak nitelikte olmaldr) sorun tekil eden bir durum yok ise yaz ile izin

verilerek gerek ortamda yetkilendirme yaplacaktr.



Test ortam https://test.efatura.gov.tr/earsiv/services/EArsivWsPort adresi

zerinden mkelleflerin eriimine sunulmutur.

Documents

e ArsivKilavuzu v1.0