Pazaryeri entegrasyonu nedir, nasıl yapılır, program seçerken nelere bakılır?

Pazaryeri entegrasyonu nedir, ne işe yarar?

Pazaryeri entegrasyonu, Trendyol, Hepsiburada, n11 gibi pazaryerlerindeki mağazanı muhasebe ya da stok programına bağlayan otomatik bir köprüdür. Sipariş, stok, fiyat ve fatura bilgisi pazaryeri paneli ile program arasında sen elle taşımadan akar. Böylece her siparişin faturası tek yerden kesilir, stok da bütün mağazalara tek yerden gider.

Entegrasyon yoksa işler dağınık yürür: sipariş panelde durur, fatura başka bir ekranda kesilir, stok Excel'de tutulur. Küçük bir işletmede köprünün öbür ucunda çoğu zaman bir ön muhasebe programı ya da ayrı bir entegrasyon yazılımı durur.

En çok da aynı ürünü iki mağazada sattığın gün işe yarar. Rafta son bir ürün kaldıysa ve iki mağazada da satışta görünüyorsa ikisinden birden sipariş gelebilir. Stok tek yerden yönetilince bu risk azalır.

E-ticaret entegrasyonu ile pazaryeri entegrasyonu aynı şey mi?

Tam olarak aynı şey değil; biri ötekinin içindedir. E-ticaret entegrasyonu, internetten satış yaptığın bütün kanalları (kendi siten ve pazaryeri mağazaların) programına bağlamaktır. Pazaryeri entegrasyonu ise bunun Trendyol, Hepsiburada gibi aracı platformlara bakan kısmıdır.

Asıl fark paranın ve faturanın yolunda ortaya çıkar:

İkisinde birden satıyorsan siparişlerin aynı listeye düşmesi ve stoğun tek yerden gitmesi gerekir; yoksa her kanal için ayrı bir düzen kurarsın.

Pazaryeri entegrasyonu nasıl çalışır, nasıl yapılır?

Pazaryeri entegrasyonu, satıcı panelinden aldığın API bilgilerini programa yazarak yapılır; bundan sonra iki yazılım kendi aralarında haberleşir. API, pazaryerinin dış yazılımlara açtığı bir servis kapısıdır; API anahtarı da bu kapıyı senin mağazan adına açar. Kurulumu bir kez yaparsın, sonrası her siparişte aynı sırayla işler:

1. API bilgilerini al. Pazaryerinin satıcı panelinden mağazana özel anahtarları kopyalarsın.
2. Mağazanı bağla. Bilgileri programa yazarsın, program bağlantıyı dener.
3. Siparişler gelir. Program pazaryerine belli aralıklarla sorar; yeni siparişin ürünleri, tutarı, alıcısı ve teslimat adresi programa düşer.
4. Ürünler eşleşir. Pazaryeri ürünü koduyla tanır: Trendyol barkodu, Hepsiburada satıcı stok kodunu kullanır. Tutmayan kodu bir kez elle eşleştirirsin.
5. Fatura hazırlanır. Alıcı cari olarak açılır, fatura alıcıya göre e-Arşiv ya da e-Fatura olarak hazırlanır. Kontrol edip onaylarsın.
6. Fatura siparişe gider. Faturanın bağlantısı pazaryerine bildirilir, müşteri faturasını kendi siparişinde görür.
7. Stok düşer. Satılan ürün stoktan çıkar, güncel miktar bir sonraki gönderimde öteki mağazalara gider.
8. Ödeme eşleşir. Hakediş servisi olan mağazada yatan para, komisyon ve kesintileriyle sen onaylayınca faturalara bağlanır.

Diyelim ki 27.09.2026 sabahı Trendyol'dan 2 adet kulaklık için KDV dahil 1.200,00 TL'lik sipariş geldi. Program siparişi alır, faturayı 1.000,00 TL + 200,00 TL KDV olarak hazırlar. Sen onaylayıp faturayı GİB'e gönderince bağlantısı siparişe işlenir. Rafta 12 adet varsa bir sonraki stok gönderiminde n11'e ve kendi sitene 10 adet gider.

