netle | e-fatura | ubl-tr 1.2 geçişi gelistiriciler... · netle | e-fatura | ubl-tr 1.2 geçişi...

Netle | E-Fatura | UBL-TR 1.2 geçişi Ayrıntılı Bilgilendirme, Sürüm 2.6

Netle E-Fatura Tasarım Ekibi

ÖZET

Bu döküman , 19.10.2015 tarihinde gerçekleşecek UBL-TR 1.2 geçişi hakkında temel bilgileri ve geçiş için gerçekleştirilen değişikliklerin detaylarını içermektedir.

Netle | E-Fatura | UBL-TR 1.2 geçişi

Netle | E-Fatura | UBL-TR 1.2 geçişi 2

Bu dokümanın içinde yer alan bilgiler gizlidir. Netle’nin izni olmadan paylaşılamaz.

İçerik

1 Doküman Tarihçesi ...................................................................................................................................... 3

2 Giriş ............................................................................................................................................................. 4

2.1 Kısaltmalar ....................................................................................................................................................... 4

3 UBL-TR 1.2 ................................................................................................................................................... 5

3.1 Genel Yapı ........................................................................................................................................................ 5 3.2 UBL-TR v1.2 Paketinin UBL-TR v1.0 Paketinden Farklılıkları ............................................................................ 6 3.3 Fatura Tipleri .................................................................................................................................................... 8 3.4 Vergi İstisna Kodları ......................................................................................................................................... 9 3.5 Tevkifat Kodları .............................................................................................................................................. 13

4 Netle Çözüm Ailesinde Yer Alan Değişiklikler .............................................................................................. 14

4.1 Genel Değişiklikler ......................................................................................................................................... 14 4.2 Netle E-Fatura XML Yapısı ............................................................................................................................. 14 4.3 UBL-TR Gönderimleri ..................................................................................................................................... 18 4.4 Web Servis Kullanımları ................................................................................................................................. 18

4.4.1 Yöntemlerdeki string tabanlı parametreler .............................................................................................. 18 4.4.2 Yöntemlerdeki nesne tabanlı parametrelre .............................................................................................. 18

4.5 Özel Durumların Yönetimi ............................................................................................................................. 19 4.5.1 Özel Durum Değerlendirme Kararları ........................................................................................................ 19 4.5.2 Yeni Sürüme İlişkin Parametre Ekranı ....................................................................................................... 20 4.5.3 Özel Matrah türündeki e-faturalar ............................................................................................................ 23 4.5.4 Sıfır tutarlı satış.......................................................................................................................................... 23 4.5.5 Tam İstisna ................................................................................................................................................ 23 4.5.6 Kısmi İstisna ............................................................................................................................................... 23 4.5.7 KDV Tevkifatı ............................................................................................................................................. 24 4.5.8 ÖTV Tevkifatı ............................................................................................................................................. 24 4.5.9 İhraç kayıtlı fatura ..................................................................................................................................... 24 4.5.10 TRL para birimi ...................................................................................................................................... 24 4.5.11 NIU(Adet) birim kodu ............................................................................................................................ 24 4.5.12 İmzalama işleminde SHA-1 algoritmasının kullanımdan kaldırılması ................................................... 25

4.6 Yeni Hata Mesajları ........................................................................................................................................ 25 4.7 E-Arşiv Faturaları ........................................................................................................................................... 26

4.7.1 NetleEFatura EkSahalar yapısında gönderilen bilgiler ve dönüşümleri .................................................... 26




1 Doküman Tarihçesi

Sürüm Tarih Açıklama Kaynak 1.0 22.07.2015 Dökümanın ilk yayım tarihi Netle.E-Fatura

1.5 03.08.2015 “Yeni Sürüme İlişkin Parametre Ekranı” bölümü eklendi Netle.E-Fatura

2.0 12.08.2015

UBL-TR 1.2 kapsamında hazırlanan özel durumlara ilişkin bölüm eklendi (Bölüm 4.5)

351 nolu açıklama kodu eklendi

Withholdingtax yapısı eklendi

Netle.E-Fatura

2.1 13.08.2015 12.08.2015 şematron denetimlerine göre ek düzenlemeler yapıldı

Yeni hata mesajları listesi eklendi Netle.E-Fatura

2.2 13.08.2015 E-Arşiv sisteminde kullanılan ubltr dokümanına ilişkin not Netle.E-Fatura

2.3 08.09.2015

02.09.2015 UBL-TR1.2 Kılavuzlarına göre kısmi istisna, tam istisna ve ihraç kayıt kodları düzenlendi, IHRACKAYITLI fatura tipi eklendi, ARACTESCIL fatura tipi kaldırıldı.

Istisna, özel matrah ve tevkifat faturaları için NetleEFatura oluşturma örnekleri eklendi

Netle.E-Fatura

2.4 09.09.2015

İhraç faturaları için NetleEFatura oluşturma örneği eklendi.

Özel durumlara ilişkin bölüme(Bölüm 4.5), 4.5.9.İhraç kayıtlı faturalar alt başlığı eklendi.

Yeni e-fatura ekranına giriş için “web admin” rolü bilgisi eklendi

IHRACKAYITLI faturalar için kod açıklamalarının girileceği grid bilgisi eklendi

Açıklamalarda ifade (expression) kullanım örneği eklendi

TRL TRY dönüşümü eklendi

E-arşiv faturalarına eklenen makro bilgiler eklendi

Netle.E-Fatura

2.5 06.10.2015

Giriş bölümünde UBL-TR 1.2 geçişinin ertelenmesi ilişkin bilgi eklendi.

“UBL-TR 1.2 Ayarları” ekranı görseli güncellendi. İstisna kodu ve tevkifat vergi kodu için yapılan tanımlamaların test edilmesine ilişkin görseller eklemdi.

İstisna 351 özel durum açıklaması düzeltildi.

617, 618, 619, 620 tevkifat kodları vergi oranları düzeltildi.

Netle.E-Fatura

2.6 14.10.2015

3.4.Vergi İstisnaları bölümüne, ÖTV istisna kodları eklendi.

İmzalama işleminde SHA-1 algoritmasının kullanımdan kaldırılması ile ilgili açıklama eklendi

NIU(adet) birim kodu yerine C62 adet kullanımı ile ilgili açıklama eklendi.

“623-AĞAÇ VE ORMAN ÜRÜNLERİ TESLİMİ” tevkifat vergi kodu için oran 50 olarak güncellendi.

“UBL-TR 1.2 Ayarları” ekranında Tevkifat kodları tanım sekmesinde yeni tevkifat tanımı yapılırken oran bilgisinin seçimi için 20,50,70 ve 90 seçeneklerinin olduğu liste eklendi.

Netle.E-Fatura




2 Giriş GİB, 18.02.2015 tarihinde, http://www.efatura.gov.tr/duyurular.html adresinde yayınladığı duyuru ile, 01.09.2015 saat 10:00 itibariyle UBL 2.1 standardı esas alınarak Gelir İdaresi Başkanlığı tarafından oluşturulan UBL-TR1.2 şemasının e-fatura gerçek ortamında uygulamaya konulacağını duyurmuştur. 18.08.2015 tarihinde yayınlanan ve UBL 2.1 geçisinin 15.09.2015 tarihine ertelendiğini belirten duyurunun ardından 10.09.2015 tarihinde yayınlanan yeni bir duyuru ile UBL 2.1 standardı esas alınarak Gelir İdaresi Başkanlığı tarafından oluşturulan UBL-TR1.2 şemasının e-fatura GERÇEK ortamında uygulamaya konulma zamanı 19 Ekim 2015 saat 10:00'a ertelenmiştir. Bu duyuruya göre, bugüne kadar kullanılan UBL-TR1.0 versiyonu, belirtilen tarihte yerini UBL-TR1.2 versiyonuna bırakacak ve UBL-TR1.0 versiyonu kullanımdan kaldırılacaktır. Bu düzenleme ile sadece UBL-TR1.2 kullanılabilecektir. UBL-TR1.0'a göre düzenlenen faturalar Merkez tarafından kabul edilmeyecek ve ilgili zarflar hata alarak alıcılarına ulaşamayacaktır. Sistemlerinde ilgili değişiklikleri uygulamayan kullanıcıların entegrasyon ve özel entegrasyon izinleri Başkanlıkça iptal edilebilecektir. Dökümanda, UBL-TR1.2 (yeni) versiyonu ile UBL-TR1.0 (eski) versiyonu arasındaki önemli farklar, yeni sürümde dikkat edilmesi gereken noktalar ve Netle yazılım tarafından eskiden yeni sürüme geçişte önemli olabilecek çözüm ve yazılım mimarisindeki değişiklikler yer almaktadır.

