Referans
Teknik Referans
Durum değerleri, açılış/kapanış kuralları, dosya türleri ve hata yönetimi referansı.
Desteklenen Dönemler
| Tür | PeriodStart | PeriodEnd | Sonraki dönem |
|---|---|---|---|
| Açılış | 1 Ocak | 1 Ocak | Aynı yıl 31 Aralık |
| Kapanış | 31 Aralık | 31 Aralık | Sonraki yıl 1 Ocak |
InventorySummaryStates
CurrentStatus, açılış veya kapanış kaydı için bir sonraki güvenli işlemi gösterir. Aşağıdaki enum adları API cevabında görüldüğü biçimiyle yazılmıştır.
| Değer | Dış anlam | Entegratör davranışı | Terminal mi? |
|---|---|---|---|
WaitingForUpload | Kaynak dosya/parça bekleniyor. | VBT Client ile doğru firma, şube ve açılış/kapanış tarihi için yüklemeyi başlatın. | Hayır |
WaitingForExtraction | Yüklenen paket açılıyor. | Aynı dosyayı yeniden yüklemeyin; mevcut kaydı izleyin. | Hayır |
WaitingForParse | Kaynak içerik ayrıştırılıyor. | Yeni kayıt açmayın; Client sonucunu bekleyin. | Hayır |
WaitingForAnalysis | Tarih, hesap, tutar ve ölçü kuralları doğrulanıyor. | Teşhis raporu tamamlanmadan üretime geçmeyin. | Hayır |
WaitingForClientToServerTransfer | Analiz edilen parçaların aktarımı bekleniyor. | Tüm Client parçalarını aynı açılış/kapanış anahtarıyla aktarın. | Hayır |
WaitingForInventoryEntityCreation | Envanter kayıtları oluşturuluyor. | Yeni üretim açmayın; aynı Uuid'yi izleyin. | Hayır |
WaitingForInventoryUblCreation | Envanter ve berat XML'i oluşturuluyor. | Yeni üretim açmayın; aynı Uuid'yi izleyin. | Hayır |
WaitingForApprove | Envanter ve berat kullanıcı kontrolüne hazır. | Önizleme ve kaynak mutabakatı sonrası güncel özeti onaylayın. | Hayır |
WaitingForSign | Onaylanan dosyalar imza veya mali mühür işlemini bekliyor. | Yeni onay göndermeyin; imza sonucunu izleyin. | Hayır |
WaitingForSendingToGib | İmza tamamlandı; GİB gönderimi başlatılabilir. | Yetkili gönderim işlemini yalnız bir kez başlatın. | Hayır |
InGibSendQueue | Paket GİB'e gönderiliyor. | Yeni paket veya tarih üretmeyin. | Hayır |
InGibStatusQueue | Gönderilen paketin GİB sonucu sorgulanıyor. | Aynı paket adı ve Uuid ile sonucu izleyin. | Hayır |
InGibReceiveQueue | Olumlu sonuçlanan GİB onaylı berat alınıyor. | Dosya erişilebilir olana kadar yeni gönderim yapmayın. | Hayır |
SentToGib | GİB onaylı envanter beratı alma adımı tamamlandı. | Onaylı beratı indirip imzalı envanterle eşleştirin. | Evet |
Failed | Süreç bulunduğu aşamada hata ile durdu. | PreviousStatus, FailDescription ve Messages[] ile nedeni belirleyin. | Evet |
Hata Okuma
Messages[], özet durum ve FailDescription birlikte değerlendirilir. Destek kaydında firma, şube, açılış/kapanış tarihi, Uuid ve işlem zamanı bulunmalı; parola, token ve tam envanter içeriği maskelenmelidir.
| Hata katmanı | Gözlenebilir belirti | Entegratör işlemi |
|---|---|---|
| HTTP/kimlik | 401/403 veya yetki mesajı | Email ve Password ile yeniden oturum açın; SecurityFirmUUID bağlamını doğrulayın. |
| Request sözleşmesi | Messages[] alan/format hatası | Zorunlu alanı, şube kodunu ve açılış/kapanış tarihlerini düzeltin. |
| Kaynak veri | DiagnoseMessages içinde parça/kayıt/satır bilgisi | Hesap, tutar veya ölçü alanını kaynakta düzeltin. |
| Yaşam döngüsü | İşlem mevcut CurrentStatus için uygun değil | Durumu zorlamayın; çağrıyı doğru kontrol noktasında yapın. |
| GİB sonucu | Paket durum kodu/açıklaması veya onaylı dosyanın hazır olmaması | Aynı paket ve Uuid ile sonucu izleyin. |
Çıktı Türleri
| Çıktı | Data biçimi | Kullanım |
|---|---|---|
| HTML önizleme | HTML işaretleme metni | Onay öncesi insan gözüyle kontrol. |
| Base64 kodlu PDF byte dizisi | Okunabilir görüntü; yasal XML'in yerine geçmez. | |
| ZIP | Base64 kodlu ZIP byte dizisi | İmzalı veya GİB onaylı teknik dosyaları indirme. |