VibeFox Envioclick for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Envioclick hesabı (yalnızca canlı fiyatlar için): API erişimi olan, Meksika veya Kolombiya'da bir Envioclick hesabı. API anahtarı, Envioclick hesabınızda Mi cuenta (sağ üstte) > Información del API altında yer alır. Yalnızca sabit fiyatlar kullanıyorsanız Envioclick hesabına ihtiyacınız yoktur.

User-Agent (yalnızca Meksika): Envioclick Meksika, her API isteği için bir User-Agent değeri gerektirir. Bu değeri Envioclick desteğinden isteyin (soporte.tecnico@envioclick.com).

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

Kurulum

1. Yönetim panelinde 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 Envioclick modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bölümünde License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. API anahtarını girin, API ülkesini seçin, User-Agent değerini (Meksika), çıkış posta kodunu veya DANE kodunu ve çıkış adresini girin. Mağazanızın varsayılan para birimi MXN veya COP değilse para birimi dönüşüm kurunu girin. Kolombiya için sayfa öneriyorsa Add Colombian departments düğmesine tıklayın.

5. İsteğe bağlı olarak ülke bazında sabit fiyatlar ve yedek ücret ekleyin, ardından Save düğmesine tıklayın.

Kurulumda modül, Courier delivery by the best Envioclick carrier teslimat süresi metniyle Envioclick Shipping kargo firmasını oluşturur. Kargo firması 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. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasında bulunur: Modules > Module Manager > VibeFox Envioclick > Configure. 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ış Envioclick tekliflerini de temizler. Sayısal alanlar ondalık ayracı olarak hem nokta hem virgül kabul eder.

Bir API anahtarı ayarlandığında, canlı fiyatlar çalışamıyorsa sayfanın üstünde uyarılar gösterilir: MXN veya COP dışındaki bir mağaza para birimi için dönüşüm kuru yoksa, Meksika için User-Agent yoksa, çıkış posta kodu veya DANE kodu yoksa ya da Kolombiya için çıkış adresi yoksa. Sayfa ayrıca mağazanızın ağırlık veya boyut birimi tanınmıyorsa uyarır; International > Localization bölümünde (Local units) kg, g, lb veya oz ile cm, mm, m veya in seçin. Kaydederken modül; Method title alanının geçerli bir kargo firması adı olduğunu, sayısal alanların negatif olmayan sayılar içerdiğini, Currency conversion rate değerinin 0'dan büyük olduğunu, Minimum weight değerinin Maximum weight değerinden büyük olmadığını ve çıkış kodunun Meksika için 5 haneli, Kolombiya için 8 haneli (veya 5 haneli belediye kodu) olduğunu kontrol eder. Bir kontrol başarısız olursa hata gösterilir ve hiçbir şey kaydedilmez.

Genel

Kargo firmasının bölgeleri, müşteri grupları ve boyut sınırları Shipping > Carriers bölümünde ayarlanır (ya da aşağıdaki Ignore shipping zones seçeneğini kullanın). Bu sayfadaki ayarlar tüm bölgelere uygulanır.

Enable Envioclick: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Method title: müşterinin sepette ve ödeme sayfasında gördüğü kargo firması adı. Varsayılan: Envioclick Shipping. Zorunlu.

Carrier in the title: canlı fiyatın Envioclick kargo firmasını ve tahmini teslimat süresini, ödeme sayfasında kargo firmasının altında gösterir, örneğin «Estafeta Express, 1 day». Kargo firması her durumda siparişe kaydedilir ve sipariş sayfalarında gösterilir. Varsayılan: açık.

Envioclick API (canlı fiyatlar)

İsteğe bağlı. API anahtarı olmadan yalnızca sabit fiyatlar kullanılır. Bu bölüm Meksika ve Kolombiya için Envioclick API belgelerine bağlantılar içerir. Canlı fiyatlar yalnızca API ülkesindeki hedefler için istenir. Diğer ülkelere gönderimler sabit fiyatları kullanır.

API key: Mi cuenta > Información del API bölümünden aldığınız Envioclick API anahtarınız. «Authorization» üstbilgisinde gönderilir. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it metnini 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 Yes seçin ve kaydedin; bundan sonra yalnızca sabit fiyatlar kullanılır. API key alanına girilen bir anahtar, kayıtlı olanın yerine geçer.

API country: Envioclick hesabınızın ülkesi.

Colombian departments: yalnızca Kolombiya. PrestaShop'ta varsayılan olarak Kolombiya illeri yoktur. Bunlar olmadan yalnızca Kolombiya'da benzersiz olan şehir adları tanınır; il, aynı ada sahip belediyeleri birbirinden ayırır. Add Colombian departments düğmesi 33 ili Kolombiya'nın eyaletleri olarak ekler (ISO kodları ANT, DC vb.), Kolombiya için «Contains states» seçeneğini açar ve Kolombiya adres formuna il alanını ekler. Zaten var olan iller tekrar eklenmez. Her şey hazır olduğunda alan, Kolombiya adreslerinin kaç ile sahip olduğunu gösterir.

