Pazaryeri Entegrasyonu: Trendyol ve Hepsiburada'yı Sitenize Bağlamak

Kendi sitenizde ve pazaryerlerinde aynı ürünleri satıyorsanız, büyük ihtimalle şu sahneyi yaşamışsınızdır: bir ürün Trendyol'da satılıyor, stok sitede düşmüyor, birkaç saat sonra aynı ürün sitenizden de satılıyor ve elinizde gönderecek ürün kalmıyor. Pazaryeri entegrasyonu, ürün, stok, fiyat ve sipariş bilgisini tek bir merkezden yöneterek bu sorunu çözer. Bunu iki yoldan yapabilirsiniz: hazır bir entegratör hizmeti kullanmak ya da pazaryerlerinin satıcılara sunduğu API'ler üzerinden kendi entegrasyonunuzu yazdırmak. Bu yazıda ikisinin farkını ve bir entegrasyon projesini baştan sona hangi adımlarla yürüttüğümüzü anlatıyoruz.

Entegrasyon neyi senkronize eder?

Bir pazaryeri entegrasyonunda veri iki yönde akar. Hangi verinin hangi yöne aktığını baştan netleştirmek, projenin en önemli tasarım kararıdır.

Trendyol'un entegrasyon dokümantasyonunda da ürün aktarımı, stok ve fiyat güncelleme, sipariş paketleri, fatura gönderimi ve müşteri soruları ayrı servis grupları olarak yer alıyor. Hepsiburada da satıcılar için ayrı bir API portalı sunuyor.

Entegratör mü, API ile özel entegrasyon mu?

Pratikte şöyle bir ayrım yapıyoruz: ürün sayısı ve iş kuralları standartsa, kiralık bir e-ticaret platformu kullanıyorsanız ve birden fazla pazaryerine hızla açılmak istiyorsanız, platformun yerleşik entegrasyonu ya da bir entegratör genellikle yeterli. Kendi ERP'niz veya stok yazılımınız merkezdeyse, kanal bazında karmaşık fiyat kurallarınız varsa ya da entegratörün desteklemediği bir akışa ihtiyacınız varsa özel entegrasyon mantıklı hâle gelir. Hazır platformların pazaryeri yeteneklerini hazır e-ticaret platformu karşılaştırmamızda ele aldık.

Adım adım entegrasyon süreci

1. Tek doğruluk kaynağını (master) belirleyin.

   Neden: Stoğun "asıl" değeri tek bir yerde tutulmazsa, kanallar birbirinin üzerine yazar ve hangi rakamın doğru olduğu bilinmez.

   Nasıl: Ürün ve stok verisinin nerede yaşayacağına karar verin: e-ticaret siteniz mi, ERP'niz mi, stok takip yazılımınız mı? Diğer bütün kanallar bu kaynaktan beslenmeli ve satışları bu kaynağa bildirmeli. Stok yazılımı seçimi aşamasındaysanız stok takip yazılımı rehberimizdeki senkronizasyon kriterleri işinize yarar.

2. Ürün verisini temizleyin ve benzersiz anahtarları oturtun.

   Neden: Entegrasyon, ürünleri kanallar arasında bir anahtar (SKU, stok kodu, barkod) üzerinden eşleştirir. Aynı ürüne iki farklı kod verilmişse ya da varyantların kodu yoksa eşleştirme bozulur.

   Nasıl: Her varyantın (renk, beden) kendi benzersiz stok kodu ve barkodu olsun. Ürün adlarını, marka bilgisini ve özellikleri tutarlı hâle getirin. Görselleri pazaryerlerinin istediği ölçü ve arka plan kurallarına göre hazırlayın.

3. Kategori ve özellik eşleştirmesini yapın.

   Neden: Her pazaryerinin kendi kategori ağacı ve kategoriye özgü zorunlu özellikleri vardır. Sizin "Kupa" kategoriniz pazaryerinde farklı bir ağaç altında olabilir ve o kategori için "hacim" veya "malzeme" özelliği zorunlu olabilir.

   Nasıl: Pazaryerinin kategori ve özellik listesini API üzerinden çekip kendi kategorilerinizle bir eşleştirme tablosu hazırlayın. Eşleştirmeyi bir kez yapıp sistemde saklayın; yeni ürünler bu tabloya göre otomatik gönderilsin.

