VibeFox Estafeta for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: cURL uzantısıyla birlikte 8.0 veya üzeri. Modül, eski PHP sürümlerinde veya cURL olmadan kurulmaz.

DrEnvio hesabı (yalnızca anlık fiyatlar için): Estafeta'nın anlık fiyatları, Meksika'daki bir Estafeta ortağı olan DrEnvio'dan gelir. drenvio.com üzerinde bir hesap oluşturun, Estafeta'yı etkinleştirin, orada toplama adresinizi ayarlayın ve API anahtarını DrEnvio panelinizden kopyalayın. Bu, resmi DrEnvio modülünün kullandığı anahtarla aynıdır. Yalnızca kendi fiyatlarınızı kullanıyorsanız DrEnvio hesabına ihtiyacınız yoktur.

Ürünler: anlık fiyatlar için ürünlerin ağırlık bilgisi olmalıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Estafeta modülünü 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. DrEnvio API key alanına anahtarınızı ve isteğe bağlı olarak Origin postcode alanına posta kodunuzu girin. Mağazanızın varsayılan para birimi MXN değilse MXN exchange rate değerini girin. MX için bir ülke fiyatı ya da DrEnvio bir fiyat döndürmediğinde kargo firmasının görünür kalmasını istiyorsanız bir Fallback cost belirleyin. Save düğmesine tıklayın.

Kurulumda modül, Estafeta courier (Mexico) teslimat süresi metniyle Estafeta kargo firmasını oluşturur. Kargo firması tüm bölgelere 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. Fiyatları orada belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Estafeta > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbellekteki DrEnvio fiyatlarını temizler.

Sayfanın üst kısmında modül uyarılar gösterir: DrEnvio API anahtarı yok; varsayılan para birimi MXN değil ve döviz kuru yok; MX için ülke fiyatı ve yedek ücret yok (bu durumda kargo firması, anlık fiyat yoksa gizlenir veya API anahtarı olmadan hiç gösterilmez); ya da modülün tanımadığı bir mağaza ağırlık birimi var (ürün ağırlıkları bu durumda kg olarak alınır; birimi International > Localization bölümünde, Local units altında ayarlayın). Sayısal alanlar ondalık ayırıcı olarak nokta veya virgül kabul eder. Geçerli bir sayı olmayan değer kaydedilirken temizlenir ve bildirilir; diğer ayarlar yine kaydedilir.

Genel

Kargo firmasının bölgeleri, müşteri grupları ve boyut sınırları Shipping > Carriers üzerinden ayarlanır. Bu ayarlar her bölge için geçerlidir.

Enable/Disable: Estafeta kargoyu açar veya kapatır. Shipping > Carriers içindeki kargo firması durumuyla aynı anahtardır.

Name: ödeme sayfasında müşteriye gösterilen kargo firması adı. Varsayılan: Estafeta. Zorunlu. Geçersiz bir ad bildirilir ve önceki ad korunur.

Tax: kargo firmasının vergi kuralı veya No tax. Mağaza bu vergiyi kargo ücretine ekler. DrEnvio fiyatlarına IVA dahil olup olmadığı DrEnvio hesabınıza bağlıdır. Zaten dahilse No tax seçin.

Anlık fiyatlar (DrEnvio API)

Adres için en ucuz Estafeta hizmeti sunulur. Anahtar yoksa bir sonraki bölümdeki fiyatlar kullanılır.

DrEnvio API key: DrEnvio panelinizdeki API anahtarı. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved API key: yalnızca kayıtlı bir anahtar varken görünür. Yes olarak ayarlayıp kaydederek anahtarı silin. Bundan sonra yalnızca Country prices ve Fallback cost kullanılır. Yukarıdaki alana girilen bir anahtar, kayıtlı olanın yerini alır.

Origin country: toplama adresinin iki harfli ülke kodu. Varsayılan: MX. Yalnızca origin postcode ile birlikte gönderilir.

Origin postcode: toplama adresinin 5 haneli posta kodu. DrEnvio hesabınızda kayıtlı çıkış adresini kullanmak için boş bırakın. 5 haneli olmayan bir posta kodu kaydedilirken temizlenir ve bildirilir.

