View
37
Download
3
Category
Preview:
DESCRIPTION
e ArsivKilavuzu v1.0
Citation preview
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 1/28
ELEKTRONK ARV KILAVUZU
Mart 2014
ANKARA
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 2/28
GELR DARES BAKANLII
Denetim ve Uyum Ynetimi Daire Bakanl
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 3/28
Versiyon Yaym Tarihi
Eklenen/Silinen/Deien Blm
Aklama
1.0 25.03.2014 -- Klavuzun ilk yaym tarihi
e-Ariv Klavuzu Mart 2014
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
e-Ariv Klavuzu Mart 2014
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
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 6/28
8 Sistem Bilgi/Hata Kodlar ...................................................................................... 26
9 Test ve Onay .......................................................................................................... 27
e-Ariv Klavuzu Mart 2014
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.
e-Ariv Klavuzu Mart 2014
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.
e-Ariv Klavuzu Mart 2014
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.
e-Ariv Klavuzu Mart 2014
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
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 11/28
3.3.1.2 mukellef
mukellef Mkellef
Kardinalite Zorunlu(1)
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
Kardinalite Zorunlu(1)
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
Kardinalite Zorunlu(1)
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
Kardinalite Zorunlu (1)
Aklama e-Ariv Raporunun dnem balang tarihi yazlmaldr.
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-08-01
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 12/28
3.3.1.6 donemBitisTarihi
donemBitisTarihi Dnem Biti Tarihi
Kardinalite Zorunlu (1)
Aklama e-Ariv Raporunun dnem biti tarihi yazlmaldr.
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-08-07
3.3.1.7 bolumBaslangicTarihi
bolumBaslangicTarihi Blm Balang Tarihi
Kardinalite Zorunlu (1)
Aklama Bu elemana ariv dosyasnn birden ok blme ayrlmas halinde ilgili blmn balang tarihi yazlacaktr. Tek blm ise dnem balang tarih ile ayn olacaktr.
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-08-01
3.3.1.8 bolumBitisTarihi
bolumBitisTarihi Blm Biti Tarihi
Kardinalite Zorunlu (1)
Aklama Bu elemana ariv dosyas blmlere ayrldysa ilgili blmn biti tarihi yazlacaktr. Tek blm ise dnem biti tarih ile ayn olacaktr.
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-08-01
3.3.1.9 bolumNo
bolumNo Blm Numaras
Kardinalite Zorunlu (1)
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
Kardinalite Zorunlu (1)
Aklama Bu elemanda XADES-A imza bilgisi yer alacaktr.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 13/28
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
Kardinalite Zorunlu (1)
Aklama Bu elemana fatura numaras yazlacaktr.
Kullanm Alfa nmerik
rnek CDE2013000000001
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 14/28
3.3.2.2 gonderimSekli
gonderimSekli Gnderim ekli
Kardinalite Zorunlu (1)
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
Kardinalite Zorunlu (1)
Aklama Bu elemana faturann oluturulduu formattaki dosya ad yazlacaktr.
Kullanm fatura.pdf
rnek fatura.pdf
3.3.2.4 ozetDeger
ozetDeger zet Deer
Kardinalite Zorunlu (1)
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
Kardinalite Zorunlu (1)
Aklama Bu elemana faturann dzenleme tarihi yazlacaktr.
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-08-01
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 15/28
3.3.2.6 duzenlenmeZamani
duzenlemeZamani Dzenleme Zaman
Kardinalite Zorunlu (1)
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
Kardinalite Zorunlu (1)
Aklama Bu elemana faturann vergi hari toplam tutar girilecektir.
Kullanm Nmerik
rnek 1500
3.3.2.8 odenecekTutar
odenecekTutar Fatura denecek Tutar
Kardinalite Zorunlu (1)
Aklama Bu elemana faturann denecek tutar girilecektir.
Kullanm Nmerik
rnek 1500
3.3.2.9 paraBirimi
paraBirimi Fatura Para Birimi
Kardinalite Zorunlu (1)
Aklama Bu elemana faturada kullanlacak para birimi girilmelidir. ISO 4217 Standardndan alnmaldr.
Kullanm Alfanmerik
rnek TRY
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 16/28
3.3.2.10 vergiBilgisi
vergiBilgisi Vergi Bilgisi
Diyagram
Kardinalite Zorunlu (1)
Aklama Bu elemana faturann vergi bilgileri girilecektir.
3.3.2.11 vergilerToplami
vergilerToplami Vergiler Toplam
Kardinalite Zorunlu (1)
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
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 17/28
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
Kardinalite Zorunlu (1)
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
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 18/28
3.3.2.14.2 gercekKisi
gercekKisi Gerek Kii
Kardinalite Seimli (0..1)
Aklama Alc, gerek kii ise ilgili bilgiler yazlmaldr.
Kullanm tckn: Vatandalk numaras adiSoyadi: Ad soyad yazlacaktr.
3.3.2.14.3 tesisatNumarasi
tesisatNumarasi tesisatNumarasi
Kardinalite Seimli (0..1)
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
Kardinalite Seimli (0..1)
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.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 19/28
3.3.2.14.5 webAdresi
webAdresi Web Adresi
Kardinalite Zorunlu (1)
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
Kardinalite Zorunlu (1)
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
Kardinalite Seimli (0..1)
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
Kardinalite Zorunlu (1)
Aklama Bu elemana demenin yapld tarih yazlmaldr
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-08-01
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 20/28
3.3.2.14.9 gonderiBilgileri
gonderiBilgileri Gnderi Bilgileri
Diyagram
Kardinalite Seimli (0..1)
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
Kardinalite Seimli (0..1)
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.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 21/28
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
Kardinalite Zorunlu (1)
Aklama Bu elemana iptal edilen faturann numaras yazlacaktr.
Kullanm Alfa nmerik
rnek FGH2013000000001
3.3.3.2 iptalTarihi
iptalTarihi ptal Tarihi
Kardinalite Zorunlu (1)
Aklama Bu elemana iptal edilen faturann tarihi yazlacaktr.
Kullanm Yl-Ay-Gn (YYYY-AA-GG)
rnek 2013-09-02
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 22/28
3.3.3.3 toplamTutar
toplamTutar Fatura Toplam Tutar
Kardinalite Zorunlu (1)
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.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 23/28
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.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 24/28
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
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 25/28
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.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 26/28
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
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 27/28
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.
e-Ariv Klavuzu Mart 2014
Versiyon : 1.0 28/28
Test ortam https://test.efatura.gov.tr/earsiv/services/EArsivWsPort adresi
zerinden mkelleflerin eriimine sunulmutur.
Recommended