VibeFox Coordinadora 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: 8.0 veya üzeri.

Coordinadora API anahtarı (yalnızca anlık teklifler için): anlık teklifler, Coordinadora'nın WooCommerce hizmeti üzerinden Coordinadora Cotizador'dan gelir; bu, resmi Coordinadora eklentisinin de kullandığı hizmettir. Coordinadora, API anahtarını etkin bir ticari anlaşması olan müşterilere verir. Coordinadora hesap yöneticinize sorun veya wc.coordinadora.com adresine bakın. Ayrıca gönderdiğiniz şehrin 8 haneli DANE kodu da gerekir. Anahtar olmadan yöntem yalnızca sabit fiyatlarla çalışır.

Ürünler: anlık bir teklif için sepetteki her ürünün bir ağırlığı ve üç boyutu (uzunluk, genişlik, yükseklik) olmalıdır.

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

Kurulum

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

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_coordinadora-oc3-(version).ocmod.zip dosyasını seçin. Uzantı OCMOD değişiklikleri eklemez, bu yüzden Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine, bu 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 uzantı türü olarak Shipping seçin. VibeFox Coordinadora uzantısını bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

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

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

5. API anahtarını, gönderim yapılan şehrin DANE kodunu ve mağaza varsayılan para biriminiz COP değilse COP kurunu girin. Yedek olarak Kolombiya için en az bir sabit fiyat ekleyin (bkz. Yapılandırma). Enable Coordinadora seçeneğini açın ve Save düğmesine tıklayın.

6. Ürünlerinizin ağırlık ve boyutlarının olduğundan emin olun.

OpenCart 4

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

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

3. Extensions > Extensions sayfasına gidin ve uzantı türü olarak Shipping seçin. VibeFox Coordinadora uzantısını bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

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

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

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Shipping > VibeFox Coordinadora > Edit. Ayarlar tüm coğrafi bölgeler için geçerlidir; yöntemi bir coğrafi bölgeye ve Conditions altındaki ülkelere sınırlayabilirsiniz. Bölümler solda listelenir. Sayfanın altındaki tek Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Kaydettikten sonra Settings saved. Cached Coordinadora rates were cleared. mesajını görürsünüz. Sayılar nokta veya virgülle girilebilir (9,99 = 9.99). Ayarları yalnızca bu uzantı için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Name boşsa veya 64 karakterden uzunsa, bir sayı ya da tablodaki bir fiyat geçersiz veya negatifse, COP per 1 unit of store currency 0 ise, Min weight (kg) değeri Max weight (kg) değerinden büyükse ya da Sort order tam sayı değilse hiçbir şey kaydedilmez ve sayfa hataları listeler.

Anlık teklifler çalışamıyorsa ya da yöntem gizlenecekse sayfa ayarların üstünde uyarılar gösterir: Origin city (DANE code) boş veya geçersizdir; varsayılan para biriminiz COP değilken COP per 1 unit of store currency eksiktir; Kolombiya için sabit fiyat yoktur (ya da *); Kolombiya için API anahtarı ve sabit fiyat yoktur, bu yüzden yöntem Kolombiya adresleri için hiç gösterilmez. Mağazanın kg cinsinden bir ağırlık sınıfı ya da cm cinsinden bir uzunluk sınıfı yoksa ve varsayılan birimi uzantı tarafından bilinmiyorsa da bir uyarı çıkar; bu durumda ürün ağırlıkları kg, boyutları cm olarak okunur (System > Localisation içinde kg, g, lb veya oz ile cm, mm, m veya in kullanın). Uyarılar her kaydetmeden sonra güncellenir.

Genel

Enable Coordinadora: Coordinadora'yı ödeme sayfasında gösterir veya gizler. Varsayılan: kapalı.

Name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Coordinadora. Zorunlu, en fazla 64 karakter.

Sort order: ödeme sayfasındaki kargo yöntemleri arasında Coordinadora'nın konumu. Tam sayı.

Coordinadora anlık teklifleri

Anlık teklifler Kolombiya'daki hedefler için istenir. Yalnızca sabit fiyat kullanmak için anahtarı boş bırakın.

API key: Coordinadora WooCommerce API anahtarınız. 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. Anahtar günlüğe asla yazılmaz.

Remove the saved API key: yalnızca kayıtlı bir anahtar varsa görünür. Açın ve anahtarı silmek için Save düğmesine tıklayın; yöntem bundan sonra yalnızca sabit fiyatları kullanır.

Origin city (DANE code): gönderim yaptığınız şehrin 8 haneli DANE kodu, örneğin 11001000 Bogotá, 05001000 Medellín, 76001000 Cali veya 08001000 Barranquilla. 5 haneli belediye kodu da kabul edilir ve 8 haneye tamamlanır.

