VibeFox Packeta for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo se niega a instalarse en versiones anteriores de PHP.
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, por lo que el transportista solo se muestra a los clientes después de introducir la clave API.
Países: la República Checa, Eslovaquia, Hungría o Rumanía deben ser países activos de tu tienda, en una zona a la que esté vinculado el transportista.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
1. En el back office ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca VibeFox Packeta más tarde en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en License key del bloque de licencia de la parte superior de la página de configuración y haz clic en Activate (consulta Clave de licencia).
4. Introduce tu API key de Packeta y tus precios: al menos una fila de Country prices (por ejemplo * Default) o un Fallback cost. Haz clic en Save. La página muestra si Packeta ha aceptado la clave.
Al instalar el módulo se crea el transportista Packeta pickup point con el texto de plazo de entrega Packeta pickup point or Z-BOX. Queda vinculado a las zonas de la República Checa, Eslovaquia, Hungría y Rumanía, y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el plazo de entrega y el logotipo en Shipping > Carriers. No definas precios allí: el precio siempre procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Packeta > Configure. Cada sección tiene su propio botón Save, que guarda toda la página.
El transportista solo se ofrece para los países de la red propia de puntos de recogida 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: falta la clave API, falta un precio, hay países seleccionados fuera de la red de Packeta, falta el transportista o la unidad de peso de la tienda no es una que el módulo reconozca.
Todos los precios y límites aceptan la coma o el punto como separador decimal (4,99 o 4.99). Un número no válido o negativo se rechaza con un mensaje y se mantiene el valor anterior.
General
Enable/Disable: activa o desactiva Packeta en la finalización de compra.
Name: el nombre del transportista que ve el cliente. También es el nombre del transportista en Shipping > Carriers. Predeterminado: Packeta pickup point. Obligatorio, máximo 64 caracteres.
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: las reglas de impuestos que se aplican al precio del envío. None (no tax on shipping) o Taxable con uno de tus grupos de reglas de impuestos. La elección se guarda en el transportista.
Prices
Packeta no tiene una API pública de tarifas. Los precios proceden de esta tabla y se introducen en la moneda predeterminada de tu tienda, sin impuestos. Los clientes que paguen en otra moneda ven el precio convertido.
Calculation type: Per order aplica el precio una sola vez. Per item (price x quantity) lo multiplica por el número de artículos físicos 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 el icono de cruz para eliminar una. Cada fila tiene un Price y columnas de peso: XS hasta 1 kg, S de 1–2 kg, M de 2–3 kg, L de 3–5 kg y XL por encima de 5 kg. Una columna de peso que se deja en 0 usa la columna Price. La fila * Default se usa para los países que no tienen fila propia. Una fila nueva empieza como * Default con todos los precios en 0, lo que significa envío gratuito. Elige el país e introduce los precios antes de guardar, o elimina la fila. Si el mismo país (o * Default) aparece en dos filas, al guardar solo se conserva la primera. Si un valor de la tabla no es un número válido, la tabla no se guarda y la página indica los valores incorrectos.
Fallback cost: se usa cuando la tabla de países no tiene fila para el destino y no hay una fila * Default. Déjalo vacío para no ofrecer el transportista allí.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío de Packeta es gratuito. Se comprueba antes que la tabla de precios: desde este importe el envío es gratuito en todos los países de Packeta donde se ofrece el transportista, incluso en los que no tienen fila de país ni coste alternativo. Déjalo vacío para no ofrecer nunca envío gratuito.
Availability
Minimum weight (kg): oculta el transportista 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 transportista cuando el carrito pesa más. Predeterminado: 15. Los puntos de recogida y los Z-BOX de Packeta suelen aceptar paquetes de hasta 15 kg; revisa tu contrato con Packeta. Vacío o 0 significa sin límite. Un peso mínimo mayor que el máximo se rechaza al guardar, y se mantienen los dos valores anteriores.
Minimum cart subtotal: ofrece el transportista solo cuando el subtotal del carrito (después de descuentos, sin impuestos) alcance este importe.
Ignore shipping zones: cuando está activado, el transportista se vincula a todas las zonas y se ofrece para los países seleccionados abajo. Las zonas creadas después se vinculan de inmediato. Al desactivarlo, el transportista recupera las zonas que tenía antes. Cuando está desactivado, solo se ofrece en las zonas asignadas al transportista en Shipping > Carriers.
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. Mantén pulsada la tecla Ctrl y haz clic para seleccionar varios. 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 modules/vfd_packeta/logs/. El archivo no se puede abrir desde la web. No se registran datos personales de los clientes ni la clave API. Los errores y las comprobaciones fallidas de la clave API siempre se registran. Desactiva el registro cuando termines.
Log (last lines): muestra las últimas entradas del registro de depuración. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: cuando está activado, al desinstalar el módulo se eliminan los ajustes y el registro. El punto de recogida guardado en los pedidos siempre se conserva.
Cómo funciona en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de Packeta. Solo cuentan los productos físicos: los productos virtuales no añaden peso y no se incluyen en el subtotal. El módulo comprueba las condiciones: país de entrega en la red de Packeta, clave API, lista de países en el modo de ignorar zonas, peso del carrito y subtotal mínimo del carrito. Si se aplica el envío gratuito, el precio es 0. Si no, el precio sale de la tabla de países y, después, del coste alternativo. Si no hay precio, el transportista se oculta.
Cuando el cliente selecciona el transportista 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. Cuando el cliente elige un punto, su nombre y su dirección se muestran debajo del transportista, y el botón cambia a Change pickup point. El punto se guarda con el carrito y se mantiene al recargar la página. Un punto elegido para otro país se descarta cuando cambia la dirección de entrega.
Tu servidor no solicita nada a Packeta durante la finalización de compra. El script del widget se carga desde widget.packeta.com. Si se bloquea (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: «No se pudo cargar el widget de puntos de recogida de Packeta. Recarga la página o elige otro método de envío.»
Si editas el transportista en Shipping > Carriers después de que tenga pedidos, PrestaShop lo guarda como una nueva versión del transportista. El módulo sigue la nueva versión automáticamente.
Los precios de Packeta no se consultan en tiempo real; proceden de tu tabla. El módulo no crea envíos de Packeta, no imprime etiquetas ni hace el seguimiento de paquetes, y de serie no ofrece entrega a domicilio ni puntos de recogida de otros transportistas. Entrega el ID del punto de recogida del pedido a Packeta de la forma habitual, por ejemplo mediante importación en client.packeta.com.
Puntos de recogida
El punto de recogida es obligatorio. Si el cliente hace clic en Continue en el paso de envío sin elegir uno, el paso no se completa y el cliente ve el mensaje: «Elige un punto de recogida de Packeta.» Si el punto elegido está en un país distinto al de la dirección de entrega, el cliente ve el mensaje: «El punto de recogida de Packeta seleccionado no está en tu país de envío. Elige de nuevo un punto de recogida.» El módulo no verifica el ID del punto con Packeta; comprueba que se haya elegido un punto y que su país coincida.
El punto se asocia al pedido en el momento de crearlo:
Página de pedido en el back office: un bloque Packeta pickup point con el nombre, la dirección, el Pickup point ID y el país. Si un pedido de Packeta no tiene punto, el bloque dice: «No se ha seleccionado ningún punto de recogida para este pedido.»
Páginas de confirmación y de detalle 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 se añaden al transportista en el correo de confirmación del pedido. El correo de nuevo pedido para el comerciante también incluye el Pickup point ID.
El punto se guarda en la tabla del módulo vfd_pckt_point (carrito, pedido, ID del punto, nombre y dirección, país).
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Packeta es el primer bloque de Modules > Module Manager > VibeFox Packeta > Configure, por encima de los ajustes. Introduce la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-packeta y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure para el módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede acceder al servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, el transportista de Packeta no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un aviso en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave y, después, una vez a la semana. No se necesita ninguna tarea cron. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
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 haya introducido la API key y que el país de entrega sea CZ, SK, HU o RO. Comprueba que haya un precio para el país (fila del país, fila * Default o Fallback cost), los límites de peso y de subtotal, y que el transportista cubra la zona del país del cliente y el grupo del cliente en Shipping > Carriers (o que Ignore shipping zones esté activado). Los productos también se pueden limitar a determinados transportistas en la página del producto. La página de ajustes muestra los problemas de configuración en la parte superior. Activa Debug log para ver el motivo en Log (last lines).
Packeta ha rechazado la clave API: copia de nuevo la clave API desde client.packeta.com > Client support y guarda. Hasta entonces, el widget no se puede abrir 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 hook actionVfdPcktWidgetUrl.
El envío es gratuito 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, y revisa Free shipping from.
Los límites de peso o las columnas de peso parecen incorrectos: si la página avisa sobre la unidad de peso de la tienda, configura kg, g, lb u oz en International > Localization (Local units). Las demás unidades se leen como kilogramos.
Otros países o transportistas: de serie, el transportista funciona para CZ, SK, HU y RO. Los desarrolladores pueden añadir países con el hook actionVfdPcktCountries y pasar los ID de los transportistas al widget con el hook actionVfdPcktWidgetOptions.
La página indica que falta el transportista de Packeta: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Packeta y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. El transportista de Packeta siempre se elimina (los pedidos conservan su transportista), junto con el resultado guardado de la comprobación de la clave API. Si Remove data on uninstall está activado, se eliminan los ajustes, el registro y los puntos de recogida de los carritos que nunca se convirtieron en pedidos. Si está desactivado, los ajustes se conservan para una reinstalación, que vuelve a crear el transportista. Los pedidos existentes siempre conservan el punto de recogida guardado.
Packeta es una marca comercial de su respectivo propietario. Este módulo no está afiliado a Packeta ni cuenta con su respaldo.