4. API erişimini alın ve test ortamında çalışın.

   Neden: Canlı mağazanızda deneme yapmak, gerçek müşterilere yanlış fiyat veya stok göstermek demektir.

   Nasıl: Satıcı panelinden entegrasyon bilgilerinizi (satıcı kimliği, API anahtarı ve şifresi) alın. Bu bilgileri kodun içine değil, sunucuda güvenli bir yapılandırma alanına koyun. Pazaryerinin test ortamı varsa ilk geliştirmeyi orada yapın.

5. Ürün gönderimini toplu ve asenkron kurgulayın.

   Neden: Pazaryerleri ürün oluşturma isteklerini çoğunlukla toplu kabul eder ve arka planda işler. İsteğin kabul edilmesi, ürünün yayına girdiği anlamına gelmez; onay sürecinde reddedilebilir.

   Nasıl: Ürünleri gruplar hâlinde gönderin, dönen işlem numarasını saklayın ve sonucu belirli aralıklarla sorgulayın. Reddedilen ürünleri hata nedeniyle birlikte bir listeye düşürün; ekip eksikleri buradan tamamlasın.

6. Stok ve fiyat güncellemesini olay bazlı yapın.

   Neden: Tüm katalogu her birkaç dakikada bir göndermek hem gereksiz yük yaratır hem de pazaryerinin istek sınırlarına takılır.

   Nasıl: Yalnızca değişen ürünleri gönderin: bir satış, bir iade, bir depo sayımı ya da fiyat değişikliği olduğunda ilgili ürün kuyruğa eklensin. Ek olarak, günde bir kez tam karşılaştırma (mutabakat) çalıştırıp kanallardaki stokla merkezdeki stoğu kıyaslayın.

7. Siparişleri düzenli çekin ve tekrar kayda karşı koruyun.

   Neden: Aynı siparişin iki kez kaydedilmesi, stoğun iki kez düşmesi ve iki kez fatura kesilmesi demektir.

   Nasıl: Siparişleri belirli aralıklarla sorgulayın (pazaryeri bildirim/webhook sunuyorsa onu da kullanın). Her siparişi pazaryerinin sipariş veya paket numarasıyla kaydedin ve aynı numara tekrar geldiğinde yeni kayıt açmak yerine mevcut kaydı güncelleyin. Siparişin durum değişikliklerini (onaylandı, kargoda, teslim edildi, iptal) de izleyin.

8. Kargo, fatura ve iade akışını bağlayın.

   Neden: Sipariş çekmek işin yarısı; takip numarası ve fatura pazaryerine geç iletilirse satıcı performans puanı etkilenebilir.

   Nasıl: Sipariş paketlendiğinde takip numarasını pazaryerine bildirin. Faturayı e-Arşiv/e-Fatura sisteminizden oluşturup pazaryerinin istediği şekilde iletin; bu akışın teknik tarafını e-Fatura ve e-Arşiv entegrasyonu yazımızda anlattık. İadeler geldiğinde stoğu geri ekleyin ve muhasebe kaydını oluşturun.

9. Hata yönetimi ve izleme kurun.

   Neden: Entegrasyonlar sessizce bozulur. Bir API anahtarının süresi dolar, bir kategori özelliği zorunlu hâle gelir ya da istek sınırı aşılır ve kimse fark etmez.

   Nasıl: Her isteği ve yanıtı kayıt altına alın. Geçici hatalarda (zaman aşımı, sunucu hatası, HTTP 429 "çok fazla istek") isteği artan bekleme süreleriyle yeniden deneyin. Kalıcı hatalarda (geçersiz veri, yetki hatası) yeniden denemek yerine ekibe bildirim gönderin. Son başarılı stok güncellemesinin ne zaman yapıldığını gösteren basit bir panel, sorunları saatler değil dakikalar içinde fark etmenizi sağlar.

