VibeFox The Courier Guy 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.

Clave API de ShipLogic (para tarifas en tiempo real y lockers): The Courier Guy funciona sobre la plataforma ShipLogic. Crea una clave API en tu portal de courier de The Courier Guy, en Settings > API Keys (cuenta empresarial). Sin la clave solo se usa la tabla de precios y no se puede ofrecer el envío a locker.

Envío a Sudáfrica: las tarifas en tiempo real y los lockers son solo para direcciones sudafricanas. Tu tienda debe enviar a Sudáfrica (WooCommerce > Settings > General > Shipping location(s)).

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_the_courier_guy a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox The Courier Guy, 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 API key de ShipLogic. Para las tarifas en tiempo real completa la dirección del remitente (calle, ciudad, provincia y código postal) y, si la moneda de tu tienda no es ZAR, el ZAR conversion rate.

6. Rellena la tabla de precios y/o un coste alternativo.

7. Añade VibeFox The Courier Guy a una zona de envío de Sudáfrica en WooCommerce > Settings > Shipping > Shipping zones, elige el Delivery type (courier o TCG locker) y, si quieres, un título. Añádelo una segunda vez para el otro tipo de entrega.

Configuración

Los ajustes principales están en una sola página: WooCommerce > Settings > Shipping > VibeFox The Courier Guy. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene dos campos:

Title (zone): el nombre de esta tarifa en la finalización de compra, en esta zona. Déjalo vacío para usar el Method name global.

Delivery type (zone): Courier to the door (el predeterminado) o TCG locker (customer chooses a locker). Añade el método dos veces para ofrecer ambos. Los lockers requieren la clave API de ShipLogic y están disponibles solo en Sudáfrica.

Cada vez que guardas los ajustes se borran las tarifas y los lockers en caché. Las advertencias encima de los ajustes te avisan cuando la tienda no envía a Sudáfrica, falta la clave API, falta el tipo de cambio a ZAR o la dirección del remitente, no hay tabla de precios ni coste alternativo, o la última petición a ShipLogic falló (con su fecha y error).

General

Enable/Disable: desactiva el método en todas partes, incluidas las zonas de envío.

Method name: el nombre que se muestra en la finalización de compra. Para el envío a locker se añade "locker", por ejemplo "The Courier Guy locker". Una zona puede sustituirlo por su propio título. Predeterminado: The Courier Guy.

Tax status: Taxable: las tarifas en tiempo real se toman sin IVA y WooCommerce añade su propio impuesto. None: las tarifas en tiempo real se toman con IVA incluido.

API de ShipLogic (tarifas en tiempo real y lockers)

API key: tu clave API de ShipLogic del portal de The Courier Guy.

Account ID: opcional. El ID numérico de la cuenta de ShipLogic, solo si tu clave tiene acceso a varias cuentas.

Tarifas en tiempo real (para direcciones sudafricanas; si no hay tarifa en tiempo real, se usa la tabla de precios)

Price source: de dónde procede el precio.

ZAR conversion rate: ShipLogic cotiza en rands sudafricanos (ZAR). Si la moneda de tu tienda no es ZAR, indica cuánto vale 1 ZAR en la moneda de tu tienda, por ejemplo 0.05. Sin este valor no se usan las tarifas en tiempo real y se aplica la tabla de precios. Si la moneda de tu tienda es ZAR, déjalo vacío. El tipo de cambio no se actualiza automáticamente.

Dirección del remitente (para tarifas en tiempo real) (desde donde The Courier Guy recoge los paquetes, en Sudáfrica; para las tarifas en tiempo real se necesitan calle, ciudad, provincia y código postal)

Sender company: el nombre de tu empresa.

Sender street address: por ejemplo 12 My Road.

Sender suburb: el barrio de la dirección del remitente.

Sender city: la ciudad de la dirección del remitente.

Sender province: elige la provincia sudafricana de la lista.

