Üç fatura servisi
| Servis | Yöntem ve yol | Gövde | Yanıt |
|---|---|---|---|
| Fatura linki gönderme | POST .../seller-invoice-links | invoiceLink, shipmentPackageId, invoiceDateTime, invoiceNumber | 201 |
| Fatura linki silme | POST .../seller-invoice-links/delete | serviceSourceId (paket ID), channelId: 1, customerId | 202 |
| Fatura dosyası gönderme | POST .../seller-invoice-file | form-data: shipmentPackageId, file; mikro ihracatta invoiceDateTime, invoiceNumber | - |
Yollar /integration/sellers/{sellerId} ile başlar. Silme isteğindeki customerId değeri sipariş paketlerini çekme servisinden alınır.
Ne zaman bu servis kullanılır?
Doküman kuralı açıkça koyar: siparişin faturasını siparişteki kriptolu e-posta adresine PDF ekiyle gönderemiyorsanız bu servisi kullanmanız gerekir. Kriptolu adresler müşteri bazlı sabit değildir; her sipariş için ayrı adres üretilir.
Servis tetiklendiğinde Trendyol linki kontrol eder ve müşteriye iletir. Link 10 yıl boyunca açılabilir olmalıdır. Geçici depolama, süreli imzalı adres ya da kapanabilecek bir sunucu kullanmayın.
Trendyol Yurt Dışı Aracılığı siparişlerinde e-Arşiv fatura gönderilemez; e-Fatura kesilmelidir. Mikro ihracat siparişlerinde Trendyol'un sıkça sorulan sorularına göre KDV oranı %0, fatura tipi istisna ve 301 - 11/1-a Mal İhracatı kodu kullanılır.
Fatura numarası ve tarih kuralları
- invoiceDateTime long tiptedir, 0'dan büyük ve 10 haneli (saniye) ya da 13 haneli (milisaniye) olmalıdır.
- invoiceNumber metindir ve 16 karakterdir: ilk 3 hane harf ya da rakam, sonraki 4 hane 2020 ile 2099 arası bir yıl, son 9 hane rakam.
- Geçerli örnek: FRY2024567890123. Geçersiz örnek: FRY12345.
- Azerbaycan ve Körfez ülkeleri siparişlerinde sisteme gönderilen numara faturada yazan numarayla aynı olmalıdır.
- Fatura dosyası 10 MB'tan büyük olamaz, yalnız PDF, JPEG ya da PNG olabilir ve ileri tarihli olamaz.
Fatura durumu ve ret nedenleri
Sipariş paketindeki invoiceStatus alanı faturanın durumunu gösterir: NotInvoiced fatura beslenmedi, Received beslendi ve kontrolde, Rejected hatalı bulundu, Invoiced doğru bulundu demektir. invoiceLink alanı yalnız Invoiced paketlerde dolu döner.
Türkiye pazaryerinde Rejected olan faturayı silip yeniden göndermeniz gerekir. Ret nedeni invoiceRejectedReasonKeys alanında gelir; örneğin INVOICE_TOTAL_MISMATCH dip toplamın siparişle uyuşmadığını, INVOICE_DATE_MISMATCH fatura tarihinin sipariş tarihinden önce olduğunu, INVOICE_NUMBER_ALREADY_EXISTS numaranın başka pakette kullanıldığını gösterir.
| Hata | Neden | Çözüm |
|---|---|---|
| 409 | Pakete daha önce fatura beslenmiş ya da link başka pakete verilmiş | Mevcut faturayı silip yeniden gönderin; her pakete ayrı link verin |
| Fatura önceden gönderilmiş | Dosya yüklemede pakete fatura var | Önce silme servisini kullanın |
| Micro export type'lari icin fatura bilgisi zorunludur | Mikro ihracatta numara ya da tarih eksik | invoiceNumber ve invoiceDateTime ekleyin |
| Dosya türü desteklenmiyor | PDF, JPEG, PNG dışı dosya | Desteklenen biçime çevirin |
Sık sorulanlar
Trendyol'a fatura linki nasıl gönderilir?
POST /integration/sellers/{sellerId}/seller-invoice-links servisine invoiceLink ve shipmentPackageId gönderin. Mikro ihracat ve Yurt Dışı Aracılığı paketlerinde invoiceNumber ve invoiceDateTime da zorunludur.
Fatura linkinde 409 hatası neden olur?
İki nedeni vardır: pakete daha önce fatura beslenmiştir ya da aynı link başka bir pakete gönderilmiştir.
Hatalı gönderdiğim faturayı nasıl silerim?
POST .../seller-invoice-links/delete servisine serviceSourceId olarak paket kimliğini, channelId olarak 1'i ve paketin customerId değerini gönderin. Ardından doğru faturayı yeniden gönderebilirsiniz.
Fatura linki ne kadar süre açık kalmalı?
Doküman, gönderilen fatura bağlantılarının yasal zorunluluk gereği 10 yıl boyunca erişilebilir olmasını ister.
Link yerine PDF yükleyebilir miyim?
Evet. seller-invoice-file servisine form-data ile shipmentPackageId ve file alanlarını gönderin. Dosya PDF, JPEG ya da PNG olmalı ve 10 MB'ı geçmemelidir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı