İş Akışı

e-Defter Akışı

VBT Client hazırlığından kullanıcı onayı, imza, GİB sonucu ve ikincil kopyaya kadar bütün durum geçişleri.

e-Defter yaşam döngüsü tek bir CurrentStatus alanı üzerinden izlenir. Durum adları farklı uygulamaların ayrı kayıtları değildir; VBT Client, kullanıcı arayüzü/API ve GİB işlemlerinin aynı dönem özeti üzerinde sırayla oluşturduğu gözlemlenebilir aşamalardır.

Okuma kuralı: Akış şemaları durum sırasını, altlarındaki geçiş tabloları ise her değişikliği başlatan işlem veya sonucu gösterir. Bir işlemin ön koşulu “Mevcut durum”, başarılı tamamlanma kanıtı “Sonraki durum” sütunundadır.

Ana Akış ve Uygulama Sınırları

Akış üç sorumluluk alanında ilerler. Client kaynak veriyi hazırlar ve aktarır; kullanıcı arayüzü/API defter üretimi, onay ve imza adımlarını yürütür; GİB aşaması gönderim sonucunu ve onaylı beratları tamamlar. Bir alanın son durumu, sonraki alanın başlangıç durumudur.

Akış alanı	Başlangıç durumu	Bitiş durumu	Bu alanda tamamlanan iş
VBT Client	`WaitingForUpload`	`WaitingForLedgerCreation`	Kaynak dosyanın açılması, ayrıştırılması, analizi ve parçaların sunucuya aktarılması.
Kullanıcı arayüzü ve API	`WaitingForLedgerCreation`	`WaitingForSendingToGib`	Defter ve beratların üretilmesi, kullanıcı onayı ve imzanın tamamlanması.
GİB ve sonuç	`WaitingForSendingToGib`	`SentSecondCopy`	Gönderimin başlatılması, GİB durumunun izlenmesi, onaylı beratların ve ikincil kopyaların alınması.

VBT Client Durumları

Bu bölüm, kaynak dosyanın seçilmesinden analiz edilen parçaların API'ye aktarılmasına kadar Client tarafından yürütülen hazırlık zinciridir. Entegratör bu durumlarda defter üretimini başlatmaz; Client işleminin tamamlanmasını ve güncel dönem özetini izler.

WaitingForUploadKaynak dosya bekleniyor

WaitingForExtractionArşiv açılıyor

WaitingForParseKayıtlar ayrıştırılıyor

WaitingForAnalysisVeri analiz ediliyor

WaitingForClientToServerTransferParçalar aktarılıyor

WaitingForLedgerCreationÜretime hazır

Mevcut durum	Geçişi oluşturan işlem veya sonuç	Sonraki durum	Kontrol
`WaitingForUpload`	Kaynak dosya Client'a yüklenir.	`WaitingForExtraction`	Yüklemenin aynı firma, şube ve dönem için başladığını doğrulayın.
`WaitingForExtraction`	Sıkıştırılmış kaynak dosya başarıyla açılır.	`WaitingForParse`	Aynı dosyayı yeniden seçmeden Client sonucunu izleyin.
`WaitingForParse`	Kaynak kayıtlar Client tarafından ayrıştırılır.	`WaitingForAnalysis`	Ayrıştırma hatası varsa kaynak dosyayı düzeltin; aktarımı başlatmayın.
`WaitingForAnalysis`	Client analizi hatasız tamamlanır.	`WaitingForClientToServerTransfer`	Analiz sonucundaki parça ve toplamları kontrol edin.
`WaitingForClientToServerTransfer`	Son analiz parçası `LedgerState/TransferParsedFile` ile aktarılır.	`WaitingForLedgerCreation`	`GetProcessReport` sonucunda üretime hazır bilgisini ve teşhis listesini birlikte değerlendirin.

Kullanıcı Arayüzü ve API Durumları

Bu aşamada kaynak aktarımı bitmiştir. Defter üretimi kullanıcı tarafından başlatılır; üretilen içerik kontrol edilip onaylandıktan sonra imza işlemi tamamlanır. Her işlemden önce güncel özet yeniden alınır.

WaitingForLedgerCreationÜretim başlatılabilir

WaitingForApproveİçerik onayı bekleniyor

WaitingForSignİmza bekleniyor

WaitingForSendingToGibGİB gönderimine hazır

Mevcut durum	Tetikleyen işlem	Başarılı işlemin sonucu	Sonraki durum
`WaitingForLedgerCreation`	`LedgerState/CreateLedger`	Yevmiye, kebir ve berat dosyaları üretilir.	`WaitingForApprove`
`WaitingForApprove`	`LedgerApproval/LedgerApproval`	Güncel özet ve mali toplamlar kullanıcı tarafından onaylanır.	`WaitingForSign`
`WaitingForSign`	Yetkili imza işlemi tamamlanır.	İmzalı defter ve beratlar GİB gönderimine hazırlanır.	`WaitingForSendingToGib`

İşlem cevabı ile durum aynı şey değildir: Bir çağrının kabul edilmesi zincirin tamamlandığını göstermez. Sonraki adıma yalnız güncel özet beklenen sonraki durumu döndürdüğünde geçin.

GİB ve Sonuç Durumları

GİB gönderimini başlatan kullanıcı işleminden sonra ilerleme platform ve GİB sonuçlarıyla gerçekleşir. GetBatchStatus ve ReceiveFile sonuçları gözlemlemek ve onaylı dosyayı almak içindir; aynı dönem için yeni bir gönderim başlatma gerekçesi değildir.

WaitingForSendingToGibGönderim tetiklenebilir

InGibSendQueueBeratlar gönderiliyor

InGibStatusQueueGİB sonucu sorgulanıyor

InGibReceiveQueueOnaylı berat alınıyor

SentToGibGİB onaylı berat alındı

SentSecondCopyİkincil kopya tamamlandı

Mevcut durum	Geçişi oluşturan işlem veya sonuç	Sonraki durum	Entegratör davranışı
`WaitingForSendingToGib`	`LedgerGib/BulkSendGibQueue` isteği kabul edilir.	`InGibSendQueue`	Gönderimi yinelemeyin; mevcut `Uuid`'yi izleyin.
`InGibSendQueue`	İmzalı beratların GİB'e gönderimi tamamlanır.	`InGibStatusQueue`	Gerçek paket adıyla GİB sonucunu izleyin.
`InGibStatusQueue`	GİB paket sonucu olumlu olarak alınır.	`InGibReceiveQueue`	Yeni paket üretmeyin; onaylı beratın alınmasını bekleyin.
`InGibReceiveQueue`	GİB onaylı berat başarıyla alınır ve dönemle ilişkilendirilir.	`SentToGib`	Onaylı dosyaların erişilebilir olduğunu doğrulayın.
`SentToGib`	İkincil kopya gönderimi başarıyla tamamlanır.	`SentSecondCopy`	Yerel mutabakatı ve arşiv kaydını kapatın.

Uçtan Uca Geçiş Matrisi

Aşağıdaki matris, bir sonraki işlemin hangi durumda yapılacağını ve geçişin hangi alanda gerçekleştiğini tek görünümde özetler.

Sorumlu alan	İşlem öncesi durum	İşlem veya sonuç	Beklenen sonraki durum
VBT Client	`WaitingForUpload`	Yükleme, açma, ayrıştırma ve analiz	`WaitingForClientToServerTransfer`
VBT Client → API	`WaitingForClientToServerTransfer`	`TransferParsedFile` ile son parçanın aktarılması	`WaitingForLedgerCreation`
Kullanıcı arayüzü → API	`WaitingForLedgerCreation`	`CreateLedger` ve üretimin tamamlanması	`WaitingForApprove`
Kullanıcı arayüzü → API	`WaitingForApprove`	`LedgerApproval`	`WaitingForSign`
İmza uygulaması	`WaitingForSign`	Yetkili imzanın tamamlanması	`WaitingForSendingToGib`
Kullanıcı arayüzü → API	`WaitingForSendingToGib`	`BulkSendGibQueue`	`InGibSendQueue`
Platform ve GİB	`InGibSendQueue`	Gönderim, durum sorgusu ve onaylı beratın alınması	`SentToGib`
Platform ve GİB	`SentToGib`	İkincil kopyanın tamamlanması	`SentSecondCopy`

Hata Dalı

Failed, Client hazırlığından GİB sonucuna kadar her aşamada oluşabilen ortak hata durumudur. Hatanın yeri yalnız Failed değerinden anlaşılmaz; PreviousStatus, FailDescription ve Messages[] birlikte değerlendirilir.

`PreviousStatus` alanı	Hata alanı	İlk kontrol	Güvenli davranış
`WaitingForUpload` – `WaitingForClientToServerTransfer`	VBT Client	Kaynak dosya biçimi, parça adı, teşhis fiş ve satırı	Kaynak veriyi düzeltin; defter üretimini başlatmayın.
`WaitingForLedgerCreation`	Defter üretimi	Süreç raporu, dönem ve mali toplamlar	Mevcut `Uuid` sonucunu netleştirmeden yeniden üretmeyin.
`WaitingForApprove` / `WaitingForSign`	Onay veya imza	Güncel özet, önceki durum ve hata açıklaması	Eski özetle yeniden onay vermeyin; güncel kaydı alın.
`WaitingForSendingToGib` – `InGibReceiveQueue`	GİB iletişimi	Paket adı, GİB sonucu ve güncel özet	Yeni paket oluşturmayın; aynı paket ve `Uuid` üzerinden izleyin.

Durum geçişi: Ara durumlar atlanmaz ve özet kaydı dışarıdan doğrudan güncellenmez. Bir sonraki işlem yalnız güncel CurrentStatus o işlemin ön koşuluyla eşleştiğinde çağrılır.