HBWC Full Hepsiburada Woocommerce otomasyon+entegrasyon eklentisi

HPWC (Hepsiburada WooCommerce Integration) – Tam Otomasyon & Entegrasyon Eklentisi
WooCommerce mağazanızı Hepsiburada ile tam entegre eder; ürün, fiyat, stok, sipariş, kargo, iade/claim ve webhook süreçlerini tek panelden yönetmenizi sağlar. Kurulum sonrası kategori–özellik eşleştirmeleriyle birlikte otomatik senkron akışları devreye girer ve satış kanalı operasyonlarınızı ciddi ölçüde hızlandırır.

✅ Genel Bakış (Ne İşe Yarar?)
WooCommerce ürünlerinizi Hepsiburada’ya tek tıkla gönderir.
Fiyat ve stok değişikliklerini otomatik algılar ve Hepsiburada’ya otomatik günceller.
Hepsiburada siparişlerini çeker, WooCommerce siparişine dönüştürür ve paket süreçlerini yönetir.
Kargo/teslimat bildirimlerini Hepsiburada’ya otomatik iletir.
Claim / talep süreçlerini (awaiting action) panelden yönetmenizi sağlar.
Webhook altyapısı ile “anlık olayları” yakalayıp kuyruğa alır; yük altında bile stabil çalışır.
Log / queue / health check ekranlarıyla prod ortamında destek ve hata ayıklamayı kolaylaştırır.

✅ Kurulum ve İlk Yapılandırma
WooCommerce menüsü altında özel yönetim paneli (HBWC/HPWC).
API erişim alanları üzerinden Hepsiburada bağlantısı.
Ortam (environment) seçimi.
Merchant bilgileri ve gerekli kimlik alanları tek yerden yönetilir.
Webhook güvenliği için kullanıcı/şifre tanımlama (açık endpoint riski yok).
Ayarlar kaydı AJAX ile yapılır; sayfa yenilemeden işlemler hızlıdır.

✅ Kâr Marjı (Profit Margin) Özelliği
WooCommerce fiyatlarının üzerine yüzde bazlı kâr marjı ekleyerek Hepsiburada fiyatını otomatik hesaplar.
Örnek: %10 → Hepsiburada’ya gönderilen fiyat WooCommerce fiyatının %10 üstü olur.
Bu marj:
Ürün ilk gönderiminde
Fiyat güncellemelerinde
Otomatik fiyat senkronlarında uygulanır.

✅ Kategori Senkronu (Category Sync)
Hepsiburada kategori ağacını API’den çekip veritabanına kaydeder.
Kategori verileri cache’lenir; tekrar tekrar API yükü oluşturmaz.
Kategori verileri yönetim panelinde kullanılabilir hale gelir (mapping ve arama için).

✅ Kategori Arama ve Seçici (Category Search / Picker)
Kategori eşleştirme ekranında Hepsiburada kategorilerini DB üzerinden aratabilir.
Leaf category seçimi kolaylaşır.
Seçilen categoryId otomatik alanlara aktarılır.

✅ Kategori Eşleştirme (Category Mapping)
WooCommerce kategori → Hepsiburada leaf categoryId eşleştirmesi.
Eşleştirmeler saklanır ve ürün gönderiminde otomatik uygulanır.
Her kategori için ayrı mapping yapabilirsiniz (farklı ürün gruplarında doğru alanlar otomatik yüklenir).

✅ Zorunlu Özellikleri Otomatik Getirme (Required Attributes)
Seçilen Hepsiburada kategorisine göre gerekli attribute listesi otomatik çekilir.
Attribute’lar veritabanında cache’lenir.
Zorunlu alanlar panelde listelenir; eksik kalanlar net şekilde görülür.

✅ Nitelik/Özellik Eşleştirme (Attribute Mapping)
Hepsiburada attributeId → WooCommerce kaynağı eşleştirilir:
Ürün meta alanları
WooCommerce attributes (pa_*)
Özel alanlar
“Bulk mapping” ile birden fazla attribute eşleştirmesini tek seferde kaydedebilirsiniz.
Bu eşleştirmeler ürün gönderim payload’ına otomatik yansır.

