İş Akışı

e-Envanter Defteri Akışı

Kaynak veriden GİB onaylı envanter beratına uzanan gözlemlenebilir durum akışı.

e-Envanter yaşam döngüsü iki ayrı kararı görünür kılar: önce doğru açılış veya kapanış gününün seçilmesi, ardından ilgili kayıt için üretim, onay, imza ve GİB sonucunun tamamlanması. Durumlar API üzerinden okunur; entegratör ara durumları atlamadan yalnız uygun işlemi çağırır.

Dönem Seçimi

Firma + YılStandart takvim yılı

01-01Açılış envanteri

12-31Kapanış envanteri

Açılış tamamlandıktan sonra aynı yılın kapanış kaydı izlenir; kapanış tamamlandığında sonraki yılın açılışına geçilir. Yıl içindeki aylar ayrı envanter dönemi değildir.

Belge Durum Akışı

WaitingForUploadKaynak veri bekleniyor

WaitingForAnalysisVeri doğrulanıyor

WaitingForInventoryEntityCreationKayıt oluşturuluyor

WaitingForInventoryUblCreationXML üretiliyor

WaitingForApproveOnay bekleniyor

WaitingForSignİmza bekleniyor

SentToGibGİB sonucu alındı

GİB Ara Durumları

Durum	Anlam	Davranış
`WaitingForSendingToGib`	İmzalı envanter ve berat gönderime hazır.	Yetkili gönderim akışını bir kez başlatın.
`InGibSendQueue`	Paket GİB'e iletiliyor.	Yeni kayıt üretmeyin.
`InGibStatusQueue`	GİB paket sonucu sorgulanıyor.	Aynı `Uuid`'yi izleyin.
`InGibReceiveQueue`	GİB onaylı berat alınıyor.	Sonuç dosyası erişilebilir olana kadar bekleyin.
`Failed`	Akış hata ile durdu.	Mesajı ve aşamayı belirleyip düzeltin.

Kontrol Noktaları

Kontrol noktası	Giriş durumu	Entegratör kararı	Çıkış kanıtı
Aktarım tamamlandı mı?	`WaitingForClientToServerTransfer`	Tüm parçaları tamamlayıp süreç raporunu alın.	`WaitingForInventoryEntityCreation` ve tutarlı rapor.
Kayıt/XML üretildi mi?	`WaitingForInventoryEntityCreation` / `WaitingForInventoryUblCreation`	Aynı `Uuid`'yi izleyin; yeniden üretim açmayın.	`WaitingForApprove`.
İçerik doğru mu?	`WaitingForApprove`	Envanter/berat önizlemesi ve kaynak mutabakatı sonrası onaylayın.	`WaitingForSign`.
Gönderilebilir mi?	`WaitingForSendingToGib`	Gönderimi yalnız bir kez başlatın.	GİB ara durumlarından biri.
Tamamlandı mı?	`SentToGib`	GİB onaylı beratı indirip arşivleyin.	İmzalı envanter ve onaylı berat ilişkilendirilmiş.

Hata Dalı

Failed, işlemin bulunduğu aşamada durduğunu gösterir. PreviousStatus, FailDescription ve response içindeki Messages[] birlikte okunmadan yeni kayıt veya yeniden gönderim başlatılmamalıdır.

Hata öncesi aşama	İlk kontrol	Güvenli davranış
Yükleme/ayrıştırma/analiz	Kaynak biçim, açılış/kapanış tarihi, parça ve teşhis satırı	Kaynak veriyi düzeltin; üretime geçmeyin.
Kayıt/XML üretimi	Süreç raporu, ölçü alanları, parça ve kayıt sayıları	Mevcut `Uuid` sonucunu netleştirmeden yeniden üretmeyin.
Onay/imza	Güncel/önceki durum ve hata açıklaması	Eski özetle tekrar onay vermeyin.
GİB gönderim/sonuç	Paket adı, batch sonucu ve güncel özet	Yeni paket açmayın; aynı paket ve `Uuid` üzerinden izleyin.

Durum geçişi: Özet kaydı doğrudan güncellenerek aşama atlanmaz. Sonraki durum yalnız ilgili işlem platform tarafından kabul edildiğinde oluşur.