Hakediş Kalemleri

Bir hakedişi oluşturan satırları döner. Kalemlerin net tutarları toplandığında hakedişin netAmount değeri çıkar.

GET/v1/settlements/{settlementId}/itemsscope:FinanceRead

Yetkilendirme

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

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).

Query parametreleri

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

Parametre	Tip	Açıklama
`type`	string	`Sale`, `Refund`, `AdvertisingFee`

orderBy şu alanlardan biri olabilir: CreatedAt, Type, GrossAmount, CommissionAmount, NetAmount.

Yanıt formatı

200 OK ile birlikte pagination header'ları döner; body kayıt dizisidir.

[
  {
    "id": "3383ad045acd4077879313d56f6bb288",
    "orderItemId": "019ebbce76257cdf9453de6787aa4e7d",
    "type": "Sale",
    "grossAmount": 455.0,
    "commissionRate": 5.0,
    "commissionAmount": 22.75,
    "commissionVatAmount": 4.55,
    "netAmount": 427.7
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Kalem kimliği
`orderItemId`	string	Kalemin doğduğu sipariş kalemi; reklam ücretlerinde boştur
`type`	string	`Sale`, `Refund` ya da `AdvertisingFee`
`grossAmount`	decimal	Kaleme ait tutar; reklam giderlerinde KDV dahildir
`commissionRate`	decimal	Uygulanan komisyon oranı (yüzde)
`commissionAmount`	decimal	Kesilen komisyon
`commissionVatAmount`	decimal	Satırın KDV'si — satışta komisyonun, reklam giderinde hizmet bedelinin
`netAmount`	decimal	Kalemin bakiyeye net etkisi; reklam giderlerinde negatiftir

Satır tipine göre tutarlar

grossAmount her zaman o kaleme ait tutardır, ama satırın tipine göre farklı işler:

Sale — grossAmount satışın tutarıdır. Komisyon bu tutar üzerinden alınır, KDV de komisyon üzerinden hesaplanır. Net, geriye kalandır: netAmount = grossAmount − commissionAmount − commissionVatAmount.

AdvertisingFee — ürünü öne çıkarma hizmetinin bedelidir ve sizden tahsil edilir. Komisyon alınmaz, bu yüzden commissionRate ve commissionAmount sıfırdır. grossAmount KDV dahil toplam bedeldir (ör. 100 TL'lik paket için 120), bedelin KDV'si ise ortak tablo kullanıldığı için yine commissionVatAmount alanında taşınır. Tutarın tamamı bakiyeden düşülür: netAmount = −grossAmount.

Hata kodları

Code	Anlam
`400`	Sayfalama veya `type` geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`404`	Hakediş bulunamadı veya size ait değil
`429`	Hız limiti aşıldı