Conectar Uber Direct
Administra Uber Direct en Connect → Delivery services. Esta guía conserva el flujo de cuenta y callbacks de Uber Direct para los proyectos donde aparece el servicio.
Antes de empezar
Confirma el acceso de administrador a Delivery services, la cuenta de Uber Direct y el entorno previsto. Si Uber Direct no aparece, confirma la disponibilidad con el responsable del proyecto.
1. Seleccionar la cuenta y el entorno Uber Direct previstos
- Crea una cuenta autorizada o inicia sesión en Uber Direct.
- Abre el área Developer del proveedor.
- Antes de obtener credenciales, selecciona la cuenta y el entorno previstos para esta conexión.
Mantén separados los datos de prueba y producción. Seleccionar un entorno solo determina qué configuración estás consultando; no valida credenciales ni conecta un proyecto Ordering.co.
2. Añadir credenciales del proveedor en Connect
En Connect → Delivery services, abre Uber Direct y la configuración del proveedor del servicio elegido. Introduce el identificador de cuenta y las credenciales del entorno previsto en los campos disponibles. Comprueba la autenticación por separado del guardado. Consulta Configurar un servicio de entrega.
Revisar por separado otros ajustes de entrega
El ajuste Uber Direct también puede mostrar Sandbox Mode, Add Delivery Fee, Accept Cash Orders, Cancel Reason (sandbox), Enable Dropoff Verification (pincode), Business Name y Sync ETA Time. Revisa cada valor con el equipo de entregas y el responsable de incorporación del proveedor antes de cambiarlo. La visibilidad o el guardado de un campo no demuestra gestión de tarifas, aceptación de efectivo, comportamiento de cancelación, verificación de entrega, sincronización de ETA, despacho, seguimiento ni entrega.
3. Registrar los callbacks requeridos del proveedor
En Uber Direct, abre Developer y luego Webhooks. Registra las rutas siguientes solo si corresponden al código aprobado del proyecto de tu espacio de trabajo:
| Callback | Ruta | Evento del proveedor |
|---|---|---|
| Estado de entrega | https://uber-direct.plugins.orderingplus.com/{project_code}/webhooks/deliveries/update | event.delivery_status |
| Actualización de mensajero | https://uber-direct.plugins.orderingplus.com/{project_code}/webhooks/deliveries/courier_update | event.courier_update |
Reemplaza {project_code} por el código de proyecto aprobado en minúsculas. No deduzcas otro hostname, ruta, código de proyecto ni evento a partir de esta tabla.
Registrar la ruta indica al proveedor dónde puede enviar esos tipos de evento. No demuestra que un callback se haya entregado, aceptado, procesado, reintentado ni que lo vea un operador o cliente.
4. Validar un flujo de entrega aprobado
Después de que los responsables de la integración autoricen una prueba controlada, usa un pedido de prueba y confirma en secuencia las etapas siguientes:
- El pedido Ordering.co previsto es elegible para el servicio de entrega configurado.
- Uber Direct acepta la solicitud en el entorno previsto.
- El proveedor crea o asigna la entrega.
- Los callbacks de estado de entrega y actualización de mensajero previstos llegan a los endpoints aprobados.
- La entrega aparece en la vista prevista del proveedor con el estado esperado.
No uses pedidos reales de clientes para diagnosticar la configuración. Una lista de dashboard, botón del proveedor, callback registrado o credencial guardada no es un comprobante de entrega exitosa.
Qué verificar en cada límite
| Límite | Evidencia que se debe buscar | Qué no demuestra |
|---|---|---|
| Instalación y configuración | El ajuste Uber Direct está disponible y se guardaron los campos previstos. | Autenticación del proveedor ni disponibilidad del servicio de entrega. |
| Credenciales del proveedor | Los valores provienen de la cuenta autorizada y coinciden con el entorno seleccionado. | Que estén activos, autorizados o aceptados por Uber Direct. |
| Conexión | Los responsables de ambos sistemas confirman el proyecto, la cuenta y la configuración del callback. | Que se haya intercambiado un pedido, estado o actualización de mensajero. |
| Pedido y sincronización de datos | Una prueba aprobada muestra los identificadores y estado previstos del pedido en cada sistema autorizado. | Que todos los pedidos futuros vayan a aceptarse o sincronizarse. |
| Despacho | El proveedor acepta la solicitud de prueba elegible y crea el flujo de entrega previsto. | Que un mensajero haya aceptado o completado la entrega. |
| Entrega | El estado del proveedor confirma la prueba aprobada completada. | Que se haya capturado el pago o entregado una notificación al cliente. |
| Pago | Esta guía no configura tarifas, cobros, reembolsos ni liquidación. Verifícalos mediante su propio flujo aprobado. | Una integración de entrega no demuestra autorización ni liquidación de pago. |
| Notificaciones | Los eventos de webhook son callbacks operativos, no pruebas de una notificación visible al cliente. Prueba las comunicaciones a clientes por separado. | Registrar un evento no demuestra que se haya enviado, leído ni cuándo se recibió una notificación. |
| Resultado | La misma prueba aprobada se puede rastrear a través del pedido, despacho y estado final del proveedor previstos. | Un ajuste visible, token guardado o botón de aplicación no es una transacción completada. |
Solución de problemas
El proveedor rechaza la configuración
Confirma que la cuenta, entorno, identificador de cuenta, Client ID y Client Secret provengan de la misma cuenta Uber Direct autorizada. No pegues ninguno de esos valores en una solicitud de soporte.
No aparece el estado ni la actualización del mensajero
Confirma que las rutas registradas usen el código de proyecto aprobado en minúsculas y que esté habilitado el evento correspondiente. Registrar una ruta no demuestra que se entregue un evento saliente; los responsables del proveedor y de los endpoints deben comprobar la prueba aprobada sin exponer datos enviados ni información de clientes.
Una entrega no aparece en Uber Direct
Comprueba que el pedido de prueba fuera elegible para el servicio previsto y se enviara al entorno correspondiente. Distingue entre crear el pedido, aceptar la entrega, asignar un mensajero y completar la entrega; cada etapa puede fallar de manera independiente.
Guías relacionadas: Plugins · Delivery services · Configurar un servicio de entrega
Página de integración Ordering.co: Uber Direct