e-Fatura Entegrasyon Kontrol Hizmeti

e-Fatura entegrasyon kontrol hizmeti: UBL-TR güncellemesinden sonra güvenli geçiş

Aksiyon Soft, ERP ve e-ticaret sistemlerini özel entegratöre bağlayan işletmeler için e-Fatura entegrasyon kontrol hizmetini duyuruyor. Gelir İdaresi Başkanlığı’nın (GİB) 27 Temmuz 2026’da duyurduğu e-Fatura, e-Arşiv Fatura ve UBL-TR Kod Listeleri güncellemeleri 14 Eylül 2026 itibarıyla devreye alındı. Yeni kodlar ve şematron kuralları, eski kod listesini sabit tutan entegrasyonlarda reddedilen belge ve manuel düzeltme yükü anlamına gelebilir.

Hizmet; kendi ERP’sinden, muhasebe yazılımından ya da e-ticaret altyapısından özel entegratöre belge gönderen üretim, lojistik, perakende ve hizmet işletmeleri için tasarlandı. Amaç, yeni kurallara takılan belgeleri canlıda değil, test ortamında yakalamak ve entegrasyonun hata karşısındaki davranışını yazılı bir raporla görünür kılmaktır.

Kısaca

GİB’in UBL-TR güncellemesi 14 Eylül 2026’da devreye alındı; yeni istisna kodu 233 ve yabancı plaka tipleri eklendi.
e-Gider Pusulası için erreceipt etiketi, ayrılmış ve zarf etiketi listelerine girdi.
Kontrol hizmeti; alan eşleme, XSD/şematron doğrulama, test senaryoları ve ret izleme adımlarını kapsar.
Kuyruk, yeniden deneme ve idempotency davranışı ayrıca incelenir; mükerrer belge riski raporlanır.
Çıktı: önceliklendirilmiş analiz raporu, düzeltme sprinti ve canlı izleme planı.

14 Eylül 2026 güncellemesinde neler değişti?

GİB, e-Belge sitesindeki 27 Temmuz 2026 tarihli duyuruyla e-Fatura Paketi, e-Arşiv Fatura Paketi ve UBL-TR (Kod Listeleri) Kılavuzu’nu güncelledi; eksiklikler 11 ve 24 Ağustos’ta yayımlanan paketlerle giderildi. Aşağıdaki başlıklar, entegrasyon tarafında en sık iş çıkaran değişikliklerdir.

Yeni istisna kodu: 233

İstisna kod listesine 233 – 2942 Sayılı Kamulaştırma Kanunu kapsamında taşınmazların kamulaştırmayı yapan Devlet ve kamu tüzel kişilerine devri eklendi. Kod listesini uygulama içinde sabit bir dizi olarak tutan sistemlerde bu kod seçilemez ya da doğrulamadan geçmez. Ayrıca yatırım teşvik kodları ayrı bir listeye taşındı ve yalnızca ilgili senaryo ile fatura tiplerinde kabul ediliyor.

Yabancı plaka ve dorse tipleri

Plaka şema listesine YABANCIPLAKA, YABANCIDORSE ve YABANCIDORSEPLAKA eklendi. Türk plakaları il kodu, harf ve rakam düzenine uymak zorunda; yabancı plakalarda yalnızca büyük harf, rakam, alt çizgi ve tire kabul ediliyor. e-İrsaliyede araç plakası bilgisinin bulunması da şematronla kontrol ediliyor.

e-Gider Pusulası için erreceipt etiketi

e-Gider Pusulasını temsil eden erreceipt etiketi, belge XML’inde kullanımı yasak olan ayrılmış etiketler ile zarf etiketi listelerine eklendi. Kullanıcı hesabı tanımlarında bu etiket için ayrı kurallar geçerli; GİB, e-Gider Pusulası paketini de 15 Eylül 2026’da güncelledi.

Özel entegratörler için TÜRKAK akreditasyonlu belgeler

29 Haziran 2026’da güncellenen Özel Entegrasyon Kılavuzu (sürüm 1.14), özel entegratörlerden bilgi güvenliği için TÜRKAK’ta akredite kuruluşlardan alınmış ISO 27001 belgesinin yanında ISO 22301 ve ISO 20000 belgelerini istiyor. Bu doğrudan entegratörü ilgilendirse de entegratör seçerken veya sözleşme yenilerken sorulması gereken bir başlık hâline geldi.

Depo yükleme rampası ve paletler — e-İrsaliye ve e-Fatura plaka alanlarının lojistik bağlamı — Yabancı plakalı araç ve dorse ile yapılan sevkiyatlarda plaka alanının doğru şema tipiyle gönderilmesi artık şematronla denetleniyor.

e-Fatura entegrasyon kontrol hizmeti neleri kapsıyor?

Kontrol, belgeyi üreten koddan özel entegratörün döndüğü yanıta kadar tüm hattı ele alır. Aşağıdaki tablo, her kontrol maddesinde neye baktığımızı ve sonunda size ne teslim ettiğimizi özetler.

