Referans
Sıkça Sorulan Sorular
Açılış, kapanış, berat, durum, imza, GİB ve arşivleme hakkında sık sorulan sorular.
| Konu | Kaynak bölüm |
|---|---|
| Açılış ve kapanış kapsamı | e-Envanter Defteri Nedir? |
| İşlem sırası ve durumlar | e-Envanter Defteri Akışı |
| API işlemleri | Entegrasyon API Endpoint Referansı |
| Alan eşleştirmeleri | Veri → UBL Mapping |
Kullanım ve Operasyon
e-Envanter Defteri aylık mı hazırlanır?
Hayır. Standart takvim yılında hesap döneminin ilk günü için açılış, son günü için kapanış envanteri hazırlanır.
Açılış ve kapanış tek dosyada mı gönderilir?
Hayır. 1 Ocak ve 31 Aralık ayrı dönem kayıtları, ayrı envanter dosyaları ve ayrı beratlarla izlenir.
PDF yasal envanterin yerine geçer mi?
Hayır. PDF görüntüleme içindir. İmzalı envanter XML'i ve GİB onaylı berat birlikte muhafaza edilir.
Kapanış onayı neyle kanıtlanır?
Hesap döneminin son gününe ait imzalı envanter defteri ile GİB mali mührüyle onaylanmış envanter beratı birlikte kanıttır.
Ölçülebilir kıymetler nasıl gösterilir?
Kıymet kimliği, açıklaması, miktarı ve ölçü birimi birlikte aktarılır. Yalnız tutar göndermek fiziksel ölçü bilgisi gereken kaydı tamamlamaz.
Açılış tamamlanmadan kapanış hazırlanabilir mi?
İş akışı aynı yıl için önce 1 Ocak açılışını, ardından 31 Aralık kapanışını izler. Açılışın hata ve GİB sonucu netleşmeden kapanış kaydını tamamlanmış kabul etmeyin.
Açılış ve kapanış aynı UUID'yi kullanır mı?
Hayır. İki kayıt farklı tek günlük tarihlere, ayrı envanter/berat dosyalarına ve ayrı Uuid değerlerine sahiptir.
e-Envanter için hangi dosyalar birlikte saklanmalıdır?
İmzalı envanter XML'i, imzalı mükellef beratı ve GİB onaylı envanter beratı aynı firma, şube, tarih ve Uuid ile ilişkilendirilmelidir. PDF/HTML yasal teknik dosyanın yerine geçmez.
Bir envanter birden fazla parçadan oluşabilir mi?
Evet. Kaynak büyüklüğüne göre parçalar oluşabilir. Tüm parçalar aynı açılış veya kapanış anahtarıyla aktarılır; parça sayısı ile ilk/son kayıt ve satır numaraları süreç raporunda doğrulanır.
Teknik Entegrasyon
PeriodStart ve PeriodEnd neden aynı?
Envanter dönemi bütün yıl aralığı değil, açılış veya kapanış günüdür. Açılışta ikisi de 1 Ocak, kapanışta ikisi de 31 Aralık gönderilir.
Yıl içindeki bir ay için envanter oluşturabilir miyim?
Hayır. Desteklenen standart sözleşmede yalnız açılış ve kapanış tarihleri kullanılır.
GetProcessReport hangi iki hazır bilgisini döndürür?
IsReadyForInventoryEntityCreation kayıt üretimine, IsReadyForInventoryUblCreation envanter XML üretimine hazırlığı gösterir. Teşhis mesajları da boş olmalıdır.
Timeout sonrası CreateInventory tekrar çağrılır mı?
Önce firma, şube ve açılış/kapanış tarihi için güncel özet sorgulanır. Var olan kayıt aynı Uuid üzerinden izlenir.
InventoryApproval için yalnız UUID yeterli mi?
Hayır. Güncel özet sorgusundan alınan InventorySummaryViewModel kullanılmalıdır; eksik veya eski modelle durum geçişi yapılmamalıdır.
GİB paket adı nasıl belirlenir?
Paket adı platform tarafından üretilir. Durum ve dosya alma çağrılarında platformun döndürdüğü gerçek ad aynen kullanılır.
Canlıya geçişte hangi testler zorunludur?
Açılış ve kapanış için başarılı üretim, hatalı veri teşhisi, timeout tekilleştirmesi, onay/imza, GİB sonucu, GİB onaylı berat indirme ve XML arşiv mutabakatı ayrı ayrı kanıtlanmalıdır.
Kaynak dosya doğrudan API'ye gönderilebilir mi?
Hayır. Kaynak VBT Client tarafından ayrıştırılır ve analiz edilir. TransferParsedFile, Client'ın ürettiği ad/Base64 parçasını kabul eder; kaynak dosyayı veya elle hazırlanmış envanter XML'ini doğrudan alma endpointi değildir.
ParsedFile.Value alanını kendim üretebilir miyim?
Hayır. Bu değer VBT Client'ın gerçek parça içeriğinin Base64 serileştirmesidir. Dokümandaki örnek yalnız taşıma biçimini gösterir.
GetCurrentInventorySummary ile GetEntity arasındaki fark nedir?
GetCurrentInventorySummary firma/şube için güncel açılış veya kapanış kaydını bulur. GetEntity bilinen Uuid ile tek kaydı getirir. İşlem başladıktan sonra saklanan Uuid en kesin izleme anahtarıdır.
İki hazır bilgisinden biri false ise ne yapılır?
IsReadyForInventoryEntityCreation veya IsReadyForInventoryUblCreation değerlerinden biri false ise CreateInventory çağrılmamalıdır. Teşhis, parça ve kayıt özetleri incelenip eksik aşama tamamlanmalıdır.
Ölçü birimi serbest metin olabilir mi?
Hayır. MeasurableUnitOfMeasure yalnız mapping sayfasındaki kabul edilen kodlardan biri olmalıdır. Karşılaştırma büyük/küçük harfe duyarsız olsa da standart kod biçimini göndermek önerilir.
HTML, PDF ve ZIP response'ları nasıl ayrılır?
Üçü de ServiceResponse<string> döner. HTML endpointlerinde Data işaretleme metnidir; PDF ve ZIP endpointlerinde Base64 dosya içeriğidir.
Failed durumunda doğrudan yeniden üretim yapılabilir mi?
Hayır. PreviousStatus, FailDescription ve Messages[] birlikte okunur. Tarih, ölçü alanı veya GİB sonucu netleşmeden yeniden üretim mükerrer kayıt riski taşır.
Kapanıştan sonra hangi dönem gelir?
31 Aralık kapanışı tamamlandıktan sonra sonraki yılın 1 Ocak açılışına geçilir. Şubat-Kasım arasında ayrı envanter dönemi yoktur.
Destek talebinde ne paylaşılmalıdır?
Endpoint, zaman, firma, şube, açılış/kapanış tarihi, Uuid, CurrentStatus, paket adı ve maskelenmiş hata cevabı paylaşılır. Parola, token, imza anahtarı ve tam envanter içeriği paylaşılmaz.