VibeFox Econt for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

Econt: Econt sözleşmesi veya API anahtarı gerekmez. Ofis listesi Econt'in herkese açık bir nomenklatürüdür. Econt'e yalnızca ülke kodu gönderilir, müşteri verisi gönderilmez. e-Econt kullanıcı adı ve şifresini yalnızca Econt mağazanızdan yetkilendirme isterse girin. e-Econt girişi Econt geliştirici sayfasında açıklanmaktadır (econt.com/developers).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Econt öğesini bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Ülkelere göre ücretleri ayarlayın ve diğer seçenekleri kontrol edin (Yapılandırma bölümüne bakın), ardından Save düğmesine tıklayın. Bağlantıyı test etmek için Load offices from Econt now düğmesine tıklayın.

Kurulumda modül, Delivery to an Econt office or Econtomat teslimat süresi metniyle Econt Express kargo firmasını oluşturur. Kargo firması Bulgaristan ve Romanya bölgelerine ve tüm müşteri gruplarına atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Ücretleri orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Econt > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Ücret ve koşullar kargo firmasının tüm bölgelerine uygulanır.

Sayfanın üstünde modül uyarılar gösterir: Econt kargo firması bulunamadı, demo API açık, Bulgaristan veya Romanya için ücret ayarlanmamış (bu durumda kargo firması hiç gösterilmez), bir ülke için son ofis isteği başarısız oldu veya mağazanızın ağırlık birimi modül tarafından bilinmiyor (bu durumda ağırlıklar kg olarak alınır; birimi International > Localization bölümünde, Local units alanında ayarlayın). Sayısal alanlar ondalık virgülü kabul eder, örneğin 5,99. Bir sayısal alan sayı olmayan veya negatif sayı olmayan bir değer içeriyorsa ya da Minimum weight (kg) değeri Maximum weight (kg) değerinden büyükse, bir hata alanı belirtir ve hiçbir şey kaydedilmez.

Genel

Enable/Disable: Econt teslimatını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Name: sepette ve ödeme sayfasında gösterilen kargo firması adı. Varsayılan: Econt Express. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax. PrestaShop bu vergiyi aşağıdaki ücretlerin üzerine ekler. No tax seçilirse ücretler nihai olur.

Econt ofis listesi

Ofisler ve Econtomat'lar Econt API'sinden yüklenir ve 24 saat önbellekte tutulur.

Demo API: test verileriyle Econt demo API'sini kullanır. Canlı bir mağazada kapalı tutun. Demo ofislerin ID'leri gerçek olanlardan farklıdır. Demo modunda giriş ayarlanmamışsa Econt'in herkese açık test hesabı kullanılır.

Econt username: isteğe bağlı. HTTP Basic yetkilendirmesi için e-Econt girişiniz.

Econt password: isteğe bağlı. Mağaza veritabanında saklanır ve günlüğe asla yazılmaz. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek için yeni bir değer girin. Kayıtlı şifreyi silmek için Remove the saved password kutusunu işaretleyip kaydedin.

Office list: ülkeye göre önbellekte kaç ofis olduğunu ve ne zaman yüklendiklerini gösterir. Load offices from Econt now düğmesi listeleri hemen yeniden yükler ve sonucu ülke bazında gösterir. Yükleme başarısız olursa son başarılı yüklemedeki ofisler korunur. Bu düğme olmadan liste ilk ödeme sayfasında otomatik yüklenir. Demo API, kullanıcı adı veya şifre değiştirilirse önbellekteki listeler temizlenir.

Ödeme sayfasında ofis seçici

Show: müşterilerin seçebileceği noktalar.

City order: en büyük şehirleri önce gösterir (Sofya, Filibe, Varna, Bükreş ve diğerleri). Kapalıyken şehirler alfabetik sıralanır. Varsayılan: açık.

City list width: şehir listesinin CSS genişliği, örneğin 100% veya 300px. Varsayılan: 100%.

Office list width: ofis listesinin CSS genişliği, örneğin 100% veya 400px. Varsayılan: 100%.

Ücretler (bölüm başlığı mağazanızın varsayılan para birimini gösterir)

Ücretler mağazanızın varsayılan para biriminde, vergi hariç belirtilir. Modül Econt'ten canlı kur sorgulamaz. Bulgaristan 1 Ocak 2026'dan beri euro kullandığı için bir Bulgar mağaza genellikle ücretleri EUR olarak girer.

Price per country: her satıra bir ülke (veya virgülle ayrılmış): ülke kodu, iki nokta, ücret; örneğin BG:5.99 ve RO:8.99 (varsayılan değerler budur). Ondalık virgül de kullanılabilir: BG:5,99. 0 ücret ücretsiz teslimat anlamına gelir. Alan boşsa varsayılan ücretler BG:5.99 ve RO:8.99 kullanılır (Ignore zones açıkken kargo bölgeleri dışındaki ülkeler o zaman ücret almaz). Başka biçimdeki girişler yok sayılır ve kaydederken bir uyarıda listelenir. Geri kalanı kaydedilir.

Calculation: Per order ücreti bir kez alır. Per item (price x quantity) ücreti, gönderilmesi gereken ürün sayısıyla çarpar.

Price for other countries: yukarıda listelenmeyen bir Econt ülkesi (Bulgaristan veya Romanya) için kullanılır. Boş veya 0 ise kargo firması o ülkede gizlenir.

Koşullar

Sepet ara toplamı, indirimlerden sonra ve vergiden önce, gönderilmesi gereken ürünler anlamına gelir.

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı. Hiçbir zaman ücretsiz teslimat sunulmaması için boş bırakın.

Minimum subtotal: kargo firmasını yalnızca sepet ara toplamı bu tutarın en az üzerinde olduğunda gösterir. Her zaman göstermek için boş bırakın.

Minimum weight (kg): daha hafif sepetler için kargo firmasını gizler. Ürün ağırlıkları mağazanızın ağırlık biriminden kg'a çevrilir. Sınır olmaması için boş bırakın.

Maximum weight (kg): daha ağır sepetler için kargo firmasını gizler. Sınır olmaması için boş bırakın.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore zones: teslimat adresinin bölgesi kargo firmasına bağlı değilse, aşağıdaki ülkelerde de Econt'i sunar. Açtığınızda kargo firması her aktif bölgeye bağlanır ve daha sonra oluşturulan bölgeler de bağlanır. Tekrar kapattığınızda kargo firması daha önce sahip olduğu bölgeleri geri alır. Bağlı olan bölgeler her zamanki gibi çalışmaya devam eder. Econt yalnızca Bulgaristan ve Romanya için sunulmaya devam eder.

Countries: Bulgaristan ve/veya Romanya. Yalnızca Ignore zones ile kullanılır. Hiçbiri işaretli değilse, mağazanın gönderim yaptığı tüm Econt ülkeleri geçerlidir.

Gelişmiş

Debug log: hata ayıklama mesajlarını modül klasöründeki logs/vfd_ecn_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. Şifreler ve müşteri verileri yazılmaz.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak Econt ayarlarını, kargo firmasını ve günlüğü siler. Kapalıyken ayarlar yeniden kurulum için saklanır. Siparişlerde kaydedilen ofisler her zaman korunur.

Ödeme sayfasında nasıl çalışır

Kargo firması yalnızca Bulgaristan ve Romanya için sunulur. Kargo adımında PrestaShop, modülden Econt ücretini ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül ağırlık sınırlarını ve minimum ara toplamı kontrol eder, ardından ülkenin ücretini alır. Sepet ara toplamı Free shipping from değerine ulaşırsa ücret 0 olur. Ülke için ofis listesi yoksa, teslimat her zaman bir ofise yapıldığı için kargo firması gizlenir. Ücret varsayılan para biriminde hesaplanır ve sonra müşterinin sepet para biriminde gösterilir.

Müşteri Econt'i seçtiğinde kargo firmasının altında iki liste belirir: City ve Office / Econtomat. Ofis listesi sayfa başına yalnızca bir kez ve yalnızca Econt seçildiğinde yüklenir. Econtomat'lar listede işaretlenir. Seçim hemen sepete kaydedilir. Ofis listesi yüklenemezse müşteri Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method. mesajını görür.

Müşteri kargo adımında Continue düğmesine tıkladığında modül sunucuda bir ofisin seçildiğini ve teslimat ülkesi için Econt listesinde bulunduğunu kontrol eder (Show seçeneğine göre filtrelenir). Ofis yoksa müşteri Please select an Econt office or Econtomat. mesajını görür. Listede olmayan bir ofis The selected Econt office is not available for the shipping country. Please select it again. mesajıyla reddedilir. Ofis adı her zaman tarayıcıdan değil, Econt listesinden alınır. Seçici Classic tema ve Hummingbird ile çalışır.

Ofis listesi canlı ve demo API için ayrı ayrı 24 saat önbellekte tutulur. Econt'e ulaşılamazsa son başarılı liste kullanılır ve Econt 10 dakika boyunca tekrar sorgulanmaz. API zaman aşımı 15 saniyedir. Ofis listesi https://ee.econt.com/services/ (canlı) veya https://demo.econt.com/ee/services/ (demo) adresinden gelir.

