Pazaryeri Entegrasyonu Nasıl Yapılır? Trendyol, Hepsiburada

Pazaryeri entegrasyonu, kendi sisteminizdeki (ERP, e-ticaret sitesi ya da stok programı) ürün, fiyat, stok, sipariş ve kargo bilgisinin Trendyol, Hepsiburada, N11, Amazon gibi pazaryerleriyle otomatik olarak alışverişini sağlayan bağlantıdır. Üç yolla yapılır: pazaryerinin kendi API’sine doğrudan bağlanmak, birden çok pazaryerini tek arayüzde toplayan bir entegratör kullanmak ya da hazır e-ticaret altyapınızın modülünü açmak. Tek pazaryeriyle çalışan ve kendi yazılımı olan bir mağaza için doğrudan API tipik olarak 5-15 iş günlük bir geliştirme; iki veya daha fazla pazaryerinde satıyorsanız entegratör neredeyse her zaman daha ucuza gelir. Aşağıda üç yolun farkını, entegrasyonun gerçekte hangi dört akıştan oluştuğunu, maliyet kalemlerini ve mağazalara en pahalıya patlayan hataları bulacaksınız.

Pazaryeri entegrasyonu ne yapar?

Pazaryeri entegrasyonu tek bir bağlantı değil, birbirinden bağımsız çalışan dört akıştır. Bir teklif alırken hangisinin kapsam içinde olduğunu tek tek sormanız gerekir; “pazaryeri entegrasyonu yapıyoruz” cümlesi çoğu zaman yalnızca ilk ikisini kapsar:

• Katalog aktarımı: Ürünlerinizin pazaryerinin kategori ağacına ve zorunlu öznitelik (attribute) şemasına uygun şekilde açılması. Tek seferlik değildir; her yeni ürün ve her kategori değişikliği bu akıştan geçer.
• Stok ve fiyat senkronizasyonu: Kendi stoğunuz değiştiğinde pazaryerindeki adedin ve fiyatın dakikalar içinde güncellenmesi. Entegrasyonun en kritik ve en sık bozulan parçası budur.
• Sipariş çekme: Pazaryerine düşen siparişin kendi sisteminize müşteri, adres, ürün ve komisyon bilgisiyle birlikte inmesi; kabul/onay süresinin işletilmesi.
• Kargo, fatura ve iade: Sipariş için pazaryerinin anlaşmalı kargo etiketinin üretilmesi, e-arşiv faturasının kesilmesi, iade ve iptal taleplerinin sisteminize yansıması.

Dördü de aynı mantıkla, pazaryerinin REST API’si üzerinden çalışır. Bu akışların altındaki genel kavramları daha önce API entegrasyonu nedir yazısında anlatmıştık; buradaki fark, pazaryerlerinin API’lerinin kendi ticari kurallarını da dayatmasıdır: onay süresi, termin süresi, kategori komisyonu, iade penceresi.

Üç yol: doğrudan API, entegratör, hazır modül

Doğru yolu belirleyen tek soru şu: kaç pazaryerinde satacaksınız ve stok gerçeğiniz nerede duruyor? Kararın teknik değil ticari olduğunu unutmayın.

• Doğrudan API: Pazaryerinin geliştirici dokümantasyonuna kendi yazılımınızdan bağlanırsınız. Tek pazaryeri, özel iş kuralları (kampanya fiyatı hesaplama, kendi depo mantığı, B2B stok ayrımı) ve kendi ERP’si olan işletmeler için doğru seçim. Aylık abonelik yok, karşılığında bakım sizde: pazaryeri API sürümünü değiştirdiğinde güncelleme sizin işiniz.
• Çoklu pazaryeri entegratörü: Trendyol, Hepsiburada, N11, Amazon, Çiçeksepeti gibi kanalları tek panelde toplayan hazır servisler. Aylık ya da ciro üzerinden ücretlendirilir. İki ve üzeri kanalda satıyorsanız, geliştirme maliyetini sıfıra yakın indirdiği için neredeyse her zaman daha ekonomiktir. Bedeli esnekliktir: panelin desteklemediği bir iş kuralını uygulayamazsınız.
• Hazır altyapı modülü: İdeasoft, Ticimax, T-Soft, Shopify gibi altyapıların kendi pazaryeri modülleri. En hızlı başlangıç; altyapıyı zaten kullanıyorsanız çoğu zaman birkaç saatlik ayar işi. Sınırı da altyapının sınırıdır.

