Sıkça Sorulan Sorular

Hayır. e-Defter rehberi aylık yevmiye ve kebir dosyalarını kapsar. e-Envanter Defteri standart takvim yılında açılış ve kapanış günlerine ait ayrı envanter ve berat dosyaları üretir.

Hayır. PDF görüntüleme kolaylığı sağlar. İmzalı XML/XBRL defter dosyası ile GİB onaylı berat birlikte muhafaza edilmelidir.

Standart iş akışı ayları sıralı ilerletir. Önceki dönemin tamamlanma ve hata durumu kontrol edilmeden sonraki dönem kapatılmamalıdır.

Bu rehberde yayımlanan entegrasyon kapsamı standart Ocak-Aralık takvim yılıdır. Özel hesap dönemi ve parçalı ay senaryoları desteklenen sözleşmeye dahil değildir.

Yevmiye ve kebir önizlemeleri, dönem, firma/şube, parça sayısı, fiş-satır sıraları ve borç-alacak toplamları kaynak sistemle karşılaştırılmalıdır.

Hayır. Gönderilen paketin durum sonucu olumlu olmalı, GİB onaylı berat erişilebilir olmalı ve ilgili imzalı XML/XBRL dosyasıyla eşleştirilmelidir. İkincil kopya yüklemesi ana GİB onay akışından ayrı izlenir ve kendi sonucu tamamlanmadan arşiv mutabakatı kapatılmaz.

İmzalı yevmiye ve kebir XBRL-GL dosyaları, bunlara ait imzalı mükellef beratları ve GİB onaylı beratlar aynı firma, şube, dönem ve Uuid ile ilişkilendirilmelidir. PDF/HTML yalnız görüntüleme kopyasıdır.

SentSecondCopy, imzalı e-Defter ve berat dosyalarının ikincil kopya saklama adımının da tamamlandığını gösteren terminal durumdur. SentToGib ana GİB onay akışının sonucudur; ikincil kopya bunun yerine geçmez ve ayrı izlenir.

Evet. Kaynak büyüklüğüne göre ay birden fazla parçaya ayrılabilir. Her parça aynı firma-şube-ay anahtarıyla aktarılır; parça sayısı, ilk/son fiş ve satır numaraları süreç raporunda eksiksiz doğrulanır.

Onay, kontrol edilmiş dosyaları imza aşamasına taşır. Kaynakta değişiklik gerekiyorsa mevcut kaydın durumu ve sonuçları yetkili süreçle değerlendirilmeden aynı dönem için yeni veri gönderilmemelidir.

İşlem asenkron ilerleyebilir. Messages[], Data ve özetin CurrentStatus değeri birlikte izlenmelidir.

Önce aynı firma, şube ve dönem için güncel özet sorgulanmalıdır. Kayıt varsa dönen Uuid üzerinden izlenir; sonucu bilmeden yeni kayıt başlatılmaz.

Hayır. Şubesiz firma için sözleşme değeri 0000 gönderilir.

Tüm parçalar aktarıldıktan sonra ve CreateLedger öncesinde kontrol edilir. Teşhis mesajları boş, sayısal özet tutarlı ve IsReadyForLedgerCreation=true olmalıdır.

GetEntity veya özet sorgusundan alınan güncel LedgerSummaryViewModel kullanılır. Eski bir kopya veya yalnız Uuid içeren eksik model gönderilmemelidir.

Hayır. Platformun oluşturduğu ve gönderim cevabında ilişkilendirdiği gerçek dosya adı, GetBatchStatus ve ReceiveFile çağrılarında aynen kullanılmalıdır.

Endpoint, zaman, süre, firma, şube, dönem, Uuid, paket adı ve hata kodu izlenebilir olmalıdır. Token, parola ve tam defter içeriği maskelenmelidir.

Başarılı aylık üretim, hatalı veri teşhisi, timeout sonrası tekilleştirme, onay/imza, GİB sonucu, GİB onaylı berat indirme ve arşiv mutabakatı ayrı testlerle doğrulanmalıdır.

Hayır. Kaynak dosya VBT Client tarafından ayrıştırılır ve analiz edilir. TransferParsedFile endpointi Client'ın ürettiği ad/Base64 parçasını kabul eder; kaynak muhasebe dosyasını veya elle hazırlanmış XBRL'yi doğrudan alma endpointi değildir.

Hayır. Bu değer VBT Client'ın gerçek parça içeriğinin Base64 serileştirmesidir. Örnek JSON yalnız taşıma biçimini gösterir; Client çıktısı taklit edilmemelidir.

GetCurrentLedgerSumary firma/şube için güncel dönem özetini bulur. GetEntity ise bilinen Uuid ile tek kaydı getirir. Bir işlem başladıktan sonra en kesin izleme anahtarı saklanan Uuid'dir.

Hayır. /api/LedgerSummary/GetCurrentLedgerSumary yayımlanan route sözleşmesidir ve tek m ile çağrılır. İstemci tarafında farklı yazım kullanılmamalıdır.

Hayır. DiagnoseMessages boş olmalı; Descriptive içindeki parça, fiş, satır ve borç-alacak değerleri kaynak ERP ile tutarlı olmalıdır.

Üçü de ServiceResponse<string> döner. HTML endpointlerinde Data işaretleme metnidir; PDF ve ZIP endpointlerinde Data Base64 dosya içeriğidir. Base64 değer uygun uzantıyla byte dizisine çevrilir.

Hayır. Önce PreviousStatus, FailDescription ve Messages[] birlikte değerlendirilir. Kaynak veri hatası düzeltilmeden veya GİB sonucu netleşmeden yeniden üretim mükerrer kayıt riski taşır.

Mevcut ayın GİB onaylı beratları alınmış ve arşiv mutabakatı tamamlanmış olmalıdır. Aralık tamamlandığında sonraki yılın Ocak ayına geçilir.

Endpoint, zaman, firma, şube, dönem, Uuid, CurrentStatus, paket adı ve maskelenmiş hata cevabı paylaşılır. Parola, token, imza anahtarı ve tam defter içeriği paylaşılmaz.