VibeFox Estafeta for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 ile test edildi) veya 4.0.2 ve üzeri (4.1.0.3 ile test edildi).

PHP: cURL uzantısı yüklü 8.0 veya üzeri.

DrEnvio hesabı (yalnızca anlık tarifeler için): anlık Estafeta tarifeleri, Meksika'da bir Estafeta iş ortağı olan DrEnvio'dan gelir. drenvio.com adresinde bir hesap oluşturun, Estafeta'yı etkinleştirin, teslim alma adresinizi orada ayarlayın ve API anahtarını DrEnvio panelinizden kopyalayın. Bu, resmi DrEnvio eklentisinin 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 tarifeler için ürünlerin ağırlığının tanımlı olması gerekir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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ızda açın. İçinde README.txt, OpenCart 3 paketi vfd_estafeta-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_estafeta.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze ait paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

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

2. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Estafeta eklentisini 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. Edit sayfasının üstündeki lisans bloğunda, License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. DrEnvio API key alanına anahtarınızı ve isterseniz Origin postcode alanına posta kodunuzu girin. Varsayılan para biriminiz MXN değilse MXN exchange rate alanını doldurun. DrEnvio tarife döndürmediğinde yöntemin görünür kalmasını istiyorsanız MX için bir ülke fiyatı veya bir Fallback cost belirleyin. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_estafeta.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4, eklentinin kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

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

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Estafeta eklentisini bulun, Install düğmesine (yeşil + düğmesi), 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ı her iki sürümde aynıdır.

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Estafeta > Edit. Bölümler solda listelenir. Sayfanın altındaki tek Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kaydetme, önbelleğe alınmış DrEnvio tarifelerini de temizler. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Sayfanın üstünde eklenti uyarılar gösterir: DrEnvio API anahtarı yoksa, varsayılan para birimi MXN değilse ve döviz kuru yoksa, MX için ülke fiyatı ve yedek ücret yoksa (yöntem o zaman anlık tarife yoksa gizlenir, API anahtarı olmadan ise hiç gösterilmez) ya da kg birimli bir ağırlık sınıfı yoksa (ürün ağırlıkları o zaman ağırlık sınıflarının birim adına göre dönüştürülür, bilinmeyen birimler kg kabul edilir; System > Localisation > Weight Classes altında bir kg sınıfı ekleyin). Sayısal alanlar ondalık nokta veya virgül kabul eder. Kaydettiğinizde yanlış bir değer bildirilir ve her alanda anlatıldığı gibi temizlenir ya da sıfırlanır; form kaydedilen değeri gösterir ve diğer ayarlar yine de kaydedilir (The other settings were saved.).

Genel

Yöntem, aşağıdaki geo bölge için (ya da her adres için) veya Availability without shipping zones ülkeleri için sunulur.

Enable/Disable: Estafeta kargoyu açar veya kapatır. Varsayılan: kapalı.

Name: ödeme sırasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Estafeta. Zorunlu: 1 ila 64 karakter, < > ; = # { } karakterleri olmadan. Geçersiz bir ad bildirilir ve önceki ad korunur.

Tax class: kargo ücretine eklenen vergi sınıfı veya No tax (varsayılan). DrEnvio fiyatlarının IVA içerip içermediği DrEnvio hesabınıza bağlıdır. Zaten IVA içeriyorlarsa No tax seçin.

Geo zone: Estafeta'yı yalnızca bu geo bölgedeki adresler için sunar; örneğin bir "Meksika" bölgesi. All zones (varsayılan) sınır olmadığı anlamına gelir. Geo bölgeler System > Localisation > Geo Zones altında yönetilir. Ignore shipping zones açıkken kullanılmaz.

Sort order: ödeme sırasında Estafeta'nın kargo yöntemleri arasındaki konumu. Tam sayı.

Anlık tarifeler (DrEnvio API)

Bu bölüm anahtarın nereden alınacağını açıklar. Adres için en uygun Estafeta hizmeti sunulur. Anahtar yoksa Prices without a live rate fiyatları kullanılır.

DrEnvio API key: DrEnvio panelinizdeki API anahtarı. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. 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. Anahtarı silmek için açın ve kaydedin. Bundan sonra yalnızca Country prices ve Fallback cost kullanılır. Yukarıdaki alana girilen bir anahtar, kayıtlı olanın yerine geçer.

Origin country: teslim alma adresinin iki harfli ülke kodu. Varsayılan: MX. Yalnızca çıkış posta koduyla birlikte gönderilir. Geçersiz bir kod bildirilir ve MX'e döndürülür.