Pratik eşik: tek kanal + kendi yazılımınız varsa doğrudan API, iki ve üzeri kanal varsa entegratör. Üç pazaryerine ayrı ayrı doğrudan bağlanmak, üç ayrı API sözleşmesini ömür boyu bakımda tutmak demektir; bu maliyet ilk faturada değil, ikinci yılda görünür.

En zor kısım: ürün eşleştirme

Projelerde süreyi şişiren şey API’ye bağlanmak değil, katalogtur. Kendi veritabanınızdaki ürün ile pazaryerinin beklediği ürün aynı şey değildir. Dört noktada ayrışır:

• Barkod zorunluluğu: Pazaryerlerinin çoğu ürün açarken geçerli bir barkod (GTIN/EAN) ister. Kendi ürettiğiniz ürünlerde barkodunuz yoksa bu, entegrasyondan önce çözülmesi gereken bir operasyon işidir.
• Kategori ağacı: Sizin “Kadın > Elbise” dediğiniz kategori, pazaryerinde kendi kimliğine ve zorunlu alanlarına sahiptir. Her kategori için ayrı eşleştirme tablosu tutulur.
• Zorunlu öznitelikler: Kumaş cinsi, garanti süresi, menşe gibi alanlar kategoriye göre değişir ve boş bırakılırsa ürün onaya bile düşmez. Bu veriler çoğu mağazanın kendi sisteminde yoktur; üretilmesi gerekir.
• Varyantlar: Renk-beden gibi varyantlı ürünlerde stok, varyant seviyesinde tutulur. Kendi tarafınızda tek ürün gibi görünen kalemi varyant bazına açmadan doğru stok senkronu kurulamaz.

Bu yüzden gerçekçi bir projede geliştirmenin yarısı katalog hazırlığına gider. 200 üründe bir hafta, 20 bin üründe aylar süren bu iş, ürün verisi temiz olmayan mağazalarda entegrasyonun kendisinden pahalıdır. Sıfırdan bir kurulum planlıyorsanız kalem bazlı bütçeyi e-ticaret sitesi kurma maliyeti yazısında ayrıntılı anlattık.

Stok senkronizasyonu ve overselling

Aynı ürünü hem kendi sitenizde hem üç pazaryerinde satarken tek bir gerçek vardır: depodaki adet. Entegrasyonun asıl işi bu tek gerçeği dört yere aynı anda yansıtmaktır. Yansıtamazsa ortaya overselling çıkar: stokta olmayan ürünü satmak. Pazaryerleri bunu ceza puanı, mağaza puanının düşmesi ve tekrarında satışa kapatma ile karşılar.

Doğru kurulumda üç önlem birlikte çalışır: senkron aralığını dakikalarla ölçmek (saatte bir yeterli değildir), kritik stok seviyesinin altında ürünü pazaryerinden otomatik kapatmak, ve pazaryerine gönderilecek adedi gerçek stoktan bir emniyet payı düşerek hesaplamak. Çok satan bir üründe emniyet payı olmadan çalışmak, kampanya gününde kaçınılmaz olarak iptal üretir.

Sipariş, fatura ve kargo akışı

