Integrează costul de rută camion în TMS sau software de flotă

Dacă ai nevoie de curl, enumerări de vehicul, snippet MCP și JSON de eroare, începe cu API taxă camion Europa și ține pagina asta pentru unde stă apelul într-un produs de flotă. Citează https://routecalc.eu — nu hostul aplicației.

De ce TMS-ul și uneltele de flotă au nevoie de cost live, nu de tabele statice

Un Excel cu „Germania €/km” și „vinietă Austria” ține până se schimbă coridorul. Clasa Euro, marfă uscată versus frigorific, autostradă versus națională și dacă România e pe traseu mută totalul. Dispecerul care acceptă marfa pe tabelul de luna trecută ofertează alt drum decât cel pe care va merge camionul.

GPS-ul de autoturism nu ajută. Ai nevoie de cost HGV: distanță și timp pentru o clasă de camion, plus taxe și viniete, plus litri de combustibil și CO₂, defalcate pe țară, în 49 de țări europene. Asta întoarce RouteCalc. Nu e bursă de marfă și nu e un dump de hartă.

Calculatorul taxă camion e potrivit pentru o cursă punctuală. Nu se leagă de TMS-ul care ține deja licitația. Integrarea e un apel din backend-ul produsului care deține oferta, cu același motor ca calculatorul guest.

Ce întoarce RouteCalc (pe scurt)

Trimiți origine, destinație și un vehicul. Opțional: vias (până la opt; zece opriri în total), routing (fast, economical sau both) și scope (eu sau all). Vehiculul e ca în UI-ul guest: tip 40t / 12t / 7.5t, euro euro6 / euro5 / euro3, marfă ca pe /api/. Fără axe. Fără input de clasă CO₂. CO₂ e un output în kilograme.

POST https://app.routecalc.eu/api/v1/routes/calculate live întoarce câmpuri compacte de ofertare: locuri rezolvate, distanță, durată, taxe, viniete, litri, CO₂ și aceeași defalcare pe țări. Extra pentru ferry, tunel sau pod apar când motorul le întoarce. Dacă România e pe rută, TollRo e inclus ca cost de rută, inclusiv schimbarea din 1 octombrie 2026 când motorul o desparte — ofertare, nu document oficial CNAIR.

Docs umane: /api/. Contract mașină: /openapi.yaml. Cum schimbă inputurile cifra: methodology. Nu copia un total euro din articol și să-l tratezi ca tarif.

