Gövde alanları
| Alan | Tip | Açıklama |
|---|---|---|
| lines[].lineId | long | Paketteki kalemin kimliği; sipariş paketlerinden alınır |
| lines[].quantity | int | Kalemin adedi |
| params | nesne | Picking'de boş nesne; Invoiced'da invoiceNumber taşır |
| status | metin | Picking ya da Invoiced |
Picking örneği: lines içinde lineId ve quantity, params boş, status: Picking. Invoiced örneği: aynı lines, params içinde invoiceNumber: FATURA_NO, status: Invoiced.
Ne zaman hangi statü?
| Statü | Ne zaman gönderilir | Etkisi |
|---|---|---|
| Picking | Paketi hazırlamaya başladığınızda | Panelde "Sipariş İşleme Alınmıştır" görünür |
| Invoiced | Faturayı kestiğinizde (isteğe bağlı) | Fatura numarası pakete işlenir |
Picking, siparişi işleme aldığınızı Trendyol'a bildirir ve kendi tarafınızda durum takibini kolaylaştırır. Ortak etiket kullanıyorsanız etiket talebini Picking ya da Invoiced bildiriminden sonra yapmanız önerilir.
Invoiced statüsü fatura dosyasını ya da linkini göndermez; yalnız fatura numarasını pakete işler. Faturanın kendisi için fatura linki gönderme servisini ayrıca kullanın.
Kurallar ve limitler
- Sıra önemlidir: önce Picking, sonra Invoiced.
- lineId değerini paket yanıtındaki lines dizisinden alın. Ürün barkodu ya da sipariş numarası lineId yerine geçmez.
- Diğer statüleri (Shipped, Delivered vb.) bu servisle göndermeyin; onları sistem atar. Test ortamında bu statüleri ilerletmek için ayrı test servisi vardır.
- Paket bölünür ya da kısmen iptal edilirse eski paket kimliği geçersiz olur. Statü göndermeden önce paketin hâlâ güncel olduğundan emin olun.
- Servis limiti en düşük kademede dakikada 300 istektir; 500.000 ürün ve üzeri listeleme limitinde sınır yoktur.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 400 | lineId ya da quantity tipi yanlış, status geçersiz | lineId'yi long, quantity'yi int gönderin; status yalnız Picking ya da Invoiced |
| 404 | Paket kimliği yanlış ya da paket artık yok | Siparişi yeniden çekip güncel shipmentPackageId'yi kullanın |
| Invoiced kabul edilmiyor | Önce Picking beslenmedi | Picking'i gönderip sonra Invoiced'ı deneyin |
| Statü değişmedi görünüyor | Yanıt sonrası paket okunmadı | Paketi sipariş servisinden ya da webhook'tan tekrar okuyun |
Bu servisle aynı yolda çalışan tedarik edememe bildirimi farklı bir alt yola (/items/unsupplied) gider. İkisini karıştırmayın; ayrıntı için tedarik edememe bildirimi sayfasına bakın.
Örnek akış: bir paketi hazırlamak
İki kalemli bir paket düşünelim: bir kalemden 2, diğerinden 1 adet. Satıcı paketi sipariş servisinden çeker ve lines dizisindeki iki lineId değerini alır.
- Depoda toplama başlayınca aynı pakete status: Picking ile iki kalemi ve adetlerini gönderir.
- Faturayı kesince params içinde invoiceNumber ile status: Invoiced gönderir.
- Kargo TEX ya da Aras ve Trendyol öder ise ortak etiketi ister; değilse etiketi kargo firmasından alır.
- Paketi cargoTrackingNumber ile kargoya teslim eder ve sonraki statüleri webhook ya da sipariş servisinden izler.
Her adımda paket kimliğinin değişmediğini kontrol etmek, kısmi iptal ya da bölme sonrası yanlış pakete statü gönderilmesini önler.
Sık sorulanlar
Trendyol'da Picking statüsü ne işe yarar?
Paketi hazırlamaya başladığınızı bildirir. Picking beslendiğinde Trendyol panelinde "Sipariş İşleme Alınmıştır" ifadesi görünür.
Invoiced statüsü zorunlu mu?
Trendyol'un sipariş akışında Invoiced adımı isteğe bağlı olarak gösterilir. Gönderecekseniz Picking'den sonra ve params içinde invoiceNumber ile gönderin.
lineId nereden alınır?
Sipariş paketlerini çekme yanıtındaki lines dizisinde her kalemin lineId değeri bulunur. Statü isteğinde bu değeri long olarak gönderin.
Shipped statüsünü API ile gönderebilir miyim?
Hayır. Satıcı yalnız Picking ve Invoiced besler. Alternatif teslimat servisi kullanıldığında paket otomatik olarak Shipped olur; normal kargoda statüyü sistem günceller.
Paket statü bildiriminin limiti nedir?
En düşük iki kademede dakikada 300, 150.000 ürün kademesinde 500 istektir. 500.000 ürün ve limitsiz kademelerde sınır yoktur.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı