Marketplace externo
Enviar tracking del rider externo
Usa operations.tracking.url y operations.tracking.bearerToken del evento de adjudicación. El token actual vence cuatro horas después de emitirse y queda revocado si la adjudicación falla o el pedido se cancela. Tracking es telemetría: publicar una posición nunca cambia el estado del pedido.
Auth requerida Perfil: Bearer temporal de tracking
Requisitos para durante el reparto adjudicado
- Enviar Authorization: Bearer con el token de tracking.
- No usar este token para actualizar estados de pedido.
- No existe una frecuencia mínima impuesta por el backend.
Campos principales
Resumen de los campos relevantes para este endpoint.
| Campo | Tipo | Uso | Descripción |
|---|---|---|---|
orderId | uuid | Path param | Debe coincidir con el pedido vinculado al token. |
lat / lng | number | Obligatorio | Coordenadas WGS84 dentro de sus rangos válidos. |
recordedAt | ISO 8601 | Obligatorio | Instante en el que el dispositivo registró la posición. |
heading / speed / accuracy | number | null | Opcional | Telemetría adicional del dispositivo. |
Alcance del token
El tracking y el estado operativo son contratos distintos.
- La respuesta correcta es 202 con data.accepted: true.
- Un token ausente, expirado, revocado o asociado a otro pedido se rechaza.
- La posición publicada no acredita una llegada ni actualiza el estado operativo.
- El token de tracking externo no autoriza cambios de estado; usa operations.status.url y el STATUS_TOKEN de la adjudicación.
Request JSON
{
"lat": 38.344498,
"lng": -0.509259,
"heading": 120,
"speed": 8.5,
"accuracy": 5,
"recordedAt": "2026-07-15T10:25:00.000Z"
}Request cURL
curl -X POST 'https://api.operiohub.com/api/marketplace/orders/11111111-1111-4111-8111-111111111111/external-rider-location' \
+ -H 'Authorization: Bearer TRACKING_TOKEN' \
+ -H 'Content-Type: application/json' \
+ -d '{"lat":38.344498,"lng":-0.509259,"recordedAt":"2026-07-15T10:25:00.000Z"}'Errores esperados
Respuestas habituales que debe contemplar la integración.
Payload inválido
orderId o ubicación no cumplen el contrato.
Token inválido
Falta el Bearer, no existe o ha caducado.
Pedido no coincide
El token pertenece a otro pedido.