Entregar con un repartidor de Uber Direct

Uber Direct pone a su disposición los repartidores de la red Uber sin pasar por una plataforma de pedidos: el cliente pide en su propia app, con su marca, y Uber solo aporta el repartidor. Usted paga cada envío al precio fijado por Uber, sin comisión sobre sus ventas.

En XPRIO esto se llama repartidor bajo demanda. 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 Uber Direct es suya. La crea en Uber, registra allí su método de pago, y es Uber 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 Uber se factura aparte, según la ciudad, la distancia y la hora. Si sus gastos de envío son inferiores al coste del envío, usted asume la diferencia; si son superiores, se la queda. Una vez conectada la cuenta, XPRIO le muestra el precio de un envío típico desde su establecimiento.
El pago en línea es obligatorio. Un repartidor bajo demanda no cobra nada: ni efectivo, ni cheque, ni tarjeta a la entrega. Los modos de repartidor bajo demanda solo se activan si el pago con tarjeta en línea (Stripe) está configurado en su app. Configurar sus métodos de pago
La cobertura depende de la ciudad. Uber Direct funciona en las grandes ciudades y sus alrededores, no en todas partes. XPRIO verifica cada dirección en el carrito: una dirección no cubierta se rechaza antes del pedido.
Una cancelación puede facturarse una vez asignado un repartidor. XPRIO le avisa antes de confirmar.
Reserve una hora para todo el proceso: creación de la cuenta, claves, conexión, ajustes del establecimiento. Uber puede tardar unos días en validar una cuenta real.

Paso 1: crear su cuenta de Uber Direct

Abra merchants.uber.com en su navegador y busque Uber Direct en el menú (o vaya directamente a merchants.uber.com/uber-direct).
Haga clic en Empezar (o Get started) y rellene el formulario de empresa: razón social, dirección, identificación fiscal, datos de contacto, método de pago. Uber verifica la información y valida la cuenta, normalmente en unos días.
Una vez validada, inicie sesión en direct.uber.com. Es el panel de Uber Direct, distinto de las aplicaciones de Uber para el gran público.

Uber le ofrece dos entornos:

Una cuenta de prueba, gratuita, donde las entregas las simula un repartidor ficticio y nunca se facturan.
Su cuenta real, donde entregan repartidores reales y cada envío se le factura.

En la parte superior del panel, una franja azul indica «Está viendo una cuenta de prueba» cuando está en la cuenta de prueba, con un botón Cambiar de cuenta a la derecha para pasar de una a otra. Haga sus pruebas en la cuenta de prueba y pase a la cuenta real cuando todo funcione.

Paso 2: obtener sus claves

En el menú izquierdo del panel de Uber Direct, bajo Gestión, haga clic en Desarrollador.
Quédese en la pestaña Claves API (la primera, junto a Webhooks).
Verá el nombre de su aplicación y tres valores, cada uno con un botón Copiar a la derecha:
- Identificador del cliente (Customer ID): una larga cadena de letras y cifras separadas por guiones (por ejemplo d5d7125d-53a8-…).
- Identificador cliente (Client ID): una cadena de caracteres sin guiones regulares (por ejemplo 3O9Zffr2-…).
- Secreto cliente (Client secret): oculto por defecto. Haga clic en Mostrar para verlo y luego en Copiar. No lo comparta con nadie.

Estos tres valores son distintos entre la cuenta de prueba y la cuenta real: tome los del entorno que quiera conectar. La franja azul superior le recuerda en cuál está.

Paso 3: conectar Uber Direct a XPRIO

En XPRIO, menú izquierdo, abra Configuración de la aplicación y luego Repartidores bajo demanda (etiqueta New).
La página muestra los tres proveedores en tarjetas. En la tarjeta Uber Direct, haga clic en Conectar.
Se abre una ventana Conectar Uber Direct. En Entorno, elija:
- Prueba si pega las claves de su cuenta de prueba de Uber;
- Producción si pega las de su cuenta real.
Pegue los tres valores del paso 2 en Customer ID, Client ID y Client secret. El campo secreto está enmascarado; el icono de ojo a la derecha permite mostrarlo para comprobar.
Deje Clave de firma de webhooks vacía por ahora; volveremos a ella en el paso 4.
Haga clic en Guardar y probar. XPRIO se conecta a Uber con sus claves y solicita un presupuesto de prueba en torno a su establecimiento. Tres resultados posibles:
- la ventana se cierra y la tarjeta Uber Direct muestra Conectado (prueba) o Conectado (producción): listo;
- un mensaje rojo «La prueba de conexión falló» con el detalle devuelto por Uber: casi siempre un valor copiado con un espacio de más, o claves de prueba pegadas en modo Producción (o al revés). Corrija y vuelva a intentarlo;
- un mensaje que indica que la dirección no está cubierta: Uber Direct no cubre la zona de su establecimiento.

