VibeFox PostNord for OpenCart — Ayuda

Requisitos

OpenCart: 3.0.x (probado con la versión 3.0.5.0) o 4.0.2 y posteriores (probado con la versión 4.1.0.3).

PHP: 8.0 o posterior.

Clave API de PostNord (para el selector de puntos de servicio): crea una cuenta gratuita en developer.postnord.com, añade una aplicación y copia su clave API. Sin clave, el método de envío sigue funcionando, pero los clientes no pueden elegir un punto de servicio.

Contrato con PostNord: para enviar paquetes necesitas tu contrato habitual de cliente de PostNord, por ejemplo MyPack Collect o MyPack Home.

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_postnord-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_postnord.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 administrador, ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_postnord-oc3-(version).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no hace falta 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 y elige el tipo de extensión Shipping. Busca VibeFox PostNord y haz clic en Install (el botón verde +).

3. Haz clic en Edit (el botón del lápiz) para abrir la página de ajustes.

4. Introduce tu clave de licencia de VibeFox en el campo License key del bloque de licencia en la parte superior de la página Edit y haz clic en Activate (ver Clave de licencia).

5. Activa Enable/Disable (entrega a punto de servicio) y/o Home delivery, pega la API key de PostNord, elige el Agreement country, completa los Country prices o un Fallback cost (ver Configuración) y haz clic en Save.

OpenCart 4

1. En el administrador, ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_postnord.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 PostNord, 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 y los ajustes 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, ambas opciones están desactivadas hasta que activas una y guardas. Si vuelves a instalar la extensión después de desinstalarla, se usan de nuevo los ajustes de PostNord que conservaste.

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox PostNord > Edit. Las secciones aparecen a la izquierda. Un botón Save en la parte inferior guarda toda la página sin recargarla. Cada guardado también borra las listas de puntos de servicio en caché. Solo los usuarios administradores con permiso de modificación para esta extensión pueden guardar los ajustes.

Si un valor es incorrecto, no se guarda nada y la página muestra el motivo: un nombre vacío, de más de 64 caracteres o que contiene < > ; = # { }, un orden de clasificación que no es un número entero, un estado de impuesto o una zona geográfica no válidos, o un Min weight (kg) mayor que Max weight (kg). Un campo numérico con un valor que no es un número igual o mayor que 0 se guarda vacío, con un mensaje. Una celda de la tabla de precios que no es un número igual o mayor que 0 se guarda como 0, con un mensaje.

Encima de los ajustes, la página avisa cuando todavía no hay clave API, cuando todavía no hay ningún precio y cuando la tienda no tiene la unidad de peso "kg".

General

Las dos opciones de entrega se ofrecen en la zona geográfica definida en Availability, o para los países de Ignore shipping zones.

Enable/Disable: activa o desactiva la entrega de PostNord a un punto de servicio o a una taquilla de paquetes. El cliente elige el punto en la finalización de compra. Por defecto: desactivado.

Name: el nombre de la opción de punto de servicio en la finalización de compra, por ejemplo "PostNord MyPack Collect". Por defecto: PostNord. Obligatorio, hasta 64 caracteres, sin < > ; = # { }.

Home delivery: ofrece también la entrega a domicilio de PostNord, una segunda opción sin punto de servicio. Por defecto: desactivado.

Home delivery name: el nombre de la opción de entrega a domicilio en la finalización de compra, por ejemplo "PostNord MyPack Home". Por defecto: PostNord Home delivery. Mismas reglas que Name.

Sort order: la posición de PostNord entre los métodos de envío en la finalización de compra. Un número entero.

Tax status: None (the prices are final) (por defecto), o una clase de impuesto: OpenCart entonces añade el impuesto de envío de esa clase sobre los precios. Se aplica a ambas opciones.

API de PostNord (selector de puntos de servicio)

