Bu araç neyi kontrol eder?
Araç, GİB’in e-Fatura paketindeki doğrulama dosyasında yer alan iki kuralı uygular. ETTN 8-4-4-4-12 düzeninde, tireler dahil 36 karakterlik bir UUID olmalı ve yalnız 0–9 rakamlarıyla a–f harflerini içermelidir. Fatura numarası ise 16 karakterdir: 3 karakterlik seri (birim kodu, büyük harf ya da rakam), 20 ile başlayan 4 haneli yıl ve 9 haneli müteselsil sıra numarası.
Kural dışı bir değer girdiğinizde araç hatanın türünü söyler: uzunluk, geçersiz karakter, eksik tire, küçük harfli seri, yıl yerine başka karakter, sıfır sıra numarası ya da bu yıldan ileri bir yıl. Tiresiz yapıştırılmış 32 karakterlik bir ETTN’nin tireli hâlini de önerir.
Neyi kontrol edemez?
Bu bir biçim kontrolüdür. Biçimi doğru bir ETTN ya da fatura numarası, belgenin gerçekten düzenlendiğini, GİB’e raporlandığını ya da iptal edilmediğini göstermez. Belgenin varlığını doğrulamak için e-Arşiv faturada GİB’in e-Arşiv Fatura Sorgulama ekranını kullanın; bu ekran ETTN değil satıcının VKN/TCKN’si, fatura numarası, ödenecek tutar ve güvenlik kodunu ister.
Kontrol tamamen tarayıcınızda yapılır; yazdığınız numaralar sunucuya ya da başka bir yere gönderilmez.
En sık karşılaşılan hatalar
- ETTN’de 0 rakamı yerine büyük O harfi yazılması (O harfi ETTN’de geçersizdir).
- ETTN’nin PDF’ten kopyalanırken satır sonunda bölünmesi ya da tirelerin düşmesi.
- Fatura numarasının 15 ya da 17 karakter yazılması; sıra numarasındaki sıfırların eksik kalması.
- Seri harflerinin küçük ya da Türkçe karakterle (Ç, Ğ, İ, Ö, Ş, Ü) yazılması.
- Numaradaki yıl ile faturanın tarihindeki yılın farklı olması; müteselsil numara her yıl 1’den başlar.
Satıcılar için: numara ve ETTN disiplini
ETTN’yi ve fatura numarasını belgeyi düzenleyen yazılım ya da entegratör üretir; elle yazılmaz. Bağlantı koptuğunda yapılan tekrar denemesi yeni bir ETTN üretirse aynı satışa iki fatura oluşabilir. TicariHub aynı sipariş için yapılan tekrar denemelerde aynı ETTN’yi kullanır ve aynı siparişe ikinci fatura kesmez; ETTN sipariş detayında kopyalanabilir biçimde görünür.
Örnek girdiler ve sonuçları
| Girdi | Sonuç | Neden |
|---|---|---|
| 3f2b8c1e-9a4d-4e7b-b6c2-5d1e8f0a7c39 | Geçerli ETTN | 36 karakter, 8-4-4-4-12, onaltılık karakterler |
| 3f2b8c1e9a4d4e7bb6c25d1e8f0a7c39 | Geçersiz (öneri var) | Tireler eksik; araç tireli hâlini önerir |
| 3f2b8c1e-9a4d-4e7b-b6c2-5d1e8f0a7cO9 | Geçersiz | Sondan ikinci karakter O harfi, 0 rakamı olmalı |
| ABC2026000000123 | Geçerli fatura no | Seri ABC, yıl 2026, 123. belge |
| abc2026000000123 | Geçersiz (öneri var) | Seri büyük harfle yazılmalı |
| ABC202600000123 | Geçersiz | 15 karakter; sıra numarası 9 hane olmalı |