En sık görülen stok hata türleri
Trendyol stok push hataları genelde dört grupta toplanır: barkod eşleşmemesi, varyant ID uyuşmazlığı, negatif veya ondalıklı quantity değeri ve rate limit aşımı. Log dosyanızda HTTP 200 dönüp batch içinde FAILED satırı görmek normaldir; asıl teşhis batch item seviyesindedir.
«Ürün bulunamadı» hatası çoğu zaman yanlış barcode gönderiminden kaynaklanır; leading zero kaybı veya EAN-13 yerine iç SKU gönderimi tipik senaryolardır. ERP'den gelen barkodu string olarak sabitleyin.
- PRODUCT_NOT_FOUND → barkod ve merchantSku çapraz kontrol
- INVALID_QUANTITY → negatif stok ve rezervasyon mantığını gözden geçir
- RATE_LIMIT → push frekansını düşür, delta sync'e geç
Rezervasyon mantığı ve oversell
Stok güncelleme hatasının en pahalı sonucu oversell'dir. Sipariş geldiğinde stok düşümü ile pazaryerine push arasında yarış durumu (race condition) oluşursa, iki kanalda aynı son ürün satılabilir. Çözüm: sipariş anında internal rezervasyon, push'ta available = on_hand - reserved formülü.
İade onaylandığında stoğu otomatik artırmadan önce fiziksel kabul yapıldığını doğrulayın. Erken stok iadesi, panelde stok varken rafta ürün olmamasına ve yeni oversell'e yol açar.
Batch sonuçlarını okuma ve sınıflandırma
Her stok push'undan sonra batchRequestId ile sonuç endpoint'ini sorgulayın. Başarılı görünen batch'te bile partial failure olabilir; toplam başarı yüzdesi %100 değilse başarısız satırları ayrı kuyruğa alın.
Hata sınıflandırma matrisi oluşturun: geçici (retry), veri (düzelt ve tekrar gönder), yapısal (katalog eşleştirme gerekir). Geçici hatalarda 3 deneme sonrası eskalasyon kuralı koyun; sonsuz retry rate limit'i daha da kötüleştirir.
Çok kanallı ortamda stok tutarlılığı
Trendyol stok hatası bazen Trendyol kaynaklı değildir; merkezi envanterdeki sapma yansır. Tek kaynak (SSOT) olmadan her kanala ayrı stok yazmak, bir kanalda düzeltme yapıp diğerinde oversell yaratır.
Kanal bazlı güvenlik stoğu tanımlayın: Trendyol için 2 adet, diğer kanal için 1 adet gibi. Toplam available bu rezervleri düşerek hesaplanmalı; aksi halde toplam satılabilir stok fiziksel stoğu aşar.
Proaktif önleme ve alarm eşikleri
Günlük stok sapma raporu çalıştırın: |panel_stok - ssot_stok| > 0 olan SKU'ları listeleyin. Eşik aşımında otomatik push yerine manuel onay isteyen bir gate koymak, kampanya döneminde felaketi önler.
Stok sıfırlama (flush) operasyonunu runbook'a yazın: hangi sırayla kanallara sıfır gönderilir, rezervasyonlar nasıl temizlenir, depo sayımı ne zaman tetiklenir. Plansız flush, aktif siparişleri iptal riski taşır.
Sık sorulan sorular
Stok güncellemesi başarılı ama panelde yansımıyor — neden?
Batch asenkron işlenir; 1–5 dakika gecikme normaldir. 15 dakikayı aşan gecikmede batch durumunu sorgulayın ve Trendyol status sayfasını kontrol edin. Yanlış varyant ID ile başarılı görünen istekler sessizce yok sayılabilir.
Gece otomatik stok push'u önerilir mi?
Evet, ancak sipariş çekme job'ı ile çakışmaması için sıralama koyun: önce sipariş import ve rezervasyon, sonra push. Aynı dakikada ikisi çalışırsa race condition riski artar.
Barkod doğru ama hata devam ediyor?
Ürün Trendyol'da pasif veya onay bekliyor olabilir. Ayrıca aynı barkodla duplicate listing varsa hangi contentId'ye push yapıldığını doğrulayın.
Stok hatası ceza veya hesap kısıtına yol açar mı?
Tekrarlayan oversell ve iptal, satıcı puanını düşürür ve görünürlük kaybına neden olabilir. Hata düzeltme hızı operasyon KPI'ı olarak takip edilmelidir.
Pillar rehber
Trendyol satıcıları için entegrasyon yalnızca «ürün çekmek» değildir. Güvenli credential yönetimi, batch push sonuçları, katalog eşleştirme ve sync izleme birlikte çalışmalıdır.
Trendyol entegrasyonu: API'den operasyona
