Pazar Yeri Entegrasyonu Nasıl Yapılır? Adım Adım Rehber

Dün akşam Trendyol'da sattığınız bir ürünü Hepsiburada'da hâlâ satışta bıraktınız ve aynı ürüne çift sipariş geldi. Stoku manuel güncellemeye çalışırken öğle yemeğinizi atladınız. Tanıdık geliyor mu? Türkiye'deki e-ticaret satıcılarının %68'i birden fazla pazaryerinde satış yaparken bu senaryoyu ayda en az birkaç kez yaşıyor. Pazar yeri entegrasyonu tam olarak bu kaosu bitirir — ama kurulum aşamasında yapılan hatalar sizi daha büyük sorunlara sürükleyebilir. Bu rehber, başlangıçtan canlıya geçişe kadar her adımı somut ekran akışlarıyla açıklıyor.

Pazar Yeri Entegrasyonu Nedir ve Neden Kritik?

Pazar yeri entegrasyonu; kendi e-ticaret sisteminiz (veya bir SaaS aracı) ile Trendyol, Hepsiburada, N11 gibi platformlar arasında stok, fiyat, sipariş ve ürün bilgisini otomatik olarak senkronize eden API köprüsüdür. "Entegrasyon yapalım" kararını almadan önce şu tabloya bakın:

Türkiye pazarında Trendyol'un 30 milyonun üzerinde aktif müşterisi var; Hepsiburada ise 11 milyonun üzerinde aylık ziyaretçiyle rekabet ediyor. Bu hacimlerde manuel yönetim sürdürülebilir değil. Komisyon oranları Trendyol'da kategoriye göre %8 ile %22 arasında değişirken, operasyonel verimsizlik bu komisyonun üstüne ekstra maliyet yükler.

Başlamadan Önce: Hazırlık Adımları

Entegrasyon kurulumuna API anahtarı almadan önce atlanan hazırlık adımları en çok zaman kaybettiren kısımdır. Şu listeyi tamamlamadan bir sonraki aşamaya geçmeyin:

1. Satıcı hesabınızın onaylı olduğundan emin olun. Trendyol'da mağaza başvurusu onaylanmadan API erişimi verilmez. Onay süreci 2-5 iş günü sürebilir.
2. Ürün katalog yapınızı standartlaştırın. SKU kodları tutarsızsa (aynı ürün için farklı platformlarda farklı kod kullanıyorsanız) entegrasyon eşleştirme adımında ciddi sorun yaşarsınız. Tüm platformlarda tek tip SKU şeması belirleyin.
3. Kategori eşleştirme listesi hazırlayın. Kendi ürün kategorilerinizin her pazaryerindeki karşılığını önceden listeleyin. Trendyol'un kategori ağacı ile Hepsiburada'nınki farklıdır.
4. Muhasebe entegrasyonu kararını verin. Paraşüt, Luca veya Akınsoft kullanıyorsanız, siparişlerin otomatik muhasebeleşmesi için entegrasyonu aynı anda kurmak sonradan uğraşı ortadan kaldırır.
5. Depo yapınızı netleştirin. Birden fazla deponuz varsa hangi depodaki stokun hangi pazaryerine yansıyacağına önceden karar verin.

API Anahtarı Alma: Pazaryeri Bazında Adımlar

Her pazaryerinin API erişim yöntemi birbirinden farklıdır. Aşağıda en yaygın üç platform için gerçek panel akışını bulabilirsiniz.

Trendyol API Anahtarı

1. Trendyol Satıcı Merkezi'ne (partner.trendyol.com) giriş yapın.
2. Sol menüde Entegrasyon > API Entegrasyonu yolunu izleyin.
3. "API Bilgilerini Görüntüle" butonuna tıklayın — Supplier ID, API Key ve API Secret görünür.
4. Bu üç değeri kopyalayın. API Secret'ı yalnızca bir kez görebilirsiniz; kaydedin.

Hepsiburada API Anahtarı

1. Hepsiburada Merchant Center'a giriş yapın.
2. Ayarlar > Entegrasyon Bilgileri sekmesine gidin.
3. Username ve Password bilgilerini not alın (Hepsiburada Basic Auth kullanır, OAuth değil).

N11 API Anahtarı

1. N11 Mağaza Yönetimi paneline giriş yapın.
2. Mağaza Ayarları > API Bilgileri menüsüne tıklayın.
3. App Key ve App Secret değerlerini kopyalayın.

Kritik hata: API anahtarlarını Excel'e kopyalarken satır başı veya boşluk karakteri eklenmesi, bağlantı testinde "401 Unauthorized" hatası almanın en yaygın nedenidir. Kopyaladıktan sonra metin editöründe görünmez karakterleri temizleyin.

Etibas'ta Entegrasyonu Kurma: Panel Akışı

API anahtarlarınız hazırsa Etibas panelinde entegrasyonu kurmak ortalama 8-12 dakika sürer. İşte adım adım akış:

1. API Hesabı Tanımlama

