Pazaryeri Bağlantısı Çalışmıyor

Test bağlantısı başarısız, sync hata, ERROR statüsü için tanı ve çözüm.

Belirti

Pazaryeri bağlantı kartında:

🔴 ERROR rozeti
"Son sync başarısız" mesajı
errorCount artıyor
CONNECTION_ERROR bildirimi geliyor

Tanı adımları

1. Test Bağlantı

Bağlantı detay sayfasında Test Et butonuna bas. Yanıtı oku:

Hata mesajı	Anlamı
`401 Unauthorized`	API Key/Secret yanlış
`403 Forbidden`	Yetki yok (rol problemi)
`404 Not Found`	Endpoint değişmiş veya yanlış URL
`429 Too Many Requests`	Rate limit
`Connection refused`	IP whitelist veya ağ sorunu
`Timeout`	Pazaryeri yavaş veya bakımda
`Invalid sellerId/merchantId`	Yanlış ID

2. Pazaryeri sistem statüsünü kontrol et

Bazen problem sizde değil pazaryeri tarafında:

Trendyol durumu: partner.trendyol.com > Duyurular
Hepsiburada: HB merchant panel duyurular
N11: N11 satıcı panel

Sistem bakımda ise bekleyin (genelde 1-2 saat sürer).

3. Credential'ları doğrula

Pazaryeri panelden:

API Key / Secret değişmiş olabilir mi?
API kullanıcısı silinmiş veya pasif mi?
IP whitelist gerekiyor mu?

4. IP whitelist

Bazı pazaryerleri sizin sunucu IP'sini beyaz listede ister:

Trendyol: varsayılan açık
Hepsiburada: bazı API endpoint'lerinde whitelist sorabilir
N11: genelde açık
Custom altyapılar (Ticimax, T-Soft): muhtemelen evet

Qando'nun sunucu IP'leri için destek talebi açın; size verirler ve pazaryeri panele eklersiniz.

Çözüm akışı

Adım 1: Tekrar dene

Cron 5 dakika sonra otomatik tekrar deneyecek. Manuel için bağlantı kartında Senkronize Et butonuna bas.

Adım 2: Credential yenile

Pazaryeri panelinden yeni API Key oluştur
Qando'da Düzenle > yeni değerleri gir
Test Et + Kaydet

Adım 3: Reset

Eğer credential değişmediği halde sürekli hata alıyorsanız:

Bağlantıyı sil
Yeniden oluştur (aynı credential'larla)
Test et

Bu, internal state'i sıfırlar; bazen yardımcı olur.

Adım 4: Destek

Yukarıdakiler çözmediyse destek talebi açın. Lütfen şunları paylaşın:

Bağlantının workspace adı
Pazaryeri (Trendyol/HB/N11...)
Hata mesajı (kelimesi kelimesine)
Test Bağlantı yanıtı

Error count ve throttle

Bağlantıda errorCount her başarısız sync'te artar. 3'ün üstüne çıkınca:

CONNECTION_ERROR bildirimi gönderilir
60 dakika throttle aktive olur (tekrar bildirim verilmez)
Cron yine de 5dk'da bir dener

Başarılı bir sync olunca errorCount sıfırlanır.

Sync gecikmesi vs hata

Gecikme ≠ hata:

Hata: sync HTTP/API hatası alıyor → errorCount artıyor
Gecikme: pazaryeri yavaş yanıt veriyor (5-30 saniye) → sync başarılı ama uzun sürdü

Bağlantı ERROR statüsünde değilse gecikme normaldir.

Yaygın diagnoz

Belirti	Muhtemel sebep
Test başarılı ama sipariş gelmiyor	Cron durmuş — destek
Test başarılı ama ürün gelmiyor	Filtre: `approved=false` ürünler hariç tutulur
1-2 dakika önce çalışıyordu	Pazaryeri tarafı bakım
Sürekli timeout	Ağ problemi veya pazaryeri yavaş
Bir bağlantı çalışıyor diğeri çalışmıyor	Credential farklı