VibeFox Cargoson for WooCommerce — Ayuda

Requisitos

WordPress: 5.8 o posterior.

WooCommerce: 5.0 o posterior, instalado y activo. El plugin no se activa sin él.

PHP: 8.0 o posterior.

Cuenta de Cargoson (solo para precios en tiempo real): los precios en tiempo real usan la API de precios de transporte de Cargoson. Las consultas de precios de transporte requieren una suscripción a Cargoson con acceso a la API (plan Advanced o superior en el momento de redactar esto). La clave de API se emite en tu cuenta de Cargoson; si tu plan no muestra la configuración de la API, pide ayuda al soporte de Cargoson. Los precios proceden de los transportistas y las tarifas conectados a esa cuenta. Si solo usas precios fijos, no necesitas una cuenta de Cargoson.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Cargoson, 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. Elige cómo se calcula el coste del envío y rellena las secciones correspondientes: los precios fijos y, para los precios en tiempo real, la clave de API y el código postal de recogida (véase Configuración).

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

Title (zone): el nombre que ve el cliente en esta zona. Déjalo vacío para usar el Method title general.

Cada vez que guardas los ajustes, se borran los precios de Cargoson guardados en caché. Los números decimales se pueden escribir con punto o con coma.

General

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

Method title: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Predeterminado: Cargoson. Una zona puede sustituirlo.

Shipping cost: cómo se calcula el precio.

El motivo de la falta de un precio en tiempo real se escribe en el registro de WooCommerce. Nunca se muestra al cliente.

Cargoson API (obligatoria solo para los precios en tiempo real)

API key: la clave de API de tu cuenta de Cargoson. Solo se envía a cargoson.com y nunca se muestra a los clientes ni se escribe en el registro.

Carrier: qué precios se usan. El cliente ve una sola tarifa.

Package type code: el código de tipo de paquete de Cargoson que se envía con la consulta de precio. Predeterminado: CLL. Los ejemplos de la API de Cargoson usan EUR (palé EUR) y FIN (palé FIN). Para paquetes, usa el código de paquete de tu cuenta de Cargoson. El pedido se envía como un solo paquete con el peso total del carrito.

Price currency: la moneda de los precios de tu cuenta de Cargoson, como código de 3 letras. Predeterminado: EUR. La API devuelve importes sin código de moneda.

Currency conversion rate: solo es necesario si la moneda de los precios es distinta de la moneda de tu tienda: 1 unidad de la moneda de Cargoson = X unidades de la moneda de tu tienda. Déjalo vacío para rechazar esos precios, de modo que el cliente nunca pague en una moneda incorrecta.

Ship from (collection address) (se usa para los precios en tiempo real)

Collection country: el país desde el que envías. Por defecto, el país de tu tienda.

Collection postcode: el código postal desde el que envías. Cargoson lo exige. Si está vacío y el país de recogida es el país de tu tienda, se usa el código postal de la tienda de WooCommerce > Settings > General.

La fecha de recogida que se envía a Cargoson es hoy, o el lunes siguiente si es fin de semana.

Fixed prices (se usan cuando Shipping cost es Fixed prices, y como alternativa para los precios en tiempo real)

Price per country and size: una tabla de países con una columna Price y precios por peso del carrito en la moneda de tu tienda: XS hasta 1 kg, S hasta 2 kg, M hasta 3 kg, L hasta 5 kg, XL por encima de 5 kg. Un precio de tamaño vacío o 0 usa la columna Price; una columna Price vacía significa que no hay tarifa fija para ese tamaño. Haz clic en Add country para añadir una fila y en la cruz para eliminar una. La fila * Default se aplica a todos los países que no tengan fila propia. Los países sin fila (cuando no hay fila *) no tienen tarifa fija, así que el método se oculta para ellos.

Fixed price applies: Per order cobra el precio una sola vez. Per item (price × quantity) lo multiplica por el número de artículos del carrito. Los precios en tiempo real de Cargoson son siempre por envío.

Conditions

Minimum weight (kg): oculta el método si el peso del carrito es inferior a este valor. 0 significa sin límite.

Maximum weight (kg): oculta el método si el peso del carrito supera este valor. Predeterminado: 25. 0 significa sin límite.

Minimum order amount: muestra el método solo cuando el subtotal del carrito (después de descuentos, antes de impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.

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

Free shipping: activa el envío gratuito cuando se alcanza el importe del pedido indicado a continuación.

Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío es gratuito. Solo se usa cuando Free shipping está activado.

Tax status: Taxable añade el impuesto del envío según tus ajustes de impuestos de WooCommerce; None no lo añade. Las tarifas de los transportistas en Cargoson suelen ser netas (sin IVA). Elige None si tus precios ya incluyen impuestos.

Availability without shipping zones

Ignore shipping zones: ofrece Cargoson para los países indicados abajo aunque no esté añadido a una zona de envío.

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

Advanced

Debug log: registra cada cálculo de tarifa en WooCommerce > Status > Logs, origen vfd_cargoson. Los errores de la API siempre se registran, aunque esta opción esté desactivada. La clave de API y el código postal del cliente nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de Cargoson, los métodos de zona y los precios en caché. 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 las condiciones: país de entrega, peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si se aplica el envío gratuito, el cliente obtiene una tarifa gratuita y no se envía ninguna solicitud a Cargoson.

En el modo de precios fijos, el precio se toma de la tabla. En los modos en tiempo real, el plugin envía a Cargoson la fecha de recogida, el país y el código postal de recogida, el país y el código postal de entrega, y un paquete con el código de tipo de paquete y el peso total del carrito (al menos 0,1 kg). Los pesos de los productos se convierten de la unidad de tu tienda a kilogramos. El precio en tiempo real se solicita solo después de que el cliente haya introducido un código postal. Cargoson devuelve los precios de tus transportistas; el plugin elige el más barato (del transportista seleccionado, si lo hay) y, si hace falta, lo convierte a la moneda de tu tienda.

Cada respuesta se guarda en caché durante 1 hora, de modo que el mismo carrito no genera una nueva solicitud. Una solicitud fallida se guarda en caché durante 10 minutos, para que la finalización de compra no espere a Cargoson en cada actualización. El tiempo de espera de la API es de 10 segundos. Si Cargoson devuelve un error, ningún precio para la ruta o un precio en otra moneda sin tipo de conversión, el cliente no ve ningún error. El método se oculta, o se usa el precio fijo en el modo alternativo.

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 crea envíos ni reservas en Cargoson, no imprime etiquetas ni hace seguimiento de paquetes, y los clientes no pueden elegir una taquilla de paquetes ni un punto de recogida. El carrito se cotiza como un solo paquete con el peso total; las dimensiones del paquete no se envían. Solo se muestra el precio más bajo, no una lista de transportistas.

Pedidos

Cuando se usa un precio en tiempo real, la línea de envío del pedido guarda el Carrier, el Service y el Cargoson service ID presupuestados. Se muestran en la pantalla de edición del pedido, para que sepas qué reservar en Cargoson. Reserva el envío en Cargoson o con sus propias integraciones.

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 Cargoson. 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, Cargoson no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con la sesión iniciada 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 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 renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Cargoson 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 order amount y Excluded shipping classes. En el modo de precios fijos, comprueba que el país o * Default tiene un precio para el tamaño del carrito.

Los precios en tiempo real no aparecen: abre WooCommerce > Status > Logs, origen vfd_cargoson. Los errores de la API siempre se registran; activa Debug log para ver cada cálculo. Motivos habituales: aún no se ha introducido el código postal de entrega, falta el código postal de recogida, la clave de API ha sido rechazada (clave incorrecta o caducada, o sin acceso a la API en tu plan de Cargoson), no hay transportista para la ruta o el peso, o un precio en otra moneda. Con Cargoson live prices, fixed prices if the API fails, los clientes siguen viendo el precio fijo mientras corriges el problema.

Cargoson rechaza el tipo de paquete: usa el código de paquete que tu cuenta de Cargoson utiliza en Package type code. El motivo aparece en el registro.

Se rechaza un precio en otra moneda: pon Price currency en la moneda de tus precios de Cargoson e introduce la Currency conversion rate.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran los precios de Cargoson guardados 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 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 siempre se eliminan. Los ajustes, los métodos de zona y los precios en caché 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.

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