Kesinti faturalarını çekmek
| Amaç | İstek |
|---|---|
| Tüm kesinti faturaları | GET .../otherfinancials?transactionType=DeductionInvoices&startDate=...&endDate=... |
| Yalnız platform hizmet bedeli | Aynı istek ve transactionSubType=PlatformServiceFee |
| Bir hakedişin kesintileri | GET .../otherfinancials?paymentOrderId=ID&transactionType=DeductionInvoices |
| Stopaj | GET .../otherfinancials?transactionType=Stoppage |
transactionSubType parametresi yalnız transactionType=DeductionInvoices ile ya da transactionTypes içinde DeductionInvoices varken çalışır. Bu filtre Mart 2026'da eklendi. Tarih aralığı burada da en fazla 15 gündür.
Kayıtları ayırt etmek
DeductionInvoices tek bir fatura türü değil, Trendyol'un sağladığı hizmetler için kesilen faturaların genel kategorisidir. Alt türü kayıttaki transactionType ve description alanlarından okunur. Saystok'un canlı verisinde bu alanda Komisyon Faturası, Kargo Faturası, Reklam Bedeli, Erken Ödeme Kesintisi ve Platform Hizmet Bedeli gibi Türkçe etiketler görülür.
| Alan | Kullanımı |
|---|---|
| id | Fatura kimliği; kargo faturasında invoiceSerialNumber olarak kullanılır |
| transactionDate | Fatura tarihi |
| transactionType / description | Faturanın türü ve açıklaması |
| debt / credit | Borç ve alacak tutarı |
| paymentOrderId / paymentDate | Faturanın düşüldüğü ödeme emri ve tarihi |
Raporlarınızda bu kayıtları etiketine göre gruplayın. Reklam ve hizmet bedellerini satış komisyonundan ayrı izlemek, kârlılık hesabını netleştirir. Konunun satıcı tarafı için platform hizmet bedeli nedir yazısına bakabilirsiniz.
Kargo faturası detayı
Kargo faturasının hangi paketlerden oluştuğunu görmek için önce DeductionInvoices kayıtları arasında transactionType değeri "Kargo Faturası" ya da "Kargo Fatura" olanları bulun. Bu kaydın id değeri invoiceSerialNumber'dır. Ardından cargo-invoice servisini bu numarayla çağırın.
| Yanıt alanı | Açıklama |
|---|---|
| shipmentPackageType | Kargo paketi türü; örneğin Gönderi Kargo Bedeli ya da İade Kargo Bedeli |
| parcelUniqueId | Kargo paketinin benzersiz kimliği |
| orderNumber | Sipariş numarası |
| amount | Kargo bedeli |
| desi | Kargo desi değeri |
Bu servis, faturalanan desinin sizin hesapladığınız desiyle uyuşup uyuşmadığını sipariş bazında kontrol etmenin en doğrudan yoludur. Desi hesabı için Trendyol kargo ücreti ve desi hesaplama yazısına bakabilirsiniz.
Limitler ve sık hatalar
Cari hesap ekstresi ve kargo faturası detayı servislerinin limiti dakikada 100 istektir. Kargo faturası detayını her fatura için bir kez çekip saklamak yeterlidir; aynı faturayı tekrar tekrar sorgulamak limiti boşa harcar.
- Kargo faturası seri numarası yerine sipariş numarası göndermek: invoiceSerialNumber, DeductionInvoices kaydının id değeridir.
- transactionSubType'ı DeductionInvoices olmadan kullanmak: filtre çalışmaz.
- Kesintileri hakediş hesabının dışında bırakmak: ödeme tutarı beklenenden düşük görünür; aynı paymentOrderId'nin kesintilerini birlikte okuyun.
- Kesinti türlerini sabit bir listeye bağlamak: etiketler zamanla değişebilir; bilinmeyen etiketleri ayrı bir başlıkta toplayıp izleyin.
Sık sorulanlar
Trendyol kesinti faturalarını API ile nasıl çekerim?
otherfinancials servisini transactionType=DeductionInvoices ve en fazla 15 günlük tarih aralığıyla çağırın. Bir hakedişin kesintileri için paymentOrderId kullanın.
Platform hizmet bedelini ayrı nasıl görürüm?
Aynı isteğe transactionSubType=PlatformServiceFee ekleyin. Filtre yalnız DeductionInvoices türüyle birlikte çalışır.
Kargo faturasının seri numarası nerede?
DeductionInvoices kayıtlarında transactionType değeri Kargo Faturası ya da Kargo Fatura olan kaydın id değeri invoiceSerialNumber'dır.
Kargo faturası hangi siparişlerden oluşuyor?
cargo-invoice servisi her kargo paketi için sipariş numarasını, paket türünü, desiyi ve kargo bedelini döner.
Stopaj kesintisini nereden görürüm?
otherfinancials servisini transactionType=Stoppage ile çağırın. İlgili tarih aralığındaki e-ticaret stopajı ve stopaj iptali kalemleri listelenir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı