Trendyol'da bir ürününüz bitti, Hepsiburada'da hâlâ satılıyor. Sabah panelden panele girip fiyatı değiştiriyorsunuz, öğleden sonra aynı siparişi hem depo ekranına hem fatura programına yeniden yazıyorsunuz. Kanal sayısı arttıkça bu iş katlanır. Pazaryeri entegrasyonu, ürün, stok, fiyat ve siparişin pazaryerleri ile kendi sisteminiz arasında otomatik akmasını sağlayan bağlantıdır; ürünü bir kez tanımlar, her kanalda doğru stok ve fiyatla satarsınız.
Bu rehberde pazaryeri entegrasyonunun neyi senkronize ettiğini, ürün eşleştirmenin nasıl yapıldığını, stokta fazla satışı önleyen hesabı, kanal bazlı fiyatın nasıl bulunduğunu, sipariş, kargo, fatura ve iade akışını, hazır panel ile özel entegrasyon farkını ve altı adımlık kurulum planını anlatıyoruz. Örnek rakamların hepsi temsilîdir; kendi verinizle değiştirerek kullanabilirsiniz.
Pazaryeri Entegrasyonu Nedir?
Pazaryeri entegrasyonu, Trendyol, Hepsiburada, n11, Amazon, ÇiçekSepeti gibi satış kanallarının API'leri üzerinden ürün, stok, fiyat ve sipariş verisinin sizin sisteminizle otomatik alışverişidir. Sisteminiz ERP, e-ticaret altyapınız ya da özel bir yönetim paneli olabilir; önemli olan ürün ve stoğun yönetildiği ana yerin tek olmasıdır.
Entegrasyon olmadan her pazaryeri ayrı bir mağazadır: ürün kartı, fiyat ve stok her panelde ayrı girilir, siparişler ayrı ayrı indirilir. Entegrasyonla iki yönlü bir akış kurulur. Ürün, stok ve fiyat sizden pazaryerine gider; sipariş, iptal ve iade pazaryerinden size gelir.
Bu yazı, genel sistem bağlantısını anlatan API entegrasyonu rehberimizden farklı olarak yalnızca satış kanallarının günlük işleyişine, yani katalog, stok, fiyat ve sipariş akışına odaklanır.
Okumanızı öneririz: Entegrasyon ve API geliştirme hizmetimiz
Pazaryeri Entegrasyonu Neyi Senkronize Eder?
Yedi veri türü senkronize edilir: ürün kartı, stok, fiyat, sipariş, kargo, fatura ve iade. Her birinin yönü ve hızı farklıdır; stok ve fiyat dakikalar içinde, ürün kartı ise çok daha seyrek güncellenir.
| Veri | Yön | Ne sıklıkla? | Elle yapılırsa ne olur? |
|---|---|---|---|
| Ürün kartı | Sizden pazaryerine | Yeni ürün ve içerik değişikliğinde | Aynı başlık ve görsel her panele ayrı yüklenir |
| Stok | Sizden pazaryerine | Her satış ve stok hareketinde, dakikalar içinde | Bitmiş ürün satılmaya devam eder |
| Fiyat | Sizden pazaryerine | Fiyat ya da kampanya değişince | Kanallar arası fiyat tutarsızlığı çıkar |
| Sipariş | Pazaryerinden size | Birkaç dakikada bir ya da bildirimle | Siparişler tek tek panelden indirilir |
| Kargo | İki yönlü | Sipariş onayında ve teslim hareketlerinde | Etiket firmanın panelinden elle alınır |
| Fatura | Sizden pazaryerine | Sipariş hazırlandığında | Fatura sipariş sipariş ayrıca kesilir ve yüklenir |
| İptal ve iade | Pazaryerinden size | Talep geldiğinde | Stok ve cari kayıtlar geç ve hatalı düzelir |
Ürün Eşleştirme Nasıl Yapılır?
Ürün eşleştirme, sizdeki ürünün her pazaryerindeki karşılığını tanımlamaktır; en sağlam anahtar barkoddur (GTIN). Barkodu aynı olan ürün aynı ürün sayılır, barkodu olmayanlar için sizin stok kodunuz ile pazaryerindeki kod arasında elle bir eşleme tablosu kurulur.
Eşleştirme üç katmanda yürür:
- Ürün ve varyant: Aynı ürünün beden, renk ya da paket seçenekleri ayrı satırlar olarak eşlenir. Stok varyant düzeyinde tutulmazsa bir bedenin bitmesi bütün ürünü kapatır ya da tam tersi.
- Kategori: Her pazaryerinin kendi kategori ağacı vardır. Sizin "Mutfak > Tencere" kategoriniz Trendyol'da başka, Hepsiburada'da başka bir yola karşılık gelir; bir eşleme tablosu bunu bir kez tanımlar.
- Özellik: Renk, malzeme, hacim gibi zorunlu özellikler her kategoride farklı değerlerle istenir. Zorunlu özellik eksik gönderilen ürün yayına alınmaz.
Eşleştirmenin başarısını tek bir oranla izleyebilirsiniz:
Hedef %100'dür ama yolu bir seferde tamamlamak yerine her gün eksik listesini kısaltmaktır. Eşleşmeyen ürün satılamaz; listeyi sistem üretir, ekip tamamlar.
Stok Senkronizasyonu Nasıl Çalışır, Fazla Satış Nasıl Önlenir?
Her satış stoğu düşürür ve yeni değer tüm kanallara gönderilir. Fazla satışı önleyen şey, kanallara fiziksel stoğu değil, satılabilir stoğu bildirmektir.
Örnek: depoda 40 adet var, sevk bekleyen siparişler 6 adedi ayırmış ve 4 adet güvenlik stoku tutuyorsunuz. Kanallara toplam 40 − 6 − 4 = 30 adet bildirilir. Bu 30 adedi kanallar arasında paylaştırmak isterseniz bir kanal tahsisi kuralı tanımlarsınız:
| Kanal | Pay | Bildirilen stok |
|---|---|---|
| Trendyol | %50 | 15 adet |
| Hepsiburada | %30 | 9 adet |
| Kendi siteniz | %20 | 6 adet |
| Toplam | %100 | 30 adet |
Tahsis, bir kanalda ani yükselen satışın diğer kanalların stoğunu tüketmesini önler. Bir kanalda pay biterken diğerinde kalıyorsa kural, kullanılmayan payı otomatik başka kanala aktaracak biçimde de yazılabilir.
Güvenlik stoku nasıl belirlenir?
Güvenlik stoğunun alt sınırı, senkronizasyon gecikmesi sırasında satılabilecek miktardır: kanalın saatlik satış hızı × senkron aralığı (saat cinsinden). Kampanyada bir kanalda saatte 30 sipariş geliyorsa ve stok güncellemesi 15 dakikada bir yapılıyorsa 30 × (15 ÷ 60) = 7,5 adet, yani yaklaşık 8 adet risk vardır. Aralığı 1 dakikaya indirirseniz 30 × (1 ÷ 60) = 0,5 adede düşer.
Bu nedenle kampanya dönemlerinde hem senkron aralığı kısaltılır hem de güvenlik stoku büyütülür. Pazaryerlerinin istek sınırları vardır; çok sık güncellemek için yalnızca değişen ürünün gönderilmesi gerekir.
Okumanızı öneririz: Stok takibi nasıl yapılır? Formüllerle uygulamalı rehber
Pazaryerine Göre Fiyat Nasıl Belirlenir?
Her kanalın komisyonu farklı olduğu için aynı kârı elde etmek istiyorsanız kanal fiyatı da farklı olur. Temel formül, hedef hakedişi komisyonun tamamlayıcısına bölmektir.
Örnek: bir üründen cebinizde ₺680 kalmasını istiyorsunuz. Komisyon oranı %12 olan bir kanalda fiyat 680 ÷ 0,88 ≈ ₺772,73, %18 olan bir kanalda 680 ÷ 0,82 ≈ ₺829,27 olur. Oranlar temsilîdir ve bu hesap komisyonun KDV dahil fiyat üzerinden kesildiğini varsayar; pazaryerine göre komisyon KDV hariç ya da KDV ayrıca eklenerek alınabilir.
Gerçek oranlar için pazaryerinin resmi komisyon listesine bakılır; kaynaksız bir oranı sisteme yazmayın. Komisyonu, KDV farkını ve net kârı kategori bazında hesaplayan komisyon hesaplama araçlarımız bu işi kolaylaştırır (Turkish interface).
Fiyat kuralları entegrasyona nasıl yazılır?
Fiyatı ürün ürün elle girmek yerine kural olarak tanımlarsınız: "hedef hakedişi koru", "kanal fiyatı en fazla kendi sitedeki fiyatın %10 üstü olsun", "kampanya fiyatı bu tabanın altına inmesin". Kural bir ürüne uymadığında sistem fiyatı göndermez ve uyarı verir; bu, hatalı bir fiyatın yanlışlıkla yayına çıkmasını engeller.
Sipariş, Kargo, Fatura ve İade Akışı Nasıl Yönetilir?
Sipariş geldiği anda sırayla şu işlemler kendiliğinden başlar: sipariş çekilir, stok rezerve edilir, depoya toplama listesi düşer, kargo kaydı açılır, fatura oluşur ve takip bilgisi pazaryerine geri yazılır. Akışın hiçbir adımında aynı bilgi ikinci kez elle girilmez.
- Sipariş çekme: Entegrasyon yeni siparişleri belirli aralıklarla sorgular ya da pazaryeri bildirim gönderiyorsa onu dinler.
- Stok ayırma: Sipariş sisteme girdiği anda rezerve stok artar ve diğer kanallara bildirilen stok düşer.
- Hazırlama ve kargo: Depo ekranına toplama listesi gider, kargo firmasında gönderi kaydı açılır, barkod ve etiket sisteminizden basılır.
- Fatura: e-Fatura ya da e-Arşiv, sipariş verisinden üretilir; pazaryerinin istediği biçimde yüklenir ve muhasebe kaydı atılır.
- Durum güncelleme: Kargo takip numarası ve teslim durumu pazaryerine bildirilir; süresinde bildirilmeyen sipariş satıcı performansını düşürür.
İptal ve iade stoğu nasıl etkiler?
İptal ve iade kurallara bağlanmazsa stok yanlış görünür. Her duruma karşı net bir stok davranışı tanımlanır:
| Durum | Stok kararı | Ek işlem |
|---|---|---|
| Sevk edilmeden iptal | Rezerve serbest bırakılır, stok geri açılır | Faturalandıysa fatura iptali ya da iade faturası |
| Teslim sonrası, sağlam iade | Ürün kontrolden geçince stoğa eklenir | İade faturası, cari düzeltme |
| Hasarlı ya da kullanılmış iade | Satılabilir stoğa eklenmez, ayrı depoya alınır | Hasar kaydı, gerekirse tedarikçi talebi |
| Kısmi iade | Yalnızca iade edilen adet stoğa döner | Kısmi iade faturası |
İade edilen ürünü kontrolden geçmeden satılabilir stoğa eklemek, aynı ürünün hasarlı hâlde ikinci kez satılmasına yol açar. Bu yüzden iade stoğa girişi bir onay adımına bağlanır.
Okumanızı öneririz: Muhasebe yazılımı: e-Fatura, e-Arşiv ve cari hesap akışı
Hazır Panel mi, Özel Pazaryeri Entegrasyonu mu?
Standart bir akışınız ve birkaç kanalınız varsa hazır panel çoğu zaman yeterlidir; kuralları kendinize özgüyse, kanal sayısı fazlaysa ya da ERP'nizle derin bir bağ gerekiyorsa özel entegrasyon daha uygun olur.
| Başlık | Hazır panel | Özel entegrasyon |
|---|---|---|
| Kurulum | Hızlı; hesap bağlanır, eşleştirme yapılır | Analiz ve geliştirme süresi gerekir |
| Stok ve fiyat kuralları | Paketin sunduğu seçeneklerle sınırlı | İş kurallarınıza göre yazılır |
| ERP ve depo bağı | Hazır bağlantı varsa sınırlı alanlar | Sipariş, maliyet ve stok sistemlerinizle bire bir |
| Yeni kanal ekleme | Satıcının desteklediği kanallarla sınırlı | API'si olan her kanal eklenebilir |
| Hata görünürlüğü | Panelin sunduğu kadar | Hata kuyruğu, uyarı ve yeniden deneme ihtiyaca göre |
| Uygun olduğu durum | Az kanal, standart akış, düşük özgünlük | Çok kanal, yüksek hacim, özgün kural ve ERP bağı |
Okumanızı öneririz: Hazır yazılım mı, özel yazılım mı? Karar rehberi
Pazaryeri Entegrasyonu Seçerken Hangi Sorular Sorulur?
Çözümü seçerken yapılan en sık hata, yalnızca kaç pazaryerini desteklediğine bakmaktır. Asıl fark, işler ters gittiğinde ne olduğunda ortaya çıkar. Teklif toplarken şu soruları sorun:
- Stok ne kadar sürede güncellenir? Dakika mı, saat mi? Kampanya dönemi için aralık kısaltılabiliyor mu?
- Varyant düzeyinde stok tutuluyor mu? Beden ve renk bazında mı, ürün bazında mı?
- Kanal tahsisi ve güvenlik stoku tanımlanabiliyor mu?
- Kanal bazlı fiyat kuralı yazılabiliyor mu? Hedef hakediş ya da taban fiyat gibi kuralları kabul ediyor mu?
- Hata nerede görünür? Reddedilen ürün, eşleşmeyen kategori ve başarısız sipariş bir listede toplanıyor ve sorumluya haber veriliyor mu?
- API değişikliklerini kim izler? Pazaryeri eski sürümü kapattığında entegrasyonun güncellenmesi kimin sorumluluğunda?
- Veri size ait mi? Çözümden çıkmak isterseniz ürün eşleme tablolarını ve sipariş geçmişini alabiliyor musunuz?
- ERP, muhasebe ve kargo ile bağ var mı? Sipariş, fatura ve gönderi aynı akışın içinde mi, yoksa ayrı araçlarda mı?
Pazaryeri Entegrasyonu Nasıl Kurulur? Altı Adımda Plan
Sağlıklı bir kurulum önce katalogu düzene sokar, sonra kuralları yazar, en son kanalı açar. Kanalı açmak kolaydır; düzensiz bir kataloğu açtığınız her kanalda hata katlanır.
- Kanal seçimi: Hangi pazaryerlerinde satacağınız, her birinde satıcı hesabının ve API yetkisinin durumu belirlenir. Önce tek kanalla başlamak, öğrendiklerinizi sonraki kanala taşımanızı sağlar.
- Katalog düzeni: Barkodlar tamamlanır, ürün adları ve görseller standartlaştırılır, kategori ve özellik eşleme tabloları hazırlanır. Eşleşme oranı bu adımda ölçülür.
- Kurallar: Satılabilir stok formülü, kanal tahsisi, güvenlik stoku, fiyat kuralları ve kampanya sınırları yazılır. Kuralları kimin değiştirebileceği de belirlenir.
- Kurulum: Bağlantılar, mesaj kuyruğu, yeniden deneme ve kayıt yapısı kurulur. Sipariş, kargo ve fatura akışları ERP ya da yönetim panelinize bağlanır.
- Pilot: Az sayıda ürünle gerçek satış yapılır. Sipariş, iptal, kısmi iade ve stok bitişi gibi uç senaryolar bilerek denenir.
- İzleme: Eşleşme oranı, hata sayısı, senkron gecikmesi ve geç bildirilen sipariş gibi göstergeler haftalık izlenir; bir sorun müşteriden önce ekibe ulaşır.
Pazaryeri Entegrasyonunda Sık Karşılaşılan Sorunlar Nelerdir?
Sorunların çoğu bağlantının kendisinden değil, pazaryerinin kurallarından ve veri kalitesinden gelir. En sık dört durum şunlardır.
Ürün onaya takılır ya da reddedilir
Pazaryerleri eksik zorunlu özelliği, yanlış kategoriyi ya da görsel kuralını ihlal eden ürünü yayına almaz. Reddedilen ürün hata listesine düşmeli ve nedeni görünür olmalıdır; aksi hâlde ürünün neden satılmadığını haftalarca fark etmezsiniz.
Kategori ve özellik şeması değişir
Pazaryerleri kategori ağacını ve zorunlu özellikleri zaman zaman günceller. Eşleme tabloları bu değişikliklere göre yenilenmezse daha önce sorunsuz giden ürünler bir gün hata vermeye başlar.
İstek sınırı ve API sürümü
Binlerce ürünün stoğunu aynı anda göndermeye çalışmak istek sınırına takılır. Çözüm, yalnızca değişen kayıtları kuyruğa alıp sınırı aşmayacak hızda göndermektir. Pazaryeri eski API sürümünü kapatacağını duyurduğunda geçiş önceden planlanmalıdır.
Kampanya fiyatı ve stok çakışması
Pazaryerinin kampanyasına katılan ürünün fiyatı, sizin fiyat kuralınızla çakışabilir. Kampanya fiyatını taban fiyatın altına düşürmeyecek bir sınır tanımlamak ve kampanya sırasında senkron aralığını kısaltmak bu riski azaltır.
Okumanızı öneririz: e-Fatura Entegrasyonu Nedir, Nasıl Yapılır? Sipariş, ERP ve Muhasebe İçin Rehber
Shopify Mağazası Nasıl Kurulur? Türkiye İçin Adım Adım Shopify Rehberi
Okumanızı öneririz: Ön Muhasebe Programı Nasıl Seçilir? Karşılaştırma, Puanlama ve Maliyet Rehberi
Okumanızı öneririz: Kargo Entegrasyonu Nedir, Nasıl Yapılır? E-ticaret İçin Gönderi, Etiket ve Takip Rehberi
Okumanızı öneririz: E-ticaret Sitesi Nasıl Kurulur? Altyapı, Yasal Gereklilikler, Maliyet ve Başabaş Rehberi
Okumanızı öneririz: API güvenliği nasıl sağlanır? Kimlik, yetki, token ve hız sınırı rehberi
İnovabil ile Pazaryeri Entegrasyonu
İnovabil olarak pazaryeri entegrasyonunu yalnızca sipariş çekme işi olarak görmüyoruz; ürün, stok, fiyat, sipariş, kargo ve fatura akışının tek tasarımı olarak ele alıyoruz. Projeye katalog ve veri haritasıyla başlıyor, satılabilir stok ve fiyat kurallarını birlikte yazıyor, ardından hata kuyruğu, yeniden deneme, kayıt ve izleme ile entegrasyonu kuruyoruz.
Kendi ürünlerimizde Trendyol, Hepsiburada, n11, Amazon, Etsy, AliExpress, Ozon, ÇiçekSepeti ve Shopify gibi kanallarla entegrasyonlar geliştirdik. .NET ve ASP.NET Core, REST ve SOAP servisleri, RabbitMQ ve MassTransit ile mesaj kuyrukları, Prometheus ile izleme bu projelerde kullandığımız teknolojiler arasında. Sürat Kargo için ön ödemeli kargo sistemini (Kredili Kargo) de geliştirdik.
Pazaryeri kanallarınızı tek yerden yönetmek, stok ve fiyatı ERP'nizle buluşturmak ya da mevcut panelinizin sınırına çarpıp özel bir entegrasyona geçmek istiyorsanız, hangi kanallarda sattığınızı ve nerede elle iş yaptığınızı birkaç cümleyle anlatın; size özel bir yol haritası hazırlayalım.
Okumanızı öneririz: E-ticaret yazılımı: pazaryeri, kargo ve ödeme entegrasyonlarıyla birlikte
Sık Sorulan Sorular
Pazaryeri entegrasyonu nedir, kısaca ne işe yarar?
Pazaryeri entegrasyonu, Trendyol, Hepsiburada, n11, Amazon gibi satış kanallarıyla sisteminiz arasında ürün, stok, fiyat ve sipariş verisinin otomatik akmasını sağlar. Ürünü bir kez tanımlar, stok ve fiyatı merkezden yönetir, siparişleri tek ekranda toplarsınız.
Pazaryeri entegrasyonu stoğu anında günceller mi?
Çoğu durumda dakikalar içinde günceller, ancak "anında" garantisi yoktur; pazaryerinin istek sınırı ve sizin senkron aralığınız belirleyicidir. Bu gecikme sırasında fazla satış olmaması için satılabilir stok formülü, kanal tahsisi ve güvenlik stoku birlikte kullanılır.
Her pazaryerinde aynı fiyattan mı satmalıyım?
Zorunlu değil. Komisyon, kargo ve kampanya koşulları kanaldan kanala değiştiği için aynı kârı elde etmek istiyorsanız fiyat da değişir. Kanal fiyatı hedef hakedişin (1 − komisyon oranı) değerine bölünmesiyle bulunur; önemli olan tutarsızlığı kuralla yönetmektir.
Hazır panel mi özel entegrasyon mu seçmeliyim?
Az sayıda kanalda ve standart bir akışla satıyorsanız hazır panel yeterli olabilir. Kanal sayısı fazlaysa, stok ve fiyat kuralları özelse ya da siparişlerin ERP, depo ve muhasebe ile aynı akışta ilerlemesi gerekiyorsa özel entegrasyon daha doğrudur.
Pazaryeri entegrasyonu ne kadar sürede kurulur?
Süre kanal sayısına, katalogun düzenine ve kuralların karmaşıklığına bağlıdır. Barkod ve kategori eşleme tabloları hazırsa tek kanal birkaç haftada pilot aşamasına gelir; her yeni kanal öğrenilenlerle daha hızlı açılır. Analiz sonunda her kanal ayrı bir iş kalemi olarak planlanır.