e-Fatura

Giden Fatura

Giden Fatura Portal API

Portal giden fatura listesi, görüntüleme, e-posta, belge numarası ve mükellef sorgu endpointleri.

Kapsam: Bu endpointler VBT Portal'ın giden fatura ekranlarında kullandığı UI sözleşmeleridir. Sunucudan sunucuya entegrasyon için Giden Fatura Entegratör API sayfasını kullanın.

Listeleme ve Global Arama

EndpointRequestResponseAmaç
POST /api/Invoice/GetOutgoingInvoiceGridListSearchUIRequestModel<OutgoingInvoiceGetUiRequestModel>SearchResponseModel<OutgoingInvoiceGridResponseModel>Filtreli ve sayfalı giden fatura gridini döner.
POST /api/Invoice/GetGlobalSearchOutgoingInvoiceListSearchUIRequestModel<GlobalSearchRequestModel>SearchResponseModel<OutgoingInvoiceGridResponseModel>Portal global aramasındaki giden fatura sonuçlarını döner.

Görüntüleme, Okundu Bilgisi ve Geçmiş

EndpointRequestResponseGözlenebilir sonuç
POST /api/Invoice/GetOutgoingInvoiceViewInvoiceViewRequestModelInvoiceViewResponseModelFaturanın Portal'da gösterilecek HTML görünümünü döner.
POST /api/Invoice/OutgoingInvoiceIsReadInvoiceViewRequestModelboolSeçilen faturanın okundu bilgisini günceller.
POST /api/Invoice/GetOutgoingInvoiceHistorySearchRequestModel<string>SearchResponseModel<OutgoingInvoiceHistoryResponseModel>Faturanın kullanıcıya gösterilen işlem geçmişini döner.

E-posta İşlemleri

EndpointRequestResponseKullanım
POST /api/Invoice/AddMailOutgoingInvoicePageMailSendRequestModelboolSayfada seçilen faturaları e-posta gönderimine alır.
GET /api/Invoice/ResetOutgoingInvoiceMailQueueidboolTek faturayı yeniden e-posta gönderimine hazırlar.
POST /api/Invoice/ResetOutgoingInvoiceMailQueueListList<string> — ETTN listesiList<MailStateResponseModel>Birden fazla faturanın yeniden gönderim sonucunu ayrı ayrı döner.
POST /api/Invoice/AddMailGlobalOutgoingInvoiceGlobalMailRequestModelboolGlobal arama seçimini toplu e-posta gönderimine alır.

Numara ve Mükellef Hazırlığı

POST/api/NumberManagement/GetInvoiceNumberPrefixList

Belirtilen yıl için kullanılabilir fatura numarası öneklerini döner.

RequestNumberPrefixRequestModel
ResponseIList<NumberPrefixResponseModel>

Alıcının e-Fatura mükellefiyeti Portal'da GetGibInvoiceUser işlemiyle sorgulanır. Seçilen alıcı VKN/TCKN ve etiket sonucu, giden request'in alıcı kimliğiyle uyumlu olmalıdır.

Oluşturma Ekranında Parametre ve Senaryo Kontrolü

Portal; profil, fatura tipi, birim ve para birimi listelerini backend parametrelerinden yükler. Bu temel gruplardan biri yüklenemezse Kaydet, Güncelle ve Önizle işlemleri engellenir ve ekranda eksik grup bilgisi gösterilir.

Seçilen kapsamPortal kontrolüKullanıcı davranışı
ENERJI + SARJ/SARJANLIKDönem tarih/saatleri, tek PLAKA, tipe göre ESURaporID veya ESU seri numarasıEksik veya biçimi hatalı alan düzeltilmeden kayıt/önizleme yapılmaz.
IDISIdisSevkiyatNo için SE-/ES- + 7 rakam ve her kalemde ETIKETNOGeçersiz sevkiyat veya etiket numarası ekranda bildirilir.
YATIRIMTESVIKTek, 6 haneli YTBNO referansı/tarihi ve kalem harcama tipiEksik YTB alanları tamamlanır.
TEKNOLOJIDESTEKÜrün sınıfı seçenekleri backend'den ayrıca yüklenir.Bu liste eksikse yalnız TEKNOLOJIDESTEK kaydı engellenir; diğer fatura tipleri kullanılabilir.
Yeniden yükleme: Parametreleri tekrar yükle işlemi mevcut belge ve kalemleri temizlemeden listeleri yeniler. Ayrıntı/güncelleme ekranında enerji dönemi, plaka, belge referansları, seri numaraları ve sınıflandırma değerleri kaydedilmiş request yapısıyla yeniden gösterilir.