VibeFox 99Minutos for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 5.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Clave de API de 99minutos (solo para la comprobación de cobertura): solicítala a tu gestor de cuenta de 99minutos o en el portal para desarrolladores de 99minutos (developers.99minutos.com). Las claves de sandbox y de producción son distintas. Si solo usas la matriz de precios, no necesitas una clave de API.
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_99minutos a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox 99Minutos, 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. Rellena la Price matrix (al menos una fila, por ejemplo «* Default») y, opcionalmente, la clave de API y el modo de comprobación de cobertura (consulta la sección «Configuración»).
6. Añade VibeFox 99Minutos a una zona de envío en WooCommerce > Settings > Shipping > Shipping zones que cubra México, Colombia, Chile o Perú.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox 99Minutos. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene un solo campo:
Method title (zone): el nombre que ven los clientes en esta zona. Déjalo vacío para usar el Method title general.
Al guardar los ajustes, la página te avisa si la matriz de precios está vacía o si se elige un modo de comprobación de cobertura sin clave de API.
General
Enable/Disable: activa 99Minutos en todas las zonas de envío a la vez. El método también debe añadirse a una zona de envío que cubra México, Colombia, Chile o Perú. Por defecto: activado.
Method title: el nombre del método de envío que ve el cliente en la finalización de compra. Una zona puede sustituirlo. Por defecto: 99Minutos.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade.
API de 99minutos (comprobación de cobertura) (opcional)
La API se usa solo para comprobar si 99minutos entrega en el código postal del cliente. El precio siempre procede de la matriz.
Coverage check: si se comprueba el código postal y de qué forma.
Con la comprobación de cobertura, el método aparece solo después de que el cliente introduzca un código postal. Los resultados se guardan en caché: cubierto durante 6 horas, no cubierto durante 30 minutos, error de API durante 5 minutos. Solo se envía el código postal a 99minutos.
API key: tu clave de API de 99minutos, que se envía como token Bearer al endpoint de comprobación de cobertura de 99minutos. Es obligatoria cuando la comprobación de cobertura está activada. El campo aparece enmascarado.
Environment: Sandbox (test) (por defecto) o Production. Sandbox y producción usan claves de API distintas, así que elige el entorno que corresponda a tu clave.
Tarifas
Los precios están en la moneda de tu tienda y se usan tal como se introducen, sin conversión.
Price matrix: una tabla de países de destino y precios. Haz clic en + Add country para añadir una fila y en la cruz para eliminarla. Cada fila tiene un Country, un Base price y precios para los tamaños XS (hasta 1 kg), S (hasta 2 kg), M (hasta 3 kg), L (hasta 5 kg) y XL (más de 5 kg). Un precio de tamaño vacío o igual a 0 recurre al Base price. La fila * Default se aplica a los países sin fila propia. Se aceptan tanto el punto como la coma como separador decimal; los precios negativos se guardan como 0. Mientras la matriz no tenga al menos una fila, el método no se muestra en la finalización de compra.
Calculation: Per order — size by the total cart weight (por defecto) cobra un precio según el tamaño del paquete de todo el carrito. Per item — each unit priced by its own weight asigna a cada unidad el precio de su tamaño según su propio peso y suma los resultados.
Free shipping: activa el envío gratis a partir de un subtotal del carrito.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual la tarifa es 0. Solo se usa si Free shipping está activado.
Restricciones
Min weight (kg): oculta el método si el carrito pesa menos. 0 significa sin límite. Los pesos de los productos se convierten desde la unidad de peso de tu tienda.
Max weight (kg): oculta el método si el carrito pesa más. Por defecto: 25. 0 significa sin límite.
Minimum subtotal: muestra el método solo si el subtotal del carrito (después de descuentos, sin impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método si algún artículo del carrito tiene una de estas clases de envío de WooCommerce.
Restrict countries: ofrece el método solo para los países indicados abajo. Es un filtro adicional sobre las zonas de envío: el método sigue teniendo que añadirse a una zona. Útil cuando una zona cubre varios países.
Countries: selección de países de 99minutos (México, Colombia, Chile, Perú). Solo se usa si Restrict countries está activado. Déjalo vacío para permitir todos los países de 99minutos.
Avanzado
Debug log: registra los cálculos de tarifas en WooCommerce > Status > Logs (origen «vfd-99minutos»). Los errores de API se registran aunque esta opción esté desactivada. Las claves de API y los nombres y direcciones de los clientes nunca se registran.
Remove data on uninstall: si está activado, eliminar el plugin borra sus ajustes y la caché de cobertura. Desactivar no borra nada. Los métodos de envío de las zonas y los pedidos se conservan en cualquier caso.
Funcionamiento en la finalización de compra
El método solo se ofrece si el país de entrega es México, Colombia, Chile o Perú (y está en la lista Countries si Restrict countries está activado). Cuando el cliente introduce una dirección de entrega, el plugin comprueba los límites de peso del carrito, Minimum subtotal y Excluded shipping classes.
Si hay un modo de comprobación de cobertura activado, el plugin consulta después a la API de 99minutos si el código postal está cubierto. La petición tiene un tiempo de espera de 10 segundos y la respuesta se guarda en caché, por lo que el mismo código postal no genera una nueva petición. Los errores de API nunca se muestran al cliente: en modo Strict el método se oculta, en modo Soft se usa el precio de la matriz. El envío gratis no evita la comprobación de cobertura.
El precio se toma de la fila de la matriz del país de entrega o de la fila * Default. Si no existe ninguna de las dos, el método se oculta. Si Free shipping está activado y el subtotal del carrito alcanza Free shipping from, la tarifa es 0.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin no obtiene tarifas en tiempo real de 99minutos: los precios siempre proceden de tu matriz. No crea envíos ni pedidos en 99minutos, no imprime etiquetas (guides), no rastrea paquetes, no ofrece puntos de recogida Punto99 ni gestiona el pago contra reembolso. Crea los envíos en tu cuenta de 99minutos como de costumbre.
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 99Minutos. 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. Quitar la clave de un sitio no libera la plaza del dominio. Libérala desde tu cuenta de vibefox.net.
Sin una clave activa, 99Minutos 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
99Minutos 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 de la dirección del cliente. El país de entrega debe ser México, Colombia, Chile o Perú. Verifica que la Price matrix tenga una fila para ese país o una fila * Default, y revisa los límites de peso, Minimum subtotal, Excluded shipping classes y Restrict countries.
El método solo aparece después de introducir un código postal: es lo esperado con la comprobación de cobertura. En modo Strict solo aparece si la API confirma la cobertura.
El método siempre está oculto en modo Strict: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs (origen «vfd-99minutos»). Un error HTTP 401 o 403 significa que la clave de API fue rechazada: revisa la clave y que Environment coincida con ella (las claves de sandbox y de producción son distintas). Usa el modo Soft si los clientes deben seguir viendo el precio de la matriz mientras la API no esté disponible.
El precio no es el que esperabas: revisa Calculation (por pedido o por artículo), los pesos de los productos y la unidad de peso de tu tienda. Un precio de tamaño vacío o igual a 0 recurre al Base price.
Otros países: los desarrolladores pueden cambiar la lista de países admitidos con el filtro vfd_99m_supported_countries.
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 la dirección del sitio ha cambiado, 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 datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes y la caché de cobertura solo se eliminan si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los métodos de envío de las zonas y los pedidos existentes se mantienen.
99minutos es una marca comercial de su respectivo titular. Este plugin no está afiliado a 99minutos ni cuenta con su respaldo.