Sorumluluklar
Platform Sorumlulukları
VBT platformunun belge üretimi, imzalama, teslim ve GİB raporlama sorumlulukları.
Portal Kullanıcısı İçin Uçtan Uca Akış
Portal, e-SMM’nin hazırlanması, önizlenmesi, kaydedilmesi, çıktısının alınması ve sonradan izlenmesi için tek bir operasyon akışı sunar. Kullanıcı iş verisini girer; belge üretimi ve GİB raporlamasının teknik adımları VBT tarafından tamamlanır.
Otomatik İşlemler
| İşlem | Portal kullanıcısının yaptığı | VBT’nin tamamladığı |
|---|---|---|
| Firma ve düzenleyen bilgisi | Doğru firma oturumunu seçer. | Makbuzu düzenleyen tarafın kimlik, unvan ve adres bilgilerini firma kaydından tamamlar. |
| Belge numarası ve UUID | Gerekirse yıl/prefix seçimini yapar. | Belgeye tekil numara ve UUID atar. |
| Belge görünümü | Formu doldurur ve önizlemeyi kontrol eder. | PDF görünümünü üretir; kayıtta imzalı belge çıktısını oluşturur. |
| Elektronik teslim | Alıcı e-posta adresini girer veya seçer. | E-posta gönderim ve yeniden gönderim işlevlerini sağlar. |
| GİB raporlama | Rapor endpointi veya dosyası hazırlamaz. | Raporu oluşturur, imzalar, paketler, GİB’e gönderir ve durumunu takip eder. |
| İptal bildirimi | Portal’dan uygun belge için iptal işlemini başlatır. | İptal kaydını oluşturur ve mevzuata uygun GİB bildirim sürecine alır. |
Portal Formu ve Alan Davranışı
| Alan grubu | Portal davranışı | Kullanıcının kontrolü |
|---|---|---|
| Alıcı | Gerçek/tüzel kişi seçimine göre ilgili ad alanları gösterilir; mükellef yardımcılarıyla profil, adres ve vergi dairesi bilgileri getirilebilir. | Seçilen kaydın doğru kişi/kuruma ait olduğunu doğrular. |
| Hizmet satırları | Bir veya daha fazla hizmet satırı eklenebilir; oran ve tutarlar form üzerinde gösterilir. | Hizmet açıklaması, brüt tutar ve oranları işlemle karşılaştırır. |
| Para birimi | TRY veya döviz seçimine göre kur alanları kullanılır. | Döviz kodu ve işlem kurunun doğru olduğunu doğrular. |
| Vergi/kesinti | KDV, stopaj ve tevkifat alanları aynı makbuz üzerinde yönetilir. | Oran, kod ve nihai tahsilat tutarını kontrol eder. |
| Teslim | Elektronik veya kâğıt teslim seçilebilir; elektronik teslimde e-posta işlevleri açılır. | E-posta adresini ve teslim tercihini doğrular. |
Validasyon ve Hata Davranışı
Portal, API ile aynı belge sözleşmesini kullanır. Eksik veya uyumsuz veri olduğunda belge tamamlanmış sayılmaz; hata bilgileri formda ilgili iş alanına dönük biçimde gösterilir.
| Kontrol grubu | Kod | Örnek hata | Kullanıcı aksiyonu |
|---|---|---|---|
| Taraf | SMM003–SMM007, SMM011–SMM018 | VKN/TCKN, ad-soyad, unvan veya vergi dairesi eksik | Alıcı kartını düzeltir veya yeniden seçer. |
| Adres | SMM019–SMM022 | Ülke, ilçe/semt veya şehir eksik | Adres bilgilerini tamamlar. |
| Belge | SMM002, SMM008/SMM009 | Tarih veya dış referans eksik | Belge başlık bilgilerini düzeltir. |
| Para birimi | SMM010 | Dövizli belgede kur yok | İşlem kurunu girer. |
| Vergi/kesinti | SMM008/SMM009 | Oran geçersiz veya toplamlar uyumsuz | Satır ve üst toplamları yeniden hesaplar. |
Önizleme, PDF ve Belge Paketi
Portal, kaydetmeden önce taslak PDF önizlemesi sunar. Kayıt sonrasında imzalı PDF tekil veya çoklu olarak alınabilir; belge paketi seçeneği görüntüleme/indirme akışlarında kullanılır.
| İşlev | Ne zaman kullanılır? | Sonuç |
|---|---|---|
| Taslak önizleme | Kaydetmeden önce taraf, hizmet ve toplam görünümünü kontrol etmek için | Geçici PDF içeriği; belge numarası üretildiği anlamına gelmez. |
| PDF görüntüleme | Kaydedilmiş tek belgeyi ekranda göstermek için | PDF dosya içeriği |
| Çoklu PDF | Listeden seçilen belgeleri birlikte indirmek için | Tek veya birleştirilmiş PDF çıktısı |
| Belge paketi | Portal görüntüleme/indirme deneyimi için | Dosya adı, içerik ve görüntüleme bilgileri |
Listeleme, Arama ve Durum İzleme
Portal grid ve global arama uçları; UUID, belge numarası, dış referans, alıcı, tarih, e-posta, rapor ve iptal durumlarına göre filtreleme sağlar. İşlem logu, belgenin oluşturulması, görüntülenmesi, PDF alınması, e-posta ve iptal gibi kullanıcıya anlamlı hareketlerini gösterir.
| Görünüm | Temel filtreler | Kullanım |
|---|---|---|
| e-SMM grid | UUID, alıcı, belge no, dış referans, düzenleme tarihi, durum | Günlük belge operasyonu |
| Global arama | Serbest arama ve sayfalama | Modüller arası hızlı erişim |
| İşlem logu | Belge UUID’si, tarih ve işlem türü | Belge geçmişini inceleme |
| Rapor durumları | Normal ve iptal raporu filtreleri | Portal görünümünde raporlama sonucunu izleme |
E-posta ve Yeniden Gönderim
Elektronik teslimde Portal, sayfa seçimi veya global seçim üzerinden belgeyi e-posta gönderimine alabilir. Başarısız ya da yeniden gönderilmesi gereken kayıtlar tekil veya çoklu biçimde tekrar gönderime hazırlanabilir.
Mükellef ve Vergi Yardımcıları
Portal formunda alıcı veya düzenleyen bilgi kalitesini artırmak için mükellef profili, izin verilen KDV oranları, NACE kodları, faaliyetler, adresler, tarih bazlı aktiflik ve vergi dairesi arama işlevleri kullanılabilir.
| Yardımcı | Portal kullanım amacı |
|---|---|
| Mükellef profili | Kimlik numarasına bağlı temel mükellef bilgilerini getirir. |
| İzin verilen KDV oranları | Mükellef ve tarih bağlamında kullanılabilecek oranları gösterir. |
| NACE / faaliyet | Mesleki faaliyet bilgisini seçimlerde destekler. |
| Adresler | Kayıtlı adreslerden doğru belge adresinin seçilmesini sağlar. |
| Aktiflik | Mükellefin belirli tarihte aktif olup olmadığını gösterir. |
| Vergi dairesi | Kod veya adla vergi dairesi kaydını bulur. |
GİB Raporlama Sorumluluğu
Gün sonu raporunun oluşturulması, imzalanması, paketlenmesi, GİB’e gönderilmesi, sonuç sorgulaması ve gerektiğinde iptal raporunun hazırlanması VBT tarafından yürütülür. Portal kullanıcısı veya entegratör bu teknik rapor uçlarını çağırmaz.
İptal Davranışı
Portal yalnız mevcut ve iptale uygun belge için iptal işlemini başlatır. Başarılı iptalden sonra belge listesi ve log görünümü güncellenir; GİB iptal bildirimi VBT raporlama sürecinde tamamlanır. İptal edilen işlem yeniden belgelenecekse yeni belge oluşturulur.