Pazarama Entegrasyonu

Kategori: Pazaryeri Versiyon: 1.0.0

Pazarama eklentisi mağazanızı Pazarama (İş Ortağım) pazaryeri ile entegre eder. Ürün yükleme, stok/fiyat güncelleme, sipariş çekme, kargo bildirimi ve müşteri sorularını tek panelden yönetebilirsiniz.

Desteklenen Özellikler

• Ürün gönderme ve güncelleme (Pazarama API, batch / createProducts)
• Toplu gönderim sonuç sorgulama (batchRequestId üzerinden)
• Stok + fiyat senkronizasyonu
• Sipariş senkronizasyonu
• Sipariş kalemi bazında kargo takip no + firma bildirimi
• Müşteri sorularını çekme ve yanıtlama
• Kategori eşleştirme

1. Ön Hazırlık — Pazarama Entegrasyon Bilgilerini Alın

1. https://isortagim.pazarama.com adresinden Pazarama satıcı panelinize giriş yapın.
2. Ayarlar → Entegrasyon Bilgileri sayfasına gidin.
3. Açılan ekranda üç değer görürsünüz:
   • Satıcı ID (UUID, örn. ef526a30-3735-4bb7-b1a6-08dc70de3794)
   • API Key (kopyala butonu ile)
   • API Secret (kopyala butonu ile)

⚠️ API Secret yalnızca bir kez gösterilir. Bu bilgiyi güvenli bir yerde saklayın; kaybederseniz Pazarama panelinden yeni anahtar üretmeniz gerekir.

2. Eklentiyi Mağaza Panelinde Yapılandırın

1. Sol menüden Entegrasyonlar → Pazarama bölümüne gidin.
2. Ayarlar sekmesine tıklayın.

3. Satıcı ID, API Key ve API Secret alanlarını doldurun.
4. Kaydet butonuna tıklayın.

3. Bağlantıyı Test Edin

Ayarları kaydettikten sonra Bağlantıyı Test Et butonuna tıklayın. "Pazarama bağlantısı başarılı!" mesajını görünce entegrasyon hazırdır.

Hata alırsanız:

• Satıcı ID / API Key / API Secret değerlerini doğru kopyaladığınızdan emin olun (boşluk kalmasın).
• Pazarama panelinde API erişiminin aktif olduğunu kontrol edin.
• 401 hatasında, Kaydet'e basıp tekrar deneyin (token cache yenilenir).

4. Kategori Eşleştirme

Pazarama kendi kategori ağacını kullanır. Ürünlerinizin doğru kategoride yayınlanması için mağaza kategorinizi Pazarama kategorisiyle eşleştirmeniz gerekir.

1. Ürünler sekmesinde, kategori eşleştirmesi yapılmamış bir ürünün satırında "Eşleşmemiş" uyarısını görürsünüz.
2. Ürünün mağaza kategorisine Pazarama kategorisini atayın (Pazarama yaprak — alt seviye — kategorileri kabul eder).
3. Kaydedin.

5. Ürün Gönderimi

Ürünler sekmesinde her ürün satırının sağındaki ikon butonları:

• ⬆️ Gönder — Ürünü Pazarama'ya gönderir/günceller. Pazarama döndüğü batchRequestId saklanır.
• 📦 Stok — Sadece stok bilgisini gönderir.
• 💲 Fiyat — Liste + satış fiyatını gönderir.
• 🕘 Güncelleme sonucu — Daha önce gönderilmiş bir batch'in onay/red sonuçlarını gösterir.

Toplu yüklemek için sağ üstteki "Tümünü Pazarama'ya Gönder" butonunu kullanın.

Onay / Red Sonuçları

Pazarama her gönderim için bir doğrulama yapar. Sonuç modalında:

• ✅ SUCCESS — ürün başarıyla yayına girdi.
• ❌ FAIL — Red sebebi gösterilir (örn. zorunlu attribute eksik, banlı kelime, vb.). Hatayı giderip yeniden Gönder'e basın.

6. Sipariş Senkronizasyonu

1. Siparişler sekmesine geçin.
2. Pazarama'dan Çek butonuna tıklayın — Pazarama'daki siparişler local DB'ye yazılır ve diğer pazaryeri siparişleriyle aynı listede toplanır.

Sipariş kalemi başına 🚚 Kargo butonuyla, kargoladıktan sonra takip numarası + firma adını Pazarama'ya bildirebilirsiniz.

7. Müşteri Soruları

Sorular sekmesinde mağazanıza Pazarama üzerinden sorulan müşteri sorularını görüp yanıtlayabilirsiniz.

Sık Karşılaşılan Hatalar

Notlar

• Pazarama bir resmi sandbox ortamı sunmaz; Test Modu anahtarı şu an için canlı endpoint ile aynı şekilde çalışır.
• Webhook desteği şu sürümde yer almaz; siparişler periyodik Pazarama'dan Çek ile çekilir.
• Token süresi 1 saattir; sistem otomatik yeniler.