Pazaryeri Entegrasyonu Nedir, Nasıl Yapılır? Sipariş, Stok ve Fatura Akışı Rehberi

Pazaryeri entegrasyonu, Trendyol, Hepsiburada, N11 gibi pazaryerlerindeki mağazalarınızı API bağlantısıyla tek bir yönetim paneline bağlamaktır. Siparişler pazaryerinden panele kendiliğinden çekilir; stok, fiyat, fatura ve müşteri sorusu cevabı gibi bilgiler ise panelden, bunu destekleyen pazaryerlerine geri gönderilir. Kurulum üç işten oluşur: API bilgilerini girmek, ürünleri barkod ya da stok koduyla eşleştirmek ve hangi otomasyonun çalışacağını seçmek.

Aşağıda hangi verinin hangi yöne aktığını, stok ve sipariş senkronunu, faturanın siparişe bağlanmasını, sık kurulum hatalarını ve entegrasyon seçerken sorulacak soruları sırayla anlatıyoruz. Program karşılaştırıyorsanız özellik ve fiyat bilgisi, yazının sonundaki bağlantılardan ilki olan Pazaryeri Entegrasyon Programı sayfasındadır.

Pazaryeri entegrasyonu nedir, ne değildir?

Her pazaryeri, satıcılarının kendi yazılımlarıyla mağazaya bağlanabilmesi için bir API (uygulama programlama arayüzü) sunar. Entegrasyon yazılımı bu arayüze sizin adınıza bağlanır, belirli aralıklarla yeni siparişleri sorar ve sizin panelde yaptığınız değişiklikleri pazaryerinin beklediği biçime çevirip gönderir. Siz pazaryerinin satıcı paneline girmeden aynı işi tek ekrandan yaparsınız.

Entegrasyonun ne olmadığını bilmek de beklentiyi doğru kurar. Entegrasyon satış artırmaz; ürününüz, fiyatınız ve teslim hızınız ne ise odur. Pazaryerinin kurallarını da değiştirmez: komisyon, kampanya, kargo süresi ve fatura yükleme kuralları pazaryerine aittir, entegrasyon yalnız bu kurallara uygun işi daha az elle yapmanızı sağlar. Her pazaryeri her veriyi API’den açmaz; bir kanalda yazılımdan yapılabilen bir iş, başka bir kanalda yalnız satıcı panelinden yapılabilir.

Pazaryeri entegrasyonu iki komşu kavramla karıştırılır. Tedarikçi XML entegrasyonu, tedarikçinizin yayımladığı ürün listesindeki stok ve fiyatı ilanlarınıza taşır; kaynağı pazaryeri değil tedarikçidir. E-ticaret altyapısı entegrasyonu ise kendi sitenizi (ör. Ideasoft, Ticimax, Shopify, WooCommerce) aynı panele bağlar. Çok kanallı satışta üçü çoğu zaman birlikte kullanılır ve aynı stok kaydında buluşur.

Panel ile pazaryeri arasında hangi bilgiler akar?

Bir pazaryeri bağlantısında yedi tür bilgi taşınır ve yönleri farklıdır: sipariş, soru ve iade talebi pazaryerinden gelir; stok, fiyat ve fatura panelden gider. Aşağıdaki tablo her bilginin ne işe yaradığını ve en sık nerede takıldığını özetler.

Bu yedi bilginin hepsinin her kanalda akması gerekmez; önemli olan hangisinin akıp hangisinin akmadığını baştan bilmektir. Akmayan bir bilgi için o kanalın satıcı paneline girmeye devam edersiniz. Bunu bilmeden kurulan bir entegrasyon, “stok gitti sanıyordum” türünden sessiz hatalar üretir.

Şemanın tamamını görmek için yana kaydırın.

Kanal kanal hangi veri aktarılır?

Genel tablo her entegrasyon için geçerlidir; ama asıl soru “sattığım kanalda hangisi çalışıyor?” sorusudur. Aşağıda TicariHub’ın yurt içi pazaryerleri ve başlıca e-ticaret altyapıları için bugün aktardığı veriler yer alıyor. “Hayır” yazan hücrelerde iş, o kanalın kendi panelinden yapılır.

