Integrar TollCalc en su aplicación

TollCalc se puede integrar de tres formas en su propio software o flujos de IA:

Método	Adecuado para
API REST	Integración servidor a servidor, backends propios
MCP (Model Context Protocol)	Asistentes de IA (Claude, Cursor, GPT, etc.)
Paquete Python `tollcalc`	Scripts, ciencia de datos, notebooks Jupyter

API REST

La documentación completa de la API (OpenAPI 3.0) se encuentra en:

tollcalc.eu/en/api.html

Inicio rápido

curl -X POST https://app.tollcalc.eu/api/calculate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TU_TOKEN_API" \
  -d '{
    "origin": "Munich, Germany",
    "destination": "Vienna, Austria",
    "vehicle": {
      "weight": 40,
      "axles": 5,
      "emission_class": "euro6",
      "co2_class": "class_1"
    }
  }'

Parámetros

Parámetro	Tipo	Descripción
`origin`	string	Punto de partida: dirección o `"lat;lon"`
`destination`	string	Punto de destino: dirección o `"lat;lon"`
`via`	string[]	Paradas intermedias opcionales (máx. 48)
`vehicle.weight`	number	Masa total en toneladas (p. ej. 40)
`vehicle.axles`	integer	Número de ejes: 2, 3, 4 o 5
`vehicle.emission_class`	string	Norma Euro: `euro0`–`euro6`
`plannedTripStart`	string	Fecha ISO-8601 opcional (`"2026-09-01"`) o fecha-hora RFC3339 (`"2026-09-01T06:00:00Z"`); selecciona las reglas de peaje vigentes en ese momento. Por defecto: ahora

Cabecera HTTP opcional:

Cabecera	Descripción
`X-Subaccount`	Atribución de uso opcional, p. ej. para una empresa cliente o un departamento. Se cuenta por subcuenta y se muestra en tus estadísticas de uso. Ausente/vacío → `Default`; máx. 64 caracteres; permitidos `A-Z a-z 0-9 _ : -`; no válido → HTTP 400

Uso y cuota

Una vez integrada la API, puede obtener su consumo y su cuota de forma programática: ambos endpoints son read-only, no consumen cuota y aceptan el mismo bearer token:

Endpoint	Descripción
`GET /api/usage`	Cálculos correctos del mes, desglosados por `X-Subaccount`
`GET /api/quota`	Consumo, límite mensual y cuota restante

Parámetros de consulta opcionales: year y month (por defecto: mes actual).

# Uso por subcuenta
curl https://app.tollcalc.eu/api/usage \
  -H "Authorization: Bearer TU_TOKEN_API"
# {"year":2026,"month":9,"total":1000,
#  "sub_accounts":[{"key":"kunde_a","count":500},{"key":"Default","count":320}]}

# Cuota restante
curl https://app.tollcalc.eu/api/quota \
  -H "Authorization: Bearer TU_TOKEN_API"
# {"year":2026,"month":9,"plan":"api","used":123,"limit":5000,"remaining":4877}

Sin la cabecera X-Subaccount en un cálculo, las llamadas se atribuyen a la clave Default. En planes ilimitados, limit y remaining son null.

MCP (Model Context Protocol)

Para asistentes de IA como Claude, Cursor o GPT existe un servidor MCP que expone la calculadora como herramienta. Así los asistentes pueden calcular peajes directamente desde el chat – ideal para planificación de rutas, consultas de costes o integración en agentes de logística.

Python

El paquete tollcalc permite calcular peajes directamente desde Python:

from tollcalc import calculate_toll, get_usage, get_quota

result = calculate_toll(
    origin="Munich, Germany",
    destination="Vienna, Austria",
    weight=40,
    axles=5,
    emission_class="euro6",
)

print(result['total_toll_eur'])

# Uso y cuota
usage = get_usage(token="TU_TOKEN_API")
print(usage["total"], "Calls")
quota = get_quota(token="TU_TOKEN_API")
print(f"{quota['used']} / {quota['limit']} – restante: {quota['remaining']}")

Planes de API

El plan API incluye 1 usuario web + 2.000 llamadas API gratuitas al mes. Después: 0,005 € por llamada. Ejemplo: 10.000 llamadas = 65 €/mes. Los tokens de autenticación propios y los límites de llamadas por token están incluidos.

→ Documentación de la API | → Plan API

FAQ

¿Qué métodos ofrece TollCalc para integrarse?

Tres: la API REST para integraciones servidor a servidor, MCP para asistentes de IA y el paquete Python tollcalc para scripts y notebooks.

¿Cómo empiezo a usar la API REST de TollCalc?

Con una petición POST a /api/calculate con origen, destino y los datos del vehículo, usando un token Bearer. La documentación OpenAPI está en tollcalc.eu/en/api.html.

¿Cómo consulto mi consumo y mi cuota de API?

Con los endpoints de solo lectura GET /api/usage y GET /api/quota, que no consumen cuota y aceptan el mismo token.