VibeFox Chilexpress for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

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; üretim 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.

VibeFox lisans anahtarı: vibefox.net'ten satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_chilexpress klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Chilexpress ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Fiyat tablosunu doldurun. Canlı tarifeler için iki abonelik anahtarını, çıkış (origin) county kodunu ve mağaza para birimi CLP değilse CLP döviz kurunu girin, ardından tarife kaynağını seçin (bkz. Yapılandırma).

6. Şili için bir kargo bölgesine WooCommerce > Settings > Shipping > Shipping zones sayfasından VibeFox Chilexpress ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Chilexpress. Tüm kargo bölgelerinde geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için ödeme sayfasında görünen kargo seçeneğinin adı. Genel Name değerini kullanmak için boş bırakın.

Ayarlar sayfası sorunları üstte listeler: API tarifeleri seçili ama bir anahtar, çıkış county kodu ya da CLP döviz kuru eksik, ya da fiyat tablosunda Şili veya * Default için satır yok. Ayarları her kaydettiğinizde önbelleğe alınmış tarifeler ve comuna listeleri temizlenir. Sayılar nokta ya da virgülle yazılabilir; geçersiz bir sayı kaydedilmez ve bir hata gösterilir.

Genel

Enable/Disable: Chilexpress kargosunu tüm bölgelerde aynı anda açar ya da kapatır.

Name: müşterinin ödeme sayfasında gördüğü kargo yöntemi adı. Default: Chilexpress.

Tax status: Taxable (vergi etkinse) WooCommerce vergisini kargo ücretine ekler, None eklemez. Chilexpress API tarifeleri teklif edildiği gibi kullanılır. Teklif zaten IVA içeriyorsa ve mağazanız üzerine bir vergi daha ekleyecekse None seçin.

Tarifeler

Rate source: fiyatın nereden geldiği.

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

Country prices: varış ülkelerinin bir tablosu; Price sütunu ve mağaza para biriminde paket boyutuna göre isteğe bağlı fiyatlar içerir. 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 üzerinde 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 çarpıya tıklayın. * Default satırı, kendi satırı olmayan ülkelere uygulanır. Satırı olmayan (ve * satırı da olmayan) bir ülke sabit fiyat almaz. Fiyatı ve boyut fiyatı ikisi de 0 olan bir satır ücretsiz kargo verir.

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

Chilexpress API (canlı tarifeler)

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 (ödeme sayfasındaki Şehir alanı).

Origin county code: gönderim yaptığınız Chilexpress county (comuna) kodu, 2–5 harf, örneğin STGO (Santiago Centro), PROV (Providencia), LCON (Las Condes), VALP (Valparaíso) veya CONC (Concepción). 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ğaza para birimi CLP değilse gerekir: mağaza para biriminde 1 CLP'nin fiyatı, örneğin 0.001. Bu olmadan API tarifeleri kullanılmaz.

Uygunluk

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

Max weight (kg): sepet ağırlığı bu değerin üstündeyse yöntem gizlenir. Default: 25. 0 sınır olmadığı anlamına gelir.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergisiz) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir ürün bu WooCommerce kargo sınıflarından birine aitse yöntemi gizler.

Ignore shipping zones: yöntemi bir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için sunar.

Countries: bu mod için varış ülkeleri. Mağazanın tüm kargo ülkelerini kullanmak 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 etkinleştirir.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Yalnızca Free shipping açıkken kullanılır. Bu durumda API isteği yapılmaz.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamalarını WooCommerce > Status > Logs sayfasında, kaynak vfd-chilexpress olarak kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarları asla kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını ve bölge yöntemlerini kaldırır. Devre dışı bırakmak ayarları asla silmez. Mevcut siparişlerin kargo satırları her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse müşteri ücretsiz bir tarife alır ve Chilexpress'e hiçbir istek gönderilmez.

Şili'deki bir adres ve API tarife kaynağı için eklenti bölgeyi ve comuna'yı Şehir alanından alır ve bu bölgenin comuna listesinde (Coverage API) Chilexpress county kodunu arar. Aksanlar, boşluklar ve yazım varyantları yok sayılır; böylece Ñuñoa ve Nunoa eşleşir, Santiago de Santiago Centro ile eşleşir. Şehir alanına yazılan bir county kodu da kabul edilir. Ardından eklenti 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 üst üste) ve beyan edilen değer olarak CLP cinsinden sepet ara toplamını gönderir. Chilexpress servisleri döndürür; eklenti seçilen ya da en ucuz servisi kullanır ve pesoyu mağaza para birimine çevirir. Servis adı siparişin kargo satırına Chilexpress service olarak kaydedilir.

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, fiyatı olan bir servis ya da tanınmayan bir comuna dönerse müşteri hiçbir hata görmez. Yöntem yalnızca API modunda gizlenir ya da sabit fiyat kullanılır. Nedeni WooCommerce günlüğüne yazılır.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca tarifeleri 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ızda oluşturun. Müşteriler bir Chilexpress şubesi seçemez ve comuna seçici yoktur: müşteri comuna'yı standart Şehir alanına yazar. Uluslararası gönderiler sabit fiyatları kullanır.

Lisans anahtarı

Eklenti vibefox.net'ten alınan bir VibeFox lisans anahtarı ile çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Chilexpress sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar aktif olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Chilexpress ödeme sayfasında müşterilere gösterilmez. Giriş yapmış mağaza yöneticileri yine de (unlicensed — visible to admins only) ibaresiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma çıkar. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Chilexpress ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Sabit fiyatlarla, ülkenin ya da * Default satırının olup olmadığına bakın.

Canlı tarife gösterilmiyor, bunun yerine sabit fiyat kullanılıyor: önce ayarlar sayfasının üstündeki uyarılara bakın. Yoksa Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd-chilexpress olarak açın. Olası nedenler: Chilexpress'in tanımadığı bir comuna (Şehir alanını ve bölgeyi kontrol edin), yanlış ürün ya da ortam için bir anahtar ya da Chilexpress kapsamı olmayan bir varış noktası.

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

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

API tarifeleri IVA ile mi yoksa IVA olmadan mı? Chilexpress'in teklif ettiği gibi kullanılır. Mağazanız kargoya vergi ekliyorsa ve teklif zaten IVA içeriyorsa Tax status değerini None yapın.

Bir değişiklikten sonra tarifeler güncel görünmüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış tarifeleri ve comuna listelerini temizler.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur; yalnızca önbelleğe alınmış tarifeleri ve comuna listelerini temizler. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekler her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için kalırlar. Mevcut siparişlerin kargo satırları her zaman korunur.

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