Origin postcode: teslim alma adresinin 5 haneli posta kodu. DrEnvio hesabınızda kayıtlı çıkış adresini kullanmak için boş bırakın. 5 haneden farklı bir posta kodu kaydetme sırasında temizlenir ve bildirilir.

MXN exchange rate: DrEnvio, Meksika pesosu cinsinden teklif verir. Yalnızca varsayılan para biriminiz MXN değilse gerekir: varsayılan para biriminizde 1 MXN'nin değeri, örneğin 0.05. Kur girilmezse anlık tarifeler kullanılmaz. 0'dan büyük olmalıdır. Mağaza para birimi MXN ise boş bırakın.

Anlık tarife olmayan fiyatlar

API anahtarı yoksa veya DrEnvio hiçbir Estafeta tarifesi döndürmezse kullanılır (API'ye ulaşılamıyor, posta kodu bilinmiyor, posta kodu henüz girilmedi). Fiyatlar mağazanızın varsayılan para biriminde, vergi hariç verilir.

Country prices: her satırda bir hedef ülke, CC:FİYAT biçiminde, örneğin MX:150. Ondalık nokta veya virgül kullanın, binlik ayırıcı kullanmayın. Başka biçimdeki kısımlar yok sayılır ve kaydetme sırasında bildirilir.

Fallback cost: anlık tarife ve ülke fiyatı olmadığında geçerli fiyat. Yöntemi gizlemek için boş bırakın; 0 ücretsiz kargo anlamına gelir.

Calculation type: Per order (varsayılan) fiyatı bir kez uygular. 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 tarifesi her zaman tüm paketin fiyatıdır.

Koşullar

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon indirimi sonrası, vergi öncesi) bu tutara ulaştığında kargo ücretsizdir. Bu durumda DrEnvio'ya istek gönderilmez. Hiçbir zaman ücretsiz kargo vermemek için boş bırakın.

Minimum subtotal: aynı ara toplam en az bu tutardaysa yöntemi gösterir. Her zaman göstermek için boş bırakın.

Min weight (kg): yöntemin görünmesi için gereken minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir (varsayılan).

Max weight (kg): maksimum sepet ağırlığı. Aşılırsa yöntem gizlenir. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Eğer Min weight değeri Max weight değerinden büyükse, kaydetme bir hata gösterir ve iki ağırlık da değişmez. Ürün ağırlıkları, her ürünün ağırlık sınıfından kg'a dönüştürülür.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: geo bölgeyi kontrol etmeden yöntemi aşağıdaki ülkeler için sunar. Varsayılan: kapalı.

