Belirti zinciri — Fatura / e-fatura / ETTN / resmi işlem

Belirti

Tipik ticket ifadeleri: "fatura numarası yanlış", "ETTN güncellemesi yapıldı", "resmi işlem düzeltme", "fatura ataması yapıldı", "geçmişe fatura kesildi", "entegratör kabul etmedi", "faturada isim TC gelmiyor", "yılbaşı fatura seri güncellemesi", "istatistik kodu hatası", "döviz alım satım belgesi çıkmıyor". Alt kategoriler: Resmi İşlemler 587, Fatura Problemi 193, FaturaSeri No Update 21.

Gözlem ile sebep ayrımı

• Gözlem: kâğıttaki/ekrandaki fatura numarası, e-belge durumu ya da fatura içeriği beklenenden farklı; ya da program fatura keserken bir engel mesajı veriyor.
• Ayrım: "ETTN güncellemesi" ve "fatura ataması" başlıkları çağrı sırasında yapılan işlemi anlatır; kök neden değildir. Aynı belirti (belge üretilmedi) resmi şube/kasa tanımı, entegratör bilgisi, limit ayarı, kimlik bilgisi eksikliği ya da mevzuat limitinin değişmesinden kaynaklanabilir.
• Mevzuat notu: 5.000 $ / 85.000 TL eşikleri süreç dokümanındaki değerlerdir (PROC-175, PB-019); güncel mevzuat değeri wiki'de doğrulanmamıştır — GAP-MEVZUAT.

Muhtemel nedenler

İlk sorulacak sorular

1. Kâğıt fatura mı, e-fatura/e-döviz belgesi mi? Hangi entegratör?
2. Mesaj tam olarak ne (Türkçe metin)? Hangi ekranda çıkıyor?
3. Sorun tek bir hesapta mı (kimlik/istatistik) yoksa tüm faturalarda mı (şube/seri/limit)?
4. Yılın ilk faturası mı? Seri değişti mi?
5. İşlem resmi kasada mı yapıldı; şube resmi işaretli mi?
6. Fatura iptal mi edilecek, düzeltilecek mi; ETTN atanmış mı?

İlgili ekran(lar)

SCR-FRMFATURAEKLE · SCR-FRMEFATURALISTESI · SCR-FATURANODEGISTIR · SCR-FRMEFATURABUGREPORT · SCR-FRMUSERSETTINGS (seri, fatura yazıcısı) · SCR-FRMSUBEEKLE (Resmi Bilgiler)

İlgili müşteri varyantı

DOVIZ (ERPGOLDV2): e-döviz alım-satım belgesi, BSMV ve istatistik kodu bu varyantın konusudur; resmi işlem V2'de işlemlerin %2'si (BR-DEFTER-URETIMI). KUYUMCU: kâğıt/e-fatura ağırlıklı; e-döviz belgesi kuralları geçerli değil — GAP: KUYUMCU kurulumunda entegratör kullanımı doğrulanmadı.

Kontrol edilecek Settings

Sistem.Subeler.IsResmi, SubeTipi, ResmiIslemLimitiTL, Entegrator, EntUserName (değer yazılmaz), EBelgeTaslak, EBelgeTest, EBelgeTcknControl, EBelgeUsdLimit, EBelgeTlLimit, RsAktar · Sistem.Kasalar.ResmiKasa · Sistem.Clients.FaSeri/FsSeri/EaSeri/EsSeri, OtoFatura, FaDesignId/FsDesignId · Sistem.Settings., BSMV, BSMVTipi. Kaynak: CONFIGURATION.

Salt okunur SQL teşhis sorgusu

-- 1) Şube/kasa resmi ayarları ve e-belge limitleri
SELECT S.Id, S.Kodu, S.IsResmi, S.SubeTipi, S.ResmiIslemLimitiTL, S.Entegrator,
 S.EBelgeTaslak, S.EBelgeTest, S.EBelgeTcknControl, S.EBelgeUsdLimit, S.EBelgeTlLimit,
 K.Id AS KasaId, K.Kodu AS Kasa, K.ResmiKasa
FROM Sistem.Subeler S LEFT JOIN Sistem.Kasalar K ON K.SubeId = S.Id AND K.IsDeleted = 0
WHERE S.IsDeleted = 0;

