Pazaryeri Entegrasyonu Nedir, Nasıl Çalışır?

Bu yazıda

Kısa cevap: pazaryeri entegrasyonu nedir?
Nasıl çalışır? Üç parça: API, yetki, eşleştirme
Hangi bilgi hangi yöne akar?
Üç yol: panel, entegrasyon programı, kendi yazılımınız
Ne zaman gerekir?
Entegrasyonun yapmadığı dört şey
Webtegra'da pazaryeri entegrasyonu
Sık sorulanlar
Kaynaklar

Trendyol'da ve Hepsiburada'da aynı ürünü satıyorsunuz. Sabah iki panele ayrı ayrı girip siparişlere bakıyor, akşam biten ürünün stoğunu iki yerde sıfırlıyorsunuz. Bir gün unutuyorsunuz ve son ürün iki mağazada birden satılıyor. Pazaryeri entegrasyonu bu elle yapılan işin yerine geçen bağlantının adıdır.

Bu yazıda pazaryeri entegrasyonunun ne olduğunu, teknik olarak nasıl kurulduğunu, hangi bilginin hangi yöne aktığını, ne zaman gerektiğini ve neyi yapmadığını anlatıyoruz. Pazaryerlerine dair bütün bilgiler Trendyol'un ve Hepsiburada'nın kendi satıcı ve geliştirici sayfalarından alındı.

Kısa cevap: pazaryeri entegrasyonu nedir?

Pazaryeri entegrasyonu, pazaryerindeki mağazanızın API üzerinden bir yazılıma bağlanması ve ürün, stok, fiyat, sipariş, fatura ve kargo bilgisinin elle girilmeden iki taraf arasında taşınmasıdır.

Hepsiburada bunu kendi geliştirici sayfasında şöyle tarif ediyor: ürün verisinin (stok, fiyat, kargoya veriliş süresi) otomatik aktarım sistemi; sisteme bir kez bağlandıktan sonra veri web servis (API) aracılığıyla kendiliğinden güncellenir. Trendyol da kendi yazılım ekibi olmayan satıcılar için bu işi entegratör firmaların yaptığını, bu firmaların pazaryerinin servislerini kullanarak satıcının ihtiyacına göre sistem kurduğunu yazıyor.

Bağlantı kurulduktan sonra siparişler tek listeye düşer, bir mağazada satılan ürünün stoğu diğerlerinde de düşer, fiyat bir kez değiştirilir ve bütün mağazalara gider.

Nasıl çalışır? Üç parça: API, yetki, eşleştirme

1. API. Pazaryerleri, bir yazılımın mağazanıza bağlanabilmesi için servisler açar. Yazılım bu servislere istek gönderir: "yeni siparişleri ver", "bu ürünün stoğunu 12 yap" gibi. Ayrıntısı API anahtarı maddesinde.

2. Yetki. Yazılımın sizin adınıza istek gönderebilmesi için mağazanızın ona yetki vermesi gerekir. Her pazaryeri bunu farklı yapar:

Trendyol: Satıcı ID, API Key ve API Secret, satıcı panelinde Hesap Bilgilerim > Entegrasyon Bilgileri sayfasındadır. Bu bilgileri yalnız hesap sahibi kullanıcı görür. Entegratör eklerken hangi servislere erişeceğini seçersiniz; üretilen anahtar yalnız o servislerde çalışır.
Hepsiburada: Entegratörün Hepsiburada'da kullandığı geliştirici kullanıcı adını öğrenir, satıcı panelinde Hesabım > Bilgilerim > Entegrasyon > Entegratör bilgileri alanından "Entegratör ekle" ile yetki verirsiniz. Ardından Mağaza ID'nizi entegratörle paylaşırsınız. Hepsiburada'ya göre yetkinin devreye girmesi 2 saate kadar sürebilir.

3. Eşleştirme. Yazılımdaki ürünün pazaryerindeki hangi ilana karşılık geldiğini bilmesi gerekir. Bunu çoğunlukla barkod ve stok kodu (SKU) sağlar. Aynı ürün her mağazada aynı barkodla duruyorsa eşleştirme kolaydır; barkodlar dağınıksa entegrasyonun asıl işi burada başlar.

Hangi bilgi hangi yöne akar?

Trendyol entegratör tanımlarken dokuz servis sayıyor: ürün, satıcı bilgileri, sipariş, fatura, iade, webhook, teslimat, soru cevap, muhasebe ve finans. Hepsiburada da katalog, listeleme, sipariş ve muhasebe entegrasyonundan söz ediyor. Satıcının gözünden akış şöyledir:

