Validează factura

Corpul cererii

Corpul cererii e documentul întreg, trimis brut (Content-Type: application/xml) — nu un obiect cu câmpuri.

Parametri de interogare

Cum se comportă

• Documentul se poate trimite şi ca fişier: multipart/form-data cu câmpul fisier (curl -F fisier=@document.xml), în locul corpului brut. Conţinutul fişierului devine corpul cererii, deci rezultatul e identic; opţiunile rămân în query string, iar alt câmp de formular lângă fisier dă 422 camp_necunoscut.
• Primeşte XML-ul unei facturi în corpul cererii şi întoarce verdictul de validare pe trei straturi, cumulativ: (1) well-formed — XML-ul se parsează; (2) o verificare numerică proprie, care recalculează totalurile şi raportează diferenţa exactă acolo unde sumele nu se leagă; (3) Schematron-ul oficial EN 16931 + CIUS-RO + RO-eFactura, rulat local prin Saxon.
• Verificarea numerică proprie (stratul 2) e cea care prinde greşeala care doare cel mai des: un total care nu corespunde sumei liniilor. În loc de un simplu „invalid", răspunsul dă diferenţa exactă, ca să vezi dintr-o privire cât şi unde s-a rupt calculul.
• Cu ?anaf=1 se adaugă un cross-check la validatorul ANAF, iar confirmarea lui apare separat în anaf_confirmation. Fără el, validarea e integral locală — acelaşi Schematron oficial, dar fără ca XML-ul să iasă din proces.
• Cu ?vies=1 se verifică suplimentar, în VIES (Comisia Europeană), codul de TVA al cumpărătorului non-RO — util la livrările intracomunitare scutite (categoria K), unde scutirea e legală doar dacă partenerul are cod de TVA valid în alt stat membru. Schematron-ul verifică formatul; VIES confirmă că respectivul cod chiar există şi e activ. Rezultatul apare separat în vies şi nu afectează valid. E un apel extern, opţional: dacă VIES nu răspunde, câmpul întoarce state: unavailable şi validarea locală merge mai departe.
• Un XML invalid nu e o eroare a cererii. Răspunsul e 200 cu valid: false şi lista de erori în errors[], fiecare cu cod, mesaj şi camp. „Invalid" fără să spui ce anume n-ajută pe cineva care încearcă să corecteze factura.
• cod şi regula citată în mesaj pot să nu coincidă — de pildă cod: BR-RO-081 cu un mesaj care începe cu [BR-RO-080]. Nu e o eroare a noastră: schema oficială ROeFactura-UBL-validation-Invoice.xslt are aserţiuni distincte (adresa vânzătorului BT-35, adresa cumpărătorului BT-50) cu id-uri diferite, dar cu acelaşi prefix în text. Transmitem fidel ambele. Ia cod ca identificator al regulii, nu prefixul din text.
• Zero retenţie: XML-ul primit nu se scrie şi nu se loghează; validarea e stateless.

La ce folosește

• Verificarea unei facturi generate în altă parte, înainte de depunere în SPV.
• Depanarea unui total care nu se leagă, folosind diferenţa exactă din stratul numeric.
• Cross-check la ANAF (?anaf=1) pentru confirmare oficială, când verificarea locală nu e de ajuns.
• Confirmarea în VIES (?vies=1) a codului de TVA al cumpărătorului la o livrare intracomunitară scutită (categoria K).

Structura răspunsului

Exemple de răspuns

{
    "data": {
        "valid": true,
        "standard": "FACT1",
        "schema_version": "CIUS-RO 1.0.1 (EN16931)",
        "errors": [],
        "warnings": []
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 42+03: 00"
    }
}

{
    "data": {
        "valid": true,
        "standard": "FACT1",
        "schema_version": "CIUS-RO 1.0.1 (EN16931)",
        "errors": [],
        "warnings": []
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 42+03: 00"
    }
}

{
    "data": {
        "valid": true,
        "standard": "FACT1",
        "schema_version": "CIUS-RO 1.0.1 (EN16931)",
        "errors": [],
        "warnings": []
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 42+03: 00"
    }
}

Coduri de eroare

Erorile modulului Anaf au acelaşi plic ca restul platformei, cu două câmpuri în plus: {eroare: {cod, mesaj, camp, request_id}}. eroare.cod e stabil şi e cel după care ramifici în cod; la validare (422) codul e specific cazului: xml_invalid, xml_nu_e_factura, unitate_necunoscuta, luna_invalida ş.a. camp arată câmpul vinovat, când se poate identifica.

{
    "eroare": {
        "cod": "xml_invalid",
        "mesaj": "Corpul nu e XML parsabil. Un XML valid-ca-structură dar neconform întoarce 200 cu valid: false.",
        "camp": "anaf",
        "request_id": "0199c1f0-6e1a-7c3d-9b2f-4a8e5d1c7b04"
    }
}