VibeFox Envioclick for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

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 bölümündedir. Yalnızca sabit fiyat kullanıyorsanız Envioclick hesabına ihtiyacınız yoktur.

User-Agent (yalnızca Meksika): Envioclick Mexico, her API isteğinde bir User-Agent değeri ister. Bunu Envioclick desteğinden isteyin (soporte.tecnico@envioclick.com).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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_envioclick 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 Envioclick, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. API anahtarını girin, API ülkesini seçin, User-Agent (Meksika), çıkış posta kodu veya DANE kodu ile çıkış adresini girin. Mağaza para biriminiz MXN veya COP değilse, dönüşüm kurunu girin.

6. İsteğe bağlı olarak ülke bazında sabit fiyatlar ve yedek ücret ekleyin.

7. WooCommerce > Settings > Shipping > Shipping zones bölümünde VibeFox Envioclick yöntemini bir kargo bölgesine ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Envioclick. Tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için müşterilerin gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Bir API anahtarı ayarlandığında, canlı fiyatlar çalışamıyorsa eklenti sayfanın üstünde uyarılar gösterir: 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. Ayarları her kaydettiğinizde önbelleğe alınmış fiyat teklifleri temizlenir. Sayısal alanlar ondalık ayırıcı olarak hem nokta hem virgül kabul eder.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır. Varsayılan: açık.

Method title: sepette ve ödeme sayfasında gösterilen kargo yönteminin adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: Envioclick Shipping.

Carrier in the title: canlı fiyatlar için başlığın yanında kargo firmasını ve tahmini teslimat süresini gösterir, örneğin «Envioclick Shipping (Estafeta Express, 1 day)». Kargo firması her durumda siparişe kaydedilir ve sipariş e-postaları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. Canlı fiyatlar yalnızca API ülkesindeki varış noktaları için istenir. Diğer ülkelere gönderimler sabit fiyatları kullanır.

API key: Mi cuenta > Información del API bölümündeki Envioclick API anahtarınız.

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

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

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

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

Currency conversion rate: Envioclick MXN (Meksika) veya COP (Kolombiya) cinsinden teklif verir. Mağaza para biriminiz farklıysa, 1 MXN veya 1 COP değerini mağaza para biriminizle girin, örneğin 0.05. Beyan edilen paket değeri de aynı şekilde dönüştürülür. Mağaza para birimi MXN veya COP ise boş bırakın. Bu olmadan canlı fiyatlar başka bir para biriminde kullanılmaz.

Gönderici adresi

Canlı fiyatlar için kullanılır. Mağaza API ülkesindeyse, boş alanlar WooCommerce > Settings > General içindeki 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.

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, varış API ülkesi dışındaysa, API hatası varsa veya güzergâh için kargo firması yoksa.

Price per country: mağaza para biriminizle ülkeler ve fiyatların tablosu. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. * Default satırı, kendi satırı olmayan tüm ülkeler için geçerlidir.

Fallback cost: canlı fiyat yokken ve tablonun hiçbir satırı eşleşmediğinde kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

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

Koşullar

Minimum weight (kg): sepet ağırlığı bunun altındaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet ağırlığı bunun üstündeyse yöntemi gizler. Varsayılan: 25. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimler sonrası, vergi öncesi) bu tutara eşit veya üstündeyse gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: sepet ara toplamı (indirimler sonrası, vergi öncesi) bu tutara ulaştığında ücretsiz kargo. Bu durumda API isteği yapılmaz. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

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

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez. Envioclick fiyatları zaten kargo firmalarının vergilerini içerir; bu yüzden kargoya iki kez vergi uygulanmaması için None seçin.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem bir kargo bölgesine eklenmemiş olsa bile, aşağıda belirtilen ülkeler için Envioclick'i sunar.

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

Gelişmiş

Debug log: fiyat hesaplamalarını ve API hatalarını WooCommerce > Status > Logs altına, kaynak vfd_envioclick olarak kaydeder. API anahtarı ve müşteri adresleri kaydedilmez. İşiniz bittiğinde kapatın.

Remove data on uninstall: açıksa eklentiyi silmek tüm Envioclick ayarlarını, bölge yöntemlerini ve önbelleğe alınmış fiyat tekliflerini kaldırır. Eklentiyi devre dışı bırakmak ayarları hiçbir zaman silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti önce sepet ağırlığını, minimum sipariş tutarını ve hariç tutulan kargo sınıflarını kontrol eder. Ücretsiz kargo uygulanıyorsa yöntem sıfır fiyatla gösterilir ve Envioclick'e istek gönderilmez.

Bir API anahtarı ayarlıysa ve varış API ülkesindeyse, eklenti Envioclick'ten fiyat teklifleri ister. Meksika'da istek, müşteri 5 haneli bir posta kodu girdikten sonra yapılır. Kolombiya'da ise il ve belediye tanındıktan sonra yapılır (aksan ve büyük/küçük harf önemli değildir; «Bogotá D.C.» de çalışır). Eklenti, kapıda ödeme olmayan en ucuz veya en hızlı adrese teslimat teklifini seçer ve bunu mağaza para biriminize dönüştürür.

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 kullanılır, yüksekliği ise tüm ürünlerin toplam hacmini karşılayacak şekilde hesaplanı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ı güzergâh ve 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 döndürürse ya da güzergâh için kargo firması yoksa müşteri hata görmez: sabit fiyat kullanılır veya yöntem gizlenir. Nedeni hata ayıklama 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 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; kapıda ödeme hizmetleri, ek sigorta ve çoklu paket teklifleri kullanmaz. Canlı fiyat teklifleri yalnızca ülke içidir.

Siparişler

Canlı bir Envioclick fiyatıyla sipariş verildiğinde kargo firması ve hizmet siparişe kaydedilir. Yönetici sipariş ekranında, teslimat adresinin altında tahmini teslimat süresiyle birlikte Envioclick carrier gösterilir. Müşterinin sipariş sayfasında ve sipariş e-postalarında (HTML ve düz metin) Shipping carrier gösterilir. Teklifin Envioclick fiyat kimliği, sipariş kargo satırıyla birlikte gizli veri olarak saklanır; sipariş ekranında görünmez. Kargo belgesini Envioclick hesabınızda oluşturun.

Sabit fiyatla verilen siparişlerde kargo firması yoktur.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Envioclick sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum gösterilir; ö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ı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

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

Bir 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

Envioclick ö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 order amount ve Excluded shipping classes ayarlarını kontrol edin. Canlı fiyat yoksa yöntemin ülke için sabit bir fiyata, bir * Default satırına ya da bir Fallback cost değerine ihtiyacı vardır.

Canlı fiyatlar görünmüyor: ayarlar sayfasının üstündeki uyarıları okuyun, ardından Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs bölümünü, kaynak vfd_envioclick olacak şekilde açı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) ya da şehri (Kolombiya) henüz girilmemiş, varış API ülkesi dışında veya güzergâh için kargo firması yok.

Neden dönüşüm kuru? Envioclick fiyatları yalnızca Meksika veya Kolombiya pesosu cinsinden döndürür. Eklenti bir peso tutarını hiçbir zaman başka bir para birimi gibi göstermez.

Kolombiya: şehir tanınmıyor: müşterinin ili seçmesi ve belediye adını yazması gerekir. Posta kodu olarak yazılan 8 haneli bir DANE kodu da çalışır. Geliştiriciler vfd_evc_dane_code filtresiyle bir DANE kodu sağlayabilir.

Kargoya vergi iki kez uygulanıyor: Envioclick fiyatları zaten kargo firmalarının vergilerini içerir. Tax status seçeneğini None olarak ayarlayın.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış fiyat tekliflerini temizler.

Geliştirici filtreleri: vfd_evc_quotation_request (istek gövdesi), vfd_evc_api_url, vfd_evc_dane_code, vfd_evc_default_dimensions ve vfd_evc_package_description.

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 hak 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şılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları ve bölge yöntemlerini korur; yalnızca önbelleğe alınmış fiyat teklifleri temizlenir. Eklentiyi kaldırmak için devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbelleğe alınmış fiyat teklifleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Geçmiş siparişlerde kaydedilen kargo firması korunur ve mevcut siparişler kargo satırlarını korur.

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