Sari la conținut
e-Transport

e-Transport pentru dezvoltatori: XML v2, validare, OAuth și API ANAF

Actualizat la 18 noiembrie 2026. Scris de Echipa LaRampa. Legislația verificată la 18 noiembrie 2026.

Pe scurt

  • Prin API, declarația e-Transport se trimite ca fișier XML, iar sistemul verifică structura, sintaxa și regulile semantice (Ordinul 1337/2024 art. 2 alin. 3 lit. a și art. 6 alin. 1 – 2).
  • Codul UIT primit la încărcare îl folosești abia după ce „stareMesaj” întoarce „ok”, precizează Ministerul Finanțelor. O declarație cu erori nu se consideră transmisă (Ordinul 1337/2024 art. 6 alin. 6).
  • Autentificarea e OAuth2, cu certificatul digital calificat al utilizatorului, pe logincert.anaf.ro. După procedura ANAF, tokenul de acces ține 90 de zile, iar cel de reîmprospătare 365.
  • Folosește XML v2, validat cu XSD 1.02 și Schematron v2.0.2: doar v2 are operațiunile lohn și call-off (12, 14, 22, 24) și schimbarea vehiculului.

Cum declari un transport prin API-ul e-Transport

Trimiți un fișier XML v2 cu un token OAuth2, obținut cu certificatul digital, apoi verifici starea până la „ok”. Ordinul prevede expres această cale: aplicația ta se conectează la RO e-Transport prin „microservicii expuse sub forma unui API” (Ordinul 1337/2024 art. 2 alin. 3 lit. a).

Pașii, în ordine:

  1. Înregistrezi aplicația pe anaf.ro și primești un Client ID și un Client Secret.
  2. Utilizatorul se autentifică cu certificatul digital și obții tokenul.
  3. Construiești XML-ul v2 și îl validezi local cu XSD-ul și cu Schematronul.
  4. Trimiți fișierul la serviciul „upload” și păstrezi „index_incarcare”.
  5. Interoghezi „stareMesaj” până primești „ok” sau o respingere.
  6. La respingere, citești erorile din serviciul „lista”.

API-ul e doar un canal de transmitere. Cine declară, termenele și pragurile sunt aceleași ca în aplicația din SPV (OUG 41/2022 art. 8, 8^1 și 11; Ordinul 1337/2024 art. 1 alin. 4).

Ce spune legea despre declararea prin API

Declararea prin API se face prin transmiterea unui fișier XML, pe care sistemul îl verifică automat (Ordinul 1337/2024 art. 6 alin. 1 – 2). Documentația tehnică e publicată de Ministerul Finanțelor, pe mfinante.gov.ro, secțiunea RO e-Transport (art. 2 alin. 4).

Ce prevede ordinulTemei
Firma e înregistrată în SPV, în nume propriu sau prin reprezentant ori împuternicitOrdinul 1337/2024 art. 1 alin. 6
Te identifici cu mijloacele de acces în SPV, și pentru APIart. 2 alin. 3
Sistemul verifică structura și sintaxa, apoi face verificări semanticeart. 6 alin. 2
Până la verificare, datele au statusul „în prelucrare”art. 6 alin. 3
Fără erori, declarația primește semnătura electronică a Ministerului Finanțelorart. 6 alin. 5
Cu erori, declarația „nu se consideră transmisă în sistem”art. 6 alin. 6
Fișierele de răspuns se pot descărca 60 de zileart. 6 alin. 7

Ministerul Finanțelor a scos serviciul API „descarcare” pe 29.07.2024, potrivit notei de pe pagina de informații tehnice. Prin API afli rezultatul din „stareMesaj” și „lista”.

Ordinul prevede că fișierul semnat al unei declarații fără erori e disponibil și în aplicația web (Ordinul 1337/2024 art. 6 alin. 8). Pentru fișierul cu erori, ordinul nu prevede asta.

Autentificarea: OAuth2 cu certificat digital

API-ul ANAF folosește OAuth2 cu „Authorization Code”, iar utilizatorul se autentifică cu un certificat digital calificat. Tokenul identifică utilizatorul după seria certificatului, nu aplicația (procedura ANAF de înregistrare a aplicațiilor OAuth).

Înregistrarea aplicației

Pe anaf.ro intri la Servicii online, Înregistrare utilizatori, Dezvoltatori aplicații, „Înregistrare pentru API-uri”. După autentificare, deschizi „Editare profil Oauth” și apoi „Gestionare aplicații”.

  • Scrii numele aplicației și alegi serviciul E-Transport.
  • Dai adresa de callback a aplicației tale.
  • Apeși „Generare Client ID” și primești Client ID și Client Secret.

Înregistrarea o faci o singură dată, ca dezvoltator. Apoi fiecare utilizator se autentifică cu certificatul lui calificat.

Utilizatorul e o persoană cu drept în SPV pe firmă: reprezentant legal, reprezentant desemnat sau împuternicit. Tokenul se emite pentru certificatul lui, nu pentru firmă (procedura ANAF OAuth).

Obținerea tokenului

Adresele oficiale sunt pe logincert.anaf.ro: „/anaf-oauth2/v1/authorize” pentru autorizare și „/anaf-oauth2/v1/token” pentru token. Procedura ANAF cere parametrul „token_content_type=jwt” la autorizare și în corpul cererii de token.

  • Clientul se autentifică prin antetul HTTP Basic, cu Client ID și Client Secret.
  • La pasul din browser, utilizatorul prezintă certificatul calificat.
  • Reîmprospătarea se face pe aceeași adresă, cu „grant_type=refresh_token”.
  • Răspunsul aduce un token de acces nou și un token de reîmprospătare nou. Le păstrezi pe amândouă.
ElementDurata, după procedura ANAF
Token de acces (JWT)90 de zile
Token de reîmprospătare365 de zile

Pasul cu certificatul îl refaci când nu mai ai un token de reîmprospătare valabil. Procedura nu spune dacă tokenul primit la reîmprospătare are iar 365 de zile.

Procedura ANAF mai pomenește un interval de 60 de secunde pentru obținerea unui token valid. Schimbă codul de autorizare pe token imediat după redirect.

Ce drepturi are tokenul

Un token lucrează pe toate CIF-urile pe care utilizatorul are drept în SPV, și doar pe ele. În plus, aplicația trebuie să fie înrolată la serviciul E-Transport.

Un contabil sau un comisionar vamal declară pentru client ca reprezentant sau împuternicit (Ordinul 1337/2024 art. 2 alin. 2). Declară doar pentru CIF-urile pe care are drept în SPV (art. 1 alin. 6 și art. 3 alin. 3).

În XML, „codDeclarant” rămâne CIF-ul firmei care are obligația. Excepție face „modifVehicul”, pe care îl trimite organizatorul transportului sau transportatorul, din contul propriu.

Verifici tokenul cu serviciul de test „TestOauth” de pe api.anaf.ro. Alternativa fără OAuth e certificatul prezentat la fiecare apel, pe webserviceapl.anaf.ro.

Adresele de test și de producție

Cu token OAuth2, testul e la api.anaf.ro/test/ETRANSPORT/ws/v1, iar producția la api.anaf.ro/prod/ETRANSPORT/ws/v1. Adresele, cu varianta pe certificat, sunt în prezentarea serviciilor API a Ministerului Finanțelor (29.07.2024).

Mod de autentificareTestProducție
OAuth2 (token Bearer)api.anaf.ro/test/ETRANSPORT/ws/v1api.anaf.ro/prod/ETRANSPORT/ws/v1
Certificat la fiecare apelwebserviceapl.anaf.ro/test/ETRANSPORT/ws/v1webserviceapl.anaf.ro/prod/ETRANSPORT/ws/v1

Toate adresele sunt pe HTTPS, iar cele două medii au aceleași servicii. Și mediul de test cere un token real, cu serviciul E-Transport înrolat.

Documentația nu publică un CIF de test, așa că lucrezi pe un CIF pe care ai drept în SPV. Un cod obținut în test nu e o declarație: transportul real îl declari doar la adresa „prod”.

Serviciile: încărcare, stare, listă și informații

API-ul are patru servicii active: încărcarea XML-ului, starea unei încărcări, lista mesajelor și informațiile pentru transportatori. Toate primesc tokenul în antetul „Authorization: Bearer”.

ServiciuApel (după adresa de bază)Ce întoarce
ÎncărcarePOST /upload/ETRANSP/CIF/2„index_incarcare”, codul UIT, „trace_id”
StareGET /stareMesaj/ID_INCARCARE„ok”, „in prelucrare”, „XML cu erori nepreluat de sistem” sau „nok”
ListăGET /lista/ZILE/CIFmesajele din ultimele 1 – 60 de zile, cu erorile
Informații transportatoriGET /info?cui_op=CIFdeclarațiile active în care CIF-ul e organizatorul transportului

ID_INCARCARE e valoarea „index_incarcare” primită la încărcare. În adresa de bază segmentul e „ETRANSPORT”, iar parametrul „standard” din încărcare e „ETRANSP”.

Cu altă valoare la „standard” primești eroarea „Valoarea acceptata pentru parametrul standard este ETRANSP”.

Încărcarea

Trimiți XML-ul în corpul cererii, cu „Content-Type: application/xml”, iar ultimul segment din adresă e versiunea, 2. CIF-ul din adresă e firma pentru care acționezi, cu cel mult 13 cifre.

Fișierul are cel mult 5 MB. Erorile vin tot cu HTTP 200, dar cu „ExecutionStatus” 1 și o listă „Errors”.

Starea: folosești codul abia după „ok”

Codul UIT primit la încărcare îl folosești abia după ce „stareMesaj” întoarce „ok”. Răspunsul la încărcare o spune direct: „Codul UIT este valabil din momentul in care apare ca valid dupa apelul de stare”.

Termenul de 5 sau 15 zile se calculează tot de la data declarată pentru începerea transportului (OUG 41/2022 art. 11 alin. 2).

StareCe înseamnăCe faci
„in prelucrare”sistemul încă verifică fișierulîntrebi din nou, cu pauze tot mai mari
„ok”declarația a fost acceptatădai codul transportatorului
„XML cu erori nepreluat de sistem”respinsă la verificăricitești erorile din „lista”
„nok”prelucrarea a eșuatcitești „Errors” din răspuns

Nu da codul șoferului înainte de „ok”. Dacă verificările găsesc erori, declarația nu se consideră transmisă (Ordinul 1337/2024 art. 6 alin. 6).

Dacă la un control sistemul arată „în prelucrare”, inspectorii doar consemnează constatările. Respectarea legii se stabilește după verificările automate (Ordinul 1337/2024 art. 12 alin. 7).

Lista mesajelor

„Lista” întoarce, pentru 1 – 60 de zile, starea finală a declarațiilor valide și toate trimiterile respinse. Fiecare înregistrare are „mesaje” de tip ERR, WARN sau INFO.

Rezultatele nu sunt sortate, așa că le sortezi după „data_creare”. Legi o respingere de încărcarea ta prin „id_incarcare”, adică „index_incarcare” de la încărcare.

Informații pentru transportatori

Serviciul „info” arată organizatorului transportului declarațiile active în care apare. Parametrul „cui_op” e obligatoriu, iar „data_exp_uit” arată când expiră codul.

XML v2 sau v1

Folosește XML v2: e singura versiune cu operațiunile lohn și call-off și cu schimbarea vehiculului.

Ministerul Finanțelor acceptă v2 din 17.02.2023 și încă acceptă v1, potrivit paginii sale de informații tehnice. Nu a anunțat o dată de încetare pentru v1.

v1v2
Spațiu de numemfp:anaf:dgti:eTransport:declaratie:v1mfp:anaf:dgti:eTransport:declaratie:v2
Tipuri de operațiune10, 20, 30, 40, 50, 60, 70în plus 12, 14, 22, 24
Scopul operațiuniicoduri de 6 cifre, de exemplu 300101coduri scurte, de exemplu 101 sau 9999
Schimbarea vehicululuinu existăelementul „modifVehicul”
ValidareXSD v1 și Schematron v1.0.5XSD 1.02 și Schematron v2.0.2

Codurile oficiale de operațiune, cu denumirile lor, sunt în pagina tipurile de operațiune.

Structura fișierului XML v2

Elementul rădăcină „eTransport” poartă „codDeclarant” și conține exact unul dintre „notificare”, „stergere”, „confirmare” sau „modifVehicul” (regula BT-TY-005). Aproape toate datele stau în atribute, nu în text.

Element din „notificare”CâteCe conține
„corectie”0 – 1codul UIT corectat; declarația întreagă înlocuiește declarația inițială
„bunuriTransportate”1 sau mai multescop, cod NC, denumire, cantitate, unitate, greutăți, valoare fără TVA
„partenerComercial”1țara, codul fiscal, denumirea
„dateTransport”1vehicul, remorci, organizatorul transportului, data transportului
„locStartTraseuRutier”, „locFinalTraseuRutier”câte 1punct de trecere a frontierei, birou vamal sau adresă
„documenteTransport”1 sau mai multe10 CMR, 20 factură, 30 aviz, 9999 altele
„notificareAnterioara”0 sau mai multeun cod UIT anterior legat de transport

Câteva atribute ale rădăcinii contează în practică:

  • „refDeclarant” e referința ta internă. Ghidul ANAF 2025 explică că, prin API, ea se întoarce la generarea codului.
  • „declPostAvarie” cu valoarea „D” marchează o declarație trimisă după ce sistemul n-a funcționat. O trimiți până la sfârșitul următoarei zile lucrătoare după repunerea în funcțiune, și pentru transporturile încheiate (OUG 41/2022 art. 8 alin. 1^2 – 1^3).

Perioadele de nefuncționare le publică ANAF și Ministerul Finanțelor (OUG 41/2022 art. 8 alin. 1^4). Ce faci la o întrerupere afli în ce faci când RO e-Transport nu funcționează.

Corecție, ștergere, vehicul și confirmare

Fiecare schimbare e un fișier separat, trimis tot la încărcare. Corecția retrimite toată declarația, cu „corectie” ca prim element.

Ce faciMesaj XMLPână când, după lege
Corectezi datele, același cod„notificare” cu „corectie”până la plecare; la intrarea în țară, până la frontieră sau locul de import (Ordinul 1337/2024 art. 4 alin. 1; OUG 41/2022 art. 11 alin. 3)
Schimbi vehiculul după plecare„modifVehicul”cât e valabil codul, înainte de repornire; o face organizatorul transportului sau transportatorul (OUG 41/2022 art. 8 alin. 1^1; Ordinul 1337/2024 art. 4 alin. 2)
Confirmi, confirmi parțial, infirmi„confirmare” cu 10, 20 sau 30după încheierea transportului, până la expirarea codului; fără confirmare, transportul se consideră confirmat (Ordinul 1337/2024 art. 5 alin. 1 și 3)
Modifici bunurile după expirarea coduluinedescris în documentația tehnicădenumirea, caracteristicile, cantitățile și valoarea, până pe 25 ale lunii următoare încheierii transportului (OUG 41/2022 art. 11 alin. 5)
Ștergi declarația„stergere”legea nu reglementează ștergerea

Regulile complete sunt în cum modifici sau corectezi o declarație e-Transport.

Validarea: XSD 1.02 și Schematron 2.0.2

Validezi local în doi pași: structura cu XSD-ul v2, apoi regulile de business cu Schematronul v2.0.2. La primire, sistemul verifică structura și sintaxa, apoi face verificări semantice (Ordinul 1337/2024 art. 6 alin. 2).

FișierVersiuneCe verifică
schema_ETR_v2_20230126.xsd1.02, din 26.01.2023elemente, atribute, tipuri, liste de coduri
eTransport-validation_v.2.0.2_12082024.sch2.0.2, din 12.08.202466 de reguli active: 61 de condiții obligatorii și 5 mesaje care arată doar tipul fișierului

Schematronul e scris pentru XSLT 2.0, deci ai nevoie de un procesor XSLT 2.0. Validarea locală îți arată erorile înainte să consumi un apel de încărcare.

Codul UIT are cifră de control

Codul UIT are 16 caractere: 14 cifre sau litere, apoi 2 cifre de control. Literele O, I, Z, S, G și B nu apar în cod.

Cifrele de control sunt ultimele două cifre ale sumei codurilor ASCII ale primelor 14 caractere (regula BR-019). La codul din exemplul oficial 6T1Q7E3U0R8T4R32, suma e 932, deci controlul e 32.

Verifică codul local înainte de corecție, ștergere, schimbarea vehiculului sau confirmare. Un cod greșit e respins de regulile BR-003 și BR-019.

Ce nu acoperă schemele

XSD-ul și Schematronul sunt anterioare OUG 129/2024. Documentația tehnică nu spune separat cum trimiți modificarea bunurilor după expirarea codului.

Legea permite schimbarea denumirii, caracteristicilor, cantităților și valorii până pe 25 ale lunii următoare încheierii transportului (OUG 41/2022 art. 11 alin. 5).

Schemele nu verifică nici obligația de a declara. Pragurile (Ordinul 1337/2024 art. 1 alin. 4) și termenele (OUG 41/2022 art. 11 alin. 1) le verifici tu.

Erorile frecvente

Respingerile vin fie de la API (drepturi, mărimea fișierului, XSD), fie din regulile Schematron, cu cod BR. Lista completă a regulilor BR, cu explicații, e în erorile de validare BR-xxx.