User-Agent (Meksika): Envioclick desteğinin verdiği değer (soporte.tecnico@envioclick.com), örneğin EcUserAgent-2/123456. Meksika için zorunludur; bu olmadan Meksika için canlı fiyatlar istenmez. Kolombiya için isteğe bağlıdır.

Kargo firması seçimi: Cheapest (varsayılan) veya Fastest (then cheapest). Envioclick birkaç kargo firmasından fiyat teklifi döndürür ve müşteri tek bir fiyat görür.

Şube teslim alma fiyatları: müşterinin paketi kargo firmasının şubesinden teslim aldığı «Ocurre» fiyatlarını da dikkate alır. Kapalıyken yalnızca adrese teslimat fiyatları kullanılır. Kapıda ödeme (COD) hizmetleri hiçbir zaman kullanılmaz. Varsayılan: kapalı.

Para birimi dönüşüm kuru: Envioclick MXN (Meksika) veya COP (Kolombiya) cinsinden teklif verir. Mağazanızın varsayılan para birimi farklıysa, mağaza para biriminde 1 MXN veya 1 COP'un değerini girin, örneğin 0.05. Paketin beyan edilen değeri de aynı şekilde dönüştürülür. Mağaza para birimi MXN veya COP ise alanı boş bırakın. Kur olmadan, başka bir para biriminde canlı fiyatlar kullanılmaz.

Gönderici adresi

Canlı fiyatlar için kullanılır. Mağaza API ülkesindeyse boş alanlar Shop Parameters > Contact > Stores bölümündeki mağaza adresinden doldurulur.

Origin postcode / DANE code: Meksika: 5 haneli posta kodu. Kolombiya: belediyenin 8 haneli DANE kodu, örneğin Bogotá için 11001000; 5 haneli belediye kodu (11001) da çalışır.

Origin address: teslim alma adresinin cadde ve numarası. Kolombiya için zorunlu, Meksika için isteğe bağlıdır.

Sabit fiyatlar

Canlı fiyat olmadığında kullanılır: API anahtarı yoksa, hedef API ülkesinin dışındaysa, API hatası varsa veya rota için kargo firması yoksa.

Price per country: 2 harfli ülke kodları ile mağazanın varsayılan para biriminde, vergi hariç fiyatların tablosu. Bir ülke eklemek için Add row düğmesine, birini silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkeler için ülke kodu olarak * kullanın.

Fallback cost: canlı fiyat olmadığında ve tablodaki hiçbir satır eşleşmediğinde kullanılır. Bu durumda kargo firmasını gizlemek için alanı boş bırakın.

Fixed price applies: Per order fiyatı bir kez tahsil eder. Per item (price × quantity) fiyatı sepetteki ürün sayısıyla çarpar. Envioclick canlı fiyatları her zaman gönderi başınadır.

Koşullar

Minimum weight: sepet ağırlığı bu değerin altındaysa kargo firmasını gizler (kg cinsinden). 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet ağırlığı bu değerin üstündeyse kargo firmasını gizler (kg cinsinden). Varsayılan: 25. 0 sınır olmadığı anlamına gelir.

Minimum order amount: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergi öncesi) en az bu tutara ulaştığında gösterir. Her zaman göstermek için alanı boş bırakın.

Free shipping from: sepet ara toplamı (indirimlerden sonra, vergi öncesi) bu tutara ulaştığında ücretsiz kargo. Bu durumda Envioclick'e istek gönderilmez. Hiçbir zaman ücretsiz kargo vermemek için alanı boş bırakın.

Tax: kargo firmasının vergi kuralı veya No tax. Envioclick fiyat teklifleri zaten kargo firmalarının vergilerini içerir; bu nedenle kargoya iki kez vergi uygulanmaması için No tax seçeneğini seçin.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde kargo firması, Shipping > Carriers bölümünde kendisine atanmış bölgelerde sunulur.

Ignore shipping zones: kargo firması bölgelerine atanmamış olsa bile aşağıdaki ülkeler için Envioclick sunar. Açtığınızda kargo firması, daha sonra oluşturulan bölgeler dahil tüm bölgelere atanır. Kapattığınızda kargo firması önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın (aktif ülkeler). Yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını ve API hatalarını modül klasöründeki logs/vfd_evc_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API anahtarı ve müşteri adresleri kaydedilmez. Günlük kapalıyken hiçbir şey yazılmaz. İşiniz bittiğinde kapatın.

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çıkken modülü kaldırmak Envioclick ayarlarını, kargo firmasını, önbellekteki teklifleri ve günlükleri siler. Eski siparişlerle kaydedilen kargo firması korunur. Kapalıyken yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop modülden Envioclick fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: Ignore shipping zones ülkeleri, sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Envioclick'e istek gönderilmez.

