ShopPHP entegrasyonu:
siteniz ve pazaryerleri aynı stokta.

ShopPHP entegrasyonu nedir, ShopPHP sitesi neden ayrıca bağlanır?

ShopPHP entegrasyonu, sitenizi pazaryerlerinden ayrı bir ada gibi yönetmek yerine aynı stok sayısını paylaşan bir satış kanalına dönüştürür. ShopPHP'nin hakkımızda sayfasına göre yazılım 2005'ten bu yana Kadıköy merkezli Creamedia Yazılım tarafından geliştiriliyor; tek seferlik ödemeyle süresiz lisanslanıyor, yıllık kira ya da satış komisyonu alınmıyor. Güncel sürüm hattı v5'tir (v5.70, 7 Ekim 2026).

Kendi sunucuda çalışan altyapının bağlantıya etkisi

ShopPHP'de yazılım ve veritabanı sizin sunucunuzda ya da tercih ederseniz ShopPHP sunucularında çalışır ve lisans tek bir alan adına tanımlanır. Pratik sonucu şudur: dış sistemlerin siteye erişimini siz ya da hosting firmanız açarsınız. ShopPHP'nin SSS sayfası kurulum için PHP 8.x ve ionCube 12.0 ya da üstünü şart koşar; yardım arşivi de web servis kullanan modüller için PHP SOAP eklentisinin açık olması gerektiğini yazar.

Ayrı bir bağlantı paneline genellikle şu durumlarda ihtiyaç doğar:

• Siteniz dışında en az bir pazaryerinde aynı ürünleri satıyor ve son kalan ürünün iki kanalda birden satılmasından çekiniyorsanız
• ShopPHP'nin pazaryeri modülleri dokuz pazaryeriyle sınırlı olduğu için idefix, Etsy ya da Allegro gibi listede bulunmayan kanallara açılmayı planlıyorsanız
• Site ve pazaryeri siparişlerini, kargo etiketini ve faturayı tek listeden yürütmek istiyorsanız

Bağlanabilen pazaryeri, kargo ve muhasebe firmalarının tamamını entegrasyonlar ana sayfasında görebilirsiniz.

ShopPHP lisansı, REST API ve modül ücretleri (Ekim 2026)

ShopPHP'de entegrasyon maliyetinin büyük kısmı lisansa ek olarak alınan modüllerden gelir. Resmî paket sayfasındaki fiyatlar tek seferlik ve KDV hariçtir; sayfa fiyatlara %20 KDV eklendiğini belirtir. Bütün paketlerde 1 yıl teknik destek ve güncelleme dosyalarına erişim dahildir.

Hangi ShopPHP modülü şart, hangisi isteğe bağlı?

Yox İş Ortağım bağlantısı için sitenizde REST API modülünün açık olması gerekir. Pazaryeri ve kargo API modüllerini almak zorunda değilsiniz, çünkü pazaryerleri ve kargo firmaları panelde ayrıca bağlanır. Mevcut pazaryeri modüllerini aşağıdaki sırayla kanal kanal devre dışı bırakabilirsiniz. Tutarlar ShopPHP'nin 13 Ekim 2026'daki paket sayfasından alınmıştır; satın almadan önce güncel fiyatı ShopPHP'den teyit edin.

ShopPHP REST API modülü: entegrasyon için API kullanıcısı nasıl hazırlanır?

ShopPHP REST API, ürün, kategori, marka, sipariş ve kullanıcı verisini dış sistemlerin okuyup yazabilmesi için açılan servis katmanıdır ve yönetici şifrenizi kimseyle paylaşmadan bağlantı kurmanızı sağlar. ShopPHP'nin resmî REST API sayfasındaki hazırlık şöyle ilerler:

