VibeFox SMSA Express for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 5.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Tarifa de SMSA Express: los precios de la tabla de precios provienen de tu cuenta de SMSA o del equipo comercial de SMSA. Introdúcelos en la moneda de tu tienda. Si tu tarifa está en SAR, AED u otra moneda, conviértela antes.
passKey de SMSA (solo para tarifas en tiempo real): las tarifas en tiempo real usan el servicio web de SMSA (SECOM, operación getShipCharges). SMSA emite el passKey previa solicitud: pídeselo a tu gestor de cuenta de SMSA o escribe a info@smsaexpress.com y solicita acceso al servicio web de SMSA indicando tu número de cuenta. El passKey puede ser distinto de la clave API del portal de comercio electrónico de SMSA. SMSA no tiene servidor de pruebas (sandbox) para este servicio.
Licencia de VibeFox: se compra en vibefox.net. Una clave funciona en 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_smsa_express a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox SMSA Express, o haz clic en Settings debajo del nombre del plugin en la página de 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 tus precios de SMSA Express en la tabla de precios.
6. Opcional: en Live rates (API) activa Live charges, introduce tu passKey de SMSA, la ciudad y el país de origen y, si la moneda de tu tienda no es SAR, el tipo de cambio.
7. Añade VibeFox SMSA Express a una zona de envío en WooCommerce > Settings > Shipping > Shipping zones (por ejemplo, "Arabia Saudí"), 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 SMSA Express. 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 para esta zona. Déjalo vacío para usar el Method title global.
Cada vez que guardas los ajustes, se borran las tarifas de SMSA guardadas en caché. Cuando las tarifas en tiempo real están activadas, las advertencias encima de los ajustes te avisan de un passKey, una ciudad de origen o un tipo de cambio que faltan, o de una tabla de precios vacía.
General
Enable/Disable: activa o desactiva el método en todas las zonas a la vez.
Method title: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Una zona puede cambiarlo. Por defecto: SMSA Express.
Tarifas en tiempo real (API) (opcional; si SMSA no devuelve ningún cargo, se usa la tabla de precios)
Live charges: obtiene el cargo de envío de SMSA Express. Por defecto: desactivado.
SMSA passKey: la clave del servicio web de SMSA (SECOM). Si el registro muestra "Invalid Passkey", este servicio no acepta la clave. Pide a SMSA un passKey del servicio web.
Ship-from city: la ciudad desde la que se envían tus paquetes, escrita como lo hace SMSA, por ejemplo Riyadh, Jeddah o Dammam. Déjala vacía para usar la ciudad de la tienda de WooCommerce > Settings > General.
Ship-from country: el país desde el que se envían tus paquetes. Por defecto es el país de tu tienda.
Shipment type: se envía a SMSA como tipo de envío. DLV (el valor por defecto) es entrega estándar. Cámbialo solo si SMSA te ha dado otro código.
Currency of SMSA charges: SMSA devuelve cada cargo con su código de moneda, normalmente SAR (por defecto). No se usa ningún cargo en una moneda distinta de esta ni de la moneda de tu tienda.
Exchange rate: el precio de 1 unidad de la moneda de SMSA en la moneda de tu tienda, por ejemplo 0.24. No es necesario si ambas monedas son iguales. Sin él, los cargos en otra moneda no se usan y se aplica la tabla de precios. Se aceptan tanto el punto como la coma como separador decimal.
Precios (tu tarifa de SMSA Express en la moneda de tu tienda; se usa cuando las tarifas en tiempo real están desactivadas, y como alternativa cuando SMSA no devuelve ningún cargo)
Price table: una fila por país de destino. Haz clic en + Add country para añadir una fila y en la cruz para quitar una. La fila * All other countries se aplica a los países que no tienen fila propia. Cada fila tiene un precio base 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 vacía o con 0 usa el precio base. Un precio base de 0 significa envío gratuito. Las filas sin ningún precio se eliminan al guardar. Se aceptan tanto "9.99" como "9,99".
Price for countries not in the table: se usa cuando la tabla no tiene fila para el país de destino (y no hay fila *), o la fila no tiene precio para este peso. Déjalo vacío para ocultar el método en ese caso.
Price applies: cómo se calcula el precio.
Los pesos de los productos se convierten de la unidad de peso de tu tienda a kilogramos.
Condiciones
Minimum weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 30. 0 significa sin límite.
Minimum order amount: muestra el método solo cuando el subtotal del carrito (después de descuentos, antes de impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.
Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío con SMSA Express es gratuito. El envío gratuito solo se ofrece cuando el método tiene precio para el destino: un cargo de SMSA, una fila de la tabla o el precio para países que no están en la tabla. Si la tabla tiene precio, no se envía ninguna petición a SMSA. Déjalo vacío para no ofrecer nunca envío gratuito.
Excluded shipping classes: oculta el método cuando el carrito contiene un producto de alguna de estas clases de envío de WooCommerce.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío; None no lo añade. Elige None si tus precios (la tabla y los cargos de SMSA) ya incluyen impuestos, por ejemplo el IVA saudí.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece SMSA Express para los países indicados abajo, aunque el método no esté añadido a ninguna zona de envío.
Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Este campo solo se usa cuando Ignore shipping zones está activado. Un método añadido a una zona de envío siempre funciona para los países de su zona.
Avanzado
Debug log: registra cada cálculo de tarifa en WooCommerce > Status > Logs, origen vfd_smsa_express. No se registran direcciones de clientes ni claves. Los errores de las tarifas en tiempo real se registran siempre, aunque esta opción esté desactivada. Desactiva el registro cuando termines.
Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de SMSA Express y los métodos de zona. Desactivar el plugin nunca borra nada.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin un precio. El plugin comprueba primero las condiciones: país de entrega, peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si se aplica el envío gratuito y el destino tiene precio, el método se muestra con un precio de 0.
Con las tarifas en tiempo real activadas, el plugin envía a SMSA la ciudad y el país de origen, la ciudad y el país del cliente, el tipo de envío, el peso del paquete en kg y un importe de pago contra reembolso de 0. SMSA responde con el cargo y su moneda. El plugin lo convierte a la moneda de tu tienda y lo muestra. Una tarifa en tiempo real solo se pide después de que el cliente haya introducido una ciudad.
Cada cargo se guarda en caché durante una hora, de modo que el mismo carrito no genera una nueva petición. Una petición fallida se guarda en caché durante 5 minutos. Tras un tiempo de espera o un error del servidor, no se vuelve a consultar a SMSA durante 2 minutos. Tras una clave rechazada, no se consulta durante 5 minutos. Así, la finalización de compra nunca espera a un servicio que falla en cada actualización. El tiempo de espera de la petición es de 12 segundos.
Siempre que SMSA no devuelve un cargo válido (sin passKey, sin ciudad introducida todavía, faltan pesos de producto, clave no válida, tiempo de espera, error, sin servicio a la ciudad o moneda desconocida), se usa la tabla de precios. Si la tabla y Price for countries not in the table no dan ningún precio, el método se oculta. El cliente nunca ve un error. El motivo se escribe en el registro.
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). Se incluye una traducción al árabe.
El plugin solo calcula el precio del envío. No crea envíos de SMSA, no imprime etiquetas AWB, no gestiona devoluciones ni hace seguimiento de paquetes. El pago contra reembolso y su tarifa no se incluyen en el cargo en tiempo real. No hay selector de puntos de venta de SMSA: el método es entrega a domicilio.
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 SMSA Express. 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 quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un solo dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, SMSA Express no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión 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 de 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
SMSA Express no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado 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). Revisa los límites de peso, Minimum order amount y Excluded shipping classes. Comprueba que el país o * tiene precio, o que Price for countries not in the table está configurado.
Los clientes ven el precio de la tabla en lugar del cargo de SMSA: SMSA necesita la ciudad del cliente, así que hasta que se introduzca se muestra el precio de la tabla. La tabla también se usa cuando SMSA no responde, rechaza la clave o la ciudad, o devuelve el cargo en una moneda sin tipo de cambio. Abre WooCommerce > Status > Logs, origen vfd_smsa_express, para ver el motivo.
"Invalid Passkey" en el registro: el servicio web de SMSA no acepta la clave. Pide a SMSA un passKey del servicio web.
SMSA no acepta la ciudad del cliente: SMSA espera su propia forma de escribir las ciudades. Los desarrolladores pueden ajustar la petición, por ejemplo el nombre de la ciudad, con el filtro vfd_smsa_express_live_request_fields.
El impuesto se cobra dos veces en el envío: tu tarifa o los cargos de SMSA pueden incluir ya el IVA. Pon Tax status en None.
Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las tarifas de SMSA guardadas en caché.
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 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. Los ajustes, los métodos de zona y las tarifas guardadas en caché 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.
SMSA Express es una marca comercial de su respectivo propietario. Este plugin no está afiliado ni respaldado por SMSA Express.