OpenCart entegrasyonu:
siteniz ve pazaryerleri aynı stokta.

OpenCart entegrasyonu nedir, hangi satıcıya gerekir?

OpenCart entegrasyonu, kendi alan adınızda OpenCart ile satış yaparken aynı ürünleri Trendyol, Hepsiburada ya da başka pazaryerlerinde de satıyorsanız, stoğun her yerde tek bir sayıdan düşmesini sağlayan yapıdır. OpenCart'ın GitHub deposunda kendisini tanımladığı biçimiyle ücretsiz, açık kaynaklı ve PHP tabanlı bir e-ticaret çözümüdür; lisansı GNU GPL sürüm 3'tür. Bu esneklik, mağazanın barındırma, sürüm ve eklenti tercihlerinin tamamen size ait olduğu anlamına gelir; entegrasyonun sağlığı da büyük ölçüde bu tercihlere bağlıdır.

Siteniz tek kanalsa entegrasyona ihtiyacınız yoktur. İhtiyaç, ikinci bir satış kanalı açıldığında başlar: son kalan ürün sitede satılırken pazaryerindeki ilan açık kalır ve aynı ürün iki kez satılır. Ayda birkaç siparişin ötesine geçen her çok kanallı OpenCart mağazası için stoğun elle eşitlenmesi süreklilik taşımayan bir yöntemdir.

Sitenin içine kurulan modül mü, harici panel mi?

OpenCart'ta pazaryeri bağlantısı iki yoldan kurulur. Birincisi, sitenin dosyalarına yüklenen ve genellikle tek bir pazaryerine bağlanan modüllerdir; sürüm uyumu, tema çakışması ve güncelleme sorumluluğu sitede kalır. İkincisi, siteyi API ile dışarıdan okuyan bir paneldir; site yalnız bir satış kanalı olur ve pazaryerleriyle aynı stok kartından beslenir. Yox İş Ortağım ikinci yaklaşıma dayanır: site, pazaryerleriyle aynı stok kartından beslenen bir kanal olur ve bağlantı OpenCart'ta oluşturduğunuz API anahtarıyla kurulur.

• Siteniz ve pazaryerleriniz aynı ürünleri satıyorsa: stok tek karttan yönetilmelidir.
• Ürünlerinizi yalnız sitede tutup pazaryerine açmak istiyorsanız: önce ürün aktarımı ve kategori eşleştirmesi gerekir.
• Siparişleri farklı panellerden toplamaktan yorulduysanız: site ve pazaryeri siparişleri tek listede birleşir.

OpenCart sürümleri, lisansı ve sunucu gereksinimleri (Ekim 2026)

OpenCart'ın hangi sürümünü kullandığınız, ürün yapısının ve API ekranının nasıl göründüğünü belirler; bu yüzden bağlantıdan önce yönetim panelinin alt kısmında yazan sürüm numarasını not edin. Resmî GitHub sürüm sayfasına göre iki dal paralel güncelleniyor:

3.x'ten 4.x'e geçmeyi düşünüyorsanız sırayı doğru kurun

OpenCart'ın yükseltme belgesi, 3.x'ten 4.x'e geçmeden önce dosya ve veritabanı yedeği almayı, önce bir deneme ortamında test etmeyi ve eklentilerin OpenCart 4 uyumunu kontrol etmeyi şart koşar. Entegrasyon açısından öneri basittir: sürüm yükseltmesini bağlantıdan önce ya da en az bir hafta sonra yapın, ikisini aynı güne sıkıştırmayın. Yükseltmeden sonra ürün kodlarının ve stok sayılarının korunduğunu birkaç üründe kontrol edin; sorun varsa eşleşme ekranında hemen görünür.

OpenCart entegrasyonu için API kullanıcısı nasıl oluşturulur?

