Anaf v1 / SAF-T (D406)

Randează PDF

Un PDF sumar al declaraţiei D406, pentru verificare cu ochiul înainte de depunere. Răspunsul e documentul, nu JSON.

POST

https://oneapi.ro/api/anaf/v1/saft/render

Corpul cererii

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

D406 lunar

saft-d406.xml application/xml · 17,5 KB — se trimite ca atare, în corpul cererii.

D406 trimestrial

saft-d406-trimestrial.xml application/xml · 17,5 KB — se trimite ca atare, în corpul cererii.

D406 anual

saft-d406-anual.xml application/xml · 17,5 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 un D406 și întoarce un PDF sumar lizibil: firma, perioada, softul și numărătorile/totalurile pe secțiuni. Local (dompdf), in-memory.
Documentul e informativ; nu înlocuiește depunerea în SPV.
Zero retenție: fișierul primit nu se scrie și nu se loghează.

La ce folosește

Un rezumat tipăribil al unui D406, pt dosar sau verificare vizuală.

Structura răspunsului

CâmpTipDescriere

Exemple de răspuns

body: @saft-d406.xml

POSThttps://oneapi.ro/api/anaf/v1/saft/render

Răspunsul e un document binar, nu JSON: application/pdf, 26,2 KB în acest exemplu.

Descarcă documentul întors de acest exemplu

body: @saft-d406-trimestrial.xml

POSThttps://oneapi.ro/api/anaf/v1/saft/render

Răspunsul e un document binar, nu JSON: application/pdf, 26,3 KB în acest exemplu.

Descarcă documentul întors de acest exemplu

body: @saft-d406-anual.xml

POSThttps://oneapi.ro/api/anaf/v1/saft/render

Răspunsul e un document binar, nu JSON: application/pdf, 26,3 KB în acest exemplu.

Descarcă documentul întors de acest exemplu

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.
422	xml_invalid	XML invalid — nu poate fi randat.
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": "xml_invalid",
        "mesaj": "XML invalid — nu poate fi randat.",
        "camp": null,
        "request_id": "0199c1f0-6e1a-7c3d-9b2f-4a8e5d1c7b04"
    }
}