VibeFox Jadlog 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.

Jadlog sözleşmesi (canlı fiyatlar ve Pickup noktaları için): canlı fiyatlar ve Pickup noktalarının listesi Jadlog Embarcador API'sinden gelir. Jadlog franchise'ınız, sözleşme imzalandıktan sonra erişimi sağlar. Embarcador API jetonuna, sözleşmede kayıtlı gönderici CNPJ'sine (veya CPF'sine), cari hesaba (conta corrente) ve varsa sözleşme numarasına ihtiyacınız olacak. Yalnızca sabit fiyatları kullanıyorsanız Jadlog sözleşmesine ihtiyacınız yoktur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Arka ofiste 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 VibeFox Jadlog modülünü daha sonra modül listesinde bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı, Configure sayfasının üstündeki lisans bloğunda bulunan License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. API jetonunu yapıştırın, CNPJ, cari hesap, sözleşme numarası ve çıkış CEP'ini girin, Jadlog hizmetini seçin ve mağazanızın varsayılan para birimi BRL değilse BRL döviz kurunu girin. İsterseniz sabit fiyatlar veya yedek bir maliyet ekleyin (bkz. Yapılandırma). Save düğmesine tıklayın.

5. Jadlog Pickup noktalarını da sunmak için Enable Jadlog Pickup seçeneğini açın ve Save düğmesine tıklayın.

Kurulumda modül iki taşıyıcı oluşturur: Jadlog (adrese teslimat, açık, teslimat süresi metni Jadlog delivery to your address) ve Jadlog Pickup (kapalı, teslimat süresi metni Pickup at a Jadlog Pickup point). Her ikisi de Brezilya bölgesine ve tüm müşteri gruplarına bağlanı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. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Jadlog > Configure. Ayarlar iki Jadlog taşıyıcısının ikisi için de 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 Jadlog fiyatlarını ve Pickup nokta listelerini de temizler.

Sayfanın üst kısmında modül, eksik kurulumlar için uyarılar gösterir: API jetonu yok (yalnızca sabit fiyatlar kullanılır ve Pickup noktaları listelenemez), API jetonu ve sabit fiyat yok (yöntem hiç gösterilmez), CNPJ veya cari hesap yok, çıkış CEP'i yok, BRL ile satış yapmayan bir mağaza için BRL döviz kuru yok, modülün tanımadığı bir mağaza ağırlık veya boyut birimi (bu durumda ağırlıklar kg, boyutlar cm kabul edilir; birimleri International > Localization bölümünde, Local units alanında ayarlayın) ya da silinmiş bir Jadlog taşıyıcısı. Kaydederken hatalı değerler bildirilir: 8 haneden az CEP, 14 haneden az CNPJ (veya CPF için 11 hane), geçerli olmayan bir sayı, maksimum ağırlıktan büyük minimum ağırlık (her iki ağırlık da kayıtlı değerlerini korur), bilinmeyen bir ülke veya fiyat tablosunda geçersiz bir fiyat.

General

Enable/Disable: Jadlog adrese teslimatını açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen adrese teslimat taşıyıcısının adı. Varsayılan: Jadlog. Zorunlu.

Tax status: None veya sahip olduğunuz vergi kurallarından biriyle Taxable. İki Jadlog taşıyıcısına da kaydedilir. Jadlog fiyatları nihai taşıyıcı fiyatlarıdır. PrestaShop'un bu fiyatlara vergi eklemesini istemiyorsanız None seçin.

Jadlog live prices

Canlı fiyatlar yalnızca tam 8 haneli CEP'e sahip Brezilya adresleri için istenir.

API token: Jadlog'un Embarcador jetonu. "Bearer" kelimesiyle veya kelimesiz yapıştırabilirsiniz. Yalnızca sabit fiyatları kullanmak için boş bırakın. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved API token: kutucuğu işaretleyin ve kayıtlı jetonu silmek için Save düğmesine tıklayın.

CNPJ: Jadlog sözleşmesinde kayıtlı gönderenin CNPJ'si (14 hane) veya CPF'si (11 hane). Nokta, eğik çizgi ve tire kullanılabilir.

Current account (conta corrente): Jadlog cari hesap numaranız. Bu olmadan ve CNPJ olmadan Jadlog teklif veremez ve yalnızca sabit fiyatlar kullanılır.

Contract number: franchise'ınız size verdiyse Jadlog sözleşme numaranız.