Etibas paneline giriş yaptıktan sonra sol menüde Ayarlar > API Hesapları yolunu izleyin. "Yeni Hesap Ekle" butonuna tıkladığınızda platform seçim ekranı açılır. Trendyol'u seçin, Supplier ID, API Key ve API Secret alanlarını doldurun. "Bağlantıyı Test Et" butonuna tıkladığınızda sistem gerçek zamanlı olarak API'ye istek atar; yeşil onay aldıysanız devam edin.

2. Kategori Eşleştirme

Bu adım en çok göz ardı edilen ama ileride en çok sorun çıkaran kısımdır. Etibas'ta Ürünler > Kategori Eşleştirme menüsünden kendi ürün kategorilerinizi pazaryeri kategorileriyle eşleştirin. Örneğin kendi sisteminizde "Spor Ayakkabı" olarak tanımlanan kategori, Trendyol'da "Ayakkabı > Spor Ayakkabı > Koşu" dalında olabilir. Yanlış eşleştirme ürünlerinizin yanlış kategoride listelenmesine ve görünürlük kaybına yol açar.

3. Stok Senkron Ayarları

Etibas'ta Entegrasyonlar > Senkron Ayarları menüsünden şu parametreleri belirleyin:

• Senkron sıklığı: Her 15 dakikada bir önerilen minimum değerdir. Yüksek hacimli satışlarda 5 dakikaya indirmek çift satış riskini minimize eder.
• Stok tampon değeri: Gerçek stok 10 adet ise pazaryerine 8 adet göstermek, sipariş girişi ile sistem güncellenmesi arasındaki 5-10 saniyelik gecikme riskini sıfırlar. Özellikle kampanya dönemlerinde bu tampon hayat kurtarır.
• Sıfır stok davranışı: Stok bittiğinde ürünü "Pasif" yapmasını mı yoksa "Stok 0" olarak bırakmasını mı tercih ettiğinizi seçin. Trendyol'da stok 0 olan ürünler otomatik pasife çekilir, bazı kategorilerde listelemeden tamamen kaldırılır.

4. Fiyat Kuralları Tanımlama

Etibas'ın otomatik fiyatlandırma motoru, her platform için farklı fiyat kuralı tanımlamanıza olanak verir. Örneğin:

• Hepsiburada için ana fiyat × 1.05 (Trendyol komisyonu daha yüksekse marjı korumak için)
• N11 için promosyon dönemlerinde otomatik %10 indirim uygula
• Döviz bazlı ürünlerde kur değişimine göre otomatik fiyat güncelle

Bu kuralar Fiyatlandırma > Fiyat Kuralları menüsünden tanımlanır. Kural oluştururken "Platform" ve "Kategori" bazında filtreleme yapabilirsiniz; tüm ürünlere tek kural uygulamak zorunda değilsiniz.

Sık Yapılan Hatalar ve Çözümleri

Yüzlerce mağaza kurulumundan derlenen en kritik hata senaryoları:

• Hata: Barkod eksikliği. Trendyol ve Hepsiburada, ürün başına geçerli GTIN/EAN barkod ister. Barkod alanı boş bırakılan ürünler onay aşamasında reddedilir. Çözüm: Ürün ekleme ekranında barkod alanını zorunlu alan olarak işaretleyin.
• Hata: Marka onayı bekleniyor. Trendyol'da markasız veya onaylı olmayan markayla yüklenen ürünler "Marka Onayı Bekleniyor" statüsünde kalır, satışa açılmaz. Çözüm: Trendyol marka havuzunda var olmayan markalar için önceden marka başvurusu yapın.
• Hata: Görsel boyut reddi. Trendyol minimum 1000×1000 px JPEG/PNG ister. Daha küçük görseller yüklenirse ürün onaylanmaz. Etibas'ta görsel yükleme sırasında boyut kontrolü otomatik yapılır; uyarı alırsanız görseli yeniden boyutlandırın.
• Hata: Yanlış KDV oranı. Kategori bazında KDV oranları farklıdır (%1, %10, %20). Yanlış KDV seçimi muhasebe entegrasyonunda fatura uyumsuzluğuna yol açar. Çözüm: muhasebe entegrasyonu kurulumunda KDV eşleştirme tablosunu doğrulayın.
• Hata: Desi/kargo bilgisi eksikliği. Ürün ağırlığı veya boyutu girilmeden yüklenen ürünler kargo fiyatlandırma hatasına yol açar. Özellikle hacimli ürünlerde desi hesabı yanlış çıkarsa kargo maliyetiniz beklentinin iki katına çıkabilir.

Çoklu Pazaryeri Yönetiminde İleri Seviye İpuçları

Temel entegrasyonu kurduğunuzda kazanç büyük, ama asıl verimlilik ikinci katmanda saklı. Etibas üzerinden yönetebileceğiniz ileri seviye senaryolar:

Platform Bazında Stok Dağılımı

100 adet stoğunuz varsa ve Trendyol ile Hepsiburada'da aynı ürünü satıyorsanız, iki platforma da 100 göstermek çift satış riski taşır. Etibas'ta Depolar > Platform Dağılımı menüsünden platforma özel stok kotası belirleyebilirsiniz: Trendyol'a 70, Hepsiburada'ya 30 gibi. Stok aşımında sistem otomatik uyarı verir.

