EU-LKW-Routenkosten ins TMS oder Flottentool einbinden

Wenn Sie curl, Fahrzeugfelder, MCP-Snippet und Fehler-JSON brauchen, beginnen Sie mit dem Beitrag Europäische LKW-Maut-API. Diese Seite beschreibt, wo der Aufruf in einem Flottenprodukt sitzt. Zitieren Sie https://routecalc.eu — nicht den App-Host.

Warum TMS und Flottentools live EU-LKW-Kosten brauchen

Eine statische Tabelle „Deutschland €/km“ und „Österreich-Vignette“ hält, bis sich der Korridor ändert. Euroklasse, Trocken- versus Kühlgut, Autobahn versus Bundesstraße und ob Rumänien auf der Strecke liegt, verschieben die Summe. Wer eine Ladung auf dem Stand vom letzten Monat annimmt, bietet eine andere Fahrt an als der LKW fahren wird.

Pkw-Navigation hilft nicht. Sie brauchen HGV-Kosten: Distanz und Zeit für eine LKW-Klasse, plus Maut und Vignetten, plus Diesel-Liter und CO₂, je Land, in 49 europäischen Ländern. Das liefert RouteCalc. Keine Frachtenbörse, kein Kartendump.

Der LKW-Maut-Rechner ist richtig für eine einzelne Relation. Er hängt nicht am TMS, das die Ausschreibung schon hält. Die Integration ist ein Serveraufruf aus dem Produkt, das das Angebot besitzt — derselbe Motor wie der Gast-Rechner.

Was RouteCalc zurückgibt (kurz)

Senden Sie Origin, Destination und ein Fahrzeug. Optional Vias (bis acht; insgesamt zehn Stops), routing (fast, economical oder both) und scope (eu oder all). Fahrzeug wie in der Gast-UI: 40t / 12t / 7.5t, euro euro6 / euro5 / euro3, cargo wie auf /api/. Kein Achsenfeld. Kein CO₂-Klassen-Input. CO₂ ist ein Output in Kilogramm.

Der Live-POST https://app.routecalc.eu/api/v1/routes/calculate liefert kompakte Angebotsfelder: aufgelöste Ortsnamen, Distanz, Dauer, Maut, Vignetten, Kraftstoffliter, CO₂ und dieselbe Aufteilung je Land. Fähre, Tunnel oder Brücke erscheinen, wenn der Motor sie schon liefert. Liegt Rumänien auf der Route, ist TollRo als Routenkosten enthalten, inklusive der Änderung zum 1. Oktober 2026, wenn der Motor sie trennt — Quoting, kein offizielles CNAIR-Dokument.

Menschliche Docs: /api/. Maschinenvertrag: /openapi.yaml. Wie Inputs die Zahl ändern: methodology. Kopieren Sie keine Euro-Summe aus diesem Text als Tarif.