Farkların çoğu pazaryerinin kendi işleyişinden doğar. Trendyol, Hepsiburada, N11, Pazarama ve PttAVM’de kargo takip numarası pazaryerinin kendisinden gelir; bu yüzden numara panelden kanala yazılmaz. Amazon Türkiye’de fiyat yalnız XML Entegrasyonu (tedarikçi XML) üzerinden gönderilir. Kendi sitelerinizde ise faturanın siteye gidip gitmediği altyapıya ve mağaza ayarınıza göre değişir.

Stok sütunundaki “Evet”, otomatik stok gönderimini açtığınızda geçerlidir; bu ayar kapalı başlar. Müşteri soruları Profesyonel ve üzeri pakette açılır; iade/iptal talebi aktarımı her mağaza için ayrıca açılır. Beymen, Boyner, LC Waikiki gibi “özel anlaşma” kanalları kaydedilebilir ama bu kanallarda sipariş, stok, fiyat ya da fatura aktarılmaz.

Pazaryeri API bilgileri nereden alınır?

Entegrasyonun ilk adımı, pazaryerinin size verdiği kimlik bilgileridir. Bunlar genellikle satıcı panelinin “entegrasyon”, “API” ya da “hesap bilgileri” bölümünde durur ve çoğunlukla üç parçadan oluşur: mağazanızı tanıtan bir satıcı ya da mağaza numarası, bir kullanıcı adı ya da API anahtarı ve bir gizli anahtar ya da şifre.

Örnek olarak Trendyol, satıcı numarasını (Supplier ID), API Key ve API Secret bilgilerini satıcı panelindeki Hesap Bilgilerim bölümünün Entegrasyon Bilgileri sayfasında verir; Trendyol’un geliştirici belgesine göre bu bilgiler yalnız ana kullanıcı (admin rolü) ile giriş yapıldığında görünür. Diğer pazaryerlerinde menü adı ve alan sayısı farklıdır. Panel menüleri zaman zaman değiştiği için güncel yeri satıcı panelinizden ya da pazaryerinin entegrasyon belgesinden kontrol edin.

E-ticaret altyapılarında durum biraz farklıdır: bazı altyapılar web servis için panel şifrenizden ayrı bir kullanıcı ister, bazıları bir uygulama izni (yetki onayı) ekranı açar. Panel şifresiyle bağlanmaya çalışmak, kurulumdaki en yaygın “bağlantı kurulamadı” sebeplerinden biridir.

• API bilgilerini e-posta, mesaj ya da ekran görüntüsüyle dolaştırmayın; Trendyol da belgesinde anahtarın açık platformlarda paylaşılmamasını ister.
• Anahtarı yalnız bağlantı kuracağınız yazılımın ekranına girin; anahtarı gören bir çalışan işten ayrılırsa pazaryeri panelinden yenileyin.
• Aynı pazaryerinde ikinci mağazanız varsa onun bilgileri ayrıdır; her mağaza kendi bağlantısıyla eklenir.
• Anahtarı yeniledikten sonra yazılımdaki eski bilgiyi de güncelleyin; yoksa siparişler sessizce gelmemeye başlar.

Ürün eşleştirme: barkod mu, stok kodu mu?

Entegrasyonun doğruluğu eşleştirmeye bağlıdır. Paneldeki her ürünün her kanaldaki hangi ilana karşılık geldiği kesin bilinmezse stok yanlış ürüne yazılır, fatura yanlış kaleme kesilir, kâr başka ürüne hesaplanır. Bu yüzden eşleştirme, kurulumun hızlı geçilecek adımı değil en dikkatli yapılacak adımıdır.

İki güvenilir anahtar vardır. Barkod (GTIN), ürünün üzerindeki numaradır ve aynı ürün her kanalda aynı barkodu taşır. Stok kodu (satıcı stok kodu, SKU) ise ürüne sizin verdiğiniz iç koddur; her varyanta (beden, renk, hacim) ayrı stok kodu verdiğinizde en temiz anahtar olur. Pazaryerinde ilan açarken bu iki alanı paneldeki ürünle aynı doldurmak, eşleştirmeyi baştan çözer.

