Qando

Yaygın Hatalar ve Çözümleri

401 Unauthorized, CONNECTION_ERROR, RLS denial gibi sık karşılaşılan hatalar.

401 Unauthorized

Sebep: Access token süresi dolmuş veya geçersiz.

Çözüm:

  • Paneli kullanıyorsanız: çıkış yap ve tekrar giriş yap
  • API kullanıyorsanız: /auth/refresh ile token yenile
  • Token hala geçersizse parola sıfırla

403 Forbidden

Sebep: Bu işlemi yapma yetkiniz yok.

Çözüm:

  • Workspace rolünüz (STAFF) bu işleme yetkili değil → OWNER'a sor
  • Yanlış tenant ID gönderiyorsunuz → header'ı kontrol et
  • Tenant statüsü SUSPENDED → faturalandırma kontrol

429 Too Many Requests

Sebep: Rate limit aşıldı.

Çözüm:

  • API kullanıyorsanız Retry-After header'ı bekle
  • Birden fazla yer aynı endpoint'i çağırıyorsa azalt
  • Sürekli alıyorsanız destek ile iletişim

CONNECTION_ERROR bildirimi

Sebep: Bir pazaryeri bağlantısı son sync'ide hata aldı.

Yaygın nedenler:

  • API key/secret yanlış veya iptal edilmiş
  • Pazaryeri sistemi bakımda
  • IP whitelist sorunu
  • Rate limit aşıldı

Çözüm: Bağlantı Sorunları sayfasına bakın.

"Veri görünmüyor" sorunu

Sebep:

  • Filtre yanlış
  • Sync henüz çalışmamış
  • Soft delete edilmiş kayıt
  • Yetki yok

Çözüm:

  1. Filtreyi sıfırla
  2. Manuel sync tetikle
  3. Soft delete kontrolü için destek ile iletişim
  4. Yetkiyi kontrol et

Barkod / SKU çakışması

Sebep: Aynı barkod veya SKU başka varyantta tanımlı.

Çözüm:

  • Ürün listesinde barkod ile ara
  • Eski/silinmiş varyantı bul
  • Barkodu değiştir veya silinmiş varyantı kalıcı sil (destek)

Stok rakamı yanlış

Sebep:

  • Reserved (rezerve) miktarı dahil değil
  • Soft-deleted depo
  • Cron geç çalışmış

Çözüm:

  • physicalQty - reservedQty formülünü kontrol et
  • Bekleyen siparişler stoğu rezerve eder
  • Manuel sayım ile düzelt (ADJUSTMENT)

E-posta bildirimi gelmedi

Sebep:

  • Spam klasörüne düşmüş
  • E-posta tercihi kapalı
  • SMTP servisi geçici sorun

Çözüm:

  • Spam kontrolü
  • Ayarlar > Bildirim Tercihleri > E-posta kanalı açık mı
  • Birkaç saat sonra tekrar dene

Push: PARTIAL_FAIL veya FAIL

Sebep: Pazaryeri push'u kısmen veya tamamen reddetti.

Çözüm:

  • Push History panelinde hata detayını oku
  • En yaygın: barkod eksik, görsel boyutu küçük, kategori yanlış
  • Düzelt + tekrar push

Sayfa açılmıyor / 500 hatası

Sebep: Sistem geçici hatası.

Çözüm:

  1. Sayfayı yenile (Ctrl+F5 hard refresh)
  2. Tarayıcı cache temizle
  3. Farklı tarayıcı dene
  4. Hala olursa destek talebi

"Geçerli bir veri girin" validasyon

Sebep: Zod schema validasyonu başarısız.

Çözüm:

  • Form alanını dikkatli oku (örn. negatif sayı kabul etmiyor, e-posta formatı bekliyor)
  • Hata mesajı genelde detaylı yazar; ipuçlarına bak

Mobil panel yavaş

Sebep: Büyük listeler mobil tarayıcıda yavaşlar.

Çözüm:

  • Filtre kullanarak liste boyutunu küçült
  • Sayfalama 25/sayfa'ya düşür
  • WiFi'a bağlan

Sync sürekli FAIL durumunda

Sebep: Pazaryeri tarafı sorunu veya bağlantı bozulmuş.

Çözüm:

  1. Test Bağlantı çalıştır
  2. Başarısızsa: credential'ları yenile
  3. Pazaryeri sistemi statüsünü kontrol et (Trendyol/HB resmi duyuru)
  4. Destek talebi aç

Sonraki adım