VibeFox SF 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.

Cuenta de SF Express (solo para precios en tiempo real): los precios en tiempo real usan la plataforma abierta FengQiao de SF Express (open.sf-express.com). Necesitas una cuenta mensual de SF Express y una cuenta de desarrollador en FengQiao. Regístrate allí, crea una aplicación, añádele la API "Delivery time standard and price query" (EXP_RECE_QUERY_DELIVERTM) y copia el código de cliente y el checkword. Los checkwords del sandbox y de producción son distintos. Si solo usas la tabla de precios, no necesitas una cuenta de SF Express.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_sf_express a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox SF Express, 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. Rellena la tabla de precios y/o el coste alternativo.

6. Para los precios en tiempo real en China continental, introduce el código de cliente y el checkword, la provincia y la ciudad de origen (o define una dirección de tienda en China) y, si la moneda de tu tienda no es CNY, el tipo de cambio. Prueba primero con Sandbox y con credenciales de sandbox.

7. Añade VibeFox SF Express a una zona de envío 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 SF Express. 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.

Cada vez que guardas los ajustes se borran los precios de SF Express en caché. Si los precios en tiempo real están configurados solo en parte, un aviso encima de los ajustes indica qué ajustes faltan o qué tipo de cambio falta.

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 sustituirlo. Por defecto: SF Express.

Tax status: Taxable añade a la tarifa el impuesto de envío de tu tienda, None no lo añade. Elige None si el precio de SF Express ya incluye todo lo que quieres cobrar.

API FengQiao de SF Express (precios en tiempo real) (opcional, para direcciones de entrega en China continental)

Customer code (partnerID): el código de cliente (顾客编码) de tu aplicación FengQiao.

Checkword: el checkword (校验码) del mismo entorno. Solo se usa para firmar las solicitudes y nunca se envía ni se registra.

Sandbox: usa el sandbox de FengQiao para hacer pruebas con credenciales de sandbox. Los precios del sandbox no son reales. Desactívalo en una tienda en producción. Por defecto: off.

SF Express product: de qué producto de SF Express se muestra el precio.

Sender province: la provincia desde la que se envían los paquetes. Déjalo vacío para usar la provincia de la dirección de la tienda en WooCommerce > Settings > General, cuando la tienda esté en China.

Sender city: el nombre chino estándar de la ciudad, por ejemplo 深圳市. Déjalo vacío para usar la ciudad de la tienda, cuando la tienda esté en China.

Currency conversion rate: los precios de SF Express están en CNY (yuanes). Si la moneda de tu tienda no es CNY, indica cuántas unidades de la moneda de tu tienda vale un CNY. Sin él, no se usan los precios en tiempo real. Si la moneda de tu tienda es CNY, los precios se usan tal cual. Se aceptan tanto el punto como la coma como separador decimal.

Tabla de precios y coste alternativo (se usa para Hong Kong, Macao, Taiwán y otros países, cuando no hay precios en tiempo real configurados o cuando SF Express no devuelve precio; los precios están en la moneda de tu tienda)

Country prices: una tabla con un precio base por país. La fila * Any other country se aplica a todos los países sin fila propia. Un precio de tramo de peso superior a 0 sustituye al precio base para los paquetes de ese tramo: ≤ 1 kg, ≤ 2 kg, ≤ 3 kg, ≤ 5 kg y > 5 kg. Un precio base de 0 significa envío gratuito. Un precio base vacío significa que no hay precio para ese país y se usa el coste alternativo.

Fallback cost: se usa cuando ni SF Express ni la tabla dan un precio. Déjalo vacío para ocultar el método en ese caso.

Table / fallback price is: cómo se cobran los precios de la tabla y los alternativos.

Los precios en tiempo real de SF Express siempre se calculan para el pedido completo.

Condiciones

Free shipping from: el subtotal del carrito a partir del cual el envío es gratuito. El envío gratuito se ofrece solo donde el método tiene precio para el destino: un precio en tiempo real, una fila de la tabla o el Fallback cost. Déjalo vacío para no ofrecer nunca envío gratuito.

Minimum subtotal: muestra el método solo cuando el subtotal del carrito alcanza este importe. Déjalo vacío para mostrarlo siempre.

Min weight (kg): el peso mínimo del carrito en kg. Los pesos de los productos se convierten desde la unidad de peso de tu tienda. 0 significa sin límite.

Max weight (kg): el peso máximo del carrito en kg. Por defecto: 50. 0 significa sin límite.

