VibeFox 99Minutos 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.

99minutos API anahtarı (yalnızca kapsam kontrolü için): 99minutos hesap yöneticinizden veya 99minutos geliştirici portalından (developers.99minutos.com) alın. Sandbox ve canlı anahtarlar farklıdır. Yalnızca fiyat matrisini kullanıyorsanız API anahtarına ihtiyacınız yoktur.

Ülkeler: 99minutos, Meksika, Kolombiya, Şili ve Peru'ya teslimat yapar. Gönderim yaptığınız ülkeler International > Locations bölümünde aktif olmalıdır.

VibeFox lisans anahtarı: vibefox.net'ten 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 99Minutos modülünü bulup Configure düğmesine tıklayın.

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

4. Price matrix alanını doldurun (en az bir satır, örneğin “* Default”) ve isteğe bağlı olarak API anahtarını ve kapsam kontrolü modunu girin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Courier delivery teslimat süresi metniyle 99Minutos taşıyıcısını oluşturur. Taşıyıcı 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ünde değiştirebilirsiniz. Meksika, Kolombiya, Şili ve Peru bölgeleri taşıyıcı için etkin kalmalıdır. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox 99Minutos > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbelleğe alınmış kapsam sonuçlarını temizler. Kaydettikten sonra sayfa; fiyat matrisi boşsa, 99minutos'un hizmet vermediği ülkeler için satır varsa, API anahtarı olmadan bir kapsam kontrolü modu seçildiyse veya modül mağazanın ağırlık birimini tanımıyorsa (bu durumda ağırlıklar kilogram kabul edilir) sizi uyarır. Method title 64 karakterden uzunsa, bir ağırlık veya tutar alanı 0 veya daha büyük bir sayı değilse ya da Min weight (kg), Max weight (kg) değerinden büyükse hiçbir şey kaydedilmez ve bir hata gösterilir. Sayfa The 99Minutos carrier was not found — reset the module to create it again. mesajını gösteriyorsa Sorun giderme bölümüne bakın.

Genel

Enable 99Minutos: taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Method title: müşterinin sepette ve ödeme sayfasında gördüğü taşıyıcı adı. Varsayılan: 99Minutos. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı veya No tax. Bir vergi kuralı varsa PrestaShop, matristeki kargo fiyatına vergi ekler.

99minutos API (kapsam kontrolü) (isteğe bağlı)

API yalnızca 99minutos'un müşterinin posta koduna teslimat yapıp yapmadığını kontrol etmek için kullanılır. Fiyat her zaman matristen gelir.

Coverage check: posta kodunun kontrol edilip edilmeyeceği ve nasıl kontrol edileceği.

Kapsam kontrolü açıkken taşıyıcı, müşteri bir posta kodu girdikten sonra görünür. Sonuçlar önbelleğe alınır: kapsanan 6 saat, kapsanmayan 30 dakika, API hatası 5 dakika. 99minutos'a yalnızca posta kodu gönderilir; büyük harflerle ve yalnızca harf ve rakamlardan oluşacak şekilde.

API key: 99minutos API anahtarınız; kapsam kontrolü uç noktasına Bearer token olarak gönderilir. Kapsam kontrolü açıkken zorunludur. 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. Anahtar yazdığınız gibi kaydedilir; yalnızca başındaki ve sonundaki boşluklar silinir.

Remove the saved API key: yalnızca kayıtlı bir anahtar varsa gösterilir. Bunu açın ve anahtarı silmek için Save düğmesine tıklayın.

Environment: Sandbox (test) (varsayılan) veya Production. Sandbox ve production farklı API anahtarları kullanır; bu nedenle anahtarınızla eşleşen ortamı seçin.

Tarifeler

Fiyatlar mağazanızın varsayılan para biriminde, vergi hariç olarak girilir ve girildiği gibi kullanılır. Son fiyat müşterinin sepet para biriminde gösterilir.

Price matrix: hedef ülkelerin ve fiyatların bulunduğu bir tablo. Satır eklemek için Add country düğmesine, bir satırı silmek için çöp kutusu simgesine tıklayın. Her satırda bir Country (* Default, Meksika, Kolombiya, Şili veya Peru), bir Base price ve XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg'dan fazla) boyutları için fiyatlar bulunur. Boş veya 0 olan bir boyut fiyatı Base price değerini kullanır. * Default satırı, kendi satırı olmayan ülkeler için geçerlidir. Bir ülkenin birden fazla satırı varsa ilki kullanılır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir; boş, geçersiz veya negatif fiyatlar 0 olarak kaydedilir. Matriste en az bir satır olana kadar taşıyıcı ödeme sayfasında gösterilmez.

Calculation: Per order — size by the total cart weight (varsayılan) tüm sepetin paket boyutu için tek bir fiyat alır. Per item — each unit priced by its own weight her birimi kendi ağırlığının boyutuna göre fiyatlandırır ve tutarları toplar.

Free shipping: sepet ara toplamından itibaren ücretsiz kargoyu açar.

Free shipping from: ücretin 0 olduğu sepet ara toplamı (indirimler sonrası, vergi hariç). Yalnızca Free shipping açıkken kullanılır.

Kısıtlamalar

Min weight (kg): sepet bundan hafifse taşıyıcıyı gizler. 0 sınır olmadığı anlamına gelir. Max weight (kg) değerinden büyük olamaz. Ürün ağırlıkları mağazanızın ağırlık biriminden çevrilir.