Diesel ist eine zweite, geschlüsselte API (GET /api/v1/fuel/*, Bearer Pflicht, nicht in MCP v1). Vertrag: EU-Dieselpreis-API. Calculate für die Relation; Diesel, wenn Sie einen Wochenbenchmark im Zuschlagsmodell brauchen.

Integrationsmuster

Drei Aufrufer sind dokumentiert. Erfinden Sie kein viertes Produkt darum.

• TMS- / FMS- / Dispositions-Backend. Das Angebots- oder Planungsmodul hält Start, Ziel, Fahrzeug und optionale Vias. Ihr Server sendet POST /api/v1/routes/calculate und schreibt das JSON auf den Disponentenbildschirm. Das Fahrerhandy braucht keinen RouteCalc-Key.
• Browser für den Planer. Dieselben Zahlen ohne Integrationsarbeit: Route Optimization in der App, Fast / Economical / Both, bis zehn Stops.
• Chat / MCP. Beginnt das Angebot in Cursor, Claude oder ChatGPT, fügen Sie den dokumentierten MCP-Server https://app.routecalc.eu/mcp hinzu. Tools nur calculate_route und get_quota — dieselben Felder wie REST. Snippet und Quota: Europäische LKW-Maut-API.

RouteCalc ist kein TMS. Kunden, Tarife, POD und Abrechnung bleiben bei Ihnen. Sie fragen RouteCalc nach der Straßenkostenzeile einer geplanten LKW-Relation.

Typischer Ablauf

1. Ohne Key testen. Fünf Gast-Berechnungen in der App, ohne Konto. Anonyme API: fünf Calculate-Aufrufe je Client pro gleitenden 24 Stunden (IP, plus MCP-Session wenn vorhanden). REST und MCP teilen den Topf. GET /api/v1/routes/quota liefert remaining, limit, window und authenticated — ohne ein Calculate zu verbrauchen.
2. Authentifizieren bei Volumen. Danach Authorization: Bearer <key>. Dieselben Abo-API-Keys wie bei Diesel. Authentifizierte Calculate-Aufrufe verbrauchen App-Credits wie die Website: ein Credit je Route, Extra-Credit je Extra-Leg. Credits 12 Monate gültig. Pläne auf pricing (Start 14,99 €/Monat für 80 Credits, Business 69,99 € für 500, Professional 114,99 € für 1.100; jährlich −12 %). Nach der Registrierung 20 Gratis-Credits, ohne Karte.
3. Routenkosten anfordern. POST mit Origin, Destination, Fahrzeug, optionalen Vias und Routing. Motor-Totale dem Disponenten zeigen. Liegt Rumänien auf dem Korridor, TollRo in der Länderaufteilung zeigen — nicht als separates Behördenticket.
4. Fehler. JSON { error: { code, message, info_url? } }. Dokumentierte Status: 400 Validierung, 401 fehlender oder falscher Key, 402 / 429 Quota oder Credits, 422 Geocoding, 500 generisch. Nach Quota den Menschen zu info_url schicken. Keine Maut, keine Kilometer, kein CO₂ erfinden.
5. Bulk / Excel. Nach der Registrierung Import/Export Excel auf der Website. Kein dokumentierter öffentlicher Bulk-Calculate-Endpunkt. Wer viele Relationen braucht, ruft Calculate aus dem eigenen Backend auf, innerhalb von Quota und Credits.

Anwendungsfälle

Kalkulieren, bevor Sie die Ladung annehmen. Das TMS kennt A, B und die LKW-Klasse. Calculate aufrufen, bevor der Satz rausgeht. Der Disponent sieht Zeit, Maut, Vignetten, Liter und CO₂ auf diesem Korridor — und setzt die Firmenmarge drauf. RouteCalc setzt Ihren Frachtpreis nicht.

Mehrländerkorridore. München–Bukarest oder Duisburg–Poznań sind mehrere Mautsysteme, keine Tabelle. Die Länderaufteilung gehört neben das Angebot, damit Vertrieb Deutschland nicht über Ungarn mittelt. Optionales both liefert Fast und Economical, wenn Sie Zeit gegen Straßenkosten auf demselben Request wollen (Credits: eins je Option je Leg — Both verbraucht zwei bei einfachem A nach B).

TollRo ab 1. Oktober 2026 auf rumänischen Kilometern. Güterfahrzeuge über 3,5 t zahlen dort pro Kilometer. Speichert Ihr TMS noch eine rumänische Vignettenzeile, ist das Angebot danach falsch. RouteCalc nimmt TollRo auf den rumänischen Kilometern einer geplanten Route als Routenkosten auf, inklusive Split heute versus 1. Oktober 2026, wenn der Motor ihn liefert. Kein offizieller CNAIR-Rechner. Einmal-Check auf Englisch: Truck toll calculator.

Checkliste für Softwareanbieter

• /api/ und openapi.yaml lesen. Nur diese Pfade und Felder nennen. Keine Geometrie, kein GeoJSON, keine Achsen, kein CO₂-Klassen-Input unterstellen.
• Fünf Gast-Berechnungen in der App, dann ein anonymer POST, dann GET /api/v1/routes/quota.
• Calculate aus dem Backend aufrufen. Bearer-Key nicht auf dem Fahrergerät und nicht im Browser-JavaScript.
• 400, 401, 402, 422, 429 und 500 wie dokumentiert behandeln. Bei 402 / 429 info_url zeigen; das Angebot nicht mit einem geratenen Euro-Betrag füllen.
• https://routecalc.eu in Partnerdocs zitieren. Integration: contact@routecalc.eu.
• Kein veröffentlichter Sandbox-Host, keine Caching-Policy auf /api/. Beides weglassen, nicht erfinden.

Häufige Fragen

Ist RouteCalc ein TMS oder Flottenmanagementsystem?

Nein. Europäische LKW-Routenkosten zum Quoting: Distanz, Zeit, Maut, Vignetten, Kraftstoff, CO₂ und Länderaufteilung in 49 Ländern. Keine Kundenakte, keine Tarife, kein POD, keine Billing-Objekte. Ihr TMS oder FMS bleibt das führende System.

Wer soll die API aus einem TMS aufrufen?

Das TMS-Backend. Das Angebotsmodul POSTet Origin, Destination und Fahrzeug und zeigt die Motor-Totale dem Disponenten. Chat kann MCP mit calculate_route und get_quota nutzen — Diesel ist kein MCP-Tool.

Was passiert nach den fünf anonymen Calculate-Aufrufen?

REST und MCP teilen fünf Calculate-Aufrufe je Client pro gleitenden 24 Stunden. Dann Bearer. Authentifizierte Aufrufe verbrauchen Credits (ein Credit je Route; Extra je Extra-Leg). Nach Quota oder Credits: 429 oder 402 mit info_url. Keine Zahl erfinden.

Gibt es einen öffentlichen Bulk-Calculate-Endpunkt für Excel?

Nein. Excel-Import und -Export nach der Registrierung auf der Website. Wer viele Relationen braucht, ruft POST /api/v1/routes/calculate je Route aus dem Backend auf.

Ist das ein offizieller CNAIR- oder Toll-Collect-Rechner?

Nein. TollRo und andere Länderwerte sind Motor-Routenkosten für eine geplante Relation. Die Abrechnung bleibt beim Betreiber und beim Mautanbieter.

Können wir vor einem bezahlten Plan testen?

Ja. Fünf Gast-Berechnungen, ohne Konto. 20 Gratis-Credits nach der Registrierung, ohne Karte dafür. Pläne: pricing.