Bilet Raporu Havayolları Teknik Kılavuzu yayınlanmıştır !
-
Upload
crs-soft-yazilim-hizmetleri-as -
Category
Software
-
view
251 -
download
2
Transcript of Bilet Raporu Havayolları Teknik Kılavuzu yayınlanmıştır !
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 1 / 26
HAVAYOLU ELEKTRONİK BİLET
RAPORU
Nisan 2016
ANKARA
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 2 / 26
GELİR İDARESİ BAŞKANLIĞI
Uygulama ve Veri Yönetimi Daire Başkanlığı
(I)
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 3 / 26
Versiyon Yayım Tarihi Eklenen/Silinen/Değişen Bölüm
Açıklama
1.0 06.04.2016 Kılavuzun ilk yayım tarihi
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 4 / 26
1 Giriş ............................................................................................................................. 5
2 Elektronik Bilet Veri Formatı ....................................................................................... 6
2.1 XSD Gösterimi ...................................................................................................... 6
2.2 Elektronik Bilet Raporu Elemanları .......................................................................... 8
2.3 Elektronik Bilet Raporu Elemanları-Detay ............................................................... 8
2.3.1 gonderen ........................................................................................................... 8
2.3.2 baslangicTarihi .................................................................................................. 9
2.3.3 bitisTarihi .......................................................................................................... 9
2.3.4 versiyon ............................................................................................................. 9
2.3.5 uuid ................................................................................................................. 10
2.3.6 Signature ......................................................................................................... 10
2.3.7 biletNo ............................................................................................................. 13
2.3.8 belgeTip ........................................................................................................... 13
2.3.9 ozetDeger ........................................................................................................ 14
2.3.10 duzenlemeTarihi ........................................................................................... 14
2.3.11 odemeSekli .................................................................................................... 14
2.3.12 tutar .............................................................................................................. 15
2.3.13 kdv ................................................................................................................. 16
2.3.14 giderGosteren ............................................................................................... 16
2.3.15 hizmetinNevi ................................................................................................. 16
2.3.16 referanslar ..................................................................................................... 17
3 Elektronik Bilet Raporunun Hazırlanması ............................................................ 18
4 Elektronik Bilet Raporu Paketinin Başkanlığa Yüklenmesi ................................... 22
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 5 / 26
1 Giriş
Bu kılavuz, 462 Sıra No.lu Vergi Usul Kanunu Genel Tebliğinin1 10 uncu bölümünde
belirtilen elektronik bilet raporlarının, belirlenen veri formatı ve standardına uygun
olarak hazırlanması ve ilgili raporun Gelir İdaresi Başkanlığı sistemine yüklenmesi
süreçlerini açıklamak amacıyla hazırlanmıştır.
Kılavuzlarda yer alan açıklamaların anlaşılabilmesi için XML (eXtensible Markup
Language - Genişletilebilir İşaretleme Dili) ve ilgili diğer kavramlar hakkında temel
düzeyde bilgi sahibi olunması gerekmektedir.
Kılavuzlarda verilen örnekler, şema yapısında yer alan elemanların kullanımını ifade
etmek amacıyla hazırlanmış örnek niteliğinde olup raporlamada elemanların
kullanımı bakımından bağlayıcı değildir.
Elektronik biletlere ilişkin raporların ilgili kurallara göre hazırlanıp Başkanlık sistemine
iletilmiş olması, elektronik biletlerin muhafazası ve ibrazı ödevlerini ortadan
kaldırmamaktadır.
1 25.12.2015 tarih ve 29573 sayılı Resmi Gazetede yayımlanmıştır .
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 6 / 26
2 Elektronik Bilet Veri Formatı
Elektronik Bilet Uygulaması kapsamında üretilen elektronik biletlere ait belli bilgilerin
günlük rapor şeklinde oluşturulması, rapor formatında bulunan elemanların kullanım
şeklinin açıklanması, XSD (XML Schema Definition- XML Şema Gösterimi),
elemanlarının tanımlaması, kardinaliteleri hakkında bilgi verilmesi ve örnek kullanım
şekillerinin gösterilmesi bu bölümde açıklanmıştır.
Bu bölümde e-Bilet paketinde yer alan e-bilet raporuna ilişkin her bir
eleman açıklanırken aşağıdaki tablo yapısı kullanılmıştır.
[Eleman: Adı] [Eleman: Tanımı]
Diyagram Bu satırda anlatılan elemanın diyagramı sunulmaktadır.
Kardinalite Bu bölümde elemanın kardinalitesi sunulmaktadır. Kardinaliteler aşağıdaki şekilde olabilir: Zorunlu(1): Eleman zorunlu ve mutlaka bir tane bulunmak zorundadır. Zorunlu(1..n): Eleman zorunlu ve en az bir tane bulunmak zorundadır. Eleman birden fazla tekrarlayabilir. Seçimli(0..1): Eleman seçimlidir ve en çok bir tane bulunabilir. Seçimli(0..n): Eleman seçimlidir ve birden fazla tekrarlayabilir.
Açıklama Elemanın ne amaçla kullanıldığı bu bölümde açıklanmaktadır.
Kullanım Elemanın nasıl kullanılacağı, diğer elemanlar arasındaki ilişkiler, elemanın veri tipi, elemandaki kısıtlar detaylı olarak bu bölümde açıklanır.
Örnek Eleman için bir veya daha çok XML örneği bu bölümde sunulmaktadır.
Şekil 1 Tablo Yapısı
2.1 XSD Gösterimi
Elektronik bilet raporunun ana elemanlarını raporun başlık bilgilerinin gösterildiği
“baslik” elemanı, düzenlenen biletlere ait bilgilerin gösterildiği “bilet” elemanı ve
düzenlendikten sonra iptal edilen biletlere ait bilgilerin gösterildiği “biletIptal”
elemanı oluşturmaktadır. e-Bilet paketinde yer alan e-Bilet raporuna ait XSD
şemasının elemanlarının gösterimi aşağıdaki gibidir.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 7 / 26
Şekil 2 Elektronik Bilet Raporu XML Şema Gösterimi
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 8 / 26
2.2 Elektronik Bilet Raporu Elemanları
Elektronik bilet raporuna ait XSD şemasında yer alan elemanların içeriğine ilişkin
açıklamalar, aşağıdaki tabloda yer almaktadır.
No Eleman Adı İçerik
baslik
1 gonderen Raporu Gönderen Mükellef
2 baslangicTarihi Raporun Başlangıç Tarihi
3 bitisTarihi Raporun Bitiş Tarihi
4 version Raporun Versiyon Numarası
5 uuid Evrensel Tekil Tanımlama Numarası (GUID Formatı)
6 Signature Mali Mühür veya Güvenli Elektronik İmza
bilet
7 biletNo Bilet Numarası
8 belgeTip Belge Tipi
9 ozetDeger Biletin Hash Değeri
10 duzenlemeTarihi Raporun Düzenlenme Tarihi
11 odemeSekli Biletin Ödeme Şekli
12 tutar Bilet Tutarı
13 kdv Katma Değer Vergisi
14 giderGosteren Bilet Tutarını Gider/İndirim Gösterecek Mükellef
15 hizmetinNevi Yapılan işin konusunu oluşturan hizmet.
16 referanslar Referanslar
Tabloda yer alan ana elemanların her birine ait açıklamalar izleyen bölümde
yapılacaktır. Açıklama yöntemi olarak öncelikle elemanın adı, açıklaması, kullanım
şekli ve örneklere yer verilmiştir.
2.3 Elektronik Bilet Raporu Elemanları-Detay
2.3.1 gonderen
gonderen Raporu Gönderen Mükellef
Diyagram
Kardinalite Zorunlu(1)
Açıklama Raporu gönderen mükellefe ait vergi kimlik numarası(vkn) veya T.C.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 9 / 26
kimlik numarası(tckn) bu elemana ait alt elemanlara yazılacaktır.
Kullanım vkn: Vergi kimlik numarası tckn: Türkiye Cumhuriyeti kimlik numarası
Örnek <ebilet:vkn>1234567890</ebilet:vkn>
2.3.2 baslangicTarihi
baslangicTarihi Raporun Başlangıç Tarihi
Diyagram
Kardinalite Zorunlu(1)
Açıklama Bu elemana raporlama döneminin başlangıç tarihi yazılacaktır.
Kullanım Yıl-Ay-Gün (YYYY-AA-GG)
Örnek <ebilet:baslangicTarihi>2012-06-12</ebilet:baslangicTarihi>
2.3.3 bitisTarihi
bitisTarihi Raporun Bitiş Tarihi
Diyagram
Kardinalite Zorunlu (1)
Açıklama Bu elemana raporlama döneminin bitiş tarihi yazılacaktır.
Kullanım Yıl-Ay-Gün (YYYY-AA-GG)
Örnek <ebilet:bitisTarihi>2012-06-12</ebilet:bitisTarihi>
2.3.4 versiyon
versiyon Versiyon Numarası
Diyagram
Kardinalite Zorunlu(1)
Açıklama Rapor belgesinin versiyon numarası yazılacaktır.Bu değer “1.0” dır.
Kullanım 1.0
Örnek <ebilet:versiyon>1.0</ebilet:versiyon>
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 10 / 26
2.3.5 uuid
UUID Evrensel Tekil Tanımlama Numarası
Diyagram
Kardinalite Zorunlu (1)
Açıklama
Evrensel Tekil Tanımlama Numarası (ETTN), düzenlenen raporun evrensel eşsizliğini sağlayan numaradır. Bu numara rapor düzenleyen tarafından standartlara uygun olarak üretilip kullanılacaktır.
Kullanım GUID formatı
Örnek <ebilet:uuid>8FB13EBF-C958-4C8E-8E0F-317332AD7610</ebilet:uuid>
2.3.6 Signature
Imza Mali Mühür / e-İmza
Diyagram
Kardinalite
Zorunlu (1)
Açıklama
Bu elemanda Mali Mühür veya e-İmza bilgileri bulunacaktır.
Kullanım
XAdES-A yöntemi “enveloped” tekniği XML imza kullanılacaktır.
Örnek <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="Signature-Id-41680bba-b1a0-41f5-87af-de2250ebadc0"> <ds:SignedInfo> <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/> <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/> <ds:Reference Id="Reference-Id-cb2c1da0-0de5-49a0-8778-f391e873293e" Type="http://uri.etsi.org/01903#SignedProperties" URI="#Signed-
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 11 / 26
Properties-Id-96b4cbe4-149c-4c28-90f7-dc43a84991b5"> <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> <ds:DigestValue>C4WuLAfOmdj4KhUsbg44IkPR8UkR8orV94vorf9j05ymo=</ds:DigestValue> </ds:Reference> <ds:Reference Id="Reference-Id-81918a67-c8fb-447d-b0a2-3f8f61851d9f" URI=""> <ds:Transforms> <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/> </ds:Transforms> <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> <ds:DigestValue>ScGsLp5vRyEWCJgE44m6V0hlcMRD6a9AQg8kpDR88CLfY=</ds:DigestValue> </ds:Reference> </ds:SignedInfo> <ds:SignatureValue Id="Signature-Value-Id-b951fc24-0cfa-4bb8-9465-8a7672f68fd2">hqifxObNgr8Lw2MNiPYOwegMrLtoaa9tPlZ8+GQzNS0QSmIr/m15NeuY9FJ8H5w6GuPp8sso+DsL IoGbzHqPRd6FOYVAbE5txd+fa16Ude88PA==</ds:SignatureValue> <ds:KeyInfo> <ds:X509Data> <ds:X509Certificate>MIDFwjUg=</ds:X509Certificate> <ds:X509SubjectName>CN=AAA Sanayi Ve Ticaret Limited Şirketi,SERIALNUMBER=1234567808</ds:X509SubjectName> </ds:X509Data> <ds:KeyValue> <ds:RSAKeyValue> <ds:Modulus>AK+j38G+K2h7exToribCo6Udh1K6Lju0LZ3WuPeP2kIdlLEbWwhugVfJqR11VYyt9TBk2i47iKxT 6vnLdMkdyVLw5XHhw66gRKICxXGUjvZt1wTY2wj7zAfasuUtRivddUgqLxDV8BgRb9WI7Ll2ABhi rKpuJ3Nn4Cn/NSTDh3JrLWiriRIdUNZkIyfN+qwBC/aSN8s3ToMhwcK7LO7F9SQlLqFn+Dm MGyxokzDQ0NNC9XryQjf4AEk1eG9EPR1WUMNOmo3jzY5PCkSG4LPQbXXG8ArXsAMVRPh6/+W0yub KkSaZB9VJGTAa0d6tQlS2AZ3EOASUIncr3F3cZs=</ds:Modulus> <ds:Exponent>AQAB</ds:Exponent> </ds:RSAKeyValue> </ds:KeyValue> <ds:KeyValue> <ds:RSAKeyValue> <ds:Modulus>AK+j38G+K2h7exToribCo6Udh1K6Lju0LZ3WuPeP2kIdlLEbWwhugVfJqR11VYyt9TBk2i47iKxT
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 12 / 26
6vnLdMkdyVLw5XHhw66gRKICxXGUjvZt1wTY2wj7zAfasuUtRivddUgqLxDV8BgRb9WI7Ll2ABhi rKpuJ3Nn4Cn/NSTDh3JrLWirir/L5caIdUNZkIyfN+qWwBC/aSN8s3ToMhwcK7LO7F9SQlLqFn+Dm MGyxokzDQ0NNC9XryQjf4AEk1eG9EPR1WUMNOmo3jzY5PCkSG4LPQbXXG8ArXsAMVRPh6/+W0yub KkSaZB9VJGTAa0d6tQlS2AZ3EOASUIncr3F3cZs=</ds:Modulus> <ds:Exponent>AQAB</ds:Exponent> </ds:RSAKeyValue> </ds:KeyValue> </ds:KeyInfo> <ds:Object Id="Object-Id-a6671048-92ee-4616-9949-454938dc015e"> <xades:QualifyingProperties Target="#Signature-Id-41680bba-b1a0-41f5-87af-de2250ebadc0"> <xades:SignedProperties Id="Signed-Properties-Id-96b4cbe4-149c-4c28-90f7-dc43a84991b5"> <xades:SignedSignatureProperties> <xades:SigningTime>2016-02-22T15:34:29.624+03:00</xades:SigningTime> <xades:SigningCertificate> <xades:Cert> <xades:CertDigest> <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/> <ds:DigestValue>Q+Bm9AueWrRIfLjiwR8UZh2YLqd/UlEI1lwUa58lzcw=</ds:DigestValue> </xades:CertDigest> <xades:IssuerSerial> <ds:X509IssuerName>CN=Mali Mühür Elektronik Sertifika Hizmet Sağlayıcısı - Sürüm 1,C=TR</ds:X509IssuerName> <ds:X509SerialNumber>846427923105653</ds:X509SerialNumber> </xades:IssuerSerial> </xades:Cert> </xades:SigningCertificate> <xades:SignerRole> <xades:ClaimedRoles> <xades:ClaimedRole>Supplier</xades:ClaimedRole> </xades:ClaimedRoles> </xades:SignerRole> </xades:SignedSignatureProperties> <xades:SignedDataObjectProperties> <xades:DataObjectFormat ObjectReference="#Reference-Id-81918a67-c8fb-447d-b0a2-3f8f61851d9f"> <xades:MimeType>text/xml</xades:MimeType> </xades:DataObjectFormat> </xades:SignedDataObjectProperties> </xades:SignedProperties>
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 13 / 26
<xades:UnsignedProperties> <xades:UnsignedSignatureProperties> <xades:SignatureTimeStamp Id="SignatureTimeStamp-Id-08dc2c86-7e78-4445-86a2-35fda3eedb9c"> <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments"/> <xades:EncapsulatedTimeStamp>MIIKTAYJKbWwSbEhk6eSxj4Ir+w7mrfghki8YIlbauhVVtvHFWSKX34R43BNCIWk87 PwVpeuZVGmVSDYplEb4GBQiH</xades:EncapsulatedTimeStamp> </xades:SignatureTimeStamp> </xades:UnsignedSignatureProperties> </xades:UnsignedProperties> </xades:QualifyingProperties> </ds:Object> </ds:Signature>
2.3.7 biletNo
biletNo Bilet Numarası
Diyagram
Kardinalite Zorunlu(1)
Açıklama
Hava yolu ile yurt içi veya yurt dışı yolcu taşımacılığı işi ile iştigal eden mükellefler ise elektronik ortamda düzenleyecekleri biletlerde, seri-sıra numarası yerine üç haneli birim kod ve on haneli sıra numarası olmak üzere toplam on üç haneden oluşan belge numarasını kullanacaklardır. Birim kodu, belgeyi düzenleyecek birim için belirlenecek alfa nümerik bir koddur.
Kullanım Alfanumerik
Örnek <ebilet:biletNo>AAA0000000001/ebilet:biletNo>
2.3.8 belgeTip
belgeTip Belge Tipi
Diyagram
Kardinalite Seçimlik (0..1)
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 14 / 26
Açıklama Zorunludur..
Kullanım “SATIS” , “IADE”
Örnek <ebilet:belgeTip>SATIS</ebilet:belgeTip>
2.3.9 ozetDeger
ozetDeger Biletin Özet Değeri
Diyagram
Kardinalite Zorunlu (1)
Açıklama Düzenlenen mali mühür veya elektronik imza ile imzalanmış e-biletin özet değeri (hash değeri) bu elemana yazılacaktır. Özet değer SHA256 algoritmasına göre oluşturulmalıdır.
Kullanım Base64
Örnek <ebilet:ozetDeger>22b995cb7c58a3c4d0629c185efb7bb2f37b074a66cd21c66fac74999740b1de</ebilet:ozetDeger>
2.3.10 duzenlemeTarihi
duzenlemeTarihi Biletin Düzenleme Tarihi
Diyagram
Kardinalite Zorunlu (1)
Açıklama Bu elemana elektronik biletin düzenleme tarihi yazılacaktır.
Kullanım Yıl-Ay-Gün (YYYY-AA-GG)
Örnek <ebilet:duzenlenmeTarihi>2012-06-12</ebilet:duzenlenmeTarihi>
2.3.11 odemeSekli
odemeSekli Ödeme Şekli
Diyagram
Kardinalite Zorunlu (1)
Açıklama Bu elemana biletin ödeme türüne uygun değer yazılacaktır. Bu değerler banka kartı, bedelsiz, kredi kartı, puan, mahsup, mahsup puan, nakit, pass, promosyon, ulaşım kartı ve diğerdir.
Kullanım "BANKAKARTI","BEDELSIZ","KREDIKARTI","PUAN", "MAHSUP",
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 15 / 26
"MAHSUPPUAN",”NAKIT","PASS","PROMOSYON","MİL",”COKLU”,"ULASIMKARTI”,"DIGER"
Örnek <ebilet:odemeSekli>NAKIT</ebilet:odemeSekli>
2.3.12 tutar
Tutar Bilet Tutarı
Diyagram
Kardinalite Seçimli(0..1)
Açıklama
Bu elemana KDV hariç bilet bedeli yazılacaktır.
TL kullanılmadığı takdirde opsiyonel olan paraBirim ve kur niteliği kullanılmalıdır. Bu niteliklerle bilet tutarının TL karşılığı bulunacaktır.
Nitelikler ile ilgili açıklamalar aşağıdadır.
paraBirim: Tutar kısmı TL'den farklı bir değer ise girilmelidir. ISO 4217 Para Birimi Kod Listesinden değerler girilmelidir. Değer girilmediği takdirde tutar TL olarak kabul edilecektir. ISO 4217 Para Birimi Kod Listesinden değerler girilmelidir. 1
kur: Tutar kısmı TL'den farklı bir değer ise biletin düzenlendiği andaki hesaplana kur bilgisi yazılmalıdır. Yabancı para birimi ile kesilen biletler için bu niteliğin girilmesi zorunludur.
Kullanım Numerik
Örnek Örnek 1: <ebilet:tutar>30</ebilet:tutar>
Örnek 2: <ebilet:tutar paraBirim=”USD” kur="2.89">30</ebilet:tutar> bilet tutarı TL olarak 30*2.89=86,7 TL olarak bulunacaktır.
1 http://www.unece.org/uncefact/codelist/standard/ISO_ISO3AlphaCurrencyCode_20100407.xsd
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 16 / 26
2.3.13 kdv
Kdv Katma Değer Vergisi
Diyagram
Kardinalite Zorunlu (1)
Açıklama Bu elemana Katma Değer Vergisi tutarı yazılacaktır.
Kullanım Numerik
Örnek <ebilet:kdv>5.40</ebilet:kdv>
2.3.14 giderGosteren
giderGosteren Gider/İndirim Gösterecek Mükellef
Diyagram
Kardinalite Seçimlik (0..1)
Açıklama Bu elemanda bilet bedelini gider gösterecek veya indirime konu edecek mükellefe ait vkn, tckn bilgileri yazılacaktır.
Kullanım vkn: vergi kimlik numarası tckn: Türkiye Cumhuriyeti kimlik numarası
Örnek <ebilet:giderGosteren> <ebilet:vkn>1234567890</ebilet:vkn> </ebilet:giderGosteren>
2.3.15 hizmetinNevi
hizmetinNevi Yapılan işin konusunu oluşturan hizmet.
Diyagram
Kardinalite Seçimlik (0..1)
Açıklama Bu alana yapılan işin konusunu oluşturan hizmetin türü ve açıklaması yazılacaktır.
Kullanım tur: hizmetin türüne uygun olan değerlerden biri (SEYAHAT, BAGAJ,
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 17 / 26
CEZA, IPTALDEGISIKLIKTAZMINATI, CEZA, YEMEK, KOLTUKSECIMI, DIGER) aciklama: hizmetin açıklaması Tür olarak DIGER alanı yazılmışsa açıklama alanı boş olamaz.
Örnek <ebilet:hizmetinNevi> <ebilet:tur>SEYAHAT</ebilet:tur> <ebilet:aciklama>Seyahat hizmeti alınmıştır</ebilet:aciklama> </ebilet:hizmetinNevi >
2.3.16 referanslar
Referanslar Referanslar
Diyagram
Kardinalite Seçimlik (0..1)
Açıklama Bilet ile ilişkili bilet/belge referansları girilecektir Referanslar alanı havayolu taşımacılığında bilet tipi iade ise girilmesi gereklidir.
Kullanım No: referans olan önceki bilet/belge numarası yazılacaktır. Aciklama: Belgenin açıklaması yazılacaktır.
Örnek <ebilet:referans> <ebilet:no>1234567890</ebilet:no> <ebilet:aciklama>Açıklama</ebilet:aciklama> </ebilet:referans>
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 18 / 26
3 Elektronik Bilet Raporunun Hazırlanması
Elektronik Bilet Raporu XML dosyası, Elektronik Bilet Raporu Veri Formatı
bölümünde anlatılan kurallara uygun olarak oluşturulmalıdır.
Elektronik Bilet Raporu XML dosyası, UTF-8 dil kodlaması ile oluşturulmalıdır.
XML dosyası <?xml version="1.0" encoding="UTF-8"?> ile başlamalıdır.
Elektronik Bilet Raporu XML dosyasının “ebilet:baslik” elamanı içerisindeki
“ds:Signature” elemanı Elektronik Bilet Raporu XML dosyasının imza veya
mali mühür bilgilerini içermelidir.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 19 / 26
Mühürleme veya imzalama işleminde asgari olarak XAdES-A yöntemi
kullanılmalıdır. İstenilmesi durumunda XAdES-T, XAdES-A gibi daha çok bilgi
içeren yöntemler kullanabilirler. XAdES imzalama “enveloped” yöntemi ile
olmalıdır. İmzalama işlemi zaman damgalı olarak yapılmalıdır.
Elektronik Bilet Uygulaması kapsamında Başkanlığa gönderilecek dosyalara
Paket denilmektedir. Elektronik Bilet Raporu XML dosyasının ZIP formatı ile
sıkıştırılması sonucunda Paket elde edilecektir. ZIP dosyası içinde aynı isimde
XML formatında elektronik bilet raporu bulunmalıdır. ZIPlenmiş dosyanın
boyutu en fazla 5 MB olmalıdır.
Paketlerin isimlendirilmesinde Gelir İdaresi Başkanlığının ön gördüğü standart
kullanılmalıdır. Bu standart VKN/TCKN-YYYYAA-EB-000000.zip şeklindedir.
VKN vergi kimlik numarasını, TCKN Türkiye Cumhuriyeti Kimlik Numarasını,
YYYY yıl bilgisini, AA ay bilgisini, EB elektronik bilet kısaltmasını temsil
etmektedir. Dosya isimlendirmede kullanılan VKN/TCKN elektronik bileti
kanunen düzenlemekte olan kuruma ait olmalıdır. Bu isimlendirme
standartlarına uygun olarak oluşturulmamış elektronik bilet paketleri kabul
edilmeyecektir. Şekil 3’te öngörülen standarda uygun olarak oluşturulmuş bir
paket örneği verilmiştir:
Şekil 3 Paket Adlandırması
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 20 / 26
Elektronik bilet raporu Gelir İdaresi Başkanlığının ön gördüğü hususlar dikkate
alınarak bölünebilmekte, parçalı yüklenebilmektedir. Parçalı yükleme tercih
edilmeyecekse dosya ismi VKN/TCKN-YYYYAA-EB-000000.zip şekilde
olmalıdır. Parçalı yükleme tercih edilecekse dosya isimlendirmeleri aşağıdaki
şekilde olmalıdır.
VKN/TCKN-YYYYAA-EB-000001.zip
VKN/TCKN-YYYYAA-EB-000002. zip
.
.
.
.
Örneğin: 1234567890-201512-EB-000001. zip
1234567890-201512-EB-000002. Zip
Bu isimlendirme standartlarının dışındaki elektronik bilet raporu paketleri
kabul edilmeyecektir. Aynı ayda hem 000000 ile biten paket hem de 000001
ile biten paket gönderilmesine izin verilmez. Parçalı yüklemelerde bir önceki
parça gönderilmeden bir sonraki parçanın gönderilmesine izin verilmez.
Örneğin: 1234567890-201512-EB-000001.zip dosyası GIB’e gönderilmeden
1234567890-201512-EB-000002.zip dosyasının gönderilmesine izin verilmez.
Yeni tebliğe göre elektronik bilet paketleri aylık yüklenmektedir. Yüklenen
paketler isteğe göre parçalara bölünüp zorunlu yükleme tarihinden önce
yüklenebilir. Örneğin bilet paketleri gün bazında yüklenmek istenirse aylık
bilet verileri 30 pakete bölünebilir. Ayın 1’ine ait bilet verileri sonraki gün
paketlenip gönderilebilir. Diğer ayın 15 ine kadar gönderilmesi gereken
paketler aynı yöntemle yüklenebilir. Sistem günlük yükleme noktasında
herhangi bir kısıt getirmemektedir. Sisteme yüklenmiş (başarı ile işlenmiş
veya işlenmekte olan veya kuyrukta bekleyen) bir paket ile aynı paket
numarasına sahip başka bir paket sisteme yüklenemez. Bu isimlendirme
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 21 / 26
standardı ile başarı ile yüklenen bir paketin bir daha yüklenmesine izin
verilmez.
Paket adındaki VKN/TCKN özel entegratör yöntemi kullanmayanlar için SOAP
mesajını imzalayan VKN/TCKN ile aynı olmalıdır. Özel entegratör aracılığıyla
uygulamadan faydalananlar için SOAP mesajını imzalayan VKN/TCKN özel
entegratörün olabilir.
Sonraki döneme (YYYYAA) ait bir paket önceki dönem yüklenmeden
gönderilemez.
Paketin adında geçen belge türü ile XML içindeki başlığın uyumlu olması
gerekir. Başlıkta BILET türü varsa paket adında EB olmalıdır.
Mevcut parçanın dönem bitiş tarihi dönem başlangıç tarihinden küçük
olmamalıdır.
Mevcut parçanın dönem başlangıç tarihi bugünden ileri bir tarih olamaz.
Mevcut parçanın dönem bitiş tarihi bugünden ileri bir tarih olamaz.
Mevcut parçanın parça numarası 000000 ise veya 000001 ise bu parçanın
başlangıç tarihi paket adında geçen dönemin ilk günü olmalıdır.
Mevcut parçanın parça numarası 000000 ise bu parçanın bitiş tarihi paket
üzerinde geçen dönemin son günü olmalıdır.
Belge adında geçen dönem bilgisi ile parçanın başlangıç ve bitiş tarihleri
uyumlu olmalıdır bu iki tarih de paket adında geçen döneme ait olmalıdır.
Başlığın içindeki VKN/TCKN ile paket adındaki VKN/TCKN aynı olmalıdır.
Paketi hangi VKN/TCKN göndermişse içindeki XML içindeki imzanın da sahibi
o VKN/TCKN olmalıdır.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 22 / 26
4 Elektronik Bilet Raporu Paketinin Başkanlığa Yüklenmesi
https://portal.efatura.gov.tr/ebilet/ adresinden Elektronik Bilet Uygulaması giriş sayfasına gidilir.
Şekil 4 Elektronik Bilet Uygulaması Giriş Sayfası
”Başla” düğmesine basılarak oturum kodu alma işlemi gerçekleşir. Akıllı kartın türü ve akıllı kart şifresi girilerek ”Tamam” düğmesine basılır.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 23 / 26
Şekil 5 Akıllı Kart Türünün Seçilmesi ve Şifrenin Girilmesi
Kullanılacak sertifika seçilir ve “Tamam” düğmesine basılır.
Şekil 6 Sertifika Seçim İşlemi
Sisteme giriş için “İmzala” düğmesine basılır.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 24 / 26
Şekil 7 Sisteme Giriş İçin İmzalama İşlemi
Giriş yaptıktan sonra Elektronik Bilet Uygulaması Ana Sayfası ekrana gelecektir.
Şekil 8 Elektronik Bilet Uygulaması Ana Sayfası
Elektronik Bilet Uygulaması ana sayfasından “Paket Yükle” menüsü seçilerek hazırlanan Elektronik Bilet Raporu Paketi yükleme işlemi gerçekleştirilir.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 25 / 26
Şekil 9 Elektronik Bilet Raporu Paketi Yükleme İşlemi
Paket yükleme işleminin başarılı bir biçimde gerçekleşmesi halinde sistem tarafından bir işlem numarası verilir.
Şekil 10 Paket Yükleme İşleminin Başarılı Olması
Paketin durumu “Paket Listesi” menüsünden de takip edilebilir.
e-Bilet Raporu Nisan 2016
Versiyon:1.0 Sayfa 26 / 26
Şekil 11 Paket Listeleme Ekranı
Elektronik bilet raporları web servis yöntemi ile de Gelir İdaresi Başkanlığı’na
yüklenebilmektedir. Web servis yöntemi ile yükleme işleminin teknik detayları
http://www.efatura.gov.tr/dosyalar/ebilet/e-BiletWebserviceKilavuzu.pdf
kılavuzunda yer almaktadır.