PrestaShop entegrasyonu:
siteniz ve pazaryerleri aynı stokta.

PrestaShop entegrasyonu nedir, hangi satıcının işine yarar?

PrestaShop entegrasyonu, kendi sitenizdeki ürün kartlarını pazaryerleriyle ortak bir stok kaynağına bağlayan ve satış nereden gelirse gelsin adetleri her kanalda eşitleyen bağlantıdır. PrestaShop, geliştiricisinin tanımıyla e-ticaret sitesi kurmak için kullanılan açık kaynak bir yazılım platformudur; siteyi kendi sunucunuzda ya da barındırma firmanızda çalıştırırsınız. Bu esneklik avantajdır; ama pazaryerine açılınca stoğun tek doğru kaynağını da siz kurarsınız.

Tipik tablo şudur: sitede 300 ürün satıyorsunuz, aynı ürünleri Trendyol entegrasyonu ile Trendyol'a, ardından Hepsiburada'ya açıyorsunuz. Her kanal kendi adedini tutar; sitede son ürün satıldığında pazaryeri ilanı açık kalır ve elinizde olmayan ürün için sipariş gelir. Kanal sayısı ikiyi geçtiğinde elle güncelleme hata üretmeye başlar.

• PrestaShop sitenizdeki ürünleri bir veya birden fazla pazaryerinde de satıyorsanız,
• renk ve beden gibi kombinasyonlu ürünlerde bedenlerden biri bittiğinde pazaryerinde satılmaya devam ediyorsa,
• site ve pazaryeri siparişlerini sabahları ayrı ekranlardan topluyor, kargo takip numarasını elle kopyalıyorsanız,
• pazaryerinde komisyonu karşılamak için siteden farklı fiyat kullanmak ama bunu her ilan için elle hesaplamak istemiyorsanız

bir PrestaShop pazaryeri entegrasyonu işinizi doğrudan kolaylaştırır. Bazı satıcılar her pazaryeri için PrestaShop'a ayrı modül kurar; bu durumda stok kuralları birden fazla yerde tutulur. Harici bir panelde ise stok kartı tektir. Hangisini seçerseniz seçin, aynı ürünü iki ayrı sistemden aynı pazaryerine göndermeyin; iki sistem aynı ilanın adedini birbirinin üzerine yazar.

PrestaShop Webservice nasıl çalışır? Bağlantının resmî kuralları

PrestaShop Webservice, mağaza verisine dışarıdan erişmek için PrestaShop'un kendi içinde gelen REST tarzı API'sidir ve varsayılan olarak kapalı gelir. Ürünler, kombinasyonlar, stok kayıtları ve siparişler bu API'de ayrı kaynaklar olarak durur; her kaynağa hangi işlemle erişilebileceğini anahtara verdiğiniz izinler belirler. Aşağıdaki tablo, PrestaShop geliştirici belgesindeki (DevDocs) temel kuralları ve bunların bağlantıya etkisini özetliyor.

PrestaShop 9 Admin API ile Webservice arasındaki fark

PrestaShop 9'un ilk kararlı sürümü 10 Haziran 2025'te yayımlandı ve yanında yeni bir Admin API getirdi. Belgeye göre Admin API, API Platform 3 üzerine kurulu ve OAuth yetkilendirmesi kullanan ayrı bir arayüzdür; PrestaShop 9'da varsayılan olarak açıktır, canlı modda yalnız HTTPS ile bağlanılır. Klasik Webservice, PrestaShop 9 belgelerinde de yer alır. Yox İş Ortağım bağlantısı web servis anahtarıyla kurulur; sitenizde Admin API'nin açık olması bu bağlantıyı etkilemez.

PrestaShop entegrasyonu için web servis anahtarı adım adım

Web servis anahtarı, PrestaShop yönetim panelinden birkaç dakikada oluşturulur ve bağlantının tek kimlik bilgisidir. İngilizce arayüzde aynı sayfa Advanced Parameters > Webservice adını taşır.

