Sipariş Kalemi İptal

Teslim edemeyeceğiniz bir kalemi Cancelled duruma alır. Sebep kodu zorunludur.

POST/v1/orders/{orderId}/items/{itemId}/cancellationsscope:OrdersWrite

Yetkilendirme

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

Path parametreleri

Parametre	Açıklama
`orderId`	Hedef sipariş ID'si
`itemId`	İptal edilecek kalemin ID'si

Kalemin bu siparişe ve size ait olması gerekir; değilse yanıt 404 Not Found olur (403 değil — resource existence leak'i önlemek için).

İstek gövdesi

{
  "reasonCode": "OutOfStock",
  "reason": "Tedarikçi stoğu tükendi"
}

Alan	Tip	Zorunlu	Açıklama
`reasonCode`	string	evet	`OutOfStock`, `SupplierIssue`, `WrongProduct` ya da `Other`
`reason`	string	`Other` için	Serbest metin açıklama, en fazla 500 karakter

Hangi kalemler iptal edilebilir

Yalnızca henüz teslim edilmemiş kalemler: Pending, Reserved ve WaitingForSupply. Tamamlanmış bir kalem iptal edilemez — yanıt 422 olur. Teslim edilmiş bir siparişte sorun varsa iade akışını kullanın, bkz. İade Talepleri.

Yanıt

Başarılı iptalde 204 No Content, gövde yoktur.

İ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`	`reasonCode` geçersiz ya da `Other` için açıklama eksik
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Sipariş/kalem yok ya da size ait değil
`422`	Kalem bulunduğu durumda iptal edilemez
`429`	Hız limiti aşıldı