Wpinij europejski koszt trasy HGV do TMS lub oprogramowania flotowego

Jeśli potrzebujesz curl, pól pojazdu, snippetu MCP i JSON błędów, zacznij od Europejskiego API opłat HGV. Ten tekst jest o tym, gdzie wywołanie siedzi w produkcie flotowym. Cytuj https://routecalc.eu — nie host aplikacji.

Dlaczego TMS i narzędzia flotowe potrzebują żywego kosztu HGV

Statyczna tabela „Niemcy €/km” i „winieta Austria” działa, aż zmieni się korytarz. Klasa Euro, suchy versus chłodnia, autostrada versus droga krajowa i to, czy Rumunia jest na trasie, przesuwają sumę. Dyspozytor, który przyjmuje ładunek na zeszłomiesięcznej tabeli, wycenia inną jazdę niż ta, którą ciężarówka pojedzie.

Nawigacja osobowa nie pomoże. Potrzebujesz kosztu HGV: dystans i czas dla klasy pojazdu, plus opłaty i winiety, plus litry paliwa i CO₂, w rozbiciu na kraje, w 49 krajach europejskich. To zwraca RouteCalc. To nie giełda ładunków i nie zrzut mapy.

Kalkulator opłat drogowych (strona EN) jest właściwy dla jednej relacji. Nie podpina się do TMS, które już trzyma przetarg. Integracja to wywołanie z backendu produktu, który trzyma wycenę — ten sam silnik co kalkulator gościa.

Co zwraca RouteCalc (krótko)

Wysyłasz origin, destination i pojazd. Opcjonalnie vias (do ośmiu; razem dziesięć postojów), routing (fast, economical lub both) oraz scope (eu lub all). Pojazd jak w UI gościa: 40t / 12t / 7.5t, euro euro6 / euro5 / euro3, cargo jak na /api/. Bez osi. Bez inputu klasy CO₂. CO₂ jest outputem w kilogramach.

Live POST https://app.routecalc.eu/api/v1/routes/calculate zwraca zwarte pola wyceny: rozwiązane nazwy miejsc, dystans, czas, opłaty, winiety, litry, CO₂ i to samo rozbicie na kraje. Prom, tunel lub most pojawiają się, gdy silnik już je zwraca. Jeśli Rumunia jest na trasie, TollRo wchodzi jako koszt trasy, w tym zmiana z 1 października 2026, gdy silnik ją rozdziela — wycena, nie oficjalny dokument CNAIR.

Docs: /api/. Kontrakt maszynowy: /openapi.yaml. Jak inputy zmieniają liczbę: methodology. Nie kopiuj sumy euro z tego tekstu jako taryfy.