1. Yönetim panelinde Gelişmiş Parametreler > Web servis sayfasına girin.
2. PrestaShop web servisini etkinleştirme seçeneğini Evet konumuna getirip kaydedin; sayfanın üstündeki durum alanında web servis adresiniz görünür.
3. Yeni web servis anahtarı ekleyin ve anahtarı Oluştur düğmesiyle ürettirin.
4. Açıklama alanına anahtarın kime verildiğini yazın (ör. Yox İş Ortağım).
5. İzin tablosunda yalnız aşağıdaki kaynakları işaretleyin; diğer satırları boş bırakın.
6. Çoklu mağaza kullanıyorsanız mağaza ilişkilendirmesini seçin, kaydedin ve anahtarı site adresinizle birlikte panele girin.

Anahtara hangi kaynaklarda izin verilmeli?

Çoklu mağaza (multistore) kullanıyorsanız

PrestaShop'ta çoklu mağaza modu açıksa anahtar formunda Mağaza ilişkilendirmesi alanı görünür ve anahtarın hangi mağazalara erişeceğini buradan seçersiniz. stock_availables kaydı mağaza ve mağaza grubu kimliği de taşıdığı için stoğu mağazalar arasında paylaşıp paylaşmadığınız önemlidir.

PrestaShop /api adresi yanıt vermiyorsa sunucuda neye bakılır?

Anahtar doğru olduğu halde bağlantı kurulamıyorsa sorun çoğunlukla PrestaShop'ta değil, sunucunun URL yeniden yazma ve yetkilendirme başlığı ayarlarındadır. PrestaShop belgesine göre /api adresine URL yeniden yazmayla ulaşılır; Apache'de .htaccess dosyasının işlenmesi için mod_rewrite modülü açık olmalı, sanal sunucu tanımında AllowOverride All bulunmalıdır. Tarayıcıda siteadresiniz/api/ adresi kullanıcı adı soruyorsa adres çalışıyordur; anahtarı kullanıcı adına yazıp şifreyi boş bırakınca erişilebilen kaynakların XML listesi döner.

• Web servis Evet konumunda mı ve değişiklik kaydedildi mi?
• Site bir alt klasörde çalışıyorsa adresi /klasor/api/ biçiminde mi girdiniz?
• Anahtarın Durum alanı etkin mi, izin tablosunda en az bir kaynak işaretli mi? İzinsiz anahtarda tarayıcı kullanıcı adını tekrar tekrar sorar.
• Nginx kullanıyorsanız /api yolu için yeniden yazma kuralı tanımlı mı? Bunu barındırma firmanız kontrol edebilir.
• Sitede geçerli SSL sertifikası var mı? Kullanıcı kılavuzu güvenli bağlantıyı öneriyor.

Yetkilendirme başlığı sunucuda kayboluyorsa

PHP'nin CGI olarak çalıştığı bazı sunucularda Authorization başlığı PHP'ye ulaşmaz ve anahtar doğru olsa bile erişim reddedilir. PrestaShop belgesi bu durumda .htaccess dosyasına CGIPassAuth On satırının eklenmesini ya da başlığın SetEnvIf yönergesiyle HTTP_AUTHORIZATION değişkenine aktarılmasını öneriyor. Anahtarı adres satırına gömmek de teknik olarak mümkündür, fakat belge bu yöntemi çok riskli bulup canlı mağazada kullanılmamasını söylüyor. Bu ayarlar barındırma paketinize göre değiştiği için emin değilseniz bizimle iletişime geçin; kurulumu birlikte yapabiliriz.

Ürün ve kombinasyon eşleştirme: referans, EAN-13 ve diğer kodlar

PrestaShop'taki ürünler panele okunduğunda pazaryerlerindeki mevcut ilanlarla barkod ya da stok koduyla eşleştirilir; bu yüzden kodların hangi alanda ve hangi düzeyde durduğu eşleşmenin kalitesini belirler. PrestaShop kodları iki düzeyde tutar: ana ürün kartında ve her kombinasyonda. Pazaryerleri ise varyantlı üründe her bedeni ve rengi çoğunlukla ayrı barkodla tanır; bu nedenle kombinasyonların kendi kodu boş kalmamalıdır.

Kombinasyonun fiyatı ayrı bir fiyat değil, fiyat etkisidir

combinations kaynağındaki price alanı negatif değer alabilen bir biçimde (isNegativePrice) tanımlıdır; yani varyantın ana ürün fiyatına eklenen ya da düşülen farkını tutar. XL beden ana fiyattan 50 lira pahalıysa kombinasyonda 50 yazar, satış fiyatı ise ana fiyatla toplanarak oluşur. Eşleştirmeden sonra varyant fiyatlarını kontrol ederken satış fiyatını ana fiyat ile fiyat etkisinin toplamı olarak okuyun.

