Anaf v1 / e-Transport

Validează declarația

Verdictul XSD plus regulile Schematron pentru o notificare de transport — inclusiv regulile care leagă codul operaţiunii de scopul declarat şi de locul de ieşire.

POST

https://oneapi.ro/api/anaf/v1/etransport/validate

Corpul cererii

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

Declarație de transport

etransport.xml application/xml · 1,1 KB — se trimite ca atare, în corpul cererii.

Livrare intracomunitară

etransport-lic.xml application/xml · 1,0 KB — se trimite ca atare, în corpul cererii.

Export

etransport-exp.xml application/xml · 1,0 KB — se trimite ca atare, în corpul cererii.

Parametri de interogare

Ruta nu acceptă 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 declarații e-Transport și întoarce verdictul pe două straturi cumulative: (1) structura — XSD-ul oficial v2, validat nativ; (2) reguli de business — Schematron-ul oficial ANAF v2.0.2, rulat local.
Un XML invalid nu e o eroare a cererii: răspunsul e 200 cu valid:false și lista erorilor în errors[], fiecare cu cod, mesaj, camp.
Zero retenție: XML-ul primit nu se scrie și nu se loghează.

La ce folosește

Verificarea unei declarații generate în altă parte, înainte de depunere.
Depanarea unei declarații respinse de ANAF, cu erorile Schematron pe înțeles.

Structura răspunsului

CâmpTipDescriere

data.valid boolean Verdictul cumulat (XSD + Schematron).

data.standard string ETRANSP-v2.

data.schema_version string Schema/standardul folosit la validare, când e disponibil (ex. FACT1 sau d390_v3.xsd); altfel null.

data.xsd_checked boolean Dacă validarea XSD a rulat.

data.schematron_checked boolean Dacă Schematron-ul oficial a rulat (poate fi false dacă engine-ul lipsește).

data.errors array Erorile de validare {cod,mesaj,camp}. Gol când valid e true.

data.warnings array Avertismente neblocante.

meta.generat_la string Momentul la care s-a construit răspunsul (ISO 8601).

Exemple de răspuns

body: @etransport.xml

POSThttps://oneapi.ro/api/anaf/v1/etransport/validate

{
    "data": {
        "valid": true,
        "standard": "ETRANSP-v2",
        "schema_version": "XSD v2 (2023-01-26) + Schematron v2.0.2",
        "xsd_checked": true,
        "schematron_checked": true,
        "errors": [],
        "warnings": []
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 43+03: 00"
    }
}

body: @etransport-lic.xml

POSThttps://oneapi.ro/api/anaf/v1/etransport/validate

{
    "data": {
        "valid": true,
        "standard": "ETRANSP-v2",
        "schema_version": "XSD v2 (2023-01-26) + Schematron v2.0.2",
        "xsd_checked": true,
        "schematron_checked": true,
        "errors": [],
        "warnings": []
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 43+03: 00"
    }
}

body: @etransport-exp.xml

POSThttps://oneapi.ro/api/anaf/v1/etransport/validate

{
    "data": {
        "valid": true,
        "standard": "ETRANSP-v2",
        "schema_version": "XSD v2 (2023-01-26) + Schematron v2.0.2",
        "xsd_checked": true,
        "schematron_checked": true,
        "errors": [],
        "warnings": []
    },
    "meta": {
        "generat_la": "2026-10-06T23: 59: 43+03: 00"
    }
}

Coduri de eroare

Cod	Slug	Când apare
401	neautentificat	Token lipsă, invalid, expirat sau revocat.
403	feature_indisponibil	Planul curent nu include funcţia de care ţine ruta.
413	payload_prea_mare	Documentul depăşeşte limita acceptată.
422	parametru_necunoscut	Un parametru în query pe care ruta nu-l primeşte.
429	cota_depasita	Cota lunară a planului a fost depăşită (vezi `Retry-After`).

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": "parametru_necunoscut",
        "mesaj": "Un parametru în query pe care ruta nu-l primeşte.",
        "camp": null,
        "request_id": "0199c1f0-6e1a-7c3d-9b2f-4a8e5d1c7b04"
    }
}