API key: la clave API de tu aplicación en developer.postnord.com. Se envía a PostNord solo desde tu servidor, nunca al navegador, y nunca se escribe en el registro. Después de guardar, el campo queda vacío y muestra Saved - leave empty to keep it. Introduce un valor nuevo solo si quieres cambiarla.

Remove the saved API key: márcala y haz clic en Save para eliminar la clave guardada.

Test mode: usa el entorno de prueba de PostNord (atapi2.postnord.com). Solo para claves emitidas para el entorno de prueba.

Agreement country: el país de tu contrato de cliente de PostNord: Suecia, Dinamarca, Noruega o Finlandia. Decide qué puntos de servicio se ofrecen. Same as the delivery country (por defecto) usa el país del cliente.

Precios

El título de la sección muestra la moneda predeterminada de tu tienda. Los precios están en esa moneda, sin impuestos, y son los mismos para ambas opciones. PostNord no tiene una API pública de precios, así que tú defines tus propios precios, normalmente los precios de tu contrato con PostNord. El orden es: umbral de envío gratuito, después la tabla por país y por último el coste alternativo.

Calculation type: Per order (por defecto) cobra el precio una sola vez. Per item (price x number of items) lo multiplica por el número de artículos del carrito.

Country prices: un precio por país de destino y peso del carrito. Haz clic en Add country para añadir una fila y en el botón × para eliminarla. Cada fila tiene una columna Price y columnas de peso: XS hasta 1 kg, S hasta 2 kg, M hasta 3 kg, L hasta 5 kg y XL por encima de 5 kg. Una columna de peso con 0 usa la columna Price, y un Price de 0 significa envío gratuito. El país * All other countries cubre todos los países sin fila propia. Decimales con coma o punto (9,99 o 9.99). Una fila nueva empieza como * All other countries con todos los precios en 0. Elige el país e introduce los precios antes de guardar, o elimina la fila. Una celda vacía se guarda como 0.

Fallback cost: se usa cuando la tabla de países no tiene fila para el destino ni fila *. Déjalo vacío para ocultar PostNord en esos países.

Free shipping from: el subtotal del carrito (productos que necesitan envío, después del cupón, sin impuestos) a partir del cual PostNord es gratuito. Se comprueba antes de la tabla de países, así que también se aplica a un país sin fila de precio. Déjalo vacío para no ofrecer nunca envío gratuito.

Disponibilidad

Min weight (kg): oculta PostNord cuando el carrito pesa menos. Los pesos de los productos se convierten desde su clase de peso. Por defecto: 0, lo que significa sin límite.

Max weight (kg): oculta PostNord cuando el carrito pesa más. Por defecto: 30. 0 significa sin límite. Comprueba el límite de peso de tu servicio de PostNord: las taquillas de paquetes aceptan menos que los puntos de servicio.