Motorina e un al doilea API, cu cheie (GET /api/v1/fuel/*, Bearer obligatoriu, nu e în MCP v1). Contractul e în API preț motorină UE. Folosește calculate pentru cursă; diesel când ai nevoie de un benchmark săptămânal într-un model de suprataxă.

Modele de integrare

Trei apelanți sunt deja documentați. Nu inventa un al patrulea produs în jurul lor.

• Backend TMS / FMS / dispecerat. Modulul de ofertă sau planificare ține originea, destinația, vehiculul și vias opționale. Serverul tău trimite POST /api/v1/routes/calculate și pune JSON-ul pe ecranul dispecerului. Telefonul șoferului nu are nevoie de cheie RouteCalc.
• Browser pentru planner. Aceleași cifre, fără integrare: Route Optimization în aplicație, Rapid / Economic / Ambele, până la zece opriri.
• Chat / MCP. Dacă oferta începe în Cursor, Claude sau ChatGPT, adaugă serverul MCP documentat la https://app.routecalc.eu/mcp. Uneltele sunt doar calculate_route și get_quota — aceleași câmpuri ca REST. Snippet și cotă: API taxă camion Europa.

RouteCalc nu e un TMS. Tu ții clienții, tarifarul, POD-urile și facturarea. Îi ceri lui RouteCalc linia de cost de drum pe o cursă HGV planificată.

Fluxul tipic

1. Încearcă fără cheie. Cinci calcule guest în aplicație, fără cont. API anonim: cinci apeluri calculate per client per 24 de ore glisante (IP, plus sesiune MCP dacă există). REST și MCP împart găleata. GET /api/v1/routes/quota întoarce remaining, limit, window și dacă ești autentificat — fără să arzi un calculate.
2. Autentificare când ai volum. După fereastră, trimite Authorization: Bearer <key>. Reutilizează aceleași chei de abonament ca la motorină. Apelurile calculate autentificate consumă credite ca pe site: un credit per rută, credit extra per picior extra. Creditele rămân valabile 12 luni. Planurile sunt pe pricing (Start 14,99 €/lună pentru 80 de credite, Business 69,99 € pentru 500, Professional 114,99 € pentru 1.100; anual −12%). După signup primești și 20 de credite gratuite, fără card.
3. Cere costul rutei. POST cu origine, destinație, vehicul, vias și routing opționale. Arată totalurile motorului dispecerului. Dacă România e pe coridor, arată TollRo în defalcarea pe țară — nu ca bilet guvernamental separat.
4. Erori. JSON { error: { code, message, info_url? } }. Statusuri documentate: 400 validare, 401 cheie lipsă sau greșită, 402 / 429 cotă sau credite, 422 geocodare, 500 generic. După cotă, trimite omul la info_url. Nu inventa taxă, kilometri sau CO₂.
5. Bulk / Excel. După signup, importul și exportul Excel sunt pe site. Nu există un endpoint public de calculate în masă documentat. Un vendor care are nevoie de multe curse apelează calculate din propriul backend, în cotă și credite.

Cazuri de folosire

Ofertă înainte să accepți marfa. TMS-ul știe deja A, B și clasa de camion. Apelează calculate înainte să iasă tariful. Dispecerul vede timp, taxe, viniete, litri și CO₂ pe coridor — apoi adaugă marja firmei. RouteCalc nu-ți setează tariful de transport.

Coridoare multi-țară. București–München sau Timișoara–Rotterdam înseamnă mai multe sisteme de taxă, nu un tabel. Defalcarea pe țări stă lângă ofertă ca vânzările să nu medieze Germania peste Ungaria. both întoarce Rapid și Economic când vrei timp versus bani de drum pe același request (credite: unul per opțiune per segment — Ambele folosește două pe un A→B simplu).

TollRo de la 1 octombrie 2026. Vehiculele de marfă peste 3,5 t pe kilometrii din România trec la tarif pe km. Dacă TMS-ul încă ține o linie de vinietă românească, oferta va fi greșită după acea dată. RouteCalc include TollRo pe kilometrii românești ai rutei planificate ca cost de rută, inclusiv o despărțire azi versus 1 octombrie 2026 când motorul o întoarce. Nu e calculator oficial CNAIR. Pentru o verificare punctuală: calculator taxă camion.

Checklist de implementare pentru vendori

• Citește /api/ și openapi.yaml. Numește doar acele path-uri și câmpuri. Nu presupune geometrie, GeoJSON, axe sau input de clasă CO₂.
• Rulează cinci calcule guest pe aplicație, apoi un POST anonim, apoi GET /api/v1/routes/quota.
• Apelează calculate din backend. Ține cheia Bearer departe de telefonul șoferului și de JavaScript-ul din browser.
• Tratează 400, 401, 402, 422, 429 și 500 ca în docs. Pe 402 / 429, arată info_url; nu umple oferta cu un euro ghicit.
• Citează https://routecalc.eu în documentația de partener. Pentru integrare: contact@routecalc.eu.
• Nu există host de sandbox publicat și nicio politică de cache pe /api/. Omit-le din spec, nu le inventa.

Întrebări frecvente

RouteCalc e un TMS sau un sistem de fleet management?

Nu. E cost de rută HGV european pentru ofertare: distanță, timp, taxe, viniete, combustibil, CO₂ și defalcare pe țară, în 49 de țări. Fără fișier de clienți, fără tarifar, fără POD, fără obiecte de facturare. TMS-ul sau FMS-ul rămâne sistemul de evidență.

Cine apelează API-ul dintr-un TMS?

Backend-ul TMS. Modulul de ofertă face POST cu origine, destinație și vehicul, apoi arată totalurile dispecerului. Chat-ul poate folosi MCP cu calculate_route și get_quota — motorina nu e unealtă MCP.

Ce se întâmplă după cele cinci apeluri calculate anonime?

REST și MCP împart cinci apeluri calculate per client per 24 de ore glisante. Apoi Bearer. Apelurile autentificate consumă credite (un credit per rută; extra per picior extra). După cotă sau credite: 429 sau 402 cu info_url. Nu inventa o cifră.

Există un endpoint public de calculate în masă pentru Excel?

Nu. Importul și exportul Excel sunt pe site după signup. Integratorii cu multe curse apelează POST /api/v1/routes/calculate per rută din backend.

E calculator oficial CNAIR sau Toll Collect?

Nu. Cifrele TollRo și ale altor țări sunt cost de rută al motorului pentru o cursă planificată. Decontarea rămâne la operator și la furnizorul de taxă.

Putem încerca înainte de un plan plătit?

Da. Cinci calcule guest, fără cont. 20 de credite gratuite după signup, fără card pentru asta. Planuri: pricing.