1. Yönetim panelinde yalnız bu bağlantı için admin statüsünde yeni bir kullanıcı açın; entegrasyona ayrılmış bir e-posta adresi kullanmak takibi kolaylaştırır.
2. Kullanıcıyı bir bayi grubuna atayın ve o grupta “Rest API kullanabilir” seçeneğini işaretleyin. ShopPHP'ye göre sistemde bu seçeneği işaretli en az bir grup varsa API kullanıcısının böyle bir grupta olması zorunludur.
3. “XML veya Rest API Kullanabileceği IP'ler” alanını kullanacaksanız bağlantının geleceği adresi ekleyin; alan boş kalırsa IP kısıtı uygulanmaz.
4. Bu kullanıcının erişim bilgilerini Yox İş Ortağım'daki ShopPHP bağlantı ekranına girin ya da adımları birlikte yapmak için ön görüşme isteyin.

auth_key nasıl üretilir, şifre değişince ne olur?

ShopPHP'de her REST isteği auth_email ve auth_key alanlarıyla gönderilir. Resmî dokümana göre auth_key, şifrenin MD5 özeti e-posta adresiyle birleştirilip yeniden MD5'lenerek üretilir. Bu yüzden API kullanıcısının şifresini değiştirdiğiniz anda anahtar da değişir ve bağlantı bilgisinin yeniden girilmesi gerekir.

Yanıt biçimi ve toplu işlem sınırları

REST yanıtları varsayılan olarak XML döner; JSON için format parametresi ya da Accept başlığı kullanılır. Dokümana göre toplu fiyat-stok güncelleme ucu tek istekte 200 ürüne kadar kabul eder, ürün listesi de aralık parametreleriyle sayfalanabilir.

ShopPHP'de veri hangi yoldan akar: REST API, XML çıktıları ve tedarikçi XML'i

ShopPHP'de dış sistemlerle veri alışverişi yapan üç ayrı mekanizma vardır ve yalnız REST API iki yönlü çalışır. XML çıktıları sitenizdeki ürünleri karşılaştırma sitelerine ve iş ortaklarına okutur; tedarikçi XML modülleri ise dışarıdan gelen ürünü ve stoğu sitenize yazar. Tablo ShopPHP'nin resmî modül sayfalarındaki tanımlara dayanır:

XML önbelleği stok bilgisini nasıl geciktirir?

XML servisleri sayfasına göre çıktılar panelde girilen önbellek süresi boyunca aynı dosyadan okunur; süre 0 girilirse her istekte yeniden üretilir. Akakçe ya da Cimri'ye giden çıktıda önbellek uzunsa, sitede tükenen ürün o süre boyunca dışarıda stokta görünebilir.

Tedarikçi XML'i kullanıyorsanız stok kaynağını tek tutun

Dropshipping ya da toptancı ürünleri ShopPHP'ye tedarikçi XML'iyle geliyorsa, aynı ürünün stoğunu hem tedarikçi akışı hem pazaryeri satışları değiştirir. Yox İş Ortağım'da tedarikçi XML/CSV akışı Büyüme paketinden itibaren tanımlanabildiği için akışı panele taşıyıp ShopPHP'deki cron'u durdurmak bir seçenektir. Akışı ShopPHP'de bırakacaksanız son yazan sistemin sayısı geçerli olur; hangisinin esas alınacağını kurulumda birlikte kararlaştırırız.

Ürün verisini hazırlamak: GTIN, varyasyon kodu ve KDV dahil fiyat

Yox İş Ortağım mevcut ürünlerinizi barkod ya da stok koduyla eşleştirir; ShopPHP tarafında bu bilgiler ürün kartındaki GTIN alanında ve varyasyon satırlarının stok kodu ile barkodunda durur. REST dokümanına göre gtin alanı GTIN, EAN, UPC ya da ISBN türünde bir barkod taşır; varyasyonlar da kendi stok kodunu ve barkodunu ayrı tutar.

İki seviyeli varyasyonlarda her kombinasyona ayrı barkod

ShopPHP'nin REST dokümanı, altyapının iki seviyeli (X-Y) varyasyon kombinasyonunu desteklediğini yazar. Pazaryerlerinde her beden-renk kombinasyonu ayrı bir satırdır, bu yüzden ShopPHP'de de her kombinasyonun kendi barkodu olmalıdır.

Rastgele GTIN aracı neden geçici bir çözümdür?

