VibeFox SmartPost 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, con la extensión SimpleXML (incluida en la mayoría de las instalaciones de PHP).
SmartPost: no se necesita cuenta de API ni clave. La lista de puntos de recogida procede de la lista abierta de lugares de SmartPost. SmartPost no tiene una API pública de precios, así que introduces tus propias tarifas (de contrato). Crea los envíos en tu cuenta empresarial de SmartPost (SmartPosti).
Países: los puntos de recogida de SmartPost existen en Estonia, Letonia, Lituania y Finlandia. Para otros países de destino el método no se muestra.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave sirve para un solo 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_smartpost a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox SmartPost, 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. Revisa la tabla de precios (los precios por defecto ya están rellenados), los tamaños de caja y el estado de los puntos de recogida en la parte superior de la página.
6. Añade VibeFox SmartPost a la zona o zonas con Estonia, Letonia, Lituania y/o Finlandia en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige los países.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox SmartPost. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene un solo campo:
Title (zone): el nombre que ven los clientes en esta zona. Déjalo vacío para usar el Method title general.
En la parte superior de la página, los avisos muestran los problemas y el estado de los puntos de recogida. Aparece un aviso rojo cuando no hay ningún precio definido, porque entonces el método no se muestra en la finalización de compra. El bloque Pickup points available at checkout muestra, para cada país, cuántos puntos de recogida hay y en cuántas ciudades están disponibles. También indica cuándo se usa una copia guardada de la lista porque la lista de SmartPost no está disponible en ese momento, cuándo no se ha podido cargar un país y cuándo un país no tiene precios. El botón Refresh pickup point lists now vuelve a descargar las listas y muestra los nuevos números.
General
Enable/Disable: activa o desactiva SmartPost en todas las zonas a la vez.
Method title: el nombre del método de envío que ven los clientes. El Title de un método de zona lo sustituye. Por defecto: SmartPost parcel locker.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade.
Prices (en la moneda de tu tienda; los decimales pueden escribirse como 3.50 o 3,50)
Price table: una fila por cada país (Estonia, Letonia, Lituania, Finlandia) con un precio para cada tamaño de caja S, M, L y XL, y una columna Free from. 0 significa gratis. Una celda vacía significa que ese tamaño de caja no se ofrece: el método se oculta cuando el paquete necesita esa caja. Un país con todas las celdas vacías no recibe servicio. Free from es el total del carrito a partir del cual SmartPost es gratis en ese país; déjala vacía si no hay envío gratuito. Los precios que no son números se notifican tras guardar y se dejan vacíos. Precios por defecto: Estonia 3.50, Letonia 4.00, Lituania 4.00, Finlandia 5.00 para todas las cajas.
Box sizes (cm): el tamaño interior de cada caja, con el lado más pequeño primero (Side 1 (smallest), Side 2, Side 3 (largest)). Los lados del producto se ordenan igual y se comparan uno junto a otro, y se usa la caja más pequeña en la que quepa. Los productos sin dimensiones caben en la caja S. Un paquete que no cabe en ninguna caja oculta el método. Las dimensiones del producto se convierten desde la unidad de dimensiones de la tienda. Valores por defecto: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Los tamaños que no son números positivos se notifican tras guardar y no se cambian.
Calculation: cómo se calcula el precio.
Availability
Minimum weight (kg): oculta el método cuando el carrito pesa menos. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 25. 0 significa sin límite.
Minimum cart total: muestra el método solo a partir de este total del carrito. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método cuando el carrito contiene productos de estas clases de envío de WooCommerce.
Ignore shipping zones: ofrece SmartPost para los países indicados abajo sin añadirlo a una zona. Cuando está desactivado, los países se definen por las zonas de envío donde se ha añadido el método. Se recomienda esta opción.
Countries (without zones): los países de destino para ese modo, de Estonia, Letonia, Lituania y Finlandia. Este campo solo se usa cuando Ignore shipping zones está activado. Déjalo vacío para ofrecer el método en los cuatro países.
Pickup points
Pickup point types: qué puntos de SmartPost puede elegir el cliente: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) y Posti post offices (Finland). Déjalo vacío para ofrecer taquillas, cajas y tiendas de paquetes (por defecto). Qué tipos existen depende del país: por ejemplo, Letonia solo tiene cajas de paquetes, y las oficinas de correos solo existen en Finlandia.
City order: si está activado, las ciudades grandes aparecen primero (Tallinn, Riga, Vilnius, Helsinki y otras ciudades grandes), y después el resto por orden alfabético. Si está desactivado, todas las ciudades aparecen por orden alfabético.
Advanced
Debug log: registra los detalles del cálculo de precios y de la lista de puntos de recogida en WooCommerce > Status > Logs (origen vfd-smartpost). Los errores, como una lista de puntos de recogida no disponible, siempre se registran. No se registran datos de clientes.
Remove data on uninstall: si está activado, al eliminar el plugin se borran los ajustes, los métodos de zona y los puntos de recogida en caché. Desactivar el plugin nunca borra los ajustes. El punto de recogida guardado en los pedidos 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 solo funciona para Estonia, Letonia, Lituania y Finlandia. Comprueba el peso del carrito, el importe mínimo del carrito y las clases de envío excluidas, busca la caja del paquete y toma su precio de la fila del país de envío. Si la caja no tiene precio, o si el paquete no cabe en ninguna caja, el método se oculta. Si el país no tiene puntos de recogida (la lista no se pudo cargar y no hay copia guardada), el método también se oculta, para que el cliente nunca vea una finalización de compra que no se puede completar. Si el total del carrito alcanza el Free from del país, el precio es 0.
La lista de puntos de recogida de cada país se guarda en caché durante 24 horas, y se conserva una copia de la última lista correcta. Una descarga fallida se recuerda durante 15 minutos, así que la finalización de compra no espera a la lista en cada actualización. El tiempo máximo de descarga es de 15 segundos. Las distintas grafías de una misma ciudad (por ejemplo Riga y Rīga) se muestran como una sola ciudad.
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 están en la moneda de tu tienda. El plugin no convierte monedas.
El plugin no consulta los precios de SmartPost, no crea envíos, no imprime etiquetas, no llama a un mensajero ni rastrea paquetes. Crea los envíos en tu cuenta empresarial de SmartPost (SmartPosti). La entrega a domicilio por mensajero no forma parte de este método, y no hay vista de mapa.
Puntos de recogida
Cuando el cliente selecciona SmartPost, aparecen dos listas debajo del método: -- Select city -- y -- Select pickup point --. Las listas siempre corresponden al país de envío. En la finalización de compra clásica es el país de la dirección de envío, o el de la dirección de facturación cuando el pedido no se envía a una dirección distinta; las listas se recalculan cuando cambia el país. En la finalización de compra por bloques, las listas siguen el país de la dirección de envío. La ciudad de la dirección de envío se preselecciona cuando coincide con una ciudad de la lista. Cada punto se muestra con su nombre y su dirección. La elección se recuerda durante la finalización de compra, así que no se pierde cuando esta se actualiza.
El punto es obligatorio. En la finalización de compra clásica el cliente ve Please select a SmartPost pickup point in the shipping country. En la finalización de compra por bloques, Place order queda bloqueado hasta que se elige un punto. En ambas, el servidor vuelve a comprobar el punto con la lista del país de envío, así que se rechaza un ID de punto falsificado o desactualizado, o un punto de otro país. Si la lista del país no está disponible temporalmente, el cliente ve un mensaje y puede elegir otro método de envío.
El ID, el nombre, la ciudad y el país del punto se guardan en el pedido. Se muestran en la pantalla del pedido debajo de la dirección de envío (con el ID del lugar), en la página de pedido recibido, en My account > Orders y en los correos electrónicos del pedido (HTML y texto sin formato) como SmartPost pickup point.
Para cambiar el punto de un pedido, abre el pedido y haz clic en Change junto a SmartPost pickup point. Elige una ciudad y un punto del país de envío del pedido. El nuevo punto se guarda de inmediato y una nota del pedido registra el punto anterior y el nuevo.
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 SmartPost. 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 volver a comprobar el estado, 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 sirve para un solo dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, SmartPost 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 renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
SmartPost no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el país de envío es Estonia, Letonia, Lituania o Finlandia, 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). Abre la página de ajustes: un aviso explica si no hay ningún precio definido, si un país no tiene precios o si un país no tiene puntos de recogida. Comprueba también los límites de peso, Minimum cart total, Excluded shipping classes y los tamaños de caja: un paquete que no cabe en ninguna caja, o una caja con una celda de precio vacía, oculta el método. Con Debug log activado, WooCommerce > Status > Logs (origen vfd-smartpost) muestra por qué se ocultó el método.
El cliente ve puntos de otro país: las listas siguen la dirección de envío. Comprueba qué país está introducido en la dirección de envío (o en la de facturación, cuando el pedido no se envía a una dirección distinta). Un punto de otro país se rechaza al realizar el pedido.
No hay puntos de recogida para un país: la lista de SmartPost no se pudo cargar y no hay copia guardada. El plugin lo reintenta cada 15 minutos. Haz clic más tarde en Refresh pickup point lists now. Comprueba también que Pickup point types incluye un tipo que exista en ese país.
La lista de puntos de recogida está desactualizada: haz clic en Refresh pickup point lists now en la página de ajustes. Las listas también se vuelven a descargar cada 24 horas.
El cliente no puede realizar el pedido: hay que elegir un punto del país de envío. Si el cliente ve "The SmartPost pickup point list is temporarily unavailable", en ese momento no hay puntos disponibles de ese país.
En qué moneda están los precios: en la moneda de tu tienda. El plugin no convierte monedas.
Para desarrolladores: el filtro vfd_smpt_places_url cambia la URL de la lista de lugares de un país (argumentos: URL, código de país), por ejemplo para usar un espejo que devuelva el mismo XML.
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 en el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes. Solo se borran las listas de puntos de recogida en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia, el estado de licencia de este plugin y las cachés siempre se eliminan. Los ajustes, los métodos de zona y las copias guardadas de las listas de puntos de recogida se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. El punto de recogida guardado en los pedidos nunca se elimina, y los pedidos existentes conservan sus líneas de envío.
SmartPost y SmartPosti son marcas registradas de sus respectivos titulares. Este plugin no está afiliado a SmartPost ni cuenta con su aprobación.