VibeFox Chilexpress for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri; canlı tarifeler için cURL uzantısıyla birlikte. Modül, eski PHP sürümlerine kurulmaz.

Chilexpress API anahtarları (yalnızca canlı tarifeler için): Chilexpress geliştirici portalında (developers.wschilexpress.com) bir hesap oluşturun ve iki ürüne abone olun: Rating (Cotizador) ve Coverage (Coberturas / Georreferencia). Her ürünün kendi abonelik anahtarı vardır. Test anahtarları yalnızca test ortamında çalışır; canlı anahtarlar, müşteri sözleşmesi bulunan Chilexpress kurumsal müşterilerine verilir. Ayrıca gönderdiğiniz comuna'nın Chilexpress county kodu da gerekir, örneğin STGO. Yalnızca sabit fiyat kullanıyorsanız API anahtarlarına ihtiyacınız yoktur.

Şili bölgeleri (yalnızca canlı tarifeler için): canlı tarifeler, teslimat adresinin bölgesini gerektirir. PrestaShop'ta varsayılan olarak Şili bölgesi yoktur; modül bunları sizin için ekleyebilir (aşağıdaki Chilean regions bölümüne bakın). Mağazada Chile ülkesi bulunmalıdır.

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

Kurulum

1. Back office'te 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 Chilexpress 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. Country prices tablosunu doldurun. Canlı tarifeler için iki abonelik anahtarını, gönderim county kodunuzu ve mağaza para birimi CLP değilse CLP döviz kurunu girin; sayfa isterse Add Chilean regions düğmesine tıklayın; ardından tarife kaynağını seçin (bkz. Yapılandırma) ve Save düğmesine tıklayın.

Kurulumda modül, Chilexpress taşıyıcısını Chilexpress courier teslimat süresi metniyle oluşturur. Taşıyıcı, Chile bölgesine ve tüm müşteri gruplarına bağlanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers içinden değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir. Chilexpress'i başka bölgelerde sunmak için bu sayfada bölgeleri taşıyıcıya ekleyin veya Ignore shipping zones seçeneğini açın.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Chilexpress > 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ış Chilexpress tarifelerini ve comuna listelerini de temizler. Değişiklikler modül için "configure" iznini gerektirir; bu izin yoksa sayfa You do not have permission to configure this module. mesajını gösterir.

Sayfa, sorunları en üstte listeler: API tarifeleri seçili ama bir anahtar, gönderim county kodu veya CLP döviz kuru eksik; fiyat tablosunda Şili veya varsayılan için satır yok; mağazada Şili bölgesi yok ya da Şili adres formunda bölge alanı yok; mağazanın ağırlık veya boyut birimi modül tarafından bilinmiyor (bu durumda kg veya cm olarak okunur; International > Localization bölümünde, Local units olarak ayarlayın); taşıyıcı silinmiş. Sayılar, back office dilinizdeki gibi nokta ya da virgülle girilebilir. Geçersiz veya negatif bir sayı, 0 olan bir CLP exchange rate, Max weight (kg) değerinden büyük bir Min weight (kg) ya da 64 karakterden uzun bir Name hatadır ve siz düzeltene kadar hiçbir şey kaydedilmez.

Genel

Enable/Disable: Chilexpress kargosunu açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Name: müşterinin ödeme sayfasında gördüğü kargo yönteminin adı. Taşıyıcının adıdır. Varsayılan: Chilexpress. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı veya No tax (yeni bir taşıyıcının varsayılanı). Chilexpress API tarifeleri teklif edildiği gibi kullanılır. Teklif zaten IVA içeriyorsa ve mağazanız üzerine ayrıca vergi ekleyecekse No tax seçin.

Tarifeler

Rate source: fiyatın nereden geldiği.

Canlı tarifeler yalnızca Şili'deki varış noktaları için kullanılabilir. Diğer ülkeler her zaman sabit fiyatları kullanır.

Country prices: Price sütunu ve isteğe bağlı paket boyutu fiyatlarıyla varış ülkelerinin tablosu; mağazanızın varsayılan para biriminde, vergisiz. Boyut, sepet ağırlığından belirlenir: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L, 5 kg üzeri XL. 0 bırakılan bir boyut Price değerini kullanır. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. * Default satırı, kendi satırı olmayan ülkeler için geçerlidir. Satırı olmayan bir ülkenin (ve * Default yoksa) sabit fiyatı yoktur, bu yüzden taşıyıcı orada gizlenir. Fiyatı ve boyut fiyatları 0 olan bir satır ücretsiz kargo verir. Boş tablo, Şili için 0 fiyatlı bir satırla gösterilir; son satır silinemez, yalnızca 0'a sıfırlanabilir. Bu nedenle sayfayı kaydetmeden önce gerçek fiyatları girin. Tekrarlanan bir ülke veya geçersiz bir fiyat düzeltilir (kopya yok sayılır, fiyat 0 yapılır) ve bir uyarı düzeltmeleri listeler.

Calculation type: Per order sabit fiyatı bir kez alır. Per item (fixed price x number of items) ise sepetteki ürün sayısıyla çarpar. Chilexpress API tarifesi her zaman tüm paket için teklif edilir.

Chilexpress API (canlı tarifeler)

Bu bölüm, geliştirici portalına ve Rating ile Coverage abonelik sayfalarına bağlantılarla başlar.

Test environment: Chilexpress test ortamını kullanır (qaservices.wschilexpress.com). Test anahtarlarıyla kullanın ve canlı bir mağazada kapatın.

Rating API key: Rating (Cotizador) ürününün abonelik anahtarı.

Coverage API key: Coverage (Coberturas / Georreferencia) ürününün abonelik anahtarı. Müşterinin comuna'sının Chilexpress county kodunu bulmak için kullanılır (adresin Şehir alanı ve bölgesiyle birlikte).

Kaydettikten sonra anahtar alanı boş kalır ve Saved — leave empty to keep it. ibaresini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Anahtar, yazdığınız gibi kaydedilir; yalnızca çevresindeki boşluklar silinir.

Remove the saved Rating API key ve Remove the saved Coverage API key: yalnızca kayıtlı bir anahtar varken görünür. Seçeneği işaretleyip Save düğmesine tıklayarak anahtarı silin.

Origin county code: gönderdiğiniz yerin Chilexpress county (comuna) kodu; 2 ila 5 harf, örneğin STGO (Santiago Centro), PROV (Providencia) veya VALP (Valparaíso). Kurulumdan sonra boştur. County kodu olmayan bir değer hatayla reddedilir.

Service: tarife için kullanılan Chilexpress servisi. Varış noktası için sunulmuyorsa sunulan en ucuz servis kullanılır.

CLP exchange rate: Chilexpress tarifelerini Şili pesosu olarak verir. Yalnızca mağazanızın varsayılan para birimi CLP değilse gerekir: 1 CLP'nin o para birimindeki fiyatı, örneğin 0.001. Bu olmadan API tarifeleri kullanılmaz. Mağaza para birimi CLP ise boş bırakın. Değer 0'dan büyük olmalıdır.

Chilean regions: Şili comuna'ları bölgeye göre aranır; bu nedenle canlı tarifeler adresin bölgesini gerektirir. Mağazada Şili bölgesi yoksa alan Add Chilean regions düğmesini gösterir. Bu düğme 16 bölgeyi Chile'nin eyaletleri olarak ekler (ISO kodları RM, VS…), Chile için "Contains states" seçeneğini açar ve bölge alanını Şili adres formuna ekler. Zaten var olan bölgeler (kod veya ad bakımından) iki kez eklenmez. Her şey hazır olduğunda alan, bölge sayısıyla birlikte Chilean addresses have a region ibaresini gösterir.

Kullanılabilirlik

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

Max weight (kg): taşıyıcı, bu sepet ağırlığının üzerinde gizlenir. Varsayılan: 25. 0, sınır olmadığı anlamına gelir; boş alan 25 kg anlamına gelir. Min weight (kg) bu değerden büyük olamaz.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergisiz) en az bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Ignore shipping zones: aşağıdaki ülkeler için bölgeleri taşıyıcıya bağlı olmasa bile taşıyıcıyı sunar: taşıyıcı tüm bölgelere bağlanır ve sonradan oluşturulan bölgeler de bağlanır. Kapatıldığında taşıyıcı önceki bölgelerini geri alır.

Countries: bu mod için varış ülkeleri; mağazanın etkin ülkeleri arasından seçilir. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Ücretsiz kargo

Free shipping: ücretsiz kargo eşiğini açar.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergisiz). Yalnızca Free shipping açıkken kullanılır. Bu durumda API'ye istek gönderilmez.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamalarını modül klasöründeki logs/vfd_chx_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarları ve müşteri adresleri hiçbir zaman kaydedilmez.

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 tüm modül ayarlarını, taşıyıcıyı, önbelleğe alınmış tarifeleri, günlükleri ve siparişlerle kaydedilen servisleri siler. Kapalıysa yeniden kurulum için her şey saklanır. Siparişler her zaman saklanır.

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

Kargo adımında PrestaShop, modülden Chilexpress fiyatını ister. Yalnızca kargo gerektiren ürünler hesaba katılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Ara toplam, sepet kurallarından (kuponlardan) sonra, vergisiz ve mağazanızın varsayılan para biriminde alınır. Modül önce koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve Chilexpress'e hiçbir istek gönderilmez.

Şili'deki bir adres ve API tarife kaynağı için modül, adresin bölgesini ve Şehir alanındaki comuna'yı alır, bu bölgenin comuna listesinde Chilexpress county kodunu arar (Coverage API). Aksanlar, boşluklar ve yazım varyantları yok sayılır; böylece Ñuñoa ile Nunoa eşleşir, Santiago da Santiago Centro ile eşleşir. Şehir alanına doğrudan yazılan bir county kodu da kabul edilir. Ardından modül, Rating API'ye çıkış ve varış county kodlarını, sepet ağırlığını (en az 0,1 kg), paket boyutlarını (en büyük ürünün uzunluğu ve genişliği, yükseklikler toplamı) ve sepet ara toplamını beyan edilen değer olarak CLP cinsinden gönderir. Chilexpress servislerini döndürür; modül seçilen servisi veya en ucuzunu kullanır ve pesodaki tutarı mağazanızın varsayılan para birimine çevirir. Fiyat, o para biriminin ondalık basamaklarına yuvarlanır ve ardından müşterinin sepet para biriminde gösterilir.

Tarifeler 1 saat, comuna listeleri 7 gün önbelleğe alınır. Başarısız bir istek 5 dakika hatırlanır; böylece yavaş ya da erişilemeyen bir API her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 10 saniyedir. Chilexpress bir hata döndürürse, fiyatlı bir servis dönmezse ya da comuna veya bölge bilinmiyorsa müşteri hata görmez. Yalnızca API modunda taşıyıcı gizlenir; aksi halde sabit fiyat kullanılır. Nedeni hata ayıklama günlüğüne yazılır.

Bir taşıyıcının siparişleri olduktan sonra Shipping > Carriers bölümünde düzenlerseniz, PrestaShop onu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca tarife hesaplar. Gönderi veya taşıma siparişi (OT) oluşturmaz, etiket basmaz, kurye randevusu almaz ve paketleri takip etmez; gönderiyi Chilexpress hesabınızdan oluşturun. Müşteriler bir Chilexpress şubesi seçemez ve comuna seçici yoktur: müşteri comuna adını standart Şehir alanına yazar. Uluslararası gönderiler sabit fiyatları kullanır.

Siparişler

Chilexpress taşıyıcısıyla bir sipariş verildiğinde modül, fiyatının nasıl hesaplandığını kaydeder. Back office'teki sipariş sayfası, Chilexpress service (canlı bir tarife için Chilexpress'in teklif ettiği servis, örneğin Express) ve Price source alanlarını içeren bir Chilexpress bloğu gösterir: Live rate (Chilexpress Rating API), Fixed price veya Free shipping.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Chilexpress lisans bloğu, Modules > Module Manager > VibeFox Chilexpress > 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-chilexpress 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 Chilexpress taşıyıcısı ödeme sayfası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 sayfası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

Chilexpress ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable 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 (ya da Ignore shipping zones açık olmalı ve ülke Countries içinde olmalıdır). Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Sabit fiyatlarda ülkenin veya * Default satırının olduğunu kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlanmış olabilir.

Şili'deki kargo olması gerekirken ücretsiz: Country prices içindeki Şili satırının (ya da * Default satırının) Price ve boyut sütunlarında 0 yazıyor. Fiyatları girin ve Save düğmesine tıklayın.

Canlı tarife gösterilmiyor, bunun yerine sabit fiyat kullanılıyor: önce modül sayfasının üstündeki uyarılara bakın. Uyarı yoksa Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Tipik nedenler: adresin bölgesi yok ya da bölge alanı eksik (Add Chilean regions kullanın), Chilexpress'in tanımadığı bir comuna (Şehir alanını ve bölgeyi kontrol edin), yanlış ürün veya ortam için bir anahtar ya da Chilexpress kapsamı dışında bir varış noktası.

Günlükte HTTP 401 veya 403: abonelik anahtarı yanlış, etkin değil ya da başka bir ürüne veya ortama ait. Test anahtarları yalnızca Test environment açıkken çalışır.

Farklı para birimli bir mağazada API tarifeleri kullanılmıyor: CLP exchange rate değerini girin.

API tarifeleri IVA dahil mi, hariç mi? Chilexpress'in teklif ettiği gibi kullanılırlar. Mağazanız kargoya vergi ekliyorsa ve teklif zaten IVA içeriyorsa Tax seçeneğini No tax olarak ayarlayın.

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

Sayfa "The Chilexpress carrier was not found" diyor: taşıyıcı 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.

Sayfa "The country Chile does not exist in this shop" diyor: International > Locations > Countries bölümünde Chile'yi ekleyin veya etkinleştirin, ardından Add Chilean regions düğmesini kullanın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Chilexpress 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ış tarifeler ve comuna listeleri her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, günlük ile siparişlerle kaydedilen servisler 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, kaydedilmiş taşıyıcıyı önceki durumuyla geri getirir. Add Chilean regions ile eklenen Şili bölgeleri mağazada kalır.

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