VibeFox Frenet for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül daha eski PHP sürümlerinde kurulmaz.

Frenet hesabı (yalnızca canlı teklifler için): Frenet panelinde (painel.frenet.com.br) ücretsiz bir hesap oluşturun, kullandığınız taşıyıcıları etkinleştirin ve API jetonunuzu kopyalayın. Yalnızca sabit fiyat kullanıyorsanız Frenet hesabına ihtiyacınız yoktur.

Ürünler: doğru fiyatlar için ağırlık ve boyutları doldurun. Bunlar olmadan ürünler 0,3 kg ve 16 × 11 × 2 cm (en küçük Correios kutusu) olarak teklif edilir.

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

Kurulum

1. Back office'te 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 Frenet modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üst kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. API jetonunu yapıştırın ve çıkış CEP'ini girin. Varsayılan para biriminiz BRL değilse BRL döviz kurunu girin. İsteğe bağlı olarak sabit fiyatlar ve bir yedek ücret ekleyin. Save düğmesine tıklayın.

Kurulumda modül, Delivery by the carriers of your Frenet account teslimat süresi metniyle Frenet taşıyıcısını oluşturur. Taşıyıcı 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 bölümünde değiştirebilirsiniz. Fiyatları orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Frenet > Configure. Taşıyıcının her bölgesi için geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbelleğe alınmış Frenet tekliflerini temizler. Fiyat alanları ondalık ayırıcı olarak hem nokta hem virgülü kabul eder; sayı olmayan bir değer "…" must be a number. mesajıyla reddedilir. Negatif tutarlar ve ağırlıklar, 0 veya daha düşük bir BRL exchange rate ve Maximum weight değerinden büyük bir Minimum weight de reddedilir. Bir hata olduğunda hiçbir şey kaydedilmez.

Sayfanın üst kısmında modül uyarılar gösterir: API jetonu yoksa (yalnızca sabit fiyatlar kullanılır; sabit fiyat da yoksa taşıyıcı hiç gösterilmez), 8 haneli çıkış CEP'i yoksa veya döviz kuru olmadan varsayılan para birimi BRL değilse. Mağazanızın ağırlık ya da boyut birimini modül tanımıyorsa da uyarır; böyle bir birim kg veya cm olarak işlenir. International > Localization bölümünde (Local units) standart bir birim ayarlayın (kg, g, lb veya oz; cm, mm, m veya in).

Genel

Enable Frenet: taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen taşıyıcı adı. Default: Frenet. Zorunlu, en fazla 64 karakter.

Frenet canlı teklifleri

Frenet, Frenet hesabınızda etkin olan taşıyıcıları karşılaştırır ve sepet için fiyatlarını döndürür. Canlı teklifler yalnızca Brezilya'daki ve tam 8 haneli CEP'i olan adresler için istenir. Bölümde Frenet paneline bir bağlantı bulunur.

API token: Frenet panelindeki Frenet API jetonunuz. Yalnızca sabit fiyat kullanmak için boş bırakın. Kaydettikten sonra alan boş kalır ve A token is saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı jetonu silmek için Remove the saved token kutusunu işaretleyip kaydedin.

Origin CEP: paketlerin gönderildiği posta kodu (CEP), örneğin 00000-000. Mağaza adresi Brezilya'daysa, Shop Parameters > Contact > Stores bölümündeki mağaza posta kodunu kullanmak için boş bırakın. 8 haneden az olan bir CEP yazıldığı gibi kaydedilir ve sayfa Frenet: the origin CEP must have 8 digits. uyarısını gösterir.

Service to offer: Cheapest service (varsayılan) veya Fastest service. Frenet birden fazla hizmet döndürür ve taşıyıcı tek bir fiyat gösterir.

BRL exchange rate: Frenet, Brezilya reali üzerinden teklif verir. Varsayılan para biriminiz BRL değilse, varsayılan para biriminizde 1 BRL'nin ne kadar olduğunu girin, örneğin 0.16. Teklif ve beyan edilen sipariş tutarı bu kurla dönüştürülür. Bu olmadan canlı teklifler kullanılmaz. Varsayılan para biriminiz BRL ise alan Not needed (shop currency is BRL) ifadesini gösterir.

Sabit fiyatlar

API jetonu yoksa, Frenet'in hizmet vermediği ülkeler için ve Frenet fiyat döndürmediğinde (API çalışmıyorsa, CEP hizmet kapsamında değilse) kullanılır.