Sender postal code: el código postal de la dirección del remitente.

Tabla de precios (tus propios precios en la moneda de la tienda: se usan con Price table only, fuera de Sudáfrica y siempre que no haya tarifa en tiempo real; se acepta una coma o un punto decimal)

Calculation type: se aplica solo a la tabla de precios. Una tarifa en tiempo real siempre es para el pedido completo.

Prices by weight: una tabla de países con una columna Price y los tramos de peso XS (hasta 1 kg), S (hasta 2 kg), M (hasta 3 kg), L (hasta 5 kg) y XL (más de 5 kg). Haz clic en + Add row para añadir una fila (una fila nueva empieza con Sudáfrica) y en la cruz para quitarla. Un tramo vacío o 0 usa la columna Price. Un precio de 0 significa envío gratis. La fila * Any country se aplica a los países sin fila propia y a una fila de país sin ningún precio.

Fallback cost: se usa cuando no hay ni tarifa en tiempo real ni precio en la tabla. Déjalo vacío para ocultar el método en ese caso.

Condiciones

Min weight (kg): oculta el método por debajo de este peso del carrito. 0 significa sin límite.

Max weight (kg): oculta el método por encima de este peso del carrito. Predeterminado: 30. 0 significa sin límite.

Minimum order amount: muestra el método solo a partir de este subtotal del carrito. Déjalo vacío para mostrarlo siempre.

Free shipping from: el subtotal del carrito a partir del cual este método es gratis. El envío gratis se ofrece solo cuando el método tiene precio para el destino: una tarifa en tiempo real, un precio de la tabla o el Fallback cost. Si la tabla o el Fallback cost tienen precio, no se envía ninguna petición a ShipLogic para la tarifa. Déjalo vacío para no ofrecer nunca envío gratis.

Excluded shipping classes: oculta el método si el carrito contiene productos de estas clases de envío de WooCommerce.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados abajo, incluso donde ninguna zona lo contenga.

Delivery type without zones: courier o TCG locker para ese modo. Se usa solo con Ignore shipping zones.

Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Los lockers se ofrecen solo en Sudáfrica.

Avanzado

Debug log: escribe mensajes de depuración en WooCommerce > Status > Logs, origen vfd-the-courier-guy. Los errores de la API siempre se registran, aunque esta opción esté desactivada. La clave API y los datos de los clientes nunca se registran.

Remove data on uninstall: si está activada, al eliminar el plugin se borran los ajustes y las tarifas por zona de este método. Desactivar el plugin nunca borra los ajustes. Los lockers y el seguimiento guardados en los pedidos se conservan.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de envío, WooCommerce pide una tarifa al plugin. El plugin comprueba primero las condiciones: peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si se aplica el envío gratis y el destino tiene precio, el método se muestra con un precio de 0.

Courier to the door: el plugin pide a ShipLogic el servicio más barato desde tu dirección de remitente hasta la del cliente. Antes deben estar completas la calle, la ciudad, la provincia y el código postal del cliente. Hasta entonces se muestra el precio de la tabla.

TCG locker: la tarifa en tiempo real es el servicio más barato de puerta a locker hasta el locker más cercano a la ciudad del cliente. No se recalcula para el locker que elige el cliente.

Todo el pedido se cotiza como un solo paquete: el peso total, la mayor longitud y anchura, y las alturas apiladas. Los productos sin dimensiones cuentan como cubos de 10 cm. El importe en rands se convierte a la moneda de tu tienda. El nivel de servicio, por ejemplo ECO, se guarda en la línea de envío.

Las peticiones a ShipLogic caducan a los 12 segundos. Las tarifas se guardan en caché 1 hora, los lockers 6 horas y los fallos 10 minutos, para que una API lenta no ralentice cada actualización de la finalización de compra. Si no hay tarifa en tiempo real, el precio sale de la tabla y, después, del Fallback cost. Si no se aplica ninguno, el método se oculta.