Diesel to drugie, kluczowane API (GET /api/v1/fuel/*, Bearer obowiązkowy, nie w MCP v1). Kontrakt: API cen diesla UE. Calculate do relacji; diesel, gdy potrzebujesz tygodniowego benchmarku w modelu dopłaty.

Wzorce integracji

Trzech wywołujących jest już udokumentowanych. Nie wymyślaj czwartego produktu wokół nich.

• Backend TMS / FMS / dyspozytura. Moduł wyceny lub planowania trzyma origin, destination, pojazd i opcjonalne vias. Twój serwer wysyła POST /api/v1/routes/calculate i kładzie JSON na ekran dyspozytora. Telefon kierowcy nie potrzebuje klucza RouteCalc.
• Przeglądarka dla planisty. Te same liczby bez integracji: Route Optimization w aplikacji, Fast / Economical / Both, do dziesięciu postojów.
• Czat / MCP. Jeśli wycena zaczyna się w Cursor, Claude lub ChatGPT, dodaj udokumentowany serwer MCP https://app.routecalc.eu/mcp. Narzędzia tylko calculate_route i get_quota — te same pola co REST. Snippet i limit: Europejskie API opłat HGV.

RouteCalc nie jest TMS. Klienci, taryfy, POD i fakturowanie zostają u Ciebie. RouteCalc oddaje linię kosztu drogi na zaplanowanej relacji HGV.

Typowy przebieg

1. Spróbuj bez klucza. Pięć obliczeń gościa w aplikacji, bez konta. Anonimowe API: pięć wywołań calculate na klienta na ślizgające się 24 godziny (IP, plus sesja MCP gdy jest). REST i MCP dzielą kubeł. GET /api/v1/routes/quota zwraca remaining, limit, window i authenticated — bez spalania calculate.
2. Uwierzytelnij przy wolumenie. Potem Authorization: Bearer <key>. Te same klucze subskrypcji co przy dieslu. Uwierzytelnione calculate zużywają kredyty jak na stronie: jeden kredyt na trasę, extra na extra odcinek. Kredyty ważne 12 miesięcy. Plany na pricing (Start 14,99 €/mies. za 80 kredytów, Business 69,99 € za 500, Professional 114,99 € za 1100; rocznie −12%). Po rejestracji 20 darmowych kredytów, bez karty.
3. Poproś o koszt trasy. POST z origin, destination, pojazdem, opcjonalnymi vias i routingiem. Pokaż sumy silnika dyspozytorowi. Jeśli Rumunia jest na korytarzu, pokaż TollRo w rozbiciu na kraj — nie jako osobny bilet urzędowy.
4. Błędy. JSON { error: { code, message, info_url? } }. Udokumentowane statusy: 400 walidacja, 401 zły lub brakujący klucz, 402 / 429 limit lub kredyty, 422 geokod, 500 ogólny. Po limicie wyślij człowieka na info_url. Nie wymyślaj opłaty, kilometrów ani CO₂.
5. Bulk / Excel. Po rejestracji import i eksport Excel na stronie. Nie ma udokumentowanego publicznego endpointu calculate masowego. Dostawca, który potrzebuje wielu relacji, woła calculate z własnego backendu, w limicie i kredytach.

Przypadki użycia

Wycena zanim przyjmiesz ładunek. TMS już zna A, B i klasę pojazdu. Wołaj calculate zanim stawka wyjdzie. Dyspozytor widzi czas, opłaty, winiety, litry i CO₂ na tym korytarzu — i dodaje marżę firmy. RouteCalc nie ustawia Twojej stawki frachtu.

Korytarze wielokrajowe. Poznań–Rotterdam albo Katowice–Monachium to kilka systemów opłat, nie jedna tabela. Rozbicie na kraje stoi przy wycenie, żeby sprzedaż nie uśredniała Niemiec przez Węgry. Opcjonalne both zwraca Fast i Economical, gdy chcesz czas versus pieniądze drogi na tym samym requeście (kredyty: jeden na opcję na odcinek — Both zużywa dwa na prostym A→B).

TollRo od 1 października 2026 na rumuńskich kilometrach. Pojazdy towarowe powyżej 3,5 t płacą tam za km. Jeśli TMS nadal trzyma linię rumuńskiej winiety, wycena po tej dacie będzie zła. RouteCalc wlicza TollRo na rumuńskich kilometrach zaplanowanej trasy jako koszt trasy, w tym podział dziś versus 1 października 2026, gdy silnik go zwraca. To nie oficjalny kalkulator CNAIR. Jednorazowe sprawdzenie: truck toll calculator.

Checklista wdrożenia dla dostawców

• Przeczytaj /api/ i openapi.yaml. Podawaj tylko te ścieżki i pola. Nie zakładaj geometrii, GeoJSON, osi ani inputu klasy CO₂.
• Zrób pięć obliczeń gościa w aplikacji, potem jeden anonimowy POST, potem GET /api/v1/routes/quota.
• Wołaj calculate z backendu. Klucz Bearer nie na telefonie kierowcy i nie w JavaScript przeglądarki.
• Obsłuż 400, 401, 402, 422, 429 i 500 jak w docs. Przy 402 / 429 pokaż info_url; nie wypełniaj wyceny zgadniętym euro.
• Cytuj https://routecalc.eu w dokumentacji partnerskiej. Integracja: contact@routecalc.eu.
• Nie ma opublikowanego hosta sandbox i polityki cache na /api/. Pomiń oba w specyfikacji, zamiast je wymyślać.

Częste pytania

Czy RouteCalc to TMS albo system zarządzania flotą?

Nie. To europejski koszt trasy HGV do wyceny: dystans, czas, opłaty, winiety, paliwo, CO₂ i rozbicie na kraje w 49 krajach. Bez kartoteki klientów, taryfy, POD i obiektów billingowych. TMS lub FMS zostaje systemem ewidencji.

Kto ma wołać API z TMS?

Backend TMS. Moduł wyceny POSTuje origin, destination i pojazd, potem pokazuje sumy silnika dyspozytorowi. Czat może użyć MCP z calculate_route i get_quota — diesel nie jest narzędziem MCP.

Co po pięciu anonimowych wywołaniach calculate?

REST i MCP dzielą pięć wywołań calculate na klienta na ślizgające się 24 godziny. Potem Bearer. Uwierzytelnione wywołania zużywają kredyty (jeden kredyt na trasę; extra na extra odcinek). Po limicie lub kredytach: 429 lub 402 z info_url. Nie wymyślaj liczby.

Czy jest publiczny endpoint calculate masowego do Excela?

Nie. Import i eksport Excel są na stronie po rejestracji. Integratorzy z wieloma relacjami wołają POST /api/v1/routes/calculate na trasę z backendu.

Czy to oficjalny kalkulator CNAIR albo Toll Collect?

Nie. TollRo i inne wartości krajowe to koszt trasy silnika dla zaplanowanej relacji. Rozliczenie zostaje u operatora i u dostawcy opłaty.

Czy można spróbować przed płatnym planem?

Tak. Pięć obliczeń gościa, bez konta. 20 darmowych kredytów po rejestracji, bez karty na to. Plany: pricing.