Entegrasyon hata kodları

Ne işe yarar?

Mağaza logunda görünen API hatalarının yorumlanması.

Neden önemli?

Doğru müdahale anahtar yenileme mi yoksa platform kesintisi mi ayırır.

Detaylı açıklama

Mağaza bağlantısı yalnızca kimlik bilgisi girişi değildir: sipariş çekim aralığı, otomatik fatura/stok seçenekleri ve kargo eşlemesi birlikte yapılandırılmalıdır.

Mağaza logu HTTP kodu, platform mesajı ve zaman damgası içerir. 401/403 kimlik, 404 yanlış endpoint/ID, 429 hız limiti, 5xx platform/entegratör kesintisidir. Aynı hatayı “tekrar dene” ile ezmek kuyruğu şişirir. Önce kodu sınıflayıp sonra token, izin veya beklemeye karar verin.

Ön koşullar

• Oluşturulmuş ana mağaza.
• Platform satıcı panelinde API erişimi ve gerekli izinler.

Adımlar (Menü > Mağazalar > Log)

1. Hata kodunu ve zamanı not alın.
2. 401/403 ise token ve izinleri kontrol edin.
3. 5xx veya timeout ise platform durumuna bakın.
4. Düzeltme sonrası bağlantı testini tekrarlayın.
5. Son 20 log satırını zaman sırasıyla okuyun; ilk yeni hata anını bulun.
6. 401/403 ise platformda anahtarı yenileyip FastEntegre’ye yapıştırın.
7. 429 ise senkron aralığını düşürün; toplu işi bölün.
8. 5xx ise platform durum sayfasını kontrol edin; kesinti bitince tek test çekimi yapın.

Bağlantı doğrulama

1. Mağaza detayında Bağlantıyı test et ile API yanıtını doğrulayın.
2. Test başarılıysa tek sipariş çekimini manuel tetikleyin.
3. Mağaza logunda 401/403 yoksa token geçerlidir.
4. İlk 24 saatte sipariş, stok ve (varsa) fatura akışını ayrı ayrı kontrol edin.

Hata kodu özeti

| Kod | Anlam | İlk aksiyon |

|-----|-------|-------------|

| 401/403 | Kimlik/izin | Token yenile, izin kontrol |

| 404 | Kayıt yok | Supplier/Merchant ID, sipariş no |

| 429 | Rate limit | Yavaşlat, parçala |

| 5xx | Karşı taraf | Durum sayfası, bekle |

Kontrol listesi

• API anahtarı platform panelinde aktif.
• Bağlantı testi yeşil.
• Sipariş senkron aralığı tanımlı.
• Kargo ve fatura entegrasyonları (gerekiyorsa) ayrıca bağlandı.

Sık karşılaşılan hatalar

• Log boş — Yanlış mağaza filtresi veya henüz senkron çalışmamış olabilir. Manuel “şimdi çek” tetikleyin.
• Türkçe mesaj yok, sadece JSON — JSON’daki message/error alanını ticket’a olduğu gibi yapıştırın.

Sık sorulan sorular

Hata kesildi ama siparişler eksik

Kesinti süresindeki siparişler için tarih aralıklı yeniden çekim yapın. Sipariş senkronu.

Sadece bir SKU hata veriyor

Mağaza bağlantısı sağlamdır; ürün/publish loguna bakın.

İlgili rehberler

• Entegrasyon çalışmıyor kontrol listesi
• Pazaryeri mağazası ekleme
• Entegrasyonu yeniden bağlama
• Hata loglarını okuma

Hâlâ çözülmedi?

• Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
• WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
• Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.