API bilgilerini nereden alırsın?

Panellerdeki yol 31.10.2026 itibarıyla şöyle; menü adları zamanla değişebilir:

Mağazaya özel kurulum adımlarını Trendyol entegrasyonu ve Hepsiburada entegrasyonu sayfalarında tek tek yazdık.

Kurarken en sık nerede hata yapılır?

• Test ve canlı bilgileri karıştırmak: Trendyol ve Çiçeksepeti'nde test ortamının bilgileri canlı mağazanınkinden ayrıdır. Gerçek mağazayı canlı bilgilerle bağla.
• Yetkiyi beklememek: Hepsiburada'da yetkinin devreye girmesi 2 saati bulabilir. İlk denemede "geçersiz" uyarısı alırsan biraz sonra yeniden dene.
• Aynı mağazayı iki programa bağlamak: Eski program açık kalırsa aynı sipariş iki kez faturalanabilir, iki program stok miktarını birbirinin üstüne yazabilir. Geçişte faturayı hangisinin keseceğine baştan karar ver.
• Geçmiş siparişleri atlamak: İlk bağlantıda son günlerin siparişleri de gelebilir. Faturasını önceden kestiğin siparişin taslağını sil, ikinci kez fatura kesme.

Entegrasyon olmadan elle çalışmanın bedeli nedir?

Günde 30 siparişi elle işlemek, sipariş başına 3 dakikayla bile günde 90 dakika, ayda yaklaşık 39 saat eder. Aşağıdaki süreler ölçüm değil, örnek; kendi sürelerinle hesabı yeniden yap:

Ayda 26 gün çalışıyorsan 26 × 90 = 2.340 dakika, yani 39 saat yapar. Entegrasyon varken sana taslakları gözden geçirip onaylamak kalır. Sipariş başına 20 saniye ayırsan günde 10 dakika, ayda 4 saat 20 dakika tutar. Aradaki fark ayda yaklaşık 35 saat.

Asıl pahalı olan çoğu zaman süre değil, hatadır:

• Olmayan ürünü satmak: Hepsiburada'nın sipariş belgesine göre satıcı siparişi iptal ederse sözleşmedeki ceza tutarı mağazaya fatura edilir; sipariş başka satıcıya geçerse fiyat farkı da eklenir.
• Faturayı geciktirmek: Fatura için süren, malın tesliminden sonra en çok 7 gündür. Yoğun günlerde biriken faturalar bu süreyi zorlar.
• Yanlış yazmak: Elle yazılan tutar ya da KDV oranı karışırsa faturayı düzeltmekle uğraşırsın.
• Gider kaçırmak: Komisyon ve kargo faturalarını işlemeyi unutursan indirilecek KDV'yi de kaçırırsın.

Kaç siparişte entegrasyon gerektiğine dair resmî bir sınır yok. Tek mağazada günde birkaç siparişle elle de idare edersin. İkinci mağazayı açtığında ya da fatura kesmek paketlemenin önüne geçtiğinde sıra entegrasyona gelmiştir.

Hangi veriler eşitlenir, hangileri eşitlenmez?

Sipariş, stok ve fatura neredeyse her entegrasyonun temelidir; fiyat, ürün, kargo, iade ve hakedişte ise sınırlar pazaryerine ve programa göre değişir. Tablo genel durumu ve sık karşılaşılan sınırları gösteriyor:

Programın bir satırda "yapmıyoruz" demesi kötü değildir; kötü olan, bunu ancak satın aldıktan sonra öğrenmendir. Bu yüzden her satırı kendi mağazaların için ayrı ayrı sor.

Entegrasyon programı seçerken nelere bakılır?

Program seçerken bağlanan mağazalara, tek stoğa, e-Arşiv akışına, hakedişe, iade işleyişine, sınırlara ve ücretlendirmeye bak. Soruları genel değil, kendi mağazaların üzerinden sor; "pazaryerleri destekleniyor" cümlesi tek başına bir şey söylemez.