RegulaCe cere
BR-004, BR-005, BR-006țara partenerului se potrivește cu operațiunea: UE fără RO la 10, 12, 14, 20, 22, 24, 60, 70; RO la 30; din afara UE la 40, 50
BR-020greutatea brută e cel puțin egală cu greutatea netă
BR-206, BR-207, BR-208codul NC, greutatea netă și valoarea sunt obligatorii, mai puțin la 60 și 70
BR-210, BR-211startul și finalul au exact unul: punct de trecere a frontierei, birou vamal sau adresă
BR-212, BR-213fără punct de frontieră la start pentru 20, 22, 24, 30, 50, 70 și la final pentru 12, 14, 30, 40, 60
BR-216, BR-217birou vamal la start doar la import (40), la final doar la export (50)
BR-025„notificareAnterioara” nu e permisă la 30, 40, 50, 60, 70
BR-026documentul 9999 cere „observatii”
BR-CL-001Grecia se scrie EL, nu GR

Erorile de la API apar înainte de Schematron:

  • „Nu aveti drept in SPV pentru CIF=…”: utilizatorul tokenului nu are drept pe acel CIF.
  • „Marime fisier transmis mai mare de 5 MB”: fișierul depășește limita.
  • „Fisierul transmis nu este valid” cu SAXParseException: XML-ul nu trece de XSD.
  • Numărul vehiculului are doar cifre și majuscule, fără spații sau cratime, 2 – 20 de caractere (XSD v2).

Limitele documentate

API-ul are limite pe minut, pe zi și pe fișier, iar peste ele cererea e refuzată. ANAF spune în procedura OAuth că limitele se pot stabili ulterior și pe fiecare serviciu.

LimităValoareSursa
Cereri pe api.anaf.ro1.000 pe minut, apoi HTTP 429procedura ANAF OAuth
Verificări de stare100 pe zi pentru același „id_incarcare”mesajul de eroare din specificația serviciului
Interogări „lista”1.000 pe zi pentru un utilizatormesajul de eroare din specificația serviciului
Mărimea fișierului5 MBmesajul de eroare din specificația serviciului
Perioada din „lista”1 – 60 de zilespecificația serviciului

Cu 100 de verificări pe zi, nu interoga starea în buclă strânsă. Începe după câteva secunde și mărește pauza.

Dacă nu vrei să integrezi direct

Poți folosi și API-ul LaRampa: trimiți documentele transportului, răspunzi la verificări și primești codul după ce ANAF îl emite. Detaliile, cheile de test și webhookurile sunt în API LaRampa.

Declarația rămâne a firmei care are obligația. LaRampa pregătește XML-ul, tu îl verifici, iar ANAF emite codul UIT.

Întrebări frecvente

Pot folosi API-ul e-Transport fără certificat digital?

Nu. Te identifici cu mijloacele de acces în SPV și pentru API (Ordinul 1337/2024 art. 2 alin. 3). Procedura ANAF OAuth cere certificatul calificat la autorizare, apoi aplicația lucrează cu tokenul.

Un contabil poate declara prin API pentru un client?

Da, ca reprezentant sau împuternicit al clientului (Ordinul 1337/2024 art. 2 alin. 2). Declari doar pentru CIF-urile pe care ai drept în SPV (art. 1 alin. 6 și art. 3 alin. 3). În XML, „codDeclarant” rămâne CIF-ul clientului care are obligația.

Ce fac dacă starea rămâne „in prelucrare”?

Întrebi din nou, cu pauze tot mai mari: ai 100 de verificări pe zi pentru același „id_incarcare”. La un control în acest timp, inspectorii doar consemnează, iar respectarea legii se stabilește după verificarea automată (Ordinul 1337/2024 art. 12 alin. 7).

Mai pot descărca prin API fișierul semnat de Ministerul Finanțelor?

Nu prin API: serviciul „descarcare” a fost scos pe 29.07.2024, potrivit notei Ministerului Finanțelor. Ordinul prevede că fișierul semnat al unei declarații fără erori e disponibil 60 de zile și în aplicația web (Ordinul 1337/2024 art. 6 alin. 7 – 8).

Pot corecta prin API bunurile după expirarea codului UIT?

Legea o permite, dar documentația API nu descrie cum. Poți modifica denumirea, caracteristicile, cantitățile și valoarea până pe 25 ale lunii următoare încheierii transportului (OUG 41/2022 art. 11 alin. 5). Schemele XML sunt anterioare OUG 129/2024.

Citește și

Surse

Ghidul explică legea pe înțeles, nu ține loc de consultanță fiscală sau juridică. Ai găsit o greșeală? Scrie-ne și o corectăm, cu data corecturii (vezi cum scriem ghidurile).