VibeFox Mercado Envios for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Mercado Pago hesabı (yalnızca anlık tarifeler için): anlık tarifeler, Arjantin, Brezilya veya Meksika'daki Mercado Pago hesabınızın Mercado Envios hesap makinesinden gelir. Mercado Envios bu hesap için etkin olmalıdır. Paketler, bu hesapta yapılandırılmış gönderim adresinden fiyatlandırılır. Üretim Access Token'ına ihtiyacınız vardır (APP_USR- ile başlar): Mercado Pago geliştirici panelinde uygulamanızı ve üretim kimlik bilgilerini açın. Giriş düğmesi yoktur: belirteci modül ayarlarına yapıştırırsınız. Yalnızca ülke bazlı fiyatları kullanıyorsanız Mercado Pago 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 daha sonra modül listesinde VibeFox Mercado Envios modülünü bulup Configure düğmesine tıklayın.

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

4. Anlık tarifeler için Access Token'ı yapıştırın, Mercado Envios ülkesini seçin ve mağazanızın varsayılan para birimi ARS, BRL veya MXN değilse döviz kurunu girin. İsteğe bağlı olarak Country prices ve Fallback cost alanlarını doldurun (anlık tarife olmadan kullanılırlar). Save düğmesine tıklayın.

Kurulumda modül, Mercado Envios delivery teslimat süresi metniyle Mercado Envios kargo firmasını oluşturur. Kargo firması tüm bölgelere ve tüm müşteri gruplarına, vergi kuralı olmadan atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Fiyatları orada belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Mercado Envios > 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ış Mercado Envios tarifelerini ve son API hatasını temizler.

Sayfanın üst kısmındaki uyarılar yapılandırma sorunlarını gösterir: eksik döviz kuru, Access Token ve fiyat olmaması, tarihiyle birlikte son Mercado Envios API hatası ve modülün tanımadığı bir mağaza ağırlık veya boyut birimi (bu durumda kg veya cm olarak okunur). Kargo firması silindiyse General bölümü şunu söyler: The Mercado Envios carrier was not found — reset the module to create it again.

General

Müşterilerinizin bölgelerini Shipping > Carriers üzerinden Mercado Envios kargo firmasına ekleyin veya aşağıdaki Ignore shipping zones seçeneğini kullanın. Bu ayarlar her bölge için geçerlidir.

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

Name: müşterilere ödeme sayfasında gösterilen kargo firması adı. Varsayılan: Mercado Envios. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax (varsayılan). Mercado Envios son fiyatları bildirir. No tax bunları bildirildiği gibi gösterir; bir vergi kuralı ise kargo vergisinizi üzerine ekler.

Mercado Envios API (anlık tarifeler) (belirteç olmadan yalnızca aşağıdaki fiyatlar kullanılır)

Access token: Mercado Pago üretim Access Token'ınız (APP_USR-...). Yalnızca api.mercadopago.com adresine gönderilir ve hiçbir zaman günlüğe yazılmaz. 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. Anlık tarifeleri kullanmayı bırakmak için Remove the saved access token (only the prices below are used then) seçeneğini işaretleyip kaydedin.

Mercado Envios country: Mercado Pago hesabınızın ülkesi: Argentina (ARS) (varsayılan), Brazil (BRL) veya Mexico (MXN). Anlık tarifeler yalnızca bu ülkedeki varış noktaları için istenir ve o ülkenin para biriminde verilir.

Exchange rate: yalnızca mağazanızın varsayılan para birimi Mercado Envios para biriminden farklıysa gerekir: mağazanızın varsayılan para biriminde 1 ARS, BRL veya MXN'in fiyatı, örneğin 0.001. Bu olmadan anlık tarifeler kullanılmaz. Pozitif bir sayı olmalıdır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Anlık tarife olmadan fiyatlar

Bu fiyatlar; belirteç yoksa, varış noktası Mercado Envios ülkesinin dışındaysa ve API hiç tarife vermezse kullanılır. Mağazanızın varsayılan para biriminde ve vergi hariç olarak belirtilirler.

