Kargo entegrasyonu hataları ve çözümleri Rehberi

01Sık hatalar ve çözümleri

Mükerrer kayıt

Neden: Aynı sipariş veya cari iki kez aktarıldı. Çözüm: benzersiz anahtarla tekrar kontrolü (idempotency).

Yetki süresi doldu

Neden: API anahtarı, token veya yetki süresi sona erdi. Çözüm: yetkiyi yenilemek ve süre dolmadan uyarı veren izleme kurmak.

Zaman aşımı

Neden: Karşı sistem geç yanıt verdi veya toplu istek büyüktü. Çözüm: toplu işlemi parçalara bölmek ve yeniden deneme mantığı.

Oran sınırı

Neden: Kısa sürede platformun izin verdiğinden fazla istek gönderildi. Çözüm: kuyruk, bekleme ve toplu güncelleme stratejisi.

Stok çakışması

Neden: Aynı ürün iki kanalda aynı anda satıldı, güncellemeler çakıştı. Çözüm: tek stok kaynağı ve sıralı (kuyruklu) güncelleme.

02Kategoriye özgü sorunlar

Belirti	Olası neden	Çözüm
Stok sıfırlanıyor/eksiye düşüyor	İki yönlü güncelleme çakışması	Tek kaynak ve kilit mantığı
Sipariş düşmüyor	Kimlik/yetki süresi doldu veya alan değişti	İzleme ve uyarı
Ürün reddediliyor	Kategori/özellik eşleşmesi eksik	Eşleştirme tablosu
Fatura kesilmiyor	Vergi/kimlik bilgisi eksik	Doğrulama kuralları

03Kalıcı önlemler

İzleme panosu ve hata bildirimi
Yetki sürelerinin dolmadan yenilenmesi
Platform duyurularının takibi
Hata kuyruğunun günlük kontrolü

04Hizmet bölgeleri

Bu rehber genel bilgi sunar. Kargo entegrasyonu için Türkiye'nin 81 ili ve ilçelerine özel sayfalarda bölgeye göre çalışma notlarını bulabilirsiniz.

Projeniz için 0540 003 19 81 numarasını arayın veya WhatsApp'tan yazın.

Hemen ara WhatsApp Teklif formu

SSSSık sorulan sorular

Hata olduğunu nasıl anlarım?

İzleme kurulu bir entegrasyonda başarısız kayıtlar listelenir ve sorumlu kişiye bildirim gider; ayrıca günlük özet raporu alınabilir.

Kargo entegrasyonu için hangi erişimler gerekir?

Bağlanacak sistemlerin resmî API veya entegrasyon bilgileri, varsa test hesabı ve verinin ana kaynağının hangi sistem olacağı kararı gerekir.

Kargo entegrasyonu çalışırken bir kayıt aktarılamazsa ne olur?

Başarısız aktarım hata kuyruğunda bekletilir, yeniden denenir ve raporlanır; hangi kaydın neden aktarılamadığı görülür.

→İlgili sayfalar

Kargo Entegrasyonu: diğer rehberler

İllere göre

Genel

Bu sayfada geçen kavramlar

gönderi oluşturma
etiket/barkod
takip numarası aktarımı
kategori eşleştirme
fiyat güncelleme
e-arşiv
API
webhook
stok senkronizasyonu
fiyat güncelleme

Kargo entegrasyonu hataları ve çözümleri rehberi