Get delivery information by QR token
GET/company/qr/:token
Recupera toda la información de una entrega a partir de su token QR único.
El token QR se genera al crear la entrega. Al escanear el QR con la app móvil, este endpoint devuelve los detalles de la entrega y en el proceso rota el token:
- Elimina el
qr_tokende la entrega - Genera un nuevo
confirm_token(usado enPUT /confirm)
Este endpoint es PÚBLICO — no requiere autenticación.
Flujo típico de uso
- El transportista llega al destino y escanea el QR
- La app llama a este endpoint con el token del QR
- Se muestran los detalles de la entrega al firmante
- El firmante confirma mediante
PUT /company/qr/confirm
Campos devueltos
- Datos del envío (
service_code,status,cargo_type, etc.) - Dirección de carga y descarga (
etl_address,etd_address) - Vehículo y conductor asignado
- Fechas estimadas y reales
confirm_tokenpara usar en la confirmación
Notas técnicas
- Código fuente:
src/features/company/qr_delivery/controller.js→getDeliveryFromToken - El
qr_tokenoriginal queda invalidado tras la primera consulta - El
confirm_tokengenerado es necesario para completar la entrega
Request
Responses
- 200
- 404
- 500
Información de la entrega obtenida correctamente
Entrega no encontrada. Puede ocurrir cuando:
- El token QR no existe, ya ha sido usado o ha expirado
- La entrega fue eliminada del sistema
- El formato del token es incorrecto
Error interno del servidor al consultar la base de datos