VibeFox Mercado Envios for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

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 etkinleştirilmiş 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 ayarlara 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. 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. Ayrıca vfd_mercado_envios klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Mercado Envios yolunu izleyin ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Anlık tarifeler için Access Token'ı yapıştırın, Mercado Envios ülkesini seçin ve mağaza para biriminiz 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 tarifeler olmadan kullanılırlar).

6. VibeFox Mercado Envios yöntemini WooCommerce > Settings > Shipping > Shipping zones bölümündeki bir kargo bölgesine ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada yer alır: WooCommerce > Settings > Shipping > VibeFox Mercado Envios. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): ödeme sayfasında bu seçeneğin adı. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üstündeki uyarılar yapılandırma sorunlarını gösterir: eksik döviz kuru, erişim belirteci ve fiyat olmaması, tarih bilgisiyle birlikte son Mercado Envios API hatası. Ayarları her kaydettiğinizde önbelleğe alınmış tarifeler temizlenir.

Genel

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

Name: ödeme sırasında müşterilere gösterilen kargo yöntemi adı. Varsayılan: Mercado Envios.

Tax status: Mercado Envios nihai fiyatlar sunar. None bunları teklif edildiği gibi gösterir, Taxable ise WooCommerce 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 Mercado Pago'ya gönderilir ve asla günlüğe kaydedilmez.

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ğaza para biriminiz Mercado Envios para biriminden farklıysa gereklidir: 1 ARS, BRL veya MXN'nin mağaza para birimindeki fiyatı, örneğin 0.001. Bu olmadan anlık tarifeler kullanılmaz. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Anlık tarife olmadan fiyatlar

Bu fiyatlar erişim belirteci olmadığında, Mercado Envios ülkesi dışındaki varış noktaları için ve API tarife döndürmediğinde kullanılır.

Country prices: mağaza para biriminde fiyatlar. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeler için * All other countries seçin. Price, ülkenin fiyatıdır. XS (1 kg'a kadar), S (1-2 kg), M (2-3 kg), L (3-5 kg) ve XL (5 kg'dan fazla) sütunları, sepetin o ağırlığı için bu fiyatın yerine geçer. Boş veya 0 olan bir sütun Price değerini kullanır. Sayı olmayan değerler kaydetmeden sonra bildirilir ve silinir. Hiçbir fiyatı olmayan satırlar kaydetme sırasında kaldırılır.

Fallback cost: API de Country prices de fiyat vermediğinde kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

Calculation type: Per order fiyatı bir kez uygular. Per item (each item priced by its own weight x quantity), her ürünün ağırlığına göre Country prices (veya Fallback cost) içinden fiyat arar ve adetle çarpar. Mercado Envios anlık tarifeleri her zaman tüm paket için geçerlidir.

Uygunluk

Min weight (kg): bu yöntemin görünmesi için gereken minimum sepet ağırlığı. 0, sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan daha ağır olduğunda yöntemi gizler. Varsayılan: 25. 0, sınır olmadığı anlamına gelir.

Minimum subtotal: yöntemi yalnızca sepetin ara toplamı bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir ürün bu WooCommerce kargo sınıflarından birine aitse yöntemi gizler.

Ignore shipping zones: yöntem bir kargo bölgesine eklenmemiş olsa bile, yöntemi aşağıda belirtilen ülkeler için sunar.

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

Ücretsiz kargo

Free shipping from: bu yöntemin ücretsiz olduğu sepet ara toplamı. Bu durumda Mercado Envios'e istek gönderilmez. Devre dışı bırakmak için boş bırakın.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamasını WooCommerce > Status > Logs altına (kaynak vfd-mercado-envios) kaydeder. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Erişim belirteci ve müşteri adresleri asla kaydedilmez.

Remove data on uninstall: açıkken eklentiyi silmek, tüm eklenti ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse yöntem 0 tutarında olur ve Mercado Envios'e istek gönderilmez.

Geçerli bir posta koduna sahip, Mercado Envios ülkesindeki bir varış noktası için eklenti sepeti tek bir paket olarak tanımlar: ürünlerin en büyük genişliği ve uzunluğu, tüm ürünlerin yüksekliklerinin toplamı ve gram cinsinden toplam ağırlık. Her kenar ve ağırlık, ülkenin Mercado Envios minimum değerlerine yükseltilir; böylece boyutu veya ağırlığı olmayan ürünler de bir tarife alır. Sepet tutarı, Mercado Envios para biriminde ürün fiyatı olarak gönderilir. Mercado Envios'in döndürdüğü en ucuz seçenek mağaza para birimine çevrilir ve yöntem adınızın altında 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 veya belirteç reddedilirse, ödeme sayfası her yenilemede API'yi beklemesin diye tüm anlık teklifler 5 dakika duraklatılır. API zaman aşımı 10 saniyedir.

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

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 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. Yöntem başına bir tarife gösterir: tüm seçenekler arasında seçim değil, en ucuz Mercado Envios seçeneği; ayrıca bir teslim noktası (acente) seçicisi yoktur.

Siparişler

Sipariş anlık tarifeyle verildiğinde, hizmet adı ve gün cinsinden tahmini teslimat süresi siparişin kargo satırına Mercado Envios service ve Estimated delivery olarak kaydedilir. Mevcut siparişler kargo satırlarını korur.

Lisans anahtarı

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

Etkin bir anahtar olmadan Mercado Envios, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de bunu (unlicensed — visible to admins only) etiketiyle görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. 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 arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Mercado Envios ö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ıları, ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Yöntemin bir fiyata ihtiyacı vardır: Mercado Envios ülkesindeki adresler için çalışan bir erişim belirteci ya da Country prices veya Fallback cost.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd-mercado-envios olacak şekilde açın. Yaygın nedenler: belirteç yok, varış noktası Mercado Envios ülkesi dışında, posta kodu eksik veya geçersiz, Exchange rate eksik, paket ağırlık sınırını aşıyor ya da adres için Mercado Envios seçeneği yok.

Uyarılarda HTTP 401 veya 403: erişim belirteci 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 ve Fallback cost, mağaza para biriminizdedir. Anlık tarifeler Mercado Pago hesabınızın para biriminde gelir ve mağaza başka bir para birimi kullanıyorsa Exchange rate ile çevrilir.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış tarifeleri 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, anahtarı yeni alan adı için 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ı korur. Yalnızca tarife önbelleği temizlenir. Eklentiyi tamamen kaldırmak için devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış tarifeler ve son API hatası 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 sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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