ShopPHP'nin Teknik İşlemler menüsünde, GTIN'i olmayan ürün ve varyasyonlara algoritmik değer atayan bir araç bulunur. ShopPHP'nin kendi yardım sayfası bunun geçici bir çözüm olduğunu ve servislere gerçek GTIN değerinin iletilmesi gerektiğini belirtir. Üretilmiş bir kod pazaryerindeki ilanınızın barkoduyla tutmaz, eşleşme elle yapılır. Şüpheli kodların kontrol hanesini barkod hesaplama aracıyla doğrulayabilirsiniz.

• ShopPHP yardım arşivine göre fiyatlar KDV dahil girilir ve kuruş ayıracı nokta olmalıdır; ayıraç hatası bütün kanallarda yanlış fiyat demektir.
• Ürünün sitede görünmesi için aktif olması, kategorisinin ve markasının tanımlı olması gerekir; eksik kartları bağlantıdan önce tamamlayın.

ShopPHP pazaryeri modülleri ile Yox İş Ortağım birlikte nasıl kullanılır?

ShopPHP'nin Trendyol, Hepsiburada, N11, Amazon, ÇiçekSepeti, Pazarama, Temu Türkiye, E-PTT Avm ve AllesGo için pazaryeri başına satılan API modülleri vardır. Yardım arşivine göre bu modüllerde stok, fiyat ve sipariş akışı sunucuda tanımlanan cron adreslerine bağlıdır ve önerilen çağrı sıklığı 5 dakikadır. Aynı pazaryeri hesabını hem modülle hem Yox İş Ortağım'la yönetirseniz iki sistem aynı ilanın stoğunu ayrı ayrı yazar.

Geçişi kanal kanal yapmak

• Önce tek bir pazaryeri seçin; örneğin Trendyol entegrasyonu sayfasındaki kanal kurallarına bakıp Trendyol'u panele taşıyın.
• O pazaryerinin ShopPHP'deki ürün-stok ve sipariş cron adreslerini durdurun ya da modülü pasife alın; diğer modüller çalışmaya devam edebilir.
• Pazaryeri panelinin bildirim (webhook) alanına ShopPHP adresi girdiyseniz onu da kaldırın; siparişin iki sisteme birden düşmesini bu adım önler.
• Birkaç gün siparişleri izledikten sonra Hepsiburada gibi diğer kanalları aynı sırayla taşıyın.

ShopPHP stok ve fiyat senkronu: sepet ayarı ve kanal fiyat farkı

ShopPHP entegrasyonu kurulduğunda stok tek ürün kartında tutulur ve ShopPHP sitesi bu kartı kullanan kanallardan biri olur. ShopPHP tarafında stoğun hangi anda düştüğünü belirleyen ayarı bilmek, kanallar arasında kısa süreli görünen farkları açıklar.

Sepet Zaman Aşımı ayarı stoğu nasıl etkiler?

ShopPHP yardım arşivine göre Pazarlama > Yarım Kalan Sepetler > Sepet Ayarları altındaki Sepet Zaman Aşımı (Saniye) değeri 0'dan büyükse ürün sepete eklendiğinde stok rezerve edilir ve süre dolunca geri verilir. Değer 0 ise stok yalnız ödeme onaylandığında düşer; sepet sayfası yalnız satış öncesi doğrulama yapar. Rezervasyon açıkken sepette bekleyen ürünler ShopPHP'deki sayıyı geçici olarak düşürür. Hangi modu kullandığınızı kurulumda belirtin; sayılar arasındaki kısa süreli farkın sebebi çoğu zaman budur.

Örnek kanal fiyatı hesabı

Kanal başına yüzde ya da tutar farkı ana fiyattan türetilir. ShopPHP fiyatları KDV dahil tuttuğu için farkı da KDV dahil fiyat üzerinden düşünün. Aşağıdaki kurallar yalnız örnektir:

Gerçek komisyon kategoriye göre değişir; güncel oranı satıcı panelinizden alın ve kesinti sonrası elinizde kalan tutarı komisyon hesaplama aracıyla kontrol edin. Ana fiyatı değiştirdiğinizde kanal fiyatları aynı kurala göre yeniden hesaplanır.

