Hangi işlemler batchRequestId döner?
| İşlem | batchRequestType değeri |
|---|---|
| Ürün yaratma v2 | ProductV2OnBoarding |
| Onaysız ürün güncelleme | ProductV2Update |
| Onaylı ürün content güncelleme | ApprovedProductContentUpdate |
| Onaylı ürün varyant güncelleme | ApprovedProductVariantUpdate |
| Teslimat bilgisi güncelleme | ProductDeliveryOptionUpdate |
| Stok ve fiyat güncelleme | ProductInventoryUpdate |
| Ürün arşivleme | ProductArchiveUpdate |
| Ürün silme | ProductDeletion |
| Ürün kilit kaldırma | ProductUnlockUpdate |
batchRequestId'nin dönmesi işlemin başarılı olduğu anlamına gelmez. Trendyol sıkça sorulan sorularda bunu özellikle vurgular.
Yanıt alanları
| Alan | Açıklama |
|---|---|
| status | Toplu işlemin durumu: IN_PROGRESS ya da COMPLETED. Stok-fiyat işlemlerinde dönmez. |
| items[].requestItem | Gönderdiğiniz kalemin kendisi (barkod, miktar, fiyat vb.) |
| items[].status | Kalem sonucu: SUCCESS ya da FAILED |
| items[].failureReasons | Kalem başarısızsa nedenlerin listesi |
| itemCount / failedItemCount | Toplam ve başarısız kalem sayısı |
| batchRequestType | İşlem türü (yukarıdaki tablo) |
| sourceType | API ya da WEB |
| creationDate / lastModification | Oluşturma ve son değişiklik zamanı |
Doğru sorgulama düzeni
- batchRequestId'yi gönderdiğiniz kalemlerle birlikte saklayın. Sonuç 4 saat sonra görüntülenemez.
- İlk sorguyu birkaç saniye sonra yapın. Kalemler henüz işlenmediyse items boş gelebilir.
- Ürün işlemlerinde status COMPLETED olana kadar aralıklı sorgulayın.
- Stok-fiyat işlemlerinde toplu statüye güvenmeyin; her kalemin status alanına bakın.
- FAILED kalemleri failureReasons ile kaydedin, düzeltip yalnız onları yeniden gönderin.
- Bu servis Product Integration Read grubundadır; sık sorgu aynı gruptaki ürün listeleme isteklerinizle limiti paylaşır.
Batch başarılı, ürün yine görünmüyor
Ürün yaratmada SUCCESS, ürünün Trendyol'a kabul edilip onay sürecine girdiğini gösterir. Onay süren ya da reddedilen ürün yayına çıkmaz. Ürünün son durumunu ürün filtreleme servisinden, onaysız ürünlerde ret nedenini onaysız ürün listesinden okuyun.
Onaylı ürünlerin içerik güncellemeleri de batch'te başarılı göründükten sonra bir kontrol adımından geçer. Bu adımın sonucu ve varsa rejectReasons, /integration/product/sellers/{sellerId}/products/{contentId}/update-audits adresindeki güncelleme sonucu kontrol servisinden okunur.
Örnek: stok güncellemesinin sonucunu okumak
Bir barkodun stoğunu 100 yaptığınızı düşünelim. Stok-fiyat servisi yanıtta yalnız batchRequestId döner. Birkaç saniye sonra bu kimlikle batch servisini çağırdığınızda kalem şöyle görünür:
- requestItem.barcode: ORNEK_BARKOD
- requestItem.quantity: 100
- requestItem.updateRequestDate: isteğin işlendiği zaman
- status: SUCCESS ya da FAILED
- failureReasons: başarısızsa nedenlerin listesi, başarılıysa boş dizi
Kalem FAILED ise gerekçeyi okuyun. Aynı barkoda dakikada 30'dan fazla fiyat güncellemesi gönderildiyse ya da barkod onaylı bir ürüne ait değilse bu alanda yazar. Gerekçeyi düzeltmeden aynı gövdeyi tekrar göndermeyin; 15 dakika kuralı nedeniyle istek ayrıca reddedilir.
Sık sorulanlar
batchRequestId ne kadar süre sorgulanabilir?
Trendyol dokümanına göre ürün aktarma, ürün güncelleme ve stok-fiyat işlemlerinin batch sonuçları 4 saat sonrasına kadar görüntülenebilir.
Stok güncellemesinde status alanı neden boş?
Stok-fiyat işlemlerinde toplu statü alanı dönmez. Her kalemin items[].status değerini SUCCESS ya da FAILED olarak kontrol etmeniz gerekir.
failureReasons alanında ne yazar?
Kalemin neden reddedildiği yazar; örneğin geçersiz alan değeri, bulunamayan barkod ya da fiyat kuralı ihlali. Kalemi bu nedene göre düzeltip yeniden gönderin.
Batch sorgusu istek limitine dahil mi?
Evet. Toplu işlem kontrolü Product Integration Read grubundadır ve en düşük kademede dakikada 1000 isteklik grup limitini ürün listeleme servisleriyle paylaşır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı