VibeFox Melhor Envio for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Melhor Envio hesabı (yalnızca anlık teklifler için): anlık teklifler bir erişim belirtecine ihtiyaç duyar. Melhor Envio hesabınızda belirteç sayfasını açın (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). Üretim ve sandbox belirteçleri farklıdır. «Bağlan» düğmesi yoktur: belirteci modül ayarlarına yapıştırırsınız. Belirteç olmadan kargo firması yedek fiyatları kullanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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 Melhor Envio öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğundaki License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Erişim belirtecini, iletişim e-posta adresinizi ve çıkış CEP'ini yapıştırın. Mağazanızın varsayılan para birimi BRL değilse BRL exchange rate alanını ayarlayın. İsteğe bağlı olarak yedek fiyat tablosunu (örneğin Brezilya için) veya yedek maliyeti doldurun. Save düğmesine tıklayın.

Kurulumda modül, Delivery by the carriers of your Melhor Envio account teslimat süresi metniyle Melhor Envio kargo firmasını oluşturur. Kargo firması tüm bölgelere ve tüm müşteri gruplarına atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers bölümünden değiştirebilirsiniz. Fiyatları orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Melhor Envio > Configure. Bunlar kargo firmasının tüm bölgeleri için geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki Melhor Envio tekliflerini ve son API hatasını da temizler.

Sayfanın üstündeki uyarılar eksik kurulumu gösterir: boş veya 8 haneden farklı bir çıkış CEP'i, eksik iletişim e-postası, eksik BRL döviz kuru, tarihiyle birlikte son Melhor Envio API hatası, belirteç yokluğu, yedek fiyat yokluğu (bu durumda kargo firması hiç gösterilmez) veya modülün tanımadığı bir mağaza ağırlık ya da boyut birimi (bu durumda kg veya cm olarak okunur). Bir sayı alanında 0 veya daha büyük bir sayı dışında bir değer varsa, Min weight değeri Max weight değerinden büyükse veya Default product size uzunluk x genişlik x yükseklik biçiminde değilse, sayfa bir hata gösterir ve hiçbir şey kaydedilmez.

General

Enable Melhor Envio shipping: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Name: ödeme sayfasında müşterilere gösterilen kargo firması adı. Varsayılan: Melhor Envio. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax. Melhor Envio fiyatları kargo firmasının nihai fiyatlarıdır. PrestaShop'un bu fiyatlara vergi eklemesini istemiyorsanız No tax seçin.

Melhor Envio API

Access token: aşağıda seçilen ortamın belirteci. Melhor Envio'ya Bearer belirteci olarak gönderilir. Kaydettikten sonra alan boş kalır ve A token is saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir belirteç girin. Kayıtlı belirteci silmek için Remove the saved token kutusunu işaretleyin ve kaydedin. Belirteç hiçbir zaman günlüğe yazılmaz.

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

Contact e-mail: Melhor Envio'ya her istekte User-Agent başlığında gönderilen teknik bir iletişim e-posta adresi. Melhor Envio bunu her entegrasyondan ister. Geçersiz bir adres kaydedilmez ve bir bildirim bunu belirtir.

Origin CEP: paketlerin gönderildiği CEP (8 hane), örneğin 01310-100. 00000-000 biçiminde kaydedilir. Geçerli bir çıkış CEP'i olmadan 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: ödeme sayfasında Melhor Envio'nun teslimat süresi tahminini 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 alınır: daha ucuzdur, ancak paketler sigortalı değildir. Varsayılan: açık.

BRL exchange rate: Melhor Envio teklifleri Brezilya reali (BRL) üzerinden verir. Yalnızca mağazanızın varsayılan para birimi BRL değilse gereklidir: 1 BRL'nin varsayılan para biriminizdeki fiyatını girin, örneğin 0.17. Bu olmadan anlık teklifler kullanılmaz. Değer 0'dan büyük olmalıdır. Beyan edilen değer aynı kurla BRL'ye çevrilir. Varsayılan para biriminiz BRL ise alan Store currency is BRL ifadesini gösterir.

Default product weight: kg cinsinden, ağırlığı olmayan ürünler için; hem tekliflerde hem de ağırlık sınırlarında kullanılır. 0'dan büyük olmalıdır. Varsayılan: 0.3.

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

Yedek fiyatlar (mağazanızın varsayılan para biriminde)

Yedek fiyatlar, belirteç yoksa, hedef CEP eksikse veya API teklif vermezse (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 düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan her ülke için ülke olarak * Default seçin. Her satırda bir Price ve ağırlık sütunları bulunur: 1 kg'a kadar XS, 1-2 kg S, 2-3 kg M, 3-5 kg L ve 5 kg ü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 kargo firmasını gizlemek için boş bırakın.

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

Kullanılabilirlik

Min weight: sepet bundan hafifse kargo firmasını gizler, kg cinsinden. 0 sınır yok anlamına gelir.

Max weight: sepet bundan ağırsa kargo firmasını gizler, kg cinsinden. Varsayılan: 30. 0 sınır yok anlamına gelir. Boş alan, kargo firmasının bölgelerinde 30 kg anlamına gelir ve bu bölgelerin dışında kalan Ignore shipping zones ülkeleri için sınır olmadığı anlamına gelir.

Minimum subtotal: kargo firmasını yalnızca sepetin ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce) bu tutarın en az olması durumunda 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.