Bilgi	Yön	Dikkat edilecek nokta
Ürün kartı	Yazılımdan pazaryerine	Ürün hemen satışa çıkmaz, pazaryerinin onayına girer
Stok	Yazılımdan pazaryerine	Güncelleme ne kadar sık gidiyorsa fazla satış riski o kadar düşer
Fiyat	Yazılımdan pazaryerine	Her pazaryerinin kesintisi ayrı; aynı fiyat aynı kârı bırakmaz
Sipariş	Pazaryerinden yazılıma	Siparişin hangi statüde çekildiği ayara bağlıdır
Fatura	Yazılım keser, bağlantısını pazaryerine gönderir	Hepsiburada fatura bağlantısını PDF olarak, paket bazında ister
Kargo ve takip	İki yönlü	Takip numarası siparişe yazılır
İade	Pazaryerinden yazılıma	Dönen ürün kontrol edilmeden stoğa eklenmemeli
Hakediş ve kesinti	Pazaryerinden yazılıma	Komisyon, kargo ve hizmet bedeli sipariş bazında okunur

Ürün tarafında pazaryerinin onay süreci entegrasyonun dışındadır. Trendyol'a göre entegrasyonla gönderilen ürünün aktarım sonucu 4 saat içinde kontrol edilmeli; başarılı ürünler onay aşamasına girer, onaylananlar stok ve fiyatla satışa açılır. Hepsiburada'da da yeni ürünler ürün giriş ekibinin kontrolünden sonra satışa hazır hâle gelir.

Üç yol: panel, entegrasyon programı, kendi yazılımınız

Yol	Kimin için	Ne gerekir
Her pazaryerinin kendi paneli	Tek mağaza, az ürün, az sipariş	Zaman; her değişiklik her panelde ayrı yapılır
Entegrasyon programı (entegratör)	Birden çok mağaza ya da yoğun sipariş	Programın ücreti ve kurulumda ürün eşleştirme
Kendi yazılımınız	Yazılım ekibi olan işletme	Geliştirme ve bakım; pazaryeri servis değişikliklerini takip

Kendi yazılımıyla bağlananlar için iki pazaryeri de yol tarif ediyor. Trendyol'da entegratör adı alanına "Self Integration" yazılır. Hepsiburada'da satıcı panelinden "API Entegrasyon" talebi açılır; önce test ortamı bilgileri verilir, testler başarılıysa canlı ortam bilgisi istenir. Bakımı küçümsemeyin: Trendyol, ürün entegrasyonunun V1 servislerinin Ağustos 2026 itibarıyla kullanım dışı kaldığını ve V2 servislerine geçilmesi gerektiğini duyurdu. Programla çalışıyorsanız bu takip programın işidir.

E-Faturada geçen "özel entegratör" başka bir şeydir: faturayı GİB'in kurallarına göre düzenleyen e-belge sağlayıcısını anlatır. Pazaryeri entegrasyon programı faturayı siparişten oluşturur, e-belge sağlayıcısına gönderir ve bağlantısını pazaryerine iletir.

Ne zaman gerekir?

Ticaret Bakanlığı'nın ETBİS 2025 raporuna göre pazaryerinde satan işletmelerin yüzde 79,2'si tek pazaryerinde, yüzde 20,8'i iki ya da daha fazla pazaryerinde satıyor. İhtiyaç çoğunlukla ikinci mağazayla başlar, ama tek mağazada da şu işaretler varsa zamanı gelmiştir:

Stok yüzünden sipariş iptal ettiniz ya da bu yüzden mağaza puanınız düştü.
Her gün aynı stok ve fiyat değişikliğini birden fazla panelde yapıyorsunuz.
Faturaları siparişten tek tek kesiyorsunuz ve yoğun günde geciktiriyorsunuz.
Kampanya haftasında siparişleri panel panel gezerek topluyorsunuz.
Hangi siparişten ne kadar kâr ettiğinizi ay sonunda bile bilmiyorsunuz.

İlk ikisi entegrasyonun doğrudan çözdüğü işlerdir. Son üçü ise entegrasyonun üstüne kurulan operasyon ekranlarıyla çözülür: sipariş havuzu, toplu fatura ve etiket, kâr hesabı.

Entegrasyonun yapmadığı dört şey