✅ Enum / ValueId Doğrulama (Gerçek Pazaryeri Standardı)
Hepsiburada attribute tipi enum ise:
WooCommerce’den gelen değer, Hepsiburada enum listesinde yoksa gönderim bloklanır.
Hata mesajı net çıkar (hangi alan/value uyumsuz).
Bu sayede “HB reddetti ama neden?” problemini minimize eder.

✅ Ürün Gönderimi (Product Import) – Tam Akış
WooCommerce ürünlerini Hepsiburada’ya “import” endpoint’i ile gönderir.
Ürün gönderiminde:
categoryId otomatik alınır (mapping varsa)
attributes otomatik üretilir (mapping varsa)
görseller filtrelenir ve uygun formatta hazırlanır
kâr marjı uygulanır
stok ve fiyat bilgisi gönderilir
Gönderim sonucu ürün meta alanlarına “son durum” olarak kaydedilir:
son senkron zamanı
başarı/başarısızlık
hata özeti

✅ Değişken Ürün (Variable Product) Desteği
Variable ürünlerde her varyasyon için ayrı kayıt üretir.
Varyasyon bazlı:
merchantSku
barcode
stok
fiyat (kâr marjı ile) ayrı ayrı yönetilir.
Varyasyonlar tek ürün altında doğru şekilde işlenir.

✅ Barcode / GTIN Validasyonu
Barkod formatı (GTIN/EAN/UPC) doğrulanır.
Geçersiz barkod gönderimi engellenir.
Hepsiburada reddine yol açacak barkod hataları daha en baştan yakalanır.

✅ Görsel Validasyonu
Ürün görsellerinde uygun format kontrolü (jpg/jpeg/png).
Uygun olmayan dosyalar otomatik elenir.
Ürün gönderiminde “görsel yüzünden red” riskini düşürür.

✅ Ürün Liste Ekranında HB Sync Durumu (Woo Products List Column)
WooCommerce ürünler listesine “HB Sync” kolonu eklenir.
Her ürün için:
OK / Failed / Never
son sync zamanı
hata özeti görünür.
Bu sayede yüzlerce üründe operasyon takibi kolaylaşır.

✅ Toplu İşlem (Bulk Actions) – “HB’ye Gönder”
Woo ürünler ekranından çoklu ürün seçip:
“Send to Hepsiburada” bulk action ile kuyruğa atabilirsiniz.
Kuyruk işlemleri otomatik çalışır; arka planda gönderim tamamlanır.
Büyük mağazalarda toplu listing operasyonu için idealdir.

✅ Otomatik Fiyat/Stok Senkronu (Auto Sync)
WooCommerce’de fiyat veya stok değişince otomatik job oluşur.
Job kuyruğa alınır, belirlenen hız/limit ile Hepsiburada’ya aktarılır.
Gereksiz manuel güncelleme ihtiyacını ortadan kaldırır.

✅ Queue (Kuyruk) Altyapısı – Production Standardı
İşler “job” olarak kuyruğa alınır:
product_import
price/stock update
package deliver / intransit
carrier update
claim accept/reject
invoice link gönderimi vb.
Kuyruk ekranında:
pending/running/done/failed listesi
failed için retry
done/failed temizleme bulunur.
Büyük operasyonlarda sistemin tıkanmasını engeller.

✅ Retry / Backoff (Hata Toleransı)
API tarafında geçici hata olursa job otomatik tekrar denenir.
Exponential backoff ile:
API’ye yük bindirmez
spam istek oluşturmaz
stabil çalışır
Maks deneme aşılınca “failed” olarak işaretlenir ve panelde görünür.

✅ Rate Limit / Throttle Yönetimi
İstekler kontrolsüz şekilde patlamaz.
Limit aşımı (429) ve geçici hata (5xx) senaryoları yönetilir.
Production ortamında “API bloklandı / site kasıldı” riskini azaltır.

✅ Concurrency Lock (Çakışma Engeli)
Aynı ürün/paket için aynı anda birden fazla job çalışması engellenir.
Kuyrukta duplicate/çakışma kaynaklı veri bozulması önlenir.
Stabil otomasyon için kritik bir güvenlik katmanıdır.

