VibeFox Envioclick 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 Envioclick (solo para tarifas en tiempo real): una cuenta de Envioclick en México o Colombia con acceso a la API. La clave de API está en tu cuenta de Envioclick, en Mi cuenta (arriba a la derecha) > Información del API. Si solo usas precios fijos, no necesitas una cuenta de Envioclick.

User-Agent (solo México): Envioclick México exige un valor de User-Agent en cada solicitud a la API. Pídeselo al soporte de Envioclick (soporte.tecnico@envioclick.com).

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Envioclick, 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. Introduce la clave de API, elige el país de la API, introduce el User-Agent (México), el código postal o el código DANE de origen y la dirección de origen. Si la moneda de tu tienda no es MXN ni COP, introduce el tipo de cambio.

6. Opcionalmente, añade precios fijos por país y un coste alternativo.

7. Añade VibeFox Envioclick 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 Envioclick. 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 único campo:

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

Cuando hay una clave de API, el plugin muestra avisos en la parte superior de la página si las tarifas en tiempo real no pueden funcionar: no hay tipo de cambio para una moneda de tienda distinta de MXN o COP, no hay User-Agent para México, no hay código postal o código DANE de origen, o no hay dirección de origen para Colombia. Cada vez que guardas los ajustes, se borran las cotizaciones en caché. Los campos numéricos aceptan tanto el punto como la coma como separador decimal.

General

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

Method title: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Una zona puede cambiarlo. Por defecto: Envioclick Shipping.

Carrier in the title: muestra el transportista y el plazo de entrega estimado junto al título en las tarifas en tiempo real, por ejemplo "Envioclick Shipping (Estafeta Express, 1 day)". El transportista se guarda en el pedido y se muestra en los correos de pedido en cualquier caso. Por defecto: activado.

Envioclick API (tarifas en tiempo real)

Opcional. Sin clave de API solo se usan los precios fijos. Las tarifas en tiempo real se solicitan solo para destinos del país de la API. Los envíos a otros países usan los precios fijos.

API key: tu clave de API de Envioclick, de Mi cuenta > Información del API.

API country: el país de tu cuenta de Envioclick.

User-Agent (Mexico): el valor que emite el soporte de Envioclick (soporte.tecnico@envioclick.com). Obligatorio para México; sin él no se solicitan tarifas en tiempo real para México. Opcional para Colombia.

Carrier choice: Cheapest (por defecto) o Fastest (then cheapest). Envioclick devuelve cotizaciones de varios transportistas y el cliente recibe una sola tarifa.

Branch pickup rates: considera también las tarifas "Ocurre", en las que el cliente recoge el paquete en la sucursal del transportista. Si está desactivado, solo se usan las tarifas de entrega a domicilio. Los servicios de pago contra entrega (COD) nunca se usan. Por defecto: desactivado.

Currency conversion rate: Envioclick cotiza en MXN (México) o COP (Colombia). Si la moneda de tu tienda es otra, introduce el valor de 1 MXN o 1 COP en la moneda de tu tienda, por ejemplo 0.05. El valor declarado del paquete se convierte del mismo modo. Déjalo vacío si la moneda de la tienda es MXN o COP. Sin él, las tarifas en tiempo real no se usan en otra moneda.

Origen del envío

Se usa para las tarifas en tiempo real. Los campos vacíos se toman de la dirección de la tienda en WooCommerce > Settings > General si la tienda está en el país de la API.

Origin postcode / DANE code: México: el código postal de 5 dígitos. Colombia: el código DANE de 8 dígitos del municipio, por ejemplo 11001000 para Bogotá.

Origin address: la calle y el número de la dirección de recogida. Obligatoria para Colombia, opcional para México.

Precios fijos

Se usan cuando no hay tarifa en tiempo real: sin clave de API, con destino fuera del país de la API, con error de la API o sin transportista para la ruta.

Price per country: una tabla de países y precios en la moneda de tu tienda. 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 sin fila propia.

Fallback cost: se usa cuando no hay tarifa en tiempo real y ninguna fila de la tabla coincide. Déjalo vacío para ocultar el método en ese caso.

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. Las tarifas en tiempo real de Envioclick son siempre por envío.

Condiciones

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. Por defecto: 25. 0 significa sin límite.

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

Free shipping from: envío gratis cuando el subtotal del carrito (después de descuentos, antes de impuestos) alcanza este importe. En ese caso no se hace ninguna solicitud a la API. Déjalo vacío para no ofrecer nunca envío gratis.

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

Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade. Las cotizaciones de Envioclick ya incluyen los impuestos de los transportistas, así que elige None para no cobrar impuesto sobre el envío dos veces.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece Envioclick 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. Solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: registra los cálculos de tarifas y los errores de la API en WooCommerce > Status > Logs, origen vfd_envioclick. La clave de API y las direcciones de los clientes no se registran. Desactívalo cuando termines.

Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de Envioclick, los métodos de zona y las cotizaciones en caché. 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. El plugin comprueba primero el peso del carrito, el importe mínimo del pedido y las clases de envío excluidas. Si se aplica envío gratis, el método se muestra con precio cero y no se envía ninguna solicitud a Envioclick.

Si hay una clave de API y el destino está en el país de la API, el plugin pide a Envioclick las cotizaciones. En México, la solicitud se hace cuando el cliente ha introducido un código postal de 5 dígitos. En Colombia, se hace cuando se reconocen el departamento y el municipio (los acentos y las mayúsculas no importan; "Bogotá D.C." funciona). El plugin elige la cotización de entrega a domicilio más barata o más rápida que no sea pago contra entrega y la convierte a la moneda de tu tienda.

El paquete es siempre una sola caja: el peso total convertido a kg, y el largo y el ancho del artículo más grande con una altura que mantiene el volumen total de todos los artículos. Los productos sin dimensiones cuentan como 10 × 10 × 10 cm. Un carrito sin peso se envía como 0,5 kg. El valor declarado es el subtotal del carrito.

Cada cotización se guarda en caché durante 1 hora para la misma ruta y el mismo paquete. Una solicitud fallida se guarda en caché durante 10 minutos, de modo que una API no disponible no ralentiza cada actualización de la finalización de compra. El tiempo de espera de la API es de 10 segundos. Si Envioclick devuelve un error o no hay transportista para la ruta, el cliente no ve ningún error: se usa el precio fijo o el método se oculta. El motivo se escribe en el registro de depuración.

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 guías ni etiquetas, no solicita recogidas ni rastrea o cancela envíos. Ofrece una sola tarifa, no una elección entre transportistas, y no usa servicios de pago contra entrega, seguro adicional ni cotizaciones de varios paquetes. Las cotizaciones en tiempo real son solo nacionales.

Pedidos

Cuando se realiza un pedido con una tarifa en tiempo real de Envioclick, el transportista y el servicio se guardan en el pedido. La pantalla de pedidos del administrador muestra Envioclick carrier con el plazo de entrega estimado debajo de la dirección de envío. La página de pedido del cliente y los correos de pedido (HTML y texto sin formato) muestran Shipping carrier. El ID de la tarifa de Envioclick de la cotización se guarda con la línea de envío del pedido como dato oculto; no se muestra en la pantalla de pedido. Crea la guía en tu cuenta de Envioclick.

Los pedidos con precio fijo no tienen transportista.

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

Solución de problemas

Envioclick 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. Sin tarifa en tiempo real, el método necesita un precio fijo para el país, una fila * Default o un Fallback cost.

Las tarifas en tiempo real no aparecen: lee los avisos en la parte superior de la página de ajustes, después activa el Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd_envioclick. Motivos habituales: no hay tipo de cambio (la moneda de la tienda no es MXN ni COP), no hay User-Agent (México), no hay código postal o código DANE de origen, el código postal del cliente (México) o la ciudad (Colombia) aún no se ha introducido, el destino está fuera del país de la API o no hay transportista para la ruta.

¿Por qué un tipo de cambio? Envioclick devuelve precios solo en pesos mexicanos o colombianos. El plugin nunca muestra un importe en pesos como si fuera otra moneda.

Colombia: la ciudad no se reconoce: el cliente debe elegir el departamento y escribir el nombre del municipio. También funciona un código DANE de 8 dígitos escrito como código postal. Los desarrolladores pueden proporcionar un código DANE con el filtro vfd_evc_dane_code.

El impuesto se cobra dos veces en el envío: las cotizaciones de Envioclick ya incluyen los impuestos de los transportistas. Pon Tax status en None.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las cotizaciones en caché.

Filtros para desarrolladores: vfd_evc_quotation_request (cuerpo de la solicitud), vfd_evc_api_url, vfd_evc_dane_code, vfd_evc_default_dimensions y vfd_evc_package_description.

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 ajustes y métodos de zona; solo se borran las cotizaciones 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 siempre se eliminan. Los ajustes, los métodos de zona y las cotizaciones en caché se eliminan solo si Remove data on uninstall estaba activado. En caso contrario, se conservan para una reinstalación posterior. El transportista guardado en pedidos anteriores se conserva, y los pedidos existentes mantienen sus líneas de envío.

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