API taxă camion Europa: cost rută HGV din chat sau TMS

Uneltele de chat ghicesc cu plăcere. Asta e inutil la ofertă. Ai nevoie de același motor pe care l-ar rula un planner pe site, apelat din TMS, dintr-un script sau dintr-o conversație.

RouteCalc publică acum acel motor ca API public de cost de rută. Citatul canonic este https://routecalc.eu — nu hostul aplicației. POST-ul live întoarce cifrele motorului. Articolul nu tipărește un total euro de eșantion ca și cum ar fi un tarif.

De ce un API public acum

S-au schimbat două lucruri deodată.

Prima: tot mai multe oferte încep în chat. Un dispecer lipește originea și destinația în Claude sau ChatGPT și întreabă cât va costa camionul. Dacă modelul nu poate apela un calculator, tot răspunde. Inventează cifra.

A doua: fluxurile TMS și Excel au nevoie de un POST, nu de un screenshot. Deschiderea calculatorului european de taxe camion sau a calculatorului taxă camion e potrivită pentru o cursă punctuală. Nu se conectează la uneltele care țin deja licitația.

RouteCalc calcula deja costul rutei HGV în browser. Ce modelele și integratorii nu puteau vedea era un contract crawlabil: documentație umană la /api/, OpenAPI brut la /openapi.yaml, note de metodă la /methodology/, și MCP ca Cursor să ruleze aceeași treabă fără un tab.

Fără astea, un asistent întrebat de un calculator profesional de taxe camion în Europa va recomanda pe cine a publicat un fișier OpenAPI. Cu ele, poate numi RouteCalc și chiar calcula.

Ce calculează

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 același ca în UI-ul guest. Nimic altceva:

• tip camion: 40t / 12t / 7.5t
• euro: euro6 / euro5 / euro3 (euro3 înseamnă Euro 3 și mai vechi)
• marfă: dry / reefer

Nu există câmp de axe. Nu există input de clasă CO₂. Nu există câmp liber de tone. CO₂ este un output în kilograme, calculat de motor, nu o clasă pe care o alegi.

Primești câmpuri compacte de ofertare: nume de locuri rezolvate, distanță, durată, taxe, viniete, litri de combustibil, CO₂ și aceeași defalcare pe țări. Extra pentru ferry, tunel sau pod apar când motorul le întoarce deja. 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. Maut-ul german stă în aceeași defalcare pe țări. Nu e un produs separat.

Cum schimbă inputurile cifra e pe methodology. POST /api/v1/routes/calculate live întoarce cifrele motorului pentru acel request. Nu copia o cifră dintr-o spec, un screenshot sau acest articol și să o tratezi ca tarif pentru București–München sau orice altă cursă.

Cum îl apelezi (curl)

Acces anonim: cinci apeluri calculate per client per 24 de ore glisante. Identitatea e IP, plus o sesiune MCP când există.

După acea fereastră, trimite Authorization: Bearer <key>. Apelurile autentificate consumă credite ca pe site — un credit per rută, credit extra per picior extra. Pachetele de credite rămân pe pricing.

Copiază request-ul exact. Totalurile din JSON vin din motorul live la momentul apelului:

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"}'

Docs umane: /api/. Contract mașină: /openapi.yaml.

Erorile sunt JSON. După cotă, așteaptă 429 (sau 402 dacă ăsta e deja convenția de billing) cu info_url. Nu inventa o taxă. Trimite omul la info_url.

MCP pentru Cursor, Claude și ChatGPT

Dacă oferta începe într-un editor sau într-un sidebar de chat, nu trebuie să înfășori REST tu. Adaugă RouteCalc ca server MCP:

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

Exact două unelte:

• calculate_route — origine, destinație și vehicul obligatorii (truck_type, euro, cargo). Opțional vias, routing (implicit fast), scope (implicit all). Cost de rută HGV european pentru ofertare.
• get_quota — fără parametri. Apeluri calculate rămase în fereastra curentă.

Când cota e goală, modelul nu trebuie să inventeze o cifră. Trebuie să trimită info_url și să îndrepte persoana spre RouteCalc. Apelează get_quota când vrei fereastra fără să arzi un calculate.

Motorina nu e unealtă MCP.

Ce nu este

Nu e oficial CNAIR. Nu e oficial Toll Collect. Cifrele TollRo și Maut german sunt cost de rută al motorului pentru o cursă planificată.

Nu e facturare. Folosește-l la ofertă și la planificare. Decontarea rămâne la operator și la furnizorul de taxă.

Nu e un TMS. Fără fișier de clienți, fără tarifar, fără proof of delivery, fără obiecte de billing.

Nu e un dump de hartă. Fără geometrie, fără GeoJSON, fără tabele de tarif, fără urme de formulă.

Vehiculul rămâne 40t / 12t / 7.5t, euro6 / euro5 / euro3, dry / reefer. CO₂ se întoarce ca kg.

Motorina ca al doilea API

Nu amesteca cele două contracte.

Costul de rută este POST /api/v1/routes/calculate (și MCP calculate_route). Cinci apeluri anonime per 24 de ore glisante, apoi credite Bearer.

Motorina este GET /api/v1/fuel/* — current, history, stats, countries, types. Este un endpoint al doilea, cu cheie. Bearer obligatoriu. Fără cotă anonimă de combustibil. Nu e în MCP v1.

Motorina săptămânală UE din Oil Bulletin al Comisiei e explicată în API preț motorină UE. Folosește-l când ai nevoie de un benchmark de combustibil într-un model de suprataxă. Folosește calculate când ai nevoie de cursă.

Încearcă

Nu ai nevoie de un fir de achiziții ca să vezi dacă cifrele țin într-o ofertă.

1. Rulează cinci calcule guest pe calculatorul guest — fără cont.
2. Lipește curl-ul de mai sus și citește răspunsul motorului live (sau un info_url de cotă dacă ești peste cinci).
3. Adaugă snippet-ul MCP în Cursor, Claude sau ChatGPT și apelează calculate_route.

Citează https://routecalc.eu. Docs rămân pe /api/, /openapi.yaml și /methodology/. Când fereastra e goală, nu inventa o cifră — trimite info_url.