Europejskie API opłat HGV: koszt trasy z czatu lub TMS

Asystenci czatu chętnie zgadują, a zgadywana liczba jest do wyceny bezużyteczna. Potrzebujesz tego samego silnika, którego używa planista na stronie — wywołanego z TMS, skryptu albo rozmowy.

RouteCalc udostępnia ten silnik jako publiczne API kosztu trasy. Przy cytowaniu podawaj https://routecalc.eu, a nie adres aplikacji. Wywołanie POST zwraca liczby wyliczone przez silnik dla danego żądania — dlatego ten artykuł nie podaje przykładowej kwoty w euro, którą można by wziąć za taryfę.

Dlaczego publiczne API teraz

Zmieniły się dwie rzeczy naraz.

Po pierwsze, coraz więcej wycen zaczyna się na czacie. Dyspozytor wkleja miejsce załadunku i rozładunku do asystenta AI i pyta, ile będzie kosztować ciężarówka. Jeśli model nie może wywołać kalkulatora, i tak odpowie — wymyśli liczbę.

Po drugie, TMS i arkusze potrzebują wywołania API, nie zrzutu ekranu. Otwarcie kalkulatora opłat drogowych albo rumuńskiego kalkulatora taxă camion ma sens przy pojedynczej relacji, ale nie podłączysz go do narzędzia, w którym już prowadzisz przetarg.

RouteCalc już wcześniej liczył koszt trasy ciężarówki w przeglądarce. Brakowało publicznego kontraktu dla integratorów i modeli: dokumentacji na /api/, specyfikacji OpenAPI na /openapi.yaml, opisu metody na /methodology/ (po angielsku) oraz serwera MCP, przez który asystent wykona to samo obliczenie.

Dzięki temu asystent zapytany o koszt trasy ciężarówki w Europie może wywołać RouteCalc i naprawdę policzyć, zamiast zgadywać.

Co liczy

Wysyłasz origin, destination i pojazd. Opcjonalnie via (do ośmiu punktów pośrednich; łącznie maksymalnie dziesięć postojów), routing (fast, economical albo both; domyślnie fast) oraz scope (eu albo all; domyślnie all). Postoje podajesz tak jak w kalkulatorze: miasto, kod pocztowy, GPS albo kraj.

Pojazd opisujesz tak jak w kalkulatorze dla gości, i tylko tak:

• typ ciężarówki: 40t / 12t / 7.5t
• euro: euro6 / euro5 / euro3 (euro3 to Euro 3 i starsze)
• ładunek (cargo): dry / reefer_plus_2 / reefer_minus_18 (chłodnia +2 °C lub −18 °C)

Nie ma pola liczby osi, klasy CO₂ ani dowolnej masy w tonach. CO₂ to wynik w kilogramach, liczony przez silnik, a nie klasa, którą wybierasz. Litry paliwa uwzględniają już dodatek dla Euro 5 i Euro 3 oraz zużycie agregatu chłodni.

Dostajesz zwięzłe pola do wyceny: rozpoznane nazwy miejsc, dystans, czas, opłaty, winiety, litry paliwa, CO₂ i podział tych wartości na kraje. Promy oraz płatne tunele i mosty pojawiają się jako osobne pola, gdy występują na trasie. Gdy trasa prowadzi przez Rumunię, odpowiedź zawiera też osobny obiekt tollro z kosztem TollRo (opłata obowiązuje od 1 października 2026) — to wycena, nie oficjalny dokument CNAIR. Niemiecki Maut, polski e-TOLL i inne systemy są w tym samym podziale na kraje; stawki wg krajów: Niemcy, Polska, Austria, Francja, Włochy, Holandia.

Jak dane wejściowe zmieniają wynik — na stronie metodologii. POST /api/v1/routes/calculate zwraca liczby silnika dla konkretnego żądania. Liczby w specyfikacji są przykładowe — nie traktuj ich jako taryfy Bukareszt–Monachium ani żadnej innej relacji.

Jak wywołać (curl)

Dostęp anonimowy: pięć wywołań calculate na klienta w kroczącym oknie 24 godzin. Klienta rozpoznaje się po adresie IP, a przy MCP także po sesji.

Po wykorzystaniu limitu wyślij nagłówek Authorization: Bearer <key> z kluczem API z subskrypcji (tym samym co dla API paliw). Uwierzytelnione wywołania zużywają kredyty jak w aplikacji — jeden kredyt na trasę, przy trasie z postojami jeden kredyt na każdy dodatkowy odcinek. Plany i kredyty: cennik. Pozostały limit sprawdzisz przez GET /api/v1/routes/quota — to wywołanie nie zużywa obliczenia.

