Pazaryeri entegrasyonu, ürünlerinizi Trendyol, Hepsiburada, n11, Amazon, Çiçeksepeti ve Pazarama gibi pazaryerlerine yazılımdan aktarmak, stok ve fiyatı tek yerden güncellemek ve siparişleri otomatik çekmektir. Bunu ya bir entegratör firma üzerinden ya da pazaryerinin API'sine doğrudan bağlanarak yaparsınız.
İlgili içerikler: Kargo entegrasyonu · Ticimax entegrasyonu · Paraşüt entegrasyonu · API istek sınırı
Entegratör mü, Doğrudan API mi?
| Entegratör firma | Doğrudan API | |
|---|---|---|
| Kurulum | Panelden, kod gerekmez | Geliştirici gerekir |
| Pazaryeri sayısı | Çok sayıda pazaryeri tek panelde | Her biri için ayrı geliştirme |
| Sorumluluk | İstek sınırı, kategori eşleştirme ve hata takibi büyük ölçüde entegratörde | Hepsi sizde |
| Uygun olduğu durum | Standart ürün ve sipariş akışı | Kendi ERP'niz, özel fiyat kuralları, yüksek hacim |
Bazı pazaryerleri istekte kimin bağlandığını açıkça ister. Trendyol ve Çiçeksepeti, User-Agent başlığında satıcı numarasıyla birlikte entegratör adını bekler; kendi yazılımınızla bağlanıyorsanız bunu belirtirsiniz.
Pazaryerlerine Göre Teknik Bilgiler
| Pazaryeri | Kimlik doğrulama | Test ortamı |
|---|---|---|
| Trendyol | Basic Auth: API KEY ve API SECRET, satıcı ID, zorunlu User-Agent | Var (stage, IP tanımı gerekir) |
| Hepsiburada | Basic Auth, servis anahtarı entegratör bazında | Var ("-sit" adresleri) |
| n11 | appKey ve appSecret başlıkta | Belgede bulunamadı |
| Amazon (SP-API) | Login with Amazon erişim tokenı, x-amz-access-token | Var (sandbox) |
| Çiçeksepeti | x-api-key ve User-Agent | Var (sandbox) |
| Pazarama | clientId ve clientSecret ile token | Belgede bulunamadı |
Trendyol
- Bilgiler: Supplier ID, API KEY ve API SECRET satıcı panelinde Hesap Bilgilerim, Entegrasyon Bilgileri altında yer alır; yalnızca yönetici hesabıyla görünür. Canlı ve test bilgileri farklıdır.
- Adresler: Canlı
https://apigw.trendyol.com, testhttps://stageapigw.trendyol.com. Test ortamı için çıkış IP adresinizi Trendyol'a tanımlatmanız gerekir. - User-Agent:
{SupplierId} - {EntegratörAdı}; kendi yazılımınızda1234 - SelfIntegrationbiçimi. User-Agent gönderilmezse istek 403 alır. - Sınırlar: Belgede istek sınırları servis bazında veriliyor; 14 Eylül 2026 sonrası ürün yazma ve stok-fiyat sınırları mağazanın ürün listeleme limitine göre gruplanıyor. Bir ürün veya stok-fiyat isteğinde en fazla 1.000 öğe gönderilir.
- Kategori: En alt seviye kategori kullanılır, zorunlu özellikler kategori özellikleri servisinden alınır.
curl https://apigw.trendyol.com/... \
-u "API_KEY:API_SECRET" \
-H "User-Agent: 1234 - SelfIntegration"n11
n11 belgeleri developer.n11.com adresine taşındı ve REST yapısında. Kimlik bilgileri panelde Hesabım, API Hesapları altında. Ürün yükleme asenkron çalışır: istekte en fazla 1.000 ürün gönderilir, dönen görev numarasıyla sonuç sorgulanır. Kategori en alt seviye olmalı ve zorunlu özellikler doldurulmalıdır.
Amazon Türkiye
Amazon'un Selling Partner API'si REST yapısındadır. Amazon.com.tr için pazaryeri kimliği A33AVAJ2PDY3EV, uç nokta https://sellingpartnerapi-eu.amazon.com. Erişim tokenı 1 saat geçerlidir. İstek sınırları her işlem için ayrı tanımlanır; aşıldığında 429 döner.
Çiçeksepeti
Belgeler ciceksepeti.dev adresinde. Canlı ve test için ayrı API anahtarı verilir; anahtar satıcı panelinden destek talebiyle istenir. Belgeye göre stok ve fiyat güncelleme saniyede 1 istekle ve istek başına en fazla 200 ürünle sınırlı, aynı içerik 30 dakikada bir gönderilebilir. Ürün özellikleri API ile güncellenemez.
Hepsiburada ve Pazarama
Hepsiburada belgeleri developers.hepsiburada.com adresinde; servis anahtarı satıcı panelinde Bilgilerim, Entegrasyon, Entegratör Bilgileri altında tanımlanır ve test adresleri "-sit" ekiyle ayrılır. Pazarama'nın yayımladığı entegrasyon belgesinde clientId ve clientSecret ile token alındığı anlatılıyor; belge 2023 tarihli olduğundan güncel sürümü Pazarama'dan isteyin.
Ortak Zorluklar
- Kategori ve özellik eşleştirme: Her pazaryerinin kategori ağacı ve zorunlu özellikleri farklıdır. Kendi kategorilerinizi her pazaryeri için bir kez eşleştirip tabloda saklayın.
- Asenkron işlemler: Ürün yükleme çoğu pazaryerinde hemen sonuçlanmaz; görev veya toplu işlem numarasıyla sonucu sorgulamanız gerekir. Hata alan ürünleri ayrı listede tutun.
- İstek sınırları: Stok ve fiyat güncellemelerini değişen ürünlerle sınırlayın, tüm kataloğu her seferinde göndermeyin.
- Tek stok kaynağı: Aynı ürün birden fazla pazaryerinde satılıyorsa stok tek bir yerde tutulmalı, satış olunca hepsine dağıtılmalıdır.
- Fatura ve kargo bildirimi: Sipariş sonrasında fatura bağlantısı ve kargo bilgisi pazaryerine geri gönderilir. Faturayı muhasebe programından otomatik kesmek için Paraşüt entegrasyonu yazısına bakın.
Pazaryerine Özel Entegrasyon Rehberleri
- Trendyol entegrasyonu: ürün V2 alanları, sipariş durumları, webhook, sınırlar.
- Hepsiburada entegrasyonu: katalog ve listing, SIT test ortamı, sipariş.
- n11 entegrasyonu: REST ürün yükleme, task sorgulama, SOAP-REST geçişi.
- Amazon Türkiye entegrasyonu: SP-API kaydı, roller, Orders, RDT.
- Çiçeksepeti entegrasyonu: ürün ve stok-fiyat, kargo modelleri, iade.
- Pazarama entegrasyonu: İş Ortağım API, token, sipariş akışı.
Sık Sorulan Sorular
Trendyol'da test ortamı var mı?
Evet: stageapigw.trendyol.com. Ayrı test kimlik bilgileri ve IP tanımı gerekir.
Amazon.com.tr için hangi uç nokta kullanılır?
Avrupa bölgesi uç noktası sellingpartnerapi-eu.amazon.com ve Türkiye pazaryeri kimliği A33AVAJ2PDY3EV.
Kendi sitemle pazaryerlerini aynı stokla yönetebilir miyim?
Evet. Altyapınızın hazır pazaryeri bağlantısı varsa (örneğin Ticimax) onu kullanın; yoksa stok değişikliğini her pazaryerinin stok-fiyat servisine gönderen bir görev yazın.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.