VibeFox Mercado Envios for WooCommerce — Ayuda

Requisitos

WordPress: 5.8 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.

PHP: 8.0 o posterior.

Cuenta de Mercado Pago (solo para tarifas en tiempo real): las tarifas en tiempo real proceden de la calculadora de Mercado Envios de tu cuenta de Mercado Pago en Argentina, Brasil o México. Mercado Envios debe estar activado en la cuenta. Los paquetes se cotizan desde la dirección de envío configurada en esa cuenta. Necesitas el Access Token de producción (empieza por APP_USR-): en el panel de desarrolladores de Mercado Pago, abre tu aplicación y sus credenciales de producción. No hay botón de inicio de sesión: pegas el token en los ajustes. Si solo usas precios por país, no necesitas una cuenta de Mercado Pago.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.

Instalación

1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta vfd_mercado_envios a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Mercado Envios, o haz clic en Settings debajo del nombre del plugin en la página Plugins.

4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.

5. Para las tarifas en tiempo real, pega el Access Token, elige el país de Mercado Envios y, si la moneda de tu tienda no es ARS, BRL o MXN, el tipo de cambio. Opcionalmente, rellena Country prices y Fallback cost (se usan sin tarifas en tiempo real).

6. Añade VibeFox Mercado Envios a una zona de envío en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige los países.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Mercado Envios. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona solo tiene un campo:

Title (zone): el nombre de esta opción en la finalización de compra. Déjalo vacío para usar el Name general.

Las advertencias de la parte superior de la página muestran los problemas de configuración: falta el tipo de cambio, no hay token de acceso ni precio, y el último error de la API de Mercado Envios con su fecha. Cada vez que guardas los ajustes, se borran las tarifas en caché.

General

Enable/Disable: activa o desactiva el envío de Mercado Envios en todas las zonas a la vez.

Name: el nombre del método de envío que ven los clientes en la finalización de compra. Por defecto: Mercado Envios.

Tax status: Mercado Envios cotiza precios finales. None los muestra tal como se cotizan; Taxable añade encima tu impuesto de envío de WooCommerce.

Mercado Envios API (tarifas en tiempo real) (sin token solo se usan los precios de abajo)

Access token: tu Access Token de producción de Mercado Pago (APP_USR-...). Solo se envía a Mercado Pago y nunca se registra en el log.

Mercado Envios country: el país de tu cuenta de Mercado Pago: Argentina (ARS) (por defecto), Brazil (BRL) o Mexico (MXN). Las tarifas en tiempo real solo se solicitan para destinos de este país y se cotizan en su moneda.

Exchange rate: solo es necesario si la moneda de tu tienda es distinta de la de Mercado Envios: el precio de 1 ARS, BRL o MXN en la moneda de tu tienda, por ejemplo 0.001. Sin él no se usan las tarifas en tiempo real. Se aceptan tanto el punto como la coma como separador decimal.

Precios sin tarifas en tiempo real

Estos precios se usan cuando no hay token de acceso, para destinos fuera del país de Mercado Envios y cuando la API no devuelve ninguna tarifa.

Country prices: precios en la moneda de tu tienda. Haz clic en + Add country para añadir una fila y en la cruz para eliminar una. Elige * All other countries para todos los países que no tengan fila propia. Price es el precio del país. Las columnas XS (hasta 1 kg), S (1-2 kg), M (2-3 kg), L (3-5 kg) y XL (más de 5 kg) lo sustituyen para ese peso del carrito. Una columna vacía o con 0 usa Price. Los valores que no sean números se notifican al guardar y se borran. Las filas sin ningún precio se eliminan al guardar.

Fallback cost: se usa cuando ni la API ni Country prices dan un precio. Déjalo vacío para ocultar el método en ese caso.

Calculation type: Per order cobra el precio una sola vez. Per item (each item priced by its own weight x quantity) busca en Country prices (o en el Fallback cost) según el peso de cada artículo y lo multiplica por su cantidad. Las tarifas en tiempo real de Mercado Envios siempre son para el paquete completo.

Disponibilidad

Min weight (kg): el peso mínimo del carrito para que aparezca este método. 0 significa sin límite.

Max weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 25. 0 significa sin límite.

Minimum subtotal: muestra el método solo cuando el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.

Excluded shipping classes: oculta el método cuando algún artículo del carrito pertenece a una de estas clases de envío de WooCommerce.

Ignore shipping zones: ofrece el método para los países indicados abajo, aunque no se haya añadido a una zona de envío.

Countries: los países de destino para ese modo. Déjalo vacío para todos los países. Este campo solo se usa cuando Ignore shipping zones está activado.

Envío gratis