2.1 Kısaltmalar

GİB Gelir İdaresi Başkanlığı

UBL Universal Business Language

UBL-TR Universal Business Language – TR sürümü

İstisna açıklaması TaxExemptionReasonDescription

İstisna kodu UBL-TR1.2 kapsamında gelen istisna açıklamasına ek olarak kullanılan kod değeri

E-fatura Notu/Açık. Ubltr dokümanındaki “notes” (ek açıklama) alanıdır

v1.0 UBL-TR1.0 (eski)

v1.2 UBL-TR1.2 (yeni)

http://www.efatura.gov.tr/duyurular.html




3 UBL-TR 1.2 Yeni sürüme ilişkin notlar ve değişiklik bu bölümde açıklanmıştır.

3.1 Genel Yapı

GİB tarafında 2009 yılında, UBL 2.0 (Evrensel İş Dili-Universal Business Language) standartı esas alınarak, şu an v1.0 sürümü yayında olan UBL-TR (UBL Türkiye özelleştirmesi) formatı yayınlanmıştır. E-Fatura kullanımı süresince, kullanıcılardan gelen geri bildirimlere göre bu formatın güncellenme ihtiyacı doğmuştur. Bu esnada, uluslararası seviyede, UBL’in 2.1 sürümü geliştirildiği ve standartlaştırıldığı için, GIB tarafından, UBL-TR 1.2 versiyonu, UBL 2.1 sürümü üzerinde, kullanıcıların ihtiyaçlarını karşılayabilmek adına geliştirilmiştir. UBL-TR 1.2 yapısı hakkında detaylı bilgi http://www.efatura.gov.tr/efaturamevzuat.html adresinde, “Kılavuzlar” sekmesinde, “UBL-TR1.2 Kılavuzları” ve “UBL-TR1.2 Paketi” indirilerek edinilmelidir.

http://www.efatura.gov.tr/efaturamevzuat.html




3.2 UBL-TR v1.2 Paketinin UBL-TR v1.0 Paketinden Farklılıkları

GİB tarafından UBL-TR1.2 Kılavuzları bünyesinde yayınlanan “UBL-TR Genel Açıklamalar - V 0.2” dökümanında, genel farklılıklar aşağıdaki şekilde belirtilmiştir : UBL-TR v1.2 paketinin UBL-TR v1.0 paketinden farklılıkları üç kategoride sunulmaktadır: 1. Belge seviyesindeki değişiklikler

2. Ortak eleman seviyesindeki değişiklikler

3. Kod listesi seviyesindeki değişiklikler Bu değişiklikler aşağıdaki bölümlerde sırasıyla sunulmuştur. 3.4.1 Belge seviyesindeki değişiklikler

/Invoice/AccountingCost elemanı eklendi

/Invoice/BillingReference eklendi

/Invoice/OriginatorDocumentReference ve /Invoice/ContractDocumentReference eklendi

/Invoice/TaxRepresentativeParty eklendi

/Invoice/SellerSupplierParty eklendi

/Invoice/Delivery eklendi

/Invoice/AllowanceCharge çoklandı

/Invoice/WithholdingTaxTotal çoklu olarak klendi

InvoiceLine/SubInvoiceLine çoklu olarak eklendi.

3.4.2 Ortak eleman seviyesindeki değişiklikler

InvoicePeriod/StartTime ve InvoicePeriod/EndTime eklendi

OrderReference/SalesOrderID eklendi

OrderReference/OrderTypeCode eklendi

DocumentReference/DocumentDescription eklendi

DocumentReference/ValidityPeriod eklendi

DocumentReference/IssuerParty eklendi

Party/PartyLegalEntity eklendi

Contact/Note eklendi

Person/NationalityID eklendi

Person/IdentityDocumentReference eklendi

Person/FinancialAccount eklendi

FinancialAccount/FinancialInstitutionBranch eklendi

PaymentTerms/PenaltyAmount eklendi

PaymentTerms/PaymentDueDate eklendi

PaymentTerms/SettlementPeriod eklendi

AllowanceCharge/SequenceNumeric eklendi

AllowanceCharge/PerUnitAmount eklendi

TaxCategory/TaxExemptionReasonCode eklendi

InvoiceLine/Note çoklandı

InvoiceLine/ OrderLineReference, ReceiptLineReference ve DespatchLineReference elemanları eklendi

InvoiceLine/AllowanceCharge çoklandı

InvoiceLine/Delivery eklendi




InvoiceLine/WithholdingTaxTotal çoklu olarak eklendi

InvoiceLine/SubInvoiceLine çoklu olarak eklendi.

Item/AdditionalItemIdentification eklendi

Adress/District eklendi

Adress/BlockName eklendi

Item/CommodityClassification çoklandı

PaymentMeans/PayerFinancialAccount eklendi

/Invoice/BuyerCustomerParty eklendi

PartyType/IndustryClassificationCode eklendi

3.4.3 Kod listesi seviyesindeki değişiklikler UBL 2.0 standardında para birimi kodları, dil kodları, mime tipi kodları ve ölçü birimi kodları şema seviyesinde tanımlydı. Diğer bir deyişle, bu kodlar doğrudan XSD şemalarının bir parçasıydı. UBL 2.1’de bu yaklaşımdan ayrılındı ve artık tüm kod listeleri şemalardan çıkarıldı. Bu sebeple UBL-TR v1.2’de de aynı yaklaşım kullanılmaktadır. Ek olarak UBL-TR v1.0’de kod listeleri sabit idi ve paketle beraber yayınlanmıştı. Bu paketin kullanım süresince kod listelerinin belli bir süre sonra eskidiği ve değiştirilmesi gerekliliği farkına varıldı. Bu sebeple UBL-TR v1.2’de kod listeleri sürekli olarak Web sayfası üzerinden güncellencektir. Bu değişikliklerin dışındaki değişikliler aşağıda listelenmiştir: 1. Para birimi kodları için kullanılan ISO 4217 listesinin en son sürümü entegre edildi. Bu sürümde Türk Lirası için kod “TRY” dir. 2. Ölçü birimi kodları için T.C. Gümrük ve Ticaret Bakanlığı’nın ölçü birimi kodları9 dahil edildi. 3. İstisna kodları için kullanılacak olan “TaxExemptionReasonCode” tanımlandı. 4. Tevkifatlı faturalarda kullanılacak tevkifat kodları için “TaxTypeCode” listesi güncellendi. GİB tarafından belirtilen bu farklılıklardan bazıları aşağıda detaylı şekilde incelenmiştir.




3.3 Fatura Tipleri

v1.0’de fatura tipleri “SATIS” ve “IADE” şeklindeydi. Yeni sürümde aşağıda yer alan yeni türler eklenmiştir..

Tip Açıklama