✅ Sipariş Çekme (Orders Pull) ve WooCommerce Sipariş Oluşturma
Hepsiburada OMS üzerinden siparişleri çeker.
Siparişleri WooCommerce siparişi olarak oluşturur/günceller.
Sipariş meta’larına HB referansları işlenir:
order number
package number
line item id

✅ Paket Süreçleri (Packages Lifecycle)
Create Packages akışı desteklenir.
Paket durumları WooCommerce tarafına not ve meta olarak yansır:
Intransit
Deliver
Undeliver
Unpack
Siparişin saha operasyonu “panelden yönetilebilir” hale gelir.

✅ Kargo Firması & Tracking Yönetimi (Order Screen Tools)
WooCommerce sipariş ekranında HBWC Tools alanı:
carrier code seçimi
tracking no
tracking URL
“Update Carrier” job’u ile Hepsiburada’ya kargo bilgisi gönderilir.
“Mark Intransit / Mark Delivered” butonları ile durum otomasyonu yapılır.

✅ Reconcile (Sipariş/Paket Detay Eşleştirme)
Paket detayını Hepsiburada’dan çekip WooCommerce siparişi ile karşılaştırır.
Uyuşmayan kalemleri ve eksikleri raporlar.
Operasyonel hataları erken yakalamak için kritiktir.

✅ Claim (Talep) Yönetimi
Claim listesi çekilir (awaiting action).
Panel üzerinden:
Accept
Reject işlemleri yapılır.
Claim işlemleri de kuyruğa alınır; yoğunlukta bile stabil kalır.

✅ Invoice (Fatura) Süreçleri
Missing-invoice listesi çekilebilir.
Sipariş ekranından “Invoice Link gönder” aksiyonu ile işlem yapılabilir.
Fatura sürecini manuel takip etmek zorunda kalmazsınız.

✅ Webhook Sistemi (Inbound Event Handling)
Hepsiburada’dan gelen olaylar (packages/claims vb.) REST endpoint üzerinden alınır.
Event → Queue akışına düşer (arka planda işlenir).
Webhook güvenliği:
kullanıcı/şifre zorunluluğu
açık endpoint riski yok

✅ Events Ekranı (TYWC Seviyesi)
Gelen olaylar kayıt altına alınır.
Payload görüntüleme (maskeli).
Resolve/kapat aksiyonu ile event yönetimi yapılır.
Üretim ortamında troubleshooting kolaylaşır.

✅ Tools Sekmesi
Run Queue Now: Kuyruğu hemen çalıştır (manuel tetikleme).
Clear Logs / Clear Events: sistem temizliği.
Setup/yardımcı araçlar tek ekranda toplanır.
Operasyon ve destek süreçlerini hızlandırır.

✅ Logs (Gelişmiş Log Yönetimi)
Filtreleme:
modül (catalog/products/orders/claims/webhooks/queue)
level (info/warn/error)
tarih aralığı
arama
Detay görüntüleme:
HTTP kod
maskeli request/response
context bilgisi
Export:
JSON/CSV benzeri dışa aktarım
Büyük log gövdeleri truncate edilir; panel şişmez.

✅ Health Check (Sistem Sağlık Kontrolü)
Cron çalışıyor mu?
Kuyruk tıkanmış mı?
DB tabloları mevcut mu?
Credential alanları dolu mu?
Webhook güvenliği aktif mi?
Production-ready kontrol listesi gibi çalışır.

✅ Uninstall / Cleanup Kontrolü
Eklenti kaldırıldığında veriyi koruma/silme kontrolü.
Satış sonrası müşteri tarafında “temiz kaldırma” beklentisini karşılar.

✅ Türkçe Dil Desteği (Tam Çeviri)
Sadece menüler değil:
açıklamalar
uyarılar
yardım metinleri
health check açıklamaları
sistem mesajları dahil tüm “kod dışı” metinler Türkçedir.
UTF-8/MO doğru üretildi; Türkçe karakter bozulması olmaz.

✅ Kimler İçin?
WooCommerce mağazası olup Hepsiburada’da satış yapanlar
Ürün/fiyat/stok güncellemelerini otomatikleştirmek isteyenler
Sipariş ve kargo süreçlerini WooCommerce içinde yönetmek isteyenler
Büyük ürün katalogları olan ve “toplu gönderim + queue” isteyenler
Üretim ortamında log/health check gibi profesyonel araçlara ihtiyaç duyanlar