Price per country: Country, Price, XS, S, M, L ve XL sütunlarından oluşan bir tablo; fiyatlar varsayılan para biriminizde ve KDV hariç girilir. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Boyut sütunları sepet ağırlığına bağlıdır: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L, 5 kg'ın üzerinde XL. Boyut sütunu boş olduğunda Price kullanılır. Price değeri 0 ise o ülke için ücretsiz kargo anlamına gelir. Diğer tüm ülkeler için * Default kullanın. Hiç fiyatı olmayan satırlar kaydettiğinizde silinir.

Fallback cost: ne Frenet ne de tablo fiyat verdiğinde kullanılır. Taşıyıcıyı gizlemek için boş bırakın.

Fixed price applies: Per order fiyatı bir kez alır. Per item (price × quantity) ise fiyatı ürün adediyle çarpar. Bu yalnızca sabit fiyatlar ve yedek ücret için geçerlidir. Frenet teklifleri zaten tüm sepeti kapsar.

Koşullar

Minimum weight: sepet ağırlığı bu değerin altındaysa taşıyıcıyı gizler (kg). 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet ağırlığı bu değerin üzerindeyse taşıyıcıyı gizler (kg). Default: 30 (alan boşken de kullanılır). 0 sınır olmadığı anlamına gelir. Minimum weight değerinden düşük olamaz.

Minimum order amount: sepet ara toplamı (indirimlerden sonra, vergilerden önce) bu tutarın en az üzerindeyse taşıyıcıyı gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: sepet ara toplamı (indirimlerden sonra, vergilerden önce) bu tutarın üzerine çıktığında kargonun ücretsiz olacağı tutar. Hiçbir zaman ücretsiz kargo vermemek için boş bırakın.

Tax: taşıyıcının vergi kuralı veya No tax. Frenet fiyatları taşıyıcının nihai fiyatlarıdır. PrestaShop'un bunlara vergi eklememesi gerekiyorsa No tax seçin.

Ürün ağırlıkları ve boyutları mağazanızın birimlerinden kg ve cm'ye dönüştürülür.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers bölümünde atandığı bölgelerde sunulur.

Ignore shipping zones: hangi bölge eşleşirse eşleşsin, Frenet'i aşağıdaki ülkeler için sunar. Kaydedildiğinde taşıyıcı tüm bölgelere eklenir; daha sonra oluşturduğunuz bölgelere de eklenir. Bu seçeneği tekrar kapattığınızda taşıyıcı, önceki bölgelerini geri alır.

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

Gelişmiş

Debug log: her teklif isteğini ve yanıtını modül klasöründeki logs/vfd_frn_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. Jeton hiçbir zaman kaydedilmez ve müşterinin CEP'i kısaltılır. İşiniz bittiğinde kapatın.

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çıksa modülü kaldırmak tüm Frenet ayarlarını, taşıyıcıyı ve günlüğü siler. Kapalıysa yeniden kurulum için her şey saklanır. Önbelleğe alınmış teklifler her zaman silinir. Siparişlerle kaydedilen Frenet hizmetleri sipariş geçmişidir ve saklanır.

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

Kargo adımında PrestaShop, modülden Frenet fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Müşteri bir adres girmeden önce modül, mağazanın ziyaretçi için tahmin ettiği ülkeyi kullanır. Modül önce ülke listesini (Ignore shipping zones açıksa), sepet ağırlığını ve minimum sipariş tutarını kontrol eder. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Frenet'e istek gönderilmez.

Tam 8 haneli CEP'i olan Brezilya adresi için modül, Frenet'e çıkış ve varış CEP'lerini, her sepet ürününü (kg cinsinden ağırlık, cm cinsinden boyutlar, adet, ürün referansı ve kategoriler), BRL cinsinden sipariş tutarını ve sepetin ilk kupon kodunu gönderir. CEP eksik olduğu sürece istek yapılmaz. Frenet, etkin taşıyıcılarınızın hizmetlerini döndürür. Hatalı veya fiyatsız hizmetler atlanır. Modül en ucuz veya en hızlı hizmeti seçer ve fiyatı varsayılan para biriminize çevirir. Fiyat daha sonra müşterinin sepet para biriminde gösterilir.