Eşleşmeyen ürünler ve onay adımı

Kodu tutmayan ya da iki farklı üründe aynı referansı kullanan kayıtlar eşleşmeden ayrılır. Önce PrestaShop'ta kopya ve boş kodları düzeltip eşleştirmeyi yeniden çalıştırmak en temiz yoldur. Barkodunuzun geçerli olup olmadığını barkod hesaplama aracıyla kontrol edebilirsiniz. Bu aşamada siz onay vermeden ne sitenizdeki ne de pazaryerindeki ilan değişir.

PrestaShop stoğu nasıl hesaplar, senkronu ne etkiler?

PrestaShop stoğu üç ayrı kavramla izler ve pazaryerine açılabilecek adet bunlardan yalnız satılabilir stoktur. Kullanıcı kılavuzundaki formül şöyledir: fiziksel stok eksi rezerve stok eşittir satılabilir stok. Rezerve stok, müşteri siparişi verilmiş ama kargoya çıkmamış ürünlerden oluşur ve elle değiştirilemez.

Sitedeki adet depodaki sayıdan azsa önce açık siparişlerinize bakın; fark çoğu zaman rezerve stoktan gelir.

Stok yokken sipariş izni açık kalırsa

Ürün ayarlarındaki Stok tükenmiş ürünlerin siparişine izin ver seçeneği açıksa siteniz adet sıfıra indiğinde de sipariş almaya devam eder; bu davranış ürün bazında stock_availables kaydındaki out_of_stock alanıyla da değiştirilebilir. Pazaryeri ilanı sıfırda kapanırken sitenin satmaya devam etmesi, çok kanallı satışta fazla satışın en sık görülen PrestaShop kaynaklı sebebidir. Ön sipariş bilinçli olarak kullandığınız ürünler dışında bu izni kapalı tutun.

Paket ürünlerde stok düşme kuralı

PrestaShop paket ürünlerde varsayılan stok davranışı için üç seçenek sunar: yalnız paketin stoğunu düşürmek, yalnız paketteki ürünlerin stoğunu düşürmek ya da ikisini birden düşürmek; ayar paket bazında da değiştirilebilir. Yox İş Ortağım'da 5'li ve 10'lu paketler tek stok biriminden yönetilir, set satışında stok bileşenlerden düşer. Kurulumda iki taraftaki paket kuralının aynı mantıkla çalıştığını birlikte kontrol etmek, aynı satışın stoktan iki kez düşmesini önler.

PrestaShop siparişleri pazaryeri siparişleriyle tek listede

PrestaShop siparişleri bağlantıdan sonra pazaryeri siparişleriyle aynı listeye düşer ve hepsi aynı aşamalardan geçer: Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim. PrestaShop'un kendi tarafında ise siparişin anlamını durum ayarları belirler. Kullanıcı kılavuzuna göre her durumda siparişi onaylanmış, ödenmiş ya da kargolanmış sayma ve müşteriye e-posta gönderme seçenekleri ayrı ayrı işaretlenir; varsayılan renklerde mavi ödeme bekleyen, mor kargolanmış, koyu yeşil teslim edilmiş sipariştir.

• Geciken siparişler için uyarı alır, otomatik onay kuralıyla rutin siparişleri elle onaylamazsınız.
• Kendi kargo sözleşmenizle çalıştığınız firmayı bağlayıp barkod ve etiket üretebilirsiniz; desteklenen firmalardan biri için Yurtiçi Kargo entegrasyonu sayfasına bakabilirsiniz.
• Siparişe otomatik e-Arşiv ya da e-Fatura kesilebilir; toplu fatura ve etiket basılabilir.
• İade ve talepler tek kutuda toplanır.

Ödemesi beklenen siparişler stoğu nasıl etkiler?

Havale ya da kapıda ödeme gibi yöntemlerde sipariş, ödeme gelmeden önce oluşur. Bu siparişin ürünleri PrestaShop'ta açık sipariş olarak rezerve stokta durur; yani ödeme beklenirken de satılabilir stoktan düşmüş olur. Eski tarihli bu siparişleri düzenli temizlemek, gereksiz yere tükenmiş görünen ürünleri azaltır.

