VibeFox Loggi for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Loggi hesabı (yalnızca canlı fiyatlar için): canlı fiyat, Loggi'nin iş hesapları için verdiği bir API anahtarıyla Loggi GraphQL API'sini kullanır. Loggi hesap yöneticinize veya Loggi entegrasyon desteğine (integracoes@loggi.com) başvurun; ayrıca docs.api.loggi.com adresindeki Loggi API belgelerine bakın. Üç değere ihtiyacınız var: Loggi hesabınızın e-posta adresi, API anahtarı ve mağazanızın sayısal ID'si. Loggi hesabınızda yalnızca yeni Loggi REST platform API'si için kimlik bilgileri (client ID ve secret) varsa canlı fiyat kullanılamaz ve sabit fiyatlar kullanılır. Yalnızca sabit fiyat kullanıyorsanız Loggi hesabına 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. Yönetim panelinde 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 Loggi modülünü daha sonra modül listesinde bulup Configure düğmesine tıklayın.

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

4. Loggi API e-postasını, API anahtarını, Shop ID'yi ve teslim alma adresini girin; mağaza varsayılan para biriminiz BRL değilse BRL döviz kurunu da girin. Güvenlik ağı olarak sabit fiyatlar ekleyin (bkz. Yapılandırma) ve Save düğmesine tıklayın.

5. Shipping > Carriers bölümünde Loggi kargo firmasının bölgelerine Brezilya'yı ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Kurulumda modül, Courier delivery in Brazil teslimat süresi metniyle Loggi 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. Orada fiyat belirlemeyin: fiyat her zaman moduldan gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Loggi > Configure. Ayarlar kargo firmasının tüm bölgelerinde geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış Loggi fiyatlarını da temizler.

Sayfanın üstündeki uyarılar eksik kurulumu gösterir: API kimlik bilgisi yok (yalnızca sabit fiyatlar kullanılır), API kimlik bilgisi ve sabit fiyat yok (kargo firması hiç gösterilmez), teslim alma adresi yok, BRL döviz kuru yok ya da modülün tanımadığı bir mağaza ağırlık veya boyut birimi var (bu durumda kg veya cm olarak sayılır; birimleri International > Localization bölümünde ayarlayın). Bir değer geçersizse, örneğin negatif bir sayıysa, sayfa bir hata gösterir ve hiçbir şey kaydedilmez.

Genel

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

Method title: sepette ve ödeme sayfasında müşteriye gösterilen kargo firması adı. Varsayılan: Loggi. Zorunlu, en fazla 64 karakter.

Loggi API (canlı fiyat) (yalnızca sabit fiyat kullanmak için kimlik bilgilerini boş bırakın)

API e-mail: Loggi hesabınızın e-posta adresi. API anahtarı bu hesaba aittir. Geçerli bir e-posta adresi olmalıdır.

API key: Loggi API anahtarınız. Yalnızca Loggi'ye gönderilir ve asla günlüğe yazılmaz. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it; clear the API e-mail to remove it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. API e-mail alanını değiştirirseniz yeni e-posta için API anahtarını da girin; aksi halde sayfa bir hata gösterir ve hiçbir şey kaydedilmez. Kayıtlı anahtarı kaldırmak için API e-mail alanını temizleyin ve kaydedin.

Shop ID: Loggi panelindeki mağazanızın sayısal kimliği (pk). Yalnızca pozitif bir sayı kabul edilir. Başka bir değer hatayla reddedilir.

Staging: test kimlik bilgileriyle Loggi staging ortamını kullanır. Staging ve üretim ortamlarının hesapları ve anahtarları farklıdır. Varsayılan: kapalı.

Pickup address: Loggi'nin paketleri aldığı adres, tek satırda: cadde ve numara, mahalle, şehir, eyalet ve CEP; örneğin Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Mağaza adresi Brezilya'daysa ve adres ile şehir bilgisi varsa, Shop Parameters > Contact > Stores bölümündeki mağaza adresini kullanmak için boş bırakın. Teslim alma adresi olmadan Loggi tahmin yapamaz ve yalnızca sabit fiyatlar kullanılır.

