Anaf v1 / e-Transport

Randează PDF

Un PDF sumar al notificării, de pus în dosarul transportului. Răspunsul e documentul, nu JSON.

POST

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

Corpul cererii

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

Notificare

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 și întoarce un PDF sumar, lizibil, cu bunurile, partenerul, transportul, traseul și documentele — codurile fiind traduse în denumiri. Local (dompdf), in-memory.
Documentul e informativ; nu înlocuiește depunerea în SPV și nu conține cod UIT (acela se obține la depunere).
Zero retenție: XML-ul primit nu se scrie și nu se loghează.

La ce folosește

Un rezumat tipăribil pentru șofer/dosarul transportului.

Structura răspunsului

CâmpTipDescriere

Exemple de răspuns

body: @etransport.xml

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

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

Descarcă documentul întors de acest exemplu

body: @etransport-lic.xml

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

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

Descarcă documentul întors de acest exemplu

body: @etransport-exp.xml

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

Răspunsul e un document binar, nu JSON: application/pdf, 31,6 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"
    }
}