Başlangıç
e-Envanter Defteri Nedir?
e-Envanter Defteri kapsamı, açılış ve kapanış kayıtları, belge seti ve bileşen sorumlulukları.
Temel Kavram
e-Envanter Defteri; işletmenin hesap dönemi başındaki ve sonundaki envanter kayıtlarının GİB'in yayımladığı elektronik formata göre oluşturulması, imzalanması veya mali mühürle onaylanması ve beratlarıyla birlikte GİB'e iletilmesi sürecidir. VBT e-Envanter Defteri, kaynak envanter verisinin alınmasından GİB onaylı beratın arşivlenmesine kadar bu yaşam döngüsünün yönetilmesini sağlar.
Standart takvim yılında açılış ve kapanış kayıtları ayrı işlemler olarak yürütülür. Açılış kaydı 1 Ocak, kapanış kaydı 31 Aralık tarihini esas alır; her işlemde dönem başlangıcı ve bitişi aynı günü gösterir.
Açılış ve Kapanış
| Kayıt | Standart takvim yılı tarihi | Anlam |
|---|---|---|
| Açılış envanteri | 1 Ocak | Hesap döneminin ilk gününe ait envanter defteri ve beratı; açılış onayı yerine geçer. |
| Kapanış envanteri | 31 Aralık | Hesap döneminin son gününe ait envanter defteri ve beratı; kapanış onayı yerine geçer. |
PeriodStart ile PeriodEnd açılışta aynı 1 Ocak tarihini, kapanışta aynı 31 Aralık tarihini taşır.
Belge Seti
- Envanter defteri: Envanter başlık ve satırlarını, hesap ve ölçülebilir kıymet bilgilerini taşır.
- Envanter beratı: Defterin firma, dönem ve teknik özetini taşır.
- GİB onaylı envanter beratı: GİB mali mührüyle onaylanan ve imzalı defterle birlikte saklanan sonuç dosyasıdır.
Teknik Kimlik
Firma VKN/TCKN'si, şube kodu ve açılış/kapanış tarihi işlem anahtarını oluşturur. Platformun döndürdüğü Uuid durum, onay, önizleme ve arşiv çıktılarında korunmalıdır.
Client ve API Sorumlulukları
e-Envanter Defteri iş akışı, kaynak dosyayı hazırlayan VBT Client ile belge yaşam döngüsünü yöneten API arasında ilerler.
| Bileşen | Sorumluluk | Sonraki aşamaya geçiş ölçütü |
|---|---|---|
| VBT Client | Kaynak dosyayı seçer; ZIP'i açar, CSV/XLS/XLSX/XML/XBRL içeriğini ayrıştırır, analiz eder, parçaları aktarır ve hazır aktarım için üretimi başlatır. | WaitingForInventoryEntityCreation, ardından WaitingForInventoryUblCreation. |
| API | Özet ve durumları sunar; envanter/berat üretimi, onay, GİB sonucu ve çıktı endpointlerini sağlar. | WaitingForApprove, WaitingForSign ve son olarak SentToGib. |
TransferParsedFile içeriği VBT Client tarafından üretilir. Bu ikili parça sözleşmesi, kaynak envanter satırlarını elle JSON'a dönüştürme endpointi değildir.Uçtan Uca Entegrasyon Yolculuğu
Email ve Password ile firma bağlamını oluştur.
1 Ocak açılış veya 31 Aralık kapanış kaydını belirle.
Envanter parçalarını yükle; analiz ve ölçü alanlarını doğrula.
Envanter ve berat dosyalarını oluştur; önizlemeyle mutabık kal.
Güncel özeti onayla; imza veya mali mühür sonucunu izle.
GİB onaylı beratı indir, tarih ve Uuid ile arşivle.