• Desteklenen kanallar: Sattığın her mağaza bugün bağlanıyor mu? Listede "yakında" ya da "onay bekliyor" yazıyorsa o bağlantıyı yok say. Yarın açacağın mağazayı da sor.
• Tek stok: Stok tek yerden mi gidiyor, onay bekleyen siparişler düşülüyor mu? Rafta 20 adet varken 4 adetlik sipariş onay bekliyorsa öteki mağazaya 16 adet gitmeli.
• e-Arşiv ve e-Fatura: Fatura aynı programda mı kesiliyor? Tür alıcıya göre seçiliyor mu, internet satışı bilgileri siparişten doluyor mu?
• Komisyon ve hakediş: Pazaryerinin ödemesi siparişlerle eşleşiyor mu? Komisyon gider, stopaj peşin vergi olarak ayrılıyor mu? Tutar tutmazsa program farkı gösteriyor mu?
• İade ve iptal: Faturası kesilmiş sipariş iptal olursa uyarı çıkıyor mu? İade stoğa ve satış raporuna nasıl yansıyor?
• Sınırlar: Sipariş, ürün, mağaza ya da kullanıcı sayısında sınır var mı? Siparişler kaç dakikada bir geliyor, bağlantı koparsa haber veriyor mu? Pazaryerinin de sınırı olur: Hepsiburada'nın SSS'si sırada bekleyen stok ve fiyat güncellemesini aynı anda 5 işlemle sınırlıyor.
• Ücretlendirme: Bedel aylık mı, mağaza başına mı, sipariş başına mı? e-Belge kontörü, kurulum ve destek bu bedele dahil mi?
• Deneme ve çıkış: Gerçek akışı satın almadan görebiliyor musun? Mali müşavirin kayıtlara erişebiliyor mu, ayrılırsan verini dışarı alabiliyor musun?

En iyi entegrasyon firması hangisi?

Herkes için tek bir doğru firma yok; yanıt mağazalarına, sipariş sayına ve muhasebeni nerede tuttuğuna bağlı. Çok sayıda kanala binlerce ürün dağıtıyorsan ürün ve katalog tarafı güçlü bir araç ararsın. Az ürünle her siparişi doğru faturalamak ve kârını görmek istiyorsan muhasebeyle aynı yerde duran bir çözüm işini sadeleştirir, çünkü aynı satış iki ayrı programa girilmez. Reklam cümlelerine değil, yukarıdaki sorulara verilen somut yanıtlara göre karar ver.

Ücretsiz entegrasyon programı var mı?

"Ücretsiz" yazan programlar var, ama bedel çoğu zaman süreye, sınıra ya da ek hizmetlere taşınmıştır. Pazaryerlerinin servisleri değiştikçe bağlantının da bakım görmesi gerekir ve bu işin bir karşılığı vardır. Teklife bakarken şunları ara:

• Deneme süresi: Ücretsiz olan program değil, ilk günlerdir.
• Sipariş ya da mağaza sınırı: Belli bir sayıdan sonra ücretli pakete geçmen gerekir; bu da tam işin büyüdüğü ana denk gelir.
• Fatura bedeli: Bağlantı ücretsizdir, ama faturayı kesmek için kontöre ya da ayrı bir programa para ödersin.
• Eksik işlev: Sipariş gelir ama stok, iade ya da hakediş yine elle yürür.
• Destek: Bağlantı koptuğunda muhatap bulamayabilirsin.

Kendi yazılımını yazdırıp pazaryerinin API'sine bağlanmak da bir yol: paket ücreti ödemezsin, ama yazılımın hem yazımı hem bakımı sana kalır.

Gerçekten ücretsiz olan yol elle çalışmaktır: siparişi satıcı panelinde görür, faturayı GİB e-Arşiv Portal'dan tek tek kesersin. Portal ücretsizdir ama mağazana bağlanmaz, faturaları ekranda kendin yazarsın; yukarıdaki örnekte bu yolun bedeli ayda 39 saattir. O yüzden karşılaştırmayı "ücretsiz mi, ücretli mi" diye değil, "ayda kaç saat, kaç hata" diye yap.

Entegrasyon e-Arşiv, e-Fatura ve stopaj işini de çözer mi?