El método funciona en la finalización de compra clásica y en los bloques Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin no crea envíos, guías ni etiquetas, ni actualiza el seguimiento automáticamente. No hay mapa de lockers: se eligen de una lista. Las tarifas en tiempo real y los lockers son solo para Sudáfrica. Los demás países usan la tabla de precios. Se muestra una sola tarifa por instancia de zona (el nivel de servicio más barato), sin elección de niveles de servicio, seguro ni extras en la finalización de compra.

Puntos de recogida

Cuando el cliente elige una tarifa TCG locker en la finalización de compra clásica o de bloques, debajo aparece un selector de locker. Muestra los lockers que ShipLogic devuelve para la ciudad de la dirección de envío, primero el más cercano. El cliente puede escribir otra ciudad, barrio o código postal y hacer clic en Search. Hay que elegir un locker antes de poder hacer el pedido.

El servidor vuelve a comprobar el locker con la lista de ShipLogic. Su nombre y su proveedor se toman de ShipLogic, nunca del navegador. La elección se mantiene durante las actualizaciones de la finalización de compra y se restablece cuando cambia la dirección.

Si no se puede contactar con ShipLogic, el selector indica que los lockers no se pueden cargar y el pedido puede hacerse sin locker. Entonces el pedido se marca: "No elegido: ShipLogic no estaba disponible en la finalización de compra. Acuerda el locker con el cliente."

Pedidos

El locker elegido (nombre, ID y proveedor) se guarda en el pedido. Se muestra en la pantalla de pedidos del administrador, en las páginas "Gracias" y "Mi cuenta" y en los correos de pedido (HTML y texto sin formato). El correo del administrador también muestra el ID del locker.

En la pantalla de pedidos del administrador, los pedidos de este método tienen un campo The Courier Guy tracking reference. Introduce la referencia de tu portal de The Courier Guy y haz clic en Save. La referencia se muestra al cliente en la página del pedido y en los correos enviados después.

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 The Courier Guy. 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 quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un dominio. Quitar la clave de un sitio no libera su dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, The Courier Guy no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí la ven, marcada como (unlicensed — visible to admins only), para que puedan 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

El método The Courier Guy 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 límites de peso, el Minimum order amount y las Excluded shipping classes. Comprueba que la tabla o el Fallback cost tengan un precio. Las tarifas de locker aparecen solo para direcciones sudafricanas.

Los clientes no ven la lista de lockers: los lockers requieren la clave API, un método de zona con Delivery type "TCG locker" y una dirección de envío sudafricana. La página de ajustes muestra el último error de ShipLogic, si lo hay, por ejemplo una clave rechazada.

El precio es siempre el de la tabla: revisa las advertencias de la página de ajustes. Una tarifa en tiempo real necesita la clave API, la dirección completa del remitente y, en tiendas que no usan rands, el tipo de cambio a ZAR. Para el envío a domicilio deben estar completas la calle, la ciudad, la provincia y el código postal del cliente. Para los lockers, ShipLogic debe encontrar un locker cerca de la ciudad del cliente. Activa Debug log y abre WooCommerce > Status > Logs, origen vfd-the-courier-guy.

ShipLogic no funciona: se muestra el precio de la tabla o el alternativo. Los pedidos con locker pueden hacerse sin locker y se marcan en el pedido.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las tarifas y los lockers 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 los ajustes y solo borra las tarifas y los lockers en caché. 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 y los lockers en caché y el último error siempre se eliminan. Los ajustes y las tarifas por zona se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los lockers y las referencias de seguimiento guardados en los pedidos nunca se eliminan, y los pedidos existentes conservan sus líneas de envío.

The Courier Guy y ShipLogic son marcas comerciales de sus respectivos propietarios. Este plugin no está afiliado a The Courier Guy ni a ShipLogic ni cuenta con su respaldo.