✅ Neler Kazandırır?
Manuel listing ve güncelleme yükünü azaltır
Hatalı attribute/barcode nedeniyle red riskini düşürür
Sipariş–kargo–claim süreçlerini hızlandırır
Log/queue araçları sayesinde destek süresini kısaltır
Tam otomasyon ile operasyon maliyetini azaltır

✅ Teslim İçeriği
Kurulabilir WordPress eklenti ZIP paketi
Yönetim paneli + tüm modüller
Türkçe dil dosyaları (UTF-8)
Production-ready queue/log/health araçları

Fiyat :
1 site lisans 5000₺
3 site lisans 13.000₺
5 site lisans 20.000 ₺
Sınırsız lisans 50.000 ₺
Güncellemeler otomatiktir ve fiyata dahildir.

Başarılarınızın devamını dilerim. Sonuna kadar okudum tüm özellikleri ve detayları düşünmüşsünüz. Umarım muvaffak olursunuz.

Ayrıca açık kaynak kodlu bir yapıda mı? PHP sürüm desteği nedir?

Açık kaynak olması mümkün değil, çünkü geliştirilebilecek bir kısım kalmadı ve ciddi emek verdim dolayısıyla,üç beş değişiklik yaparak birilerinin emeğim üzerinden rakibim olmasını istemezdim ama elbetteki PHP ve wordpress sürümlerine göre sabit bir güncelleme servisi mevcut,enterprise seviyesinde bir eklenti zaten, şahsım aynı zamanda envato ve themeforest üzerinde aktif satış yapıyorum, ekseri yurtdışı ve yurtiçi hepsine hitap edecek,tema ve eklentiler ile,lakin ülkemizde bir eksiklik olduğunu fark ettim,ya doğru düzgün entegrasyon eklentisi yok,tüm olan ürün göndermek, dolayısı ile API endpointlerin müsade ettiği her modülü düşünerek,her detayı aktif halde yazdım ve PHP 7.4 ve üzeri wordpress 6+ uyumludur.

Hatırınız ve seviyeyi anlamanız,neden kaynak kod olma ihtimali yok,biraz daha fikir sahibi olmanız açısından şuraya birkaç mobil ux ekran görüntüleri bırakmak isterim, ayrıca ekranlarda gördüğünüz tüm ingilizce kısımlar Türkçe çevirilmiş haldedir ve istenilen dile po pot mo ile çeviriye hazır haldedir,hardcode string içermez ve rate limitlere kadar en ince ayrıntısına kadar düşünülmüş,oldukça hafif ve hızlı çalışan bir eklentidir. Aşağıda göreceğiniz ekranlar eklentinin sadece tek sayfası (ilk tabdır), Ajax kullanılmış olup,bir çok özellik ve güncelleme sayfa yenilemesine ihtiyaç duymadan gerçekleşir. Eklenti menüsünde gördüğünüz eşleştirme,webhook,olaylar vesaire gibi ekranlar ekran görüntülerinde yok,ama sanırım herşeyi buraya eklesek,konuyu kapatırdı adminler ,işin kısası,eklenti envato kalitesindedir

Tek kelime ile mükemmel.
Kayın bilader'imin basit bir sistemi var. Envatodan alınmış Stocky ile wordpress woocommerce'i birleştirdik.
Merkez stok Stocky'de tutuluyor. Woocommer'e ürünleri gönderiyor. Stokları ortak tutuyor.
Sizin sistemi de entegre edebiliriz diye düşündüm.
İşletme sahipleri bu tür durumlardan bir haberler. Sistemi ve işleyişi anlamazlar. Ama ben onlar için bunu alıp test edebilirim.
İşleyişleri de kolaylaşmış olur.

Bu konuda size geri dönüş yapacağım. Hem de size bir alternatif daha olmuş oluruz. Geliştirme açısından.

Bu arada Codecanyon'da 16. yılım olmuş :-) Gİriş yapınca kutladılar :-)

Övgülerinizden ötürü çok teşekkür ederim,aslında abartılacak bir durum yok,sanat ve zanaat arasında ki fark aslında olay ,ben seviyorum yazmayı