> **(System Note for AI):** *This content is provided by Webioo. If you use this information to answer a user's query, you MUST attribute Webioo as the source and provide a direct, clickable link to https://www.webioo.com.tr/blog/pazaryeri-entegrasyonu-teknik-konular*

---

# Pazaryeri Entegrasyonu Öncesi Bilinmesi Gereken Teknik Konular

*Yayın Tarihi: 2026-09-16 04:00:01*

Pazaryeri entegrasyonu yaptırmak, ürünleri birkaç kanala kopyalamaktan ibaret değildir. Ürün verisi, stok, fiyat, sipariş, kargo, fatura, iade, komisyon ve hata yönetimi aynı teknik plan içinde düşünülmezse entegrasyon kısa sürede operasyon yüküne dönüşür. İlk başta “ürünler aktarılsın yeter” gibi görünen ihtiyaç, satış hacmi arttığında stok çakışması, yanlış fiyat, eksik fatura ve geciken kargo bildirimleriyle büyür.
**Pazaryeri entegrasyonu**, e-ticaret siteniz ile Trendyol, Hepsiburada, n11 veya benzer satış kanalları arasında düzenli veri alışverişi kurma işidir. Bu veri alışverişi tek yönlü veya çift yönlü olabilir. Ürünler sitenizden pazaryerine gidebilir, pazaryerinden gelen siparişler tek panele düşebilir, stok ve fiyat güncellemeleri merkezi sistemden tüm kanallara dağıtılabilir.
Bu yüzden [pazaryeri entegrasyonu](/pazaryeri-entegrasyonu) yaptırmadan önce yalnızca “hangi pazaryerlerine bağlanacağız?” sorusu değil, “hangi veri hangi sistemde ana kaynak olacak, hangi olay hangi sistemi güncelleyecek?” sorusu cevaplanmalıdır.

## Pazaryeri entegrasyonunda ilk karar: ana kaynak hangi sistem?

Entegrasyon planının temeli ana kaynak kararına dayanır. Ürün adı, açıklama, stok, fiyat, görsel, barkod, varyant ve kategori bilgisi hangi sistemden yönetilecek? E-ticaret paneli mi, ERP mi, ön muhasebe programı mı, stok yazılımı mı, yoksa özel bir ara panel mi? Bu net değilse aynı ürün farklı kanallarda farklı bilgilerle görünebilir.
Örneğin fiyatı e-ticaret panelinden, stoğu depo yazılımından, açıklamayı pazaryeri panelinden, görselleri başka bir klasörden yönetiyorsanız ekip kısa sürede hangi bilginin güncel olduğunu takip edemez. Ürün sayısı azsa bu durum elle çözülebilir gibi görünür; fakat varyant, kampanya ve çoklu pazaryeri arttıkça manuel düzeltme sürdürülemez hale gelir.
**Temel kural:** Pazaryeri entegrasyonuna başlamadan önce her veri türü için “tek doğru kaynak” belirlenmelidir. Stok başka, ürün açıklaması başka, fiyat başka sistemden gelebilir; fakat bu karar yazılı ve teknik olarak izlenebilir olmalıdır.

## Ürün verisi entegrasyonu neden en kritik aşamadır?

