Fatura Dosyası Yükle

Fatura Oluştur ile açtığınız Pending faturaya PDF'i ekler. Fatura numarası ve tarihi de bu adımda verilir; yükleme başarılı olunca fatura Uploaded durumuna geçer.

Yetkilendirme

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

İstek

multipart/form-data ile gönderilir.

Yalnızca PDF kabul edilir; içeriği de PDF olarak doğrulanır, uzantıyı değiştirmek yeterli değildir.

Yanıt

201 Created ile faturanın güncel hâli döner; Location header'ı dosyanın indirme adresini gösterir. Alan açıklamaları için Fatura Oluştur sayfasına bakın.

{
  "id": "019ff2645beb70f1b010d93780ae1979",
  "orderId": "019ebadd24d87401ae32da7a86c2bd70",
  "documentType": "SalesInvoice",
  "status": "Uploaded",
  "invoiceNumber": "FT-2026-1",
  "invoiceDate": "2026-08-01",
  "fileSize": 33393,
  "originalFileName": "fatura.pdf",
  "relatedInvoiceId": null,
  "uploadedAt": "2026-08-11T19:54:51.4738713+00:00",
  "createdAt": "2026-08-11T19:54:51.24392+00:00"
}

Path parametresi

Yalnızca kendi kaynaklarınızı görebilirsiniz. Başka satıcıya ait bir ID için yanıt 404 Not Found olur (403 değil — resource existence leak'i önlemek için).

İdempotency

Idempotency-Key header'ı opsiyoneldir ama önerilir. Aynı key ile gelen sonraki başarılı istek cached response döner. Detay: Idempotency.

Hata kodları