OpenCart'ta dış sistemlerin siteye erişimi, yönetici hesabından ayrı bir API kullanıcısıyla verilir; böylece yönetici şifrenizi kimseyle paylaşmazsınız ve erişimi tek tıkla kapatabilirsiniz. OpenCart'ın API belgesindeki ekrana göre adımlar şöyledir:

1. Yönetim panelinde Sistem > Kullanıcılar > API (System > Users > APIs) menüsünü açın ve Yeni Ekle (Add New) düğmesine basın.
2. API Kullanıcı Adı alanına 3-20 karakter uzunluğunda, amacını anlatan bir ad yazın; belge bağlantının amacını anlatan adları önerir.
3. OpenCart'ın ürettiği anahtarı (64-256 karakter) kaydetmeden önce kopyalayıp güvenli bir yere saklayın.
4. Durum (Status) seçeneğini Etkin yapın; erişimi ileride silmeden kapatmak için de bu alanı kullanırsınız.
5. İzinli IP listesi (Allowed IPs) kullanıyorsanız bağlantının geleceği adresi ekleyin; adresi kurulum sırasında birlikte kontrol ediyoruz.
6. Kaydedin ve anahtarı Yox İş Ortağım'daki OpenCart bağlantı ekranına girin.

Anahtar yalnız bir kez gösterilir

OpenCart belgesi açıkça uyarır: anahtar kaydedildikten sonra bir daha görüntülenemez ve kaybedilirse yenisinin üretilmesi gerekir. Yeni anahtar ürettiğinizde eski anahtarla çalışan bağlantı durur; bu yüzden anahtarı yenilediğiniz gün panele de yeni değeri girin.

Geçmiş (History) sekmesiyle bağlantıyı izlemek

API formundaki Geçmiş sekmesi, anahtarla yapılan her çağrıyı uç nokta, kaynak IP ve tarihle listeler. Bağlantı beklenmedik biçimde durduğunda ilk bakılacak yer burasıdır: çağrılar hiç görünmüyorsa sorun büyük olasılıkla IP listesi ya da pasif durumdaki anahtardır. Sitede genel bir hata varsa OpenCart'ın Sistem > Bakım > Hata Kayıtları ekranı da teşhise yardımcı olur.

Ürün verisini hazırlamak: Model, SKU, EAN ve stok alanları

OpenCart pazaryeri entegrasyonunda eşleşmenin kalitesini bağlantı değil, ürün formundaki kod alanlarının düzeni belirler. Yox İş Ortağım mevcut ürünleri barkod ya da stok koduyla eşleştirir; kodu boş ya da iki üründe tekrar eden kayıtlar eşleşmez ve elle düzeltme ister. OpenCart'ın ürün formu ve ürün tanımlayıcıları belgelerine göre ilgili alanlar şunlardır:

Barkod hatalarını bağlantıdan önce yakalamak

EAN-13 kodunun son hanesi kontrol hanesidir; bir rakamı yanlış girilen barkod pazaryerinde başka bir ürüne denk gelebilir ya da reddedilir. Şüpheli kodları barkod kontrol hanesi hesaplama aracıyla doğrulayın. Ağırlık ve ölçü alanları boş olan ürünlerde kargo bedelini tahmin etmek zorlaşır; pazaryerinin desi tabanlı kargo kesintisini önceden görmek için desi hesaplama aracını kullanabilirsiniz.

• Aynı EAN'ın iki üründe kullanılıp kullanılmadığını katalog dışa aktarımında sıralayarak kontrol edin.
• SKU'larda boşluk ve özel karakter kullanmayın; belge yalnız harf, rakam ve tire önerir.
• Stok durumu (Stock Status) metni yalnız müşteriye gösterilen etikettir; asıl sayı Miktar alanındadır.

OpenCart'ta seçenekler ve varyantlar pazaryeriyle nasıl eşleşir?