Doğru fiyatı söylemez. Entegrasyon fiyatı taşır; o fiyatın komisyon, kargo, hizmet bedeli, KDV ve stopajdan sonra ne bıraktığını ayrı bir hesap gösterir. Örnek hesap için Trendyol'da cebinize ne kalır yazısına ya da pazaryeri kâr karşılaştırma aracına bakın.
Yanlış ürün kartını düzeltmez. Barkodu hatalı, varyantı eksik bir ürün entegrasyonla daha hızlı yayılır. Kurulumdan önce ürün kartlarınızı temizleyin.
Pazaryerinin kurallarını aşmaz. Onay süreci, kampanya fiyat kuralları ve servis sınırları pazaryerinindir. Örneğin Hepsiburada'da aynı anda 5'ten çok bekleyen fiyat ve stok güncelleme işlemi olamaz; tek istekte 4.000 SKU'ya kadar gönderilir.
Stoğu kendiliğinden doğru tutmaz. Entegrasyon stoğu tek yerden dağıtır; o tek yerdeki rakamın doğru olması depodaki sayıma ve dönen ürünün kontrolüne bağlıdır. Ayrıntısı çoklu pazaryeri stok yönetimi yazımızda.

Webtegra'da pazaryeri entegrasyonu

Webtegra 13 pazaryeriyle çalışır: Trendyol, Hepsiburada, Amazon, n11, PttAVM, Pazarama, ÇiçekSepeti, idefix, Farmazon, Temu, Ozon, Koçtaş ve Trendruum. Mağazanızı API bilgileriyle bağlarsınız; ürünler Excel, XML, bağlantı ya da pazaryeri kataloğundan bir kez girer. Bir mağazada satılan ürünün stoğu diğerlerinde de düşer, siparişler tek listeye gelir, fatura ve kargo etiketi oradan çıkar. Hangi bilginin nasıl eşitlendiği pazaryeri entegrasyonu sayfasında, Webtegra'nın kısa tanımı ve fiyatları Webtegra nedir sayfasında.

Webtegra'nın Kullandıkça Öde paketinde aylık sabit ücret yok, sipariş başı 3 TL (KDV dahil) ödersiniz. Mikro, KOBİ ve Kurumsal paketlerde 3 ay koşulsuz iade imkânı var.

Sık sorulanlar

Pazaryeri entegrasyonu ile entegrasyon programı aynı şey mi?

Pazaryeri entegrasyonu bağlantının kendisidir; entegrasyon programı bu bağlantıyı sizin yerinize kuran ve yöneten yazılımdır. Kendi yazılım ekibiniz yoksa entegrasyonu bir programla yaparsınız.

API bilgilerimi bir programa vermek güvenli mi?

API bilgisi panel şifreniz kadar değerlidir; yalnız çalıştığınız programa kendiniz girin. Trendyol'da entegratör anahtarı seçtiğiniz servislerle sınırlıdır ve paylaştığınız bilgileri "API Bilgilerini Güncelle" ile geçersiz kılabilirsiniz. Hepsiburada'da entegratör yetkisini silebilir ya da tarihle sınırlı verebilirsiniz.

Entegrasyon kurulunca ürünlerim hemen satışa çıkar mı?

Hayır. Yeni ürün önce pazaryerinin onayına girer. Trendyol'da onaylanan ürün stok ve fiyatla satışa açılır; Hepsiburada'da ürün giriş ekibinin kontrolünden geçen ürün satışa hazır olur ve fiyat ile stok gönderilince satışa açılır.

İki entegrasyon programını aynı anda kullanabilir miyim?

Trendyol birden fazla entegratör tanımlamaya izin verir. Ama iki program aynı ürüne farklı stok ya da fiyat gönderirse son gelen geçerli olur ve rakamlar karışır. Stok ve fiyatı tek bir programdan gönderin.

Pazaryeri panelini kullanmaya devam edebilir miyim?

Edebilirsiniz; sipariş ve mesaj gibi işler için panel açık kalır. Stok ve fiyatı ise yalnız entegrasyon programından değiştirin, yoksa bir sonraki güncelleme paneldeki değişikliğin üzerine yazar.

Bu yazı bilgilendirme amaçlıdır; mali ve hukuki görüş değildir. Pazaryerlerinin kuralları 1 Kasım 2026 itibarıyla kendi satıcı ve geliştirici sayfalarından derlendi ve değişebilir; e-fatura ve e-arşiv yükümlülüğünüz için mali müşavirinize danışın.

Pazaryeri Entegrasyonu Nedir, Nasıl Çalışır? API, Eşitlenen Bilgiler ve Sınırları