Countries: bu mod için hedef ülkeler. 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 tarife hesaplamalarını storage/logs/vfd_est_debug.log.php (OpenCart 4'te system/storage/logs/vfd_est_debug.log.php) dosyasına yazar. Dosya web üzerinden okunamaz. API hataları günlük kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_est_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

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

Remove data on uninstall: açıksa eklentiyi kaldırmak tüm ayarlarını ve günlüğü siler. Kapalıysa (varsayılan) her şey yeniden kurulum için saklanır. Siparişlerdeki kayıtlı Estafeta hizmetleri her zaman korunur.

İçe / Dışa Aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API anahtarı 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 kaydetme gibi kontrol edilir. Kayıtlı API anahtarı korunur.

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

OpenCart kargo yöntemlerini gösterirken eklentiden Estafeta fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bu bölgenin dışındaysa Estafeta sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler dikkate alınır: diğer ürünler ağırlığa eklenmez ve ara toplama dahil edilmez. Ara toplam, bu ürünlerin kupon indiriminden sonra ve vergi öncesi fiyatıdır; hediye çekleri, puanlar ve mağaza kredisi dikkate alınmaz. Ardından eklenti koşulları kontrol eder: Countries listesi (Ignore shipping zones açıkken), sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve DrEnvio'ya istek gönderilmez.

Aksi halde eklenti DrEnvio'ya hedef ülkeyi ve posta kodunu, sepet ağırlığını, ürün sayısını ve MXN cinsinden ara toplamı gönderir; bir çıkış posta kodu ayarladıysanız onu da gönderir. Meksika posta kodları 5 haneli olmalıdır; müşteri böyle bir teslimat adresi girene kadar istek yapılmaz. DrEnvio, hesabınızdaki tüm kargo firmalarının tekliflerini döndürür. Eklenti yalnızca Estafeta tekliflerini kullanır, sıfır fiyatları yok sayar, en ucuzunu seçer ve mağazanızın varsayılan para birimine çevirir. Fiyat, o para biriminin ondalık basamaklarına yuvarlanır ve müşteriye kendi para biriminde, seçilen Tax class vergisiyle gösterilir.

Her yanıt 1 saat önbellekte tutulur. Başarısız bir istek veya Estafeta tarifesi olmayan bir rota 5 dakika hatırlanır; böylece yavaş veya bozuk bir API ödeme güncellemelerini asla 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 yoksa yöntem gizlenir. Neden günlüğe yazılır.

Müşteri yalnızca yöntem adını ve fiyatı görür. Eklenti yalnızca tarifeleri hesaplar. Gönderi oluşturmaz, kargo etiketi (guías) yazdırmaz veya kargoları takip etmez; gönderiyi DrEnvio veya Estafeta hesabınızda oluşturun. Müşteri belirli bir Estafeta hizmetini veya bir Estafeta şubesini seçemez ve döviz kurları otomatik olarak güncellenmez.

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

Siparişler

Estafeta ile bir sipariş verildiğinde, eklenti müşteriye gösterilen tarifeyi DrEnvio'ya yeni bir istek göndermeden kaydeder. Siparişte yönetici panelinden sonradan yapılan değişiklikler bunu değiştirmez. OpenCart 4'te ödeme sayfası tek bir siparişi tutar ve müşteri her yeniden onayladığında onu günceller; bu nedenle kayıtlı tarife, ödeme sayfasının son tarifesiyle değiştirilir. Müşteri başka bir kargo yöntemine geçerse, bu sipariş için panel artık gösterilmez.

Sales > Orders altındaki sipariş sayfasında bir Estafeta paneli gösterilir:

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

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

Shipping cost: ödeme sırasında hesaplanan, mağazanızın varsayılan para biriminde ve vergi hariç kargo fiyatı.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Estafeta lisans bloğu, ayarların üstünde, Extensions > Extensions > Shipping > VibeFox Estafeta > Edit sayfasındaki 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 tarihi ve alan adınızı) ve Check now düğmesini gösterir: durumu yeniden kontrol eder; Change key başka bir anahtar girmenizi sağlar ve Remove key anahtarı bu mağazadan kaldırır. Bunların altında Product: opencart-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 eklenti için Modify yetkisine sahip 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 tarihle 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şılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca 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 olmadan Estafeta, ödeme sırasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. Aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici kullanıcı, yöntemi mağazada hâlâ (unlicensed — visible to admins only) işaretiyle 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 görünür. Bunu × ile kapatırsanız 7 gün boyunca 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 her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Estafeta ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Geo zone ayarını veya Ignore shipping zones ve Countries ayarlarını kontrol edin. Eklenti sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum subtotal ayarını kontrol edin. API anahtarı yoksa veya DrEnvio bir Estafeta tarifesi döndürmüyorsa yöntem, hedef için bir ülke fiyatına veya yedek ücrete ihtiyaç duyar. Ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti sayfasındaki Log alanına bakın. Nedenini 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), bu rota için Estafeta tarifesi yok (günlükte DrEnvio'nun döndürdüğü kargo firmaları listelenir) ya da MXN dışında bir para biriminde tarife.

Fiyat IVA içeriyor mu? Bu, DrEnvio hesabınıza bağlıdır. DrEnvio fiyatları zaten IVA içeriyorsa Tax class değerini No tax olarak ayarlayı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ış DrEnvio tarifelerini temizler.

Sipariş sayfasında Estafeta paneli yok: panel yalnızca eklenti kuruluyken ve etkinken Estafeta ile verilen siparişlerde gösterilir.

Sayfa "Warning: You do not have permission to modify VibeFox Estafeta!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups altında extension/shipping/vfd_estafeta (OpenCart 3) veya extension/vfd_estafeta/shipping/vfd_estafeta (OpenCart 4) için değiştirme yetkisi verin.

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

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Estafeta yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable/Disable, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış tarifeler her zaman kaldırılır. Remove data on uninstall açıksa Estafeta ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerdeki kayıtlı Estafeta hizmetleri her iki durumda da korunur ve siparişler kargo yöntemini ve ücretini saklamaya devam eder.

OpenCart 4'te eklentinin dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, yüklü eklentiler listesinde VibeFox Estafeta 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.

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