10. Kademeli canlıya geçin.

    Neden: Tüm katalogu tek seferde açmak, eşleştirme hatalarını yüzlerce ürüne yayar.

    Nasıl: Önce 10-20 ürünle başlayın, birkaç gün siparişleri ve stok hareketlerini elle kontrol edin. Sorun yoksa katalogu kategoriler hâlinde genişletin. İlk haftalarda günlük mutabakat raporunu mutlaka okuyun.

Sık yapılan hatalar

• Stok tamponu bırakmamak: Senkronizasyon ne kadar hızlı olursa olsun, iki kanalda aynı anda satış ihtimali vardır. Az stoklu ürünlerde pazaryerine gerçek stoktan birkaç adet eksik göndermek, satıp gönderememe riskini azaltır.
• Kampanya fiyatlarını unutmak: Pazaryerinde bir kampanyaya katıldığınızda, entegrasyonun bir sonraki fiyat güncellemesinde kampanya fiyatını ezmemesi gerekir. Kanal bazlı fiyat kurallarını ve istisnaları sistemde tanımlayın.
• Komisyonu fiyat hesabına katmamak: Pazaryeri fiyatını sitedeki fiyatla aynı tutmak, kategoriye göre değişen komisyon ve kargo maliyeti nedeniyle kârlılığı bozabilir. Kanal bazlı fiyatlamayı komisyon ve kargo kalemleriyle birlikte hesaplayın.
• Varyantları tek ürün gibi göndermek: Renk ve bedenleri ayrı ürünler olarak göndermek, pazaryerinde dağınık listelemelere ve yanlış eşleşmelere yol açar. Varyant gruplamasını pazaryerinin kurallarına göre yapın.
• API değişikliklerini takip etmemek: Pazaryerleri servislerini yeni sürümlerle güncelliyor ve eski sürümleri belirli bir takvimle kapatabiliyor. Dokümantasyondaki değişiklik kayıtlarını (changelog) düzenli izleyin ya da bunu bakım sözleşmesinin bir parçası yapın.
• Tek bir kişinin bilgisine bağımlı kalmak: Eşleştirme tabloları, fiyat kuralları ve hata çözümleri yazılı olmalı. Entegrasyonu kuran kişi ayrıldığında sistem anlaşılmaz hâle gelmemeli.

Kanal bazlı fiyat kuralı nasıl kurulur?

Entegrasyonda en çok tartışılan konulardan biri, pazaryeri fiyatının nasıl belirleneceği. Elle her ürüne ayrı fiyat girmek yerine, sistemde kural tanımlamak sürdürülebilir bir yöntemdir. Basit bir kural yapısı şöyle olabilir:

1. Taban fiyat: Merkezdeki satış fiyatı (örneğin sitedeki fiyat).
2. Kanal maliyeti: İlgili pazaryerinin o kategorideki komisyonu, varsa hizmet bedeli ve kargo maliyeti farkı.
3. Hedef marj: Kanal maliyeti düşüldükten sonra elinizde kalmasını istediğiniz tutar veya oran.
4. Yuvarlama ve sınırlar: Fiyatı psikolojik bir değere yuvarlama, minimum fiyatın altına düşmeme ve kampanya dönemlerinde kuralı askıya alma seçenekleri.

Örnek (tamamen varsayımsal): sitede 400 TL'ye satılan bir ürün için pazaryeri komisyonunu ve kargo farkını hesaba katan kural, pazaryeri fiyatını 449 TL olarak hesaplayabilir. Komisyon oranları kategoriye ve döneme göre değiştiği için bu oranları sabit kodlamak yerine yönetim panelinden güncellenebilir tutmak gerekir. Kuralın sonucunu, ürünler pazaryerine gönderilmeden önce bir önizleme listesinde görmek de hatalı fiyatların yayına çıkmasını önler.

Örnek senaryo: Site, iki pazaryeri ve bir depo

İzmir'de ev tekstili satan, kendi sitesi ile iki pazaryerinde mağazası olan ve tek bir depodan gönderim yapan bir işletme düşünelim (senaryo örnektir). Kurguladığımız yapı şöyle olur:

