Belirti
Tipik ticket ifadeleri: "AA.YYYY BTrans alma", "BTrans alındı", "BTrans işlemleri", "BTrans raporu", "BTrans güncelleme", "muhasebe aktarımı", "şema kontrolünde hata". Başlıkların %93'ünde "btrans" kelimesi geçer; alt kategori "BTrans İşlemleri" 955.
Gözlem ile sebep ayrımı
- Gözlem: çağrıların büyük çoğunluğu arıza değil, aylık rutin talebidir ("BTrans alınacak"). Kapanış süresi ortalama 86,6 saat ve 24 saat içinde kapanan oranı %63,8 — diğer temalardan belirgin düşük; bu, çağrının rapor hazırlanana kadar açık tutulduğuna işaret eder (SUPPORT_OBSERVED, PRB-BTRANS-000).
- Ayrım: gerçek sorun ancak (a) BTrans Kontrol Raporu'nda "hatalı işlem" satırı, (b) XML oluşturulamaması, (c) Doğrulama uygulamasında şema hatası olduğunda vardır. "BTrans alındı" kapanış notu neden içermez.
- Ticket başlığından kök neden çıkarılamaz; kök neden yalnız kontrol raporu ve şema hata metniyle belirlenir.
Muhtemel nedenler
| # | Neden | Kanıt |
|---|---|---|
| 1 | Rutin talep: ay sonu aktarımının destek tarafından yapılması (sorun yok) | H-164, PROC-144, TERM-BTRANS |
| 2 | Cari kartta vergi/TC numarası hane hatası → şema kontrolü "Vergi Numarası 10 Karaketer Olmalıdır" | H-164, H-146, BR-FATURA-001 — SOURCE_IMPLEMENTED |
| 3 | Kontrol raporunda "hatalı işlem": resmi işlemin fatura/istatistik alanı eksik | PB-022, PB-021, FN-MUHASEBE.EDOVIZKONTROLRAPORUBTRANS |
| 4 | Aktarım yalnız Cari.Islemler + Cari.IslemDetaylari + Cari.Hesaplar alanlarından üretilir; hesap adres/il/ilçe boşsa XML alanı boş |
SP-MUHASEBE.SPBTRANSDOVIZ (READS listesi) — SOURCE_IMPLEMENTED |
| 5 | Şube resmi tanımı/RS aktar ayarı eksik → resmi işlemler aktarıma girmiyor | BR-FATURA-007, TERM-RS-AKTAR, PB-042 |
| 6 | Yılbaşı/limit güncellemesi yapılmamış aylarda kontrol raporu hata üretir | H-165, H-166 — GAP: BTrans ile bağlantısı ticket'larda doğrulanmadı |
İlk sorulacak sorular
- Hangi ay/yıl ve hangi şube için alınacak?
- BTrans Kontrol Raporu'nda Durum süzgecinde hatalı işlem var mı? Kaç satır, hangi hesaplar?
- XML oluştu mu; hata Doğrulama uygulamasında mı çıkıyor? Hata metni ne?
- O ay resmi işlem yapılan şube/kasa resmi işaretli mi?
- Daha önceki ay sorunsuz alındı mı; arada program/şema güncellemesi oldu mu?
İlgili ekran(lar)
SCR-CREATEBTRANSDOVIZ (Hesap Yönetimi → BTrans → XML Oluştur) · SCR-FRMREPORTLIST (BTrans Kontrol Raporu) · SCR-FRMCARIHESAPEKLE (vergi/TC düzeltme) · SCR-FRMSUBEEKLE (Resmi Bilgiler)
İlgili müşteri varyantı
DOVIZ (ERPGOLDV2): BTrans döviz bürolarının aylık yükümlülüğüdür; Muhasebe.SPBTRANSDoviz bu şemada. KUYUMCU: Muhasebe.BTRANSMaden fonksiyonu vardır (FN-MUHASEBE.BTRANSMADEN) — GAP: kuyumcu kurulumunda BTrans'ın fiilen alınıp alınmadığı ticket verisinde ayrıştırılmadı.
Kontrol edilecek Settings
Sistem.Subeler.IsResmi, RsAktar, YetkiliMuesseseNo, VergiNo, Unvan (şube resmi kimliği XML başlığına girer — CONFIGURATION). Sistem.Settings içinde BTrans'a özgü kolon yok — GAP değil, ayar şube kartındadır.
Salt okunur SQL teşhis sorgusu
-- 1) Dönemdeki resmi işlemlerde hane hatası olan hesaplar (şema kontrol hatasının kaynağı)
SELECT DISTINCT H.Id, H.HesapAdi, H.VergiNo, H.TCNo, H.HukukiKod, H.HesapTuru
FROM Cari.Islemler I JOIN Cari.Hesaplar H ON H.Id = I.HesapId
WHERE I.IsDeleted = 0 AND I.SubeId = @SubeId AND I.Tarih BETWEEN @BasTarih AND @SonTarih
AND I.IslemTipi IN (11, 12)
AND ( (H.VergiNo <> '' AND LEN(H.VergiNo) <> 10) OR (H.TCNo <> '' AND LEN(H.TCNo) <> 11) );
-- 2) Dönemdeki resmi işlemlerde belge/istatistik eksikleri
SELECT I.Id, I.Tarih, I.FisNo, I.HesapId, D.FaturaSeri, D.FaturaNo, D.IstatistikKodu, D.ETTN, D.Durum
FROM Cari.Islemler I LEFT JOIN Cari.IslemDetaylari D ON D.IslemId = I.Id
WHERE I.IsDeleted = 0 AND I.SubeId = @SubeId AND I.Tarih BETWEEN @BasTarih AND @SonTarih
AND I.IslemTipi IN (11, 12)
AND (D.IslemId IS NULL OR D.FaturaNo IS NULL OR D.IstatistikKodu IS NULL);
-- 3) Şube resmi kimliği
SELECT Id, Kodu, Unvan, VergiNo, IsResmi, RsAktar, YetkiliMuesseseNo FROM Sistem.Subeler WHERE IsDeleted = 0;
İlgili iş kuralı
BR-FATURA-001 · BR-FATURA-003 (TL işlemine fatura ve istatistik kodu zorunlu) · BR-FATURA-007 (RsAktar) · BR-TIP-004 (resmi tipler deftere yazmaz, aktarıma girer)
Geçmiş ticket teması
PRB-BTRANS-000 — 1.035 çağrı, ERPGOLDV2 çağrılarının %9,3'ü (4. büyük tema). Kapanış ortalaması 86,6 saat; aylık rutin olduğundan takvim etkisi güçlüdür.
İlgili süreç
PROC-144 BTrans alma · PROC-133 fatura kontrol raporu · PROC-99 resmi işlem hataları · PROC-88 istatistik kodları · PROC-166 resmi kasa
Çözüm
PB-022: Kontrol Raporu → hatalı işlem varsa düzelt → BTrans → XML Oluştur → Doğrulama (Şema Kontrol) → zip. Hane hatası cari kartta düzeltilip BTrans yeniden alınır; istatistik kodu için PB-021.
Workaround
Hatalı tek bir işlem aktarımı engelliyorsa ilgili hesap bilgileri düzeltilene kadar dönem daraltılıp (tarih aralığı) kalan kısım ayrı XML olarak alınır — GAP: parçalı XML'in kabul edilip edilmediği süreç dokümanında yazılı değil; mali müşavire sorulmalı.
Yazılımcıya escalate koşulu
Şema kontrolü program alanlarıyla açıklanamayan hata veriyorsa XML dosyası ve hata çıktısıyla; Muhasebe.SPBTRANSDoviz / Muhasebe.IslemlerBTrans çıktısı kontrol raporuyla çelişiyorsa (sorgu 2 boş ama rapor hatalı diyor) yazılımcıya.
Kalıcı önlem
Ay başında müşteriye "BTrans öncesi kontrol" hatırlatması (kontrol raporu Durum süzgeci); hesap açılışında VKN/TCKN hane doğrulaması (BR-KASA-008); rutin çağrılar için ayrı kategori ki gerçek arızalar ölçülebilsin.
Kaynaklar
- TICKET_THEME:PRB-BTRANS-000 (SRC-TKT-ERP, 1.035 çağrı)
- DOCUMENT:12_Support/Playbooks/PB-022.md; 12_Support/KnownIssues/H-164.md, H-146.md
- DOCUMENT:12_Support/Processes/PROC-144.md (30.10.2021, rev. 06.05.2022)
- DB_OBJECT:Muhasebe.SPBTRANSDoviz → SP-MUHASEBE.SPBTRANSDOVIZ (READS: Cari.Hesaplar, Cari.IslemDetaylari, Cari.Islemler)
- DERIVED:18_Glossary/TERM-BTRANS.md; 08_Database/Tables/TBL-CARI.HESAPLAR.md, TBL-CARI.ISLEMDETAYLARI.md, TBL-SISTEM.SUBELER.md (kolon doğrulaması)