Free shipping from: el subtotal del carrito a partir del cual este método es gratuito. En ese caso no se hace ninguna solicitud a Mercado Envios. Déjalo vacío para desactivarlo.

Avanzado

Debug log: registra las solicitudes a la API y el cálculo de tarifas en WooCommerce > Status > Logs (origen vfd-mercado-envios). Los errores siempre se registran, aunque esta opción esté desactivada. El token de acceso y las direcciones de los clientes nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran todos sus ajustes y los métodos de las zonas. Desactivar el plugin nunca borra los ajustes.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide una tarifa al plugin. Primero el plugin comprueba las condiciones: peso del carrito, subtotal mínimo y clases de envío excluidas. Si se aplica el envío gratis, el método cuesta 0 y no se envía ninguna solicitud a Mercado Envios.

Para un destino del país de Mercado Envios con un código postal válido, el plugin describe el carrito como un único paquete: la mayor anchura y longitud de los artículos, la suma de las alturas de todos los artículos y el peso total en gramos. Cada lado y el peso se elevan a los mínimos de Mercado Envios de ese país, de modo que los productos sin dimensiones o peso también reciben una tarifa. El valor del carrito se envía como precio del artículo en la moneda de Mercado Envios. La opción más barata que devuelve Mercado Envios se convierte a la moneda de tu tienda y se muestra con el nombre de tu método.

Cada cotización se guarda en caché durante 1 hora, así que el mismo carrito no genera una solicitud nueva. Una cotización fallida no se repite durante 5 minutos. Si no se puede contactar con Mercado Pago o rechaza el token, todas las cotizaciones en tiempo real se pausan durante 5 minutos, para que la finalización de compra no espere a la API en cada actualización. El tiempo de espera de la API es de 10 segundos.

Se usan los precios sin tarifas en tiempo real en su lugar cuando no hay token, el destino está fuera del país de Mercado Envios, el código postal falta o no es válido, falta el tipo de cambio, el paquete supera el límite de peso de Mercado Envios del país (25 kg en Argentina, 15 kg en Brasil, 30 kg en México), o Mercado Envios devuelve un error o ninguna opción para la dirección. Se usa la fila del país (o la fila *) y, si no existe, el coste alternativo. Si no hay ningún precio, el método se oculta. El cliente nunca ve un error de la API.

El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).

El plugin solo calcula tarifas. No crea envíos, no imprime etiquetas ni hace seguimiento de paquetes. Crea el envío en tu cuenta de Mercado Libre o de Mercado Pago. Muestra una tarifa por método, la opción más barata de Mercado Envios, no una elección entre todas las opciones, y no tiene selector de punto de recogida (agencia).

Pedidos

Cuando el pedido se realiza con una tarifa en tiempo real, el nombre del servicio y el tiempo estimado de entrega en días se guardan en la línea de envío del pedido como Mercado Envios service y Estimated delivery. Los pedidos existentes conservan sus líneas de envío.

Clave de licencia

El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Shipping > VibeFox Mercado Envios. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa, y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un solo dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Mercado Envios no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí lo ven, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio en la página Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados.

Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Mercado Envios no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado y que el método esté añadido a la zona del país del cliente (o que Ignore shipping zones esté activado y el país permitido). Revisa las advertencias de la parte superior de la página de ajustes, los límites de peso, Minimum subtotal y Excluded shipping classes. El método necesita un precio: un token de acceso válido para direcciones del país de Mercado Envios, o bien Country prices o Fallback cost.

Las tarifas en tiempo real no aparecen: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-mercado-envios. Motivos habituales: no hay token, un destino fuera del país de Mercado Envios, un código postal que falta o no es válido, falta el Exchange rate, un paquete que supera el límite de peso, o no hay opción de Mercado Envios para la dirección.

HTTP 401 o 403 en las advertencias: el token de acceso no es válido o ha caducado. Copia de nuevo el Access Token de producción desde el panel de desarrolladores de Mercado Pago.

Mercado Envios respondió en otra moneda: el país de la cuenta no coincide con Mercado Envios country. Elige el país de tu cuenta de Mercado Pago.

En qué moneda están los precios: Country prices y Fallback cost están en la moneda de tu tienda. Las tarifas en tiempo real llegan en la moneda de tu cuenta de Mercado Pago y se convierten con Exchange rate cuando la tienda usa otra moneda.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las tarifas en caché.

El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Desactivar el plugin conserva todos los ajustes. Solo se borra la caché de tarifas. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin, las tarifas en caché y el último error de la API siempre se eliminan. Los ajustes y los métodos de zona se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus líneas de envío.

Mercado Envios y Mercado Pago son marcas comerciales de sus respectivos titulares. Este plugin no está afiliado ni respaldado por Mercado Envios ni por Mercado Pago.