Yox İş Ortağım ile PrestaShop entegrasyonu nasıl kurulur?

Yox İş Ortağım'da PrestaShop, pazaryerleriyle aynı stok kartını paylaşan bir satış kanalı olarak bağlanır ve kurulum dört adımda tamamlanır. İsterseniz bütün adımları sizinle birlikte yapıyoruz; sunucu ayarlarını da birlikte gözden geçiririz.

1. Yox İş Ortağım'a başvurun; kısa bir ön görüşme ve 3 günlük ücretsiz denemeyle başlarsınız.
2. Web servis anahtarını oluşturup site adresinizle birlikte panele girin; PrestaShop ürünleriniz panele aktarılır.
3. Barkod ya da stok koduyla eşleşmeyen kayıtları düzeltin, ürünleri pazaryeri kategori ve özellikleriyle eşleştirin.
4. Pazaryerlerinin API bilgilerini ekleyip aynı ürünleri satışa açın; kanal başına fiyat kuralını tanımlayın ve ilk siparişleri tek listeden izleyin.

Bağlanabilen bütün kanalları ve firmaları Yox entegrasyon listesinde görebilirsiniz: 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması, 51 muhasebe, e-Fatura ve ERP programı.

PrestaShop ile pazaryeri fiyatı nasıl ayrılır, hangi paket gerekir?

Siteniz ile pazaryerleri arasında fiyat farkı, stok kartındaki ana fiyata kanal başına yüzde ya da tutar olarak eklenen bir kuralla kurulur. Pazaryerlerinde komisyon ve kargo kesintisi kategoriye göre değişir; güncel oranları her kanalın satıcı panelinden alıp komisyon hesaplama aracıyla kendi kâr eşiğinizi bulduktan sonra kuralı belirlemek doğru sıradır. Aşağıdaki rakamlar yalnız örnektir; komisyon oranı içermez.

Örnek fiyat kuralı hesabı

Yüzde kural kampanyadaki indirimi pazaryerine orantılı taşır; tutar kural ise düşük fiyatlı ürünlerde sabit kargo kesintisini karşılamakta daha öngörülebilirdir.

PrestaShop hangi pakette bağlanır?

PrestaShop Başlangıç paketinde yer almaz; Büyüme paketinden itibaren seçilir ve bir kanal hakkı sayılır. Ayrıntılı limitler paketler bölümünde yer alıyor; yıllık ödemede %20 indirim uygulanır.

PrestaShop bağlantısından önce kontrol listesi ve sık yapılan hatalar

PrestaShop sitesi pazaryerine bağlanmadan önce yapılan yarım saatlik bir kontrol, ilk haftadaki eşleşme ve fazla satış sorunlarının büyük kısmını önler. Aşağıdaki listeyi kendi sitenizde sırayla gözden geçirin; bir maddede takılırsanız bağlantıyı ertelemek yerine kurulumda birlikte çözebiliriz.

Bağlamadan önce kontrol edin

• Her kombinasyonun kendine ait, tekrarlanmayan referansı ya da EAN-13 barkodu var.
• Pazaryerindeki ilan barkodu ile PrestaShop'taki EAN-13 aynı.
• Web servis açık, anahtar etkin, izinler yalnız ürün, kombinasyon, stok ve sipariş kaynaklarında.
• Siteadresiniz/api/ adresi kullanıcı adı penceresi açıyor ve site HTTPS ile çalışıyor.
• Stok tükenmiş ürünlere sipariş izni yalnız bilinçli ön sipariş ürünlerinde açık.
• Eski tarihli, ödemesi gelmemiş siparişler temizlendi.

Sık yapılan hatalar

• Anahtara kolaylık olsun diye bütün kaynaklarda bütün yetkileri vermek.
• Bütün bedenleri ana ürünün tek referansına bağlamak; bir beden bitince diğerleri de satışa kapanır ya da biten beden satılmaya devam eder.
• Aynı ürünü hem PrestaShop modülünden hem panelden aynı pazaryerine göndermek.
• Kombinasyondaki fiyat etkisini satış fiyatı sanıp pazaryeri fiyatını yanlış kurmak.
• Paket stok kuralını iki tarafta farklı bırakmak ve stoğun iki kez düşmesine yol açmak.