VibeFox Coordinadora for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

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ı etkin 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 gerekir. Anahtar olmadan yöntem yalnızca sabit fiyatlarla çalışır.

Ürünler: canlı teklif için sepetteki her ürünün ağırlığı ve boyutları (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

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_coordinadora 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 Coordinadora veya 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. API anahtarını, gönderim şehrinin DANE kodunu ve mağaza para biriminiz COP değilse COP döviz kurunu girin. Yedek olarak Kolombiya için en az bir sabit fiyat ekleyin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde Kolombiya'yı kapsayan bir kargo bölgesine VibeFox Coordinadora ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.

7. Ürünlerinizin ağırlık ve boyut bilgilerinin olduğundan emin olun.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Coordinadora. 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ölgede müşteriye gösterilen kargo yöntemi adı. Genel Name değerini kullanmak için boş bırakın.

Ayarlar sayfası, canlı teklifler çalışamadığında veya yöntem gizlenecekse sayfanın üstünde uyarılar gösterir: gönderim DANE kodu eksik veya geçersizdir, COP döviz kuru eksiktir ya da Kolombiya için sabit fiyat yoktur. Ayarları her kaydettiğinizde önbellekteki teklifler temizlenir. Sayılar nokta veya virgülle girilebilir (9,99 = 9.99).

Genel

Enable/Disable: Coordinadora'yı tüm bölgelerde aynı anda açar veya kapatır.

Name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Coordinadora. Bir bölgenin Title değeri bunun yerine geçer.

Tax status: Taxable ücrete WooCommerce kargo vergisini ekler, None eklemez. Fiyatlarınız veya Coordinadora teklifi vergiyi zaten içeriyorsa None seçin.

Coordinadora canlı kargo ücretleri

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

API key: Coordinadora'dan aldığınız WooCommerce API anahtarınız. Hiçbir zaman günlüğe yazılmaz.

Origin city (DANE code): gönderdiğiniz ş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 teklifleri Kolombiya pesosu cinsinden verir. Mağaza 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. Mağaza para biriminiz COP ise boş bırakın.

Sabit fiyatlar (API anahtarı olmadığında, Kolombiya dışındaki varış noktaları için ve canlı teklif alınamadığında yedek olarak kullanılır)

Prices by country: Price sütunu ve mağaza para biriminizde isteğe bağlı paket boyutu fiyatları içeren bir ülke tablosu. Boyut, sepet ağırlığından belirlenir: 1 kg'a kadar XS, 1–2 kg S, 2–3 kg M, 3–5 kg L, 5 kg'ın üzerinde XL. 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ı işaretine tıklayın. * All other countries ülkesi, kendi satırı olmayan ülkeler için geçerlidir. Satırı olmayan (ve * de olmayan) bir ülke için sabit fiyat yoktur. Price değeri 0 olan ve boyut fiyatı olmayan bir satır ücretsiz kargo verir.

Fixed price per: Order fiyatı bir kez tahsil eder. Item (price × quantity) ise 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 (kg): bu sepet ağırlığının altında yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Max weight (kg): bu sepet ağırlığının üzerinde yöntemi gizler. Varsayılan: 25. 0 sınır olmadığı anlamına gelir.

Minimum order subtotal: yöntemi yalnızca sepet ara toplamı en az bu tutara ulaşırsa gösterir. Her zaman göstermek için boş bırakın.

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

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

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.

Kargo bölgeleri olmadan kullanılabilirlik

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

Countries: bu mod için varış ülkeleri. Mağazanın gönderim yaptığı tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: kargo ücreti hesaplamalarını WooCommerce > Status > Logs bölümüne, kaynak vfd-coordinadora olarak kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbellekteki teklifleri kaldırır. Devre dışı bırakma hiçbir zaman veri silmez.

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

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

API anahtarı olan Kolombiya adresinde eklenti, varış şehrinin DANE kodunu şu sırayla bulur: şehir alanındaki bir DANE kodu (Kolombiya departman ve şehir ödeme eklentileri 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. Listeden bir şehir, seçilen departmanla karşılaştırılır. Aksanlar ve büyük/küçük harf yok sayılır.

Ardından eklenti, Coordinadora'ya varış DANE kodunu ve her ürünü gönderim şehri, ağırlığı (kg), boyutları (cm), adedi ve beyan edilen değeriyle (COP) gönderir. Mağaza birimleri otomatik olarak dönüştürülür. Coordinadora fiyatı COP olarak döndürür, eklenti de bunu mağaza para biriminize çevirir. Her teklif 1 saat önbelleğe alınır. 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.

Canlı teklif alınamadığında (API hatası, bilinmeyen şehir, ağırlığı veya boyutu olmayan ürün, eksik ayarlar), sabit fiyat kullanılır. Sabit fiyat yoksa yöntem gizlenir. Hata ayrıntıları WooCommerce günlüğüne yazılır, müşteriye hiçbir zaman gösterilmez.

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 kargo ücretlerini hesaplar. Gönderi veya guía (guías) oluşturmaz, etiket yazdırmaz, kurye alımı ayırtmaz (recogidas), kargoyu takip etmez, kapıda tahsilat (recaudo) yapmaz ve Droop teslim noktaları sunmaz; bunlar için Coordinadora portalını kullanın. Aynı gün teslimat teklifi vermez; uluslararası varış noktaları sabit fiyatları kullanır.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Shipping > VibeFox Coordinadora sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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 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 yoksa Coordinadora ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) işaretiyle görür; böylece bir anahtar satın almadan önce eklentiyi kurabilir ve test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

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

Sorun giderme

Coordinadora ö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 (veya Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum order subtotal ve Excluded shipping classes ayarlarını kontrol edin. Canlı teklif yoksa ülke veya * için bir sabit fiyat bulunmalıdır.

Canlı teklif gösterilmiyor, yalnızca sabit fiyat görünüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs bölümünü açın; kaynak vfd-coordinadora. Yaygın nedenler: varış şehri tanınmıyor, bir üründe ağırlık veya boyut yok, gönderim DANE kodu ya da COP döviz kuru eksik, veya Coordinadora bir hata döndürdü.

Varış şehri tanınmıyor: şehir alanına DANE kodunu yazan bir Kolombiya departman ve şehir ödeme eklentisi kurun. Geliştiriciler vfd_crd_dane_cities ve vfd_crd_destination_dane filtreleriyle daha fazla şehir eşleyebilir.

Ücrete vergi dahil mi? Ücret, Coordinadora'nın verdiği tutardır. Tax status Taxable olarak ayarlıysa WooCommerce kargo vergisini üzerine ekler; teklif vergiyi zaten içeriyorsa None seçin.

Bir değişiklikten sonra ücretler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki teklifleri temizler.

Lisans bloğunda bir hata gösteriliyor: 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, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur; yalnızca önbellekteki teklifleri temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekteki teklifler 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 yeniden kurulum için saklanırlar. Mevcut siparişler kargo satırlarını korur.

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