Stuart pone a su disposición sus repartidores independientes, sin pasar por una plataforma de pedidos: el cliente pide en su app, a su nombre, y Stuart solo aporta el repartidor. Usted paga cada envío a la tarifa de Stuart, sin comisión sobre sus ventas.
En XPRIO esto se llama repartidor asociado. Lo conecta una vez para su empresa y luego decide, establecimiento por establecimiento, si entrega todos sus pedidos o solo refuerza a sus propios repartidores.
Lo que debe saber antes de empezar
La cuenta de Stuart es suya. La crea en Stuart, y es Stuart quien le factura cada envío. XPRIO no cobra nada.
El cliente paga sus gastos de envío, los de su establecimiento, cobrados con el pedido. El coste del envío Stuart se factura aparte, según la distancia, el tamaño del paquete y la hora. Si sus gastos son inferiores al envío, usted asume la diferencia; si son superiores, se la queda. Una vez conectado, XPRIO le muestra el precio con impuestos de un envío típico.
El pago en línea es obligatorio. Un repartidor asociado no cobra nada. Los modos de repartidor asociado solo se activan si el pago con tarjeta en línea (Stripe) está configurado en su app. Configurar sus métodos de pago
Países cubiertos: Francia, Reino Unido y Polonia, en las grandes ciudades donde opera Stuart (129 ciudades en 2025). XPRIO solo ofrece Stuart para los establecimientos de estos países, y verifica cada dirección en el carrito.
Debe haber una tarjeta bancaria registrada en Stuart antes del primer envío, también en la cuenta de prueba. Sin tarjeta, Stuart rechaza crear la entrega.
Sin código de entrega con Stuart: la prueba de entrega es la del repartidor Stuart (firma o foto).
Una cancelación puede facturarse una vez asignado un repartidor. XPRIO le avisa antes de confirmar.
Paso 1: abrir sus cuentas de Stuart
Stuart ofrece dos paneles, con un registro separado para cada uno:
Cuenta de prueba en dashboard.sandbox.stuart.com: envíos simulados, nada facturado, disponible de inmediato. Ahí hará sus pruebas.
Cuenta real en dashboard.stuart.com: solicite el alta en stuart.com (botón Hazte cliente o equivalente). Stuart le llama para validar su actividad y después le abre el acceso.
En ambos casos, una vez conectado:
Haga clic en su avatar arriba a la derecha y luego en Mi cuenta.
En el menú izquierdo, haga clic en Facturación y registre una tarjeta bancaria. En la cuenta de prueba vale cualquier tarjeta de prueba (salvo American Express), por ejemplo 4242 4242 4242 4242 con una fecha de caducidad futura y un código de tres cifras. En la cuenta real, su tarjeta real o sus datos de facturación según su contrato.
Paso 2: obtener sus claves
En Mi cuenta, menú izquierdo, haga clic en API.
Si la página muestra Sin credenciales de API, haga clic en Generar ahora.
La sección Credenciales API muestra tres líneas, cada una con un icono de copia:
ID de cliente: una larga cadena de caracteres (es el «Client ID»).
Clave secreta API: otra larga cadena (es el «Client secret»). No la comparta con nadie.
ID de cuenta Stuart: un número de seis cifras. No lo necesitará en XPRIO.
Los valores aparecen truncados en pantalla: use siempre el icono de copia, nunca la selección con el ratón. La cuenta de prueba y la cuenta real tienen cada una sus propias claves.
Paso 3: conectar Stuart a XPRIO
En XPRIO, menú izquierdo, abra Configuración de la aplicación y luego Repartidores asociados.
En la tarjeta Stuart, haga clic en Conectar.
En Entorno, elija Prueba para las claves de la cuenta de prueba, Producción para las de la cuenta real.
Pegue el ID de cliente en Client ID y la Clave secreta API en Client secret. El icono de ojo permite mostrar el secreto para comprobar.
Deje Clave de autenticación de webhooks vacía por ahora (paso 4).
Haga clic en Guardar y probar. XPRIO se conecta a Stuart, comprueba que la dirección de su establecimiento está cubierta y pide un presupuesto de prueba. Si la tarjeta pasa a Conectado (prueba) o Conectado (producción), listo. Si no, un mensaje rojo recoge la respuesta de Stuart: claves incompletas, o establecimiento fuera de las zonas de Stuart.
Una vez conectado, la tarjeta muestra «Envío típico desde su establecimiento (unos 1,5 km)» con el precio real con impuestos devuelto por Stuart.
Paso 4: activar las notificaciones en tiempo real (recomendado)
Sin este paso, XPRIO consulta el estado de cada envío cada 20 segundos: funciona. Con él, Stuart avisa a XPRIO al instante en cada cambio (repartidor asignado, posición, pedido recogido, entregado).
En XPRIO, vuelva a abrir la ventana Stuart (Editar en la tarjeta). Copie la URL de notificación a declarar en el proveedor.
En esa misma ventana, invente una clave larga (por ejemplo 20 caracteres sin espacios), péguela en Clave de autenticación de webhooks y haga clic en Guardar y probar.
En el panel de Stuart, Mi cuenta, API: bajo la sección Credenciales, la sección Webhooks muestra Sin Webhooks. Haga clic en + Añadir un nuevo endpoint.
Pegue la URL en URL del webhook. En Cabecera de autenticación, escriba exactamente
Authentication-Key(sin este nombre, Stuart no envía la clave y XPRIO rechaza los eventos). En Clave de autenticación, pegue la misma clave que en XPRIO. Marque todos los eventos V2 (job, delivery, driver). Guarde.
La tarjeta Stuart en XPRIO pasa a «Notificaciones en tiempo real activas» con el primer envío.
Paso 5: elegir el modo de cada establecimiento
En XPRIO, menú Establecimientos, abra la ficha del establecimiento (Editar) y luego la pestaña Entrega y servicios.
Compruebe que el servicio Entrega está activado.
En la sección Quién entrega sus pedidos, elija:
Mis repartidores: nada cambia.
Mis repartidores + repartidor asociado de refuerzo: sus repartidores tienen prioridad; un botón Llamar a un repartidor asociado aparece en cada pedido a domicilio pagado en línea mientras no haya repartidor asignado. Opción Llamar automáticamente a un repartidor asociado si ningún repartidor toma el pedido, con un plazo de 5 a 30 minutos tras «listo».
Solo repartidor asociado: cada pedido a domicilio se confía automáticamente al repartidor Stuart, en el momento que elija (Cuándo solicitar el repartidor). El cliente solo ve el pago en línea.
Si las tarjetas asociadas están grises con «Pago en línea obligatorio», active primero Stripe en Configuración de la aplicación, Métodos de pago.
Elija Stuart en Proveedor.
En modo «solo repartidor asociado», elija los gastos cobrados al cliente: Mis gastos fijos o El precio del repartidor (+ margen). En modo refuerzo el cliente paga siempre sus gastos fijos.
Si lo necesita, añada instrucciones de recogida para el repartidor y decida si la propina del cliente se transfiere al repartidor. Guarde.
En el Live y del lado del cliente
En el pedido, el bloque Repartidor asociado muestra al repartidor Stuart desde su asignación, su teléfono, su etapa (Repartidor en camino, Repartidor en el establecimiento, Recogido, En casa del cliente, Entregado) y la hora estimada de llegada. Antes de solicitarlo, la ventana de confirmación le muestra el coste del envío con impuestos.
El pedido pasa a En reparto cuando el repartidor lo recoge y a Entregado al entregarlo, sin intervención. Puede cancelar al repartidor mientras no haya recogido el pedido. Si Stuart cancela o el pedido se devuelve, recibe una notificación, un sonido y un mensaje en el Live, y puede solicitar otro repartidor o asignar a uno de los suyos.
En su app, el cliente ve una tarjeta de contacto Repartidor asociado con el nombre del repartidor, un botón de llamada, un enlace de seguimiento y su posición en tiempo real en el mapa. En un establecimiento en modo «solo repartidor asociado», el carrito solo muestra el pago con tarjeta.
Preguntas frecuentes
¿Puedo probar sin un envío real? Sí, con la cuenta de prueba conectada en el entorno Prueba. En el panel de prueba, la pestaña Escenario ideal permite hacer avanzar un envío simulado paso a paso y ver el resultado en el Live.
¿Stuart rechaza el envío con un error de pago? No hay ninguna tarjeta registrada en Facturación de esa cuenta, o ha caducado. Añada una y vuelva a intentarlo.
Artículos relacionados