Origin CEP: paketlerin gönderildiği posta kodu, 8 hane. 00000-000 biçiminde kaydedilir. Mağaza adresi Brezilya'daysa Shop Parameters > Contact > Stores bölümündeki mağaza posta kodunu kullanmak için boş bırakın.

Jadlog service: adrese teslimat için sözleşmenizin hizmeti (modalidade): .Package (3, varsayılan), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12) veya Emergencial (14). Jadlog Pickup (40) ikinci taşıyıcıdır.

Insurance type: Normal (N) (varsayılan) veya Jadlog sözleşmenizde kararlaştırıldığı gibi Own insurance policy (A - apolice).

Volumetric weight: Jadlog, gerçek ağırlık ile hacimsel ağırlıktan büyük olanını ücretlendirir.

BRL exchange rate: Jadlog, Brezilya reali üzerinden fiyat verir. Mağazanızın varsayılan para birimi BRL ise bu alana gerek yoktur. Değilse, varsayılan para biriminizde 1 BRL'nin ne kadar olduğunu girin, örneğin 0.16. Jadlog fiyatı bu kurla çarpılır ve Jadlog'a gönderilen beyan edilen sipariş değeri tekrar BRL'ye çevrilir. Kur olmadan canlı fiyatlar kullanılmaz ve yalnızca sabit fiyatlar uygulanır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Delivery time: Jadlog'un döndürdüğü teslimat süresini ödeme sayfasında, Jadlog taşıyıcısının altında ve her Pickup noktasının yanında gösterir; örneğin "Delivery time: 3 business days". Varsayılan olarak açıktır. Teslimat süresi her zaman siparişle birlikte kaydedilir.

Jadlog Pickup

Jadlog Pickup (40) hizmetine sahip ikinci bir taşıyıcı. API jetonu gerektirir. Nokta yoksa taşıyıcı gizlenir.

Enable Jadlog Pickup: Jadlog Pickup taşıyıcısını açar veya kapatır. Bu, Shipping > Carriers bölümündeki durumuyla aynı anahtardır. Kurulumdan sonra kapalıdır.

Jadlog Pickup carrier name: bu seçeneğin ödeme sayfasındaki adı. Varsayılan: Jadlog Pickup. Zorunlu.

Points to show: kaç Pickup noktası sunulacağı, 1 ile 10 arasında. Varsayılan: 5.

Fixed prices (API jetonu yoksa, Jadlog'un hizmet vermediği ülkeler için ve Jadlog fiyat döndürmediğinde kullanılır)

Price per country: mağazanızın varsayılan para biriminde Country, Price, XS, S, M, L ve XL sütunlarından oluşan bir tablo. Satır eklemek için + Add country düğmesine, bir satırı kaldırmak için çöp kutusu simgesine tıklayın. Boyut sütunu sepet ağırlığına göre seçilir: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L, 5 kg'ın üzeri XL. Boyut sütunu boşsa Price kullanılır. Fiyat 0, o ülke için ücretsiz kargo anlamına gelir. Diğer tüm ülkeler için * Default (other countries) kullanın. Hiçbir fiyatı olmayan satırlar kaydederken kaldırılır.

Fallback cost: ne Jadlog'un ne de tablonun fiyat verdiği durumlarda kullanılır. Bu durumda taşıyıcıyı gizlemek için boş bırakın.

Fixed price applies: Per order fiyatı bir kez alır. Per item (price x quantity) ise fiyatı sepetteki ürün adediyle çarpar. Bu yalnızca sabit fiyatlar ve yedek maliyet için geçerlidir. Jadlog fiyatları zaten tüm sepeti kapsar.

Conditions

Minimum weight (kg): sepet bundan hafifse taşıyıcıları gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan ağırsa taşıyıcıları gizler. Varsayılan: 150. 0 sınır olmadığı anlamına gelir.

Minimum order amount: taşıyıcıları yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergilerden önce). Ücretsiz kargo yoksa boş bırakın.

Availability without shipping zones

Ignore shipping zones: taşıyıcıları bölgelerine bağlı olmasa bile, aşağıda belirtilen ülkeler için Jadlog'u sunar. Açıldığında her iki taşıyıcı da tüm aktif bölgelere bağlanır ve sonradan oluşturulan bölgeler de bağlanır. Tekrar kapatıldığında taşıyıcılar daha önce sahip oldukları bölgelere geri döner.

Countries: bu mod için, taşıyıcıların kendi bölgeleri dışındaki hedef ülkeler. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Advanced

