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
| Endpoint | Request | Response | Amaç |
|---|---|---|---|
POST /api/Invoice/ | SearchUIRequestModel<OutgoingInvoiceGetUiRequestModel> | SearchResponseModel<OutgoingInvoiceGridResponseModel> | Filtreli ve sayfalı giden fatura gridini döner. |
POST /api/Invoice/ | SearchUIRequestModel<GlobalSearchRequestModel> | SearchResponseModel<OutgoingInvoiceGridResponseModel> | Portal global aramasındaki giden fatura sonuçlarını döner. |
Görüntüleme, Okundu Bilgisi ve Geçmiş
| Endpoint | Request | Response | Gözlenebilir sonuç |
|---|---|---|---|
POST /api/Invoice/ | InvoiceViewRequestModel | InvoiceViewResponseModel | Faturanın Portal'da gösterilecek HTML görünümünü döner. |
POST /api/Invoice/ | InvoiceViewRequestModel | bool | Seçilen faturanın okundu bilgisini günceller. |
POST /api/Invoice/ | SearchRequestModel<string> | SearchResponseModel<OutgoingInvoiceHistoryResponseModel> | Faturanın kullanıcıya gösterilen işlem geçmişini döner. |
E-posta İşlemleri
| Endpoint | Request | Response | Kullanım |
|---|---|---|---|
POST /api/Invoice/ | MailSendRequestModel | bool | Sayfada seçilen faturaları e-posta gönderimine alır. |
GET /api/Invoice/ | id | bool | Tek faturayı yeniden e-posta gönderimine hazırlar. |
POST /api/Invoice/ | List<string> — ETTN listesi | List<MailStateResponseModel> | Birden fazla faturanın yeniden gönderim sonucunu ayrı ayrı döner. |
POST /api/Invoice/ | GlobalMailRequestModel | bool | Global 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.
| Request | NumberPrefixRequestModel |
| Response | IList<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 kapsam | Portal kontrolü | Kullanıcı davranışı |
|---|---|---|
ENERJI + SARJ/SARJANLIK | Dö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. |
IDIS | IdisSevkiyatNo için SE-/ES- + 7 rakam ve her kalemde ETIKETNO | Geçersiz sevkiyat veya etiket numarası ekranda bildirilir. |
YATIRIMTESVIK | Tek, 6 haneli YTBNO referansı/tarihi ve kalem harcama tipi | Eksik 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.