VibeFox ShipStation 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 ShipStation: conecta tus transportistas en ShipStation (Settings > Shipping > Carriers) y después copia la API Key y el API Secret desde ShipStation > Settings > Account > API Settings. El acceso a la API depende de tu plan de ShipStation. Si la página no está disponible, tu plan no incluye acceso a la API. El plugin usa la API V1 de ShipStation (API Key y API Secret). Las cuentas de la API V2 de ShipStation con una sola clave de API no son compatibles. Sin claves, solo se usan los precios de reserva.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox ShipStation, 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. Pega la API Key y el API Secret, introduce el código postal de origen del envío y guarda. La página mostrará ahora los códigos de transportista de tu cuenta. Introduce el o los que quieras en Carrier codes y vuelve a guardar.

6. Si la moneda de tu tienda no es la moneda de tu cuenta de ShipStation, configura Exchange rate.

7. Opcionalmente, rellena los precios de reserva.

8. Añade VibeFox ShipStation 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 ShipStation. 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 el cliente ve en esta zona. Déjalo vacío para usar el nombre general Name.

Cada vez que guardas la configuración, se borran las tarifas de ShipStation en caché y se comprueban la API Key y el API Secret. La página muestra entonces los transportistas conectados a tu cuenta con sus códigos, por ejemplo "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)". Las advertencias sobre la configuración te indican cuándo no pueden funcionar las tarifas en tiempo real: falta una clave, falta el código de transportista, falta el código postal de origen, falta el tipo de cambio, falla la comprobación de la conexión o los códigos de transportista no están conectados a tu cuenta.

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 con su propio Title. Valor predeterminado: ShipStation Shipping.

Cuenta de ShipStation

API Key: la API Key de ShipStation > Settings > Account > API Settings.

API Secret: el API Secret de la misma página.

Carrier codes: uno o más códigos de transportista de ShipStation, separados por comas, por ejemplo stamps_com, ups_walleted. Se usan hasta 5 códigos, con una petición a la API por transportista. Se muestra la tarifa más barata de estos transportistas. Toma los códigos de la lista que aparece tras guardar.

Allowed services: opcional, códigos de servicio de ShipStation separados por comas, por ejemplo usps_priority_mail, ups_ground. Déjalo vacío para mostrar el servicio más barato de los transportistas indicados arriba.

Package code: "package" (el predeterminado) calcula la tarifa para tu propia caja y excluye los sobres del transportista y las cajas de tarifa plana. Déjalo vacío para calcular la tarifa de todos los tipos de paquete que ofrece el transportista.

Origen del envío

Ship-from postal code: obligatorio para las tarifas en tiempo real. ShipStation calcula la tarifa solo a partir del código postal y debe estar en el país de tu cuenta de ShipStation. Déjalo vacío para usar el código postal de la tienda de WooCommerce > Settings > General.

Tarifas

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

ShipStation account currency: la moneda en la que ShipStation devuelve las tarifas: USD, CAD, GBP, AUD, NZD o EUR. Valor predeterminado: USD (cuentas de EE. UU.).

Exchange rate: el precio de 1 unidad de la moneda de la cuenta en la moneda de tu tienda, por ejemplo 0.92. Solo es necesario cuando la moneda de la tienda es distinta de la de la cuenta. Sin él, no se usan las tarifas en tiempo real y se aplican los precios de reserva. Los tipos de cambio no se actualizan automáticamente.

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

Precios de reserva (se usan cuando no hay tarifa en tiempo real: sin API Key, ShipStation no está disponible o ningún transportista da tarifas para la dirección; precios en la moneda de tu tienda; deja vacíos la tabla y Other countries para ocultar el método en ese caso)

Prices by country: una tabla con un precio base por país y columnas de tamaño según el peso del paquete: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg y XL >5 kg. Haz clic en + Add country para añadir una fila y en el icono de cruz para quitar una. Un tamaño vacío usa el precio base. Un precio base de 0 significa envío gratis. La fila * Default (all other countries) se aplica a los países que no tienen fila propia.

Other countries: el precio cuando la tabla no tiene precio para el país. Déjalo vacío para ocultar el método en ese caso.