ShopPHP siparişleri, kargo ve fatura akışı

ShopPHP siparişleri Yox İş Ortağım'da pazaryeri siparişleriyle aynı listeye Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim aşamalarıyla düşer. ShopPHP tarafında ise her siparişin sayısal bir durum kodu vardır; REST dokümanında geçen temel kodlar şunlardır:

Sitenize özel durumlar eklediyseniz bunları kurulumda birlikte gözden geçiririz.

Kargo etiketi ve faturayı tek sistemden kesin

ShopPHP'nin kargo API modülü 15 kargo firmasına gönderi bilgisi iletip barkod basabiliyor; muhasebe tarafında da program ve aracı firma entegrasyonları bulunuyor. Yox İş Ortağım'da kendi kargo sözleşmenizle barkodlu etiket basılır, takip numarası siparişe işlenir ve siparişe e-Arşiv ya da e-Fatura düzenlenir. Aynı siparişe iki etiket ya da iki fatura çıkmaması için her adımı tek sistemde bırakın.

Yox İş Ortağım'da ShopPHP hangi pakette, kurulum nasıl ilerler?

Yox İş Ortağım'da ShopPHP siteniz bir satış kanalı sayılır ve Başlangıç paketinde seçilemez; Başlangıç'ın tek kanalı Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ya da idefix'ten biri olmak zorundadır.

Büyüme paketinde ShopPHP sitenize ek olarak iki pazaryeri bağlanır. Yıllık ödemede %20 indirim uygulanır; bütün limitler paket karşılaştırmasında yer alır.

Kurulum sırası

1. Yox İş Ortağım'a başvurun; süreç 3 günlük ücretsiz deneme ve isteğe bağlı kısa bir ön görüşmeyle başlar.
2. ShopPHP'de REST API modülünü, API kullanıcısını ve gerekiyorsa IP iznini hazırlayın.
3. Erişim bilgilerini panele girin; ürünleriniz gelir ve barkod ya da stok koduyla eşleşme önerilir.
4. Eşleşmeyen ürünleri düzeltip pazaryeri kategorileriyle eşleştirin; siz onaylamadan hiçbir ürün değişmez.
5. Kanal fiyat kurallarını tanımlayın, ilk pazaryerini açın ve ShopPHP'deki ilgili modülün cron'unu durdurun.
6. İlk siparişleri tek listeden izledikten sonra diğer kanalları ekleyin.

ShopPHP entegrasyonu öncesi kontrol listesi ve sık yapılan hatalar

ShopPHP entegrasyonunda sorunların çoğu bağlantı anında değil, sitede yıllar içinde biriken ayar ve veri alışkanlıklarından çıkar.

Bağlamadan önce kontrol edin

• REST API modülü açık; API kullanıcısı admin statüsünde ve “Rest API kullanabilir” işaretli bir bayi grubunda.
• IP listesi doluysa bağlantı adresi ekli; hosting güvenlik duvarı dışarıdan gelen istekleri engellemiyor.
• Her varyasyonda gerçek ve tekil barkod var; rastgele GTIN aracıyla üretilmiş kodlar ayıklandı.
• Sepet Zaman Aşımı ayarının hangi modda olduğu biliniyor.
• Sitedeki stok sayıları gerçek sayımla eşitlendi.

Sık yapılan hatalar

• API kullanıcısının şifresini habersiz değiştirmek: auth_key değişir ve bağlantı durur.
• Pazaryeri cron'unu açık bırakmak: ShopPHP modülü ile panel aynı ilanı ayrı ayrı günceller, sayılar birbirini ezer.
• XML önbelleğini uzun tutmak: karşılaştırma sitelerinde tükenmiş ürün satışta görünür.
• Sürüm güncellemesini kurulumla aynı haftaya koymak: ShopPHP yardım arşivinde v5 güncellemesinden sonra cron servislerinin çalışmamasına dair ayrı bir başlık var; iki değişiklik aynı anda yapılırsa sorunu ayırmak zorlaşır.