Bir API anahtarı ayarlıysa ve hedef API ülkesindeyse modül Envioclick'ten fiyat teklifleri ister. Meksika'da istek, müşteri 5 haneli bir posta kodu girdiğinde yapılır. Kolombiya'da ise il ve belediye tanındığında yapılır (aksan ve büyük/küçük harf fark etmez). Modül, kapıda ödeme olmayan en ucuz veya en hızlı teklifi seçer ve bunu mağazanızın varsayılan para birimine çevirir. Fiyat, ardından müşterinin sepet para biriminde gösterilir.

Paket her zaman tek bir kutudur: toplam ağırlık kg'a çevrilir; en büyük ürünün uzunluğu ve genişliği, tüm ürünlerin toplam hacmini koruyan bir yükseklikle birlikte kullanılır. Boyutu olmayan ürünler 10 × 10 × 10 cm sayılır. Ağırlığı olmayan bir sepet 0,5 kg olarak gönderilir. Beyan edilen değer, sepet ara toplamıdır.

Her teklif, aynı rota ve aynı paket için 1 saat önbelleğe alınır. Başarısız bir istek 10 dakika önbelleğe alınır, böylece erişilemeyen bir API her ödeme sayfası güncellemesini yavaşlatmaz. API zaman aşımı 10 saniyedir. Envioclick bir hata veya rota için kargo firması bulamazsa müşteri hata görmez: sabit fiyat kullanılır veya kargo firması gizlenir. Nedeni hata ayıklama günlüğüne yazılır.

Siparişleri olan kargo firmasını Shipping > Carriers bölümünde düzenlerseniz PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak takip eder.

Modül yalnızca fiyat hesaplar. Kargo belgesi veya etiket oluşturmaz, kargo alımı talep etmez, gönderileri izlemez veya iptal etmez. Kargo firmaları arasında seçim değil, tek bir fiyat sunar ve kapıda ödeme hizmetleri ile çoklu paket teklifleri kullanmaz. Canlı fiyatlar yalnızca ülke içidir.

Siparişler

Envioclick kargo firmasıyla bir sipariş verildiğinde, sepeti için hesaplanan fiyat siparişle birlikte kaydedilir ve artık değişmez. Yönetici sipariş sayfasında, Envioclick carrier, Estimated delivery ve Envioclick rate ID (canlı fiyat için), Price source (Envioclick live rate, Fixed price per country, Fallback cost veya Free shipping threshold) ve Calculated price (excl. tax) içeren Envioclick shipping bloğu gösterilir. Canlı fiyat için müşterinin sipariş sayfasında Shipping carrier gösterilir. Kargo belgesini Envioclick hesabınızda oluşturun.

Sabit fiyatla verilen siparişlerde Envioclick kargo firması yoktur.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Envioclick lisans bloğu, Modules > Module Manager > VibeFox Envioclick > Configure sayfasındaki ilk bloktur ve ayarların üstündedir. 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 son tarihi ve alan adınızı) ve şu düğmeleri gösterir: 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. Bunların altında Product: presta-shipping-envioclick 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 yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, ö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, çoklu mağaza kurulumunda da. 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 Envioclick kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden kargo firması sizin için de gizlenir: modülü 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 yenileme gerektirir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Envioclick ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Envioclick seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries değerini kontrol edin. Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Canlı fiyat yoksa kargo firmasının ülke için bir sabit fiyata, bir * satırına veya bir Fallback cost değerine ihtiyacı vardır. Ürünler, ürün sayfasında belirli kargo firmalarıyla da sınırlandırılmış olabilir.

Canlı fiyatlar görünmüyor: modül sayfasının üstündeki uyarıları okuyun, ardından Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Yaygın nedenler: dönüşüm kuru yok (mağaza para birimi MXN veya COP değil), User-Agent yok (Meksika), çıkış posta kodu veya DANE kodu yok, müşterinin posta kodu (Meksika) veya şehri (Kolombiya) henüz girilmemiş, hedef API ülkesinin dışında veya rota için kargo firması yok.

Neden bir dönüşüm kuru gerekiyor? Envioclick fiyatları yalnızca Meksika veya Kolombiya pesosu cinsinden döndürür. Modül, peso tutarını asla başka bir para birimi gibi göstermez.

Kolombiya: şehir tanınmıyor: müşterilerin ili seçebilmesi için modül sayfasında Add Colombian departments düğmesine tıklayın ve belediye adının doğru yazıldığını kontrol edin. Posta kodu olarak girilen 8 haneli bir DANE kodu da çalışır.

Kargoda vergi iki kez alınıyor: Envioclick fiyat teklifleri zaten kargo firmalarının vergilerini içerir. Tax değerini No tax olarak ayarlayın.

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

Sayfa, Envioclick kargo firmasının bulunamadığını belirtiyor: kargo firması 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.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Envioclick yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbelleğe alınmış teklifler ve siparişi olmayan sepetlerin kayıtlı fiyatları her zaman silinir. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişlerini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kayıtlı kargo firmasına önceki durumunu geri verir. Verilen siparişlerin Envioclick verileri her iki durumda da saklanır.

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