MXN exchange rate: DrEnvio, Meksika pesosu cinsinden teklif verir. Yalnızca mağazanızın varsayılan para birimi MXN değilse gerekir: varsayılan para biriminizde 1 MXN'in değeri, örneğin 0.05. Bu olmadan anlık fiyatlar kullanılmaz.

Anlık fiyat olmadan fiyatlar

API anahtarı yoksa veya DrEnvio bir Estafeta fiyatı döndürmezse kullanılır (API kullanılamıyor, bilinmeyen posta kodu, posta kodu henüz girilmemiş). Fiyatlar mağazanızın varsayılan para biriminde, vergi hariç olarak belirtilir.

Country prices: satır başına bir hedef ülke, CC:PRICE biçiminde, örneğin MX:150. Ondalık ayırıcı olarak nokta veya virgül kullanın; binlik ayırıcı kullanmayın. Farklı biçimdeki kısımlar yok sayılır ve kaydederken bildirilir.

Fallback cost: anlık fiyat ve ülke fiyatı yokken uygulanan fiyat. Kargo firmasını gizlemek için boş bırakın; 0 ücretsiz kargo anlamına gelir.

Calculation type: Per order fiyatı bir kez alır. Per item (price x number of items) fiyatı sepetteki ürün sayısıyla çarpar. Bu, Country prices ve Fallback cost için geçerlidir. DrEnvio anlık fiyatı her zaman tüm paketin fiyatıdır.

Koşullar

Free shipping from: sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergi öncesi) bu tutara ulaştığında kargo ücretsizdir. Bu durumda DrEnvio'ya istek gönderilmez. Ücretsiz kargoyu hiç sunmamak için boş bırakın.

Minimum subtotal: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergi öncesi) en az bu tutar olduğunda gösterin. Her zaman göstermek için boş bırakın.

Min weight: kargo firmasının görünmesi için sepetin kg cinsinden minimum ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight: sepetin kg cinsinden maksimum ağırlığı. Aşılırsa kargo firması gizlenir. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Eğer Min weight, Max weight değerinden büyükse, kaydederken bir hata gösterilir ve iki ağırlık da değişmeden kalır. Ürün ağırlıkları, mağazanızın ağırlık biriminden kg'a çevrilir.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: kargo firması için bölge ayarlamadan, aşağıda belirtilen ülkeler için kargo firmasını sunar. Açık olduğu sürece kargo firması, daha sonra oluşturacaklarınız dahil tüm bölgeleri alır. Kapatmak, kargo firmasına kendi bölgelerini geri verir.

Countries: bu mod için hedef ülkeler; mağazanızın etkin ülkeleri arasından seçilir. Tüm ülkeler için boş bırakın. Yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: API isteklerini ve fiyat hesaplamalarını modül klasöründeki logs/vfd_est_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Log: hata ayıklama günlüğünün boyutunu ve en son girdilerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa modülü kaldırmak, tüm modül ayarlarını, kargo firmasını, siparişlerin kayıtlı Estafeta hizmetlerini ve günlüğü siler. Kapalıysa yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, modülden Estafeta fiyatını ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: Countries listesi (Ignore shipping zones açıksa), sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo uygulanırsa fiyat 0 olur ve DrEnvio'ya istek gönderilmez.

Aksi halde modül DrEnvio'ya hedef ülkeyi ve posta kodunu, sepet ağırlığını, ürün sayısını ve MXN cinsinden ara toplamı, ayrıca ayarladıysanız origin postcode değerini gönderir. Meksika posta kodları 5 haneli olmalıdır; müşteri böyle bir posta koduyla teslimat adresi girene kadar istek yapılmaz. DrEnvio, hesabınızdaki tüm kargo firmalarının tekliflerini döndürür. Modül yalnızca Estafeta tekliflerini kullanır, sıfır fiyatları yok sayar, en ucuzunu seçer ve bunu mağazanızın varsayılan para birimine çevirir. Fiyat daha sonra müşterinin sepet para biriminde gösterilir.

