API verificare plătitor TVA după CUI

Afli printr-un singur apel dacă o firmă este înregistrată în scopuri de TVA, dacă aplică TVA la încasare, dacă figurează ca inactivă și dacă este în Registrul RO e-Factura. Util la facturare, la adăugarea unui furnizor și în fluxurile de onboarding.

Cheie gratuită (100 credite)Documentație

Exemplu curl

curl -H "x-api-key: htr_demo" "https://api.howtoromania.io/v1/company/RO14399840"

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: “Este RO14399840 plătitoare de TVA, aplică TVA la încasare și este în Registrul RO e-Factura?”

Ce primești în răspuns

  • vat.registered și vat.since: înregistrarea în scopuri de TVA și data de la care se aplică
  • vat.cashAccounting: TVA la încasare
  • vat.splitVat: plată defalcată a TVA
  • status.inactive, inactiveSince, reactivatedOn, deregisteredOn: starea din registrul contribuabililor inactivi/reactivați și radierea
  • eFactura.registered: dacă firma figurează în Registrul RO e-Factura
  • denumire, număr de înregistrare, cod CAEN, adresa domiciliului fiscal și a sediului social, plus câmpul fx cu cursul BNR EUR/RON

Accepți CUI-ul cu sau fără prefixul RO. Câmpul source arată serviciul ANAF interogat și momentul citirii. Pentru facturi, API-ul e-Factura completează automat datele părților după CUI.

Endpoint-uri și prețuri

ServiciuEndpointCredite≈ EUR
Company lookup
ANAF registry data by CUI/VAT id: name, address, status, VAT, e-Factura, BNR EUR/RON		GET /v1/company/{cui}
MCP lookup_company		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

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 €, pachetul minim), fără contract; erorile și indisponibilitatea sursei nu se taxează (raportul de risc parțial se taxează integral)
  • 100 de credite gratuite la fiecare cheie
  • Abonamente pentru volume mari, la cerere: hello@howtoromania.io.

Întrebări frecvente

Ce înseamnă vat.registered = false?

Că firma nu figurează ca înregistrată în scopuri de TVA la data interogării (câmpul queriedForDate), conform serviciului public ANAF.

Pot verifica și CUI-uri din alte țări UE?

Nu. Endpoint-ul acoperă firme din România, după CUI.

Cât costă?

Plătești per apel reușit, în credite (1 credit = 0,005 €, pachetul minim). 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, „negăsit” și apelurile la care sursa (ex. ANAF) nu răspunde nu se taxează. Un raport de risc cu secțiuni indisponibile se taxează integral.

Pot testa fără cont?

Da. Cheia demo htr_demo merge, cu o limită zilnică per IP, pe căutarea firmei după CUI, dosarul după număr, validarea și parsarea e-Factura, căutarea în legislație, articolele în vigoare și actele noi. 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.