Giden Fatura

Giden Fatura Entegratör API

Giden faturayı doğrulama, oluşturma, güncelleme, gönderme, sorgulama ve durum takibi endpoint sözleşmeleri.

Ön koşul: Aşağıdaki çağrılardan önce API Temelleri sayfasındaki token ve header sözleşmesini uygulayın. Tam JSON gövdeleri için Giden Fatura Request Örnekleri sayfasını kullanın.

Doğrulama, Önizleme ve Oluşturma

Önizleme endpointleri request'i kaydetmeden doğrular ve PDF üretir. Oluşturma endpointleri JSON, hazır UBL, XML metni veya Excel girdisini kabul eder.

POST/api/VbtApi/OutgoingInvoicePreview

JSON request'i doğrular ve kaydetmeden PDF önizlemesi döner.

Request	`OutgoingInvoiceRequestModel`
Response	`OutgoingInvoicePreviewResponseModel` — `InvoicePdfFileBytes`, `HasError`, `Errors[]`

POST/api/VbtApi/OutgoingInvoiceUblPreview

Hazır UBL belgesini doğrular ve kaydetmeden PDF önizlemesi döner.

Request	`InvoiceUblRequestModel`
Response	`OutgoingInvoicePreviewResponseModel`

POST/api/VbtApi/AddOutgoingInvoice

JSON modelinden yeni giden e-Fatura oluşturur.

Request	`OutgoingInvoiceRequestModel`
Response	`OutgoingInvoiceAddResponseModel` — `InvoiceNumber`, `Ettn`, `PdfUrl`, `XmlUrl`, `HasError`, `Errors[]`

POST/api/VbtApi/AddOutgoingInvoiceByUbl

Hazır UBL Invoice içeriğiyle yeni giden e-Fatura oluşturur.

Request	`InvoiceUblRequestModel` — dış referans, alıcı etiketi, dosya içeriği ve paketleme bilgileri
Response	`OutgoingInvoiceAddResponseModel`

POST/api/VbtApi/AddOutgoingInvoiceByXml

XML metniyle yeni giden e-Fatura oluşturur.

Request	`XmlRequestModel`
Response	`ResponseModel<XmlResponseModel>`

POST/api/VbtApi/AddOutgoingInvoiceByExcel

Excel girdisindeki faturaları toplu işler; her satır için ayrı sonuç döner.

Request	`ExcelFileRequestModel`
Response	`List<OutgoingInvoiceAddExcelResponseModel>`

Güncelleme

Güncelleme çağrıları yalnız kesinleşmemiş belge için kullanılır. Hedef belge request kimliği veya UBL kimliğiyle açıkça belirlenmelidir.

POST/api/VbtApi/UpdateOutgoingInvoice

Mevcut giden faturayı JSON modeliyle günceller.

Request	`OutgoingInvoiceRequestModel` — `Id` veya `UUId` ile
Response	`OutgoingInvoiceUpdateResponseModel`

POST/api/VbtApi/UpdateOutgoingInvoiceByUbl

Mevcut giden faturayı hazır UBL içeriğiyle günceller.

Request	`InvoiceUblRequestModel`
Response	`OutgoingInvoiceUpdateResponseModel`

POST/api/VbtApi/UpdateOutgoingInvoiceByXml

Mevcut giden faturayı XML request'iyle günceller.

Request	`XmlRequestModel`
Response	`ResponseModel<XmlResponseModel>`

Gönderim ve Durum Takibi

POST/api/VbtApi/SendOutgoingInvoiceToGib

Oluşturulmuş faturayı GİB gönderim sürecine alır.

Request	`OutgoingInvoiceSendToGibRequestModel` — belge kimliği
Response	`bool`

POST/api/VbtApi/GetOutgoingInvoicesStatus

Bir veya daha fazla giden faturanın teknik ve kullanıcı durumunu döner.

Request	`OutgoingInvoiceSummaryStatusRequestModel` — `EttnList[]`
Response	`OutgoingInvoiceSummaryStatusResponseModel` — kimlik, teknik durum, kullanıcı durumu ve zarf bilgisi

POST/api/VbtApi/UpdateOutgoingInvoiceErpProcessStatus

Yerel ERP işlemi tamamlandıktan sonra belge üzerindeki ERP işleme bilgisini günceller.

Request	`InvoiceErpProcessRequestModel` — `Ettn`, `ErpProcessBranch`, `IsErpProcessed`
Response	`bool`

Sorgulama ve Belge Çıktıları

GET/api/VbtApi/GetOutgoingInvoice?id={ETTN}

ETTN ile tek giden faturanın ayrıntısını getirir.

Request	`id` — ETTN/GUID
Response	`OutgoingInvoiceResponseModel`

POST/api/VbtApi/GetOutgoingInvoiceList

Filtreli ve sayfalı giden fatura özet listesini getirir.

Request	`SearchRequestModel<OutgoingInvoiceGetRequestModel>`
Response	`SearchResponseModel<OutgoingInvoiceSummaryResponseModel>`

POST/api/VbtApi/GetOutgoingInvoicePdf

İstenen giden faturaların PDF içeriklerini döner.

Request	`InvoicePdfRequestModel` — `InvoiceEttns[]`
Response	`InvoicePdfResponseModel` — base64 dosya içeriği

POST/api/VbtApi/GetOutgoingInvoiceView

Tek faturanın HTML görünümünü döner.

Request	`InvoiceViewRequestModel` — `Ettn`, `IsRead`
Response	`InvoiceViewResponseModel` — `InvoiceHtmlView`

POST/api/Invoice/GetOutgoingInvoiceDocumentPackage

Seçilen giden faturaların XML/PDF belge paketini üretir.

Request	`GlobalDocumentPreviewRequestModel` — belge listesi ve çıktı seçimi
Response	`DocumentPreviewResponseModel` — dosya içeriği, adı ve uzantısı

İptal ve İtiraz

POST/api/Invoice/CancelOutgoingInvoice

İptal işlemini destekleyen profillerde giden faturayı iptal olarak işaretler.

Request	`InvoiceCancelRequestModel` — dış referans, ETTN veya fatura numarası
Response	`bool`

POST/api/Invoice/ObjectOutgoingInvoice

Giden faturaya itiraz belgesi bilgilerini kaydeder.

Request	`DocumentObjectionRequestModel` — `UUId`, belge tarihi/numarası, itiraz tipi ve açıklaması
Response	`bool`