COP per 1 unit of store currency: Coordinadora Kolombiya pesosu cinsinden teklif verir. Varsayılan para biriminiz COP değilse, para biriminizin 1 birimi için kaç COP olduğunu belirtin, örneğin 4300. Bu kur, beyan edilen değeri COP olarak göndermek için de kullanılır. Boş bırakılırsa anlık teklifler kullanılmaz. Kur 0'dan büyük olmalıdır. Varsayılan para biriminiz COP ise boş bırakın.

Sabit fiyatlar (API anahtarı olmadığında, Kolombiya dışındaki hedefler için ve anlık teklif kullanılamadığında yedek olarak kullanılır)

Prices by country: Price sütunu ve mağazanızın varsayılan para biriminde, vergi hariç, isteğe bağlı koli boyutu fiyatları olan ülkelerin listesi. Boyut sepet ağırlığından gelir: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L, 5 kg üstü XL. Boyut sütunu 0 veya boşsa Price kullanılır. Satır eklemek için Add country düğmesine tıklayın; yeni satır Kolombiya ile başlar. * All other countries satırı, kendi satırı olmayan ülkeler için geçerlidir. Satırı olmayan bir ülke (ve * satırı da yoksa) sabit fiyat almaz. Price değeri 0 olan ve boyut fiyatı olmayan bir satır ücretsiz kargo verir.

Fixed price per: Order (varsayılan) fiyatı bir kez alır. Item (price × quantity) fiyatı sepetteki ürün sayısıyla çarpar. Bu yalnızca sabit fiyatlar için geçerlidir; Coordinadora anlık teklifi her zaman tüm siparişi kapsar.

Koşullar

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

Max weight (kg): bu sepet ağırlığının üzerinde yöntemi gizler. Varsayılan: 25 (alan boş olduğunda da kullanılır). 0 sınır olmadığı anlamına gelir.

Minimum order subtotal: yöntemi yalnızca gönderilmesi gereken ürünlerin ara toplamı (kupondan sonra, vergi öncesi) bu tutarın en az üstündeyse gösterir. Her zaman göstermek için boş bırakın.

Free shipping: aşağıdaki ara toplamdan itibaren ücretsiz teslimatı açar.

Free shipping from: ücretsiz kargonun başladığı ara toplam (kupondan sonra, vergi öncesi). Yalnızca Free shipping açıkken kullanılır. Bu durumda API'ye istek gönderilmez.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Bir vergi sınıfı seçildiğinde OpenCart, tarifenin üzerine kargo vergisi ekler. Fiyatlarınız veya Coordinadora teklifi vergiyi zaten içeriyorsa No tax seçin.

Geo zone: Coordinadora'yı yalnızca bu coğrafi bölgedeki adresler için sunun. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones altında yönetilir.

Countries: Coordinadora'yı yalnızca bu hedef ülkeler için sunun. Tüm ülkelere izin vermek için boş bırakın. Bu sınır Geo zone ile birlikte uygulanır.

Gelişmiş

Debug log: tarife hesaplamalarını storage/logs/vfd_crd_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_crd_debug.log.php). Dosya web üzerinden okunamaz. API hataları ve eksik ayarlar bu seçenek kapalı olsa bile her zaman günlüğe yazılır. API anahtarı ve müşteri adresleri asla günlüğe yazılmaz. Dosya 5 MB'a ulaştığında vfd_crd_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlar.

Log: hata ayıklama günlüğünü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, uzantıyı kaldırmak Coordinadora ayarlarını, önbellekteki teklifleri ve günlükleri siler. Kapalıysa (varsayılan), yeniden kurulum için her şey 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 sayfasında nasıl çalışır

OpenCart kargo yöntemlerini gösterirken uzantıdan Coordinadora fiyatını ister. Bir Geo zone ayarlıysa ve adres bu bölgenin dışındaysa, Coordinadora sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğerleri ağırlık eklemez ve teklife dahil edilmez. Ara toplam, gönderilmesi gereken ürünlerin, kupon indirimi uygulandıktan sonra ve vergi öncesi fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi dikkate alınmaz. Uzantı önce koşulları kontrol eder: izin verilen ülkeler, sepet ağırlığı ve minimum sipariş ara toplamı. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Coordinadora'ya hiçbir istek gönderilmez.

