Fatura Listele

Sipariş faturalarınızı listeler.

GET/v1/order-invoicesscope:InvoicesRead

Yetkilendirme

Bu endpoint InvoicesRead scope'u gerektirir. Bkz. İzinler.

Query parametreleri

Sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için Sayfalama sayfasına bakın.

Parametre	Tip	Açıklama
`orderId`	string(32)	Tek bir siparişin faturaları
`status`	string	`Pending` ya da `Uploaded`
`documentType`	string	`SalesInvoice` ya da `CreditNote`

orderBy şu alanlardan biri olabilir: CreatedAt, UploadedAt, InvoiceDate, InvoiceNumber, Status.

Yanıt formatı

200 OK ile birlikte pagination header'ları (X-Total-Count, X-Page, X-Page-Size, X-Next-Page, X-Prev-Page) döner. Body sadece kayıt dizisini içerir.

[
  {
    "id": "019e204815c570199a91b921491a0993",
    "orderId": "019e1e231d99722e8631e246d4accb74",
    "documentType": "SalesInvoice",
    "status": "Uploaded",
    "invoiceNumber": "FT20260513",
    "invoiceDate": "2026-05-13",
    "fileSize": 33393,
    "originalFileName": "fatura.pdf",
    "relatedInvoiceId": null,
    "uploadedAt": "2026-05-13T08:17:12.525037+00:00",
    "createdAt": "2026-05-13T07:40:55.621395+00:00"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Fatura kimliği
`orderId`	string	Faturanın ait olduğu sipariş
`documentType`	string	`SalesInvoice` veya `CreditNote`
`status`	string	`Pending` (dosya bekliyor) veya `Uploaded`
`invoiceNumber`	string	Fatura numarası; dosya yüklenene kadar boştur
`invoiceDate`	date	Fatura tarihi (`YYYY-MM-DD`); dosya yüklenene kadar boştur
`fileSize`	number	Yüklenen PDF'in bayt cinsinden boyutu
`originalFileName`	string	Yüklediğiniz dosyanın adı
`relatedInvoiceId`	string	`CreditNote` ise ilişkili satış faturası
`uploadedAt`	datetime	Dosyanın yüklendiği an, ISO 8601, UTC
`createdAt`	datetime	Fatura kaydının açıldığı an, ISO 8601, UTC

Hata kodları

Code	Anlam
`400`	Sayfalama veya filtre değeri geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`429`	Hız limiti aşıldı