VibeFox Estafeta 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 DrEnvio (solo para tarifas en tiempo real): las tarifas en tiempo real de Estafeta proceden de DrEnvio, socio de Estafeta en México. Crea una cuenta en drenvio.com, activa Estafeta, configura allí tu dirección de recogida y copia la clave de API desde el panel de DrEnvio. Es la misma clave que usa el plugin oficial de DrEnvio. Si solo usas tus propios precios, no necesitas una cuenta de DrEnvio.

Productos: los productos necesitan un peso para las tarifas en tiempo real.

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_estafeta a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Estafeta, o haz clic en Settings debajo del nombre del plugin en la página de 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. Introduce la clave de API de DrEnvio y, opcionalmente, el código postal de origen. Si la moneda de tu tienda no es MXN, introduce el MXN exchange rate. Define un precio por país para MX o un coste de reserva si el método debe seguir visible cuando DrEnvio no tenga tarifa.

6. Añade VibeFox Estafeta a tu zona de México 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 Estafeta. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene solo un campo:

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

En la parte superior de la página el plugin muestra avisos: falta la clave de API de DrEnvio, la moneda de la tienda no es MXN y no hay tipo de cambio, o no hay precio por país para MX ni coste de reserva (en ese caso el método se oculta si no hay tarifa en tiempo real). Cada vez que guardas los ajustes se borran las tarifas de DrEnvio en caché. Los campos numéricos aceptan punto o coma como separador decimal. Un valor que no es un número válido se borra y se notifica al guardar.

General

Enable/Disable: activa o desactiva el envío de Estafeta en todas las zonas a la vez. Por defecto: activado.

Name: el nombre del método de envío que ve el cliente en la finalización de compra. Por defecto: Estafeta.

Tax status: Taxable permite que WooCommerce añada impuestos sobre el coste de envío; None no lo hace. Que los precios de DrEnvio incluyan IVA depende de tu cuenta de DrEnvio. Si ya incluyen IVA, elige None. Por defecto: Taxable.

Tarifas en tiempo real (API de DrEnvio)

Se ofrece el servicio de Estafeta más barato para la dirección. Sin clave se usan los precios de la siguiente sección.

DrEnvio API key: la clave de API de tu panel de DrEnvio.

Origin country: el código de país de dos letras de la dirección de recogida. Por defecto: MX. Se envía solo junto con el código postal de origen.

Origin postcode: el código postal de 5 dígitos de la dirección de recogida. Déjalo vacío para usar la dirección de origen guardada en tu cuenta de DrEnvio. Un código postal que no tenga 5 dígitos se borra al guardar.

MXN exchange rate: DrEnvio cotiza en pesos mexicanos. Solo hace falta si la moneda de tu tienda no es MXN: el valor de 1 MXN en la moneda de tu tienda, por ejemplo 0.05. Sin él no se usan tarifas en tiempo real.

Precios sin tarifa en tiempo real

Se usan cuando no hay clave de API o DrEnvio no devuelve ninguna tarifa de Estafeta (API caída, código postal desconocido, todavía no se ha introducido ningún código postal). Los precios están en la moneda de tu tienda.

Country prices: un país de destino por línea, en el formato CC:PRICE, por ejemplo MX:150. Usa punto o coma decimal, sin separador de miles. Las partes con otro formato se ignoran y se notifican al guardar.

Fallback cost: el precio cuando no hay tarifa en tiempo real ni precio por país. Déjalo vacío para ocultar el método; 0 significa envío gratis.

Calculation type: Per order cobra el precio una sola vez. Per item (price x number of items) lo multiplica por el número de artículos enviables. Se aplica a Country prices y a Fallback cost. Una tarifa en tiempo real de DrEnvio siempre es el precio de todo el paquete.

Condiciones

Free shipping from: el envío es gratis cuando el subtotal del carrito alcanza este importe. En ese caso no se hace ninguna petición a DrEnvio. Déjalo vacío para no ofrecer nunca envío gratis.

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

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

Max weight (kg): el peso máximo del carrito. El método se oculta si se supera. Por defecto: 30. 0 significa sin límite.

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

Los pesos de los productos se convierten de la unidad de tu tienda a kg.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados abajo, incluso sin añadirlo a una zona de envío.

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

Avanzado

Debug log: registra las peticiones a la API y el cálculo de tarifas en WooCommerce > Status > Logs, origen vfd-estafeta. Los errores de la API siempre se registran. La clave de API y las direcciones de los clientes nunca se registran.

Remove data on uninstall: si está activado, al borrar el plugin se eliminan todos sus ajustes y los métodos de zona. Desactivar el plugin nunca borra nada.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. Primero el plugin comprueba el peso del carrito, el subtotal mínimo y las clases de envío excluidas. Si se aplica el envío gratis, el método se muestra con precio cero y no se envía ninguna petición a DrEnvio.

Si no, el plugin envía a DrEnvio el país y el código postal de destino, el peso del carrito, el número de artículos y el subtotal, además del código postal de origen si lo has configurado. Los códigos postales mexicanos deben tener 5 dígitos; hasta que el cliente introduzca uno, no se hace ninguna petición. DrEnvio devuelve cotizaciones de todas las empresas de transporte de tu cuenta. El plugin usa solo las cotizaciones de Estafeta, ignora los precios cero, elige la más barata y la convierte a la moneda de tu tienda. El servicio de Estafeta y el plazo de entrega se guardan con la línea de envío del pedido y se muestran en la pantalla de pedidos del administrador.

Cada respuesta se guarda en caché durante 1 hora. Una petición fallida o una ruta sin tarifa de Estafeta se recuerda durante 5 minutos, para que una API lenta o averiada nunca bloquee cada actualización de la finalización de compra. El tiempo de espera de la API es de 12 segundos. En estos casos el cliente no ve ningún error: se usa el precio por país o el coste de reserva, o el método se oculta si no hay ninguno de los dos.

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 (guías) ni rastrea paquetes; el envío se crea en tu cuenta de DrEnvio o de Estafeta. El cliente no puede elegir un servicio concreto de Estafeta ni una oficina de Estafeta, y los tipos de cambio no se actualizan automáticamente.

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 Estafeta. 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. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Estafeta 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 de 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 una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Estafeta 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 los avisos en la parte superior de la página de ajustes, los límites de peso, Minimum subtotal y Excluded shipping classes. Sin clave de API, o cuando DrEnvio no tiene tarifa de Estafeta, el método necesita un precio por país para el destino o un coste de reserva.

Las tarifas en tiempo real no aparecen: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-estafeta. Ahí se indica el motivo: no hay clave de API, no hay tipo de cambio para una tienda que no usa MXN, falta el código postal o no es válido, la clave de API está rechazada (HTTP 401 o 403), o no hay tarifa de Estafeta para la ruta.

¿El precio incluye IVA? Depende de tu cuenta de DrEnvio. Si los precios de DrEnvio ya incluyen IVA, pon Tax status en None.

Las tarifas parecen desactualizadas después de un cambio: guarda la página de ajustes. Así se borran las tarifas de DrEnvio 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 para 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 y solo 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 los archivos de registro antiguos 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 nunca se tocan, y los pedidos existentes conservan sus líneas de envío.

Estafeta y DrEnvio son marcas comerciales de sus respectivos propietarios. Este plugin no está afiliado ni respaldado por Estafeta ni por DrEnvio.