VibeFox Melhor Envio for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Melhor Envio hesabı (yalnızca anlık teklifler için): anlık teklifler bir erişim belirteci gerektirir. Melhor Envio hesabınızda belirteçler için erişim izinleri sayfasını açın (Integrações > Permissões de acesso, melhorenvio.com.br/painel/gerenciar/tokens) ve «shipping-calculate» izniyle bir belirteç oluşturun. Test için Melhor Envio sandbox ortamında bir belirteç oluşturun (sandbox.melhorenvio.com.br/painel/gerenciar/tokens). Canlı ve sandbox belirteçleri farklıdır. Belirteçlerin süresi dolar. «Bağlan» düğmesi yoktur: belirteci ayarlara yapıştırırsınız. Belirteç yoksa yöntem yedek fiyatları kullanır.

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 yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_melhor_envio 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 Melhor Envio veya Eklentiler 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. Erişim belirtecini, iletişim e-posta adresinizi ve çıkış CEP'ini yapıştırın. Mağaza para biriminiz BRL değilse BRL exchange rate değerini ayarlayın. İsteğe bağlı olarak yedek fiyat tablosunu (örneğin Brezilya için) veya bir yedek maliyeti doldurun.

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde Brezilya için bir bölge ekleyin ve bölgeye VibeFox Melhor Envio yöntemini 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 Melhor Envio. Tüm kargo bölgelerinde geçerlidirler. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu seçeneğin ödeme sayfasındaki adı. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üstündeki uyarılar eksik kurulumu gösterir: 8 haneden oluşmayan bir çıkış CEP'i, eksik bir iletişim e-postası, eksik bir BRL döviz kuru, tarihiyle birlikte son Melhor Envio API hatası ya da belirteç ve yedek fiyat olmaması. Ayarları her kaydettiğinizde önbellekteki teklifler temizlenir.

Genel

Enable/Disable: Melhor Envio kargosunu tüm bölgelerde bir kerede açar veya kapatır.

Name: ödeme sayfasında müşterilere gösterilen kargo yöntemi adı. Varsayılan: Melhor Envio.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez.

Melhor Envio API

Access token: aşağıda seçilen ortamın belirteci. Günlüğe asla yazılmaz.

Sandbox: test için Melhor Envio sandbox ortamını (sandbox.melhorenvio.com.br) kullanır. Bununla birlikte bir sandbox belirteci kullanın. Varsayılan: kapalı.

Contact e-mail: Melhor Envio'ya her istekle birlikte gönderilen teknik bir iletişim e-posta adresi. Melhor Envio bunu her entegrasyondan ister.

Origin CEP: paketlerin gönderildiği CEP (8 hane), örneğin 01310-100. Geçerli bir çıkış CEP'i olmadan hiçbir teklif istenmez.

Services: teklif alınacak, virgülle ayrılmış isteğe bağlı Melhor Envio hizmet kimlikleri, örneğin 1 = Correios PAC, 2 = Correios SEDEX, 17 = Correios Mini Envios, 3 = Jadlog .Package, 4 = Jadlog .Com. Hesabınızdaki tüm hizmetler için teklif almak üzere boş bırakın.

Quotes at checkout: tekliflerin nasıl gösterileceği.

Delivery time: Melhor Envio'nun teslimat süresi tahminini ada ek olarak gösterir, örneğin «(3-5 business days)». Varsayılan: açık.

Declared value: tekliflerde ürün değerini (sigorta) beyan eder. Kapalıyken teklifler beyan edilen değer olmadan istenir: daha ucuzdur, ancak paketler sigortalı olmaz. Varsayılan: açık.

BRL exchange rate: Melhor Envio teklifleri Brezilya reali (BRL) üzerinden verir. Yalnızca mağaza para biriminiz BRL değilse gereklidir: 1 BRL'nin mağaza para birimindeki fiyatını girin, örneğin 0.17. Bu olmadan anlık teklifler kullanılmaz. Beyan edilen değer aynı kurla BRL'ye çevrilir.

Default product weight (kg): ağırlığı olmayan ürünler için hem tekliflerde hem de ağırlık sınırlarında kullanılır. Varsayılan: 0.3.

Default product size (cm): boyutu olmayan ürünler için kullanılan uzunluk x genişlik x yükseklik. Varsayılan: 16x11x5.

Fallback prices (mağaza para biriminizde)

Yedek fiyatlar; belirteç yoksa, hedef CEP eksikse veya API bir teklif döndürmezse (hata, zaman aşımı, kapsama yok) kullanılır.

Fallback price table: ülkeye ve sepet ağırlığına göre fiyat. Satır eklemek için + Add country, bir satırı silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeler için * Any country seçin. Her satırda bir Price ve ağırlık sütunları vardır: 1 kg'a kadar XS, 1-2 kg S, 2-3 kg M, 3-5 kg L ve 5 kg'ın üzeri XL. Boş veya 0 olan bir sütun Price değerini kullanır. Hem «9.99» hem de «9,99» kabul edilir. Sayı olmayan değerler kaydetmeden sonra bildirilir ve yok sayılır.

Fallback cost: tabloda da fiyat yoksa kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