Debug log: her Jadlog isteğini ve yanıtını modül klasöründeki logs/vfd_jdlg_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalıyken bile her zaman kaydedilir. Jeton, CNPJ ve hesap hiçbir zaman kaydedilmez ve müşterinin CEP'i kısaltılır. İşiniz bittiğinde günlüğü kapatın.

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

Remove data on uninstall: açıksa modülü kaldırmak tüm Jadlog ayarlarını ve taşıyıcılarını siler. Kapalıysa kaldırma yalnızca taşıyıcıları kapatır. Önbellekteki fiyatlar her zaman silinir. Siparişler hiçbir zaman değiştirilmez.

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

Kargo adımında PrestaShop, her Jadlog taşıyıcısının fiyatını modülden ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlığa eklenmez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: sepet ağırlığı ve minimum sipariş tutarı ile Ignore shipping zones açıksa izin verilen ülkeler. Sepet ara toplamı Free shipping from tutarına ulaşırsa teslimat ücretsizdir ve Jadlog'a fiyat isteği gönderilmez.

Tam 8 haneli CEP'e sahip bir Brezilya teslimat adresi için modül Jadlog'a çıkış ve varış CEP'ini, ağırlığı, CNPJ'nizi, cari hesabı, sözleşmeyi, hizmeti, sigorta türünü ve beyan edilen sipariş değerini gönderir. Dönen fiyat mağazanızın varsayılan para birimine çevrilir ve müşterinin sepet para biriminde gösterilir. Ağırlığı olmayan sepetler 0,1 kg olarak hesaplanır. Canlı fiyat yoksa (jeton yok, adres Brezilya dışında, CEP eksik, BRL kuru yok, Jadlog hatası), modül önce Price per country tablosunu, ardından Fallback cost değerini kullanır. Hiçbiri fiyat vermezse taşıyıcı o sepet için gizlenir.

Her fiyat 1 saat önbellekte tutulur, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbellekte tutulur. Jadlog yanıt vermezse, sunucu hatası döndürürse veya jetonu reddederse, API 10 dakika boyunca tekrar çağrılmaz. API zaman aşımı 10 saniyedir. Müşteri hiçbir zaman bir API hatası görmez. Neden günlüğe yazılır.

Siparişi olan bir taşıyıcıyı Shipping > Carriers bölümünde düzenlerseniz, PrestaShop onu yeni bir taşıyıcı sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca fiyat hesaplar ve yalnızca Pickup noktalarını listeler. Jadlog gönderisi oluşturmaz, etiket basmaz, kurye talebi oluşturmaz, gönderileri iptal etmez veya kargoları takip etmez. Pickup noktalarının haritasını göstermez ve Jadlog'dan uluslararası teklif istemez. Diğer ülkeler için sabit fiyatları kullanın.

Pickup noktaları

Jadlog Pickup taşıyıcısı yalnızca Brezilya'daki adresler için ve yalnızca API jetonu kayıtlıyken sunulur. Müşteri tam 8 haneli bir CEP girdiğinde modül, Jadlog'dan en yakın aktif Pickup noktalarını ister ve taşıyıcının altında en fazla Points to show noktayı, her birinin fiyatı ve örneğin "nokta adı — fiyat (3 business days) — adres" biçiminde listeler. Liste henüz önbellekte değilse, müşteri taşıyıcıyı seçtiğinde yüklenir; böylece kargo adımı Jadlog'u beklemez.

Her nokta için fiyat Jadlog'dan istenir. Jadlog bir nokta için fiyat vermezse sabit fiyat kullanılır ve hiçbir fiyatı olmayan bir nokta listeden çıkarılır. Nokta listeleri 12 saat önbellekte tutulur. Taşıyıcının fiyatı seçilen noktanın fiyatıdır. Bir nokta seçilmeden önce, fiyatı olan en yakın noktanın fiyatıdır. Diğer noktaların fiyatı varken fiyatı olmayan bir nokta taşıyıcıyı gizlemez. Müşteri bir nokta seçtikten sonra kargo adımı yeni fiyatla yenilenir.

Nokta zorunludur. Nokta olmadan müşteri devam edemez ve Please select a Jadlog Pickup point. uyarısını görür. Modül, noktanın teslimat CEP'i için Jadlog listesinde olup olmadığını kontrol eder. Yoksa müşteri The selected Jadlog Pickup point is not in the Jadlog list for this CEP. Please choose the point again. mesajını görür. CEP eksikse, yakında nokta yoksa veya Jadlog kullanılamıyorsa taşıyıcının altında bir mesaj gösterilir.