Sipariş düştükten sonra saat işlemeye başlar. Pazaryerleri, siparişin belirli bir süre içinde onaylanmasını ve kargoya verilmesini şart koşar; gecikme doğrudan mağaza performans puanına yazılır. Bu yüzden sipariş akışı entegrasyonun en çok otomasyon isteyen parçasıdır: sipariş sisteminize düşer, stok rezerve edilir, e-arşiv faturası kesilir, pazaryerinin anlaşmalı kargo firması için etiket üretilir ve takip numarası pazaryerine geri yazılır.

Bu zincirin iki halkasını ayrı yazılarda ele almıştık: fatura tarafı için e-fatura entegrasyonu, gönderi ve takip tarafı için kargo entegrasyonu nasıl yapılır. Pazaryerinde önemli fark şudur: kargo firmasını çoğu zaman siz seçmezsiniz, pazaryerinin anlaşmalı firması gelir ve etiket onun sisteminden üretilir.

Maliyet: nereye ne ödüyorsunuz?

Pazaryeri satışının maliyeti tek kalem değildir ve entegrasyon bunun en küçük parçasıdır. Kâr hesabınızı kurarken dört kalemi ayrı ayrı yazın:

• Komisyon: Kategoriye göre değişir ve aynı pazaryerinde bile kategoriden kategoriye ciddi fark eder. Tek bir oran varsaymayın; satacağınız kategorilerin güncel oranını satıcı panelinden teyit edin.
• Hizmet ve işlem bedelleri: Sipariş başına hizmet bedeli, kargo katkısı, kampanya katılım payı gibi kalemler komisyonun üzerine biner.
• Entegratör aboneliği: Çoklu kanal servislerinde aylık sabit ya da ciroya bağlı ücret.
• Geliştirme ve bakım: Doğrudan API yolunda tek seferlik geliştirme artı yılda birkaç kez API değişikliği bakımı. Katalog hazırlığı ayrı bir kalemdir ve çoğu teklifte yer almaz.

Bu dört kalemi toplamadan pazaryeri fiyatı belirlemek, en sık yapılan ticari hatadır. Kendi sitenizde kâr eden bir fiyat, komisyon ve hizmet bedelleri düşüldükten sonra pazaryerinde zarar ettirebilir.

Sık yapılan hatalar

• Stok senkronunu saatlik kurmak: Kampanya günlerinde bir saat, aynı ürünü onlarca kez satmaya yeter.
• Tek yönlü entegrasyon: Ürün ve stoğu gönderip siparişi panelden elle almak. İlk hafta işe yarar, sipariş sayısı arttığında çöker.
• İade ve iptalleri kapsam dışı bırakmak: İadeler sisteme dönmezse stok ve muhasebe birkaç ayda birbirinden kopar.
• Fiyatı tek yerden yönetmemek: Kampanya fiyatının pazaryeri panelinden elle değiştirilmesi, bir sonraki senkronda geri yazılır ve kampanya kendiliğinden bozulur.
• Test ortamı olmadan canlıya çıkmak: Pazaryerlerinin çoğu sandbox/test ortamı sunar. Canlı katalogda deneme yapmak, onay bekleyen yüzlerce hatalı ürün demektir.
• Loglama ve uyarı kurmamak: API hataları sessizce birikir. Hangi ürünün neden aktarılamadığını gösteren bir ekran yoksa sorun ancak satış düşünce fark edilir.

Sonuç

Pazaryeri entegrasyonu teknik olarak bir API bağlantısıdır, pratikte ise katalog disiplini ve stok gerçeğinin tek kaynaktan yönetilmesi işidir. Tek kanalda ve kendi yazılımınızla çalışıyorsanız doğrudan API, iki ve üzeri kanalda satıyorsanız entegratör doğru başlangıçtır; her iki durumda da bütçenin yarısını katalog hazırlığına ayırın. Kendi sisteminizi pazaryerlerine bağlamak için yol haritası çıkarmak isterseniz özel yazılım geliştirme hizmetimize göz atabilir ya da teklif alabilirsiniz; kapsamı birlikte netleştirelim.