Fallback calculation: Per order yedek fiyatı bir kez uygular. Per item (each item priced by its own weight x quantity) her ürünün ağırlığı için yedek fiyatı arar (ağırlığı yoksa varsayılan ağırlık) ve adetle çarpar. Bu yalnızca yedek fiyatlar için geçerlidir. Melhor Envio teklifleri zaten tüm ürünleri içerir.

Availability

Min weight (kg): sepet bundan hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

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

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Hizmet başına bir seçenek kullanıldığında yalnızca en ucuz hizmet ücretsiz olur. Daha hızlı hizmetler fiyatını korur. Devre dışı bırakmak için boş bırakın.

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

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

Countries: bu mod için hedef ülkeler. Tüm ülkeler için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: API isteklerini ve teklif hesaplamasını WooCommerce > Status > Logs sayfasına (kaynak vfd-melhor-envio) kaydeder. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Belirteç ve müşteri adresleri asla kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek tüm eklenti ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir teklif ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve hariç tutulan kargo sınıfları.

Brezilya'daki 8 haneli CEP'li bir teslimat adresi için eklenti, Melhor Envio'ya çıkış ve hedef CEP'lerini ve gönderilebilir her ürünün ağırlığı, boyutu, adedi ve beyan edilen değeriyle birlikte gönderir; bir hizmet listesi tanımladıysanız onu da ekler. Teklifler mağaza para birimine çevrilir ve fiyata göre sıralanır. Müşteri en ucuz hizmeti veya hizmet başına bir seçeneği görür; açıksa teslimat süresi tahminiyle birlikte. Ücretsiz kargo geçerliyse en ucuz hizmet 0 değerindedir.

Her teklif, gönderi, CEP ve ortam başına 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir çağrı 5 dakika hatırlanır; böylece bir API kesintisi her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 12 saniyedir.

Belirteç yoksa, adres Brezilya dışındaysa veya henüz geçerli bir CEP'i yoksa, BRL döviz kuru eksikse ya da Melhor Envio rota için hata döndürür veya hizmet bulamazsa yedek fiyatlar kullanılır: ülkenin satırı (veya * satırı), yoksa yedek maliyet. Ücretsiz kargo geçerliyse yöntem fiyatı olmasa bile ücretsiz gösterilir. Hiçbir fiyat yoksa yöntem gizlenir. Müşteri asla bir API hatası görmez.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolaması (HPOS) ile uyumludur.

Eklenti yalnızca fiyat hesaplar. Etiket satın almaz veya oluşturmaz, Melhor Envio sepetine gönderi eklemez, paketleri takip etmez, kargo alımı planlamaz veya fatura (NF-e) verilerini göndermez. Jadlog, Azul veya LATAM şubelerinin (teslim noktalarının) seçimini ve «elden teslim» ile «teslim alındı belgesi» ek hizmetlerini sunmaz. Gönderilerinizi Melhor Envio panelinizden yönetin. Melhor Envio yalnızca Brezilya içinde gönderim yapar. Diğer ülkeler yalnızca yedek fiyatları alır.

Siparişler

Sipariş anlık bir teklifle verildiğinde hizmet ve teslimat süresi tahmini, siparişin kargo satırına kaydedilir. Sipariş ekranında ve sipariş e-postalarında Melhor Envio service ve Delivery estimate olarak gösterilirler; böylece Melhor Envio'da hangi hizmeti satın almanız gerektiğini bilirsiniz. Mevcut siparişler kendi kargo satırlarını korur.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Melhor Envio 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 aktif 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 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 Melhor Envio müşterilere ödeme sayfasında gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler 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

Melhor Envio ö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çıksa ve ülke izinliyse). Ayarlar sayfasının üstündeki uyarılara, ağırlık sınırlarına, Minimum subtotal ve Excluded shipping classes alanlarına bakın. Belirteç veya teklif yoksa yöntemin bir yedek fiyata ihtiyacı vardır: Fallback price table içinde bir satır ya da bir Fallback cost.

Yalnızca yedek fiyatlar gösteriliyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını açın (kaynak vfd-melhor-envio). Yaygın nedenler: belirteç yok, çıkış CEP'i 8 haneli değil, BRL dışında bir mağaza para birimi için BRL exchange rate yok, henüz hedef CEP yok ya da hiçbir hizmet rotayı kapsamıyor.

Günlükte veya uyarılarda HTTP 401 veya 403: Melhor Envio erişim belirtecini reddetti. Belirteç yanlış, süresi dolmuş veya iptal edilmiş olabilir ya da diğer ortama ait olabilir. Yeni bir belirteç oluşturun ve Sandbox seçeneğinin ona uyduğunu kontrol edin.

Müşteriler hangi fiyatı görür: tek seçenekte Melhor Envio'nun döndürdüğü en ucuz hizmet. Hizmet başına bir seçenekte rotaya hizmet veren her hizmet. Per item yalnızca yedek fiyatlar için geçerlidir.

Bir değişiklikten sonra teklifler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki teklifleri 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 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur. Yalnızca teklif önbelleği temizlenir. Tamamen kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında 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 kendi kargo satırlarını korur.

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