API jetonu olmadan, 8 haneli CEP olmadan, Jadlog kullanılamadığında veya yakında aktif nokta olmadığında Jadlog Pickup taşıyıcısı gizlenir. Noktası olmayan bir sipariş gönderilemez.

Siparişler

Bir Jadlog taşıyıcısıyla sipariş verildiğinde modül Jadlog hizmetini ve Jadlog bunu döndürdüyse iş günü cinsinden teslimat süresini kaydeder. Jadlog Pickup siparişi için ayrıca Pickup noktasının adını, adresini ve kimliğini kaydeder.

Yönetici sipariş sayfası Jadlog service, Delivery time ve Jadlog Pickup için Pickup point, Pickup point address ve Pickup point ID alanlarını içeren bir Jadlog bloğu gösterir. Müşteri seçilen noktayı sipariş onay sayfasında ve sipariş ayrıntılarında görür. Nokta, sipariş onay e-postasında taşıyıcı adına eklenir. Mağazanın yeni sipariş e-postası (e-posta bildirim modülünü kullanıyorsanız) da nokta kimliğini içerir.

Gönderiyi Jadlog sisteminde kendiniz oluşturun. Sipariş, bunun için ihtiyacınız olan hizmeti ve Pickup nokta kimliğini gösterir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Jadlog lisans bloğu, Modules > Module Manager > VibeFox Jadlog > Configure sayfasındaki ilk bloktur ve ayarların üstündedir. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-jadlog satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra ya da 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 tek 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ızda serbest bırakın.

Etkin bir anahtar yoksa Jadlog taşıyıcıları ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop mağaza ön yüzü yönetim paneline giriş yaptığınızı bilmediği için taşıyıcılar sizden de gizlenir: modülü bir anahtar satın almadan önce yapılandırabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında 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

Jadlog ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable (veya Enable Jadlog Pickup) seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını doğrulayın veya Ignore shipping zones seçeneğini açın. Modül sayfasının üst kısmındaki uyarıları, ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Müşteri henüz tam 8 haneli bir CEP girmediyse yalnızca sabit fiyatlar kullanılabilir; bu durumda Price per country tablosuna bir satır veya bir Fallback cost ekleyin. Ayrıca ürün sayfasında ürünler belirli taşıyıcılarla sınırlandırılabilir.

Yalnızca sabit fiyatlar gösteriliyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Nedenini gösterir: CNPJ veya cari hesap yok, çıkış CEP'i yok, eksik varış CEP'i, BRL kuru yok veya Jadlog hata mesajı.

Günlükte HTTP 401 veya 403: Jadlog API jetonunu reddetti. Jetonu Jadlog franchise'ınızla kontrol edin. Bu hatadan sonra API 10 dakika duraklatılır. Ayarları kaydetmek duraklatmayı kaldırır, bu yüzden hemen tekrar deneyebilirsiniz.

Pickup noktaları görünmüyor: Jadlog Pickup taşıyıcısı için Enable Jadlog Pickup, API jetonu ve Brezilya'da tam 8 haneli bir CEP gerekir. Jadlog'un CEP'in yakınında aktif noktası yoksa taşıyıcı gizlenir. Nedeni için günlüğe bakın.

Fiyatlar benim para birimim yerine reais cinsinden: BRL exchange rate değerini girin (mağazanızın varsayılan para biriminde 1 BRL'nin ne kadar olduğu).

Fiyatlar çok düşük veya çok yüksek görünüyor: ürün ağırlıklarını ve boyutlarını doldurun. Ağırlığı olmayan sepetler 0,1 kg olarak hesaplanır ve hacimsel ağırlık boyut gerektirir.

Jadlog fiyatlarına vergi ekleniyor: Tax status değerini None olarak ayarlayın.

Bir değişiklikten sonra fiyatlar güncel görünmüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki Jadlog fiyatlarını ve Pickup nokta listelerini temizler.

Sayfa bir Jadlog taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers bölümünde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünden modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Jadlog yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbellekteki fiyatlar ve Pickup nokta listeleri her zaman silinir. Remove data on uninstall açıksa iki taşıyıcı da silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcılar yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak taşıyıcılara daha önce sahip oldukları durumu geri verir. Siparişlerle kaydedilen Jadlog hizmeti, teslimat süresi ve Pickup noktası her zaman korunur.

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