API anahtarı olan bir Kolombiya adresi için uzantı, hedef şehrin DANE kodunu şu sırayla arar: şehir alanındaki bir DANE kodu (Kolombiya'nın il ve şehirler için ödeme modülleri bunu yazar, örneğin MEDELLIN (ANT) (05001000)), 8 haneli bir posta kodu ya da il merkezlerinin ve yaklaşık 40 büyük şehrin yerleşik listesi. Adresin bir bölgesi (il) varsa, listedeki bir şehir bununla karşılaştırılır. Aksanlar ve büyük-küçük harf farkı yok sayılır.

Ardından uzantı, Coordinadora'ya hedef DANE kodunu ve gönderim şehriyle birlikte her ürünü gönderir: ağırlığı (kg), boyutları (cm), miktarı ve beyan edilen değeri (COP). Beyan edilen değer, kupon indiriminden sonra ve vergi öncesi ürün satırı toplamıdır. Ürünlerin ağırlık ve uzunluk sınıfları otomatik olarak dönüştürülür. Coordinadora fiyatı COP olarak döndürür; uzantı bunu mağazanızın varsayılan para birimine çevirir, o para biriminin ondalıklarına yuvarlar ve seçili Tax class vergisiyle müşterinin para biriminde gösterir. Her teklif 1 saat önbellekte tutulur. Başarısız bir istek 10 dakika hatırlanır; böylece bir Coordinadora kesintisi her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 10 saniyedir.

Anlık teklif kullanılamadığında (API hatası, bilinmeyen şehir, ağırlığı ya da boyutu olmayan ürün, eksik ayarlar) sabit fiyat kullanılır. Yoksa yöntem o sepet için gizlenir. Hata ayrıntıları hata ayıklama günlüğüne gider, asla müşteriye gösterilmez.

Uzantı yalnızca tarifeleri hesaplar. Gönderi veya kılavuz (guía) oluşturmaz, etiket basmaz, kurye randevusu (recogidas) almaz, kolileri takip etmez, kapıda ödeme (recaudo) tahsil etmez ve Droop teslim noktaları sunmaz; bunlar için Coordinadora portalını kullanın. Siparişlere hiçbir şey eklemez: sipariş, diğer OpenCart kargo yöntemlerinde olduğu gibi yöntem adını ve kargo tutarını gösterir. Uluslararası hedefler sabit fiyatları kullanır.

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

Lisans anahtarı

Uzantı, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Coordinadora lisans bloğu, ayarların üstünde, Extensions > Extensions > Shipping > VibeFox Coordinadora > 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ı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) 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: opencart-shipping-coordinadora 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 bu uzantı için değiştirme yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloktaki metinler 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şılamazsa uzantı son bilinen durumla çalışmaya devam eder.

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

Etkin bir anahtar olmadan Coordinadora ödeme sayfası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 yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin bir 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. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard 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. Uzantıyı kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Coordinadora ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Coordinadora seçeneğinin açık olduğunu kontrol edin. Uzantı sayfasının üstündeki uyarıları, Geo zone, Countries, ağırlık sınırlarını ve Minimum order subtotal değerini kontrol edin. Anlık teklif yoksa, ülke için veya * için bir sabit fiyat bulunmalıdır. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

Anlık tarife gösterilmiyor, yalnızca sabit fiyat var: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve uzantı sayfasındaki Log alanına bakın. Yaygın nedenler: hedef şehir tanınmıyor, bir ürünün ağırlığı ya da boyutu yok, gönderim yerinin DANE kodu ya da COP kuru eksik, ya da Coordinadora bir hata döndürdü.

Hedef şehir tanınmıyor: DANE kodunu şehir alanına yazan bir Kolombiya il ve şehirler ödeme modülü kurun. Geliştiriciler, vfd_coordinadora/dane_cities, vfd_coordinadora/destination_dane ve vfd_coordinadora/api_url OpenCart olaylarıyla daha fazla şehir eşleyebilir ya da API adresini değiştirebilir; API adresi ayrıca vfd_crd_api_url ayarıyla (testler için) değiştirilebilir, bu ayarın ayarlar sayfasında bir alanı yoktur.

Tarife vergi içeriyor mu? Tarife, Coordinadora'nın teklif ettiğidir. Bir Tax class ile OpenCart, tarifenin üzerine kargo vergisi ekler; teklif bunu zaten içeriyorsa No tax seçin.

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

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

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Coordinadora yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman silinir. OpenCart her zaman Enable Coordinadora, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbellekteki teklifler her zaman silinir. Remove data on uninstall açıksa, Coordinadora ayarları ve günlük de silinir. Kapalıysa, diğer ayarlar korunur ve uzantıyı yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kendi kargo yöntemini ve maliyetini korur.

OpenCart 4'te uzantının dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu uzantılar listesinde VibeFox Coordinadora 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.

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