VibeFox 99Minutos for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

99minutos API anahtarı (yalnızca kapsam kontrolü için): hesap yöneticinizden veya 99minutos geliştirici portalinden (developers.99minutos.com) edinin. 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 System > Localisation > Countries bölümünde etkin olmalıdır.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_99minutos-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_99minutos.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_99minutos-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine bu paketin upload klasöründeki içeriği mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox 99Minutos eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın.

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

5. Price matrix bölümü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). Enable 99Minutos seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_99minutos.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentilerin listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox 99Minutos eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4 ve 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, Enable 99Minutos seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız 99minutos ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı sayfayı yenilemeden kaydeder. Her kayıtta kapsam kontrolünün önbelleğe alınmış sonuçları da temizlenir. Bir değer hatalıysa hiçbir şey kaydedilmez ve sayfa nedenini gösterir; örneğin Enter a method title (1 to 64 characters)., bir alanın 0 veya daha büyük bir sayı olması gerektiğine dair bir ileti veya Min weight (kg) değerinin Max weight (kg) değerinden büyük olamayacağını belirten bir ileti. Kaydettikten sonra ayarların üstündeki uyarılar, yöntemin mevcut yapılandırmayla çalışamayacağı durumları bildirir: fiyat matrisi boşsa, API anahtarı olmadan bir kapsam kontrolü modu seçilmişse, matriste 99minutos'un hizmet vermediği ülkeler için satırlar varsa veya mağazada "kg" ağırlık sınıfı yoksa ve ağırlık birimi eklenti tarafından tanınmıyorsa (bu durumda ağırlıklar kilogram olarak alınır). Ayarları yalnızca bu eklentiyi değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Genel

Ayarlar tüm coğrafi bölgeler için geçerlidir. 99Minutos yalnızca Meksika, Kolombiya, Şili ve Peru hedef ülkeleri için sunulur.

Enable 99Minutos: ödeme sayfasında 99Minutos'u gösterir veya gizler. Varsayılan: kapalı.

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

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Bir vergi sınıfı seçiliyse OpenCart, matristeki fiyata vergi ekler.

Sort order: ödeme sayfasında 99Minutos'un kargo yöntemleri arasındaki konumu. Tam sayı.

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ü ile yöntem, müşteri bir posta kodu girdikten sonra görünür. Sonuçlar önbelleğe alınır: kapsam dahilinde 6 saat, kapsam dışında 30 dakika, API hatası 5 dakika; ancak OpenCart önbellek süresinden (varsayılan 1 saat) daha uzun değil. 99minutos'a yalnızca posta kodu gönderilir; büyük harfle ve yalnızca harf ve rakamlardan oluşacak şekilde.

API key: 99minutos API anahtarınız; 99minutos kapsam uç noktasına Bearer belirteci olarak gönderilir. Kapsam kontrolü açıkken zorunludur. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ibaresini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Anahtar yazıldığı gibi kaydedilir; yalnızca çevresindeki boşluklar silinir.

Remove the saved API key: yalnızca kayıtlı bir anahtar olduğunda görünür. Açın ve anahtarı silmek için Save düğmesine tıklayın.

Environment: Sandbox (test) (varsayılan) veya Production. Sandbox ve canlı ortam farklı API anahtarları kullanır; bu nedenle anahtarınıza uyan ortamı seçin.

Tarifeler

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

Price matrix: hedef ülkeler ve fiyatlardan oluşan bir tablo. Satır eklemek için Add country düğmesine, satır silmek için × düğmesine 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 çok satırı varsa ilk satır 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 yöntem ö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: bir sipariş tutarından itibaren ücretsiz kargoyu açar.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi); bu tutarın üzerinde ücret 0 olur. Yalnızca Free shipping açıkken kullanılır.

Kısıtlamalar

Min weight (kg): sepet bundan hafifse yöntemi gizler. 0 sınırsız anlamına gelir (varsayılan). Max weight (kg) değerinden büyük olamaz. Ürün ağırlıkları ağırlık sınıflarından dönüştürülür.

Max weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 25. 0 sınırsız anlamına gelir; boş alan 25 kg anlamına gelir.

Minimum subtotal: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) bu tutara eşit veya üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Geo zone: 99Minutos'u yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir.

Restrict countries: kargo yöntemini yalnızca aşağıdaki ülkeler için sunar. Bu, Geo zone üzerine eklenen ek bir filtredir.

Countries: 99minutos ülkelerinden (Meksika, Kolombiya, Şili, Peru) bir seçim. 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: tarife hesaplamalarını storage/logs/vfd_99m_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. Bu kapalıyken bile API hataları günlüğe yazılır. API anahtarları ile müşteri adları ve adresleri asla günlüğe yazılmaz. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_99m_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: hata ayıklama günlüğünü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 eklentiyi kaldırmak 99minutos ayarlarını, kapsam önbelleğini ve günlüğü siler. Kapalıysa (varsayılan) yeniden kurulum için saklanırlar. Siparişler her durumda korunur.

İçe Aktarma / Dışa Aktarma

Export: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API anahtarı dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Değerler normal bir kayıtta olduğu gibi kontrol edilir. Kayıtlı API anahtarı korunur.

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

OpenCart kargo yöntemlerini gösterirken eklentiden 99Minutos fiyatını ister. Bir Geo zone ayarlıysa ve adres bu bölgenin dışındaysa 99Minutos sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler hesaba katılır: diğer ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Yöntem yalnızca teslimat ülkesi Meksika, Kolombiya, Şili veya Peru ise sunulur (ve Restrict countries açıksa Countries listesinde yer alır). Ardından eklenti ağırlık sınırlarını ve Minimum subtotal değerini kontrol eder. Sipariş tutarı, kupon indiriminden sonra ve vergi öncesi, kargo gerektiren ürünlerin fiyatıdır. Hediye kartları, sadakat puanları ve mağaza kredisi hesaba katılmaz.

Kapsam kontrolü açıksa eklenti, 99minutos API'sine posta kodunun kapsam alanında olup olmadığını sorar. İstek 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 yöntem 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 yöntem gizlenir. Free shipping açıksa ve sipariş tutarı Free shipping from değerine ulaşırsa tarife 0 olur. Fiyat mağazanın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçilen Tax class vergisiyle birlikte müşteriye kendi para biriminde gösterilir.

Eklenti 99minutos'tan canlı kargo tarifeleri almaz: fiyatlar her zaman sizin matrisinizden gelir. 99minutos'ta gönderi veya sipariş oluşturmaz, kargo etiketi (guide) yazdırmaz, paketleri takip etmez, Punto99 teslim noktaları sunmaz ve kapıda ödemeyi desteklemez. Siparişlere hiçbir şey eklemez: sipariş, diğer tüm OpenCart kargo yöntemleri gibi yöntem adını ve kargo ücretini gösterir. Gönderileri her zamanki gibi 99minutos hesabınızdan oluşturun.

OpenCart 4'te müşteri, kargo yöntemi bloğundaki Choose düğmesine tıklar ve Shipping method options penceresinde 99Minutos'u seçer. Yöntem, OpenCart 3'teki ile aynı şekilde çalışır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox 99Minutos lisans bloğu, Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now düğmesini (durumu yeniden kontrol etmek için), Change key düğmesini (başka bir anahtar girmek için) ve Remove key düğmesini (anahtarı bu mağazadan kaldırmak için) gösterir. Bunların altında Product: opencart-shipping-99minutos satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 License expired on ve bir tarih. 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, kargo yöntemini yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu ön izleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan kargo yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici panelindeki Dashboard veya Edit sayfası açıldığında 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. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman 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 System > Localisation > Countries bölümünde etkin olmalıdır. Geo zone ve Restrict countries ayarlarını kontrol edin. Price matrix bölümünde o ülke için bir satır veya bir * Default satırı bulunduğunu doğrulayın; ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Ürünlerin Requires Shipping değerinin Yes olduğundan emin olun. Save düğmesinden sonra görünen uyarılar, yöntemi gizleyen ayarları gösterir.

Yöntem yalnızca bir posta kodu girildikten sonra görünüyor: kapsam kontrolü ile bu beklenen bir davranıştır. Strict modunda yöntem yalnızca API kapsamı onayladığında görünür.

Strict modunda yöntem her zaman gizli: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti sayfasındaki Log alanına bakın. HTTP 401 veya 403 hatası, API anahtarının reddedildiği anlamına gelir: anahtarı ve Environment değerinin buna uyduğunu kontrol edin (sandbox ve canlı anahtarlar farklıdır). API kullanılamadığında müşterilerin yine matris fiyatını görmesi gerekiyorsa Soft modunu kullanın.

Fiyat beklediğiniz gibi değil: Calculation seçeneğini (sipariş başına veya ürün başına) ve ürün ağırlıklarını ve ağırlık sınıflarını kontrol edin. Boş veya 0 olan bir boyut fiyatı Base price değerini kullanır. Tax class seçiliyse matris fiyatına vergi eklenir.

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

Sayfa "Warning: You do not have permission to modify VibeFox 99Minutos!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_99minutos (OpenCart 3) veya extension/vfd_99minutos/shipping/vfd_99minutos (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: 99minutos API adresi, vfd_99m_api_url ayarıyla değiştirilebilir (testler için); ayarlar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox 99Minutos yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable 99Minutos, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbelleğe alınmış kapsam sonuçları her zaman silinir. Remove data on uninstall açıksa 99minutos ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kendi kargo yöntemlerini ve maliyetlerini korur.

OpenCart 4'te dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox 99Minutos yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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