Country prices: varış ülkelerinin ve fiyatların bir tablosu. 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çeneğini seçin. Price, ülke için fiyattır. XS (1 kg'a kadar), S (1-2 kg), M (2-3 kg), L (3-5 kg) ve XL (5 kg'ın üzeri) sütunları, sepet ağırlığına göre bu fiyatın yerini alır. Boş veya 0 olan bir sütun Price değerini kullanır. Price değeri 0 ise o ülkeye ücretsiz kargo anlamına gelir. Hem 9.99 hem 9,99 kabul edilir. Sayı olmayan değerler kaydetmeden sonra bildirilir ve temizlenir. Hiçbir fiyatı olmayan satırlar kaydederken silinir.

Fallback cost: ne API ne de Country prices bir fiyat verdiğinde kullanılır. Bu durumda kargo firmasını gizlemek için boş bırakın.

Calculation type: Per order ücreti bir kez alır. Per item (each item priced by its own weight x quantity), her ürünün ağırlığı için Country prices (veya Fallback cost) değerine bakar ve bunu ürün adediyle çarpar. Bir ürün için fiyat bulunmazsa kargo firması gizlenir. Anlık Mercado Envios tarifeleri her zaman tüm paket içindir.

Kullanılabilirlik

Min weight: bu kargo firmasının görünmesi için sepetin kg cinsinden minimum ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight: sepet daha ağır olduğunda kargo firmasını gizler; kg cinsinden. Boş bırakmak 25 kg, 0 ise sınır yok anlamına gelir. Max weight değerinden büyük bir Min weight kaydederken reddedilir.

Minimum subtotal: kargo firmasını yalnızca sepetin ara toplamı (indirimlerden sonra, vergiden önce) en az bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Ignore shipping zones: kargo firmasını, bölgelerini ayarlamadan aşağıdaki ülkeler için sunar. Kaydedildiğinde kargo firması tüm bölgelere eklenir; sonradan oluşturulan bölgelere de eklenir. Seçeneği kapatmak, bunun eklediği bölgeleri kaldırır; kargo firması kendi bölgelerini korur.

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

Ücretsiz kargo

Free shipping from: bu kargo firmasının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergiden önce). Bu durumda API isteği yapılmaz. Devre dışı bırakmak için boş bırakın.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamasını modül klasöründeki logs/vfd_mrcv_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar bu seçenek kapalıyken de her zaman kaydedilir. Access Token ve müşteri adresleri hiçbir zaman günlüğe yazılmaz.

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

Remove data on uninstall: açık olduğunda modülün kaldırılması ayarları, kargo firmasını, önbellekteki tarifeleri ve günlükleri siler. Kapalı olduğunda yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop modülden Mercado Envios fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve Mercado Envios'a hiçbir istek gönderilmez.

Geçerli bir posta koduna sahip Mercado Envios ülkesindeki bir varış noktası için modül sepeti tek bir paket olarak tanımlar: ürünlerin en büyük genişliği ve uzunluğu, tüm ürünlerin yükseklikleri toplamı ve gram cinsinden toplam ağırlık. Her kenar ve ağırlık, ülkenin Mercado Envios minimum değerlerine yükseltilir; bu nedenle boyutu ya da ağırlığı olmayan ürünler de bir tarife alır. Sepet değeri, Mercado Envios para biriminde ürün fiyatı olarak gönderilir. Mercado Envios'un döndürdüğü en ucuz seçenek mağazanızın varsayılan para birimine çevrilir ve ardından müşterinin sepet para biriminde gösterilir.

Her teklif 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir teklif 5 dakika boyunca tekrarlanmaz. Mercado Pago'ya ulaşılamazsa, belirteci reddederse veya istekleri sınırlarsa, tüm anlık teklifler 5 dakika duraklatılır; böylece ödeme sayfası her yenilemede API'yi beklemez. API zaman aşımı 10 saniyedir.