Her yanıt 1 saat önbellekte tutulur. Başarısız bir istek veya Estafeta fiyatı olmayan bir rota 5 dakika hatırlanır; böylece yavaş veya arızalı bir API ödeme sayfasındaki her güncellemeyi yavaşlatmaz. API zaman aşımı 12 saniyedir. Bu durumlarda müşteri hata görmez: ülke fiyatı veya yedek ücret kullanılır ya da ikisi de ayarlı değilse kargo firması gizlenir. Nedeni günlüğe yazılır.

Shipping > Carriers üzerinden kargo firmasında, siparişleri olduktan sonra değişiklik yaparsanız PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca fiyatları hesaplar. Gönderi oluşturmaz, etiket (guías) yazdırmaz veya paketleri takip etmez; gönderiyi DrEnvio veya Estafeta hesabınızda oluşturun. Müşteri belirli bir Estafeta hizmeti veya Estafeta şubesi seçemez ve döviz kurları otomatik olarak güncellenmez.

Siparişler

Estafeta kargo firmasıyla bir sipariş verildiğinde modül, sepeti için hesaplanan fiyatı saklar. Daha sonraki yeniden hesaplamalar, örneğin yönetim panelindeki sipariş sayfasında, bu fiyatı değiştirmez.

Orders > Orders sayfasındaki sipariş sayfası bir Estafeta bloğu gösterir:

Estafeta service: DrEnvio teklifindeki Estafeta hizmeti ve teslimat süresi. Yalnızca anlık fiyatlar için gösterilir.

Price source: Live DrEnvio rate, Country price (no live rate), Fallback cost (no live rate) veya Free shipping threshold.

Calculated price (excl. tax): mağazanızın varsayılan para biriminde kargo fiyatı.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Estafeta lisans bloğu, Modules > Module Manager > VibeFox Estafeta > Configure sayfasında ayarların üstündeki ilk bloktur. 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 tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-shipping-estafeta satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

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

Bir anahtar yalnızca 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ızda serbest bırakın.

Etkin bir anahtar olmadan Estafeta kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop mağazası 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 ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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 için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Estafeta ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde kargo firmasının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Modül sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. API anahtarı yoksa veya DrEnvio bir Estafeta fiyatı döndürmüyorsa kargo firması için hedef ülke fiyatı ya da yedek ücret gerekir. Ürünler de ürün sayfasında belirli kargo firmalarıyla sınırlandırılmış olabilir.

Anlık fiyatlar görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Nedeni gösterir: API anahtarı yok; varsayılan para birimi MXN olmayan bir mağaza için döviz kuru yok; posta kodu eksik veya geçersiz; API anahtarı reddedildi (DrEnvio HTTP 401 veya 403, API anahtarını kontrol edin); rota için Estafeta fiyatı yok (günlük, DrEnvio'nun döndürdüğü kargo firmalarını listeler); veya fiyat MXN dışında bir para birimindedir.

Fiyat IVA'yı içeriyor mu? Bu, DrEnvio hesabınıza bağlıdır. DrEnvio fiyatları zaten IVA içeriyorsa Tax değerini No tax olarak ayarlayın.

Bir değişiklikten sonra fiyatlar eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki DrEnvio fiyatlarını temizler.

Sayfa Estafeta kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın. Aynısı The settings were saved, but the carrier could not be updated. mesajı için de geçerlidir.

Sipariş sayfasında Estafeta bloğu yok: blok yalnızca modül kuruluyken Estafeta kargo firmasıyla verilmiş siparişler için gösterilir. Remove data on uninstall açıkken kaldırmak kayıtlı hizmetleri siler.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Estafeta yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbellekteki fiyatlar her zaman silinir. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur) ve ayarlar, siparişlerin kayıtlı Estafeta hizmetleri ve günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve ayarlar ile siparişlerin kayıtlı hizmetleri korunur. Modülü yeniden kurduğunuzda kargo firması, kaldırılmadan önceki durumunu geri alır.

Estafeta ve DrEnvio, ilgili sahiplerinin ticari markalarıdır. Bu modül Estafeta veya DrEnvio ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.