VibeFox Jadlog for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

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 verir. 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 vardır. Yalnızca sabit fiyat kullanıyorsanız Jadlog sözleşmesine ihtiyacınız yoktur.

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_jadlog 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 Jadlog 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 jetonunu yapıştırın, CNPJ, cari hesap, sözleşme numarası ve gönderici CEP'ini girin, Jadlog hizmetini seçin ve mağaza para biriminiz BRL değilse BRL döviz kurunu girin. İsterseniz sabit fiyatlar veya yedek bir maliyet ekleyin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde Brezilya için bir kargo bölgesine VibeFox Jadlog ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin. Jadlog Pickup noktalarını da sunmak için yöntemi aynı bölgeye ikinci kez ekleyin ve hizmet olarak Pickup (40) seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Jadlog. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde iki alan bulunur:

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

Jadlog service (zone): bu bölge yönteminin hizmeti. Same as the global setting, ana ayarlar sayfasındaki hizmeti kullanır. Aynı bölgede örneğin adrese teslimat (.Package) ve Jadlog Pickup noktalarını sunmak için yöntemi iki kez ekleyin.

Bölge başlığı boşken ve hizmet Pickup ise genel başlığa "Pickup" kelimesi eklenir; böylece iki yöntemin adları farklı olur.

Ayarlar sayfasının üstünde eklenti, eksik kurulum için uyarılar gösterir: API jetonu yoksa, CNPJ veya cari hesap yoksa, CEP (gönderici) yoksa ya da BRL dışında satış yapan bir mağaza için BRL döviz kuru yoksa. Ayarları her kaydettiğinizde, önbelleğe alınmış Jadlog fiyatları ve Pickup nokta listeleri temizlenir.

Genel

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

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Varsayılan: Jadlog. Bir bölge bu adı değiştirebilir.

Jadlog canlı fiyatları

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

API token: Jadlog'un Embarcador jetonu. Başına "Bearer" kelimesi ile veya onsuz yapıştırabilirsiniz. Yalnızca sabit fiyat kullanmak için boş bırakın.

CNPJ: Jadlog sözleşmesinde kayıtlı göndericinin CNPJ'si (14 hane) veya CPF'si (11 hane). Nokta, eğik çizgi ve tire kullanılabilir. Hane sayısı yanlışsa eklenti uyarır.

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

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

Origin CEP: kargoların gönderildiği 8 haneli posta kodu. 00000-000 biçiminde kaydedilir. Mağaza adresi Brezilya'daysa, WooCommerce > Settings > General bölümündeki mağaza posta kodunu kullanmak için boş bırakın.

Jadlog service: 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), Emergencial (14) veya Pickup (40). Pickup, müşteriye yakın Jadlog Pickup noktalarını sunar. Bir bölge yöntemi başka bir hizmet kullanabilir.

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

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 (BRL) üzerinden fiyat verir. Mağaza para biriminiz BRL ise bu alan gerekli değildir. Değilse, mağaza para biriminizde 1 BRL'nin değerini girin, örneğin 0.16. Jadlog fiyatı bu kurla çarpılır ve Jadlog'a gönderilen beyan edilen sipariş değeri BRL'ye geri çevrilir. Kur girilmezse canlı fiyatlar kullanılmaz ve yalnızca sabit fiyatlar uygulanır. Ondalık ayırıcı olarak nokta ve virgül ikisi de kabul edilir.

Delivery time: Jadlog'un döndürdüğü teslimat süresini yöntem başlığının yanında gösterir, örneğin "Jadlog (3 iş günü)". Varsayılan olarak açıktır. Teslimat süresi her zaman siparişe kaydedilir.

Jadlog Pickup noktaları (Pickup (40) hizmeti tarafından kullanılır; API jetonu gerekir)

Points to show: sunulacak Pickup noktası sayısı, 1 ile 10 arasında. Varsayılan: 5.

