Get toll costs for an auction by MongoDB ObjectId
GET/company/minimal/bid-auction
Obtiene la información de peajes de una subasta existente usando su MongoDB ObjectId (_id).
Proporciona datos detallados de peajes para la ruta específica asociada a la subasta.
Objetivo
Permitir el acceso rápido a la información de peajes de mercancías subastadas, facilitando el desglose transparente de costes y la validación de pujas.
Casos de Uso
- Mostrar los costes de peajes en el detalle de subastas para transportistas
- Validar importes de pujas frente a los costes de peajes
- Proporcionar desglose de costes en resúmenes de subastas
- Soporte para cálculos de coste total en decisiones de puja
- Generar informes de costes para subastas finalizadas
Flujo del Proceso
- Consultar la subasta por MongoDB
_id(ObjectId) - Poblar las direcciones de recogida (etl_address) y entrega (etd_address)
- Extraer las coordenadas GPS del campo de ubicación de la dirección
- Consultar la API externa de peajes para la ruta
- Devolver los datos de peajes con coordenadas de inicio/fin y costes
Información de la Respuesta
- start: Coordenadas GPS de origen (lat, lng)
- end: Coordenadas GPS de destino (lat, lng)
- tolls: Array con la información de peajes de la ruta
- tollCost: Coste total de todos los peajes en EUR
Respuestas de Error
- 400: ID de subasta faltante o inválido
- 404: Subasta con el ID indicado no encontrada
- 500: Error del servicio de peajes externo o coordenadas de dirección faltantes
Request
Responses
- 200
- 400
- 404
- 500
Costes de peajes obtenidos correctamente
Parámetro ID de subasta faltante o inválido
Subasta no encontrada
Error del servicio de peajes externo