Server MCP

Dă-i lui Claude, Cursor sau oricărui agent AI compatibil MCP acces direct la e-facturare — validează, repară, generează și convertește facturi UE direct dintr-o conversație, fără nicio integrare separată de scris.

Ce este

CrateAPI oferă un server Model Context Protocol (MCP) pentru API-ul de e-facturare. Îndreaptă un agent compatibil MCP — Claude Desktop, Claude Code, Cursor sau propria ta buclă de agent — către el, și primește patru unelte pe care le poate apela direct: validează o factură, repară una, generează una din date structurate sau convertește între sintaxa UBL și CII. Agentul citește descrierile uneltelor și decide singur când să le folosească; logica de facturare rulează pe același API determinist din spatele restului CrateAPI.

Unelte disponibile

Patru unelte, un singur proces. Fiecare face proxy către exact același API public pe care îl poți apela prin HTTP — aceleași reguli, aceleași limite, aceleași răspunsuri.

validate_invoicegratuit

Verifică un XML de factură (UBL sau CII) față de regulile oficiale EN 16931, Peppol BIS, XRechnung, RO_CIUS și BR-FR. Întoarce un raport structurat — validă sau nu, numărul de erori/avertismente, constatări. Nu necesită cheie API.

repair_invoicenecesită cheie API

Auto-reparare pe bază de efort rezonabil: repară formatele de dată non-ISO și totalurile care nu se adună, recalculate din liniile facturii. Nu inventează niciodată date de business lipsă — raportează ce a putut repara și ce nu.

generate_invoicenecesită cheie API

Construiește un XML de factură conform (UBL sau CII) dintr-un model JSON structurat de factură — furnizor, client, linii, totaluri.

convert_invoicenecesită cheie API

Convertește o factură între sintaxa UBL și CII, fără pierderi sau respinsă: dacă ceva nu se poate converti curat, operația eșuează cu un motiv clar, în loc să piardă date pe tăcute.

Cum îl rulezi

Self-hosted, funcționează chiar azi cu propria ta cheie API. Adaugă asta în configurația clientului tău MCP — Claude Desktop, Claude Code, Cursor sau orice alt agent compatibil MCP:

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

validate_invoice nu necesită deloc cheie. Celelalte trei citesc EINVOICE_API_KEY din mediul de execuție — obține una pe pagina de prețuri. EINVOICE_API_BASE poate suprascrie API-ul țintă, util pentru a îndrepta către o instanță locală sau de test.

Self-hosted, deocamdată. Încă nu există un endpoint găzduit mcp.crateapi.com — rulezi serverul tu însuți, un singur proces Python (python -m einvoicing.mcp_server), care apelează același API de producție cu propria ta cheie. Dacă apare cerere suficientă pentru o variantă găzduită, o vom construi; până atunci, ăsta e stadiul onest al lucrurilor.

De ce contează

Agenții AI redactează, verifică și depun tot mai des documente de business. Dacă al tău poate apela aceste unelte direct, poate valida o factură înainte să fie trimisă, sau poate genera una conformă la cerere — în loc să greșească formatul și să afle asta abia peste câteva zile, dintr-o respingere. Motorul din spatele uneltelor e același din spatele restului CrateAPI — determinist, zero LLM la runtime (vezi Trust & Security) — agentul decide când apelează o unealtă, regulile facturii în sine rămân bazate pe reguli, niciodată ghicite.

Vrei să verifici singur?

Fiecare unealtă de mai sus apelează același API pe care îl poți apela chiar azi — citește referința completă sau încearcă validatorul gratuit cu propria ta factură.

Încearcă validatorul gratuit Citește documentația