Skip to main content

Calculate raw transportation costs (fuel, tolls, maintenance)

GET 
/company/minimal/costs

Calculate the gross costs of freight transport between origin and destination using the external CargoRutas routing API. Return a detailed breakdown of costs without applying platform margins or price adjustments.

Objective​

Provide accurate gross cost data for freight transport, useful for internal cost analysis, margin calculation, and route comparison.

Use Cases​

  • Analyze gross cost components without platform commissions
  • Compare costs between different route options
  • Internal cost analysis and margin calculation
  • Support for cost-based pricing decisions

Cost Components Returned​

  • Fuel: Based on distance and average consumption (35L/100km default)
  • Tolls: When with_tolls=true, includes highway toll costs
  • Maintenance: Oil, tires, clutch, air filter, belt
  • Time: Estimated journey duration in minutes
  • Monetary: Total gross cost in EUR

Note​

This endpoint returns gross costs from the routing API without applying platform margins (profit, commission, random factor). Use GET /company/minimal to obtain the minimum auction price with all margins applied.

Parameter Priority​

Location identifier priority:

  1. id (auction_id): Use the pickup/delivery addresses from the auction
  2. idEtl/idEtd: Address IDs in the database
  3. zipcodeStart/zipcodeEnd: Search by postal code
  4. coordsStart/coordsEnd: GPS coordinates
  5. countryOrigin/countryDestiny: Country codes (fallback)

Error Responses​

  • 400: Invalid parameters or missing location identifiers
  • 404: Auction or addresses not found
  • 500: External routing service error

Request​

Responses​

Cost calculation completed successfully