Excluded shipping classes: oculta el método si el carrito contiene productos de estas clases de envío de WooCommerce.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados abajo aunque no esté añadido a una zona. Si está desactivado, el método aparece solo en las zonas de envío a las que se ha añadido.

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.

Avanzado

Debug log: escribe los cálculos de precios en el registro de WooCommerce: WooCommerce > Status > Logs, origen vfd-sf-express. Los errores de la API siempre se registran, aunque esta opción esté desactivada. No se escriben checkwords ni direcciones de clientes.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes, sus métodos en las zonas de envío y sus cachés. 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 un precio al plugin. Primero el plugin comprueba las condiciones: país de entrega, peso del carrito, subtotal mínimo y clases de envío excluidas. Si se aplica el envío gratuito y la tabla de precios o el Fallback cost tienen un precio para el destino, el método se muestra con precio 0 y no se envía ninguna solicitud a SF Express. En otro caso, el plugin pide primero un precio en tiempo real a SF Express y muestra el método como gratuito solo si se recibe uno.

Para una dirección de entrega en China continental, con el código de cliente y el checkword configurados, el plugin envía a SF Express la provincia y la ciudad de origen, la provincia y la ciudad del cliente, el peso del carrito y el volumen del carrito (de los productos con sus tres dimensiones). La solicitud se firma con tu checkword. SF Express devuelve los precios en CNY y el plugin convierte el elegido a la moneda de tu tienda.

SF Express reconoce las direcciones por los nombres chinos estándar. La provincia del cliente procede del campo de estado de la finalización de compra. La ciudad debe escribirse en chino, por ejemplo 广州市. Para Pekín, Shanghái, Tianjin y Chongqing, la ciudad se rellena automáticamente. Una ciudad escrita con letras latinas, como "Guangzhou", obtiene el precio de la tabla.

Cada precio se guarda en caché durante una hora, así que el mismo carrito no genera una nueva solicitud. Una solicitud fallida se guarda en caché durante 10 minutos, para que la finalización de compra no espere a SF Express en cada actualización. El tiempo de espera HTTP es de 10 segundos.

Si no hay precio en tiempo real, el precio procede de la tabla de precios y, después, del Fallback cost. Si no se aplica ninguno, el método se oculta. El cliente nunca ve un error. El error se escribe en el registro.

El método funciona en la finalización de compra clásica y en los bloques de Carrito y de Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS). Se incluyen traducciones al inglés y al chino simplificado.

El plugin solo calcula precios. No crea guías ni etiquetas, no crea pedidos en SF Express, no reserva recogidas, no cancela ni hace seguimiento de envíos. Crea y sigue los envíos en tu cuenta de SF Express como de costumbre. Los clientes no pueden elegir un punto de servicio ni una taquilla de SF. SF Express se usa como servicio de mensajería puerta a puerta. Los precios en tiempo real existen solo para direcciones de entrega en China continental. El plugin se desarrolló con la documentación de FengQiao y con respuestas simuladas, así que confirma los precios con tu cuenta de SF Express (primero en sandbox) antes de poner la tienda en producción.

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 SF 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 eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, SF Express no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí la ven, marcada 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

SF 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 permitido). Revisa los límites de peso, el Minimum subtotal y las Excluded shipping classes. Comprueba que la tabla o el Fallback cost tengan un precio para el país.

El precio procede de la tabla, no de SF Express: los precios en tiempo real necesitan el código de cliente y el checkword, una provincia y una ciudad de origen, una dirección de entrega en China continental con provincia y nombre de ciudad chino, y (en tiendas que no usan CNY) el tipo de cambio. Abre WooCommerce > Status > Logs, origen vfd-sf-express, para ver el motivo. Una solicitud fallida se repite después de 10 minutos.

Error A1006 en el registro: firma no válida. El checkword es incorrecto o pertenece al otro entorno. Revisa el ajuste Sandbox.

Error A1004 en el registro: la API de consulta de precios no está añadida a tu aplicación FengQiao.

Hong Kong: funciona con la tabla de precios y el coste alternativo. La consulta de precios de FengQiao es solo para direcciones de China continental.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran los precios de SF Express en caché.

Para desarrolladores: el filtro vfd_sfex_quote_request modifica la solicitud de precio, por ejemplo para usar otro código de producto. vfd_sfex_api_url cambia la URL de la pasarela.

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 acceder al 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 los precios 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.

SF Express es una marca comercial de su respectivo titular. Este plugin no está afiliado a SF Express ni cuenta con su aprobación.