Bilet Raporu Havayolları Teknik Kılavuzu yayınlanmıştır !

Preview:

Citation preview

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.