Ürün adıyla otomatik eşleştirme ise risklidir. “Zeytinyağı 5 Lt” ile “Zeytinyağı 2 Lt” ad olarak neredeyse aynıdır ama farklı üründür; aynı modelin iki rengi de çoğu zaman tek kelimeyle ayrılır. Bu yüzden ad benzerliği en fazla bir öneri olmalı, son karar sizde kalmalıdır.

Pratik bir kural: eşleştirmeden önce paneldeki ürün listenizi sadeleştirin. Aynı ürünün iki ayrı kartı varsa birini kapatın, varyantları tek tek açın, stok kodunu boş bırakmayın. Stok kodu düzenini sıfırdan kuruyorsanız stok kodu nasıl verilir yazımızdaki adlandırma örnekleri işinizi kolaylaştırır.

Şemanın tamamını görmek için yana kaydırın.

Pazaryeri stok entegrasyonu nasıl çalışır?

Pazaryeri stok entegrasyonunun temeli tek stok kaydıdır: ürünün gerçek adedi bir yerde tutulur ve bütün kanallar bu adetten beslenir. Bir kanalda satış olduğunda adet düşer ve yeni adet stok gönderimi açık olan diğer kanallara yazılır; iade ya da mal girişi olduğunda adet artar ve aynı yoldan kanallara gider. Her kanalın kendi adedini ayrı tuttuğu düzende ise son ürün iki kanalda birden satılabilir; buna fazla satış (oversell) denir.

Stok gönderimi hiçbir sistemde sıfır gecikmeli değildir. Satışın panele gelmesi, yeni adedin hesaplanması, pazaryerine gönderilmesi ve pazaryerinin bunu ilanına işlemesi arasında kısa bir süre geçer. Son birkaç adette bu süre önemlidir; hızlı satan ürünlerde kanallara gerçek adetten bir iki eksik göstermek (güvenlik payı) yaygın bir önlemdir.

Birden fazla deponuz ya da mağazanız varsa hangi yerin stoğunun pazaryerine sayılacağına ayrıca karar verin. Mağaza vitrinindeki ürün internetten satılmayacaksa o yerin adedi kanal stoğuna katılmamalıdır. Aynı şekilde hasarlı ya da iade incelemesindeki ürünler satılabilir stoğa sayılmamalıdır.

Stok gönderimini eşleştirme bitmeden açmayın. Eşleşmemiş ya da yanlış eşleşmiş üründe doğru çalışan bir senkron, yanlış ilanın stoğunu sıfırlayabilir.

Şemanın tamamını görmek için yana kaydırın.

Fiyat güncellemesi entegrasyonla nasıl yönetilir?

Fiyat, stoktan farklı olarak her kanalda aynı olmak zorunda değildir. Komisyonu, kargo baremi ve kampanya yapısı farklı olan iki pazaryerinde aynı ürünü aynı fiyata satmak, birinde kâr ederken diğerinde zarar etmek anlamına gelebilir. Bu yüzden entegrasyonda fiyat çoğu zaman kanal bazında bir kurala bağlanır: temel fiyat, üzerine kanal farkı ve yuvarlama.

Fiyat gönderiminde iki risk vardır. Birincisi yanlış fiyatın yüzlerce ilana birden gitmesidir; bir yazım hatası ya da yanlış maliyet bilgisi, toplu gönderimde büyük zarara dönüşebilir. Bunun önlemi en düşük ve en yüksek fiyat sınırı tanımlamak ve büyük değişiklikleri gönderimden önce gözden geçirmektir. İkincisi pazaryerinin fiyatı reddetmesidir: kampanyaya giren ürünlerde ya da pazaryerinin fiyat kuralına takılan değişikliklerde fiyat ilana işlenmeyebilir; gönderimin sonucunu kontrol etmek bu yüzden gönderim kadar önemlidir.

