API e-Factura (validare și generare XML)

Validezi facturile e-Factura și afli exact ce reguli CIUS-RO pică, generezi XML UBL din JSON simplu (datele părților se completează din CUI), transformi facturile primite în JSON și obții PDF-ul. Nu trimite facturile în SPV; le pregătește și le verifică.

Cheie gratuită (100 credite)Documentație

Exemplu curl

curl -X POST "https://api.howtoromania.io/v1/efactura/validate" -H "x-api-key: htr_demo" -H "content-type: application/xml" --data-binary @invoice.xml
curl -X POST "https://api.howtoromania.io/v1/efactura/generate" -H "x-api-key: $HTR_KEY" -H "content-type: application/json" \
  -d '{"number":"INV-1","seller":{"vatId":"DE123456789","name":"Acme GmbH","street":"Hauptstr 1","city":"Berlin","country":"DE"},"buyer":{"cui":"14399840"},"currency":"EUR","vatToRonRate":5.09,"lines":[{"name":"Consulting","quantity":10,"unitCode":"HUR","unitPrice":120,"vatCategory":"AE","vatRate":0}]}'

Cheie gratuită: curl -X POST https://api.howtoromania.io/v1/keys -H "content-type: application/json" -d '{"email":"you@example.com","accept_terms":true}'

Exemplu MCP

{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }

Cere agentului: “ANAF a respins acest XML. Validează-l și spune-mi exact ce reguli nu trec și cum le repar.”

Endpoint-uri și prețuri

ServiciuEndpointCredite≈ EUR
Validate invoice XML
validated with ANAF's public validation service (CIUS-RO) + local checks, rule codes		POST /v1/efactura/validate
MCP validate_efactura		1€0.005
Generate invoice XML
CIUS-RO UBL from simple JSON; parties auto-filled from CUI; validated with ANAF's public validation service		POST /v1/efactura/generate
MCP generate_efactura		2€0.010
Parse invoice XML
UBL Invoice/CreditNote -> English JSON		POST /v1/efactura/parse
MCP parse_efactura		1€0.005
Invoice PDF
rendered with ANAF's public PDF service		POST /v1/efactura/pdf
MCP efactura_to_pdf		1€0.005

Pachete preplătite (TVA inclus): €5 = 1,000 · €20 = 5,000 · €100 = 30,000 credits. 100 credite gratuite per cheie, fără contract.

De ce HowToRomania

  • JSON în engleză, gata de folosit de agenți AI și de cod
  • Firme, dosare în instanță, e-Factura și legislație în vigoare într-un singur API
  • REST și server MCP remote cu aceleași chei
  • Plată per apel (1 credit = 0,005 €), fără contract; erorile nu se taxează
  • 100 de credite gratuite la fiecare cheie
  • Abonamente pentru volume mari, la cerere: hello@howtoromania.io.

Întrebări frecvente

Trimite facturile în SPV?

Nu. Validează, generează, parsează și afișează PDF-ul. Încărcarea în SPV rămâne în programul de facturare.

Cât costă?

Plătești per apel reușit, în credite (1 credit = 0,005 €). Fiecare cheie primește 100 de credite gratuite. Pachete: 5 € = 1.000 credite, 20 € = 5.000 credite, 100 € = 30.000 credite. Preplătit, fără contract; erorile și „negăsit” nu se taxează.

Pot testa fără cont?

Da. Cheia demo htr_demo merge pe endpoint-urile de 1 credit, cu o limită zilnică per IP. O cheie gratuită cu 100 de credite se obține cu un singur POST la /v1/keys.

Este un serviciu oficial ANAF?

Nu. HowToRomania este un serviciu independent care preia surse publice (ANAF, date deschise ONRC, BNR, portal.just.ro, legislatie.just.ro) și le livrează ca JSON. Nu este afiliat sau aprobat de vreo autoritate. Doar informativ; nu este consultanță juridică sau de credit.