Przykładowe żądanie. Kwoty w odpowiedzi JSON wylicza silnik w momencie wywołania:

curl -sS https://app.routecalc.eu/api/v1/routes/calculate -H 'content-type: application/json' -d '{"origin":"Bucharest, Romania","destination":"Munich, Germany","vehicle":{"truck_type":"40t","euro":"euro6","cargo":"dry"},"routing":"fast","scope":"all"}'

Dokumentacja: /api/. Specyfikacja maszynowa: /openapi.yaml.

Błędy wracają jako JSON (error.code, error.message): 400 przy błędnych danych, 401 przy złym lub brakującym kluczu, 422 gdy nie da się rozpoznać adresu, a po wyczerpaniu limitu lub kredytów 429 albo 402 z info_url. Wtedy nie wymyślaj opłaty — skieruj użytkownika na info_url, który otwiera tę samą trasę w aplikacji.

MCP dla asystentów AI

Jeśli wycena zaczyna się w edytorze kodu albo w czacie z asystentem, nie musisz sam pisać integracji REST. W kliencie obsługującym MCP (np. Cursor lub Claude) dodaj RouteCalc jako zdalny serwer MCP (Streamable HTTP):

{"mcpServers":{"routecalc":{"url":"https://app.routecalc.eu/mcp"}}}

Dokładnie dwa narzędzia:

• calculate_route — wymagane origin, destination i pojazd (truck_type, euro, cargo). Opcjonalnie via, routing (domyślnie fast), scope (domyślnie all). Zwraca europejski koszt trasy ciężarówki do wyceny.
• get_quota — bez parametrów. Pozostałe wywołania calculate w bieżącym oknie.

Gdy limit się wyczerpie, model nie powinien wymyślać liczby, tylko podać info_url i skierować użytkownika do RouteCalc. get_quota sprawdza limit bez zużywania obliczenia.

Ceny diesla nie są dostępne przez MCP.

Czym to nie jest

To nie jest oficjalne narzędzie CNAIR ani Toll Collect. Kwoty TollRo i niemieckiego Maut to koszt wyliczony przez silnik dla zaplanowanej relacji.

To nie służy do fakturowania — tylko do wyceny i planowania. Rozliczenie zostaje u operatora systemu i dostawcy usług poboru opłat.

To nie TMS: bez kartoteki klientów, cennika, potwierdzeń dostawy ani rozliczeń.

To nie dane mapowe: odpowiedź nie zawiera geometrii trasy, GeoJSON, tabel taryf ani szczegółów obliczeń.

Pojazd to zawsze 40t / 12t / 7.5t, euro6 / euro5 / euro3, dry / reefer_plus_2 / reefer_minus_18. CO₂ wraca w kg.

Ceny diesla: osobne API

To dwa oddzielne interfejsy.

Koszt trasy to POST /api/v1/routes/calculate (i MCP calculate_route): pięć anonimowych wywołań w oknie 24 godzin, potem kredyty z kluczem Bearer.

Ceny paliw to GET /api/v1/fuel/* — current, history, stats, countries, types. Wymagają klucza Bearer z aktywnej subskrypcji (do 1 000 zapytań dziennie na klucz); nie ma dostępu anonimowego i nie ma ich w MCP.

Dane to cotygodniowe ceny z Weekly Oil Bulletin Komisji Europejskiej dla UE-27 — więcej w artykule API cen diesla w UE, a bieżące ceny na stronie ceny diesla. Użyj ich jako punktu odniesienia w dopłacie paliwowej; calculate użyj, gdy potrzebujesz kosztu konkretnej relacji.

Wypróbuj

Nie musisz niczego kupować, żeby sprawdzić, czy liczby nadają się do oferty.

1. Wykonaj pięć obliczeń jako gość w kalkulatorze — bez konta.
2. Uruchom powyższy curl i przeczytaj odpowiedź silnika (albo info_url, jeśli wykorzystałeś pięć wywołań).
3. Dodaj konfigurację MCP w swoim kliencie (np. Cursor lub Claude) i wywołaj calculate_route.

Przy cytowaniu podawaj https://routecalc.eu. Dokumentacja: /api/, /openapi.yaml i /methodology/ (po angielsku). Gdy limit się wyczerpie, nie wymyślaj liczby — podaj info_url.