-- 2) Bir işlemin e-belge durumu (ETTN, gönderim, hata metni)
SELECT I.Id, I.Tarih, I.FisNo, I.IslemTipi, I.Tutar, I.Birim,
 D.FaturaSeri, D.FaturaNo, D.ETTN, D.IsSended, D.Durum, D.ErrorText, D.IstatistikKodu, D.KimlikTipi
FROM Cari.Islemler I LEFT JOIN Cari.IslemDetaylari D ON D.IslemId = I.Id
WHERE I.Id = @IslemId;

-- 3) Yıl içinde seri bazında son fatura numaraları (seri kayması / yılbaşı kontrolü)
SELECT D.FaturaSeri, MAX(D.FaturaNo) AS SonNo, COUNT(*) AS Adet
FROM Cari.IslemDetaylari D JOIN Cari.Islemler I ON I.Id = D.IslemId
WHERE I.IsDeleted = 0 AND YEAR(I.Tarih) = @Yil AND D.FaturaNo IS NOT NULL
GROUP BY D.FaturaSeri;

İlgili iş kuralı

BR-FATURA-001 · BR-FATURA-002 · BR-FATURA-003 · BR-FATURA-004 (belge no formatı) · BR-FATURA-005 (taslak/hemen gönder) · BR-FATURA-006 · BR-FATURA-007 (RsAktar) · BR-KUR-002 (FATURA/MAHSUP'ta TCMB kuru) · BR-TIP-010 · BR-IPTAL-007 · BR-DUZELTME-013

Geçmiş ticket teması

PRB-FATURA-000 — 1.286 çağrı, ERPGOLDV2 çağrılarının %11,5'i (2. büyük tema). Ocak zirvesi (yılbaşı seri/limit güncellemesi) beklenir; "ettn" (241) ve "güncellemesi" (184) kelimeleri yılbaşı rutinine işaret eder.

İlgili süreç

PROC-43 fatura serisi değiştirme · PROC-145 seri no kayma · PROC-88 istatistik kodları · PROC-165 · PROC-106 her şahsa fatura · PROC-116 isim/TC · PROC-99 resmi işlem hataları · PROC-112 resmi limit · PROC-175 5.000$/85.000₺ · PROC-133 fatura kontrol raporu · PROC-166 resmi kasa · PROC-209 OptimalScan

Çözüm

Mesaja göre playbook: numara PB-015 / yılbaşı PB-018; yanlış müşteri ve mutabakat PB-016; isim/TC PB-017; limit PB-019; entegratör/GİB/para cinsi PB-020; istatistik PB-021; MASAK PB-062; resmi şube/kasa PB-042.

Workaround

Fatura penceresinde Unvan/VKN elle yazılır (PB-017); numara kayması için Ctrl+Y ile kâğıttaki numara elle verilir (PB-015). E-belge reddinde belge taslakta bırakılıp (EBelgeTaslak) düzeltme sonrası gönderilir — GAP: taslak akışının ekran adımları wiki'de yok.

Yazılımcıya escalate koşulu

GetFaturaNo/FaturaBilgileri/GetIstatistikKodu nesnelerinde değişiklik gerekiyorsa (yalnız SQL yetkili destek, yedek sonrası); entegratör detayı program alanlarıyla açıklanamıyorsa ETTN + işlem no + hata ekran görüntüsü ile; EBelgeTlLimit kolonu yoksa şema güncellemesi (PROC-175).

Kalıcı önlem

Yılbaşı kontrol listesi (H-168): seri, limit, GetFaturaNo yıl koşulu, DijitalFatura.dll sürümü; her müşteriye Aralık'ta gönderilir. Hesap açılışında kimlik alanları zorunlu tutulur (BR-KASA-008).

Kaynaklar

• TICKET_THEME:PRB-FATURA-000 (SRC-TKT-ERP, 1.286 çağrı)
• DOCUMENT:12_Support/Playbooks/PB-015..PB-021, PB-042, PB-062
• DOCUMENT:12_Support/KnownIssues/H-024, H-035, H-132, H-140..H-152, H-166, H-168
• BUSINESS_RULE:BR-FATURA-001..009, BR-TIP-004, BR-DUZELTME-010, BR-IPTAL-006
• DB_OBJECT:Cari.AcceptTransaction (ETTN kontrolü, satır 119–245) → TRG-CARI.ACCEPTTRANSACTION
• DERIVED:08_Database/Tables/TBL-CARI.ISLEMDETAYLARI.md, TBL-SISTEM.SUBELER.md, TBL-SISTEM.KASALAR.md, TBL-SISTEM.CLIENTS.md (kolon doğrulaması)