Fatura Oluştur

Bir sipariş için boş fatura kaydı açar. Kayıt Pending durumunda oluşur; fatura PDF'ini ardından Fatura Dosyası Yükle ile eklersiniz.

POST/v1/order-invoicesscope:InvoicesWrite

Yetkilendirme

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

İstek gövdesi

Alan	Tip	Zorunlu	Açıklama
`orderId`	string(32)	evet	Faturalanacak sipariş
`documentType`	string	evet	`SalesInvoice` ya da `CreditNote`
`relatedInvoiceId`	string(32)	`CreditNote` için	İadenin dayandığı satış faturasının kimliği

{
  "orderId": "019ebadd24d87401ae32da7a86c2bd70",
  "documentType": "SalesInvoice"
}

SalesInvoice için siparişteki tüm kalemleriniz sonuçlanmış olmalı (Completed, Cancelled veya Refunded) ve bunlardan en az biri Completed ya da Refunded olmalı. Tamamı iptal edilmiş bir siparişte satılan bir şey yoktur; fatura kesilemez.

CreditNote için siparişte iade edilmiş (Refunded) en az bir kaleminiz olmalı ve relatedInvoiceId, yüklenmiş bir satış faturanızı göstermelidir.

Aynı sipariş ve belge tipi için ikinci bir fatura açılamaz.

Yanıt

201 Created. Dosya henüz yüklenmediği için dosya alanları boş döner.

{
  "id": "019ff2645beb70f1b010d93780ae1979",
  "orderId": "019ebadd24d87401ae32da7a86c2bd70",
  "documentType": "SalesInvoice",
  "status": "Pending",
  "invoiceNumber": null,
  "invoiceDate": null,
  "fileSize": null,
  "originalFileName": null,
  "relatedInvoiceId": null,
  "uploadedAt": null,
  "createdAt": "2026-08-11T19:54:51.24392+00:00"
}

Alanlar

Alan	Tip	Açıklama
`id`	string	Fatura kimliği — dosya yüklerken bu kullanılır
`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üklenirken verilir
`invoiceDate`	date	Fatura tarihi (`YYYY-MM-DD`) — dosya yüklenirken verilir
`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

İdempotency

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

Hata kodları

Code	Anlam
`400`	İstek gövdesi geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Sipariş bulunamadı veya bu siparişte kaleminiz yok
`409`	Sipariş faturaya hazır değil, iade bağlamı yok ya da bu fatura zaten var
`429`	Hız limiti aşıldı