Confirmar entrega mediante token QR
PUT/qr/confirm
Este endpoint permite confirmar una entrega utilizando el token QR y código de servicio. Al confirmar una entrega:
- Se marca como completada en el sistema
- Se invalida el token de confirmación
- Se registra la fecha/hora exacta de confirmación
Casos de uso:
- Confirmar entrega al llegar al destino
- Registrar finalización exitosa de un servicio
- Actualizar estado de entregas en tiempo real
Requisitos:
- Token QR válido obtenido del endpoint GET /{token}
- Código de servicio asociado a la entrega
Request
Responses
- 200
- 404
Entrega confirmada exitosamente. Devuelve los datos actualizados de la entrega. Ejemplo:
{
"_id": "5f8d3a1b2c3d4e5f6a7b8c9d",
"service_code": "SRV-2023-001",
"status": "delivered",
"confirmed": true,
"date_eta": "2023-10-15T14:30:00Z",
"date_delivered": "2023-10-15T14:25:00Z"
}
Entrega no encontrada. Posibles causas:
- El token o código de servicio no son válidos
- La entrega ya fue confirmada previamente
- La entrega fue cancelada o eliminada