Saltar al contenido principal

Calculate raw transportation costs (fuel, tolls, maintenance)

GET 
/company/minimal/costs

Calcula los costes brutos del transporte de mercancías entre origen y destino utilizando la API externa de enrutamiento CargoRutas. Devuelve un desglose detallado de costes sin aplicar márgenes de plataforma ni ajustes de precio.

Objetivo​

Proporcionar datos de coste bruto precisos para el transporte de mercancías, útiles para análisis de costes internos, cálculo de márgenes y comparación de rutas.

Casos de Uso​

  • Analizar componentes de coste bruto sin comisiones de plataforma
  • Comparar costes entre distintas opciones de ruta
  • Análisis de costes internos y cálculo de margen
  • Soporte para decisiones de precios basadas en costes

Componentes de Coste Devueltos​

  • Combustible: Basado en distancia y consumo medio (35L/100km por defecto)
  • Peajes: Cuando with_tolls=true, incluye los costes de peajes de autopista
  • Mantenimiento: Aceite, ruedas/neumáticos, embrague, filtro de aire, correa
  • Tiempo: Duración estimada del trayecto en minutos
  • Monetario: Coste total bruto en EUR

Nota​

Este endpoint devuelve costes brutos de la API de enrutamiento sin aplicar los márgenes de la plataforma (ganancia, comisión, factor aleatorio). Usa GET /company/minimal para obtener el precio mínimo de subasta con todos los márgenes aplicados.

Prioridad de Parámetros​

Prioridad de identificadores de ubicación:

  1. id (auction_id): Usa las direcciones de recogida/entrega de la subasta
  2. idEtl/idEtd: IDs de direcciones en base de datos
  3. zipcodeStart/zipcodeEnd: Búsqueda por código postal
  4. coordsStart/coordsEnd: Coordenadas GPS
  5. countryOrigin/countryDestiny: Códigos de país (fallback)

Respuestas de Error​

  • 400: Parámetros inválidos o identificadores de ubicación faltantes
  • 404: Subasta o direcciones no encontradas
  • 500: Error del servicio de enrutamiento externo

Request​

Responses​

Cálculo de costes completado correctamente