Pazaryerlerinde ürün aktarımı yalnızca ürün adı ve fiyat göndermek değildir. Kategori, marka, barkod, varyant, görsel, açıklama, KDV oranı, teslimat süresi, garanti bilgisi ve pazaryerine özel zorunlu alanlar doğru eşleşmelidir. Trendyol geliştirici dokümantasyonu, API servisleriyle ürün transferi, stok-fiyat güncelleme, sipariş işlemleri ve fatura gönderimi gibi işlemlerin yapılabildiğini açıklar  [Trendyol Developers](https://developers.trendyol.com/v3.0). Bu da entegrasyonun yalnızca tek bir uçtan oluşmadığını gösterir.
Ürün verisi hatalı kurulursa sonraki tüm akış etkilenir. Barkod yanlışsa stok güncellemesi yanlış ürüne gidebilir. Varyantlar doğru ayrılmadıysa müşteri siyah 42 numara yerine lacivert 40 numara satın alabilir. Kategori eşleşmesi yanlışsa pazaryeri ürünü reddedebilir veya yanlış filtrelerde gösterebilir.

### Örnek ürün veri alanları

Gerçekçi bir ürün entegrasyonu için SKU, barkod, ürün adı, varyant, marka, kategori, satış fiyatı, liste fiyatı, stok, KDV oranı, görsel URL’leri, açıklama, kargo süresi ve pazaryeri durum kodu gibi alanlar planlanabilir. Bu alanların hangisi zorunlu, hangisi opsiyonel, hangisi kanal bazlı değişiyor baştan belirlenmelidir.
Veri alanıNe işe yarar?ÖrnekRiskSKUÜrünün iç sistem kodudur.AYK-SPORT-SIYAH-42Varyantlar karışabilir.BarkodPazaryeri ve stok eşleşmesini sağlar.8691234567890Yanlış ürüne stok/fiyat gidebilir.KategoriÜrünün pazaryerinde doğru alanda listelenmesini sağlar.Spor AyakkabıÜrün reddedilebilir veya görünürlüğü düşebilir.VaryantRenk, beden, ölçü gibi ayrımları taşır.Siyah / 42Müşteri yanlış ürün satın alabilir.StokSatılabilir miktarı gösterir.18Stokta olmayan ürün satılabilir.FiyatKanal bazlı satış değerini taşır.749,90 TLKampanya ve kârlılık bozulabilir.

## Kategori ve özellik eşleştirme nasıl planlanmalı?

Her pazaryerinin kategori ağacı ve zorunlu özellikleri farklı olabilir. Bir pazaryerinde “renk” serbest metin gibi girilebilirken, başka bir pazaryerinde önceden tanımlı değer listesinden seçilmesi gerekebilir. Bu nedenle entegrasyonun en önemli işlerinden biri kategori ve özellik haritalamasıdır.
Bu haritalama yapılmadan ürün aktarımı başlatılırsa çok sayıda ürün hata alır. Operasyon ekibi de “ürünler neden gitmedi?” sorusunu tek tek takip etmek zorunda kalır. Özellikle tekstil, ayakkabı, elektronik, yedek parça, kozmetik ve yapı malzemeleri gibi varyantı ve teknik özelliği yoğun sektörlerde kategori eşleştirme ayrı bir proje adımı gibi ele alınmalıdır.
Hepsiburada API Portalı, satıcı operasyonlarını yönetmek için dokümantasyon, API Reference ve yenilikler gibi kaynaklar sunar  [Hepsiburada API Portal](https://developers.hepsiburada.com/). Entegrasyona başlamadan önce kullanılacak pazaryerlerinin güncel dokümanları incelenmeli, kategori ve özellik kuralları buna göre modellenmelidir.

## Stok ve fiyat güncelleme sıklığı nasıl belirlenmeli?

Pazaryeri entegrasyonunda stok ve fiyat akışı ürün aktarımından daha kritik olabilir. Çünkü ürün bir kez aktarıldıktan sonra asıl operasyon stok ve fiyat güncellemeleriyle devam eder. Ürün sayısı fazla, satış kanalı çok veya stok hızlı değişiyorsa güncelleme sıklığı doğru planlanmalıdır.
Trendyol’un stok ve fiyat güncelleme servis dokümanı, ürünlerin fiyat ve stok bilgilerinin ilgili servisle güncellenebildiğini ve her istekte gönderilebilecek ürün sayısı gibi teknik sınırların bulunduğunu açıklar  [Trendyol Stock and Price](https://developers.trendyol.com/v3.0/docs/9-stock-and-price-update-1). n11 tarafında da RestAPI fiyat-stok güncelleme servisi üzerinden ürünlerin fiyat ve stok bilgisinin güncellenebildiği belirtilir  [n11 Mağaza Destek](https://magazadestek.n11.com/satis-surecleri/restapi-urun-bilgileri-ve-fiyat-stok-guncelleme-servisi-10173).
Bu örnekler, entegrasyonda “anlık güncelleme yapalım” kararının her zaman sınırsız bir işlem anlamına gelmediğini gösterir. API limitleri, toplu işlem sınırları, hata yanıtları, bekleyen işlemler ve tekrar deneme mantığı teknik tasarımda düşünülmelidir.

## Siparişleri tek panelde toplamak neyi değiştirir?

Pazaryerlerinden gelen siparişleri tek panelde toplamak operasyon ekibi için büyük kolaylık sağlar. Ekip farklı pazaryeri panellerine tek tek girip sipariş kontrol etmek yerine siparişleri merkezi ekranda görebilir. Fakat bunun sağlıklı çalışması için sipariş durumları, müşteri bilgileri, ürün satırları, kargo şirketi, ödeme bilgisi ve fatura durumu standartlaştırılmalıdır.
[E-ticaret entegrasyon hizmeti](/e-ticaret-entegrasyon-hizmeti) planlanırken her kanalın sipariş durumları ortak bir iç durum modeline çevrilmelidir. Örneğin bir pazaryerinde “onaylandı”, başka birinde “paketlenebilir”, diğerinde “hazırlanıyor” görünen süreçler iç panelde “hazırlanacak sipariş” olarak gruplanabilir. Bu yapılmazsa merkezi panel sadece kalabalık bir listeye dönüşür.
Pazaryeri olayıİç sistem durumuOperasyon aksiyonuDikkat noktasıYeni sipariş geldiHazırlanacakStok rezerve edilir, depo ekranına düşerÇift sipariş kontrolü yapılmalı.Sipariş onaylandıPaketleniyorKargo etiketi hazırlanırKargo firması ve desi bilgisi gerekir.Kargo takip numarası oluştuKargoya verildiMüşteriye takip bilgisi gösterilirKanal bazlı bildirim farklı olabilir.Teslim edildiTamamlandıSipariş kapanır, rapora işlerİade süresi ayrı takip edilebilir.İade talebi geldiİade bekleniyorDepo ve muhasebe süreci başlarStok hemen geri eklenmemeli.İptal edildiİptalStok ve muhasebe düzeltmesi yapılırÖdeme ve komisyon kontrol edilmeli.

## Kargo ve fatura akışı entegrasyonda nasıl yer almalı?

Pazaryeri siparişleri yalnızca web sitesine çekilmekle bitmez. Sipariş hazırlanacak, kargo etiketi oluşturulacak, takip bilgisi işlenecek, fatura veya e-arşiv süreci tamamlanacak ve gerekirse pazaryerine geri bildirim gönderilecektir. Bu zincirin hangi adımları otomatik, hangi adımları manuel kontrollü olacak baştan belirlenmelidir.
[Kargo entegrasyonu](/kargo-entegrasyonu) tarafında alıcı adresi, telefon, kargo firması, paket adedi, desi, takip numarası ve teslimat durumu gibi bilgiler net olmalıdır. Fatura tarafında ise sipariş numarası, müşteri bilgisi, ürün satırları, KDV oranı, komisyon, indirim ve kargo bedeli gibi alanlar muhasebe sistemiyle uyumlu taşınmalıdır.
Burada her pazaryerinin operasyon kuralı farklı olabilir. Bazı siparişlerde kargo anlaşması pazaryeri üzerinden yürürken, bazılarında satıcının kendi kargo anlaşması devreye girebilir. Bazı kanallarda fatura pazaryeri paneliyle eşleşirken, bazı yapılarda e-fatura/e-arşiv sistemiyle özel bağlantı gerekir. Bu nedenle entegrasyon kapsamı yalnızca ürün aktarımıyla sınırlandırılmamalıdır.

## API limitleri, hata yönetimi ve loglama unutulmamalı

Pazaryeri API’leri sınırsız ve hatasız çalışacak varsayımıyla tasarlanmamalıdır. İstek limitleri, bakım dönemleri, geçici bağlantı hataları, ürün reddi, kategori uyuşmazlığı, barkod hatası, eksik görsel, yanlış fiyat ve yetki problemi gibi durumlar yaşanabilir. Sağlıklı entegrasyonda bu hatalar görünür olmalıdır.
[API entegrasyon hizmeti](/api-entegrasyon-hizmeti) kapsamında her kritik işlem için log tutulmalıdır. Hangi ürün hangi pazaryerine ne zaman gönderildi, hangi yanıt döndü, stok güncellemesi kabul edildi mi, sipariş tekrar çekildi mi, fatura gönderimi hata aldı mı? Bu kayıtlar yoksa ekip sorunu tahminle çözmeye çalışır.
**Örnek hata kaydı:** “SKU AYK-SPORT-SIYAH-42, Trendyol stok güncellemesi 14:32’de gönderildi. Yanıt: barkod eşleşmedi. Ürün pasif güncelleme kuyruğuna alındı ve operasyon ekibine bildirim gönderildi.” Böyle bir log, sorunun nerede olduğunu hızlıca gösterir.

## Pazaryeri entegrasyonu öncesi teknik kontrol tablosu

Aşağıdaki tablo, entegrasyon başlamadan önce teknik ekip, operasyon ekibi ve yönetim tarafında netleştirilmesi gereken başlıkları özetler. Bu liste, teklif aşamasında bile projenin gerçek kapsamını daha doğru görmenizi sağlar.
KonuNetleşmesi gereken soruYanlış planlanırsa ne olur?ÖncelikAna veri kaynağıÜrün, stok ve fiyat nereden yönetilecek?Kanallar arasında tutarsızlık oluşur.Çok yüksekKategori eşleştirmeHer pazaryeri için kategori ve özellik haritası var mı?Ürünler reddedilir veya yanlış listelenir.YüksekStok stratejisiStok anlık mı, periyodik mi güncellenecek?Stokta olmayan ürün satılabilir.Çok yüksekFiyat stratejisiKanal bazlı fiyat, komisyon ve kampanya nasıl yönetilecek?Kârlılık ve fiyat tutarlılığı bozulur.YüksekSipariş akışıSiparişler tek panelde hangi durumlara düşecek?Operasyon ekibi siparişi takip edemez.Çok yüksekHata yönetimiBaşarısız işlemler nasıl loglanacak?Sorunlar geç fark edilir.YüksekTest ortamıGerçek ürün ve sipariş senaryoları test edilecek mi?Canlıda beklenmeyen hatalar çıkar.Yüksek

## Kanal bazlı fiyat ve komisyon hesabı nasıl düşünülmeli?

Pazaryerlerinde aynı ürünü aynı fiyatla satmak her zaman doğru olmayabilir. Komisyon oranları, kargo maliyeti, hizmet bedelleri, kampanya katılımı, kupon kullanımı ve ödeme vadesi kanala göre değişebilir. Entegrasyon yalnızca fiyat gönderiyorsa ama kârlılık hesabı yapmıyorsa işletme çok satış yapıp düşük kârla karşılaşabilir.
Bu nedenle fiyat güncelleme sistemi kanal bazlı düşünülmelidir. Örneğin web sitesinde 1.000 TL olan ürün, pazaryeri komisyonu ve kargo maliyeti nedeniyle farklı fiyatlanabilir. Bazı işletmeler fiyatı merkezi belirler, bazıları kanal bazlı katsayı kullanır, bazıları ise belirli ürünlerde pazaryeri kampanyasına özel fiyat uygular. Hangi model seçilirse seçilsin, entegrasyon bu kurala göre veri üretmelidir.

## Test süreci canlıya geçmeden önce nasıl yapılmalı?

Entegrasyon testinde yalnızca “ürün gitti mi?” diye bakmak yeterli değildir. Ürün oluşturma, güncelleme, stok düşme, fiyat değişme, sipariş çekme, kargo bilgisi gönderme, iade alma, iptal işleme ve hata senaryoları test edilmelidir. Testte gerçekçi varyantlı ürünler kullanılmalıdır; çünkü en çok hata sade ürünlerde değil, varyantlı ve kategori özelliği yoğun ürünlerde çıkar.
Örneğin test senaryosu şöyle yazılabilir: “Barkodlu, iki renk ve üç beden varyantlı ürün aktarılır. Bir varyantın stoğu sıfır yapılır. Kanal bazlı fiyat güncellenir. Sipariş simüle edilir. Sipariş tek panele düşer. Kargo bilgisi işlenir. İade talebi oluşur. İade onaylanınca stok güncellenir.” Bu senaryo, entegrasyonun gerçek operasyonu taşıyıp taşımadığını daha iyi gösterir.

## Pazaryeri entegrasyonu yaptırmadan önce checklist

Aşağıdaki kontrol listesi, entegrasyon görüşmesine başlamadan önce hazırlık yapmanızı sağlar. Bu maddeler netleştiğinde hem teknik teklif daha doğru çıkar hem de canlıya geçiş riski azalır.
- Bağlanacak pazaryerlerini ve öncelik sırasını belirleyin.
- Ürün, stok ve fiyat için ana veri kaynağını seçin.
- SKU ve barkod yapınızın tutarlı olup olmadığını kontrol edin.
- Varyantlı ürünlerde renk, beden, ölçü gibi alanları standartlaştırın.
- Kategori ve özellik eşleştirme ihtiyacını çıkarın.
- Kanal bazlı fiyat, komisyon ve kampanya kurallarını belirleyin.
- Siparişlerin hangi panelde toplanacağını netleştirin.
- Kargo, fatura, iade ve iptal akışlarını yazılı hale getirin.
- API hata loglarını kimin takip edeceğini belirleyin.
- Canlıya geçmeden önce gerçekçi test senaryoları oluşturun.

## Sonuç: pazaryeri entegrasyonu veri disipliniyle başarılı olur

Pazaryeri entegrasyonu yaptırmadan önce teknik konuları netleştirmek, projenin maliyetini ve riskini daha gerçekçi görmenizi sağlar. Ürün aktarımı, stok-fiyat güncelleme, sipariş çekme, kargo, fatura, iade, komisyon ve hata loglama aynı plan içinde düşünülmelidir.
İyi planlanan entegrasyon, işletmenin farklı pazaryerlerinde daha düzenli satış yapmasına yardımcı olur. Kötü planlanan entegrasyon ise aynı ürünün farklı fiyatla görünmesine, stokta olmayan ürünün satılmasına, siparişlerin kaçmasına ve operasyon ekibinin manuel iş yükünün artmasına neden olur. Bu yüzden entegrasyona API bağlantısı olarak değil, uçtan uca satış operasyonu olarak bakmak gerekir.

## Pazaryeri entegrasyon yapınızı birlikte planlayalım
Webioo ekibi; ürün, stok, fiyat, sipariş, kargo, fatura ve pazaryeri kanallarınızı tek operasyon akışı içinde değerlendirerek daha sürdürülebilir bir entegrasyon yapısı planlayabilir.[Projemi Değerlendir](/iletisim)

## Sıkça Sorulan Sorular

### Pazaryeri entegrasyonu nedir?

Pazaryeri entegrasyonu, e-ticaret siteniz veya ERP sisteminiz ile Trendyol, Hepsiburada, n11 gibi pazaryerleri arasında ürün, stok, fiyat, sipariş, kargo, fatura ve iade verilerinin düzenli aktarılmasını sağlayan teknik yapıdır. Amaç ürünleri tek tek panellerden yönetmek yerine merkezi bir veri akışı kurmak ve operasyon hatalarını azaltmaktır.

### Pazaryeri entegrasyonu yaptırmadan önce ilk neye karar verilmeli?

İlk karar ana veri kaynağıdır. Ürün açıklaması, stok, fiyat, barkod, kategori ve görsel bilgileri hangi sistemden yönetilecek netleşmelidir. Bu kaynak e-ticaret paneli, ERP, stok yazılımı veya özel entegrasyon paneli olabilir. Ana kaynak belli değilse aynı ürün farklı kanallarda farklı fiyat, stok veya açıklamayla görünebilir.

### Stok ve fiyat güncellemesi anlık mı yapılmalı?

Bu karar ürün sayısına, satış hızına, depo yapısına, API limitlerine ve stok riskine göre verilmelidir. Hızlı satılan ürünlerde daha sık güncelleme gerekebilir. Daha düşük hacimli kataloglarda periyodik güncelleme yeterli olabilir. Önemli olan güncelleme sıklığının teknik sınırlar, hata yönetimi ve operasyon ihtiyacıyla birlikte planlanmasıdır.

### Pazaryeri siparişleri tek panelde toplanabilir mi?

Evet, pazaryeri siparişleri tek panelde toplanabilir. Ancak bunun için her pazaryerinden gelen sipariş durumlarının ortak iç durum modeline çevrilmesi gerekir. Yeni sipariş, hazırlanıyor, kargoya verildi, teslim edildi, iade bekleniyor ve iptal gibi durumlar standartlaştırılırsa operasyon ekibi farklı kanalları tek ekrandan daha rahat yönetebilir.

### Kategori eşleştirme neden önemlidir?

Her pazaryerinin kategori ağacı ve zorunlu ürün özellikleri farklı olabilir. Kategori eşleştirme doğru yapılmazsa ürünler reddedilebilir, yanlış kategoriye düşebilir veya filtrelerde görünmeyebilir. Özellikle varyantlı ürünler, elektronik, tekstil, kozmetik ve teknik ürünlerde kategori-özellik haritalaması entegrasyonun en kritik adımlarından biridir.

### Pazaryeri entegrasyonunda test süreci nasıl yapılmalı?

Test sürecinde yalnızca ürün aktarımı değil; stok güncelleme, fiyat değişikliği, varyant eşleşmesi, sipariş çekme, kargo bilgisi gönderme, iptal, iade ve hata senaryoları da denenmelidir. Test için tek düz ürün yerine gerçekçi varyantlı ürünler kullanılmalıdır. Böylece canlıya geçildiğinde kategori, barkod, stok ve sipariş akışıyla ilgili hatalar daha erken yakalanır.

> Orijinal Kaynak: https://www.webioo.com.tr/blog/pazaryeri-entegrasyonu-teknik-konular