Kampanya Dönemlerinde Fiyat Koruması

Trendyol'un 11.11 veya Efsane Cuma kampanyalarında indirim uygularsanız, kampanya bitişinde fiyatların otomatik eski haline dönmesi için Etibas'ta zamanlanmış fiyat kuralı oluşturabilirsiniz. Kampanya başlangıç/bitiş saatini girin — sistem saate dakika farkıyla günceller.

Muhasebe Otomasyonu

Siparişler Etibas'a düştükten sonra Paraşüt entegrasyonu veya Luca entegrasyonu aktifse e-fatura otomatik kesilir, GİB'e iletilir ve muhasebe kaydı oluşturulur. Fatura işlem süresi sipariş başına 2 dakikadan 10 saniyenin altına iner. Aylık 500 siparişlik bir mağazada bu yalnızca fatura işlemi için ayda 15 saate yakın zaman kazandırır.

Ürün Varyant Yönetimi

Beden/renk kombinasyonu olan ürünlerde her varyantın ayrı stok değeri takip edilmesi gerekir. Etibas'ta varyant eşleştirme ekranında (Ürünler > Varyant Yönetimi) ana ürüne bağlı tüm SKU'ları görebilir, pazaryeri varyant ağacıyla eşleştirebilirsiniz. Bu yapı kurulmadan yüklenen varyantlı ürünler, platformlarda tek tip görünür ve müşteri seçim yapamaz.

Hangi Pazaryerinden Başlamalısınız?

"Hepsini aynı anda aç" yaklaşımı cazip görünse de operasyonel olarak risklidir. İlk 30 günde tek platforma odaklanıp süreçleri oturtmak daha sağlıklı sonuç verir. Öncelik sıranızı belirlemek için şu kriterleri değerlendirin:

• Kategori uyumu: Tekstil ve moda için Trendyol, elektronik için Hepsiburada, ev ve yaşam için N11 tarihsel olarak daha güçlü. Trendyol entegrasyonu kurulumu ile başlamak çoğu kategori için mantıklı ilk adımdır.
• Komisyon yapısı: Hepsiburada entegrasyonu bazı kategorilerde daha düşük komisyon sunar; marj hesabınıza göre öncelik değişebilir.
• Kategori rekabeti: Çok rekabetin olduğu kategorilerde ikinci bir platform açmak yerine ilk platformda organik sıralama oturtmak daha verimlidir.
• Lojistik altyapı: Pazarama gibi nişe özel platformlar daha az rekabet sunar. Pazarama entegrasyonu ile hızlı büyüme fırsatı değerlendirilebilir.

Sıkça Sorulan Sorular

Pazar yeri entegrasyonu kurmak için yazılım bilgisi gerekiyor mu?

Hayır. Etibas gibi SaaS çözümleri API süreçlerini arayüz üzerinde yönetmenizi sağlar. API anahtarını kopyalayıp ilgili alana yapıştırmak yeterli; herhangi bir kod yazmanıza gerek yoktur. Ortalama bir kurulum 8-12 dakika içinde tamamlanıyor.

Entegrasyon sonrası stoklar neden eşleşmiyor?

En yaygın neden SKU tutarsızlığıdır. Etibas'ta kendi sisteminizdeki SKU ile pazaryerindeki ürün barkodunu doğru eşleştirmeniz gerekir. İkinci yaygın neden ise API rate limit aşımıdır: Trendyol API'si dakikada belirli sayıda istek kabul eder; bu limiti aşan senkron talepleri sessizce reddedilir. Etibas bu isteği otomatik kuyruklar ve yeniden dener.

Birden fazla pazaryerinde farklı fiyat uygulayabilir miyim?

Evet. Etibas'ın fiyat kuralları motoru platform bazında farklı fiyat tanımlamanıza izin verir. Örneğin Trendyol için ana fiyat × 1.08, N11 için ana fiyat × 1.05 şeklinde platform bazlı çarpan belirleyebilirsiniz. Komisyon farklarını ve kargo maliyetlerini bu kurallara ekleyerek platforma özel net kar marjı koruma stratejisi oluşturabilirsiniz.

Entegrasyon kurulumu sonrası mevcut ürünlerim ne olur?

Mevcut ürünleriniz pazaryerinde olduğu gibi kalır; entegrasyon bunların üzerine stok ve fiyat bilgisini yazmaya başlar. Ancak ürünleri Etibas üzerinden de yönetmek istiyorsanız "Ürün Çekme" özelliğiyle mevcut listeleri Etibas kataloğuna import edebilirsiniz. Bu işlem sonrasında tek kaynaktan yönetim devreye girer.

Entegrasyon koptuğunda (API hatası) ne oluyor?

Etibas, API bağlantı hatalarında e-posta ve panel içi bildirim gönderir. Bağlantı koptuğu süre zarfında son başarılı senkron değerleri pazaryerinde sabit kalır — yani stok otomatik artmaz ama azalmaz da. Hata çözüldüğünde sistem son duruma göre farkı kapatır. Kritik kampanya dönemlerinde bu pencereyi kısaltmak için senkron sıklığını 5 dakikaya indirmenizi öneririz.