VibeFox ShipStation for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.

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 módulo usa la API V1 de ShipStation (API Key y API Secret). Las cuentas de la API V2 de ShipStation con una única 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 el back office, ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.

2. Cuando termine la subida, haz clic en Configure o busca más tarde VibeFox ShipStation en la lista de módulos y haz clic en Configure.

3. Pega tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).

4. Pega la API Key y el API Secret, introduce el código postal de origen y haz clic en Save. La página mostrará ahora los códigos de transportista de tu cuenta. Introduce el o los que quieras en Carrier codes y guarda de nuevo.

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

6. Opcionalmente, rellena los precios de reserva.

Al instalarse, el módulo crea el transportista ShipStation Shipping con el texto de tiempo de entrega ShipStation carriers (USPS, UPS, FedEx, ...). El transportista se asigna a todas las zonas y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el tiempo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No configures precios allí: el precio siempre procede del módulo.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox ShipStation > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado borra las tarifas de ShipStation en caché y comprueba la API Key y el API Secret. Después, la página muestra los transportistas conectados a tu cuenta con sus códigos, por ejemplo "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)".

Las advertencias de la parte superior de la página indican cuándo no pueden funcionar las tarifas en vivo: no hay claves, no hay código de transportista, no hay código postal de origen, falta el tipo de cambio, falla la comprobación de conexión o los códigos de transportista no están conectados a tu cuenta. También aparece una advertencia cuando la unidad de peso o de dimensiones de la tienda es una que el módulo no puede convertir. Configura kg, g, lb u oz y cm, mm, m o in en International > Localization (unidades locales). Un campo numérico con un valor negativo o con texto que no es un número, o un Minimum weight mayor que el Maximum weight, se notifica como error y no se guarda nada.

General

Enable ShipStation shipping: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.

Name: el nombre del transportista que ve el cliente en la finalización de compra. Predeterminado: ShipStation Shipping. Obligatorio, 64 caracteres como máximo.

Tax: la regla de impuesto del transportista, o No tax. Las tarifas de ShipStation no incluyen el impuesto de ventas. No tax las muestra tal como se cotizan; una regla de impuesto añade impuesto al envío según tus reglas fiscales.

Cuenta de ShipStation

API Key: la API Key de ShipStation > Settings > Account > API Settings. Se envía solo a ShipStation y nunca se registra. Tras guardar, el campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarla.

API Secret: el API Secret de la misma página. Se guarda igual que la clave.

Remove the saved API key and secret: aparece cuando hay claves guardadas. Márcalo y guarda para eliminar ambas.

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. Si introduces más, solo se conservan los 5 primeros y la página lo indica. 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" (predeterminado) tarifa tu propia caja y deja fuera los sobres y las cajas de tarifa plana del transportista. Déjalo vacío para tarifar todos los tipos de paquete que ofrece el transportista.

Origen del envío

Ship-from postal code: obligatorio para las tarifas en vivo. ShipStation calcula la tarifa solo a partir del código postal, que 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 Shop Parameters > Contact > Stores.

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. Predeterminado: USD (cuentas de EE. UU.).

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

