VibeFox Packeta for OpenCart — Ayuda
Requisitos
OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3), con la finalización de compra por defecto del tema predeterminado.
PHP: 8.0 o posterior.
Clave API de Packeta: la encontrarás 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 método 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 estar habilitados como países de tu tienda. Figuran en los datos estándar de OpenCart. Hungría no tiene regiones en OpenCart, así que el campo de región de la dirección queda vacío; esto no importa.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
La descarga es un único archivo zip con los paquetes de ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 vfd_packeta-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_packeta.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.
OpenCart 3
1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_packeta-oc3-(version).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no necesitas actualizar Extensions > Modifications. En lugar del Installer, puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.
2. Ve a Extensions > Extensions, elige el tipo de extensión Shipping, busca VibeFox Packeta y haz clic en Install (el botón verde +).
3. Haz clic en Edit (el botón con el lápiz) para abrir la página de configuración.
4. Pega tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Edit y haz clic en Activate (ver License key).
5. Introduce tu API key de Packeta y tus precios: al menos una fila de Country prices (por ejemplo * Default) o un Fallback cost. Activa Enable/Disable y haz clic en Save. La página muestra si Packeta ha aceptado la clave.
OpenCart 4
1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_packeta.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.
2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.
3. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox Packeta, haz clic en Install (el botón verde +) y después en Edit (el botón del lápiz).
4. Introduce la clave de licencia, la clave API y los precios como en los pasos 4 y 5 de OpenCart 3. La página de ajustes y sus campos son iguales en ambas versiones.
Tras la instalación el método está desactivado hasta que actives Enable/Disable y guardes. Si vuelves a instalar la extensión después de desinstalarla, se usan de nuevo los ajustes de Packeta que conservaste.
Configuración
Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox Packeta > Edit. Las secciones aparecen a la izquierda. Un único botón Save al final guarda toda la página sin recargarla. Solo los usuarios administradores con permiso de modificación para esta extensión pueden guardar los ajustes.
El método 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 advertencias sobre problemas: falta la clave API, falta un precio, hay países seleccionados fuera de la red de Packeta o una unidad de peso de la tienda que la extensión no reconoce. Las advertencias se actualizan después de cada guardado.
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, se mantiene el valor anterior de ese campo y los demás campos sí se guardan.
General
Enable/Disable: activa o desactiva Packeta en la finalización de compra. Por defecto: desactivado.
Name: el nombre del método de envío que ve el cliente. Por defecto: Packeta pickup point. Obligatorio, máximo 64 caracteres.
API key: tu clave API de Packeta de 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 realizarse, 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 (por defecto) 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: la clase de impuesto de OpenCart aplicada al precio del envío, o None (no tax on shipping) (por defecto).
Sort order: la posición de Packeta entre los métodos de envío de la finalización de compra. Un número entero.
Precios
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 (por defecto) cobra el precio una sola vez. Per item (price x quantity) lo multiplica por la cantidad de productos que requieren envío.
Country prices: un precio por país de destino y por peso del paquete. Haz clic en Add country para añadir una fila y en el botón × para eliminarla. Cada fila tiene un Price y columnas de peso: XS hasta 1 kg, S de 1 a 2 kg, M de 2 a 3 kg, L de 3 a 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 igual o mayor que 0, 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 ni fila * Default. Déjalo vacío para no ofrecer el método allí.
Free shipping from: el subtotal del carrito (después del cupón, sin impuestos) a partir del cual el envío con Packeta es gratuito. Se comprueba antes que la tabla de precios: a partir de este importe el envío es gratuito en todos los países de Packeta donde se ofrece el método, incluso en los que no tienen fila de país ni coste de reserva. Déjalo vacío para no ofrecer nunca envío gratuito.
Disponibilidad
Minimum weight (kg): oculta el método cuando el carrito pesa menos. Los pesos de los productos se convierten desde sus clases de peso de OpenCart. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 15. Los puntos de recogida y los Z-BOX de Packeta suelen admitir paquetes de hasta 15 kg; consulta tu contrato con Packeta. Vacío o 0 significa sin límite. Si el peso mínimo es mayor que el máximo, al guardar se rechaza y se mantienen los dos valores anteriores.
Minimum cart subtotal: ofrece el método solo cuando el subtotal del carrito (después del cupón, sin impuestos) alcanza este importe.
Geo zone: ofrece Packeta solo para direcciones de esta zona geográfica. All zones (por defecto) significa sin límite. No se comprueba cuando Ignore shipping zones está activado. Las zonas geográficas se gestionan en System > Localisation > Geo Zones.
Ignore shipping zones: cuando está activado, no se comprueba la zona geográfica y el método se ofrece para los países seleccionados abajo. Cuando está desactivado (por defecto), solo se ofrece en la zona geográfica indicada arriba.
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 storage/logs/vfd_pckt_debug.log.php. El archivo no se puede leer desde la web. No se registran datos personales de clientes ni la clave API. Los errores y las comprobaciones fallidas de la clave API siempre se registran. Desactiva el registro cuando termines. Cuando el archivo llega a 5 MB, se traslada a vfd_pckt_debug.old.log.php y se inicia un registro nuevo.
Log (last lines): muestra el tamaño y las últimas entradas del registro de depuración. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: cuando está activado, al desinstalar la extensión se eliminan los ajustes y el registro. Cuando está desactivado (por defecto), los ajustes se conservan para una reinstalación. El punto de recogida guardado en los pedidos se conserva siempre.
Importación / Exportación
Exportar: haz clic en Download JSON para guardar los ajustes como archivo JSON, incluida la clave API, que es pública.
Importar: pega el JSON exportado previamente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Los valores se comprueban igual que en un guardado normal.
Cómo funciona en la finalización de compra
Cuando OpenCart muestra los métodos de envío, pide a la extensión el precio de Packeta. Si hay una Geo zone definida (y Ignore shipping zones está desactivado) y la dirección queda fuera de ella, Packeta no se ofrece. Solo cuentan los productos con Requires Shipping en Yes: los demás productos no añaden peso y no se incluyen en el subtotal. La extensión comprueba las condiciones: país de entrega dentro de la red de Packeta, clave API, la lista de países en el modo de zonas ignoradas, peso del carrito y subtotal mínimo del carrito. El subtotal es el precio de los productos que necesitan envío, después del descuento del cupón y sin impuestos. Los certificados regalo, los puntos de recompensa y el crédito de la tienda no se tienen en cuenta. Si se aplica el envío gratuito, el precio es 0. En caso contrario, el precio sale de la tabla de países y, después, del coste de reserva. Si no hay precio, el método se oculta. El precio se muestra al cliente en su moneda, con el impuesto de la Tax status seleccionada.
Debajo de la opción de Packeta del paso de método de envío hay un botón Choose pickup point. Abre el widget oficial de Packeta en el navegador del cliente 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 método, y el botón cambia a Change pickup point. El punto se guarda para la sesión de compra y se mantiene al recargar la página. Un punto elegido para otro país no se usa cuando la dirección de entrega cambia a otro país.
Tu servidor no pide nada a Packeta durante la compra. El script del widget se carga desde widget.packeta.com, solo en la página de finalización de compra. 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 "The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method."
Las tarifas de Packeta no se consultan en tiempo real; proceden de tu tabla. La extensión 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 transportistas asociados de serie. Entrega el ID del punto de recogida del pedido a Packeta de la forma habitual, por ejemplo mediante importación en client.packeta.com. El botón de punto de recogida funciona con la finalización de compra estándar de OpenCart del tema predeterminado.
En OpenCart 4 el cliente hace clic en Choose en el bloque del método de envío de la página de finalización de compra y elige Packeta en la ventana Shipping method options. El botón Choose pickup point y el punto elegido aparecen en esa ventana, debajo de la opción de Packeta, y el widget de Packeta se abre encima. Los precios son los mismos que en OpenCart 3.
Puntos de recogida
El punto de recogida es obligatorio. Si el cliente hace clic en Continue en el paso de método de envío sin elegir uno, el paso no se completa y el cliente ve el mensaje "Please choose a Packeta pickup point." Si el punto elegido está en un país distinto al de la dirección de entrega, el cliente ve el mensaje "The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again." La extensión no verifica el ID del punto con Packeta; solo comprueba que se ha elegido un punto y que su país coincide.
El punto se asocia al pedido cuando este se crea:
Método de envío del pedido: el nombre y la dirección del punto se añaden al nombre del método, por ejemplo Packeta pickup point: <point> (hasta 128 caracteres). El cliente lo ve en el historial del pedido y en el correo electrónico del pedido, y se imprime en la factura. La página de confirmación del pedido de OpenCart no muestra el método de envío.
Página de pedido del administrador: abre el pedido en Sales > Orders. Un panel de Packeta pickup point muestra el nombre y la dirección, el Pickup point ID y el país. Si un pedido de Packeta no tiene punto, el panel indica "No pickup point was selected for this order."
En OpenCart 4 el botón Continue de la ventana Shipping method options no continúa sin un punto, con los mismos mensajes. OpenCart 4 mantiene un único pedido para la finalización de compra y lo actualiza cada vez que el cliente vuelve a confirmar, y el punto del pedido se actualiza con él. El panel Packeta pickup point de la página del pedido del administrador se muestra encima de la sección History.
El punto se guarda en la tabla propia de la extensión vfd_pckt_point (sesión de compra, pedido, ID del punto, nombre y dirección, país).
Clave de licencia
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Packeta es el primero de Extensions > Extensions > Shipping > VibeFox Packeta > Edit, encima de los ajustes. Pega 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 comprobar el estado de nuevo, Change key para introducir otra clave y Remove key para quitar la clave de esta tienda. Debajo están la línea Product: opencart-shipping-packeta y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify de la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del administrador (se incluyen inglés y ruso).
Si no se acepta la clave, 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. Tras cambiar la dirección de la tienda, o tras liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no responde, la extensión sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: la dirección de la tienda de la configuración de OpenCart. 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 método de envío de Packeta no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. Un usuario administrador que haya iniciado sesión en el administrador en el mismo navegador sigue viendo el método en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que sin una clave activa el método se oculta a todos. Tras abrir una vez la página Edit, aparece un recordatorio en el Dashboard del administrador. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente cuando abres el Dashboard del administrador o la página Edit: una vez al día durante los primeros 14 días tras introducir la clave, y después una vez por semana. No hace falta ninguna tarea cron. Desinstalar la extensión 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 la API key está introducida y que el país de entrega 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 de subtotal, y Geo zone (o bien Ignore shipping zones y sus países). Comprueba que los productos tienen Requires Shipping en Yes. La página de configuración muestra los problemas 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 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.
El envío es gratuito por error: revisa Country prices por si hay 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 advierte sobre la unidad de peso de la tienda, usa clases de peso con la unidad kg, g, lb u oz y define la clase de peso predeterminada en System > Settings, pestaña Local. Las demás unidades se leen como kilogramos.
La página muestra "Warning: You do not have permission to modify VibeFox Packeta!": tu grupo de usuarios administradores solo puede ver los ajustes. Da al grupo el permiso de modificación para extension/shipping/vfd_packeta (OpenCart 3) o extension/vfd_packeta/shipping/vfd_packeta (OpenCart 4) en System > Users > User Groups.
Para desarrolladores: otras extensiones pueden añadir países, pasar opciones como los ID de transportista al widget, cambiar la URL del script del widget o su idioma con los eventos de OpenCart vfd_packeta/countries, vfd_packeta/widget_options, vfd_packeta/widget_url y vfd_packeta/widget_language (disparadores con el prefijo catalog/, por ejemplo catalog/vfd_packeta/widget_options).
Desinstalación
Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox Packeta. La clave de licencia y el estado de la licencia de esta extensión se eliminan siempre. OpenCart siempre restablece Enable/Disable, Sort order, Tax status y Geo zone. La comprobación guardada de la clave API siempre se elimina, y el botón de punto de recogida y el panel del pedido dejan de mostrarse. Si Remove data on uninstall está activado, se borran los ajustes, el registro y los puntos de recogida de las compras que nunca se convirtieron en pedidos. Si está desactivado, los demás ajustes se conservan y se vuelven a usar al reinstalar la extensión. Los pedidos existentes conservan siempre el punto de recogida guardado y el punto en su método de envío.
En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer tras la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox Packeta en la lista de extensiones instaladas y, después, en Delete (el botón rojo con forma de papelera) para eliminar el paquete subido.
Packeta es una marca comercial de su respectivo titular. Esta extensión no está afiliada a Packeta ni cuenta con su respaldo.