TicariHub’da Fiyat Merkezi kanallardaki fiyatları çeker, fiyat geçmişini tutar ve ürün bazlı en düşük ve en yüksek fiyat kuralıyla fiyat gönderebilir. Fiyat yalnız fiyat gönderimi olan kanallara gider; XML beslemesinin yönettiği ilanlara kural fiyatı gönderilmez.

Sipariş senkronu ve sipariş durumları nasıl izlenir?

Siparişler pazaryerinden belirli aralıklarla sorgulanarak panele çekilir. İlk kurulumda geçmiş siparişleri de almak istersiniz; burada pazaryerinin kuralı devreye girer: bazı kanallar tek sorguda yalnız belirli bir gün aralığını verir, bazıları belirli bir tarihten eski siparişi hiç vermez. Geçmişi çekerken makul bir aralıkla başlayıp gerekirse genişletmek, eksik ya da yavaş gelen veriyle uğraşmaktan daha az zahmetlidir.

Bir sipariş yaşamı boyunca birkaç durumdan geçer: yeni, hazırlanıyor, kargoya verildi, teslim edildi; bazen iptal ya da iade. Pazaryerleri bu durumları farklı adlandırır ve bazen eski bir durumu sonradan yeniden gönderir. İyi bir entegrasyon durumu yalnız ileri yönde günceller: teslim edilmiş bir sipariş, gecikmeli gelen eski bir “kargoda” kaydı yüzünden geri adım atmaz.

İptal ayrı dikkat ister. Faturası kesilmemiş bir sipariş iptal olduysa stok geri girmeli ve fatura kesilmemelidir. Faturası kesildikten sonra iptal olduysa faturanın iptali ya da iade belgesi gerekir. Bu ayrımı yapan bir düzen kurmadan otomatik faturayı açmak, iptal edilen siparişlere kesilmiş belgelerle sonuçlanabilir.

Siparişten faturaya: fatura zinciri nasıl kurulur?

Pazaryeri siparişinin faturasını pazaryeri değil satıcı keser. Zincir şöyle işler: sipariş panele düşer, alıcı bilgisi (ad ya da unvan, VKN ya da TCKN, fatura adresi) kontrol edilir, alıcının e-Fatura sistemine kayıtlı olup olmadığına bakılarak belge türü seçilir, belge sizin e-Fatura entegratörünüzden kesilir ve kesilen belge pazaryerindeki siparişe yüklenir.

Faturaya esas tutar en çok hata çıkan noktadır. Pazaryerleri indirim, kupon ve kargo bedelini farklı alanlarda bildirir; başlıktaki toplam her zaman kalemlerin toplamı değildir. Entegrasyonun her kanal için hangi alanı esas aldığını bilmek, müşteriye ödediğinden farklı tutarda fatura gitmesini önler.

Süre de önemlidir: Fatura, teslimden itibaren en geç yedi gün içinde düzenlenmelidir (fatura kesme süresi ve geç kesmenin sonuçları). Pazaryerlerinin faturayı siparişe yükleme için ayrıca kendi beklentileri olabilir; satıcı panelinizdeki güncel kuralı kontrol edin. Hangi alıcıya e-Fatura, hangisine e-Arşiv kesileceği ayrı bir konudur ve e-Fatura ile e-Arşiv farkı yazımızda anlatılır.

• Aynı siparişe ikinci fatura kesilmemesi için sipariş başına tek belge kuralı olmalı.
• Bağlantı koptuğunda yapılan yeniden denemeler yeni bir belge açmamalı.
• Maskeli ya da tüm haneleri aynı olan kimlik numarası faturaya gerçek numara gibi yazılmamalı.
• Ödemesi henüz onaylanmamış ya da iptal edilmiş sipariş otomatik faturalanmamalı.

Kargo, takip numarası ve iade akışı nasıl bağlanır?

Kargo tarafında iki model vardır. Pazaryerinin anlaşmalı kargosunu kullandığınızda gönderi kodu ve takip numarası genellikle pazaryeri tarafında oluşur; size düşen, etiketi yazdırıp paketi teslim etmektir. Kendi kargo anlaşmanızı kullandığınızda gönderiyi kargo firmasında siz açarsınız ve takip numarasının siparişe işlenmesi gerekir. Hangi modelin hangi pazaryerinde geçerli olduğunu satıcı panelinizden kontrol edin.