Una vez conectado, la tarjeta muestra también «Envío típico desde su establecimiento (unos 1,5 km)» con el precio real devuelto por Uber, en la moneda del proveedor. Úselo como referencia para fijar sus gastos de envío.

Sus claves se cifran y nunca vuelven a mostrarse en claro. No tendrá que volver a introducirlas: XPRIO renueva por sí mismo su conexión con Uber. Si más adelante cambia de entorno (por ejemplo de Prueba a Producción), los campos se vacían: son otras claves las que hay que pegar.

Paso 4: activar las notificaciones en tiempo real (recomendado)

Sin este paso, XPRIO consulta el estado de cada envío cada 20 segundos, lo cual funciona. Con él, Uber avisa a XPRIO al instante en cada cambio (repartidor asignado, posición, pedido recogido, entregado), y la tarjeta Uber Direct muestra «Notificaciones en tiempo real activas».

En XPRIO, vuelva a abrir la ventana de conexión de Uber Direct (botón Editar en la tarjeta). Bajo los campos de claves, localice URL de notificación a declarar en el proveedor y haga clic en Copiar.
En el panel de Uber Direct, menú Desarrollador, haga clic en la pestaña Webhooks. Bajo Puntos de conexión, haga clic en + Crear un webhook.
Se abre a la derecha un panel Crear un punto de conexión. Pegue la URL en URL del webhook.
En Seleccionar tipos de eventos, marque event.delivery_status y event.courier_update. Deje event.refund_request sin marcar.
Haga clic en Guardar. Su webhook aparece en la lista con su URL y sus eventos.
A la derecha de la fila, haga clic en el menú ⋮ y luego en la opción que muestra la clave de firma («Signing key»). Cópiela.
De vuelta en XPRIO, ventana Uber Direct, péguela en Clave de firma de webhooks y haga clic en Guardar y probar.

Desde el primer envío, la tarjeta Uber Direct pasa de «Sin notificación en tiempo real» a «Notificaciones en tiempo real activas», con la fecha de la última notificación recibida.

Paso 5: elegir el modo de cada establecimiento

En XPRIO, menú Establecimientos, abra la ficha del establecimiento (botón Editar) y luego la pestaña Entrega y servicios.
Compruebe que el servicio Entrega está activado.
Localice la sección Quién entrega sus pedidos, justo encima de las opciones de repartidores. Tres tarjetas a elegir:
- Mis repartidores: nada cambia, entregan sus repartidores de XPRIO Pro.
- Mis repartidores + repartidor bajo demanda de refuerzo: sus repartidores tienen prioridad. En cada pedido a domicilio pagado en línea, el Live ofrece un botón Llamar a un repartidor bajo demanda mientras no haya repartidor asignado. Ideal para un viernes por la noche con mucho trabajo o una ausencia.
- Solo repartidor bajo demanda: cada pedido a domicilio se confía automáticamente al repartidor. El cliente solo ve el pago en línea.
Si las dos últimas tarjetas están grises con el mensaje «Pago en línea obligatorio», active primero Stripe en Configuración de la aplicación, Métodos de pago.
En cuanto elige un modo asociado, aparecen los ajustes siguientes:
- Proveedor: la lista de proveedores conectados que cubren el país del establecimiento. Elija Uber Direct. Si la lista está vacía, el enlace Conectar un proveedor le devuelve al paso 3.
- En modo refuerzo: la casilla Llamar automáticamente a un repartidor bajo demanda si ningún repartidor toma el pedido, con un plazo de 5 a 30 minutos desde que el pedido está listo. Márquela si no siempre hay alguien vigilando el Live.
- En modo solo repartidor bajo demanda: Cuándo solicitar el repartidor. La opción recomendada es Al iniciar la preparación: el repartidor llega cuando el pedido está listo. Al aceptar lo hace venir antes, con riesgo de espera facturada; Cuando el pedido está listo evita cualquier espera pero el pedido aguarda de 10 a 15 minutos.
- En modo solo repartidor bajo demanda: Gastos de envío cobrados al cliente. Mis gastos fijos mantiene sus zonas y tarifas habituales. El precio del repartidor (+ margen) cobra al cliente el presupuesto de Uber calculado para cada dirección, más un margen a su elección, fijo o en porcentaje. En modo refuerzo el cliente paga siempre sus gastos fijos, ya que en el momento del pedido aún no se sabe quién entregará.
- Instrucciones de recogida para el repartidor: una frase libre, por ejemplo «entrada por el aparcamiento, preguntar en el mostrador».
- Transferir la propina del cliente al repartidor: si no, la propina se queda en el establecimiento, como con sus repartidores.
Guarde la ficha. El modo se aplica de inmediato a los nuevos pedidos.