OpenCart'ta beden, renk ya da malzeme farkı iki farklı yapıyla tanımlanabilir ve hangisini kullandığınız stok eşleşmesini doğrudan etkiler. Pazaryerlerinde her beden-renk kombinasyonu genellikle kendi barkodu olan ayrı bir satırdır; OpenCart tarafında da her kombinasyonun kendine ait bir kodu olması gerekir.

Seçenek (option) yapısı

OpenCart'ın seçenekler belgesi, Açılır liste, Radyo, Onay kutusu, Metin, Dosya, Tarih gibi seçenek türlerini anlatır ve seçenek değerlerine fiyat, ağırlık ve ödül puanı farkı verilebildiğini belirtir. Seçenekler Katalog > Seçenekler menüsünden oluşturulur ve ürün formundaki Seçenek sekmesinden ürüne atanır. Bu yapı müşteri seçimi için tasarlanmıştır; her seçenek değerine ayrı barkod tanımlamak için kurulmamıştır. Metin ya da dosya yükleme gibi kişiselleştirme seçenekleri ise pazaryerinde karşılığı olmayan alanlardır.

OpenCart 4 ana ürün ve varyant yapısı

OpenCart 4 belgeleri, ortak bilgileri tutan bir ana ürün (master) ve her kombinasyon için ayrı bir varyant ürün tanımlar. Varyant; ad, açıklama, kategori, özellik ve SEO bilgilerini ana üründen devralır, ancak Model/SKU, fiyat, stok adedi, stoktan düşme ayarı, stok durumu, ölçüler, ağırlık ve durum alanlarını kendine göre değiştirebilir. Belge açıkça stoğu ana ürün düzeyinde değil, varyant düzeyinde takip etmeyi önerir.

• Pazaryerinde ayrı satılan her kombinasyon için OpenCart'ta ayrı SKU ve EAN bulunmalı.
• OpenCart 4 kullanıyorsanız çok varyantlı ürünlerde varyant yapısı eşleşmeyi kolaylaştırır.
• 5'li ya da 10'lu paketleri ayrı ürün gibi açtıysanız panelde paket stoğu olarak tek stok biriminden düşecek şekilde tanımlayabilirsiniz.

Aşırı satışı önleyen OpenCart stok ve sipariş ayarları

OpenCart'ta bazı varsayılan ayarlar tek kanallı mağaza için zararsızdır ama çok kanallı satışta stok sayısını anlamsız hâle getirir. En kritik iki ayar, ürün formundaki Stoktan Düş ile mağaza ayarlarındaki Stoksuz Ödeme (Stock Checkout) seçeneğidir. Aşağıdaki tablo OpenCart belgelerindeki tanımları ve çok kanallı satış için önerimizi bir arada verir:

Sipariş durumları stoğu nasıl etkiler?

OpenCart'ın siparişler belgesi yerleşik durumları Beklemede (Pending), İşleniyor (Processing), Kargolandı (Shipped), Tamamlandı (Complete), İptal (Canceled), Reddedildi (Denied), Başarısız (Failed) ve İade Edildi (Refunded) olarak listeler. Sipariş durumları belgesine göre iptal durumu, stoktan yapılan düşüşleri geri almak için kullanılır; tamamlandı durumu ise ortaklık komisyonu ve ödül puanı gibi işlemleri tetikler. Bu nedenle iptal edilen site siparişini başka bir duruma değil, gerçekten iptal durumuna çekin; aksi hâlde düşen stok geri gelmez ve pazaryerinde ürün tükenmiş görünür.

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

Yox İş Ortağım'da OpenCart, pazaryerleriyle aynı ürün kartını kullanan bir satış kanalıdır: sitenizdeki ürünler panele aktarılır, aynı kartlardan pazaryerlerine ilan açılır ve satış hangi kanalda olursa olsun stok her yerde düşer. Kurulum sırası:

