VibeFox Andreani 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 Andreani (solo para tarifas en tiempo real): las tarifas en tiempo real usan la API de cotizaciones de Andreani. Andreani emite credenciales de API, un código de cliente y números de contrato a los clientes empresariales, normalmente a partir de unos 300 envíos al mes. Consulta developers.andreani.com o escribe a ventapyme@andreani.com. Necesitas el nombre de usuario y la contraseña de la API, el código de cliente y el número de contrato. Andreani emite un contrato distinto para cada servicio (entrega a domicilio, recogida en sucursal). Sin acceso a la API, usa precios fijos. El selector de sucursales funciona sin credenciales.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Andreani, 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. Configura el nombre, la fuente de tarifas, los precios por país (por ejemplo AR=5000) y, para las tarifas en tiempo real, las credenciales de la API, el código de cliente y el número de contrato (ver Configuración).

6. Ve a WooCommerce > Settings > Shipping > Shipping zones, abre o crea una zona para Argentina y añade VibeFox Andreani. En la ventana de la zona puedes definir el título, la modalidad de entrega y un contrato distinto para esta opción. También puedes activar Ignore shipping zones y elegir países en su lugar.

Configuración

Los ajustes principales están en WooCommerce > Settings > Shipping > VibeFox Andreani. Se aplican a todas las zonas de envío. Las advertencias sobre ajustes incompletos (credenciales de la API, número de contrato, tipo de cambio, sin precio para Argentina) se muestran en la parte superior de la página. Cada vez que guardas los ajustes, se borran el token, la lista de sucursales y las tarifas guardados en caché.

Ventana de la zona (al añadir el método a una zona de envío)

Title: el nombre de esta opción en la finalización de compra. Déjalo vacío para usar el Name global.

Delivery modality: Use global setting o una de las cuatro modalidades (ver abajo). Añade el método dos veces a una zona, por ejemplo puerta a puerta y recogida en sucursal, para ofrecer ambas.

Contract number: el contrato de Andreani para esta opción. Déjalo vacío para usar el contrato global.

General

Enable/Disable: activa o desactiva el envío con Andreani en todas las zonas a la vez.

Name: el nombre del método de envío que ve el cliente en la finalización de compra. Predeterminado: Andreani.

Tax status: Taxable significa que WooCommerce añade impuesto al costo del envío, así que la tarifa de la API se toma sin IVA. None significa que la tarifa de la API se toma con IVA incluido.

Andreani API (necesaria para tarifas en tiempo real)

Environment: Sandbox / QA (apisqa.andreani.com) (predeterminado) o Production (apis.andreani.com). Usa el entorno al que pertenecen tus credenciales.

API username: tu nombre de usuario de la API de Andreani.

API password: tu contraseña de la API de Andreani.

Client code: el código de cliente facilitado por Andreani, por ejemplo CL0000000.

Contract number: el contrato del servicio usado para las tarifas, por ejemplo entrega a domicilio. Una zona puede usar otro contrato, por ejemplo para la recogida en sucursal.

Origin branch code: sucursal de origen opcional (sucursalOrigen) para las cotizaciones de tarifas. Déjalo vacío para usar la sucursal configurada en tu contrato.

Entrega y tarifas

Delivery modality: la primera parte indica dónde recoge Andreani el paquete (tu domicilio o una sucursal donde lo dejas). La segunda parte indica dónde lo recibe el cliente.

Rate source: cómo se calcula el precio.

Country prices: un precio fijo por país de destino en la moneda de tu tienda, uno por línea con el formato CC=PRICE, por ejemplo AR=5000. Se usa en el modo fijo y como alternativa si falla la API. Las líneas con otro formato se ignoran, y al guardar aparece una advertencia con ellas.

ARS exchange rate: Andreani cotiza en pesos argentinos. Solo hace falta si la moneda de tu tienda no es ARS: el precio de 1 ARS en la moneda de tu tienda, por ejemplo 0.001. Sin él, no se usan las tarifas de la API. Los precios fijos siempre están en la moneda de tu tienda.

Default product weight (kg): se usa en los productos sin peso al pedir tarifas de la API y al comprobar los límites de peso. Predeterminado: 0.5.

Calculation type: Per order cobra el precio una sola vez. Per item (price x number of items) multiplica el precio fijo de Country prices por el número de artículos del carrito. Una tarifa en tiempo real de Andreani ya es para todo el carrito y no se multiplica.

Disponibilidad

Min weight (kg): el peso mínimo del carrito para que aparezca el método. 0 significa sin límite.

Max weight (kg): el peso máximo del carrito. El método se oculta si se supera. Predeterminado: 100. 0 significa sin límite.

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

Excluded shipping classes: si algún artículo del carrito pertenece a una clase de envío de WooCommerce seleccionada, el método se oculta.

Ignore shipping zones: ofrece el método para los países de abajo aunque no se haya añadido a una zona de envío.

Countries: los países de destino para ese modo. Déjalo vacío para permitir todos los países. Solo se usa cuando Ignore shipping zones está activado.

Envío gratis

Free shipping: activa el umbral de envío gratis.

Free shipping from: el subtotal del carrito desde el cual el envío es gratis. Requiere que Free shipping esté activado.

