API de peajes: integrar el cálculo de peajes en tu software
Respuesta directa: una API de peajes recibe una ruta (polilínea o waypoints), un perfil de vehículo y un método de pago, y devuelve el coste de peaje desglosado por tramos. Tolls Calculator expone dos puertas de entrada documentadas en su corpus técnico: el endpoint específico de peajes POST https://back.transcend.cargoffer.com/api/v1/tolls/calculate y el endpoint de costes completos POST https://api.cargoffer.com/costs/calculate, que suma peaje, combustible y coste de conductor.
Autenticación
Ambos endpoints se autentican con cabecera Authorization: Bearer <API_KEY>. La clave se solicita al equipo de producto; no se publica en documentación ni en código del frontend.
Endpoint de peajes
POST https://back.transcend.cargoffer.com/api/v1/tolls/calculate
{
"polyline": "<polilínea codificada>",
"vehicle_class": "CLASS_4",
"payment_method": "VIA_T"
}
Respuesta (cifras ilustrativas):
{
"total_toll_cost_eur": 45.8,
"currency": "EUR",
"toll_sections": [
{ "name": "AP-1", "cost": 22.4, "distance_meters": 82000 }
]
}
Parámetros clave: polyline (geometría de la ruta), vehicle_class (CLASS_1 a CLASS_4 para pesados) y payment_method (TELEPASS, VIA_T, CASH, CARD). La referencia completa está en Especificación del endpoint de peajes.
Endpoint de costes totales
Para precificar un trayecto completo, POST https://api.cargoffer.com/costs/calculate acepta vehicle_profile (ejes, masa, clase EURO) y financials (precio de combustible, consumo medio, coste por hora de conductor), y devuelve el total con desglose de peaje, combustible y conductor. Está documentado en API de peajes Europa (calculadora de costes), disponible también bajo /resources.
Cómo elegir entre calculadora, API y SDK
- Validación puntual: la calculadora interactiva en
/live-demo. - Backend propio: REST directo desde Python (guía Python) o Node.js/TypeScript (guía Node.js).
- Agentes y LLM: la misma API se consume desde MCP o Actions; ver MCP de peajes.
Buenas prácticas de integración
- Cachea por ruta + fecha, no por ciudad. Un cambio de tarifa o de geometría invalida el resultado.
- Guarda la fecha de cada consulta. Al auditar facturas necesitarás probar qué tarifa estaba vigente.
- Valida el perfil de vehículo antes de llamar. Una clase mal informada es la causa nº 1 de desviaciones.
- Trata el resultado como estimación hasta el paso real por la infraestructura.
Aviso: todos los importes de esta página son ilustrativos; el resultado real depende de las tarifas vigentes en la consulta.