VibeFox Chilexpress 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.

Claves de API de Chilexpress (solo para tarifas en tiempo real): crea una cuenta en el portal de desarrolladores de Chilexpress (developers.wschilexpress.com) y suscríbete a dos productos: Rating (Cotizador) y Coverage (Coberturas / Georreferencia). Cada producto tiene su propia clave de suscripción. Las claves de prueba funcionan solo con el entorno de prueba; las claves de producción se emiten a clientes corporativos de Chilexpress con un contrato de cliente. También necesitas el código county de Chilexpress de la comuna desde la que envías, por ejemplo STGO. Si solo usas precios fijos, no necesitas claves de API.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Chilexpress, 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. Rellena la tabla de precios. Para tarifas en tiempo real, introduce ambas claves de suscripción, tu código county de origen y, si la moneda de la tienda no es CLP, el tipo de cambio a CLP; después elige la fuente de tarifas (consulta Configuración).

6. Añade VibeFox Chilexpress a una zona de envío para Chile 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 Chilexpress. 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 de esta opción de envío en la finalización de compra para esta zona. Déjalo vacío para usar el Name global.

La página de ajustes muestra los problemas en la parte superior: hay tarifas de API seleccionadas pero falta una clave, el código county de origen o el tipo de cambio a CLP, o la tabla de precios no tiene fila para Chile ni para * Default. Cada vez que guardas los ajustes, se borran las tarifas y las listas de comunas en caché. Los números se pueden escribir con punto o con coma; un número no válido no se guarda y se muestra un error.

General

Enable/Disable: activa o desactiva el envío por Chilexpress 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. Default: Chilexpress.

Tax status: Taxable añade el impuesto de WooCommerce al costo de envío (si los impuestos están activados), None no lo añade. Las tarifas de la API de Chilexpress se usan exactamente como se cotizan. Elige None si la cotización ya incluye IVA y tu tienda añadiría impuesto encima.

Tarifas

Rate source: de dónde viene el precio.

Las tarifas en tiempo real solo están disponibles para destinos en Chile. Los demás países siempre usan los precios fijos.

Country prices: una tabla de países de destino con una columna Price y precios opcionales por tamaño de paquete en la moneda de tu tienda. El tamaño sale del peso del carrito: XS hasta 1 kg, S hasta 2 kg, M hasta 3 kg, L hasta 5 kg, XL por encima de 5 kg. Un tamaño que se deja en 0 usa Price. Haz clic en + Add country para añadir una fila y en la × para quitarla. La fila * Default se aplica a los países sin fila propia. Un país sin fila (y sin *) no tiene precio fijo. Una fila cuyo precio y precio por tamaño son ambos 0 da envío gratis.

Calculation type: Per order cobra el precio fijo una sola vez. Per item (fixed price x number of items) lo multiplica por el número de artículos del carrito. Una tarifa de la API de Chilexpress siempre se cotiza para el paquete completo.

API de Chilexpress (tarifas en tiempo real)

Test environment: usa el entorno de pruebas de Chilexpress (qaservices.wschilexpress.com). Úsalo con claves de prueba y desactívalo en una tienda en producción.

Rating API key: la clave de suscripción del producto Rating (Cotizador).

Coverage API key: la clave de suscripción del producto Coverage (Coberturas / Georreferencia). Se usa para encontrar el código county de Chilexpress de la comuna del cliente (el campo Ciudad en la finalización de compra).

Origin county code: el código county de Chilexpress de la comuna desde la que envías, de 2 a 5 letras, por ejemplo STGO (Santiago Centro), PROV (Providencia), LCON (Las Condes), VALP (Valparaíso) o CONC (Concepción). Un valor que no es un código county se rechaza con un error.

Service: el servicio de Chilexpress que se usa para la tarifa. Si no se ofrece para el destino, se usa el servicio más barato disponible.

CLP exchange rate: Chilexpress cotiza en pesos chilenos. Solo hace falta si la moneda de tu tienda no es CLP: el precio de 1 CLP en la moneda de tu tienda, por ejemplo 0.001. Sin él no se usan las tarifas de la API.

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 método se oculta por encima de este peso del carrito. Default: 25. 0 significa sin límite.

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

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

Ignore shipping zones: ofrece el método 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 de envío de la tienda. Este campo 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 a partir del cual el envío es gratis. Solo se usa cuando Free shipping está activado. En ese caso no se hace ninguna solicitud a la API.

Avanzado

Debug log: registra las solicitudes a la API y los cálculos de tarifas en WooCommerce > Status > Logs, origen vfd-chilexpress. Los errores de la API siempre se registran, incluso con esta opción desactivada. Las claves de API nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y los métodos de zona. Desactivar nunca borra los ajustes. Las líneas de envío de los pedidos existentes siempre se conservan.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. El plugin primero comprueba las condiciones: peso del carrito, subtotal mínimo y clases de envío excluidas. Si se aplica el envío gratis, el cliente recibe una tarifa gratuita y no se envía ninguna solicitud a Chilexpress.

Para una dirección en Chile y una fuente de tarifas de API, el plugin toma la región y la comuna del campo Ciudad y busca el código county de Chilexpress en la lista de comunas de esa región (API de Coverage). Se ignoran los acentos, los espacios y las variantes ortográficas, así que Ñuñoa y Nunoa coinciden, y Santiago coincide con Santiago Centro. También se acepta un código county escrito en el campo Ciudad. Después el plugin envía a la API de Rating los códigos county de origen y destino, el peso del carrito (al menos 0,1 kg), las dimensiones del paquete (largo y ancho del producto más grande, con las alturas apiladas) y el subtotal del carrito en CLP como valor declarado. Chilexpress devuelve sus servicios; el plugin usa el servicio elegido o el más barato, y convierte el importe en pesos a la moneda de tu tienda. El nombre del servicio se guarda en la línea de envío del pedido como Chilexpress service.

Las tarifas se guardan en caché durante 1 hora y las listas de comunas durante 7 días. Una solicitud fallida se recuerda durante 5 minutos, para que una API lenta o no disponible no ralentice cada actualización de la finalización de compra. El tiempo de espera de la API es de 10 segundos. Si Chilexpress devuelve un error, no devuelve ningún servicio con precio o no reconoce la comuna, el cliente no ve ningún error. El método se oculta en el modo solo API, o se usa el precio fijo. El motivo se escribe en el 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 crea envíos ni órdenes de transporte (OT), no imprime etiquetas, no reserva recogidas ni rastrea paquetes; reserva el envío en tu cuenta de Chilexpress. Los clientes no pueden elegir una oficina de Chilexpress, y no hay selector de comuna: el cliente escribe la comuna en el campo Ciudad estándar. Los envíos internacionales usan los precios fijos.

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 Chilexpress. 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, Chilexpress no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión lo siguen viendo, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un aviso 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 renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Chilexpress 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 permitido). Revisa los límites de peso, Minimum subtotal y Excluded shipping classes. Con precios fijos, comprueba que el país o * Default tenga una fila.

La tarifa en tiempo real no se muestra y se usa el precio fijo: primero revisa los avisos de la parte superior de la página de ajustes. Si no hay avisos, activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-chilexpress. Causas habituales: una comuna que Chilexpress no reconoce (revisa el campo Ciudad y la región), una clave de otro producto o entorno, o un destino sin cobertura de Chilexpress.

HTTP 401 o 403 en el registro: la clave de suscripción es incorrecta, está inactiva o pertenece a otro producto o entorno. Las claves de prueba solo funcionan con Test environment activado.

Las tarifas de la API no se usan en una tienda con otra moneda: introduce el CLP exchange rate.

¿Las tarifas de la API incluyen IVA o no? Se usan exactamente como las cotiza Chilexpress. Si tu tienda añade impuesto al envío y la cotización ya incluye IVA, pon Tax status en None.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las tarifas y las listas de comunas 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 contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Desactivar el plugin conserva todos los ajustes; solo borra las tarifas y las listas de comunas en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia, el estado de licencia de este plugin y las cachés 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. Las líneas de envío de los pedidos existentes siempre se conservan.

Chilexpress es una marca comercial de su respectivo titular. Este plugin no está afiliado ni respaldado por Chilexpress.