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.