Condiciones

Free shipping from: el subtotal del carrito a partir del cual el envío es gratis. En ese caso no se hace ninguna petición a ShipStation. 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: el peso mínimo del carrito, en la unidad de peso de tu tienda, para mostrar este método. 0 significa sin límite.

Maximum weight: el método se oculta por encima de este peso del carrito, en la unidad de peso de tu tienda. 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 solo se usa 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 peticiones a ShipStation en WooCommerce > Status > Logs, origen vfd-shipstation. Los errores de la API siempre se registran, aunque esta opción esté desactivada. La API Key, el API Secret y las direcciones de los clientes nunca se registran. El código postal se enmascara.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y sus métodos de las zonas 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 precio 0 y no se envía ninguna petición a ShipStation.

Después, el plugin envía a ShipStation el código postal de origen, el país, el estado o provincia, la ciudad y el código postal de destino, el peso del paquete y el tamaño de la caja. No se hace ninguna petición hasta que el cliente introduce un código postal. Los países sin códigos postales reciben los precios de reserva. Los pesos y las dimensiones se convierten desde las unidades de tu tienda. Los artículos se apilan en una caja. Si un producto no tiene dimensiones, el paquete se calcula solo por peso.

ShipStation recibe una petición por cada código de transportista. El plugin muestra la tarifa permitida más barata, convertida a la moneda de tu tienda, debajo del nombre del método.

Cada respuesta se guarda en caché durante 1 hora. Cuando ShipStation responde sin una tarifa utilizable, la respuesta se recuerda durante 10 minutos. Cuando ShipStation rechaza las claves o no está disponible, las peticiones se pausan durante 5 minutos. Tras un límite de peticiones, la pausa sigue la hora de reinicio indicada por ShipStation. El tiempo de espera de cada petición es de 12 segundos. Desactivar el plugin borra las tarifas en caché.

Si no hay tarifa en tiempo real, el precio sale de la tabla de precios de reserva y, después, de Other countries. Si ninguna de las dos aplica, el método se oculta. El cliente nunca ve los textos de error de ShipStation. Los detalles van al registro de WooCommerce.

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 compra etiquetas, no crea pedidos ni envíos en ShipStation, no hace seguimiento de paquetes y no gestiona devoluciones. No hay puntos de recogida, ni elección entre varios servicios en la finalización de compra, ni validación de direcciones, ni seguro, ni confirmación de firma, ni empaquetado en varios paquetes, ni recargo sobre las tarifas.

Pedidos

La línea de envío del pedido guarda el Service elegido, por ejemplo "USPS Ground Advantage - Package". Lo ves en la pantalla de pedidos del administrador y puedes crear la etiqueta correspondiente en ShipStation.

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 ShipStation. 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 solo dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

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

Solución de problemas

ShipStation 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 tienen un precio.

La finalización de compra muestra el precio de reserva en lugar de la tarifa de ShipStation: revisa las advertencias de la parte superior de la página de configuración (claves, código de transportista, código postal de origen, tipo de cambio). Activa Debug log y abre WooCommerce > Status > Logs, origen vfd-shipstation. Es necesario el código postal del cliente. No se hace ninguna petición hasta que se introduce.

Qué código de transportista introducir: guarda la configuración con la API Key y el API Secret. La página muestra los códigos de transportista de tu cuenta. Usa uno o varios de ellos.

La tarifa no coincide con la de ShipStation: el paquete se calcula a partir de los pesos y las dimensiones de los productos, con los artículos apilados en una caja. Los productos sin dimensiones se calculan solo por peso. Las tarifas se guardan en caché durante 1 hora. Guarda la configuración para borrar la caché.

Para desarrolladores: los filtros vfd_shst_rate_request, vfd_shst_selected_rate y vfd_shst_api_url cambian la petición de tarifa por transportista, la tarifa elegida y la URL base 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 los ajustes y solo borra las tarifas 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 en caché y la lista de transportistas guardada siempre se eliminan. Los ajustes y los métodos de zona solo se eliminan 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.

ShipStation es una marca comercial de su respectivo titular. Este plugin no está afiliado a ShipStation ni cuenta con su respaldo.