İade, entegrasyonun en çok unutulan parçasıdır. Pazaryerinden gelen iade talebi onaylandığında üç kaydın birlikte düzelmesi gerekir: ürün sağlamsa stoğa geri girer, müşterinin cari bakiyesi düzeltilir, kesilmiş faturaya karşılık iade belgesi düzenlenir. Bunlardan biri atlanırsa stok sayımı ile sistem, kâr raporu ile banka hesabı tutmaz.

Müşteri soruları da zamana bağlıdır. Pazaryerleri soruların hızlı cevaplanmasını bekler; süre kuralını satıcı panelinizden kontrol edin. Soruların API’den gelip gelmediğini kanal kanal öğrenmek, hangi panele ayrıca bakmanız gerektiğini gösterir.

Soru ve iade tarafında kapsam kanala göre değişir: TicariHub’da Trendyol, N11, ÇiçekSepeti ve idefix'in ("Satıcıya Sor" API yetkisi açıksa Hepsiburada'nın da) müşteri soruları; Trendyol, Hepsiburada, ÇiçekSepeti, Pazarama ve idefix'in iade ve iptal talepleri panele düşer. Amazon, Pazarama ve PttAVM’in soruları ile N11, Amazon ve PttAVM’in iade talepleri ise kendi satıcı panellerinden yönetilir.

En sık entegrasyon hataları ve çözümleri

Entegrasyon hatalarının çoğu birkaç tanıdık sebepten çıkar ve çoğu sessizdir: sistem çalışıyor görünür ama bir veri hiç gitmez. Aşağıdaki tablo belirtiden sebebe gitmenizi kolaylaştırır.

Hata mesajını okumak tahmin etmekten hızlıdır. Pazaryerleri reddin gerekçesini çoğu zaman teknik bir kodla döner; bu kodu sade bir açıklamaya çeviren bir yazılım, destek talebi açmadan sorunu çözmenizi sağlar.

Pazaryeri entegrasyonu seçerken nelere bakmalı?

Bir entegrasyon yazılımını tanıtım sayfasındaki kanal logolarına bakarak seçmek yanıltıcıdır; logo, o kanalda her verinin aktığı anlamına gelmez. Karar vermeden önce aşağıdaki soruların cevabını yazılı olarak alın ya da deneme süresinde kendiniz görün.

Bu soruların hepsi deneme süresinde gerçek bir siparişle sınanabilir. İlk haftayı tek kanalla geçirip akışı uçtan uca izlemek, en doğru karşılaştırmayı verir.

• Sattığınız her kanal için sipariş, stok, fiyat, fatura, takip numarası, soru ve iade ayrı ayrı yazılmış mı? Tek kelimelik “destekleniyor” yeterli değildir.
• Listede görünüp veri aktarmayan kanal var mı? Bazı kanallar yalnız kayıt amacıyla listelenir.
• Stok gönderimi açılıp kapatılabiliyor mu, ne kadar gecikmeyle gidiyor, depo seçimi yapılabiliyor mu?
• Ürün eşleştirme barkod ve stok koduyla mı yapılıyor; ad benzerliği otomatik bağ mı kuruyor, yoksa yalnız öneri mi?
• Fatura sizin entegratör hesabınızdan mı kesiliyor; sipariş başına tek fatura ve yeniden denemede çift belge koruması var mı?
• Otomasyonlar (fatura, stok gönderimi, otomatik cevap) siz açmadan çalışmıyor mu?
• Bir hata olduğunda ne olduğunu ve ne yapmanız gerektiğini anlaşılır Türkçeyle söylüyor mu?
• Sipariş, fatura ve cari verilerinizi dışa aktarabiliyor musunuz?
• Ekip için ayrı kullanıcı ve yetki tanımlanabiliyor mu; örneğin depo personeli fiyat değiştirebiliyor mu?
• Ücret kanal, mağaza ya da sipariş sayısına göre mi artıyor; denemede kart isteniyor mu?