SATIS Her türlü mal ve hizmet satışı ile ilgili düzenlenen faturalar

IADE Bir malın iadesi amacıyla alıcı tarafından düzenlenen faturalar

TEVKIFAT Tevkifat içeren faturalar için

ISTISNA Vergi istisnası içeren faturalar için

OZELMATRAH Özel matrah faturaları

IHRACKAYITLI İhraç kayıtlı satışlar ile DİİB ve geçici kabul rejimi kapsamındaki satışlar için düzenlenen faturalar




3.4 Vergi İstisna Kodları

v1.0’de, vergi istisna nedeni metin biçiminde belirtilirken, v1.2’ de istisna nedeninin, “TaxExemptionReasonCode” alanında kodlarla belirtilmesi gerekmektedir. Bu kod değerleri, fatura tipine göre değişiklik göstermektedir. Aşağıda kodlar ve karşılıkları listelenmiştir. “ISTISNA” faturaları için kodlar :

ÖTV İstisna Kodu

Açıklaması

101 İhracat İstisnası 102 Diplomatik İstisna 103 Askeri Amaçlı İstisna 104 Petrol Arama Faaliyetlerinde Bulunanlara Yapılan Teslimler 105 Uluslararası Anlaşmadan Doğan İstisna 106 Diğer İstisnalar 107 7/a Maddesi Kapsamında Yapılan Teslimler 108 Geçici 5. Madde Kapsamında Yapılan Teslimler

Kısmi İstisna Kodu

Açıklaması

201 17/1 Kültür ve Eğitim Amacı Taşıyan İşlemler 202 17/2-a Sağlık, Çevre Ve Sosyal Yardım Amaçlı İşlemler 204 17/2-c Yabancı Diplomatik Organ Ve Hayır Kurumlarının Yapacakları Bağışlarla İlgili Mal Ve Hizmet

Alışları 205 17/2-d Taşınmaz Kültür Varlıklarına İlişkin Teslimler ve Mimarlık Hizmetleri 206 17/2-e Mesleki Kuruluşların İşlemleri 207 17/3 Askeri Fabrika, Tersane ve Atölyelerin İşlemleri 208 17/4-c Birleşme, Devir, Dönüşüm ve Bölünme İşlemleri 209 17/4-e Banka ve Sigorta Muameleleri Vergisi Kapsamına Giren İşlemler 211 17/4-h Zirai Amaçlı Su Teslimleri İle Köy Tüzel Kişiliklerince Yapılan İçme Suyu teslimleri 212 17/4-ı Serbest Bölgelerde Verilen Hizmetler 213 17/4-j Boru Hattı İle Yapılan Petrol Ve Gaz Taşımacılığı 214 17/4-k Organize Sanayi Bölgelerindeki Arsa ve İşyeri Teslimleri İle Konut Yapı Kooperatiflerinin

Üyelerine Konut Teslimleri 215 17/4-l Varlık Yönetim Şirketlerinin İşlemleri 216 17/4-m Tasarruf Mevduatı Sigorta Fonunun İşlemleri 217 17/4-n Basın-Yayın ve Enformasyon Genel Müdürlüğüne Verilen Haber Hizmetleri 218 17/4-o Gümrük Antrepoları, Geçici Depolama Yerleri, Gümrüklü Sahalar ve Vergisiz Satış Yapılan

Mağazalarla İlgili Hizmetler 219 17/4-p Hazine ve Arsa Ofisi Genel Müdürlüğünün işlemleri 220 17/4-r İki Tam Yıl Süreyle Sahip Olunan Taşınmaz ve İştirak Hisseleri Satışları 221 Geçici 15 Konut Yapı Kooperatifleri, Belediyeler ve Sosyal Güvenlik Kuruluşlarına Verilen İnşaat

Taahhüt Hizmeti 223 Geçici 20/1 Teknoloji Geliştirme Bölgelerinde Yapılan İşlemler 225 Geçici 23 Milli Eğitim Bakanlığına Yapılan Bilgisayar Bağışları İle İlgili Teslimler 226 17/2-b Özel Okulları, Üniversite ve Yüksekokullar Tarafından Verilen Bedelsiz Eğitim Ve Öğretim

Hizmetleri 227 17/2-b Kanunların Gösterdiği Gerek Üzerine Bedelsiz Olarak Yapılan Teslim ve Hizmetler




228 17/2-b Kanunun (17/1) Maddesinde Sayılan Kurum ve Kuruluşlara Bedelsiz Olarak Yapılan Teslimler

229 17/2-b Gıda Bankacılığı Faaliyetinde Bulunan Dernek ve Vakıflara Bağışlanan Gıda, Temizlik, Giyecek ve Yakacak Maddeleri

230 17/4-g Külçe Altın, Külçe Gümüş Ve Kiymetli Taşlarin Teslimi 231 17/4-g Metal Plastik, Lastik, Kauçuk, Kağit, Cam Hurda Ve Atıkların Teslimi 232 17/4-g Döviz, Para, Damga Pulu, Değerli Kağıtlar, Hisse Senedi ve Tahvil Teslimleri 234 17/4-ş Konut Finansmanı Amacıyla Teminat Gösterilen ve İpotek Konulan Konutların Teslimi 235 16/1-c Transit ve Gümrük Antrepo Rejimleri İle Geçici Depolama ve Serbest Bölge Hükümlerinin

Uygulandığiı Malların Teslimi 236 19/2 Usulüne Göre Yürürlüğe Girmiş Uluslararası Anlaşmalar Kapsamındaki İstisnalar (İade Hakkı

Tanınmayan) 237 17/4-t 5300 Sayılı Kanuna Göre Düzenlenen Ürün Senetlerinin İhtisas/Ticaret Borsaları Aracılığıyla

İlk Teslimlerinden Sonraki Teslim 238 17/4-u Varlıkların Varlık Kiralama Şirketlerine Devri İle Bu Varlıkların Varlık Kiralama Şirketlerince

Kiralanması ve Devralınan Kuruma Devri 239 17/4-y Taşınmazların Finansal Kiralama Şirketlerine Devri, Finansal Kiralama Şirketi Tarafından

Devredene Kiralanması ve Devri 240 17/4-z Patentli Veya Faydalı Model Belgeli Buluşa İlişkin Gayri Maddi Hakların Kiralanması, Devri

ve Satışı 250 Diğerleri

Tam İstisna

Kodu*

Açıklaması

301 11/1-a, Mal İhracatı

302 11/1-a, Hizmet İhracatı

303 11/1-a, Roaming Hizmetleri

316 11/1-a, Serbest bölgelerdeki müşteriler için yapılan fason hizmetler

322 11/1-a Türkiye'de İkamet Etmeyenlere Özel Fatura ile Yapılan Teslimler (Bavul Ticareti) 304 13/a, Deniz, hava ve demiryolu taşıma araçlarının teslimi ile inşa, tadil, bakım ve onarımları

305 13/b, Deniz ve hava taşıma araçları için liman ve hava meydanlarında yapılan hizmetler

306 13/c Petrol Aramaları ve Petrol Boru Hatlarının İnşa ve Modernizasyonuna İlişkin Yapılan Teslim ve Hizmetler

307 13/c Maden Arama, Altın, Gümüş, ve Platin Madenleri İçin İşletme, Zenginleştirme Ve Rafinaj Faaliyetlerine İlişkin Teslim Ve Hizmetler[KDVGUT-(II/8-4)]

308 13/d, Teşvikli yatırım mallarının teslimi

309 13/e, Limanlara bağlantı sağlayan demiryolu hatları ile liman ve hava meydanlarının inşası, yenilenmesi ve genişletilmesi

310 13/f, Ulusal güvenlik amaçlı teslim ve hizmetler

