OpenCart Hepsiburada Entegrasyonu: Kurulum ve Günlük Kullanım Rehberi
OpenCart Hepsiburada entegrasyonu, OpenCart sitenizdeki ürünlerin stok, fiyat ve siparişlerinin Hepsiburada mağazanızla aynı stoktan yönetilmesidir. OpenCart'ın kendi API'si ürün ve stok yönetmediği için siteye bir köprü dosyası yüklenir; Hepsiburada'da Mağaza ID ve servis anahtarı alınır. Hepsiburada'da satış "listing" ile yapılır: katalogdaki ürün (HB SKU) sizin stok kodunuzla (merchantSku) eşleşir, stok ve fiyat bu kayda gider.
OpenCart tarafı: neden köprü dosyası?
OpenCart'ın yönetim panelindeki API (Sistem → Kullanıcılar → API) yalnız satış tarafını (sepet, sipariş) kapsar; ürün, stok ve fiyat yönetimi içermez. Bu yüzden entegrasyon programları siteye küçük bir köprü dosyası yükler. Cube Entegre'nin köprüsü (cube_bridge.php) OpenCart'ın kendi veritabanı ayarlarıyla çalışır, her istekte köprü anahtarıyla korunur; OpenCart 2.x, 3.x ve 4.x ile uyumludur.
Hepsiburada tarafı: listing ve HB SKU
Hepsiburada'da ürün kartı katalogdadır ve HB SKU (ör. HBV0000…) ile tanınır. Sizin satışınız bu karta bağlanan bir "listing"dir: HB SKU + sizin stok kodunuz (merchantSku) + fiyat + stok. Entegrasyonda eşleştirme şöyle olur:
- Listing'in merchantSku'su uygulamadaki stok kodunuzla aynıysa otomatik bağlanır.
- Katalogda ürünü olup listing'i olmayan ürününüze HB SKU yazarak listing'i uygulamadan açabilirsiniz.
- Katalogda hiç olmayan ürün için kart, Hepsiburada'nın kendi süreciyle (Merchant Portal) açılır.
Kurulum adımları
- OpenCart'ı bağlayın: Uygulama köprü dosyasını sizin anahtarınızla hazırlar; dosyayı sitenizin ana klasörüne yükleyip site adresini girin ve bağlantıyı test edin.
- Hepsiburada'yı bağlayın: Merchant Portal'daki Mağaza ID ve servis anahtarını girin. Ayrıntı: Hepsiburada API bilgileri nasıl alınır?
- Stok kodlarını eşitleyin: OpenCart'ta stok kodu olarak ürünün "model" alanı (boşsa SKU) kullanılır; Hepsiburada listing'lerindeki merchantSku ile uygulamadaki stok kodu aynı olmalı.
- Fiyat formüllerini kurun: Site için sanal POS ve kargo, Hepsiburada için komisyon, kargo ve hizmet bedeli.
- Otomatik gönderimi açın: Stok ve fiyat seçtiğiniz aralıkla iki kanala gider.
Günlük kullanım
- Siparişler: OpenCart ve Hepsiburada siparişleri tek listede. OpenCart'ta uygulamadan seçtiğiniz duruma karşılık gelen OpenCart durumunu ayarlardan belirlersiniz; Hepsiburada'da paketleme ve satıcı iptali uygulamadan yapılır.
- Stok: Bir kanaldaki satış diğerinin stoğunu düşürür; iptal ve iadede geri eklenir.
- İadeler: Hepsiburada iade talepleri uygulamadan onaylanır ya da reddedilir; OpenCart iade talepleri de uygulamada görünür.
- Müşteri soruları: Hepsiburada soruları diğer kanallarla aynı kutuda, yapay zekâ cevap taslağıyla.
Sık karşılaşılan sorunlar
| Sorun | Çözüm |
|---|---|
| Hepsiburada'daki ürün stoğu değişmiyor | Listing'in merchantSku'su uygulamadaki stok koduyla aynı değildir; eşleştirin. |
| OpenCart bağlantı testi başarısız | Köprü dosyası sitenin ana klasöründe mi ve site adresi doğru mu kontrol edin; anahtarı değiştirdiyseniz dosyayı yeniden yükleyin. |
| OpenCart fiyatı KDV'li / KDV'siz karışıyor | OpenCart fiyatı genelde KDV hariç tutar; uygulamadaki "KDV hariç" ayarını sitenize göre seçin. |
OpenCart entegrasyonu · Hepsiburada entegrasyonu · Stok senkronizasyonu
Sık sorulanlar
OpenCart'ın kendi API'si entegrasyon için yeterli mi?
Hayır. OpenCart'ın API'si yalnız sepet ve sipariş işlemlerini kapsar; ürün, stok ve fiyat yönetimi için siteye köprü dosyası yüklenir.
Hepsiburada'ya yeni ürün kartı açılabilir mi?
Hepsiburada'da ürün kartı katalogdadır. Katalogda olan ürüne HB SKU ile listing açılabilir; katalogda olmayan ürünün kartı Hepsiburada'nın kendi süreciyle açılır.
Hangi OpenCart sürümleri destekleniyor?
Cube Entegre'nin köprüsü OpenCart 2.x, 3.x ve 4.x ile çalışır.
Mağazalarınıza uygun kurulumu ücretsiz canlı demoda birlikte inceleyelim.
