Pazaryeri Entegrasyonu Kurulumu: API Bilgileri ve İlk Ayarlar

Kısa cevap

Sağlıklı kurulum, API bilgisini girip bağlantı testi yapmakla bitmez. Yetkilendirme sonrası mağaza verisi okunmalı, kategori ve marka kaynakları çekilmeli, küçük bir ürün grubuyla gönderim test edilmeli ve stok-fiyat ile sipariş akışı ayrı ayrı doğrulanmalıdır.

Pazaryeri Entegrasyonu Kurulumu neden önemli?

Bağlantı testi başarılı olduğu halde ürün gönderimi başarısız olabilir; çünkü kategori özelliği, marka ID'si, kargo şablonu veya zorunlu alan gibi ürün katmanındaki gereksinimler ayrıca tamamlanmalıdır.

Kurulumun amacı yalnız bağlantıyı 'yeşil' göstermek değil, ürün ve sipariş yaşam döngüsünün tamamını doğrulamaktır. API kimliği doğru olsa bile kategori, marka, özellik, kargo veya sipariş yetkisi eksik olabilir.

2026 itibarıyla pazaryerleri katalog ve sipariş servislerini düzenli olarak güncelliyor. Bu nedenle entegrasyon kararını yalnız bir kez yapılan kurulum gibi değil, izlenen ve güncellenen bir operasyon sistemi gibi ele almak daha sağlıklıdır.

Doğru çalışma mantığı nasıl kurulmalı?

En güvenli sıra kimlik doğrulama → referans verileri çekme → tekil ürün → stok-fiyat → sipariş → hata senaryosu şeklindedir. Her aşama çalışmadan sonraki aşamada toplu hacme geçmek teşhisi zorlaştırır.

Ürün veya sipariş kaydında yerel kimlik ile pazaryerinin uzak kimliğini birlikte saklamak, tekrar deneme ve durum sorgularında kritik önem taşır. İşlem geçmişi kaybolmadığında aynı kaydın neden beklediği veya reddedildiği daha hızlı bulunur.

Adım adım uygulama planı

Satıcı panelinden resmi API/entegrasyon kimliklerini alın ve yetkileri kontrol edin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Bağlantı testinde mağaza veya satıcı bilgisini okuyabildiğinizi doğrulayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Kategori, marka ve kategori özellik listelerini yerel sisteme çekin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Tek bir basit ürünle katalog veya ürün oluşturma testi yapın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Stok ve fiyat güncellemesini ayrı bir istek olarak doğrulayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Bir test siparişinin entegrasyona düşmesini ve durum güncellemesini kontrol edin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Başarısız görevlerin logunu ve yeniden deneme mekanizmasını test edin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.

Kontrol ve ölçüm noktaları

Kurulum tamamlandı demeden önce en az bir ürünün gönderim sonucu, bir stok-fiyat değişikliği ve bir sipariş durumu uçtan uca doğrulanmalıdır. Ayrıca başarısız isteğin kullanıcıya nasıl gösterildiği kontrol edilmelidir.

İşlem hangi mağaza ve kanal için çalıştı?
Yerel SKU/barkod ile uzak ürün kimliği eşleşiyor mu?
Son durum ilk API yanıtından mı, nihai sonuç servisinden mi geliyor?
Başarısız işlem için kullanıcıya anlaşılır hata nedeni gösteriliyor mu?
Tekrar deneme mükerrer ürün veya sipariş oluşturmadan çalışıyor mu?
Canlı kanalda örnek ürün/sipariş ile sonuç doğrulandı mı?

Sık yapılan hatalar ve düzeltme yaklaşımı

Canlı mağazada binlerce ürünü ilk testte toplu göndermek.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

API anahtarını ekran görüntüsü veya açık metin dosyasında paylaşmak.

Kategori özelliklerini güncellemeden eski eşleştirmeleri kullanmak.

Bağlantı testini entegrasyonun tamamı çalışıyor sanmak.

2026 için güncellik notları

Pazaryeri API dokümanları, endpoint sürümleri, zorunlu alanlar ve işlem limitleri zaman içinde değişebilir. Bu yazıdaki operasyon mantığını uygularken ilgili kanalın güncel geliştirici veya satıcı destek dokümanını esas alın. Özellikle ürün oluşturma, toplu güncelleme ve sipariş durum servislerinde sürüm notlarını takip etmek gerekir.

Canlı sistemlerde değişiklik yapmadan önce küçük ürün grubu, düşük riskli stok-fiyat değeri ve test edilebilir sipariş senaryosu kullanmak; geniş kataloğa geçmeden önce hata davranışını görmeyi sağlar.

3E Entegrasyon tarafında hangi akışlar değerlendirilebilir?

3E Yazılım’ın pazaryeri entegrasyonu sayfasında XML, Excel, manuel ürün ekleme, desteklenen bağlantılardan ürün alma, tekil/toplu ürün gönderimi, kategori-özellik eşleştirme, stok-fiyat senkronizasyonu ve sipariş takibi gibi operasyon başlıkları yer alıyor. İhtiyacınız bu akışlardan biriyse önce gerçek ürün verinizle demo senaryosu oluşturmak en sağlıklı karşılaştırma yöntemidir.

Pazaryeri entegrasyonu özelliklerini inceleyin veya demo talebi oluşturun.

Sık sorulan sorular

API bilgileri nereden alınır?

Her pazaryerinin satıcı/merchant panelinde veya entegrasyon ayarlarında farklı alanlarda bulunur; resmi doküman izlenmelidir.

İlk önce ürün mü sipariş mi test edilmeli?

Bağlantıdan sonra ürün, stok-fiyat ve sipariş akışları ayrı test senaryolarıyla doğrulanmalıdır.

Canlı ürünlerle test güvenli mi?

Küçük, kontrollü bir ürün grubu ve geri alınabilir fiyat/stok değerleri kullanmak daha güvenlidir.