Ignore shipping zones: kargo firmasını, bölgelerine atanmamış olsa bile aşağıdaki ülkelerde sunar. Bu açıkken kargo firması, etkin olmayan bölgeler ve daha sonra oluşturulan bölgeler dahil tüm bölgelere bağlanır. Kapattığınızda kargo firması kendi bölgelerini geri alır.

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ı modül klasöründeki logs/vfd_menv_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Belirteç hiçbir zaman günlüğe yazılmaz ve müşterinin CEP'i ilk 5 hanesine kısaltılır.

Log: hata ayıklama günlüğünün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak, tüm modül ayarlarını, kargo firmasını ve günlüğü siler. Kapalıyken yeniden kurulum için her şey saklanır. Teklif önbelleği her zaman kaldırılır. Siparişlerle birlikte kaydedilen hizmetler sipariş geçmişidir ve saklanır.

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

Kargo adımında PrestaShop, Melhor Envio fiyatı için modüle başvurur. Yalnızca kargo gerektiren ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: Ignore shipping zones ülkeleri, sepet ağırlığı ve minimum ara toplam.

8 haneli CEP'e sahip bir Brezilya teslimat adresi için modül, Melhor Envio'ya çıkış ve hedef CEP'i ile her gönderilebilir ürünün ağırlığını, boyutunu, adedini ve beyan edilen değerini gönderir; ayrıca bir hizmet listesi tanımladıysanız bu listeyi de iletir. Teklifler mağazanızın varsayılan para birimine çevrilir, fiyata göre sıralanır ve ardından müşterinin sepet para biriminde gösterilir. Ücretsiz kargo geçerliyse en ucuz hizmet 0 değerindedir.

One option - the cheapest service seçeneğiyle kargo firması en ucuz hizmetin fiyatını gösterir; Delivery time açıksa kargo firmasının altında Delivery estimate: satırını da gösterir. One option per service seçeneğiyle müşteri kargo firmasının altında Choose a delivery service: ifadesini, her hizmet için bir seçim düğmesini, fiyatını ve teslimat süresi tahminini görür. Seçim hemen kaydedilir ve kargo firması fiyatı ile sepet özeti güncellenir. Hizmet adres için artık sunulmuyorsa müşteri This service is not available for your address any more. Please choose another one. mesajını görür ve önceki seçim geri gelir.

Her teklif, paket, CEP, belirteç ve ortam başına 1 saat önbellekte tutulur; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir çağrı 5 dakika hatırlanır; bu sayede 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 bir hata veya rota için hizmet döndürmezse yedek fiyatlar kullanılır: ülkenin satırı (veya * satırı), yoksa yedek maliyet. Ücretsiz kargo geçerliyse kargo firması fiyat olmasa bile ücretsiz olarak gösterilir. Hiç fiyat yoksa kargo firması gizlenir. Müşteri hiçbir zaman bir API hatası görmez.

Kargo firmasında siparişler olduktan sonra Shipping > Carriers bölümünde düzenlerseniz, PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca fiyatları 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 «eline teslim» ve «teslim alındı belgesi» ek hizmetlerini sunmaz. Gönderileri 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 teklifle verildiğinde modül, Melhor Envio hizmetini ve teslimat süresi tahminini siparişle birlikte kaydeder. Back office'teki sipariş sayfasında, hangi hizmeti Melhor Envio'da satın almanız gerektiğini bilmeniz için Melhor Envio service (hizmet kimliğiyle) ve Delivery estimate içeren bir Melhor Envio bloğu gösterilir. Müşteri aynı bilgileri hesabındaki sipariş sayfasında görür. Sipariş onay e-postasında bunlar kargo firmasının adından sonra eklenir. Yedek fiyatla verilen siparişlerde hizmet bulunmaz. Mevcut siparişler etkilenmez.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Melhor Envio lisans bloğu, Modules > Module Manager > VibeFox Melhor Envio > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın 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-melhor-envio satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetici paneli 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 tarihli 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 bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Melhor Envio kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir teklif hesaplanmaz. PrestaShop vitrini, yönetici paneline giriş yaptığınızı bilmediği için kargo firması sizden de gizlenir: modülü anahtarı satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Melhor Envio ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Melhor Envio shipping seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde kargo firmasının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin veya Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Modül sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Belirteç veya teklif yoksa kargo firması bir yedek fiyata ihtiyaç duyar: Fallback price table içinde bir satır veya bir Fallback cost. Ürün sayfasında ürünler belirli kargo firmalarıyla da sınırlandırılmış olabilir.

Yalnızca yedek fiyatlar gösteriliyor: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Yaygın nedenler: belirteç yok, çıkış CEP'i 8 haneli değil, BRL dışında bir varsayılan para birimi için BRL exchange rate yok, henüz hedef CEP yok veya 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ş ya da diğer ortama ait olabilir. Yeni bir belirteç oluşturun ve Sandbox ayarının ona uygun olduğunu kontrol edin.

Müşteri «The service could not be saved. Please try again.» mesajını görüyor: seçim mağazaya ulaşmadı, örneğin bir ağ hatası nedeniyle. Müşteri hizmeti yeniden seçebilir. Müşteri Continue düğmesine tıkladığında seçili olan hizmet de kaydedilir.

Melhor Envio fiyatına vergi ekleniyor: Tax alanını No tax olarak ayarlayın.

Bir değişiklikten sonra teklifler güncel değil gibi görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki teklifleri temizler.

Sayfa Melhor Envio kargo firmasının bulunamadığını söylüyor: kargo firması 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.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Melhor Envio yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Teklif önbelleği her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur), kendi bölgeleri geri yüklenir ve ayarlar, açık sepetlerdeki hizmet seçimleri ve günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar saklanır. Modülü yeniden kurmak, kargo firmasına daha önceki durumunu geri verir. Siparişlerle birlikte kaydedilen hizmetler her zaman saklanır.

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