Her yanıt, aynı sepet ve aynı adres için 1 saat önbelleğe alınır. Başarısız bir istek ya da hiçbir etkin taşıyıcının hizmet vermediği bir CEP 10 dakika boyunca hatırlanır. API zaman aşımı 10 saniyedir. Bu durumlarda müşteri bir hata görmez: sabit fiyat veya yedek ücret kullanılır ya da hiçbiri yoksa taşıyıcı gizlenir. Neden günlüğe yazılır. Brezilya dışındaki adresler için yalnızca sabit fiyatlar kullanılır.

Taşıyıcıda siparişler olduktan sonra Shipping > Carriers bölümünde düzenlerseniz PrestaShop onu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca fiyat hesaplar. Gönderi oluşturmaz, etiket basmaz veya paketleri takip etmez. Sepet başına birden fazla değil, bir Frenet hizmeti gösterir ve teslim noktası ya da dolap sunmaz. Frenet yalnızca Brezilya içinde teklif verir; diğer ülkeler için sabit fiyatları kullanın.

Siparişler

Sipariş Frenet taşıyıcısıyla verildiğinde modül, kargo fiyatının nasıl hesaplandığını kaydeder. Back office sipariş sayfasında bu satırları içeren bir Frenet bloğu gösterilir:

Carrier: Frenet taşıyıcısı ve hizmet; örneğin bir Correios veya Jadlog hizmeti. Canlı teklifler için gösterilir.

Delivery time: Frenet'in döndürdüğü iş günü cinsinden teslimat süresi. Canlı teklifler için gösterilir.

Price source: Live Frenet quote, Fixed price (price per country), Fallback cost veya Free shipping.

Bu veriler modül kaldırıldığında da saklanır; Remove data on uninstall açık olsa bile.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Frenet lisans bloğu, Modules > Module Manager > VibeFox Frenet > Configure bölümünde ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve domaininiz) gösterir; ayrıca 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 düğmeleri bulunur. Bunların altında Product: presta-shipping-frenet satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office 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ştikten sonra ya da hesabınızda bir domain hakkı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 yalnızca bir domainde çalışır: ana mağazanın domaini, çoklu mağaza kurulumunda da dahil. Anahtarı mağazadan kaldırmak domain hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Frenet taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop vitrini, back office'e giriş yaptığınızı bilmez; bu yüzden taşıyıcı sizden de gizlenir: modülü bir 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 için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Frenet ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Frenet seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını ya da Ignore shipping zones seçeneğinin açık ve ülkenin izinli olduğunu kontrol edin. Modül sayfasının üst kısmındaki uyarılara, ağırlık sınırlarına ve Minimum order amount değerine bakın. Tipik nedenler: müşteri henüz tam 8 haneli bir CEP girmemiş ve sabit fiyat yok, ya da Frenet bu güzergâh için hiçbir hizmet döndürmemiş ve sabit fiyat yok. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlandırılmış olabilir.

Canlı teklifler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Alan nedeni gösterir: çıkış CEP'i yok, BRL döviz kuru yok, müşterinin CEP'i eksik, ağırlık veya tutar sınırı ya da atlanan hizmetlerin mesajları.

Günlük API jetonunun reddedildiğini gösteriyor (HTTP 401 veya 403): jetonu Frenet panelinden yeniden kopyalayın ve API token alanına yapıştırın.

Günlük Frenet'in hiçbir hizmet döndürmediğini gösteriyor: Frenet panelinde en az bir taşıyıcıyı etkinleştirin.

Mağazam euro veya dolar ile satış yapıyor: Frenet BRL cinsinden yanıt verir. BRL exchange rate değerini girin (varsayılan para biriminizde 1 BRL'nin ne kadar olduğu).

Frenet fiyatının üzerine vergi ekleniyor: Frenet fiyatları taşıyıcının nihai fiyatlarıdır. Tax değerini No tax olarak ayarlayın.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Frenet tekliflerini temizler.

Sayfa Frenet taşıyıcısının bulunamadığını söylüyor: taşıyıcı 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. O zamana kadar kaydetme işlemi The settings were saved, but the carrier could not be updated. mesajını gösterir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Frenet yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbelleğe alınmış teklifler her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar saklanır. Modülü yeniden kurmak ya da Reset yapmak, kayıtlı taşıyıcıya daha önceki durumunu geri verir: kapattığınız bir taşıyıcı kapalı kalır. Mevcut siparişler Frenet taşıyıcısını ve sipariş sayfasındaki Frenet bloğunu korur.

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