Gelen Fatura

Gelen Fatura Entegratör API

Gelen faturayı listeleme, ayrıntılandırma, yanıtlama, durum sorgulama, ERP işleme ve çıktı alma endpointleri.

Ön koşul: API Temelleri sayfasındaki token ve header sözleşmesini uygulayın. Kopyalanabilir gövdeler için Gelen Fatura İşlem Örnekleri sayfasına geçin.

Listeleme ve Ayrıntı

POST/api/VbtApi/GetIncomingInvoiceList

Gelen faturaları filtreli ve sayfalı özet liste olarak döner.

Request	`SearchRequestModel<IncomingInvoiceGetRequestModel>`
Response	`SearchResponseModel<IncomingInvoiceSummaryResponseModel>`
Kullanım	Yeni belgeleri periyodik olarak almak ve ETTN ile tekilleştirmek

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

ETTN ile tek gelen faturanın ayrıntılı modelini döner.

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

POST/api/VbtApi/GetDetailedIncomingInvoiceList

Bir veya daha fazla ETTN için ayrıntılı gelen fatura modellerini toplu döner.

Request	`IncomingInvoiceListRequestModel` — `EttnList[]`
Response	`IncomingInvoiceListResponseModel`

Durum ve ERP Mutabakatı

POST/api/VbtApi/GetIncomingInvoicesStatus

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

Request	`IncomingInvoiceSummaryStatusRequestModel` — `EttnList[]`
Response	`IncomingInvoiceSummaryStatusResponseModel` — `IncomingInvoiceStatusList[]`
Ana alanlar	`UUId`, `InvoiceNumber`, `IncomingInvoiceStatus`, `IncomingInvoiceStatusForUser`

POST/api/VbtApi/UpdateIncomingInvoiceErpProcessStatus

Yerel işlem başarıyla tamamlandıktan sonra tek faturanın ERP işleme bilgisini günceller.

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

POST/api/VbtApi/UpdateIncomingInvoicesErpProcessStatus

Birden fazla gelen faturanın ERP işleme bilgisini toplu günceller.

Request	`InvoiceErpProcessRequestListModel`
Response	`bool`

Kabul veya Red Uygulama Yanıtı

Bu işlem yalnız uygulama yanıtı bekleyen faturada kullanılır. İşlem sonucunu tek HTTP cevabıyla tamamlandı saymayın; durum endpointiyle terminal sonucu izleyin.

POST/api/VbtApi/ApproveOrRejectIncomingInvoice

Gelen faturaya kabul veya red uygulama yanıtı oluşturur.

Request	`IncomingInvoiceApproveRequestModel` — `Ettn`, `ForwardForApproveOrReject`, `ApplicationResponseNote`
Karar değerleri	`ForwardForApprove` veya `ForwardForReject`
Response	`bool`

XML, PDF, HTML ve Belge Paketi

POST/api/VbtApi/GetIncomingInvoiceXmlList

ETTN listesindeki gelen faturaların XML içeriklerini döner.

Request	`IncomingInvoiceXmlRequestModel` — `InvoiceEttns[]`
Response	`IncomingInvoiceXmlResponseModel`

POST/api/VbtApi/GetIncomingInvoiceUblXmlListZip

Filtreye uyan UBL XML belgelerini ZIP paketi olarak döner.

Request	`SearchRequestModel<IncomingInvoiceUblXmlZipRequestModel>`
Response	`IncomingInvoiceUblXmlZipResponseModel`

POST/api/VbtApi/GetIncomingInvoicePdf

ETTN listesindeki gelen faturaların PDF içeriklerini döner.

Request	`InvoicePdfRequestModel` — JSON alanı `InvoiceEttns[]`
Response	`InvoicePdfResponseModel`

POST/api/VbtApi/GetIncomingInvoiceView

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

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

POST/api/Invoice/GetIncomingInvoiceDocumentPackage

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

Request	`GlobalDocumentPreviewRequestModel`
Response	`DocumentPreviewResponseModel` — dosya içeriği, adı ve uzantısı

İptal ve İtiraz

POST/api/Invoice/CancelIncomingInvoice

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

Request	`InvoiceCancelRequestModel`
Response	`bool`

POST/api/Invoice/ObjectIncomingInvoice

Gelen faturaya itiraz belgesi bilgilerini kaydeder.

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