• Stok ve ürün verisinin asıl kaynağı işletmenin stok yazılımıdır.
• Site ve pazaryerleri bu kaynaktan beslenir; satışlar da bu kaynağa bildirilir.
• Bir satış olduğunda ilgili ürünün yeni stok değeri diğer kanallara kısa sürede gönderilir.
• Stoğu belirli bir eşiğin altındaki ürünlerde pazaryerlerine tampon düşülmüş stok gönderilir.
• Gece çalışan bir mutabakat işi, kanallardaki stok ve fiyatı merkezle karşılaştırır ve farkları raporlar.
• Siparişler tek bir sipariş ekranında toplanır; depo ekibi hangi kanaldan geldiğine bakmadan aynı ekrandan paketler.

Bu yapıda yeni bir pazaryeri eklemek, yeni bir kanal bağlayıcısı yazmak ve eşleştirme tablosunu doldurmak anlamına gelir; merkezdeki iş akışı değişmez. Daha önce tekrarlı işleri otomatikleştirmek için kullandığımız iş akışı araçlarını n8n ile iş otomasyonu yazımızda anlattık; küçük ölçekli entegrasyonlarda bu tür araçlar da bir seçenek olabilir.

Sık Sorulan Sorular

Pazaryeri entegrasyonu için yazılım bilgisi gerekir mi?

Hazır bir entegratör ya da e-ticaret platformunuzun yerleşik entegrasyonunu kullanıyorsanız temel düzeyde panel kullanımı yeterli olur. Kendi API entegrasyonunuzu yaptırıyorsanız geliştirme bir yazılım ekibinin işidir; ama eşleştirme kuralları ve fiyat politikası gibi kararları işletmenin vermesi gerekir.

Stok ne sıklıkla güncellenmeli?

İdeali, stok değiştiği anda ilgili ürünün güncellenmesidir. Pazaryerlerinin istek sınırları ve işlem süreleri nedeniyle küçük gecikmeler kaçınılmazdır; bu yüzden olay bazlı güncellemenin yanında periyodik bir mutabakat ve az stoklu ürünlerde tampon kullanmak en güvenli yaklaşımdır.

Pazaryerinde ürün açıklamasını sitedekinden farklı yazmalı mıyım?

Zorunlu değil, ama faydalı olabilir. Pazaryerinin özellik alanlarını eksiksiz doldurmak orada filtrelenebilirliği artırır. Sitenizde ise aynı metni birebir kullanmak yerine daha zengin ve özgün bir açıklama sunmak, arama motorlarında sitenizin ayırt edici olmasına katkı sağlar.

Birden fazla depo varsa entegrasyon nasıl çalışır?

Her depo için ayrı stok tutulur ve hangi deponun hangi kanala stok verdiği kurallarla belirlenir. Bazı pazaryerleri depo bazlı stok bildirimi destekler; desteklemiyorsa toplam satılabilir stok hesaplanıp gönderilir. Sipariş geldiğinde hangi depodan gönderileceği de bu kurallara göre atanır.

Entegrasyon kurulduktan sonra bakım gerekir mi?

Evet. Pazaryerleri API'lerini, kategori şablonlarını ve zorunlu alanlarını zaman zaman güncelliyor. Hata kayıtlarının izlenmesi, yeni sürümlere geçiş ve eşleştirme tablolarının güncellenmesi düzenli bakım gerektirir. Bunu baştan bütçe ve sözleşmeye dahil etmek, sürpriz kesintileri önler.

Nereden başlamalı?

İlk adım teknik değil: stoğun asıl kaynağına karar vermek ve ürün verisini benzersiz kodlarla temizlemek. Bu iki iş tamamlandığında, entegratör mü özel entegrasyon mu sorusu da netleşir. Kendi stok veya ERP sisteminizi pazaryerlerine bağlamak, kanal bazlı fiyat kuralları kurmak ya da mevcut entegrasyonunuzdaki sorunları çözmek için özel yazılım hizmetimizi inceleyebilir veya bize yazabilirsiniz. Mağazanızı yeni kuruyorsanız sürecin tamamı için e-ticaret sitesi kurma rehberimize göz atın.

Kaynaklar

• Trendyol – Entegrasyon Dokümantasyonu
• Hepsiburada – API Portal
• MDN – 429 Too Many Requests