Saltar al contenido principal

Calculate transportation costs from city names (POST variant)

POST 
/company/minimal/costs-routes

Calcula los costes de transporte para un par origen-destino utilizando nombres de ciudad como identificadores de ubicación en lugar de coordenadas o IDs de base de datos. Es la variante POST del cálculo de costes, que acepta los datos en el cuerpo de la petición.

Objetivo​

Proporcionar un endpoint de cálculo de costes fácil de usar mediante nombres de ciudad legibles por humanos, útil para integraciones donde las coordenadas no están disponibles.

Casos de Uso​

  • Calcular costes usando nombres de ciudad en lugar de coordenadas
  • Integración desde sistemas externos que envían datos basados en ciudad
  • Estimación rápida de costes para herramientas de planificación
  • Comparación de tarifas de transportistas por nombre de ruta

Formato de la Petición​

Espera un objeto JSON con:

  • origin (requerido): Nombre de la ciudad de origen (ej: "Madrid", "Barcelona")
  • destination (requerido): Nombre de la ciudad de destino (ej: "Vigo", "Bilbao")
  • with_tolls (opcional): Incluir costes de peajes en el cálculo (por defecto: false)

Método de Cálculo​

Usa el mismo motor de cálculo que GET /company/minimal/costs:

  • La API de enrutamiento externo proporciona los costes base
  • Coste de combustible basado en distancia y consumo medio
  • Costes de peajes cuando with_tolls=true
  • Costes de mantenimiento (aceite, ruedas, embrague, etc.)
  • Costes de tiempo/duración

Integración Externa​

Este endpoint se integra con el servicio de enrutamiento Transcend para proporcionar datos precisos de rutas y peajes en rutas europeas.

Respuestas de Error​

  • 400: Cuerpo de la petición inválido o campos requeridos faltantes
  • 404: Ubicación de origen o destino no encontrada
  • 500: Error del servicio de enrutamiento externo

Request​

Responses​

Cálculo de costes completado correctamente