Precios de reserva (se usan cuando no hay tarifa en vivo: sin API Keys, ShipStation no responde o no hay tarifas de transportista para la dirección; precios en la moneda predeterminada de tu tienda; deja vacíos la tabla y Other countries para ocultar el transportista 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 papelera para eliminarla. Una columna de tamaño vacía usa el precio base. Un precio base de 0 significa envío gratuito. La fila * Default (all other countries) se aplica a los países que no tienen fila propia. Una fila sin ningún precio no se guarda.

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

Condiciones

Free shipping from: el subtotal del carrito (después de descuentos y antes de impuestos) a partir del cual el envío es gratuito. En ese caso no se hace ninguna petición a ShipStation. Déjalo vacío para desactivarlo.

Minimum subtotal: muestra el transportista solo si el subtotal del carrito (después de descuentos y antes de impuestos) 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 el transportista. 0 significa sin límite.

Maximum weight: el transportista se oculta si el peso del carrito supera este valor, en la unidad de peso de tu tienda. 0 significa sin límite.

Disponibilidad sin zonas de envío

Normalmente, el transportista se ofrece en sus zonas de Shipping > Carriers. Como alternativa, puede ofrecerse por país.

Ignore shipping zones: ofrece el transportista para los países indicados abajo, tenga o no asignada su zona. Mientras esté activado, el transportista se añade a todas las zonas, también a las zonas creadas después. Al desactivarlo, se eliminan esas zonas añadidas.

Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países activos de la tienda. Este campo solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: registra las peticiones a ShipStation en logs/vfd_shst_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. 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 aparece enmascarado.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Remove data on uninstall: si está activado, al desinstalar el módulo se eliminan los ajustes, el transportista, el registro y el servicio de ShipStation guardado con los pedidos. Si está desactivado, todo se conserva para una nueva instalación.

Cómo funciona en la finalización de compra

En el paso de envío, PrestaShop pide al módulo el precio. Solo cuentan los productos físicos: los productos virtuales no añaden peso y no se incluyen en el subtotal. El módulo comprueba primero las condiciones: países permitidos (con Ignore shipping zones), peso del carrito y subtotal mínimo. Si se aplica el envío gratuito, el transportista se muestra con un precio de 0 y no se envía ninguna petición a ShipStation.

Después, el módulo envía a ShipStation el código postal de origen, el país de destino, la provincia, la ciudad y el código postal, el peso del paquete y el tamaño de la caja. No se hace ninguna petición antes de que el cliente introduzca un código postal. Los países sin códigos postales reciben los precios de reserva. Los artículos se apilan en una caja. Si un producto no tiene dimensiones, el paquete se tarifa solo por peso.

ShipStation se consulta una vez por cada código de transportista. El módulo usa la tarifa permitida más barata, convertida a la moneda predeterminada de tu tienda. Después, el precio se muestra en la moneda del carrito del cliente.

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 que indique ShipStation. El tiempo de espera de la petición es de 12 segundos. Al desactivar el módulo se borran las tarifas en caché.

Si no hay tarifa en vivo, el precio procede de la tabla de precios de reserva y, después, de Other countries. Si no se aplica ninguno, el transportista se oculta. El cliente nunca ve textos de error de ShipStation. Los detalles van al registro de depuración.

Si editas el transportista en Shipping > Carriers después de que tenga pedidos, PrestaShop lo guarda como una nueva versión del transportista. El módulo sigue esa nueva versión automáticamente.

El módulo solo calcula tarifas. No compra etiquetas, no crea pedidos ni envíos en ShipStation, no hace seguimiento de paquetes ni gestiona devoluciones. No hay puntos de recogida, ni elección entre varios servicios en la finalización de compra, ni validación de direcciones, seguro, confirmación de firma, empaquetado en varios paquetes ni recargo sobre las tarifas.

Pedidos

Cuando se realiza un pedido con una tarifa en vivo de ShipStation, el servicio elegido se guarda con el pedido. La página de pedido del back office lo muestra en un bloque de ShipStation como Service, por ejemplo "USPS Ground Advantage - Package", para que puedas crear la etiqueta correspondiente en ShipStation. Los recálculos posteriores del carrito no lo cambian. Los pedidos con precio de reserva o envío gratuito no tienen bloque de servicio.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox ShipStation es el primer bloque de Modules > Module Manager > VibeFox ShipStation > Configure, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-shipstation y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen el inglés y el ruso).

Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o tras liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede acceder al servidor de licencias, el módulo sigue funcionando con el último estado conocido.

Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, el transportista de ShipStation no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un aviso en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados.

Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días tras introducir la clave, y después una vez a la semana. No hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.

Solución de problemas

ShipStation no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable ShipStation shipping esté activado. En Shipping > Carriers, comprueba que el transportista cubre la zona del país del cliente y su grupo, o activa Ignore shipping zones y revisa Countries. Revisa los límites de peso y el Minimum subtotal. Sin tarifa en vivo, comprueba que el país, * Default u Other countries tenga un precio. Además, los productos pueden limitarse a determinados transportistas en la página del producto.

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 del módulo (claves, código de transportista, código postal de origen, tipo de cambio). Activa el Debug log, vuelve a cargar la finalización de compra y mira el campo Log. El código postal del cliente es obligatorio. No se hace ninguna petición antes de introducirlo.

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

La comprobación de conexión con ShipStation ha fallado: el mensaje indica el motivo. Revisa la API Key y el API Secret y vuelve a guardar para repetir la comprobación.

La tarifa no coincide con ShipStation: el paquete se construye a partir de los pesos y las dimensiones de los productos, con los artículos apilados en una caja. Los productos sin dimensiones se tarifan solo por peso. Las tarifas se guardan en caché durante 1 hora. Haz clic en Save en la página del módulo para borrar la caché.

La página indica que no se encontró el transportista de ShipStation: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox ShipStation y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. La caché de tarifas y el resultado de la comprobación de conexión siempre se eliminan. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial) y se eliminan los ajustes, el registro y el servicio guardado con los pedidos. Si está desactivado, el transportista solo se desactiva y se conservan los ajustes y el servicio de los pedidos realizados. Al volver a instalar el módulo, o con un Reset, el transportista recupera el estado que tenía antes.

ShipStation es una marca comercial de su titular. Este módulo no está afiliado a ShipStation ni cuenta con su respaldo.