VibeFox Coordinadora for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

Coordinadora API anahtarı (yalnızca canlı teklifler için): canlı teklifler, resmi Coordinadora eklentisinin de kullandığı Coordinadora WooCommerce hizmeti üzerinden Coordinadora Cotizador'dan gelir. Coordinadora API anahtarını aktif ticari anlaşması olan müşterilere verir. Coordinadora hesap yöneticinize danışın veya wc.coordinadora.com adresine bakın. Ayrıca gönderim yaptığınız şehrin 8 haneli DANE kodu gerekir. Anahtar olmadan taşıyıcı yalnızca sabit fiyatlarla çalışır.

Ürünler: canlı teklif için sepetteki her ürünün ağırlığı ve boyutları (genişlik, yükseklik, derinlik) 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. Back office'te Modules > Module Manager sayfasına 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 veya daha sonra modül listesinde VibeFox Coordinadora 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 bulunan License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. API anahtarını, çıkış şehrinin DANE kodunu ve varsayılan para biriminiz COP değilse COP döviz kurunu girin. Alternatif olarak Kolombiya için en az bir sabit fiyat ekleyin (bkz. Yapılandırma). Save düğmesine tıklayın.

5. Kolombiya'nın mağazanızda aktif olduğundan ve ürünlerinizin ağırlık ve boyutlarının bulunduğundan emin olun.

Kurulumda modül, Courier delivery in Colombia teslimat süresi metniyle Coordinadora 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 üzerinden değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Coordinadora > Configure. Ayarlar taşıyıcının tüm bölgelerinde geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış Coordinadora tekliflerini de temizler. Sayılar nokta veya virgülle yazılabilir (9,99 = 9.99).

Bir sayı veya tablo fiyatı geçersiz ya da negatifse, COP per 1 unit of store currency 0 ise, Min weight değeri Max weight değerinden büyükse veya Name 64 karakterden uzunsa sayfa kaydetmeyi reddeder ve bir hata gösterir. Düzeltene kadar hiçbir şey kaydedilmez.

Canlı teklifler çalışamadığında veya taşıyıcı gizlenecekse sayfa üstte uyarılar gösterir: Origin city (DANE code) boş veya geçersizse, varsayılan para biriminiz COP değilken COP per 1 unit of store currency eksikse ya da Kolombiya için sabit fiyat (veya *) yoksa. API anahtarı olmadan ve böyle bir sabit fiyat olmadan taşıyıcı Kolombiya adresleri için asla gösterilmez. Mağazanın International > Localization (Local units) bölümündeki ağırlık veya boyut birimi modül tarafından bilinmiyorsa da uyarı çıkar; bu durumda ürün ağırlıkları kg, boyutlar cm olarak okunur.

Genel

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

Name: ödeme sırasında müşteriye gösterilen taşıyıcı adı. Varsayılan: Coordinadora. Zorunlu.

Tax: taşıyıcının vergi kuralı veya No tax. Bir kural seçilirse PrestaShop, kargo vergisini ücretin üzerine ekler. Fiyatlarınız veya Coordinadora teklifi vergiyi zaten içeriyorsa No tax seçin.

Coordinadora canlı kargo ücretleri

Canlı teklifler Kolombiya'daki varış adresleri için istenir. Yalnızca sabit fiyat kullanmak için anahtarı boş bırakın.

API key: Coordinadora'dan aldığınız 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 için yeni bir değer girin. Anahtar günlüğe asla yazılmaz.

Remove the saved API key: yalnızca kayıtlı bir anahtar varken görünür. Açın ve anahtarı silmek için Save düğmesine tıklayın; taşıyıcı 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 fiyatları Kolombiya pesosu cinsinden verir. Varsayılan para biriminiz COP değilse, para biriminizin 1 birimine kaç COP karşılık geldiğini girin, örneğin 4300. Bu kur, beyan edilen değeri COP olarak göndermek için de kullanılır. Boş bırakırsanız canlı 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ı yokken, Kolombiya dışındaki varış yerleri için ve canlı teklif alınamadığında yedek olarak kullanılır)

Prices by country: Price sütunu ve isteğe bağlı paket boyutu fiyatları içeren bir ülke tablosu; varsayılan para biriminizde, vergi hariç. Boyut, sepet ağırlığından gelir: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg'ın üzerinde. Boyut sütunu 0 veya boşsa Price kullanılır. Satır eklemek için Add country düğmesine, satır silmek için çarpıya tıklayın. * All other countries ülkesi kendi satırı olmayan ülkelere uygulanır. Satırı olmayan (ve * de olmayan) bir ülke sabit fiyat almaz. Price değeri 0 olan ve boyut fiyatı olmayan bir satır ücretsiz kargo sağlar.

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

Koşullar

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

Max weight: sepet ağırlığı bu değerin üzerindeyken taşıyıcıyı gizler (kg). Varsayılan: 25 (alan boşken de kullanılır). 0 sınır olmadığı anlamına gelir. Min weight değerinden küçük olamaz.