Max weight (kg): sepet bundan ağırsa taşıyıcıyı gizler. Varsayılan: 25. 0 sınır olmadığı anlamına gelir; boş alan 25 kg anlamına gelir.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı (indirimler sonrası, vergi hariç) en az bu tutarsa gösterir. Her zaman göstermek için boş bırakın.

Restrict countries: taşıyıcıyı yalnızca aşağıdaki ülkeler için sunar. Bu, taşıyıcı bölgelerine ek bir filtredir. Bir bölge birden fazla ülkeyi kapsadığında kullanışlıdır.

Countries: 99minutos ülkelerinden bir seçim (Meksika, Kolombiya, Şili, Peru). Birden fazla seçmek için Ctrl (Cmd) tuşunu basılı tutun. Yalnızca Restrict countries açıkken kullanılır. Tüm 99minutos ülkelerine izin vermek için boş bırakın.

Gelişmiş

Debug log: fiyat hesaplamalarını modül klasöründeki logs/vfd_99m_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Bu kapalı olsa bile API hataları kaydedilir. API anahtarları ile müşteri adları ve adresleri asla kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

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çıksa modülü kaldırmak ayarları, taşıyıcıyı, kapsam önbelleğini ve günlüğü siler. Kapalıysa yeniden kurulum için her şey saklanır. Siparişler her durumda saklanır.

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

Kargo adımında PrestaShop, modülden 99Minutos fiyatını ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve sepet ara toplamına dahil edilmez. Taşıyıcı yalnızca teslimat ülkesi Meksika, Kolombiya, Şili veya Peru ise sunulur (ve Restrict countries açıksa Countries listesinde yer alıyorsa). Ardından modül ağırlık sınırlarını ve Minimum subtotal değerini kontrol eder.

Bir kapsam kontrolü modu açıksa modül, 99minutos API'sine posta kodunun kapsanıp kapsanmadığını sorar. İstek için zaman aşımı 10 saniyedir ve yanıt önbelleğe alınır; böylece aynı posta kodu yeni bir istek tetiklemez. API hataları müşteriye asla gösterilmez: Strict modunda taşıyıcı gizlenir, Soft modunda matris fiyatı kullanılır. Ücretsiz kargo kapsam kontrolünü atlamaz.

Fiyat, teslimat ülkesinin matris satırından veya * Default satırından alınır. İkisi de yoksa taşıyıcı gizlenir. Free shipping açıksa ve sepet ara toplamı Free shipping from değerine ulaşırsa ücret 0 olur. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Taşıyıcının siparişleri olduktan sonra Shipping > Carriers bölümünde düzenlerseniz PrestaShop onu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül 99minutos'tan canlı kargo ücreti teklifleri almaz: fiyatlar her zaman matrisinizden gelir. 99minutos'ta gönderi veya sipariş oluşturmaz, etiket (guides) yazdırmaz, kargoları takip etmez, Punto99 teslim noktaları sunmaz ve kapıda ödemeyi yönetmez. Gönderileri her zamanki gibi 99minutos hesabınızda oluşturun.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox 99Minutos lisans bloğu, Modules > Module Manager > VibeFox 99Minutos > 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ı maskeli olarak, durumu (örneğin lisansın hangi tarihe kadar geçerli olduğunu ve alan adınızı) gösterir. Ayrıca 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 düğmeleri bulunur. Bunların altında Product: presta-shipping-99minutos satırı ve Manage licenses and domains in your account bağlantısı yer alır; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office 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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa 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 99Minutos taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop mağazası back office'e giriş yaptığınızı bilmez; bu nedenle taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce yapılandırabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, back office'te ç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

99Minutos ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable 99Minutos seçeneğinin açık olduğunu kontrol edin. Teslimat ülkesi Meksika, Kolombiya, Şili veya Peru olmalı ve International > Locations bölümünde aktif olmalıdır. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin. Price matrix bölümünde o ülke için veya bir * Default satırı olduğunu kontrol edin; ardından ağırlık sınırlarını, Minimum subtotal ve Restrict countries ayarlarını inceleyin. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlanmış olabilir.

Taşıyıcı yalnızca posta kodu girildikten sonra görünür: kapsam kontrolüyle bu beklenen bir durumdur. Strict modunda yalnızca API posta kodunun kapsandığını onayladığında görünür.

Strict modunda taşıyıcı her zaman gizli: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. HTTP 401 veya 403 hatası API anahtarının reddedildiği anlamına gelir: anahtarı ve Environment ayarının buna uyup uymadığını kontrol edin (sandbox ve production anahtarları farklıdır). Müşterilerin API kullanılamazken yine de matris fiyatını görmesi gerekiyorsa Soft modunu kullanın.

Fiyat beklediğiniz gibi değil: Calculation (sipariş başına veya ürün başına), ürün ağırlıklarını ve mağazanızın ağırlık birimini (International > Localization) kontrol edin. Boş veya 0 olan bir boyut fiyatı Base price değerini kullanır. Tax bölümünde bir vergi kuralı varsa vergi matris fiyatına eklenir.

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

Sayfa 99Minutos taşıyıcısının bulunamadığını bildiriyor: taşıyıcı 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. Aynı durum The settings were saved, but the carrier could not be updated. Reset the module to create it again. mesajı için de geçerlidir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox 99Minutos yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Kapsam önbelleği de her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişlerini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar saklanır. Modül yeniden kurulduğunda kayıtlı taşıyıcı, kaldırılmadan önceki durumunu geri kazanır; bu nedenle Reset devre dışı bir taşıyıcıyı etkinleştirmez.

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