E-belge süreçlerinde en çok zaman kaybı “hata/durum kodunu” doğru okumamaktan kaynaklanır. Bu rehber, en sık görülen kodların anlamı, olası nedenleri ve pratik çözüm adımlarını tek sayfada toplar. 2025 sonbaharında yayımlanan UBL-TR ve şematron güncellemeleri ile bazı kontroller sıkılaştı; 1 Ekim 2025’ten itibaren yeni kurallar devrede. Bu yüzden hem eski hem de güncel kod akışlarını birlikte ele aldık.
1) “Kod”ları Nasıl Okumalıyım? (Hızlı Akış Mantığı)
- 1000’li başlangıçlar genelde zarf/fatura iletim süreci hakkında durum bildirir: kuyruğa alındı, iletildi, bekliyor, işlenemedi vb. (örn. 1000 Zarf Kuyruğa Eklendi).
- 1100–1199 aralığı çoğunlukla yapısal/validasyon (XML, şematron, zorunlu alan) problemlerini gösterir (örn. 1103 Zorunlu alan boş, 1170 Şematron uyumsuz).
- 1210 → 1215 → 1230/1240 gibi zincirler deneme/tekrar ve sonuç akışını ifade eder: birkaç deneme sonrası hâlâ başarısızsa 1215 ile durur; yeniden gönderim veya düzeltme gerekir. Başarısız zarf yeniden gönderildiğinde 1230 gibi kodlar görülebilir. 1300 ise genelde “alıcıya başarıyla ulaştı” durumudur.
İpucu: “Durum kodu başarılı/başarısız mı?” sorusunda tek satıra takılmayın; zarf → GİB → alıcı zincirinde önceki/sonraki kodları da kontrol edin. Birçok vaka, 1210 denemelerinden sonra 1215’te sonlanır ve tekrar gönderim gerekir.
2) 2025–2026’ta Ne Değişti?
- 05.09.2025 duyurusu ile e-Fatura paketi ve UBL-TR (Kod Listeleri) Kılavuzu güncellendi; şematron kuralları sıkılaştı ve yeni istisna/kod eklemeleri yapıldı. 01.10.2025 itibarıyla yürürlükte. (e-Arşiv için de Ekim içinde ilave devreye alımlar açıklandı.)
- Bu, zorunlu alan/şema kontrollerinde daha fazla hata yakalanacağı ve bazı faturaların önceden geçse de artık geçmeyebileceği anlamına gelir. Geliştirme/test planlarınızı bu tarihlere hizalayın.
3) En Sık Görülen 15 Kod (Kısa Tablo)
Aşağıdaki liste e-Fatura/e-Arşiv/e-İrsaliye süreçlerinde en sık sorulan kodlardan derlenmiştir. Kod açıklamaları ve örnek akışlar, yaygın paylaşımlı kılavuzlar ve sektör rehberleriyle doğrulanmıştır. (Kaynaklar sayfa sonunda.)
Kod — Ne Anlama Gelir — Olası Neden — Ne Yapmalı?
- 1000 — Zarf kuyruğa eklendi — GİB yoğun/normal süreç — Bir süre bekleyin, durumu tazeleyin.
- 1101 — XML/Yapı hatası — Hatalı etiket, eksik kapanış — XML’i doğrulayın; entegratör/geliştiriciyle şematrona göre düzeltin.
- 1103 — Zorunlu alan boş — Vergi no, tarih, tip vb. eksik — Faturayı açıp zorunlu alanları doldurun; tekrar gönderin.
- 1104 — Numara tekrarı/benzersiz değil — Aynı seri-sıra/ETTN tekrar — Yeni numara üret; mükerrer kaydı iptal/yeniden düzenle.
- 1132 — Beklenmeyen içerik (XML değil/bozuk) — Dosya biçimi hatalı — UBL-TR uyumlu XML oluşturup tekrar deneyin.
- 1163 — Zarfta daha önce kayıtlı fatura — Mükerrer zarf — Yeni zarf oluşturun; tekilleştirin.
- 1170 — Şematron uyumsuz — Kural ihlali (tip/alan) — Şematron log’una göre alanları düzeltip tekrar gönderin.
- 1195 — Sistemsel hata — Geçici sorun — Aynı ETTN ile tekrar gönderin; sürüyorsa entegratör desteği.
- 1210 — Gönderim başarısız (tekrar denenecek) — Ulaşım/validasyon hatası — Nedenini kontrol edin; otomatik/manuel tekrar bekleyin.
- 1215 — Gönderim başarısız; tekrarlar sonlandı — Birkaç deneme de başarısız — Faturayı düzeltip yeniden gönderin.
- 1220 — Hedeften sistem yanıtı gelmedi — Alıcı/posta kutusu erişilemedi — Alıcı entegratörüyle teyit; tekrar deneyin.
- 1230 — Alıcıda işlenemedi — Alıcı entegrasyon hatası — Alıcıdan hata detayını isteyin; düzeltip yeniden gönderin.
- 1240 — Alıcı reddetti/işleyemedi — Ticari kurgu/alan uyuşmuyor — Yanıt/hata açıklamasına göre düzeltin/iptal-iade.
- 1300 — Başarılı; alıcıya ulaştı — Süreç tamam — Muhasebe/defter akışına geçin; ek işlem gerekmez.
- e-İrsaliye benzer akış — 12xx/13xx’ler iletim/sonuç — Şema ve zorunlu alanlar benzer mantıkta kontrol edilir.
Not: Kod adları kısa özetlenmiştir; kendi entegratör panelinizdeki mesaj ile birlikte okumayı unutmayın.
4) Hataları Hızla Çözmek İçin Adım Adım Kontrol Listesi
- Durum zincirini kontrol edin: 1210 → 1215 gibi akış mı, yoksa tek seferlik 1103 gibi alan hatası mı?
- Zorunlu alanları gözden geçirin (tarih, vergi no, tip, senaryo, satır vergileri, belge no, müşteri bilgileri). 01.10.2025 sonrası şematron bazı alanlarda daha hassas.
- Numara/ETTN tekilliğini kontrol edin (1104). Mükerrer durumlarda yeni seri-sıra üretin.
- XML/UBL-TR doğrulaması yapın (1101/1170/1132). Entegratörünüzün doğrulama çıktısını inceleyin.
- Alıcı tarafı kaynaklı hatalarda (1220/1230) alıcı entegratörüyle iletişime geçip tekrar deneyin.
5) 2025 Sonbahar Güncellemeleri: UBL-TR & Şematron
- Yeni/ek kurallar nedeniyle “daha önce geçen” faturaların şimdi takılması olağandır. Bu, özellikle istisna, tevkifat, KDV muafiyetleri ve tip/senaryo seçimlerinde görülür.
- Duyurularda yeni istisna kod(lar)ı ve kod listesi ekleri yer aldı; şematron dosyaları güncellendi. Geliştirme/test süreçlerinizi 01.10.2025 yürürlük tarihine göre uyarlayın.
6) Sektörel Not: İlaç & Tıbbi Cihaz (ILAC_TIBBICIHAZ) Senaryosu
- Bu senaryoda ek alan/kurallar vardır ve kılavuz 2025 içinde güncellenmiştir. İlgili senaryoyu seçmeden düzenlenen faturalar zorunlu alan hataları verebilir (1103/1170). En güncel teknik kılavuz ve güncelleme özetlerine bakın. ebelge.gib.gov.tr+2pwc.com.tr+2
7) SSS – Sık Sorulan Sorular
“1215’te kaldı; ne yapmalıyım?”
1215, birden çok denemenin başarısız olduğunu ve tekrarların durdurulduğunu gösterir. Gönderimden önceki hata/durum kodlarını ve entegratör log’unu inceleyin; düzelterek yeniden gönderin.
“Tekrarlı fatura numarası (1104) uyarısı aldıktan sonra ne yaparım?”
Aynı seri-sıra/ETTN daha önce kullanılmış olabilir. Faturayı iptal-iade akışına alıp yeni numara ile yeniden düzenleyin.
“1300 geldiyse süreç tamam mı?”
Evet, genellikle alıcıya ulaştı ve işlem tamam anlamına gelir; defter/muhasebe akışına geçebilirsiniz.
8) DİA/Kurumsal ERP’de Pratik İpuçları
- Tekilleştirme: Seri-sıra ve ETTN çakışmalarına karşı otomatik kontrol/uyarı kurgulayın.
- Şematron ön-kontrolü: Fatura kaydı sırasında “taslak doğrulama” ile 1101/1170 riskini erkenden yakalayın.
- Hata dashboard’u: 1210/1215/1230 vakalarını zaman damgası + kullanıcı + müşteri kırılımında raporlayın; kronikleşen hataları süreçte düzeltin.
- Medikal senaryolar: ILAC_TIBBICIHAZ tiplerinde ürün kimlik/lot alanlarını zorunlu hale getirip kullanıcıya görsel uyarı verin (tool-tip/yardım bağlamı).
9) İndirilebilirler
- “En Sık 50 Kod – Excel/CSV” (Kod | Kısa açıklama | Olası neden | Çözüm kutusu)
- “Hata Akış Posteri (1210→1215→1230→1300)”
Hazırlamamı istersen hemen oluşturup dosya bağlantısını paylaşırım.
Kaynaklar (seçme)
- GİB detaylı durum kodları: DİA Akademi bilgi bankası özeti; Sovos (genel liste). DİA Akademi+1
- Medikal senaryo/teknik kılavuz (ILAC_TIBBICIHAZ) ve güncellemeleri. ebelge.gib.gov.tr+2pwc.com.tr+2