Minimum order subtotal: sepetin ara toplamı (indirimlerden sonra, vergi öncesi) bu tutarın en az üzerindeyse taşıyıcıyı 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: kargonun ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi öncesi). Yalnızca Free shipping açıkken kullanılır. Bu durumda API isteği yapılmaz.

Countries: Coordinadora'yı yalnızca bu varış ülkeleri için sunar. Yalnızca etkin ülkeler listelenir. Taşıyıcı bölgelerinin tüm ülkelerine izin vermek için boş bırakın.

Gelişmiş

Debug log: tarife hesaplamalarını modül klasöründeki logs/vfd_crd_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. 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 hiçbir zaman günlüğe yazılmaz.

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 modülü kaldırmak Coordinadora ayarlarını, taşıyıcıyı, önbelleğe alınmış teklifleri ve günlükleri siler. Kapalıysa yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, modülden Coordinadora fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve teklife dahil edilmez. Modül önce koşulları kontrol eder: izin verilen ülkeler, sepet ağırlığı ve minimum sipariş ara toplamı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Coordinadora'ya istek gönderilmez.

API anahtarı olan ve Kolombiya'daki bir adres için modül, varış şehrinin DANE kodunu şu sırayla bulur: şehir alanındaki DANE kodu (Kolombiya departman ve şehir ödeme modülleri bunu yazar, örneğin MEDELLIN (ANT) (05001000)), 8 haneli posta kodu veya departman merkezleri ile yaklaşık 40 en büyük şehrin yerleşik listesi. Adreste departman (eyalet) varsa listedeki şehir buna göre kontrol edilir. Aksanlar ve büyük/küçük harf farkı dikkate alınmaz.

Ardından modül, Coordinadora'ya varış DANE kodunu ve her ürünü çıkış şehri, ağırlığı (kg), boyutları (cm), adedi ve beyan edilen değeriyle (COP) gönderir. Beyan edilen değer, ürün satırının vergi öncesi ve sepet indirimleri öncesi toplamıdır. Mağaza birimleri otomatik olarak dönüştürülür. Coordinadora fiyatı COP olarak döndürür; modül bunu önce varsayılan para biriminize, ardından müşterinin sepet para birimine çevirir. Her teklif 1 saat önbelleğe alınır. Başarısız bir istek 10 dakika hatırlanır; böylece Coordinadora kesintisi her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 10 saniyedir.

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

Siparişleri olan bir taşıyıcıyı Shipping > Carriers bölümünde düzenlerseniz PrestaShop bunu yeni bir taşıyıcı sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca kargo ücretlerini hesaplar. Gönderi veya guía (guías) oluşturmaz, etiket yazdırmaz, kurye alımı (recogidas) ayırtmaz, kargoyu takip etmez, kapıda ödeme (recaudo) tahsil etmez ve Droop teslim noktaları sunmaz; bunlar için Coordinadora portalını kullanın. Uluslararası varışlar sabit fiyatları kullanır.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Coordinadora lisans bloğu, Modules > Module Manager > VibeFox Coordinadora > Configure sayfasının ayarlardan önceki ilk bloğudur. 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 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: presta-shipping-coordinadora satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure iznine sahip ç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 tarihiyle 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 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, çok mağazalı kurulumda 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 Coordinadora taşıyıcısı ödeme sırasında müşterilere gösterilmez ve tarife hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırasında test edemezsiniz. Modules > Module Manager içinde 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ıştığınız sürece 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

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. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin. Countries, ağırlık sınırları ve Minimum order subtotal değerlerini kontrol edin. Canlı teklif yoksa ülke veya * için bir sabit fiyat bulunmalıdır. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlandırılabilir.

Canlı teklif gösterilmiyor, yalnızca sabit fiyat görünüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Tipik nedenler: varış şehri tanınmıyor, bir üründe ağırlık veya boyut yok, çıkış DANE kodu ya da COP kuru eksik ya da Coordinadora bir hata döndürdü.

Varış şehri tanınmıyor: şehir alanına DANE kodunu yazan bir Kolombiya departman ve şehir ödeme modülü kurun. Geliştiriciler, modülün actionVfdCrdDaneCities ve actionVfdCrdDestinationDane hook'larıyla daha fazla şehri eşleyebilir veya actionVfdCrdApiUrl ile API adresini değiştirebilir.

Teklif vergiyi içeriyor mu? Teklif, Coordinadora'nın verdiği tutardır. Tax kuralıyla PrestaShop kargo vergisini üzerine ekler; teklif vergiyi zaten içeriyorsa No tax seçin.

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

Sayfa Coordinadora taşıyıcısının bulunamadığını bildiriyor: taşıyıcı Shipping > Carriers bölümünde silindi. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Coordinadora yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve ö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 korunur. Modülü yeniden kurmak veya bir Reset işlemi, kayıtlı taşıyıcıya daha önceki durumunu geri verir: kapattığınız bir taşıyıcı kapalı kalır.

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