En el Live

En un pedido a domicilio, el bloque de repartidor de la tarjeta muestra:

antes de la llamada: el botón 🛵 Llamar a un repartidor bajo demanda (solo en modo refuerzo);
tras la llamada: la etiqueta Repartidor bajo demanda, el nombre del proveedor y luego Repartidor solicitado mientras Uber asigna a alguien;
desde la asignación: el nombre del repartidor, su teléfono (enmascarado por Uber, válido durante el envío), su etapa (Repartidor en camino, Repartidor en el establecimiento, Recogido, En casa del cliente, Entregado) y la hora estimada de llegada.

Al hacer clic en Llamar a un repartidor bajo demanda, una ventana de confirmación muestra el proveedor, la dirección de entrega, el coste del envío para usted, la hora de recogida prevista y la hora estimada de entrega. Haga clic en Solicitar el repartidor para confirmar.

Cuando el repartidor recoge el pedido, este pasa a En reparto por sí solo, y a Entregado al entregarlo: no tiene que hacer nada. Puede cancelar el repartidor desde el bloque mientras no haya recogido el pedido; XPRIO le recuerda que pueden aplicarse gastos de cancelación.

Si Uber no encuentra repartidor o cancela el envío, recibe una notificación en la app XPRIO Pro, un sonido y un mensaje en el Live. El pedido sigue abierto y puede solicitar otro repartidor o asignar a uno de los suyos. Lo mismo si el repartidor devuelve un pedido que no ha podido entregar: aparece como Devuelto al establecimiento, pendiente de gestionar (nueva entrega o reembolso).

Para el cliente

En su app, el cliente ve una tarjeta de contacto Repartidor bajo demanda con el nombre del repartidor, su vehículo, un botón de llamada y un enlace de seguimiento. En el mapa de seguimiento, el repartidor se mueve en tiempo real como uno de los suyos. Si su establecimiento exige un código de entrega, el repartidor de Uber se lo pide al cliente, igual que sus repartidores.

En un establecimiento en modo «solo repartidor bajo demanda», el carrito solo muestra el pago con tarjeta, con la mención «Entrega por un repartidor bajo demanda: solo pago en línea». Una dirección fuera de la cobertura de Uber se señala como «Dirección no cubierta por nuestro repartidor bajo demanda» antes del pedido.

Preguntas frecuentes

¿Puedo probar sin un pedido real? Sí, con la cuenta de prueba de Uber (paso 1) conectada en el entorno Prueba: los envíos los simula un repartidor ficticio, no se factura nada, y ve todo el ciclo en el Live en unos minutos.

¿Por qué el presupuesto difiere del envío real? El presupuesto es válido 15 minutos. Si se llama al repartidor más tarde, Uber recalcula en ese momento. XPRIO nunca vuelve a cobrar al cliente: la diferencia es suya.

¿Qué pasa si mi cuenta de Uber tiene un problema? La tarjeta Uber Direct pasa a Error con el mensaje de Uber, y el Live no permite llamar a un repartidor hasta que se resuelva. Sus repartidores siguen funcionando con normalidad.

¿Puedo desconectar Uber Direct? Sí, botón Desconectar en la tarjeta, siempre que ningún establecimiento siga en modo repartidor bajo demanda. Páselos primero a «Mis repartidores».