BRL exchange rate: Loggi fiyatları Brezilya reali (BRL) cinsindendir. Mağazanızın varsayılan para birimi BRL ise bu alana gerek yoktur ve sayfa bunu belirtir. Aksi halde 1 BRL'nin mağaza para biriminizde ne kadar ettiğini girin, örneğin 0.16. Bu olmadan canlı fiyatlar kullanılmaz. Yalnızca pozitif bir sayı kabul edilir. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Sabit fiyatlar (mağazanızın varsayılan para biriminde, vergi hariç)

Sabit fiyatlar, Loggi API yapılandırılmadığında, Brezilya dışındaki hedefler veya tam CEP olmayan adresler için ve Loggi fiyat döndürmediği her durumda kullanılır (API kullanılamıyor, anahtar reddedildi, adres kapsama alanı dışında).

Price table: hedef ülke başına bir satır. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkeler için * All other countries seçin. Her satırda bir Base price ve ağırlık sütunları vardır: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg. Boş (veya 0) bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ise ücretsiz kargo anlamına gelir. Hem "9.99" hem "9,99" kabul edilir. Boş satırlar ve aynı ülke için ikinci bir satır kaydederken silinir.

Price for countries not in the table: Loggi canlı fiyatı yoksa ve tabloda hedef ülke için satır (ve * satırı) yoksa kullanılır. Bu durumda kargo firmasını gizlemek için boş bırakın.

Fixed price applies: sabit fiyatların nasıl hesaplandığı. Canlı bir Loggi fiyatı zaten tüm sepeti kapsar ve asla çarpılmaz.

Koşullar

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

Maximum weight: sepet daha ağırsa kargo firmasını gizler, kg cinsinden. Varsayılan: 30. 0 sınır yok anlamına gelir. Minimum weight değeri Maximum weight değerinden büyük olamaz.

Minimum order amount: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergi hariç) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: Loggi teslimatının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi hariç). Ücretsiz kargo olmaması için boş bırakın.

Tax: kargo firmasının vergi kuralı veya No tax. Fiyatlarınız ve Loggi fiyatı zaten vergileri içeriyorsa No tax seçin.

Ağırlık sınırları ve ağırlık sütunları için ağırlığı olmayan bir ürün 0 kg sayılır.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: eşleşen bölge ne olursa olsun, Loggi'yi aşağıdaki ülkeler için sunar. Bu seçenek açıkken kaydederseniz kargo firması tüm bölgelere eklenir ve sonradan oluşturulan bölgelere de eklenir. Kapatmak, eklenen bu bölgeleri kaldırır, böylece kargo firması kendi bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Mağazanızın tüm etkin ülkelerine izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını ve Loggi isteklerini, modül klasöründeki logs/vfd_lggi_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalıyken bile her zaman günlüğe yazılır. API anahtarı ve müşteri adresleri asla günlüğe yazılmaz.

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

Remove data on uninstall: açıksa modülü kaldırmak Loggi ayarlarını, kargo firmasını, önbelleğe alınmış fiyatları ve günlükleri siler. Kapalıysa, yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, modülden Loggi fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Loggi'ye istek gönderilmez.

Tam 8 haneli CEP'e sahip bir Brezilya adresi için modül Loggi paketleri oluşturur: her ürün en kısa kenarı yükseklik olacak şekilde döndürülür ve ürünler, 55 × 55 × 55 cm ve 20 kg sınırları içinde kaldığı sürece tek bir pakete yığılır. Ağırlığı veya boyutları olmayan ürünler kenar başına 1 cm sayılır ve her paket en az 100 g ağırlığındadır. Loggi bir tahmin için 2 paket kabul eder; bu nedenle daha büyük sepetler birden fazla istekle gönderilir ve toplamlar eklenir. Modül Loggi'ye Shop ID'nizi, teslim alma adresini, teslimat adresini ve paketleri gönderir ve Loggi toplamını BRL'den mağazanızın varsayılan para birimine dönüştürür. Fiyat daha sonra müşterinin sepet para biriminde gösterilir.

Her Loggi fiyatı sepet, adres, hesap ve ortam başına 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir tahmin 10 dakika önbelleğe alınır. Loggi hiç erişilemezse, ödeme sayfası her yenilemede Loggi'yi beklemesin diye istekler 2 dakika duraklatılır. API zaman aşımı 10 saniyedir.

