VibeFox Jadlog 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.
Contrato con Jadlog (para precios en tiempo real y puntos Pickup): los precios en tiempo real y la lista de puntos Pickup proceden de la API Embarcador de Jadlog. Tu franquicia de Jadlog emite el acceso una vez firmado el contrato. Necesitas el token de la API Embarcador, el CNPJ (o CPF) del remitente registrado en el contrato, la cuenta corriente (conta corrente) y, si tienes uno, el número de contrato. Si solo usas precios fijos, no necesitas un contrato con Jadlog.
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_jadlog a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Jadlog, 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. Pega el token de la API, introduce el CNPJ, la cuenta corriente, el número de contrato y el CEP de origen, elige el servicio de Jadlog y, si la moneda de tu tienda no es BRL, introduce el tipo de cambio a BRL. Añade precios fijos o un coste de respaldo si los quieres (consulta Configuración).
6. Añade VibeFox Jadlog a una zona de envío para Brasil en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige países. Para ofrecer también los puntos Jadlog Pickup, añade el método a la zona por segunda vez y elige Pickup (40) como servicio.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Jadlog. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene dos campos:
Title (zone): el nombre que ven los clientes en esta zona. Déjalo vacío para usar el Method title global.
Jadlog service (zone): el servicio de este método de zona. Same as the global setting usa el servicio de la página de ajustes principal. Añade el método dos veces para ofrecer, por ejemplo, entrega a domicilio (.Package) y puntos Jadlog Pickup en la misma zona.
Cuando el título de la zona está vacío y el servicio es Pickup, se añade la palabra "Pickup" al título global, para que los dos métodos tengan nombres distintos.
En la parte superior de la página de ajustes, el plugin muestra avisos si la configuración está incompleta: no hay token de API, no hay CNPJ o cuenta corriente, no hay CEP de origen o no hay tipo de cambio a BRL en una tienda que no vende en BRL. Cada vez que guardas los ajustes, se borran los precios de Jadlog y las listas de puntos Pickup en caché.
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. Por defecto: Jadlog. Una zona puede sustituirlo.
Precios en tiempo real de Jadlog
Los precios en tiempo real solo se piden para direcciones en Brasil con un CEP completo de 8 dígitos.
API token: el token Embarcador de Jadlog. Puedes pegarlo con o sin la palabra "Bearer". Déjalo vacío para usar solo precios fijos.
CNPJ: el CNPJ (14 dígitos) o el CPF (11 dígitos) del remitente registrado en el contrato de Jadlog. Se permiten puntos, barras y guiones. El plugin te avisa si el número de dígitos es incorrecto.
Current account (conta corrente): el número de tu cuenta corriente de Jadlog. Sin ella y sin el CNPJ, Jadlog no puede cotizar y solo se usan precios fijos.
Contract number: el número de tu contrato con Jadlog, si tu franquicia te lo dio.
Origin CEP: el código postal desde el que se envían los paquetes, de 8 dígitos. Se guarda en el formato 00000-000. Déjalo vacío para usar el código postal de la tienda de WooCommerce > Settings > General, si la dirección de la tienda está en Brasil.
Jadlog service: el servicio (modalidade) de tu contrato: .Package (3, por defecto), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12), Emergencial (14) o Pickup (40). Pickup ofrece los puntos Jadlog Pickup cercanos al cliente. Un método de zona puede usar otro servicio.
Insurance type: Normal (N) (por defecto) o Own insurance policy (A — apólice), según lo acordado en tu contrato con Jadlog.
Volumetric weight: Jadlog cobra el mayor entre el peso real y el peso volumétrico.
BRL exchange rate: Jadlog cotiza en reales brasileños. Si la moneda de tu tienda es BRL, este campo no es necesario. Si no lo es, introduce cuánto vale 1 BRL en la moneda de tu tienda, por ejemplo 0.16. El precio de Jadlog se multiplica por este tipo de cambio, y el valor declarado del pedido que se envía a Jadlog se convierte de nuevo a BRL. Sin el tipo de cambio no se usan precios en tiempo real y solo se aplican precios fijos. Se aceptan tanto el punto como la coma como separador decimal.
Delivery time: muestra el plazo de entrega que devuelve Jadlog junto al título del método, por ejemplo "Jadlog (3 días hábiles)". Activado por defecto. El plazo de entrega siempre se guarda en el pedido.
Puntos Jadlog Pickup (los usa el servicio Pickup (40); necesita el token de la API)
Points to show: cuántos puntos Pickup ofrecer, de 1 a 10. Por defecto: 5.
Precios fijos (se usan cuando no hay token de API, para los países que Jadlog no atiende y siempre que Jadlog no devuelva ningún precio)
Price per country: una tabla con las columnas Country, Price, XS, S, M, L y XL, en la moneda de tu tienda. Haz clic en + Add country para añadir una fila y en el icono × para eliminar una. La columna de tamaño se elige según el 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. Price se usa cuando la columna de tamaño está vacía. Un precio de 0 significa envío gratis para ese país. Usa * Default como país para todos los demás países. Las filas sin ningún precio se eliminan al guardar.
Fallback cost: se usa cuando ni Jadlog ni la tabla dan un precio. 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. Esto solo se aplica a los precios fijos y al coste de respaldo. Los precios de Jadlog ya cubren todo el carrito.
Condiciones
Minimum weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 150. 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) alcanza este importe. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método cuando el carrito contiene un producto de cualquiera de estas clases de envío de WooCommerce.
Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío es gratuito. Déjalo vacío si no hay envío gratis.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade. Los precios de Jadlog son precios finales del transportista. Elige None si WooCommerce no debe añadir impuestos a ellos.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece Jadlog para los países de abajo aunque el método no esté añadido a ninguna zona de envío. En este modo se usa el servicio global Jadlog service.
Countries: los países de destino para este 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.
Avanzado
Debug log: registra cada petición y respuesta de Jadlog en WooCommerce > Status > Logs, origen vfd-jadlog. Los errores de la API siempre se registran, incluso con esta opción desactivada. El token, el CNPJ y la cuenta nunca se registran, y el CEP del cliente se acorta. Desactiva el registro cuando termines.
Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de Jadlog y los métodos de zona. Desactivar el plugin nunca borra los ajustes. Los precios en caché siempre se eliminan.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin un precio. El plugin comprueba primero las condiciones: peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si el subtotal del carrito alcanza Free shipping from, el envío es gratuito y no se envía ninguna petición de precio a Jadlog.
Para una dirección de entrega en Brasil con un CEP completo de 8 dígitos, el plugin envía a Jadlog el CEP de origen y de destino, el peso, tu CNPJ, la cuenta corriente, el contrato, el servicio, el tipo de seguro y el valor declarado del pedido, y muestra el precio devuelto en la moneda de tu tienda. Los carritos sin peso se cotizan como 0,1 kg. Si no hay precio en tiempo real (sin token, dirección fuera de Brasil, CEP incompleto, sin tipo de cambio a BRL, error de Jadlog), el plugin usa la tabla Price per country y después el Fallback cost. Si ninguno da un precio, el método se oculta para ese carrito.
Cada precio se guarda en caché durante 1 hora, así que el mismo carrito no genera una nueva petición. Una petición fallida se guarda en caché durante 10 minutos. Si Jadlog no responde, devuelve un error de servidor o rechaza el token, la API no se vuelve a llamar durante 10 minutos. El tiempo de espera de la API es de 10 segundos. El cliente nunca ve un error de la API. El motivo se escribe en el registro.
El método funciona en la finalización de compra clásica y en los bloques Carrito y Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.
El plugin solo calcula precios y muestra puntos Pickup. No crea envíos de Jadlog, no imprime etiquetas, no solicita recogidas, no cancela envíos ni rastrea paquetes. No muestra un mapa de los puntos Pickup y no pide a Jadlog cotizaciones internacionales. Para otros países, usa precios fijos.
Puntos Pickup
Un método con el servicio Pickup (40) solo se ofrece para direcciones en Brasil. Cuando el cliente ha introducido un CEP completo de 8 dígitos, el plugin pide a Jadlog los puntos Pickup activos más cercanos y ofrece hasta Points to show puntos. Cada punto es una opción de envío propia con su propio precio, por ejemplo "Jadlog Pickup: nombre del punto — dirección". El cliente elige un punto seleccionando la opción de envío, tanto en la finalización de compra clásica como en los bloques Carrito y Finalizar compra.
El precio hasta cada punto se pide a Jadlog. Si Jadlog no da precio para un punto, se usa el precio fijo, y un punto sin ningún precio se omite. Las listas de puntos se guardan en caché durante 12 horas.
Sin token de API, sin un CEP de 8 dígitos, cuando Jadlog no está disponible o cuando no hay puntos activos cerca, el método Pickup se oculta. Un pedido sin punto no se podría enviar.
Pedidos
La línea de envío del pedido conserva el servicio de Jadlog y, cuando Jadlog lo devolvió, el plazo de entrega en días hábiles. En un pedido Pickup, el nombre de la línea de envío contiene el nombre y la dirección del punto, y el pedido también guarda el nombre, la dirección y el ID del punto Pickup. Los ves debajo de la línea de envío en la pantalla de pedidos del administrador. El cliente ve el punto elegido en la página de confirmación del pedido y en los correos de pedido.
Registra el envío en el sistema de Jadlog tú mismo. El pedido muestra el servicio y el ID del punto Pickup que necesitas para ello.
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 Jadlog. 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 comprobar el estado de nuevo, 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. 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, Jadlog no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con 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 una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Jadlog 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 avisos de la parte superior de la página de ajustes, los límites de peso, Minimum order amount y Excluded shipping classes. Si el cliente aún no ha introducido un CEP completo de 8 dígitos, solo se pueden usar precios fijos, así que añade una fila en Price per country o un Fallback cost.
Solo se muestran precios fijos: activa el Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-jadlog. Muestra el motivo: no hay CNPJ o cuenta corriente, no hay CEP de origen, el CEP de destino está incompleto, no hay tipo de cambio a BRL o el mensaje de error de Jadlog.
HTTP 401 o 403 en el registro: Jadlog ha rechazado el token de la API. Compruébalo con tu franquicia de Jadlog. La API se pausa durante 10 minutos tras este error. Guardar los ajustes elimina la pausa, así que puedes volver a intentarlo enseguida.
Los puntos Pickup no aparecen: el método Pickup necesita el token de la API y un CEP completo de 8 dígitos en Brasil. Si Jadlog no tiene puntos activos cerca del CEP, el método se oculta. Revisa el registro para ver el motivo.
Los precios aparecen en reales en lugar de en mi moneda: introduce el BRL exchange rate (cuánto vale 1 BRL en la moneda de tu tienda).
Los precios parecen demasiado bajos o demasiado altos: rellena los pesos y las dimensiones de los productos. Los carritos sin peso se cotizan como 0,1 kg, y el peso volumétrico necesita las dimensiones.
Los precios parecen desactualizados tras un cambio: guarda la página de ajustes. Esto borra los precios de Jadlog y las listas de puntos Pickup 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 la dirección del sitio ha cambiado, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede conectar con el 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 los precios en caché y las listas de puntos Pickup. Para eliminar el plugin, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin y los precios 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 con el servicio de Jadlog y el punto Pickup.
Jadlog es una marca comercial de su respectivo titular. Este plugin no está afiliado a Jadlog ni cuenta con su respaldo.