Kısmen: entegrasyon faturayı doğru hazırlamana yardım eder, ama vergi sorumluluğu sende ve mali müşavirinde kalır. Pazaryeri yalnız aracıdır; faturayı alıcıya satıcı olarak sen düzenlersin. Şu kuralları aklında tut:

• e-Arşiv mi, e-Fatura mı? Sen ve alıcı firma e-Fatura kullanıcısıysanız e-Fatura, alıcı vatandaşsa ya da e-Fatura kullanmıyorsa e-Arşiv kesilir. e-Arşiv faturada "Bu satış internet üzerinden yapılmıştır." ifadesi, satışın yapıldığı web adresi, ödeme şekli ve tarihi, taşıyan kargo firması ve gönderim tarihi de yer alır.
• Geçiş sınırı: Kendi sitende ya da pazaryerinde satıyorsan ve yıllık brüt satış hasılatın 500 bin TL'ye ulaştıysa izleyen yılın 1 Temmuz'una kadar e-Fatura ve e-Arşiv'e geçmen gerekir.
• %1 e-ticaret stopajı: 01.01.2025'ten beri pazaryeri, sana ödeme yaparken KDV hariç satış tutarı üzerinden stopaj keser. Oran 31.10.2026 itibarıyla %1'dir; 9284 sayılı Cumhurbaşkanı Kararı'na dayanır ve yeni bir kararla değişebilir. %20 KDV'li 1.200,00 TL'lik satışta matrah 1.000,00 TL, kesinti 10,00 TL olur; komisyon ve kargo bu hesabı değiştirmez. Kesinti gider değildir, beyannamede hesaplanan vergiden düşülür. Basit usulde vergilendirilen satıcıdan ve vergiden muaf esnaftan kesilmez.

Hesabın ayrıntısını e-ticaret stopajı yazımızda, faturadan hakedişe bütün kayıt düzenini e-ticaret muhasebesi yazımızda anlattık.

Entegrasyona nereden başlamalısın?

Önce üç şeyi not al: hangi mağazalarda sattığın, günde kaç sipariş aldığın ve faturayı şu an nerede kestiğin. Sonra iki üç programı yukarıdaki listeden geçir ve tek bir sipariş için bütün yolu dene: sipariş geldi mi, fatura doğru mu, iptal edince ne oldu? Stok gönderimini en sona bırak; önce ürün kodlarını eşleştir, açılış stoğunu gir.

Uygun Muhasebe bu seçeneklerden biri; mağaza bağlantısını fatura, stok, cari ve kasayla aynı yerde tutar. Siparişler 15 dakikada bir gelir, her birine fatura taslağı açılır, onay sendedir. Bütün mağazalarda sipariş gelir. Stok gönderimini mağaza ayarından sen açarsın; miktar her siparişte değil, günde bir kez ya da istediğin an gider. Değişen kısımlar 31.10.2026 itibarıyla şöyle:

Amazon'da yalnız kendi gönderdiğin ürünlerin stoğu gider. Kendi sitende e-Arşiv fatura, siparişte e-posta varsa müşteriye e-postayla iletilir. Hakediş mutabakatı olmayan mağazada ödemeyi elle kaydedersin. Hepsiburada'da önce API yetkisi istersin, ilk kurulumu seninle birlikte yapıyoruz.

Bağlantıların güncel durumunu entegrasyonlar sayfasında, siparişten hakedişe bütün akışı e-ticaret ve pazaryeri entegrasyonu sayfamızda görebilirsin. Günlük düzeni nasıl kuracağını e-ticaret satıcıları için ön muhasebe sayfamızda anlattık. Uygun Muhasebe'yi kart bilgisi vermeden 14 gün deneyebilirsin; deneme bitince ücretlidir. Gerçek mağazanı bağlamadan önce, örnek siparişler üreten deneme mağazasıyla akışı görebilirsin.

Bu yazı genel bilgi içindir; vergi ve hukuk kararlarında mali müşavirine danış. Mevzuat değiştikçe yazıyı güncelliyoruz; güncelleme tarihi başlığın altında.