Selector de sucursal en la finalización de compra (se muestra para puerta a sucursal y sucursal a sucursal)

Province select width: el ancho CSS de la lista de provincias, por ejemplo 100% o 300px. Predeterminado: 100%.

Branch select width: el ancho CSS de la lista de sucursales, por ejemplo 100% o 400px. Predeterminado: 100%.

Avanzado

Debug log: registra las solicitudes a la API y los cálculos de tarifas en WooCommerce > Status > Logs (fuente "vfd-andreani"). Los errores siempre se registran. Las credenciales y los tokens nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran todos sus ajustes y métodos de zona. Desactivarlo nunca borra nada. Los datos de sucursal guardados en los pedidos siempre se conservan.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, el plugin comprueba el peso del carrito (los pesos de los productos se convierten a kg; los productos sin peso usan Default product weight (kg)), el Minimum subtotal y las Excluded shipping classes.

En el modo fijo el precio se toma de Country prices. En los modos en tiempo real, el plugin inicia sesión en la API de Andreani y solicita una cotización con el código postal de destino, el contrato, el código de cliente, el peso en kg, el volumen a partir de las dimensiones del producto y el valor declarado (el subtotal del carrito en ARS). Una tarifa en tiempo real solo se solicita para un código postal argentino válido. El importe en ARS se convierte con ARS exchange rate cuando la moneda de tu tienda no es ARS.

El token de inicio de sesión se guarda en caché durante 23 horas y se renueva automáticamente cuando Andreani lo rechaza. Las cotizaciones se guardan en caché durante 1 hora. Una llamada fallida a la API no se repite durante 5 minutos. Los errores de la API nunca se muestran al cliente: el método se oculta o, en el modo de alternativa, se usa el precio fijo. El motivo se escribe en el registro.

Si Free shipping está activado y el subtotal del carrito alcanza Free shipping from, la tarifa es 0. El envío gratis se aplica solo donde el método tiene precio: si la API de Andreani no devuelve tarifa (y no hay precio fijo al que recurrir), el método no se muestra. Con Per item el precio fijo se multiplica por el número de artículos.

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 no crea envíos de Andreani, no imprime etiquetas ni hace seguimiento de paquetes. Para ello usa el portal web de Andreani.

Puntos de recogida

Con Door to branch o Branch to branch, debajo de la opción de Andreani aparecen en la finalización de compra una lista de provincias y una lista de sucursales, tanto en la finalización de compra clásica como en el bloque de Finalizar compra. La provincia se preselecciona a partir de la dirección de envío. La lista de sucursales procede de la API pública de sucursales de Andreani y se guarda en caché durante 12 horas. No se muestran las sucursales que no entregan paquetes. Si no hay sucursales disponibles, el cliente ve un mensaje y puede elegir otro método de envío.

El pedido no se puede realizar sin sucursal: el cliente ve Please select an Andreani pickup branch. Esto se comprueba en el servidor para ambas finalizaciones de compra.

La sucursal elegida se guarda en el pedido. En la pantalla de pedidos del administrador, la modalidad y la sucursal se muestran debajo de la dirección de envío. Haz clic en Edit para elegir otra provincia y sucursal. El cliente ve la sucursal como Andreani pickup branch en la página del pedido y en los correos electrónicos del pedido (HTML y texto sin formato). Los pedidos existentes conservan sus datos de sucursal.

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 Andreani. 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. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Andreani no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada 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

Andreani 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 de la dirección del cliente (o que Ignore shipping zones esté activado y el país permitido). Comprueba que Country prices tenga una línea para el país (para precios fijos o como alternativa) y revisa los límites de peso, el Minimum subtotal y las Excluded shipping classes. Lee las advertencias de la parte superior de la página de ajustes.

Las tarifas en tiempo real no aparecen: activa el Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs (fuente "vfd-andreani"). Muestra el motivo: credenciales o número de contrato que faltan, un inicio de sesión fallido (usuario, contraseña o entorno incorrectos), todavía no hay un código postal argentino válido, no hay tipo de cambio o un error HTTP de Andreani. Con Andreani API, fixed price if the API fails, los clientes siguen recibiendo el precio fijo mientras corriges el problema.

Mi tienda no está en pesos argentinos: pon ARS exchange rate con el valor de 1 ARS en la moneda de tu tienda.

El impuesto del envío parece incorrecto: con Tax status en Taxable se usa la tarifa de Andreani sin IVA y WooCommerce añade su propio impuesto. Con None se usa la tarifa con IVA y WooCommerce no añade impuesto. Comprueba que los impuestos de WooCommerce estén configurados si usas Taxable.

No hay sucursales en la lista: la API de sucursales de Andreani no respondió. Una solicitud fallida se reintenta después de 5 minutos. Revisa el registro.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra el token, la lista de sucursales y las tarifas guardados en caché.

El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya está usada 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 contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Al desactivar el plugin se conservan todos los ajustes y solo se borran las cachés. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin, así como el token, la lista de sucursales 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. En caso contrario, se conservan para una reinstalación posterior. Los datos de sucursal guardados en los pedidos nunca se borran.

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