1. Yox İş Ortağım'a başvurun; 3 günlük ücretsiz deneme ve isterseniz kısa bir ön görüşmeyle başlarsınız.
2. OpenCart'ta API kullanıcısını oluşturup anahtarı panele girin.
3. Ürünleriniz panele gelir; barkod ya da stok koduyla eşleşmeyen kayıtları düzeltin.
4. Ürünleri pazaryeri kategorileriyle eşleştirin; siz onaylamadan hiçbir ürün değişmez.
5. Pazaryeri API bilgilerini girip aynı ürünleri satışa açın; kanal kuralları için Trendyol entegrasyonu ve Hepsiburada entegrasyonu sayfalarına bakabilirsiniz.
6. Kanal başına fiyat kuralını tanımlayıp ilk siparişleri tek listeden izleyin.

Elle yönetim ile panelle yönetimin farkı

Kargo ve fatura da aynı akıştan yürür; ancak kargo entegrasyonu Büyüme, e-Fatura Profesyonel paketinden itibaren pakete dahildir. Bağlanabilen firma ve programların tamamını entegrasyonlar ana sayfasında görebilirsiniz.

OpenCart site fiyatı, pazaryeri fiyatı ve paket seçimi

Sitenizde pazaryeri komisyonu ödemediğiniz için OpenCart fiyatını pazaryeri fiyatının altında tutmak satıcıların sık kullandığı bir yöntemdir. Yox İş Ortağım'da bunu kanal başına yüzde ya da tutar farkıyla ana fiyattan türetirsiniz; ana fiyat değiştiğinde kanal fiyatları bu kurala göre yeniden hesaplanır.

Örnek fiyat kuralı hesabı

Oranlar örnektir; gerçek komisyon kategoriye göre değişir ve güncel oran satıcı panelinizde yazar. Düşük fiyatlı ürünlerde yüzde farkı sabit kargo kesintisini karşılamayabilir, pahalı ürünlerde ise gereğinden fazla büyür. Kesinti sonrası kalan tutarı komisyon hesaplama aracıyla kontrol edin.

OpenCart hangi pakette bağlanır?

OpenCart siteniz bir kanal sayılır; Büyüme paketinde site artı iki pazaryeri bağlanır. Profesyonel paketin 28 kanallık listesinde OpenCart'ın durumunu ön görüşmede birlikte kontrol ediyoruz. Yıllık ödemede %20 indirim uygulanır; ayrıntılı karşılaştırma paketler bölümünde.

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

OpenCart entegrasyonunda yaşanan sorunların çoğu bağlantıdan değil, sitedeki veri ve ayar düzensizliğinden doğar. Bağlamadan önce aşağıdaki listeyi bir kez gözden geçirmek ilk haftanın düzeltme işini belirgin biçimde azaltır.

Bağlamadan önce kontrol edin

• OpenCart sürümünüzü ve PHP sürümünüzü biliyorsunuz; PHP 8.0 ya da üstü çalışıyor.
• Her ürün ve varyantta tekil SKU, satılan her kombinasyonda pazaryeriyle aynı EAN var.
• Stock Checkout Hayır, Subtract Stock her üründe Evet.
• İptal edilen siparişler gerçekten İptal durumuna çekiliyor.
• API kullanıcısı Etkin; IP listesi kullanılıyorsa bağlantı adresi ekli.
• Sitedeki stok sayıları bağlantı öncesi gerçek sayımla eşitlendi.

Sık yapılan hatalar

• Eski pazaryeri modülünü açık bırakmak: sitedeki modül ile panel aynı stoğu ayrı ayrı güncellerse birbirinin yazdığını ezer; modülün stok güncellemesini kapatın.
• Anahtarı kopyalamadan kaydetmek: OpenCart anahtarı bir daha göstermez, yenisini üretmeniz gerekir.
• Seçenekli ürünlerde kodu boş bırakmak: kombinasyonlar ayrı ayrı tanınmaz, stokları karışır.
• Sürüm yükseltmesini kurulumla aynı güne koymak: sorunun kaynağını ayırmak zorlaşır.