319 13/g, Başbakanlık Merkez Teşkilatına yapılan araç teslimleri

323 13/ğ 5300 Sayılı Kanuna Göre Düzenlenen Ürün Senetlerinin İhtisas/Ticaret Borsaları Aracılığıyla İlk Teslimi

311 14/1, Uluslararası taşımacılık

315 14/3, İhraç konusu eşyayı taşıyan kamyon, çekici ve yarı romorklara yapılan motorin teslimleri

312 15/a, Diplomatik organ ve misyonlara yapılan teslim ve hizmetler

313 15/b, Uluslarası kuruluşlara yapılan teslim ve hizmetler




317 17/4-s, Özürlülerin eğitimleri, meslekleri ve günlük yaşamlarına ilişkin araç-gereç ve bilgisayar programları

314 19/2, Usulüne göre yürürlüğe girmiş uluslar arası anlaşmalar kapsamındaki istisnalar (İade hakkı tanınan)

320 Geçici 16 (6111 sayılı K.), İSMEP Kapsamında İstanbul İl Özel İdaresi'ne bağlı olarak faaliyet gösteren "İstanbul Proje Koordinasyon Birimi"ne yapılacak teslim ve hizmetler

318 Geçici 29, 3996 sayılı Kanuna göre Yap-İşlet-Devret modeli çerçevesinde gerçekleştirilecek projeler, 3359 sayılı Kanuna göre kiralama karşılığı yaptırılan sağlık tesislerine ilişkin projeler ve 652 sayılı Kanun Hükmünde Kararnameye göre kiralama karşılığı yaptırılan eğitim öğretim tesislerine ilişkin projelere ilişkin teslim ve hizmetler

321 Geçici 26, Birleşmiş Milletler (BM) ile Kuzey Atlantik Antlaşması Teşkilatı (NATO) temsilcilikleri ve bu teşkilatlara bağlı program, fon ve özel ihtisas kuruluşları ile İktisadi İşbirliği ve Kalkınma Teşkilatına (OECD) resmi kullanımları için yapılacak mal teslimi ve hizmet ifaları, bunların sosyal ve ekonomik yardım amacıyla bedelsiz olarak yapacakları mal teslimi ve hizmet ifaları ile ilgili bunlara yapılan mal teslimi ve hizmet ifaları

350 Diğerleri

351 İstisna Olmayan Diğer. 1 no.lu kdv beyannamesinin doldurulmasına ilişkin açıklamalar ve işlem kodlari dışındaki, istisna olmayan ancak 0 KDV'li fatura oluşturulması gereken durumlarda kullanılacaktır. 351 kodu kullanılarak oluşturulan faturalarda InvoiceTypeCode alanı “SATIS” değerini alacaktır.

* Önemli Not : TaxExemptionReason alanına, listeden farklı istisna nedeni yazılmak

isteniyorsa,kod olarak 350 seçilmelidir.




“OZELMATRAH” faturaları için kodlar :

Kod Açıklama

801 Milli piyango, spor-toto ve benzeri Devletçe organize edilen organizasyonlar

802 At yarışları ve diğer müşterek bahis ve talih oyunları

803 Profesyonel sanatçıların yer aldığı gösteriler ve konserler ile profesyonel sporcuların katıldığı sportif faaliyetler, maçlar ve yarışlar ve yarışmalar

804 Gümrük depolarında ve müzayede salonlarında yapılan satışlar

805 Altından mamül veya altın ihtiva eden ziynet eşyaları ile sikke altınların teslim ve ithali

806 Tütün mamülleri ve bazı alkollü içkiler

807 Gazete, dergi ve benzeri periyodik yayınlar

808 Külçe gümüş ve gümüşten mamül eşya teslimleri

809 Belediyeler tarafından yapılan şehiriçi yolcu taşımacılığında kullanılan biletlerin ve kartların bayiler tarafından satışı

810 Telefon kartı ve jeton satışları

811 Türkiye Şoförler ve Otomobilciler Federasyonu tarafından araç plakaları ile sürücü kurslarında kullanılan bir kısım evrakın basımı

“IHRACKAYITLI” faturalar için kodlar :

Kod Açıklama

701 İhraç Kayıtlı Satışlar

702 At yarışları ve diğer müşterek bahis ve talih oyunları




3.5 Tevkifat Kodları**

v1.2’de, tevkifatlı faturalarda, tevkifat bilgilerinin “TaxTotal” yerine “WithholdingTaxTotal” alanında belirtilmesi gerekmektedir. Aşağıda kodlar, karşılıkları ve oranları listelenmiştir.

Kod Açıklama Oran

601 YAPIM İŞLERİ İLE BU İŞLERLE BİRLİKTE İFA EDİLEN MÜHENDİSLİK-MİMARLIK VE ETÜT-PROJE HİZMETLERİ *GT 117-Bölüm (3.2.1)+

20

602 ETÜT, PLAN-PROJE, DANIŞMANLIK, DENETİM VE BENZERİ HİZMETLER*GT 117-Bölüm (3.2.2)+

90

603 MAKİNE, TEÇHİZAT, DEMİRBAŞ VE TAŞITLARA AİT TADİL, BAKIM VE ONARIM HİZMETLERİ *GT 117-Bölüm (3.2.3)+

50

604 YEMEK SERVİS HİZMETİ *GT 117-Bölüm (3.2.4)+ 50

605 ORGANİZASYON HİZMETİ *GT 117-Bölüm (3.2.4)] 50

606 İŞGÜCÜ TEMİN HİZMETLERİ *GT 117-Bölüm (3.2.5)+ 90

607 ÖZEL GÜVENLİK HİZMETİ *GT 117-Bölüm (3.2.5)+ 90

608 YAPI DENETİM HİZMETLERİ *GT 117-Bölüm (3.2.6)+ 90

609 FASON OLARAK YAPTIRILAN TEKSTİL VE KONFEKSİYON İŞLERİ, ÇANTA VE AYAKKABI DİKİM İŞLERİ VE BU İŞLERE ARACILIK HİZMETLERİ *GT 117-Bölüm (3.2.7)+

50

610 TURİSTİK MAĞAZALARA VERİLEN MÜŞTERİ BULMA / GÖTÜRME HİZMETLERİ *GT 117-Bölüm (3.2.8)+

90

611 SPOR KULÜPLERİNİN YAYIN, REKLÂM VE İSİM HAKKI GELİRLERİNE KONU İŞLEMLERİ *GT 117-Bölüm (3.2.9)+

90

612 TEMİZLİK HİZMETİ *GT 117-Bölüm (3.2.10)+ 70

613 ÇEVRE VE BAHÇE BAKIM HİZMETLERİ *GT 117-Bölüm (3.2.10)+ 70

614 SERVİS TAŞIMACILIĞI HİZMETİ *GT 117-Bölüm (3.2.11)] 50

615 HER TÜRLÜ BASKI VE BASIM HİZMETLERİ *GT 117-Bölüm (3.2.12)+ 50

616 5018 SAYILI KANUNA EKLİ CETVELLERDEKİ İDARE, KURUM VE KURUŞLARA YAPILAN DİĞER HİZMETLER *GT 117-Bölüm (3.2.13)+

50

617 HURDA METALDEN ELDE EDİLEN KÜLÇE TESLİMLERİ *GT 117-Bölüm (3.3.1)+ 50