Minimum subtotal: muestra PostNord solo si el subtotal del carrito (productos que necesitan envío, después del cupón, sin impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.

Geo zone: ofrece PostNord solo para direcciones de esta zona geográfica. All zones (por defecto) significa sin límite. Las zonas geográficas se gestionan en System > Localisation > Geo Zones. No se usa mientras Ignore shipping zones esté activado.

Ignore shipping zones: cuando está activado, no se comprueba la zona geográfica y PostNord se ofrece para los países indicados abajo. Cuando está desactivado, se ofrece solo en la zona geográfica.

Countries (Ignore shipping zones): los países de destino para ese modo. Déjalo vacío para permitir todos los países. Este campo solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: escribe los cálculos de tarifas y las llamadas a la API en storage/logs/vfd_ptnd_debug.log.php. El archivo no se puede leer desde la web. Los errores de la API siempre se registran. La clave API nunca se registra. Desactiva el registro cuando termines. Cuando el archivo llega a 5 MB, se inicia uno nuevo.

Log: 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 de PostNord y el registro. Las listas de puntos de servicio en caché siempre se eliminan. Los puntos de servicio guardados en los pedidos siempre se conservan.

Importación / Exportación

Export: haz clic en Download JSON para guardar los ajustes como archivo JSON. La clave API no se exporta.

Import: pega el JSON exportado anteriormente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Los valores se comprueban igual que en un guardado normal. La clave API guardada se conserva.

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 cada opción de PostNord. Solo cuentan los productos con Requires Shipping en Yes: los demás no suman peso ni entran en el subtotal. La extensión comprueba la zona geográfica o la lista de países, el peso del carrito y el subtotal mínimo. 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 alternativo. Si no hay precio, la opción se oculta. El precio se calcula en tu moneda predeterminada y se muestra al cliente en su moneda, con el impuesto del Tax status seleccionado. El cálculo del precio nunca contacta con PostNord.

Para la opción de punto de servicio y una dirección de entrega en Suecia, Dinamarca, Noruega o Finlandia, tu servidor pide a la API Business Location de PostNord los 10 puntos de servicio más cercanos al código postal de entrega. Envía el país y el código postal de entrega y el país del contrato. El tiempo de espera de la API es de 10 segundos. Las listas se guardan en caché durante 6 horas por código postal, y las respuestas "sin puntos" durante 1 hora. Los errores de la API se guardan en caché durante 5 minutos, para que una caída de PostNord no ralentice cada actualización del pago. La caché se guarda en la tabla de base de datos propia de la extensión. El paso de entrega nunca espera a PostNord: si la lista aún no está en caché, se carga cuando el cliente selecciona la opción.

Para otros destinos, las opciones se pueden seguir ofreciendo con tus precios, sin selector. La opción de entrega a domicilio nunca muestra un selector.

La extensión no solicita precios en tiempo real de PostNord y no crea etiquetas de envío, no reserva envíos (EDI), no proporciona números de seguimiento ni envía correos de seguimiento. No hay vista de mapa. Para los envíos usa PostNord Portal, Skicka Direkt Business o una herramienta de etiquetas; esas herramientas necesitan el ID del punto de servicio guardado.

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 una opción de PostNord en la ventana Shipping method options. Los precios son los mismos que en OpenCart 3.

Puntos de recogida

Cuando la dirección de entrega está en Suecia, Dinamarca, Noruega o Finlandia, aparece una lista de PostNord service point debajo de la opción de punto de servicio, con los puntos más cercanos, agrupados por ciudad, cada uno con su dirección y distancia. Antes de introducir un código postal, el cliente ve "Introduce tu código postal para elegir un punto de servicio de PostNord." La elección se guarda de inmediato para el pago.

Cuando la lista está cargada, es obligatorio elegir un punto. Sin ninguno, Continue en el paso del método de entrega se detiene con "Selecciona un punto de servicio de PostNord." El punto elegido se comprueba en el servidor frente a la lista de PostNord para la dirección de entrega. Un punto elegido para otro código postal no se usa.

El selector nunca bloquea una venta. Si la lista no se puede cargar (todavía no hay clave API, la API de PostNord no funciona o no hay puntos cerca del código postal), el cliente ve una nota y aun así puede realizar el pedido. PostNord entonces entrega en el punto de servicio más cercano a la dirección.

Páginas de pedido, correos y factura: el punto se añade al método de envío del pedido, por ejemplo "PostNord: nombre, dirección (ID 12345)" (el nombre de la opción y después el punto). Si el texto superara los 128 caracteres, la dirección se omite (en OpenCart 4 no hay ese límite y la dirección siempre se conserva). Se muestra en todas partes donde OpenCart muestra el método de envío: el historial de pedidos del cliente, los correos del pedido, la factura y Sales > Orders. Un pedido sin punto conserva el nombre simple del método.

Página de pedido del administrador: en Sales > Orders, la página del pedido muestra un panel PostNord service point encima del historial, con el nombre, la dirección y el Service point ID. Si no se eligió ningún punto, indica "no seleccionado - PostNord entrega en el punto de servicio más cercano a la dirección de envío".

En OpenCart 4 la lista de puntos de servicio aparece en la ventana Shipping method options, debajo de la opción de punto de servicio, y se vuelve a cargar cada vez que se abre la ventana, porque la dirección puede cambiar en la finalización de compra de una sola página. El botón Continue de la ventana no continúa sin un punto de la lista, con el mismo mensaje. Si el cliente hace clic mientras la lista todavía se está cargando, la ventana espera a la lista sin mostrar ningún mensaje y después vuelve a hacer clic en Continue por sí sola. Una lista no disponible tampoco bloquea el pedido. 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 de servicio del pedido se actualiza con él.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox PostNord es el primero de la página Extensions > Extensions > Shipping > VibeFox PostNord > Edit, 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 están la línea Product: opencart-shipping-postnord 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 para 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, las opciones de envío de PostNord no se muestran a los clientes en la finalización de compra y no se calcula ningún precio de envío. Un usuario administrador que haya iniciado sesión en el administrador en el mismo navegador sigue viendo las opciones en la tienda, marcadas 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 las opciones se ocultan 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

PostNord no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable (o Home delivery) esté activado. Revisa la Geo zone o la lista de Countries cuando Ignore shipping zones está activado. Comprueba que haya un precio para el país (fila del país, fila * o Fallback cost), los límites de peso y el Minimum subtotal. Comprueba que los productos tengan Requires Shipping en Yes.

El selector indica que no se pueden cargar los puntos de servicio: comprueba la API key y el ajuste Test mode. Una clave de producción no funciona con el entorno de prueba, y viceversa. Activa el Debug log, recarga la finalización de compra y mira el campo Log en la página de la extensión. El pedido se puede realizar igualmente; PostNord entonces entrega en el punto de servicio más cercano.

Puntos de servicio inesperados: revisa el Agreement country. Decide qué puntos de servicio se ofrecen.

El envío sale gratis por error: revisa las Country prices con filas de Price en 0, sobre todo una fila * añadida con Add country y dejada sin completar, y revisa el Free shipping from.

Los puntos de servicio parecen desactualizados tras un cambio: haz clic en Save en la página de la extensión. Esto borra las listas en caché.

Los pesos de los productos parecen incorrectos: si la página de la extensión avisa de que la tienda no tiene la clase de peso "kg", revisa System > Localisation > Weight Classes. Los pesos de los productos se convierten según el nombre de la unidad de su clase, y las unidades desconocidas se leen como kg.

La página indica "Warning: You do not have permission to modify VibeFox PostNord!": tu grupo de usuarios del administrador puede solo ver los ajustes. Concede al grupo el permiso de modificación para extension/shipping/vfd_postnord (OpenCart 3) o extension/vfd_postnord/shipping/vfd_postnord (OpenCart 4) en System > Users > User Groups.

Para desarrolladores: la dirección de la API de PostNord se puede cambiar con el ajuste vfd_ptnd_api_url (para pruebas); no tiene campo en la página de ajustes.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox PostNord. La clave de licencia y el estado de la licencia de esta extensión se eliminan siempre. OpenCart siempre restablece el estado de la extensión, el Sort order, el Tax status y la Geo zone. Las listas de puntos de servicio en caché siempre se eliminan. Si Remove data on uninstall está activado, también se borran los ajustes de PostNord, el registro de depuración y los puntos de servicio de finalizaciones de compra que nunca se convirtieron en pedido. Si está desactivado, los demás ajustes se conservan y se usan de nuevo al volver a instalar la extensión. Los pedidos existentes conservan su método de envío, su coste y el punto de servicio guardado.

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 PostNord en la lista de extensiones instaladas y, después, en Delete (el botón rojo con forma de papelera) para eliminar el paquete subido.

PostNord es una marca comercial de su respectivo titular. Esta extensión no está afiliada ni respaldada por PostNord.