VibeFox Frenet for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

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 tek bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınıza açın. İçinde README.txt, OpenCart 3 paketi vfd_frenet-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_frenet.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_frenet-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine bu paketin upload klasöründeki içeriği mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox Frenet'i bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

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

5. 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 maliyet ekleyin. Enable Frenet seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_frenet.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox Frenet'i bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları, OpenCart 3 için 4. ve 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra Enable Frenet seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Frenet ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Frenet > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi, tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış Frenet tekliflerini de temizler. Fiyat alanları ondalık ayracı olarak hem nokta hem virgül kabul eder. Bir değer yanlışsa hiçbir şey kaydedilmez ve sayfa nedenini gösterir; örneğin Enter a valid method title (64 characters max, without < > ; = # { })., "…" must be a number. veya "…" must not be negative. Ayrıca 0 veya daha az bir BRL exchange rate ve Maximum weight (kg) değerinden büyük bir Minimum weight (kg) de reddedilir. Ayarları yalnızca bu eklenti için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Sayfanın üst kısmında ve her kayıttan sonra eklenti uyarılar gösterir: API jetonu yoksa (yalnızca sabit fiyatlar kullanılır ya da hiç sabit fiyat yoksa yöntem hiç gösterilmez), çıkış CEP'i yoksa, çıkış CEP'i 8 haneli değilse ya da varsayılan para birimi BRL değilken döviz kuru yoksa. Mağazada kg birimli bir ağırlık sınıfı ya da cm birimli bir uzunluk sınıfı yoksa da uyarır. Bu durumda ürün ağırlıkları ve boyutları, sınıflarının birim adına göre dönüştürülür ve bilinmeyen birimler kg veya cm olarak okunur. System > Localisation > Weight Classes ve Length Classes bölümlerini kontrol edin.

Genel

Ayarlar tüm coğrafi bölgeler için geçerlidir. Yöntemi Conditions içinde bir coğrafi bölgeyle sınırlayabilir ya da Ignore shipping zones seçeneğini kullanabilirsiniz. Fiyat her zaman bu eklentiden gelir.

Enable Frenet: Frenet'i ödeme sırasında gösterir veya gizler. Varsayılan: kapalı.

Method title: müşterinin sepette ve ödeme sırasında gördüğü kargo yöntemi adı. Varsayılan: Frenet. Zorunlu, en fazla 64 karakter, şu karakterler olmadan: < > ; = # { }.

Sort order: Frenet'in ödeme sırasındaki kargo yöntemleri arasındaki konumu. Tam sayı.

Frenet canlı teklifleri

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

API token: Frenet panelinden aldığınız Frenet API jetonu. 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 01001-000. OpenCart'ta mağaza posta kodu yoktur, bu nedenle canlı teklifler bu alanı gerektirir. 8 haneli olmayan bir CEP yazdığınız 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 yöntem tek bir fiyat gösterir. Seçilen taşıyıcı, hizmet ve teslimat süresi siparişle birlikte kaydedilir.

BRL exchange rate: Frenet Brezilya reali cinsinden teklif verir. Varsayılan para biriminiz BRL değilse, 1 BRL'nin varsayılan para biriminizde ne kadar ettiğini girin, örneğin 0.16. Teklif ve siparişin beyan edilen değeri bu kurla dönüştürülür. Bu olmadan canlı teklifler kullanılmaz. Varsayılan para biriminiz BRL ise alan, Frenet fiyatlarının olduğu gibi kullanıldığını belirtir.

Sabit fiyatlar

API jetonu yoksa, Frenet'in hizmet vermediği ülkeler için ve Frenet fiyat döndürmediğinde (API kapalı, CEP hizmet dışı) 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çtir. Satır eklemek için Add country düğmesine 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şsa Price kullanılır. Price değeri 0 ise o ülke için ücretsiz kargo anlamına gelir. Kendi satırı olmayan tüm ülkeler için * Default (all other countries) seçeneğini kullanın. Hiçbir fiyatı olmayan satırlar kaydedildiğinde silinir.

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

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

Koşullar

Minimum weight (kg): yöntemi bu sepet ağırlığının altında gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): yöntemi bu sepet ağırlığının üzerinde gizler. Varsayılan: 30 (alan boşken de kullanılır). 0 sınır olmadığı anlamına gelir. Minimum weight (kg) değerinden düşük olamaz.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) en az bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: kargonun ücretsiz olduğu ara toplam (kupon sonrası, vergi öncesi). Asla ücretsiz kargo vermemek için boş bırakın.

Tax class: kargo maliyetine eklenen vergi sınıfı ya da No tax. Frenet fiyatları taşıyıcının nihai fiyatlarıdır. OpenCart bu fiyatlara vergi eklemesin istiyorsanız No tax seçin.

Geo zone: Frenet'i yalnızca bu coğrafi bölgedeki adresler için sunar. All zones sınır olmadığı anlamına gelir. Ignore shipping zones ile birlikte kullanılmaz. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde yöntem, Conditions içinde seçili coğrafi bölgede sunulur (hiçbiri seçili değilse tüm bölgelerde).

Ignore shipping zones: Frenet'i, hangi coğrafi bölgenin eşleştiğine bakılmaksızın aşağıdaki ülkeler için sunar. Bu durumda Conditions içindeki Geo zone kontrol edilmez.

