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

Clave API de Coordinadora (solo para cotizaciones en vivo): las cotizaciones en vivo provienen del Cotizador de Coordinadora a través del servicio WooCommerce de Coordinadora, el mismo que usa el plugin oficial de Coordinadora. Coordinadora emite la clave API a los clientes con un acuerdo comercial activo. Pregunta a tu gestor de cuenta de Coordinadora o consulta wc.coordinadora.com. También necesitas el código DANE de 8 dígitos de la ciudad desde la que envías. Sin clave, el método funciona solo con precios fijos.

Productos: para una cotización en vivo, cada producto del carrito necesita peso y dimensiones (largo, ancho, alto).

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_coordinadora a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Coordinadora, 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 API, el código DANE de la ciudad de origen y, si la moneda de tu tienda no es COP, el tipo de cambio a COP. Añade al menos un precio fijo para Colombia como alternativa (ver Configuración).

6. Añade VibeFox Coordinadora a una zona de envío que cubra Colombia en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige países.

7. Asegúrate de que tus productos tengan peso y dimensiones.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Coordinadora. Se aplican a todas las zonas de envío. Al añadir el método a una zona, la ventana de la zona tiene un único campo:

Title (zone): el nombre del método de envío que ve el cliente en esta zona. Déjalo vacío para usar el Name global.

La página de ajustes muestra avisos arriba cuando las cotizaciones en vivo no pueden funcionar o el método quedaría oculto: falta el código DANE de origen o no es válido, falta el tipo de cambio a COP o no hay precio fijo para Colombia. Cada vez que guardas los ajustes, se borran las cotizaciones en caché. Los números pueden escribirse con punto o con coma (9,99 = 9.99).

General

Enable/Disable: activa o desactiva Coordinadora 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. Por defecto: Coordinadora. El Title de una zona lo sustituye.

Tax status: Taxable añade el impuesto de envío de WooCommerce sobre la tarifa, None no lo añade. Elige None si tus precios o la cotización de Coordinadora ya incluyen impuestos.

Cotizaciones en vivo de Coordinadora

Las cotizaciones en vivo se solicitan para destinos en Colombia. Deja la clave vacía para usar solo precios fijos.

API key: tu clave API de WooCommerce de Coordinadora. Nunca se escribe en el registro.

Origin city (DANE code): el código DANE de 8 dígitos de la ciudad desde la que envías, por ejemplo 11001000 Bogotá, 05001000 Medellín, 76001000 Cali u 08001000 Barranquilla. También se acepta un código de municipio de 5 dígitos, que se completa hasta 8 dígitos.

COP per 1 unit of store currency: Coordinadora cotiza en pesos colombianos. Si la moneda de tu tienda no es COP, introduce cuántos COP equivalen a 1 unidad de tu moneda, por ejemplo 4300. El tipo de cambio también se usa para enviar el valor declarado en COP. Si lo dejas vacío, no se usan las tarifas en vivo. Si la moneda de tu tienda es COP, déjalo vacío.

Precios fijos (se usan cuando no hay clave API, para destinos fuera de Colombia y como alternativa cuando una cotización en vivo no está disponible)

Prices by country: tabla de países con una columna Price y precios opcionales por tamaño de paquete en la moneda de tu tienda. El tamaño se calcula a partir del peso del carrito: XS hasta 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL más de 5 kg. Price se usa cuando la columna de tamaño es 0 o está vacía. Haz clic en + Add country para añadir una fila y en el icono de la cruz para eliminarla. El país * All other countries se aplica a los países sin fila propia. Un país sin fila (y sin *) no tiene precio fijo. Una fila con Price 0 y sin precio por tamaño da envío gratis.

Fixed price per: Order cobra el precio una vez. Item (price × quantity) lo multiplica por el número de artículos del carrito. Esto se aplica solo a los precios fijos; una cotización en vivo de Coordinadora siempre cubre todo el pedido.

Condiciones

Min weight (kg): oculta el método por debajo de este peso del carrito. 0 significa sin límite.

Max weight (kg): oculta el método por encima de este peso del carrito. Por defecto: 25. 0 significa sin límite.

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

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

Free shipping: activa la entrega gratuita a partir del subtotal indicado abajo.

Free shipping from: el subtotal del carrito a partir del cual el envío es gratis. Solo se usa si Free shipping está activado. En ese caso no se hace ninguna solicitud a la API.

Disponibilidad sin zonas de envío

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 a los que la tienda envía. Este campo se usa solo si Ignore shipping zones está activado.

Avanzado

Debug log: registra los cálculos de tarifas en WooCommerce > Status > Logs, origen vfd-coordinadora. Los errores de la API siempre se registran, incluso con esta opción desactivada. La clave API y las direcciones de los clientes nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes, los métodos de zona y las tarifas en caché. Desactivar el plugin nunca borra datos.

Cómo funciona en la finalización de compra

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

Para una dirección en Colombia con clave API, el plugin busca el código DANE de la ciudad de destino en este orden: un código DANE en el campo de ciudad (los plugins de departamentos y ciudades de Colombia lo escriben, por ejemplo MEDELLIN (ANT) (05001000)), un código postal de 8 dígitos o la lista integrada de capitales departamentales y unas 40 de las ciudades más grandes. Una ciudad de la lista se comprueba frente al departamento seleccionado. Los acentos y las mayúsculas no se tienen en cuenta.

Después, el plugin envía a Coordinadora el código DANE de destino y cada producto con la ciudad de origen, su peso (kg), dimensiones (cm), cantidad y valor declarado (COP). Las unidades de la tienda se convierten automáticamente. Coordinadora devuelve el precio en COP, y el plugin lo convierte a la moneda de tu tienda. Cada cotización se guarda en caché durante 1 hora. Una solicitud fallida se recuerda durante 10 minutos, para que una caída de Coordinadora nunca ralentice cada actualización de la finalización de compra. El tiempo de espera de la API es de 10 segundos.

Cuando una cotización en vivo no está disponible (error de la API, ciudad desconocida, un producto sin peso o dimensiones, ajustes que faltan), se usa el precio fijo. Si no hay ninguno, el método queda oculto. Los detalles de los errores van al registro de WooCommerce, nunca al cliente.

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 guías (guías), no imprime etiquetas, no programa recogidas (recogidas), no rastrea paquetes, no cobra contraentrega (recaudo) ni ofrece puntos de recogida de Droop; para esto usa el portal de Coordinadora. No ofrece cotizaciones para entrega el mismo día, y los destinos 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 Coordinadora. 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 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, Coordinadora no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada sí la ven, marcada 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

Coordinadora 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 order subtotal y Excluded shipping classes. Sin cotización en vivo, debe existir un precio fijo para el país o para *.

La tarifa en vivo no se muestra, solo el precio fijo: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-coordinadora. Motivos habituales: la ciudad de destino no se reconoce, un producto no tiene peso o dimensiones, falta el código DANE de origen o el tipo de cambio a COP, o Coordinadora devolvió un error.

La ciudad de destino no se reconoce: instala un plugin de departamentos y ciudades de Colombia para la finalización de compra que escriba el código DANE en el campo de ciudad. Los desarrolladores pueden asignar más ciudades con los filtros vfd_crd_dane_cities y vfd_crd_destination_dane.

¿La tarifa incluye impuestos? La tarifa es la que cotiza Coordinadora. Con Tax status en Taxable, WooCommerce añade el impuesto de envío encima; elige None si la cotización ya lo incluye.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las cotizaciones 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 ajustes; solo borra 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 y las cotizaciones en caché 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. Los pedidos existentes conservan sus líneas de envío.

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