İş Akışı

Kullanım Senaryoları

Kaynak dosyadan arşive kadar aylık e-Defter işlemini müşteri ve operasyon adımlarıyla uygulayın.

Bu senaryolar standart takvim yılı kullanan bir firmanın aylık yevmiye ve kebir üretimini kapsar. Her ay ayrı bir dönem kaydıdır; aynı firma ve şubede Ocak'tan Aralık'a sıralı ilerler.

Aylık Defter Üretimi

Firma VKN/TCKN'si, şube kodu ve üretilecek ay belirlenir.
Kaynak muhasebe dosyasında fiş/satır sırası, hesaplar, belge bilgileri, tarihler ve borç-alacak toplamları kontrol edilir.
Kaynak dosya VBT Client ile ayrıştırılır ve analiz edilir. Client'ın ürettiği parçalar TransferParsedFile ile aktarılır.
Tüm parçalar tamamlandıktan sonra GetProcessReport çağrılır. IsReadyForLedgerCreation=true, DiagnoseMessages boş ve sayısal özet kaynak sistemle aynı olmalıdır.
CreateLedger çağrılır. Data=true yalnız üretim isteğinin kabul edildiğini gösterir.
Güncel özet WaitingForApprove durumuna ulaşana kadar aynı Uuid üzerinden izlenir.

Aylık Girdi Kontrolü

Kontrol	Kabul ölçütü	Uygun değilse
Dönem	`PeriodStart` ayın ilk, `PeriodEnd` aynı ayın son günü.	Aktarımı başlatmayın; tarihleri kaynak dönemle eşitleyin.
Fiş sırası	Başlık ve satır sıra numaraları benzersiz ve kesintisiz.	Eksik veya mükerrer kayıtları kaynakta düzeltin.
Mali denge	Toplam borç = toplam alacak; rapor ve ERP toplamları aynı.	Onay vermeyin; farkın oluştuğu fiş/satırı belirleyin.
Belge bilgisi	Belge türüne bağlı tarih, numara ve açıklama alanları eksiksiz.	Mapping kurallarındaki koşullu alanları tamamlayın.
Parçalar	Parça sayısı ile ilk/son fiş ve satır numaraları tutarlı.	Eksik parçayı aynı firma-şube-dönem altında aktarın.

Onay, İmza ve GİB

Üretilen defterler önizlenir; borç-alacak toplamları ve dönem bilgileri kaynak sistemle mutabık kaldığında onaylanır. Onaydan sonra imza aşaması tamamlanır, beratlar GİB'e iletilir ve GİB onaylı sürümler alınır.

Karar	İşlem	Sonraki kontrol
Aktarım tamamlandı	`GetProcessReport`	Teşhis mesajı yok ve oluşturma hazır.
Defter üretilecek	`CreateLedger`	Özet `WaitingForApprove` durumuna ilerliyor.
İçerik doğrulandı	`LedgerApproval`	İmza bekleme durumu.
GİB süreci tamamlanacak	Yetkili akış üzerinden gönderim	GİB onaylı yevmiye ve kebir beratları.

Onay Kapısı

LedgerApproval geri alınabilir bir önizleme işlemi değildir. Çağrıdan önce yevmiye ve kebir HTML/PDF görünümleri, mükellef beratları, firma/şube, dönem, parça sayısı, fiş/satır sayıları ve mali toplamlar doğrulanmalıdır. Onay isteği güncel özet cevabındaki Data nesnesiyle yapılır; daha önce saklanmış eski bir model kullanılmaz.

GİB Sonuç Kapısı

WaitingForSendingToGib durumu imzanın tamamlandığını ve gönderimin başlatılabileceğini gösterir. InGibSendQueue, InGibStatusQueue ve InGibReceiveQueue sürerken yeni bir dönem veya paket üretilmez. Tamamlanma kanıtı; olumlu GİB sonucu, erişilebilir GİB onaylı yevmiye/kebir beratları ve bunların aynı Uuid ile arşivlenmesidir.

Güvenli Tekrar

Timeout sonrasında aynı firma-şube-ay için yeniden aktarım veya oluşturma yapmadan önce güncel özet sorgulanır. Mevcut kayıt ilerlemişse aynı Uuid üzerinden izlenir; hata terminal durumdaysa mesaj ve kaynak veri düzeltilmeden tekrar başlatılmaz.

Ay sırası: Önceki ay tamamlanmadan sonraki aya geçilmemelidir. Standart akış Ocak'tan Aralık'a kesintisiz ilerler.

Canlıya Geçiş Senaryoları

Test	Beklenen kanıt	Kaydedilecek kimlik
Başarılı tek parçalı ay	Üretim, onay, imza, GİB sonucu ve onaylı berat indirme tamam.	Firma, şube, dönem, `Uuid`, paket adı.
Başarılı çok parçalı ay	Parça, fiş ve satır sayıları eksiksiz; toplamlar kaynakla aynı.	Parça adları ve özet `Uuid`.
Hatalı muhasebe verisi	Teşhis mesajı doğru fiş/satırı gösteriyor; üretim başlatılmıyor.	Parça, fiş, satır ve hata mesajı.
Timeout sonrası tekrar	Yeni kayıt üretmeden mevcut durum bulunuyor ve aynı `Uuid` izleniyor.	İlk çağrı zamanı ve sorgu sonucu.
Arşiv mutabakatı	İmzalı yevmiye/kebir ile GİB onaylı beratlar eşleşiyor.	Dosya adları, hash veya kurumun arşiv kimliği.