VibeFox Shippo 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 Shippo: crea una cuenta de Shippo, conecta o activa las empresas de transporte (USPS, UPS, FedEx, DHL y otras) y copia el token de API desde Shippo > Settings > Advanced > API. Shippo cobra las etiquetas compradas, no las solicitudes de tarifas. Las cuentas nuevas de Shippo pueden necesitar verificación por parte de Shippo antes de que se devuelvan tarifas en tiempo real. Sin token, solo se usan los precios de respaldo.

Productos: los productos deben tener peso y dimensiones. Los productos sin dimensiones usan el tamaño de caja predeterminado.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Shippo, 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. Pega tu token de API de Shippo y completa la dirección de Ship from. El código postal es obligatorio.

6. Elige la Shippo rate currency (USD si envías desde EE. UU.) y, si tu tienda usa otra moneda, introduce el tipo de cambio.

7. Opcionalmente, introduce precios de respaldo en la tabla de países y pesos.

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

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Shippo. 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:

Title (zone): el nombre que ven los clientes para esta zona. Déjalo vacío para usar el Name global.

Cada vez que guardas los ajustes, se borran las tarifas de Shippo en caché. Las advertencias sobre los ajustes te avisan cuando el método nunca se puede mostrar o cuando no se pueden usar tarifas en tiempo real: sin token de API, sin código postal o país de origen, o sin tipo de cambio. Un aviso te recuerda cuando hay configurado un token de prueba.

General

Enable/Disable: activa o desactiva el método en todas las zonas a la vez.

Name: el nombre del método de envío que se muestra en la finalización de compra. Una zona puede sustituirlo por su propio Title. Predeterminado: Shippo Shipping.

Cuenta de Shippo

API token: tu token de API de Shippo. Usa el token en vivo (shippo_live_...) para tarifas reales en la tienda en producción, o un token de prueba (shippo_test_...) para las tarifas de prueba de Shippo.

Allowed carriers / services: opcional, separado por comas. Introduce una empresa como la nombra Shippo (USPS, UPS, FedEx, DHL Express) o un token de nivel de servicio de Shippo (usps_priority, ups_ground). Se muestra la tarifa permitida más barata. Déjalo vacío para mostrar la tarifa más barata de cualquier empresa.

Ship from (la dirección desde la que se envían los paquetes; los campos vacíos se toman de la dirección de la tienda en WooCommerce > Settings > General cuando está en el mismo país)

Sender name / company: el nombre del remitente. También se usa para firmar la declaración aduanera.

Street address: la calle del remitente.

City: la ciudad del remitente.

State / province: el código de estado de dos letras, por ejemplo CA o NY. Algunas empresas lo necesitan.

Postal / ZIP code: obligatorio para tarifas en tiempo real.

Country: el país desde el que envías. Predeterminado: United States.

Tarifas

Parcels: cómo se envía el carrito a Shippo.

Default box size: largo x ancho x alto en la unidad de dimensiones de tu tienda, por ejemplo 30 x 20 x 10. Shippo necesita el tamaño de la caja. Se usa cuando un producto del carrito no tiene dimensiones. Déjalo vacío para usar 30 x 20 x 10 cm.

Shippo rate currency: la moneda en la que Shippo cotiza a tus empresas de transporte, que es la moneda del país de origen: USD (EE. UU.), CAD (Canadá), GBP (Reino Unido), EUR (eurozona) o AUD (Australia). Predeterminado: USD. Las tarifas que Shippo devuelve en la moneda de la tienda siempre se usan tal cual.

Exchange rate: el precio de 1 unidad de la Shippo rate currency en la moneda de tu tienda, por ejemplo 0.92. No hace falta si ambas son iguales. Sin él, las tarifas en la otra moneda no se usan y se aplican los precios de respaldo. El plugin no convierte monedas automáticamente.

Tax status: Taxable permite que WooCommerce añada impuestos al envío según tus reglas fiscales; None no lo hace. Las tarifas de Shippo no incluyen impuestos sobre ventas.

Precios de respaldo (se usan cuando no hay tarifa en tiempo real: sin token de API, Shippo no responde, el token es rechazado o no hay tarifas de transportistas para la dirección; precios en la moneda de tu tienda; deja ambos campos vacíos para ocultar el método en ese caso)

Country prices: una tabla de precios por país y peso del carrito. Haz clic en + Add country para añadir una fila y en la cruz para eliminar una. Las columnas son Price y los niveles 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). Un nivel vacío o 0 usa la columna Price. La fila * Default se aplica a los países sin fila propia. Una fila nueva empieza como * Default. Una fila que se guarda con todas las celdas vacías cobra 0, así que elimina las filas que no vayas a rellenar.

