Gövde ve neden kodları
Gövde iki alan taşır: lines dizisi (her elemanda lineId ve quantity) ve reasonId. Örnek: lines içinde lineId: KALEM_ID, quantity: 1 ve reasonId: 500.
| reasonId | Ad | Ne zaman seçilir |
|---|---|---|
| 500 | Stok tükendi | Ürünün stoğu tükendi ya da gönderim gecikmesi nedeniyle tedarik edilemiyor |
| 501 | Kusurlu/Defolu/Bozuk Ürün | Ürün kusurlu olduğu için gönderilemiyor |
| 502 | Hatalı Fiyat | Yanlış fiyat beslendi |
| 504 | Entegrasyon Hatası | Entegrasyon firmasından kaynaklı hatalı fiyat ya da stok aktarımı |
| 505 | Toplu Alım | İndirim sonrası aynı müşteri aynı üründen toplu satın aldı |
| 506 | Mücbir Sebep | Doğal afet, hastalık, cenaze gibi durumlar |
Bildirimden sonra paket ne olur?
| Durum | Sonuç |
|---|---|
| Paketin tamamı iptal edildi | Paket Cancelled olur; iptal sipariş servisinden ya da webhook'tan görülür |
| Paketteki kalemlerin bir kısmı iptal edildi | Mevcut paket bozulur ve Cancelled olur; aynı orderNumber altında yeni shipmentPackageId ve cargoTrackingNumber oluşur |
Kısmi iptalden sonra kalan ürünleri eski paket kimliğiyle göndermeye çalışmayın. Doküman, tedarik edememe kaydından sonra sipariş paketlerinin yeniden çekilmesini ister. Yeni paket bilgileri sipariş servisinden ya da webhook'tan alınır; yeni paketin createdBy alanı cancel olarak gelir.
Önce yapılacak kontroller
- Gerçekten tedarik edemiyor musunuz? Başka bir depoda ürün varsa paketi bölmek ya da gönderim süresini uzatmak daha iyi bir seçenek olabilir.
- Doğru nedeni seçin. 504 Entegrasyon Hatası yalnız entegrasyondan kaynaklı fiyat ya da stok hatası içindir; stoğu biten ürün için 500 seçilir.
- İptal ettiğiniz ürünün stoğunu hemen sıfırlayın. Aksi hâlde aynı ürün yeniden satılır ve aynı sorun tekrarlanır.
- Tedarik edememe nedeniyle satışı durdurulan ürünlerin kilidi, sorun giderildikten sonra kilit kaldırma servisiyle açılabilir.
Limit ve sık hatalar
Servis limiti en düşük iki kademede dakikada 100, 150.000 ürün kademesinde 200 istektir; 500.000 ürün ve üzerinde sınır yoktur.
| Belirti | Neden | Çözüm |
|---|---|---|
| 400 | reasonId eksik ya da geçersiz | Tablodaki kodlardan birini gönderin |
| Kalan ürünler gönderilemiyor | Eski paket kimliği kullanılıyor | Siparişi yeniden çekip yeni paketi kullanın |
| Yanlış kalem iptal edildi | lineId yerine başka kimlik gönderildi | lineId'yi paketin lines dizisinden alın |
Stok farkları sık tedarik edememeye yol açıyorsa kök nedeni çözün. Kanallar arası çift satışı önlemek için çoklu pazaryeri çift satış sorunu rehberine bakabilirsiniz. Stoğu biten ürünün satışını önceden durdurmak, iptal bildirmekten her zaman daha az maliyetlidir.
Sık sorulanlar
Trendyol'da tedarik edememe nasıl bildirilir?
PUT .../shipment-packages/{packageId}/items/unsupplied servisine iptal edilecek kalemlerin lineId ve quantity değerleri ile bir reasonId gönderilir.
Tedarik edememe neden kodları nelerdir?
500 Stok tükendi, 501 Kusurlu ürün, 502 Hatalı fiyat, 504 Entegrasyon hatası, 505 Toplu alım ve 506 Mücbir sebep.
Kısmi iptalden sonra kalan ürünleri nasıl gönderirim?
Siparişi yeniden çekin. Aynı orderNumber altında oluşan yeni paketin shipmentPackageId ve cargoTrackingNumber değeriyle devam edin.
Tedarik edememe ürünü etkiler mi?
Trendyol tedarik edememe sebebiyle bazı ürünlerin satışını durdurabilir. Bu kilit, sorun giderildikten sonra kilit kaldırma servisiyle açılabilir.
Paketin yalnız bir ürününü iptal edebilir miyim?
Evet. lines dizisine yalnız iptal edilecek kalemin lineId ve quantity değerini yazın. Paket bozulur, kalan ürünler aynı sipariş numarası altında yeni bir pakette devam eder.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı