VibeFox Packeta 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.
Clave API de Packeta: la encuentras en la sección de cliente de Packeta (client.packeta.com), en Client support. Tiene 16 letras y dígitos. El widget la necesita para abrirse en la finalización de compra, así que el método solo se muestra a los clientes después de introducir la clave API.
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_packeta a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Packeta, 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 tu API key de Packeta y tus precios: al menos una fila de Country prices (por ejemplo * Default) o un Fallback cost. Guarda. La página indica si Packeta ha aceptado la clave.
6. Añade VibeFox Packeta a tus zonas de envío de la República Checa, Eslovaquia, Hungría o Rumanía en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Packeta. 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 que ven los clientes en esta zona. Déjalo vacío para usar el Name global.
El método solo se ofrece para los países de la red de puntos de recogida propia de Packeta: CZ, SK, HU y RO. Encima de los ajustes, la página muestra el resultado de la comprobación de la clave API y avisos de problemas, por ejemplo falta la clave API, falta un precio o hay países seleccionados fuera de la red de Packeta.
Todos los precios y límites admiten coma o punto como separador decimal (4,99 o 4.99). Un número no válido se rechaza con un mensaje y se mantiene el valor anterior.
General
Enable/Disable: activa o desactiva el método en todas las zonas a la vez.
Name: el nombre del método de envío que ve el cliente. Una zona puede sustituirlo por su propio Title. Predeterminado: Packeta pickup point.
API key: tu clave API de Packeta desde client.packeta.com > Client support. También puedes pegar la contraseña de API de 32 caracteres: solo se guardan sus primeros 16 caracteres, que son la clave API. La clave API es pública: se envía al navegador del cliente para abrir el widget. Al guardar una clave nueva, se comprueba con el feed de transportistas de Packeta, y la página muestra Packeta API key verified o que Packeta la ha rechazado. Si la comprobación no puede ejecutarse, la clave se guarda y se vuelve a comprobar la próxima vez que guardes.
Widget language: el idioma del widget de puntos de recogida. Store / visitor language (predeterminado) sigue el idioma de la página. También puedes fijarlo en checo, eslovaco, húngaro, rumano, inglés, alemán, polaco o ucraniano.
Pickup point types: qué puntos de Packeta ofrece el widget.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío; None no lo añade.
Precios
Packeta no tiene una API pública de tarifas. Los precios salen de esta tabla y se introducen en la moneda de la tienda.
Calculation type: Per order cobra el precio una vez. Per item (price x quantity) lo multiplica por el número de artículos enviables del carrito.
Country prices: un precio por país de destino y peso del paquete. Haz clic en + Add country para añadir una fila, y en la cruz para eliminar una. Cada fila tiene un Price y columnas de peso: XS hasta 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg y XL más de 5 kg. Si una columna de peso se deja en 0, se usa la columna Price. La fila * Default se usa para los países sin fila propia. Una fila nueva empieza como * Default con todos los precios en 0, lo que significa envío gratis. Elige el país e introduce los precios antes de guardar, o elimina la fila. Si el mismo país aparece en dos filas, al guardar solo se conserva la primera.
Fallback cost: se usa cuando la tabla de países no tiene fila para el destino y no hay fila * Default. Déjalo vacío para no ofrecer el método allí.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío con Packeta es gratis. Solo se aplica donde hay un precio: una fila de país, la fila * Default o el coste alternativo. Déjalo vacío para no ofrecer nunca envío gratis.
Disponibilidad
Minimum weight (kg): oculta el método cuando el carrito pesa menos. El peso del carrito se convierte desde la unidad de peso de tu tienda. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Predeterminado: 15. Los puntos de recogida y Z-BOX de Packeta suelen admitir paquetes de hasta 15 kg; consulta tu contrato con Packeta. Vacío o 0 significa sin límite.
Minimum cart subtotal: ofrece el método solo cuando el subtotal del carrito (después de descuentos, sin impuestos) alcanza este importe.
Excluded shipping classes: oculta el método cuando el carrito contiene un producto de alguna de estas clases de envío de WooCommerce.
Ignore shipping zones: cuando está activado, el método se ofrece para los países seleccionados abajo, aunque no esté añadido a la zona de envío correspondiente. Cuando está desactivado, solo se ofrece en las zonas a las que se ha añadido.
Countries (ignore zones mode): los países de destino para ese modo. Déjalo vacío para usar todos los países de Packeta. Los países fuera de la red de puntos de recogida de Packeta se omiten. Este campo solo se usa cuando Ignore shipping zones está activado.
Avanzado
Debug log: escribe los cálculos de tarifas y las elecciones de puntos de recogida en WooCommerce > Status > Logs (origen "vfd-packeta"). No se registran datos personales de los clientes ni la clave API. Las comprobaciones fallidas de la clave API siempre se registran. Desactiva el registro cuando termines.
Remove data on uninstall: cuando está activado, al eliminar el plugin se borran los ajustes y las instancias de zona de este método. Desactivar el plugin nunca borra nada. El punto de recogida guardado en los pedidos siempre se conserva.
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 las condiciones: país de entrega en la red de Packeta, clave API, peso del carrito, subtotal mínimo del carrito y clases de envío excluidas. El precio sale de la tabla de países y, después, del coste alternativo. Si no hay precio, el método se oculta. Si se aplica el envío gratis, el cliente ve el método sin coste.
Cuando el cliente selecciona el método de Packeta, aparece debajo un botón Choose pickup point. Abre en el navegador del cliente el widget oficial de Packeta con el país de destino, el peso del carrito, los tipos de punto elegidos y el idioma del widget. Después de que el cliente elija un punto, su nombre y dirección se muestran debajo del método, y el botón cambia a Change pickup point. La elección se recuerda en la sesión del cliente cuando la finalización de compra se actualiza o la página se recarga.
Tu servidor no solicita nada a Packeta durante la finalización de compra. El script del widget se carga desde widget.packeta.com. Si está bloqueado (por un bloqueador de anuncios o de privacidad, una política de seguridad de contenido o una caída de Packeta), el cliente ve el mensaje "The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method."
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).
Los precios de Packeta no se solicitan en tiempo real; salen de tu tabla. El plugin no crea envíos de Packeta, no imprime etiquetas ni hace seguimiento de paquetes, y no ofrece entrega a domicilio ni puntos de recogida de otros transportistas de serie. Entrega el ID del punto de recogida del pedido a Packeta como lo haces habitualmente, por ejemplo mediante importación en client.packeta.com.
Puntos de recogida
El punto de recogida es obligatorio. Si el cliente hace el pedido sin elegir uno, la finalización de compra se detiene con "Please choose a Packeta pickup point." Si el punto elegido está en un país distinto al de la dirección de envío, la finalización de compra se detiene con "The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again." Ambas comprobaciones se hacen en el servidor, tanto en la finalización de compra clásica como en la de bloques. El plugin no verifica el ID del punto con Packeta; solo comprueba que se eligió un punto y que su país coincide.
El punto se guarda con el pedido cuando se crea:
Pantalla de pedido del administrador: Packeta pickup point con el nombre, la dirección, Pickup point ID y el país, debajo de la dirección de envío. Si un pedido de Packeta no tiene punto, la pantalla indica "No pickup point was selected for this order."
Página de confirmación y vista del pedido: Packeta pickup point: con el nombre y la dirección.
Correos electrónicos del pedido: el nombre y la dirección del punto en los correos HTML y de texto plano. Los correos del administrador también incluyen el Pickup point ID.
En la base de datos, el punto se guarda en los metadatos del pedido _vfd_pckt_point_id, _vfd_pckt_point_name (nombre y dirección) y _vfd_pckt_point_country.
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 Packeta. 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. 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, Packeta no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión 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 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
Packeta no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que se ha introducido la API key y que el país de destino es CZ, SK, HU o RO. Comprueba que hay un precio para el país (fila de país, fila * Default o Fallback cost), los límites de peso y subtotal, Excluded shipping classes, y que el método está añadido a la zona correspondiente (o que Ignore shipping zones está activado). La página de ajustes muestra arriba los problemas de configuración. Activa Debug log para ver el motivo en WooCommerce > Status > Logs.
Packeta rechazó la clave API: copia de nuevo la clave API desde client.packeta.com > Client support y guarda. Hasta entonces, el widget no puede abrirse en la finalización de compra.
El widget no se abre: el script de Packeta está bloqueado por un bloqueador de anuncios o de privacidad, por una política de seguridad de contenido o por una caída de Packeta. Permite widget.packeta.com en tu política de seguridad de contenido. Los desarrolladores pueden cambiar la URL del script con el filtro vfd_pckt_widget_url.
El envío sale gratis por error: revisa Country prices en busca de filas con un Price de 0, sobre todo una fila * Default añadida con + Add country y sin rellenar.
Otros países o transportistas: de serie, el método funciona para CZ, SK, HU y RO. Los desarrolladores pueden añadir países con el filtro vfd_pckt_countries y pasar los ID de transportista al widget con el filtro vfd_pckt_widget_options.
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 para 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 datos. 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, junto con la comprobación de clave API guardada. 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 y el punto de recogida guardado.
Packeta es una marca comercial de su respectivo titular. Este plugin no está afiliado ni respaldado por Packeta.