Kontrol maddesi	Neye bakıyoruz?	Çıktı
UBL-TR XSD ve şematron doğrulama	Üretilen örnek belgelerin güncel GİB paketiyle doğrulanması	Hata listesi ve kural bazında eşleşme tablosu
Alan eşleme incelemesi	233 kodu, yatırım teşvik kodları, plaka şema tipleri ve sabit kod listeleri	Değişmesi gereken alanların listesi
Test ortamı senaryoları	İstisnalı satış, yabancı plakalı sevkiyat, iade ve e-Arşiv alıcı varyasyonları	Tekrar çalıştırılabilir senaryo seti
Reddedilen belge izleme	Uygulama yanıtları, ret nedenleri ve kaynak kayıtla eşleşme	Ret paneli ve hata kodu sınıflaması
Kuyruk, retry ve idempotency	Zaman aşımında yeniden gönderim, mükerrer belge ve sıralama riski	Risk notu ve önerilen düzeltme
Rapor ve düzeltme sprinti	Bulguların etkiye göre önceliklendirilmesi	Analiz raporu ve planlı düzeltme işi

Şema: ERP’den özel entegratöre e-Fatura entegrasyon akışı ve alan eşleme, XSD/şematron, kuyruk-retry, canlı izleme kontrol noktaları — e-Fatura entegrasyon hattındaki dört kontrol noktası: alan eşleme, şema doğrulama, dayanıklılık ve canlı izleme.

Kontrol süreci nasıl işler?

Çalışma, mevcut sistemi durdurmadan ve canlı belge akışına dokunmadan yürür. Adımlar şöyledir:

Keşif: belge tipleri, senaryolar, entegratör bağlantısı ve hata yönetimi akışı birlikte çıkarılır.
Analiz raporu: örnek belgeler doğrulanır, eşleme ve dayanıklılık bulguları etkiye göre sıralanır.
Düzeltme sprinti: öncelikli bulgular kodda giderilir; değişiklikler sürüm notuyla teslim edilir.
Test: senaryo seti entegratörün test ortamında çalıştırılır, sonuçlar kayıt altına alınır.
Canlı izleme ve SLA: ret paneli ve alarmlar devreye alınır; istenirse bakım sözleşmesiyle izleme sürer.

Entegrasyonun dayanıklılık tarafını derinlemesine merak ediyorsanız outbox pattern, idempotency ve retry rehberimiz bu konudaki tasarım kararlarını ayrıntılı anlatıyor.

Başlamadan önce neleri hazırlamalısınız?

Kontrolü hızlandırmak için aşağıdaki kontrol listesini önceden doldurmanızı öneririz:

Kullandığınız belge tipleri ve senaryolar (temel, ticari, e-Arşiv, iade, istisna, ihracat).
Özel entegratörünüzün adı, test ortamı erişimi ve entegrasyon yöntemi (web servis, dosya, API).
Son üç aydaki reddedilen belge örnekleri ve ret mesajları.
Kod listelerinin nerede tutulduğu: veritabanı tablosu, yapılandırma dosyası veya kod içi sabit.
Belgeyi üreten modülün sahibi ve değişiklik yayın süreci.
Yabancı plakalı araçla sevkiyat yapıp yapmadığınız ve 233 kapsamında satışınız olup olmadığı.

Aksiyon Soft nasıl yardımcı olur?

Bu çalışma, API ve entegrasyon hizmetimizin bir parçası olarak sunulur. Kalıcı bir ara katman ihtiyacı doğarsa API ve veri entegrasyon platformu yaklaşımıyla eşleme, kuyruk ve izleme tek yerde toplanır. Mimari tercihleri kurumsal entegrasyon ara katman mimarisi yazımızda, güncellemenin teknik ayrıntılarını ise GİB UBL-TR güncellemesi rehberimizde bulabilirsiniz.

Ekibimiz Samsun merkezlidir ve Türkiye genelinde uzaktan çalışır; şubemiz yoktur. Toplantılar video görüşmeyle yapılır, gerekirse planlı ziyaret eklenir. Canlı sonrası izleme için bakım ve destek kapsamında yanıt süreleri sözleşmede yazılı olarak tanımlanır.

Sık sorulan sorular

e-Fatura entegrasyon kontrolü için mevcut sistemi değiştirmek gerekir mi?

Hayır. Kontrol mevcut ERP ve entegratör bağlantınız üzerinde yapılır; değişiklik yalnızca raporda öncelik verilen bulgular için, sizin onayınızla düzeltme sprintinde yapılır.

Özel entegratörümüz güncellemeyi yaptı; bizim tarafta yine de iş var mı?

Olabilir. Entegratör kendi doğrulamasını günceller, ancak 233 kodunu veya yabancı plaka tipini belgeye yazan alan sizin sisteminizdedir. Sabit kod listeleri en sık gördüğümüz sorun kaynağıdır.

Kontrol ne kadar sürer?

Belge tipi, senaryo ve entegrasyon noktası sayısına bağlıdır. Keşif sonrasında kapsam ve takvim analiz raporunda yazılı olarak paylaşılır; sabit bir süre taahhüt etmeyiz.

Canlı ortamdaki faturalara dokunuyor musunuz?

Hayır. Doğrulama örnek belgeler ve entegratörün test ortamı üzerinden yapılır. Canlıya geçiş, test sonuçları onaylandıktan sonra planlı bir yayınla gerçekleşir.

Yerinde çalışma gerekiyor mu?

Genellikle hayır. Samsun’daki ekibimiz Türkiye genelinde uzaktan çalışır; erişim izinleri ve güvenlik gereksinimi olan durumlarda planlı ziyaret ekleyebiliriz.

Projenizi konuşalım

Son ret mesajlarınızı ve kullandığınız belge tiplerini kısa bir notla iletişim formumuza ekleyin; keşif görüşmesinde kontrol kapsamını birlikte netleştirelim.

e-Fatura entegrasyon kontrol hizmeti: UBL-TR güncellemesine hazır mısınız?