TicariHub’da pazaryeri entegrasyonu nasıl kurulur?

TicariHub’da pazaryerleri ve e-ticaret siteleri panelin Entegrasyonlar sayfasından bağlanır; siparişler, stok, faturalar ve kargo aynı panelde, ön muhasebe kayıtlarıyla birlikte tutulur. Adımlar ve bilmeniz gereken sınırlar şöyle:

Sınırlar: otomatik fatura ödemesi gelmemiş, %0 KDV satırlı, zaten faturalı, başka sistemde faturalanmış ya da 30 günden eski siparişe kesmez. Takip numarası Trendyol, Hepsiburada, N11, Pazarama, PttAVM ve Amazon Türkiye’ye TicariHub’dan yazılmaz. T-Soft siparişleri bekletmede gelir ve siparişten fatura kesilmez. Deneme 14 gündür, kart gerekmez; denemede bir modül ve e-Fatura açılır.

1. Kanalı seçip API bilgilerini girin

   Entegrasyonlar sayfasından kanalı seçin ve satıcı panelinizden aldığınız bilgileri girin. Aynı pazaryerindeki her mağaza ayrı bağlantı olarak eklenir.

2. Geçmiş siparişleri çekin

   Otomatik sipariş senkronu varsayılan olarak 10 dakikada bir çalışır; geçmiş siparişleri 1 ile 365 gün arasında elle çekebilirsiniz. Kanalın kendi sınırı ayrıca geçerlidir (ör. PttAVM’de 40 günlük aralık, Shopify’da 60 gün).

3. Ürünleri eşleştirin

   Barkodu ya da stok kodu birebir tutan ürünler toplu olarak otomatik bağlanır. Yalnız adı benzeyen ürünler öneri olarak gelir ve onayınızı bekler; “10 Lt” ile “20 Lt” gibi varyant çakışmaları önerilmez.

4. Stok kurallarını belirleyin

   Sipariş geldiğinde stok düşer (varsayılan açık). Stok Yerleri’nde hangi depo ya da mağazanın pazaryeri stoğuna sayılacağını seçersiniz. Kanallara otomatik stok gönderimi kapalı başlar; açtığınızda değişiklikler yaklaşık 20 saniye toplanıp yalnız etkilenen ürünler gönderilir.

5. Fatura akışını kurun

   Kendi e-Fatura entegratör hesabınızı bağlayın. Faturayı tek tek, toplu (Profesyonel ve üzeri) ya da otomatik kesersiniz; otomatik fatura kapalı başlar, açınca kanal filtresi ve asgari tutar seçilebilir. Faturayı kabul eden kanallarda kesilen fatura siparişe yüklenir.

6. İlk hafta tek kanalla izleyin

   Birkaç siparişi baştan sona takip edin: sipariş geldi mi, stok düştü mü, fatura doğru türde ve tutarda kesildi mi, pazaryerine yüklendi mi? Akış doğruysa ikinci kanalı ekleyin.

Kurulumdan sonra her gün neye bakmalı?

Entegrasyon kurulduktan sonra iş bitmez, biçim değiştirir: veri girmek yerine istisnaları kontrol edersiniz. Günde birkaç dakikalık bir kontrol, sessiz hataların birikmesini önler. Aşağıdaki liste çok kanallı satan bir işletme için iyi bir başlangıçtır.

TicariHub’da geciken kargo, cevapsız soru ve stok uyarıları gibi bildirimler isteğe bağlıdır ve kapalı başlar; hangilerini almak istediğinizi kendiniz açarsınız. Uyarı açık olsun ya da olmasın, haftada bir eşleşmeyen ürünler listesine bakmak iyi bir düzendir.

• Faturası kesilmemiş siparişler: yedi günlük süre dolmadan kesin.
• Bağlantı durumu: hata veren ya da uzun süredir sipariş getirmeyen kanal var mı?
• Eşleşmeyen ürünler: yeni açılan ilanlar panelde bir ürüne bağlandı mı?
• Cevapsız müşteri soruları ve bekleyen iade talepleri.
• Kargoya verilmesi geciken siparişler.