Yönetici RehberiMali Kurtarma

Mali Kurtarma

Menü yolu: Ayarlar & Erişim → Fiş Kurtarma  •  URL: /admin/fiscal-recovery Erişim: ADMIN, MANAGER  •  Gereksinim: Mali entegrasyon (fiscal) — e-Fatura (Nilvera) (Bakım, Destek ve Güncelleme kalemine dahil) ya da ÖKC / Yazarkasa (Hugin) 2.990 ₺/yıl (lisans ön koşuluyla)

Amacı

Mali Kurtarma, mali cihaza (ÖKC / mali fiş sağlayıcısı) başarıyla kesilememiş fişleri tek bir tablo altında toplar. Ağ kopması, cihaz hatası veya sağlayıcı arızası nedeniyle kuyrukta kalan ya da başarısız olan fişleri buradan görür ve tek dokunuşla yeniden denersiniz. Operasyon sırasında ortaya çıkan mali aksaklıkları kapatmak için kullanılır.

Bu ekran yalnızca mali entegrasyon aktif olan işletmelerde görünür — yani e-Fatura (Nilvera) veya ÖKC / Yazarkasa (Hugin) entegrasyonunu almış olmanız gerekir. Menüde çıkmıyorsa entegrasyon henüz tanımlı değildir. Bu kapı (gate) yalnızca arayüz içindir; gerçek yetki kontrolü her zaman sunucudadır.

Tablo neyi gösterir?

Ekran, başarıyla kesilememiş en güncel 100 fişe kadar olan kaydı listeler ve her 20 saniyede bir otomatik yenilenir. Üstteki Yenile butonuyla anında güncelleyebilirsiniz. Liste boşsa “bekleyen fiş yok” bilgisi gösterilir.

Her satırda şu kolonlar yer alır:

  • Oluşturulma — fişin sisteme düştüğü tarih/saat.
  • Sağlayıcı — fişi kesecek mali sağlayıcının kimliği (providerId).
  • Sipariş — ilgili sipariş kimliği (bağlı sipariş yoksa —).
  • Durum — queued (kuyrukta) veya failed (başarısız) rozeti; yanındaki ×N o ana kadarki deneme sayısını gösterir.
  • Tutar — fiş toplamı, kaydın kendi para biriminde (₺) biçimlendirilir.
  • Son hata — başarısız denemede sağlayıcıdan dönen son hata mesajı (kırmızı).

Tablo yalnızca kesilememiş fişleri taşır. Bir fiş başarıyla kesildiğinde (issued) listeden otomatik düşer — temizlenmesi için ayrıca bir işlem yapmanıza gerek yoktur.

Bir fişi yeniden deneme

Sorunlu fişi bulun

Durumu failed olan satırın Son hata kolonunu okuyun. Hata, cihazın kapalı olması, kâğıt bitmesi veya sağlayıcı bağlantısı gibi giderilebilir bir nedeni gösteriyorsa önce o nedeni çözün.

Yeniden Dene’ye basın

Satırın sonundaki Yeniden Dene butonuna tıklayın. İstek sürerken buton kısa süre pasifleşir; aynı anda birden fazla satırı tetiklemeyin.

Sonucu izleyin

İşlem biter bitmez bir bildirim çıkar: başarılıysa fiş numarasıyla (“fiş kesildi”) onaylanır ve satır listeden düşer. Hâlâ başarısızsa hata mesajıyla uyarır; Son hata ve deneme sayısı güncellenir.

⚠️

Yeniden deneme, fişi özgün idempotency anahtarıyla tekrar gönderir. Bu sayede mali cihaz aynı fişi iki kez kesmez — aynı satıra art arda basmanız çift fiş oluşturmaz. Yine de her denemeden önce kök nedeni (cihaz, bağlantı, sağlayıcı) gidermek, gereksiz başarısız denemeleri azaltır.

Tablo şubeye göre kapsamlıdır (branch-scope): yalnızca üst çubuktan seçili şubenin bekleyen fişlerini görürsünüz. Başka bir şubenin fişlerini görmek için o şubeye geçin.

İlgili sayfalar

Sistem DurumuAyarlar