618 HURDA METALDEN ELDE EDİLENLER DIŞINDAKİ BAKIR, ÇİNKO VE ALÜMİNYUM KÜLÇE TESLİMLERİ [GT 117-Bölüm (3.3.1)+

50

619 BAKIR, ÇİNKO VE ALÜMİNYUM ÜRÜNLERİNİN TESLİMİ *GT 117-Bölüm (3.3.2)+ 50

620 İSTİSNADAN VAZGEÇENLERİN HURDA VE ATIK TESLİMİ *GT 117-Bölüm (3.3.3)+ 50

621 METAL, PLASTİK, LASTİK, KAUÇUK, KÂĞIT VE CAM HURDA VE ATIKLARDAN ELDE EDİLEN HAMMADDE TESLİMİ *GT 117-Bölüm (3.3.4)+

90

622 PAMUK, TİFTİK, YÜN VE YAPAĞI İLE HAM POST VE DERİ TESLİMLERİ *GT 117-Bölüm (3.3.5)+

90

623 AĞAÇ VE ORMAN ÜRÜNLERİ TESLİMİ *GT 117-Bölüm (3.3.6)+ 50

650 DİĞERLERİ 20,50,70,90

** Önemli Not : Bir faturanın bir kalemi tevkifatlı diğer kalemi tevkifatsız olacak şekilde fatura oluşturulmamalıdır.

** Önemli Not : Bir fatura içinde, farklı tevkifat kodlarına ait satırlar olmamalıdır.




4 Netle Çözüm Ailesinde Yer Alan Değişiklikler

4.1 Genel Değişiklikler

E-Fatura sistemine, Netle ekibi tarafından yapılacak olan güncelleme işleminden itibaren, yerel sistem yeni sürüm ile uyumlu hale gelecektir. Sistemin yeni sürümle uyumlu hale gelmesi, güncelleme sonrası v1.2 uyumlu gönderime başlanacağı anlamına gelmemektedir. Güncelleme sonrası, sistem v1.2 uyumlu olarak çalışabilecek duruma gelecektir fakat GİB’in belirlediği v1.2 geçiş zamanına kadar, v1.0 kullanılması gerektiği için, yeni tanımlanan özel bir parametre ile eski sürümün kullanımına da izin verilecek, GİB yasal geçişi sonrasında bu parametrenin değiştirilmesiyle sistem v1.2 uyumlu olarak çalışmaya başlayacaktır.

4.2 Netle E-Fatura XML Yapısı

NetleEFatura, yeni sürüm ile doğan ihtiyaçları karşılayabilmek adına yeni sahalar ile zengilenleştirilmiştir. Kullanılan referansların (örnek : web servis, wsdl dokumanı – xml yapısı) güncellenmesiyle bu sahalar da kullanılabilecektir. Geçiş tarihinden itibaren de, bu sahalar aktif olarak kullanılmaya başlanacaktır.

NetleEfatura değişiklikler

NetleEfatura/VergiTemsilcisi elemanı eklendi

NetleEfatura/SaticiTedarikcisi elemanı eklendi

NetleEfatura/SaticiSiparisNo elemanı eklendi

NetleEfatura/SiparisTuruKodu elemanı eklendi

NetleEfatura/Vergi/MuafiyetKodu elemanı eklendi

NetleEfatura/FaturaKalemi/Vergi/MuafiyetKodu elemanı eklendi

NetleEfatura/Tedarikci/Ilce elemanı eklendi

NetleEfatura/Tedarikci/BlokAdi elemanı eklendi

NetleEfatura/Tedarikci/NACEKodu elemanı eklendi

NetleEfatura/Musteri/Ilce elemanı eklendi

NetleEfatura/Musteri/BlokAdi elemanı eklendi

NetleEfatura/Musteri/NACEKodu elemanı eklendi

NetleEFaturaSenaryoType enum sınıfına YOLCUBERABERFATURA değeri eklendi

NetleEFaturaType enum sınıfına TEVKIFAT, ISTISNA, OZELMATRAH, IHRACKAYITLI değerleri eklendi

TaxCodeContentType enum sınıfına tevkifat vergi kodları eklendi

Kısmi istisna, istisna, özel matrah faturaları, muafiyet neden kod değerleri için TaxExemptionReasonCodeContentType enum sınıfı eklendi.

NetleEFatura xml yapısı kullanarak UBLTR1.2 sürümünde geçerli olacak ISTISNA, OZELMATRAH ve TEVKIFAT, IHRACKAYITLI faturaları oluşturmak için aşağıda yer alan örnekler incelenebilir.




NetleEfatura kullanılarak UBLTR1.2 uyumlu istisna faturası oluşturmak için aşağıdaki adımların uygulanması gerekmektedir.

NetleEfatura sınıfındaki Tip bilgisinin NetleEFaturaType.ISTISNA olarak verilmelidir.

Netleefatura Vergiler listesinde yer alan KDVGERCEK tipli vergi bilgisindeki MuafiyetKodu alanında kısmi istisna veya tam istisna kodlarından biri kullanılmalıdır.

İstisna kullanım örneği (tam istisna kodu) var netleEfatura = new NetleEFatura(); netleEfatura.Tip = NetleEFaturaType.ISTISNA; ......... ......... var vergiList = new List<Vergi>(); vergiList.Add( new Vergi() { Tur = TaxCodeContentType.KDVGercek, Tutar = 0, MuafiyetKodu = TaxExemptionReasonCodeContentType.ISTISNA301, MuafiyetNedeni = "11/1-a Mal İhracatı" }); netleEfatura.Vergiler = vergiList.ToArray();

İstisna kullanım örneği (kısmi istisna kodu) var netleEfatura = new NetleEFatura(); netleEfatura.Tip = NetleEFaturaType.ISTISNA; ......... ......... var vergiList = new List<Vergi>(); vergiList.Add( new Vergi() { Tur = TaxCodeContentType.KDVGercek, Tutar = 0, MuafiyetKodu = TaxExemptionReasonCodeContentType.KISMIISTISNA201, MuafiyetNedeni = "17/1 Kültür ve Eğitim Amacı Taşıyan İşlemler" }); netleEfatura.Vergiler = vergiList.ToArray();

NetleEfatura kullanılarak UBLTR1.2 uyumlu özel matrah faturası oluşturmak için aşağıdaki adımların uygulanması gerekmektedir.

NetleEfatura sınıfındaki Tip bilgisi NetleEFaturaType.OZELMATRAH olarak verilmelidir.

Netleefatura Vergiler listesinde yer alan KDVGERCEK tipli vergi bilgisindeki MuafiyetKodu alanında özel matrah kodlarından biri kullanılmalıdır.

Özel matrah kullanım örneği var netleEfatura = new NetleEFatura(); netleEfatura.Tip = NetleEFaturaType.OZELMATRAH; ......... ......... var vergiList = new List<Vergi>(); vergiList.Add(

new Vergi() {

Tur = TaxCodeContentType.KDVGercek, Tutar = 0, MuafiyetKodu = TaxExemptionReasonCodeContentType.OZELMATRAH807, MuafiyetNedeni = "Gazete, dergi ve benzeri periyodik yayınlar"




} ); netleEfatura.Vergiler = vergiList.ToArray();

NetleEfatura kullanılarak UBLTR1.2 uyumlu tevkifat faturası oluşturmak için aşağıdaki adımların uygulanması gerekmektedir.

NetleEfatura sınıfındaki Tip bilgisi NetleEFaturaType.TEVKIFAT olarak verilmelidir.

NetleEfatura sınıfındaki VergilerDahilTutar bilgisi hesaplanırken tevkifat değeri düşülmemelidir.

NetleEfatura sınıfındaki KDVTevkifatTutarı alanına hesaplanan tevkifat tutarı yazılmalıdır.

Netleefatura Vergiler listesinde yer alan KDVGERCEK tipli vergi bilgisindeki Tutar alanındaki değer tevkifat düşülmemiş KDV olmalıdır.

Netleefatura Vergiler listesine KDVTEVKIFAT tipli vergi eklenmemelidir. Bunun yenine TEVKIFAT ile başlayan diğer tevkifat vergi türleri kullanılmalıdır. (Örnek: TEVKIFAT601, TEVKIFAT606,....) Yukarıda yer alan tevkifat kodları listesinden kod, açıklama ve oran bilgileri incelenebilir.

Tevkifat vergi türüne uygun oran bilgisi verilmelidir. Yukarıdaki tevkifat kodları listesinde yer alan vergi türüne ait oran bilgisi değerleri kullanılmalıdır. (TEVKIFAT606 vergi türü kullanılıyorsa oran 90 olmalıdır.)

TEVKIFAT350 vergi türü kullanılıyorsa 20, 50, 70 veya 90 değererinden biri kullanılabilir

Tevkifat kullanım örneği var netleEfatura = new NetleEFatura(); netleEfatura.Tip = NetleEFaturaType.TEVKIFAT; ......... ......... netleEfatura.ToplamTutar = 20000; netleEfatura.VergilerHaricTutar = 20000; netleEfatura.VergilerDahilTutar = 23600; netleEfatura.OdenecekToplamTutar = 20360; netleEfatura.KDVTevkifatTutari = 3240; var vergiList = new List<Vergi>() {

new Vergi() {

Tur = TaxCodeContentType.KDVGercek, Oran = 18, Tutar = 3600, Matrah = 20000

}, new Vergi() {

Tur = TaxCodeContentType.TEVKIFAT606, Oran = 90, Tutar = 3240

} }; netleEfatura.Vergiler = vergiList.ToArray();




NetleEfatura kullanılarak UBLTR1.2 uyumlu ihraç kayıtlı fatura oluşturmak için aşağıdaki adımların uygulanması gerekmektedir.

NetleEfatura sınıfındaki Tip bilgisi NetleEFaturaType.IHRACKAYITLI olarak verilmelidir.

NetleEfatura sınıfındaki VergilerDahilTutar bilgisi hesaplanırken KDV düşülmemelidir.

NetleEfatura sınıfındaki OdenecekToplamTutar bilgisi hesaplanırken KDV düşülmelidir.

Netleefatura Vergiler listesinde yer alan KDVGERCEK tipli vergi bilgisinin Tutar alanındaki değer hesaplanan KDV olmalıdır.

Netleefatura Vergiler listesinde yer alan KDVGERCEK tipli vergi bilgisinin MuafiyetKodu alanında ihraç kayıtlı kodlardan biri kullanılmalıdır.

Tevkifat kullanım örneği var netleEfatura = new NetleEFatura(); netleEfatura.Tip = NetleEFaturaType.IHRACKAYITLI; ......... ......... netleEfatura.ToplamTutar = 20000; netleEfatura.VergilerHaricTutar = 20000; netleEfatura.VergilerDahilTutar = 23600; netleEfatura.OdenecekToplamTutar = 20000; var vergiList = new List<Vergi>() {

new Vergi() {

Tur = TaxCodeContentType.KDVGercek, Oran = 18, Tutar = 3600, MuafiyetKodu = TaxExemptionReasonCodeContentType.IHRACKAYITLI701, MuafiyetNedeni = "İhraç Kayıtlı Satışlar"

} }; netleEfatura.Vergiler = vergiList.ToArray();




4.3 UBL-TR Gönderimleri

Yasal geçiş tarihine kadar, sistemde yalnızca v1.0 uyumlu e-faturaların gönderimine izin verilecektir. Geçiş sonrasında sisteme eski(v1.0) sürümlü e-fatura gönderilse bile sistem tarafından yeni sürüme otomatik çevrim yapılarak GİB ya da özel entegratör noktasına iletim gerçekleştirilecektir. Yeni sürümde iletilen e-faturalar ise değişikliğe uğramadan iletilecektir. Mali mühür ya da NES ile elektronik imzalı eski sürümlü e-faturalar, yeni versiyona çevirilemeyeceği için hata fırlatılacaktı. Bu tür belgeler tekrar hazırlanarak yeni sürümde gönderilmelidir. Eski versiyonlu faturalar, geçiş sonrası yeni versiyona otomatik olarak çekiliyor olmasına rağmen, tevkifat ve kdv muafiyetli faturaların ek sahalara ihtiyaçları dolayısıyla, elde edilen yeni faturalar karşı tarafa iletilemeyebilir. Bu sebeple geçiş tarihi itibariyle, yeni sürümün kullanımına başlanması, gönderimlerin tutarlı devam etmesi açısından tavsiye edilmektedir.

4.4 Web Servis Kullanımları

4.4.1 Yöntemlerdeki string tabanlı parametreler

Netle Yazılım tarafından geliştirilen entegrasyon ya da özel entegratör web servislerinde e-fatura gönderimleri ya da alımları için kullanılan yöntem (method) parametresi string xml tabanlı ise uygulama katmanında (istemci – client) ek bir değişiklik gereksinimi olmayacaktır. Eski sürüm ya da yeni sürüm bu yöntemler üzerinden iletişim kurulabilecek şekilde çalışmaya devam edecektir.

4.4.2 Yöntemlerdeki nesne tabanlı parametrelre

Netle Yazılım tarafından geliştirilen entegrasyon ya da özel entegratör web servislerinde e-fatura gönderimleri ya da alımları için kullanılan yöntem (method) parametresi nesne (object) tabanlı ise uygulama katmanında (istemci – client) ek bir değişiklik gereksinimi olacaktır. Çünkü NelteXML ya da UblTR formatlarına karşılık gelecek nesne yapıları yeni sürüm sahalarını da barındırdığı için istemci (client) ortamında kod geliştirme sürecinde bu sahaların kullanımı söz konusu olduğunda güncel web servislerinden tekrar referans güncellemeleri yapılması gerekmektedir.




4.5 Özel Durumların Yönetimi

Yeni sürümde UBL-TR 1.2 kapsamında GİB tarafından gereksinim duyulan özel durumdaki e-faturaların, eski sistemde ek bir geliştirme olmadan, kolaylıkla yönetilmesi için e-fatura yazılım katmanlarında önemli değişiklikler yapılmıştır. İmzasız UBL-TR 1.0, Excel ya da NetleXML yapısında gönderilen belgelerde, GİB’in yeni sisteme geçişi sonrasında bazı değerler denetlenecek, bazı kontroller yapılacak ve gerekli şartlar sağlandığında otomatik tür dönüştürme işlemi gerçekleştirilecektir(özel durum yönetimi). Yeni sürüm kapsamında, UBL-TR 1.2 sürümünde ya da NetleXML yapısında yeni alanların gönderilmesi durumunda yukarıda belirtilen özel durum yönetimi geçersiz ya da etkisiz olacaktır. Bu durumda tasarımcının ya da kullanıcının temel olarak belirlemiş olduğu veriler aynen kullanılacak, herhangi bir özel dönüşüm yapılmayacaktır. Her bir özel durum için otomatik ve manuel tespit yöntemleri belirlenmiştir. Otomatik tespit yöntemi ile, eski sistem(v1.0) özelliklerine göre hazırlanan e-fatura belgelerinde özel durumlar denetlenerek yeni sistem gereksinimi karşılanacaktır. Sistemde bir sorun olması ya da VUK kapsamında özel şartların oluşması nedeniyle, ödel durumların otomatik tespitinin mümkün olmadığı durumlarda ise manuel ifadelerle(örnek : muafiyet açıklaması

Örnek 1: TAM İstisna Durumu

Bir firmada KDV için tam istisnalı e-fatura hazırlık işlemi yapılmaktadır

Netle yazılım tarafından geliştirilen e-fatura modülleri ya da bileşenleri Eylül 2015 UBL-TR 1.2 özelliklerine göre geliştirilmiş ve firmanın sunucularında güncellenmiştir.

19 Ekim 2015 sonrasında ilgili firma entegrasyonlarında ya da veri modellerinde ek bir değişiklik yapmadan çalışmaya devam etmektedir.

Bu çalışma süreci içinde tam istisnalı bir e-fatura gönderimi yapma gereksinimi oluştuğunda;

o Mevcut zorunluluk nedeniyle e-fatura içine istisna açıklaması yazılmak zorundadır (TaxExemptionReasonDescription)

o Bu açıklamaya göre yeni sistem gereksinimine göre Code Type (300, 301 gibi) istisna kodları da tanımlanmak zorundadır

o Bu şartlar altında e-fatura hazırlandığında, güncel Netle e-fatura sistemi istisna durumunu kontrol eder, otomatik eşleme tablosundan istisna açıklamasını denetler, bu açıklamaya uygun ek tanımlama yapılmış veri muafiyet kodunu e-faturada ilgili alana ekler ve gönderir

o Ek tanımlama yapılmamış ise, eski sistem özelliklerine göre gönderilen e-fatura şematron hatası verecektir.

o Bu durumda kullanıcı istisna açıklaması yanına “[Tur:ISTISNA,KOD:300]” değerini de ekleyerek tekrar gönderim yaparsa, bu değer sistem tarafından algılanır ve e-fatura türü ISTISNA olarak işaretlenir ve sonrasında da istisna KOD değeri de 300 olarak tanımlanır

4.5.1 Özel Durum Değerlendirme Kararları

Manual bildirimler için Notlara ya da muafiyet açıklamarına yazılan özel formatlı değerler işlem sonrasında temizlenmektedir. (örnek : ......(11/c) [Tur:ISTISNA, KOD:300] değer yazılırsa, e-fatura işlemleri sonrasında bu değer (......(11/c) şeklinde dönüştürilecektir

Bir e-fatura belgesinde aynı anda birden fazla (N tane) farklı istisna ya da tevkifat durumu varsa sistem hata verecektir. Bu durumda tek belge içinde tek tür özel durum kullanılmalıdır

Özel durum tespitinde öncelik manual bildirimlere göre yapılacaktır. Eğer manual bildirim yoksa otomatik özel durum tespit işlemi çalıştırılacaktır.

Manual ya da otomatik özel durum tespitleri sonrasında sistem halen yeni ubltr 1.2 sürümündeki gereksinimleri karşılamıyorsa şema ya da şematron hatası verilecektir.




4.5.2 Yeni Sürüme İlişkin Parametre Ekranı

4.5.2.1 Kullanım Notları

Netle E-fatura web portalında, sunucu adresinde “EInvoice/UblTr” ifadesi yazılmalıdır ve sisteme girilmelidir.

o Örnek : ekrana giriş url bilgisi http://MySrv/dochuman/home/portal ise, http://MySrv/dochuman/EInvoice/UblTr adresi kullanılmalıdır.

Bu adrese girebilmek ve değişiklikleri saklayabilmek için Netle uygulamalarında “web admin” rolü ile giriş yapılmalıdır.

19 Ekim 2015 sonrasında UBL-TR 1.2 sistem özellikleri etkin hale alınacaksa bu değer “işaretlenmelidir” ve mutlaka “değişiklikleri sakla” düğmesine basılmalıdır

Grid (liste) ekranlarında kullanılacak değer bazı durumlarda sabit olmayabilir. Muafiyet açıklaması içinde her faturaya özel bir bilgi eklenebilir ve sadece bazı yerleri sabit ifade olabilir. Bu durumda listeden girilecek açıklamalar (regular expression) ifadesi özelliği desteklediği için maskeli biçimde girilebilir.

o Örnek : İhraç kayıtlı muafiyet açıklamalarında açıklama “3065” ile başlıyor ve sonrası faturaya göre değişiyorsa grid üzerinde “Vergi istisna açıklamasındaki değer” alanına “3065(.*)” regular expression değeri girilebilir. Bu durumda 3065 ile başlayan tüm mesajlar bu satırda girilen kod üzerinden değerlendirilecektir.

http://mysrv/dochuman/home/portal

http://mysrv/dochuman/EInvoice/UblTr




4.5.2.2 KDV İstisna ve İhraç kayıtlı Kodlar

Bir sistem üzerinden birden fazla şirket (VKN) olabilir.

Her bir VKN için, farklı istisna açıklamalarına özel “istisna kodları” tanımlanabilir.

Burada tanımlanacak kodlar KDV istisnası ya da İhraç kayıtlı özel durum için kullanılmalıdır. Eğer ilgili muafiyet açıklaması KDV istisnasına yönelik ise 350’ye kadar olan kodlar, ihraç kayıtlı faturalardaki açıklamaların kodları

ise 701 ya da 702 olmalıdır. İstisna kapsamında olmayan ancak 0 KDV'li fatura oluşturulması gereken durumlarda, açıklamaya ait kod 351 olmalıdır.

“UBL-TR 1.2 Ayarları” ekranında “KDV İstisna Kodları”bölümünde istisna kod tanımlamaları yapılır. İstisna kodları için yapılan tanımlamalar, şirket kodu ve istisna açıklaması girilerek test edilebilir. Yapılan test sonucu istisna kod değeri bulunamıyorsa, tanımlamalar kontrol edilmelidir.

4.5.2.3 Tevkifat Kodları

Bir sistem üzerinden birden fazla şirket (VKN) olabilir.

Her bir VKN için, o Ürün /Hizmet adı, o Açıklaması, o Ya da kalem açıklaması bazında tevkifat kodu ve (gerekirse) oranı tanımlanabilir.

Kayıt yapılırken “Kod” 650 ise “Oran“ bilgisinin listeden seçilmesi gerekir. Oran için listedeki 20,50,70,90 değerlerinden bir seçilebilir. 650 dışında başka bir kod kullanılıyorsa “Oran” bilgisine gerek bulunmamaktadır.




“UBL-TR 1.2 Ayarları” ekranında “Tevkifat Kodları”bölümünde tevkifat vergi kodu tanımlamasıı yapılır. Tevkifat vergi kodları için yapılan tanımlamalar, şirket kodu ve tevkifat vergisine ait açıklama girilerek test edilebilir. Yapılan test sonucu tevkifat vergi kodu bulunamıyorsa, tanımlamalar kontrol edilmelidir.




4.5.3 Özel Matrah türündeki e-faturalar

Manual Özel Durum

E-fatura türü SATIŞ ise VE İstisna açıklamasının bir yerine (başına, sonuna, içine) (TaxExemptionReasonDesc) “[Tur:OZELMATRAH,KOD:XXX]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü OZELMATRAH

İstisna Kodu XXX (örnek : Sigara durumunda, 806 değeri kullanılmalıdır)

4.5.4 Sıfır tutarlı satış

Otomatik Özel Durum

E-fatura türü SATIŞ ise VE Vergi tür kodu 0015 ise VE İstisna açıklamasına not yazılmışsa

İstisna açıklaması sırasıyla kodu 351 olan ubltr parametrelerinde denetlenir.

Bu denetimde bir eşleme yapıldıysa 351 istisna kodu alınır.

Manual Özel Durum

İstisna açıklamasının bir yerine (başına, sonuna, içine) (TaxExemptionReasonDesc) “[KOD:351]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü SATIS

İstisna Kodu 351

4.5.5 Tam İstisna


E-fatura türü SATIŞ ise VE Vergi tür kodu 0015 ise VE İstisna açıklamasına not yazılmışsa VE Vergi toplamı değeri (TaxAmount) değeri sıfır (0) ise

Manual Özel Durum

İstisna açıklamasının bir yerine (başına, sonuna, içine) (TaxExemptionReasonDesc) “[Tur:ISTISNA,KOD:XXX]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü ISTISNA

İstisna Kodu Manual durumda : XXX (Örnek : 300) Otomatik durumda : Parametrelerde istisna açıklamasına gelen bölümdeki kod kullanılacak

4.5.6 Kısmi İstisna


E-fatura türü SATIŞ ise VE Vergi tür kodu 0015 ise VE İstisna açıklamasına not yazılmışsa VE Vergi toplamı değeri (TaxAmount) değeri sıfır (0) ise

Manual Özel Durum

İstisna açıklamasının bir yerine (başına, sonuna, içine) (TaxExemptionReasonDesc) “[Tur:ISTISNA,KOD:XXX]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü ISTISNA





4.5.7 KDV Tevkifatı


E-fatura türü SATIŞ ise VE Vergi tür kodu değerlerinde 9015 var ise;

Fatura kalemi içinde ürün adı, açıklaması ve ek notu sırasıyla yeni eklenen ubltr parametrelerinde denetlenir.

Bu denetimde kalem özgü bir eşleme yapıldıysa tevkifat kodu alınır

Eğer kod değeri genel/diğer ise, bu kaleme ilişkin tevkifat oranı da alınır

Manual Özel Durum

Ek açıklamalarda (ubltr-notes)bir yerde (başında, sonunda, içinde) “[Tur:TEVKIFAT,KOD:XXX]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü TEVKIFAT

Tevkifat Kodu Manual durumda : XXX (Örnek : 601) Otomatik durumda : Kalem bilgileri esas alınarak yapılacak eşleme denetimi sonrasındaki kod ve oran bilgisi kullanılacaktır

Yeni Yapı WithholdingTax

Bu durumda 9015 veri türüne ilişkin temel veri yapısı, ubltr 1.2 de gelen “WithholdingTax” yapısına dönüştürülmektedir

4.5.8 ÖTV Tevkifatı


E-fatura türü SATIŞ ise VE Vergi tür kodu değerlerinde 4171 var ise

Manual Özel Durum

Ek açıklamalarda (ubltr-notes)bir yerde (başında, sonunda, içinde) “[Tur:TEVKIFAT]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü TEVKIFAT

4.5.9 İhraç kayıtlı fatura


E-fatura türü SATIŞ ise VE Vergi tür kodu 0015 ise;

Fatura notları, istisna açıklaması sırasıyla yeni eklenen ubltr parametrelerinde denetlenir.

Bu denetimde bir eşleme yapıldıysa ihraç kayıtlı istisna kodu alınır.

PayableAmount değerinden KDV(0015 tipli vergi) tutarı düşülür.

Manual Özel Durum

Ek açıklamalarda (ubltr-notes)bir yerde (başında, sonunda, içinde) “[Tur:IHRACKAYITLI,KOD:XXX]” biçiminde değer kullanıcı tarafından yazılırsa VEYA İstisna açıklamasının bir yerine (başına, sonuna, içine) (TaxExemptionReasonDesc) “[Tur:IHRACKAYITLI,KOD:XXX]” biçiminde değer kullanıcı tarafından yazılırsa

E-Fatura türü IHRACKAYITLI


4.5.10 TRL para birimi

E-fatura portalına gönderilen kaynak dokümanlarda, doküman imzasız ise para birimi denetimi yapılmaktadır. Ubltr 1.2 kapsamında yapılan düzenlemeye göre TRL para birimi şematron düzeyinde artık kullanılmıyor. Bu nedenle bu türde gönderilen belgeler otomatik olarak TRY olarak dönüştürülmektedir.

4.5.11 NIU(Adet) birim kodu

UBL-TR1.2 kapsamında yapılan düzenlemeye göre NIU(Adet) birim kodu yerine, C62(Adet) kullanılması önerilmektedir. UBL-TR 1.2 kapsamında yapılacak güncelleme sonrası, birim kodu eşleştirme parametresi aktif ise, eşleştirme




tablosunda mevcut NIU birim kodu C62 olarak güncellenecektir. Birim kodu eşleştirme parametresi aktif olmayan sistemler NIU yerine C62 kullanacak şekilde kendi sistemlerinde düzenleme yapmalıdır.

4.5.12 İmzalama işleminde SHA-1 algoritmasının kullanımdan kaldırılması

GİB, 09.10.2015 tarihinde, http://www.efatura.gov.tr/duyurular.html adresinde yayınladığı duyuru ile, 19.10.2015 saat 10:00 itibariyle SHA-1 özet algoritmasının kullanılmaması gerektiğini ve söz konusu algoritmanın kullanılması halinde zarfların Merkez'den geçemeyerek hata alacağını duyurmuştur. E-Fatura uygulamamızda imzalama algoritması olarak GİB "e-Fatura Uygulaması Yazılım Standartları ve Nesne Yapısı - v1.4" teknik klavuzunda önerilen SHA256 algoritması kullanılmaktadır. UBL-TR1.2 geçişi sonrası, gelen zarflarda SHA1 algoritması kullanılması durumunda, uygulamamız da GİB’in belirttiği şekilde hata dönülecektir.

4.6 Yeni Hata Mesajları

Yeni ubltr 1.2 kapsamında yapılan iyileştirmeler sonrasında Netle Yazılım E-Fatura katmanında yeni hata mesajları eklenmiştir. Yeni ubltr 1.2 kapsamında sıfır yazılım entegrasyon amacıyla yeni eklenen parametre tablosunda ilgili işlem için kayıt bulunumazsa aşağıda hata mesajı verilecektir;

Tevkifat e-fatura belgesinde birden fazla tevkifat türünde kalem varsa aşağıda hata mesajı verilecektir;

CheckTaxTotalAndSetExemptionReason.taxExemptionReason cannot be null for expression:

Invoice line cannot contain more than one withholding tax code

http://www.efatura.gov.tr/duyurular.html




4.7 E-Arşiv Faturaları

Ubltr 1.2 kapsamında yeni özelliklerin etkin olarak çalışması sonrasında e-arşiv projelerinde kullanılan ubltr dokümanının sürümü de 1.2 olacaktır. e-arşiv kapsamında yapılan yeni güncellemelere göre sisteme macro sahalar eklenmiştir. Bu makro sahaları ile gönderilen e-arşiv faturaları sistem tarafından otomatik olarak gerçek değerlerine dönüştürülmektedir.

4.7.1 NetleEFatura EkSahalar yapısında gönderilen bilgiler ve dönüşümleri

4.7.1.1 Örnek : Tasarım anında eklenen sahalar

var nef = CreateTestNetleEFatura(); nef.EkSahalar = new EArchiveWS.EkSaha[] { new EArchiveWS.EkSaha(){Anahtar="Enable_B2C", Deger="1"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_WebSite", Deger="http://www.netle.com.tr"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_PaymentType", Deger="Nakit"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_PaymentDate", Deger="01.01.2015, cuma"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_Transport_Person_Name", Deger="Necati Salıgil"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_Transport_Person_TCKN", Deger="1501478851"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_Transport_Company_Title", Deger="Netle Yazılım"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_Transport_Company_VKN", Deger="1818181818"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_Dispatch_Date", Deger="01.01.2015"}, new EArchiveWS.EkSaha(){Anahtar="EArc_B2C_Field_Dispatch_Time", Deger="10:00"}, new EArchiveWS.EkSaha(){Anahtar="Enable_Dispatch", Deger="1"}, new EArchiveWS.EkSaha(){Anahtar="Enable_Electronic", Deger="1"} };

4.7.1.2 Örnek : Ubltr ek sahalarda görünen, XSTL de kullanılabilecek açıklamalar

http://www.netle.com.tr/

netle | e-fatura | ubl-tr 1.2 geçişi gelistiriciler... · netle | e-fatura | ubl-tr 1.2 geçişi...

Documents