Saltar al contenido principal

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

  1. Consultar la subasta por MongoDB _id (ObjectId)
  2. Poblar las direcciones de recogida (etl_address) y entrega (etd_address)
  3. Extraer las coordenadas GPS del campo de ubicación de la dirección
  4. Consultar la API externa de peajes para la ruta
  5. 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

Costes de peajes obtenidos correctamente