Sabit fiyatlar (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ğaza 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, satır silmek için çarpı işaretine tıklayın. Beden sütunu sepet ağırlığına göre seçilir: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar, XL 5 kg'ın üzeri. Beden sütunu boşsa Price kullanılır. Fiyat 0 ise o ülke için ücretsiz kargo anlamına gelir. Diğer tüm ülkeler için ülke olarak * Default kullanın. Hiçbir fiyatı olmayan satırlar kaydedilirken silinir.

Fallback cost: ne Jadlog ne de tablo fiyat verdiğ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 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.

Koşullar

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

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

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutara ulaştığında gösterir. Her zaman göstermek 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.

Free shipping from: sepet ara toplamının (indirimlerden sonra, vergiden önce) bu tutara ulaştığı durumda teslimat ücretsiz olur. Ücretsiz kargo yoksa boş bırakın.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez. Jadlog fiyatları taşıyıcının kesin fiyatlarıdır. WooCommerce bu fiyatlara vergi eklemesin istiyorsanız None seçin.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem hiçbir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için Jadlog sunar. Bu modda genel Jadlog service kullanılır.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız 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: her Jadlog isteğini ve yanıtını WooCommerce > Status > Logs bölümüne, kaynak vfd-jadlog olarak kaydeder. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. Jeton, CNPJ ve hesap hiçbir zaman kaydedilmez, müşterinin CEP'i kısaltılır. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa eklentiyi silmek tüm Jadlog ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez. Önbelleğe alınmış fiyatlar her zaman kaldırılır.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. 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 Brezilya'daki bir teslimat adresi için eklenti 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 ve dönen fiyatı mağaza para biriminizde gösterir. Ağırlığı olmayan sepetler 0,1 kg olarak fiyatlandırılır. Canlı fiyat yoksa (jeton yok, adres Brezilya dışında, eksik CEP, BRL döviz kuru yok, Jadlog hatası), eklenti önce Price per country tablosunu, ardından Fallback cost değerini kullanır. Hiçbiri fiyat vermezse yöntem 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 önbelleğe alınır. 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.

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 ve 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ı fiyat teklifi istemez. Diğer ülkeler için sabit fiyatları kullanın.

Pickup noktaları

Pickup (40) hizmetine sahip bir yöntem yalnızca Brezilya adresleri için sunulur. Müşteri tam 8 haneli bir CEP girdiğinde eklenti Jadlog'dan yakındaki aktif Pickup noktalarını ister ve en fazla Points to show nokta sunar. Her nokta kendi fiyatıyla ayrı bir kargo seçeneğidir, örneğin "Jadlog Pickup: nokta adı — adres". Müşteri, kargo seçeneğini seçerek bir nokta belirler; bu hem klasik ödeme sayfasında hem de Sepet ve Ödeme bloklarında aynı şekilde çalışır.

Her nokta için fiyat Jadlog'dan istenir. Jadlog bir nokta için fiyat vermezse sabit fiyat kullanılır; hiçbir fiyatı olmayan nokta listeden çıkarılır. Nokta listeleri 12 saat önbellekte tutulur.

API jetonu yoksa, 8 haneli CEP yoksa, Jadlog kullanılamıyorsa veya yakında aktif nokta yoksa Pickup yöntemi gizlenir. Noktasız bir sipariş gönderilemez.

Siparişler

Siparişin kargo satırı Jadlog hizmetini ve Jadlog bunu döndürdüyse iş günü cinsinden teslimat süresini saklar. Pickup siparişinde kargo satırının adı nokta adını ve adresini içerir; sipariş ayrıca Pickup noktasının adını, adresini ve kimliğini kaydeder. Bunları yönetici sipariş ekranında kargo satırının altında görürsünüz. Müşteri seçtiği noktayı teşekkür sayfasında ve sipariş e-postalarında görür.

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ı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Jadlog sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Check now ile durumu yeniden kontrol edin, Change key ile başka bir anahtar girin ve Remove key ile anahtarı bu siteden kaldırı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ı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Jadlog ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) ibaresiyle 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.

Lisans 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

Jadlog ö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). Ayarlar sayfasının üstündeki uyarılara, ağırlık sınırlarına, Minimum order amount ve Excluded shipping classes seçeneklerine bakın. 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 ya da bir Fallback cost ekleyin.

Yalnızca sabit fiyatlar gösteriliyor: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve WooCommerce > Status > Logs bölümünü, kaynak vfd-jadlog olarak açın. Neden burada görünür: CNPJ veya cari hesap yok, gönderici CEP yok, eksik hedef CEP, BRL döviz kuru yok ya da Jadlog hata mesajı.

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

Pickup noktaları görünmüyor: Pickup yöntemi API jetonu ve Brezilya'da tam 8 haneli bir CEP gerektirir. Jadlog CEP yakınında aktif nokta yoksa yöntem gizlenir. Nedeni görmek için günlüğe bakın.

Fiyatlar benim para birimim yerine reais olarak görünüyor: BRL exchange rate değerini girin (mağaza para biriminizde 1 BRL'nin değeri).

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 fiyatlandırılır ve hacimsel ağırlık boyut gerektirir.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış Jadlog fiyatlarını ve Pickup nokta listelerini 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 yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı 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ış fiyatlar ve Pickup nokta listeleri temizlenir. Eklentiyi kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbelleğe alınmış fiyatlar 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 daha sonraki bir yeniden kurulum için saklanır. Mevcut siparişler, Jadlog hizmeti ve Pickup noktası ile birlikte kargo satırlarını korur.

Jadlog, ilgili sahibinin ticari markasıdır. Bu eklenti Jadlog ile bağlantılı değildir ve Jadlog tarafından desteklenmez veya onaylanmaz.