Kargo firmasında siparişleri olduktan sonra Shipping > Carriers bölümünde düzenlerseniz PrestaShop bunu yeni bir kargo firması sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak takip eder.

Modül yalnızca sabit ücretleri kullanır. Econt'ten canlı fiyat sorgulamaz, irsaliye veya etiket oluşturmaz, kurye çağırmaz, kargoları takip etmez, kapıda ödemeyi yönetmez ve adrese teslimat yapmaz. Yalnızca Bulgaristan ve Romanya'nın ofis listesi vardır.

Teslim noktaları

Sipariş verildiğinde sepet için seçilen ofis siparişle birlikte kaydedilir: şehir, ofis adı ve adresi ile Econt ofis kodu. Gönderiyi e-Econt'te oluştururken ofis kodunu kullanın.

Yönetim panelindeki sipariş sayfası: Econt office / Econtomat bloğu ofisi ve Office code değerini gösterir. Change altında siparişin ülkesinde başka bir şehir ve ofis seçip Save düğmesine tıklayın. Değişiklik hemen kaydedilir ve özel bir sipariş mesajı eski ve yeni ofisi kaydeder. Ofis seçmeden Save düğmesine tıklarsanız blok Select a city and an office first - nothing was changed. mesajını gösterir. Siparişleri düzenleme yetkisi olan her çalışan ofisi değiştirebilir; modül sayfasına erişim gerekmez. Ofis listesi yüklenemezse blok Econt offices cannot be loaded right now. mesajını gösterir.

Aynı sepetten birden fazla sipariş: ofis ilk siparişe aittir. Aynı sepetten verilen başka bir sipariş ofis almaz: günlüğe bir hata yazılır ve bloğunda bu sepetin ofisinin başka bir siparişe ait olduğu belirtilir. Ofisi müşteriyle kararlaştırın ve gönderiyi e-Econt'te elle oluşturun.

Müşteri: ofis, müşterinin sipariş sayfasında ve sipariş onay sayfasında gösterilir; sipariş onay e-postasında ve mağazaya giden yeni sipariş e-postasında kargo firması adına eklenir.

Mağaza dili Bulgarca veya Rumence olduğunda ofis adları yerel dilde (Bulgaristan için Kiril alfabesiyle), diğer durumlarda İngilizce gösterilir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Econt lisans bloğu, Modules > Module Manager > VibeFox Econt > Configure sayfasındaki ilk bloktur ve ayarların üstündedir. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarihi ve alan adınızı) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-econt satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Econt kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden kargo firması sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Econt ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu, teslimat ülkesinin Bulgaristan veya Romanya olduğunu kontrol edin. Shipping > Carriers bölümünde kargo firmasının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin (veya Ignore zones seçeneğini açıp Countries bölümünü kontrol edin). Ülke için bir ücretin, ağırlık sınırlarının ve Minimum subtotal değerinin ayarlandığını kontrol edin. Ayarlardaki Office list satırını kontrol edin: ülke için ofis listesi yoksa kargo firması gizlenir. Ürünler ürün sayfasında belirli kargo firmalarıyla da sınırlandırılabilir.

Ofis listesi yüklenmiyor: Load offices from Econt now düğmesine tıklayın ve sonucu veya ayarlar sayfasının üstündeki uyarıyı okuyun. Hatalar her zaman günlüğe yazılır; daha fazla ayrıntı için Debug log seçeneğini açın ve Log alanına bakın. Econt mağazanız için yetkilendirme istiyorsa Econt username ve Econt password alanlarını doldurun.

Müşteriler test ofislerini görüyor: Demo API açık. Canlı bir mağazada kapatın.

Ücretler hangi para biriminde? Mağazanızın varsayılan para biriminde, vergi hariç. Müşteriler bunları sepet para birimlerinde görür.

Vergi ücretin üzerine ekleniyor: kargo firmasının bir vergi kuralı var. Fiyatlarınız KDV'yi zaten içeriyorsa Tax seçeneğini No tax olarak ayarlayın.

Sayfa Econt kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers bölümünde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Econt yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki ofis listeleri her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kaydedilmiş kargo firmasını önceki durumuyla geri getirir. Modülü sıfırlamak mevcut kargo firması durumunu korur. Siparişlerde kaydedilen ofisler her zaman korunur.

Econt, ilgili sahibinin ticari markasıdır. Bu modül Econt ile bağlantılı değildir ve Econt tarafından onaylanmamıştır.