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 Hepsiburadaya tek tıkla gönderir.
Fiyat ve stok değişikliklerini otomatik algılar ve Hepsiburadaya 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 Hepsiburadaya 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 → Hepsiburadaya 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ı APIden çekip veritabanına kaydeder.
Kategori verileri cachelenir; 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.
Attributelar veritabanında cachelenir.
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:
WooCommerceden 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 Hepsiburadaya import endpointi 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) HBye 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)
WooCommercede fiyat veya stok değişince otomatik job oluşur.
Job kuyruğa alınır, belirlenen hız/limit ile Hepsiburadaya 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:
APIye 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ş metaları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 jobu ile Hepsiburadaya 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ı Hepsiburadadan ç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)
Hepsiburadadan 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 Hepsiburadada 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şkargoclaim 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.