Countries: bu mod için hedef ülkeler; mağazanızdaki etkin ülkeler arasından seçilir. Kargo gönderdiğiniz 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ı storage/logs/vfd_frn_debug.log.php dosyasına kaydeder (OpenCart 4'te system/storage/logs/vfd_frn_debug.log.php). Dosya web üzerinden okunamaz. API hataları her zaman kaydedilir. Jeton asla kaydedilmez ve müşterinin CEP'i kısaltılır. İşiniz bittiğinde kapatın. Dosya 5 MB'a ulaştığında vfd_frn_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken eklentiyi kaldırmak tüm Frenet ayarlarını ve günlüğü siler. Kapalıyken yeniden kurulum için her şey saklanır. Önbelleğe alınmış teklifler her zaman silinir. Siparişlerle kaydedilen Frenet hizmetleri sipariş geçmişinin parçasıdır ve korunur.

İçe / dışa aktarma

Export: ayarları bir JSON dosyasına kaydetmek için Download JSON düğmesine tıklayın. API jetonu dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Değerler normal bir kayıtta olduğu gibi kontrol edilir. Kayıtlı API jetonu korunur.

Ödeme sırasında nasıl çalışır

OpenCart kargo yöntemlerini gösterdiğinde eklentiden Frenet fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa Frenet sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğerleri ağırlık eklemez ve sipariş tutarına dahil edilmez. Eklenti ardından ülke listesini (Ignore shipping zones açıksa), sepet ağırlığını ve minimum sipariş tutarını kontrol eder. Sipariş tutarı, kupon indiriminden sonra ve vergi öncesi, kargo gerektiren ürünlerin fiyatıdır. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve Frenet'e istek gönderilmez.

Brezilya'daki tam 8 haneli CEP'e sahip bir adres için ve API jetonu ile çıkış CEP'i ayarlandığında eklenti, Frenet'e çıkış ve varış CEP'lerini, her sepet ürününü (kg cinsinden ağırlık, cm cinsinden boyutlar, adet, ürünün Model değeri ve kategorileri), BRL cinsinden sipariş değerini ve sepetin kupon kodunu gönderir. CEP eksikken istek yapılmaz. Frenet, etkin taşıyıcılarınızın hizmetlerini döndürür. Hatalı ya da fiyatsız hizmetler atlanır. Eklenti en ucuz ya da en hızlı hizmeti seçer ve fiyatı varsayılan para biriminize çevirir. Fiyat, varsayılan para biriminizin ondalık basamaklarına yuvarlanır ve seçili Tax class vergisiyle birlikte müşteriye kendi para biriminde gösterilir.

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

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve “Shipping method options” penceresinde Frenet'i seçer. Yöntem, OpenCart 3'teki ile aynı şekilde çalışır.

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

Siparişler

Frenet ile bir sipariş verildiğinde eklenti, kargo fiyatının nasıl hesaplandığını kaydeder: müşterinin kargo adımında gördüğü seçeneğin tam olarak aynısı, Frenet'e yeni bir istek gönderilmeden. Sales > Orders altındaki sipariş sayfası bu durumda şu satırları içeren bir Frenet bloğu gösterir:

Carrier: Frenet taşıyıcısı ve hizmeti; örneğin bir Correios ya da 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.

OpenCart 4'te blok History bölümünün üstünde gösterilir. OpenCart 4, müşteri siparişi yeniden onayladığında aynı siparişi günceller: kayıtlı Frenet verileri de güncellenir ve müşteri başka bir kargo yöntemi seçtiyse siparişin Frenet verileri kaldırılır.

Blok, eklenti kapalıyken de gösterilir. Bu veriler eklenti kaldırılsa da korunur; Remove data on uninstall açık olsa bile.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Frenet lisans bloğu, Extensions > Extensions > Shipping > VibeFox Frenet > Edit 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi 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: opencart-shipping-frenet satırı ile Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 tarih ile birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 yoksa Frenet, ödeme sırasında müşterilere gösterilmez ve tarifeler hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi (unlicensed — visible to admins only) işaretiyle mağazada yine görür; böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Frenet ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable Frenet seçeneğinin açık olduğunu kontrol edin. Geo zone ayarını, ya da Ignore shipping zones ve Countries ayarlarını, ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Eklenti sayfasının üst kısmındaki uyarılara bakın. Tipik nedenler: müşteri henüz tam 8 haneli bir CEP girmedi ve sabit fiyat yok ya da Frenet bu güzergâh için hizmet döndürmedi ve sabit fiyat yok. Ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

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

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 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 ile yanıt verir. BRL exchange rate alanına (1 BRL'nin varsayılan para biriminizde ne kadar ettiğini) girin.

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

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

Sayfada "Warning: You do not have permission to modify VibeFox Frenet!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_frenet (OpenCart 3) ya da extension/vfd_frenet/shipping/vfd_frenet (OpenCart 4) için değiştirme izni verin.

Geliştiriciler için: Frenet teklif adresi vfd_frn_api_url ayarıyla değiştirilebilir (testler için); ayarlar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Frenet yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. OpenCart her zaman Enable Frenet, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış teklifler her zaman silinir. Bu eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca yeni siparişlerin Frenet verilerini kaydeden olaylar da), bu yüzden Frenet bloğu artık sipariş sayfasında gösterilmez. Siparişlerle kaydedilen Frenet verileri korunur ve eklentiyi yeniden kurduğunuzda yeniden gösterilir. Remove data on uninstall açıksa Frenet ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kargo yöntemini ve maliyetini korur.

OpenCart 4'te eklentinin dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Frenet yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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