Other countries: el precio para los países que no están en la tabla de arriba (cuando no hay una fila * Default). Déjalo vacío para ocultar el método en ellos.

Condiciones

Free shipping from: el subtotal del carrito a partir del cual el envío es gratis. En ese caso no se hace ninguna solicitud a Shippo. Déjalo vacío para desactivarlo.

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

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

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

Disabled shipping classes: oculta el método si el carrito contiene un producto de una 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, esté o no añadido a una zona.

Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que la tienda envía. Este campo se usa solo cuando Ignore shipping zones está activado. Un método añadido a una zona de envío funciona siempre para los países de su zona.

Avanzado

Debug log: registra las solicitudes a Shippo en WooCommerce > Status > Logs, origen vfd-shippo. Los errores de la API siempre se registran, incluso con esta opción desactivada. El token de API y las direcciones de los clientes nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y sus métodos de zona de envío. 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 al plugin una tarifa. Primero el plugin comprueba las condiciones: peso del carrito, subtotal mínimo y clases de envío desactivadas. Si se aplica el envío gratis, el método se muestra con un precio de 0 y no se envía ninguna solicitud a Shippo.

Después el plugin envía a Shippo la dirección de origen, la dirección del cliente y el paquete. En los países donde WooCommerce exige código postal, la solicitud espera hasta que el cliente lo introduzca. Para envíos internacionales se añade una declaración aduanera con los nombres, cantidades, pesos y valores de los artículos. Shippo devuelve las tarifas de tus empresas de transporte, y el plugin muestra la tarifa permitida más barata en la moneda de tu tienda bajo el nombre del método.

En el modo por pedido, los artículos se apilan en una caja: los lados más largo y medio de los artículos más grandes, y los lados más cortos de todas las unidades sumados. Si algún producto no tiene dimensiones, se usa el tamaño de caja predeterminado para todo el paquete. En el modo por artículo, cada producto se tarifica como su propio paquete y la tarifa se multiplica por su cantidad.

Cada respuesta se guarda en caché durante 1 hora por dirección y paquete. Cuando Shippo responde sin una tarifa utilizable, la dirección se recuerda durante 10 minutos. Tras un tiempo de espera, un token rechazado, un error del servidor o un límite de solicitudes, el plugin pausa las solicitudes durante 5 minutos y usa los precios de respaldo. El tiempo de espera de la solicitud es de 10 segundos.

Si no hay tarifa en tiempo real, el precio sale de la tabla de respaldo y después de Other countries. Si ninguno se aplica, el método se oculta. El cliente nunca ve un error.

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 solo calcula tarifas. No compra etiquetas, no hace seguimiento de paquetes, no valida direcciones, no ofrece puntos de recogida o entrega, seguro, opciones de firma ni etiquetas de devolución. Solo se muestra la tarifa permitida más barata, no una lista de todos los servicios. No hay empaquetado de cajas más allá del apilado descrito arriba, ni recargo sobre la tarifa ni cargo por gestión.

Pedidos

La línea de envío del pedido guarda la Carrier / service elegida y, para un paquete por pedido, los Estimated delivery days. Los ves en la pantalla de administración del pedido y puedes comprar la etiqueta correspondiente en Shippo.

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 Shippo. 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 comprobar el estado de nuevo, 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 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, Shippo no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión siguen viéndolo, 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 una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Shippo 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 está permitido). Revisa los límites de peso, Minimum subtotal y Disabled shipping classes. Sin tarifa en tiempo real, comprueba que el país, * Default o Other countries tiene un precio.

Las tarifas en tiempo real no aparecen: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-shippo. Motivos habituales: falta el token de API o el código postal de origen, la moneda de la tienda es distinta de la Shippo rate currency sin tipo de cambio, el cliente aún no ha introducido su código postal, ninguna empresa de tu cuenta de Shippo llega a la dirección o la cuenta de Shippo aún no está verificada.

Probar tarifas en la tienda en producción: un token de prueba (shippo_test_...) devuelve tarifas de prueba de Shippo. Usa el token en vivo (shippo_live_...).

Envío gratis para países inesperados: revisa la tabla de precios en busca de una fila vacía, sobre todo una fila * Default vacía. Una fila con todas las celdas vacías cobra 0.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las tarifas de Shippo en caché.

Para desarrolladores: los filtros vfd_shpo_shipment_request, vfd_shpo_customs_declaration, vfd_shpo_selected_rate y vfd_shpo_api_url modifican el cuerpo de la solicitud, la declaración aduanera, la tarifa elegida y la URL de la API.

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 acceder al 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 y las tarifas en caché 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.

Shippo es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Shippo ni respaldado por Shippo.