Belirteç yoksa, varış noktası Mercado Envios ülkesinin dışındaysa, posta kodu eksik veya geçersizse, döviz kuru eksikse, paket ülkenin Mercado Envios ağırlık sınırından ağırsa (Arjantin'de 25 kg, Brezilya'da 15 kg, Meksika'da 30 kg) veya Mercado Envios adres için hata ya da hiçbir seçenek döndürmezse, anlık tarife olmayan fiyatlar bunların yerine kullanılır. Ülkenin satırı (veya * satırı) kullanılır, yoksa yedek ücret. Hiçbir fiyat yoksa kargo firması gizlenir. Müşteri hiçbir zaman bir API hatası görmez.

Kargo firmasında 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 tarifeleri hesaplar. Gönderi oluşturmaz, etiket yazdırmaz ve paketleri takip etmez. Gönderiyi Mercado Libre veya Mercado Pago hesabınızda oluşturun. Tüm seçenekler arasından seçim yapmak yerine tek bir fiyat, yani en ucuz Mercado Envios seçeneğini gösterir ve bir teslim noktası (acente) seçici içermez.

Siparişler

Bir sipariş anlık bir Mercado Envios tarifesiyle verildiğinde modül, hizmet adını, gün cinsinden tahmini teslimat süresini ve anlık tarifeyi saklar. Yönetim panelinde sipariş sayfası, Mercado Envios service, Estimated delivery ve Live rate (excl. tax) alanlarını içeren bir Mercado Envios bloğu gösterir. Müşteri, hesabındaki sipariş ayrıntıları sayfasında Mercado Envios service ve Estimated delivery alanlarını görür. Mevcut siparişler sonraki tarife değişikliklerinden etkilenmez.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Mercado Envios lisans bloğu, Modules > Module Manager > VibeFox Mercado Envios > 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ı 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-mercado-envios 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 modül için Configure izni olan ç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 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: çok mağazalı kurulumda da ana mağazanın alan adında. 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 Mercado Envios kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden kargo firması sizden de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, 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ı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

Mercado Envios ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Mercado Envios shipping 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 seçeneğini açıp Countries alanını kontrol edin). Modül sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Kargo firmasının bir fiyatı olmalıdır: Mercado Envios ülkesindeki adresler için çalışan bir access token veya Country prices ya da Fallback cost. Ayrıca ürün sayfasında ürünler belirli kargo firmalarıyla sınırlandırılmış olabilir.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Yaygın nedenler: belirteç yok, varış noktası Mercado Envios ülkesinin dışında, posta kodu eksik veya geçersiz, Exchange rate eksik, paket ağırlık sınırını aşıyor veya adres için Mercado Envios seçeneği yok.

Uyarılarda HTTP 401 veya 403: Access token geçersiz veya süresi dolmuş. Mercado Pago geliştirici panelinden üretim Access Token'ını yeniden kopyalayın.

Mercado Envios başka bir para biriminde yanıt verdi: hesabın ülkesi Mercado Envios country ile eşleşmiyor. Mercado Pago hesabınızın ülkesini seçin.

Fiyatlar hangi para biriminde: Country prices, Fallback cost ve eşikler mağazanızın varsayılan para birimindedir. Anlık tarifeler Mercado Pago hesabınızın para biriminde gelir ve mağaza başka bir varsayılan para birimi kullandığında Exchange rate ile çevrilir.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki tarifeleri temizler.

Sayfa Mercado Envios 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ünden modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Mercado Envios yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbelleğe alınmış tarifeler her zaman silinir. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur), ayrıca ayarlar, günlük ve siparişlerin kayıtlı hizmet verileri kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar ile sipariş hizmet verileri korunur. Modülü yeniden kurduğunuzda kargo firması, kaldırılmadan önceki durumunu geri alır.

Mercado Envios ve Mercado Pago, ilgili sahiplerinin ticari markalarıdır. Bu modül Mercado Envios veya Mercado Pago ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.