Sabit fiyatlar şu durumlarda yerine kullanılır: API yapılandırılmamışsa, adres Brezilya dışındaysa veya henüz tam CEP yoksa, BRL döviz kuru eksikse, teslim alma adresi yoksa, bir ürün bir Loggi paketinden büyükse, sepet 10'dan fazla paket gerektiriyorsa veya Loggi bir hata, reddedilen bir paket, kapsama dışı bir adres ya da sıfır toplam döndürürse. Sabit fiyat da yoksa kargo firması gizlenir. Müşteri asla bir API hatası görmez. Neden hata ayıklama günlüğüne yazılır.

Kargo firmasını siparişleri 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 fiyat hesaplar. Loggi siparişleri veya gönderileri oluşturmaz, etiket yazdırmaz, paketleri takip etmez, ödeme sayfasında teslimat süresini göstermez ve teslim alma noktaları ya da dolapları sunmaz. Gönderileri Loggi panelinde oluşturun. Loggi yalnızca Brezilya içinde teslimat yapar. Diğer ülkeler için sabit fiyatları kullanın.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Loggi lisans bloğu, Modules > Module Manager > VibeFox Loggi > Configure sayfasında ayarların üstündeki ilk bloktur. 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 tarih ve alan adınız) ve Check now (durumu yeniden kontrol etmek için), Change key (başka bir anahtar girmek için) ve Remove key (anahtarı bu mağazadan kaldırmak için) düğmelerini gösterir. Bunların altında Product: presta-shipping-loggi 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 izni olan çalışanlar değiştirebilir. Bloktaki metinler arka ofis dilini takip eder (İ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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül, son bilinen durumu kullanarak ç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ı boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan, Loggi kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini arka ofise giriş yaptığınızı bilmez, bu nedenle kargo firması sizden de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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. Durum, arka ofiste çalışırken 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

Loggi ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Loggi 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üşterinin grubunu kapsadığını kontrol edin (veya Ignore shipping zones açık ve ülke izinli olmalıdır). Modül sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Müşteri henüz tam CEP girmediyse veya Loggi fiyat döndürmüyorsa, kargo firmasının sabit fiyata ihtiyacı vardır: ülke için bir satır, bir * satırı veya Price for countries not in the table. Ürün sayfasında ürünler belirli kargo firmalarıyla da sınırlandırılabilir.

Yalnızca sabit fiyatlar görünüyor: modül sayfasındaki Log alanına bakın. Hatalar her zaman günlüğe yazılır. Her adımı görmek için Debug log seçeneğini açın ve ödeme sayfasını yeniden yükleyin. Yaygın nedenler: API e-postasının, anahtarının veya Shop ID'nin eksik olması, teslim alma adresi olmaması, BRL dışındaki bir mağaza para birimi için BRL exchange rate olmaması, henüz tam 8 haneli CEP olmaması, 55 cm'den büyük veya 20 kg'dan ağır bir ürün ya da Loggi kapsama alanı dışındaki bir adres.

Günlükte HTTP 401 veya 403: Loggi API e-postasını veya anahtarı reddetti. Bunları Loggi ile kontrol edin ve Staging seçeneğinin kimlik bilgileriyle eşleştiğinden emin olun: staging ve üretim anahtarları farklıdır.

Mağazanız euro veya dolar ile satış yapıyor: Loggi BRL cinsinden yanıt verir. BRL exchange rate değerini girin (1 BRL'nin mağazanızın varsayılan para biriminde ne kadar olduğu). Sabit fiyatlar her zaman mağazanızın varsayılan para birimindedir.

Fiyatlar doğru değil: ürünlerinizin ağırlık ve boyutlarını doldurun. Bunlar olmadan ürünler kenar başına 1 cm ve her paket en az 100 g sayılır.

Per item, Loggi fiyatını çarpmıyor: bu amaçlanmıştır. Canlı bir Loggi fiyatı tüm sepeti kapsar. Per item yalnızca sabit fiyatlara uygulanır.

Bir değişiklikten sonra fiyatlar eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Loggi fiyatlarını temizler.

Sayfa Loggi 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 Loggi yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbelleğe alınmış Loggi fiyatları her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişlerini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurduğunuzda, kayıtlı kargo firması kaldırılmadan önceki durumunu geri kazanır.

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