Sari la conținut

e-Factura prin SPV sau prin API: când lucrul manual nu mai este suficient

La câteva zeci de facturi pe lună, SPV-ul sau modulul din programul de facturare sunt suficiente. La mii de facturi, pe mai multe firme dintr-un grup, cu facturi primite care trebuie înregistrate la timp, încărcarea și descărcarea manuală devin un al doilea flux de lucru. Mai jos sunt variantele existente, ce oferă API-ul ANAF și semnalele după care vă dați seama că ați depășit lucrul manual.

Publicat 12 min de citit

Orice companie din România care emite facturi către alte companii lucrează deja cu e-Factura. Întrebarea nu mai este dacă, ci cum: cineva încarcă fișiere XML în SPV, programul de facturare le trimite printr-un buton sau ERP-ul vorbește direct cu ANAF, fără intervenție umană. Toate trei sunt legale și toate trei produc aceeași factură validată.

Diferența apare în ce nu se vede la emitere: cine urmărește dacă factura a fost validată, cine descarcă facturile primite de la furnizori, în cât timp ajung ele în contabilitate și ce se întâmplă când același lucru trebuie făcut pentru cinci firme din grup. Aici se decide dacă lucrul manual mai ține.

Variantele de lucru cu e-Factura

Există cinci moduri de a trimite și primi facturi prin sistemul RO e-Factura. Ele nu se exclud: multe companii folosesc două sau trei în paralel, fără să-și dea seama.

Variantă Ce face Unde se oprește
Încărcare manuală în SPV Fișierul XML, generat de program, se încarcă din secțiunea de factură electronică, cu certificatul digital. Răspunsurile se descarcă tot de acolo. Fiecare factură este o operațiune separată. Facturile primite se descarcă și ele una câte una.
Aplicațiile gratuite ale Ministerului Finanțelor Formular web pentru completarea facturii, validarea fișierului XML și conversia XML în PDF. Sunt gândite pentru cine nu are un program care generează XML. Fișierul tot trebuie încărcat și urmărit.
Modulul de e-Factura din ERP sau din programul de facturare Generează XML-ul și îl trimite, de obicei prin același API, la apăsarea unui buton sau automat. Depinde de cât acoperă: unele module doar trimit, altele urmăresc și starea, descarcă facturile primite și le importă.
Integrare directă prin API ERP-ul trimite, interoghează starea, descarcă răspunsurile și facturile primite, fără intervenție umană. Trebuie construită și întreținută, inclusiv reînnoirea tokenurilor și respectarea limitelor de apeluri.
Conector sau intermediar O aplicație terță face legătura dintre ERP și ANAF, ca serviciu. Datele trec printr-un sistem în plus, iar modul în care facturile primite ajung înapoi în ERP diferă de la un furnizor la altul.

Ministerul Finanțelor a precizat, într-un răspuns citat de presă în iulie 2025, că nu intenționează să dezvolte o aplicație de sine stătătoare pentru gestiunea facturilor electronice. Instrumentele gratuite rămân cele de completare, validare și conversie, plus API-ul.

Ce oferă API-ul e-Factura

API-ul este documentat de Ministerul Finanțelor pe pagina de informații tehnice a e-Factura. Serviciile, așa cum sunt descrise în documentația oficială și în bibliotecile care o implementează, sunt:

  • Încărcare (upload): trimite fișierul XML și întoarce un index de încărcare. Există o variantă separată pentru facturile către persoane fizice.
  • Starea mesajului (stareMesaj): pe baza indexului, spune dacă factura este în prelucrare, validată sau respinsă.
  • Lista mesajelor (listaMesajeFactura): toate mesajele unui CUI din ultimele 1 până la 60 de zile, cu filtru pe tip: facturi trimise, facturi primite, erori, mesaje de la cumpărător.
  • Lista cu paginație (listaMesajePaginatieFactura): același lucru, pe un interval de timp exact, pagină cu pagină. Este varianta potrivită pentru volume mari.
  • Descărcare (descarcare): arhiva unui mesaj, cu factura XML și semnătura Ministerului Finanțelor sau cu fișierul de erori.
  • Validare (validare): verifică un fișier XML față de regulile în vigoare, fără să-l transmită.
  • Transformare (transformare): generează PDF-ul unei facturi din XML.

Validarea și transformarea sunt disponibile și ca servicii publice, fără autentificare. Celelalte cer autorizare.

Autentificarea: certificat, aplicație înregistrată, token

Procedura ANAF pentru serviciile API folosește OAuth 2.0 și are două părți distincte.

Aplicația se înregistrează o singură dată. Dezvoltatorul își creează un cont în portalul ANAF, la Servicii Online, Înregistrare utilizatori, Dezvoltatori aplicații, apoi declară aplicația în secțiunea „Editare profil Oauth”: denumirea, serviciul folosit (e-Factura, e-Transport) și adresa de callback. Portalul generează un Client ID și un Client Secret.

Utilizatorul se autentifică cu certificatul. La obținerea tokenului, persoana care autorizează accesul își prezintă certificatul digital calificat. Certificatul trebuie să fie înrolat în SPV cu unul dintre drepturile pentru persoane juridice: reprezentant legal, reprezentant desemnat sau împuternicit. Tokenul este emis pentru acel certificat și permite accesul la firmele pe care le reprezintă certificatul. Dacă certificatul nu are drepturi pe o firmă, aplicația nu poate lucra pentru ea, oricât de corect ar fi înregistrată.

Conform documentului ANAF, tokenul de acces este valabil 90 de zile, iar tokenul de reîmprospătare 365 de zile. Cu tokenul de reîmprospătare se obține un token de acces nou, fără certificat, iar la fiecare reîmprospătare ANAF întoarce o pereche nouă, care trebuie salvată. În practică, o integrare bine construită cere intervenția deținătorului de certificat cel puțin o dată pe an. Răspunderea pentru păstrarea în siguranță a tokenurilor revine celui care le folosește, iar un token compromis trebuie semnalat la ANAF pentru blocare.

Din aceste reguli rezultă două întrebări pe care orice proiect de integrare trebuie să le lămurească de la început: al cui este certificatul folosit și ce se întâmplă cu accesul când persoana respectivă pleacă din companie sau certificatul expiră.

Limitele de apeluri

API-ul are limite, publicate de Ministerul Finanțelor într-un document separat. Documentul OAuth al ANAF confirmă limita generală de 1.000 de apeluri pe minut, peste care serverul răspunde cu codul 429. Limitele pe servicii, așa cum sunt reproduse în documentația tehnică a unui furnizor de software, sunt:

  • Încărcare: fără limită pentru fișierele de tip factură; cel mult 1.000 de fișiere de răspuns la factură pe zi pe CUI.
  • Starea mesajului: cel mult 100 de interogări pe zi pentru același mesaj, fără limită totală pe CUI.
  • Lista simplă: cel mult 1.500 de interogări pe zi pe CUI.
  • Lista cu paginație: cel mult 100.000 de interogări pe zi pe CUI.
  • Descărcare: cel mult 10 descărcări pe zi pentru același mesaj, fără limită totală pe CUI.

Ignorarea repetată a mesajelor de depășire poate duce la blocarea accesului la API. Limitele nu sunt o problemă pentru un sistem care interoghează cu măsură, dar devin una pentru scripturi scrise în grabă, care verifică starea fiecărei facturi în buclă sau descarcă aceeași listă la fiecare minut.

Facturile primite: partea care se vede mai târziu

Discuția despre e-Factura începe aproape întotdeauna cu facturile emise. La companiile mari, problema mai mare este adesea cealaltă direcție: facturile de la furnizori, care ajung în SPV și trebuie descărcate, verificate, aprobate și înregistrate.

Câteva reguli fac din această parte un risc real la volum mare:

  • Mesajele rămân disponibile 60 de zile. Potrivit ghidului RO e-Factura, citat de Fiscalitatea.ro, fișierele XML și mesajele de eroare se pot descărca timp de 60 de zile de la validare, apoi sunt arhivate și se eliberează la cerere. API-ul aplică aceeași fereastră: lista nu acceptă intervale mai vechi de 60 de zile.
  • Originalul este fișierul XML semnat. Factura electronică originală este XML-ul cu sigiliul Ministerului Finanțelor, nu PDF-ul. El trebuie păstrat ca document justificativ, în sistemul dumneavoastră, nu în SPV.
  • ANAF vede facturile primite înaintea dumneavoastră. Decontul precompletat RO e-TVA se construiește și din facturile din e-Factura. O factură de achiziție ajunsă în SPV, dar înregistrată în ERP luna următoare, produce o diferență între datele ANAF și decontul depus. Mecanismul acestor diferențe și reconcilierea lor sunt descrise în articolul despre diferențele din decontul precompletat e-TVA.

O persoană care descarcă manual facturile primite pentru o singură firmă poate ține pasul. Pentru un grup cu mai multe CUI-uri și sute de furnizori, descărcarea manuală înseamnă fie întârzieri, fie facturi pierdute, iar ambele ajung în decont.

Termenul de transmitere

OUG 89/2025 a modificat OUG 120/2021: din 1 ianuarie 2026, termenul de transmitere în e-Factura este de 5 zile lucrătoare de la data emiterii facturii, dar nu mai târziu de 5 zile lucrătoare de la data-limită pentru emiterea facturii prevăzută de Codul fiscal.

Ce înseamnă o respingere pentru acest termen, de unde vin respingerile și cum se repară în ERP sunt descrise în articolul despre erorile e-Factura. Pentru discuția de aici contează altceva: în fluxul manual, o respingere este observată doar când cineva deschide SPV-ul și citește mesajul. Într-un flux integrat, starea ajunge în ERP fără să o caute nimeni.

Când SPV-ul sau modulul din ERP sunt suficiente

Integrarea directă nu este răspunsul potrivit pentru toată lumea. SPV-ul sau modulul existent sunt o alegere corectă dacă:

  • emiteți și primiți un număr de facturi pe care o persoană îl poate urmări zilnic, fără să rămână în urmă;
  • lucrați cu o singură firmă sau cu foarte puține;
  • modulul din ERP trimite facturile și importă automat facturile primite, iar respingerile apar în sistem;
  • știți, la orice moment, ce facturi sunt validate și ce facturi primite nu sunt încă înregistrate.

Dacă toate acestea sunt adevărate, un proiect de integrare v-ar costa mai mult decât problema pe care o rezolvă.

Semnalele că ați depășit lucrul manual

Nu există un prag oficial și nici un număr de facturi peste care integrarea devine obligatorie. Există însă situații care apar repetat la companiile care au crescut peste fluxul inițial:

  1. Mai multe persoane încarcă sau descarcă facturi, fiecare cu propriul certificat și propriul mod de lucru, iar nimeni nu are imaginea completă.
  2. Grupul are mai multe CUI-uri, iar fiecare firmă se urmărește separat, cu certificate și drepturi SPV diferite.
  3. Volumul lunar este de ordinul miilor de facturi, emise sau primite, iar urmărirea se face în fișiere Excel.
  4. Facturile primite nu ajung în ERP la timp. Furnizorii sună pentru plăți, iar factura este încă în SPV, nedescărcată.
  5. Nimeni nu poate spune, la sfârșitul zilei, ce facturi au fost validate, ce facturi sunt respinse și ce facturi n-au plecat deloc.
  6. Accesul depinde de o singură persoană, cu un singur certificat, iar concediul ei oprește fluxul.

Două sau trei dintre aceste semnale sunt de obicei suficiente pentru a justifica măcar o evaluare. La un singur semnal, problema se rezolvă adesea în procesul intern, nu în software.

Ce să faceți luna aceasta

  1. Numărați facturile emise și primite în ultima lună, pe fiecare firmă din grup, și notați cine le-a transmis și cine le-a descărcat.
  2. Verificați ce face efectiv modulul din ERP. Trimite doar facturile sau urmărește și starea, descarcă facturile primite și le importă? Întrebați furnizorul ERP în scris.
  3. Comparați facturile primite din SPV în ultimele 60 de zile cu cele înregistrate în ERP. Facturile care există doar în SPV arată cât de mare este decalajul.
  4. Stabiliți al cui certificat se folosește pentru fiecare firmă și ce se întâmplă dacă persoana respectivă lipsește sau certificatul expiră.

Dacă rezultatul arată decalaje constante, mai multe firme urmărite de mână sau o dependență de o singură persoană, problema este de integrare. Pe această parte lucrăm în proiectele de conformitate ANAF: e-Factura legată direct de ERP-ul existent, cu facturile emise urmărite până la validare, facturile primite descărcate și importate zilnic și o singură evidență pentru toate firmele din grup.

Întrebări frecvente

Este obligatoriu să folosim API-ul ANAF?

Nu. Legea cere transmiterea facturilor în sistemul RO e-Factura, în termen, nu un anumit mod de transmitere. SPV-ul, aplicațiile gratuite și modulele din programele de facturare sunt la fel de valabile.

Cât timp este valabil tokenul OAuth pentru e-Factura?

Conform documentului ANAF, tokenul de acces este valabil 90 de zile, iar tokenul de reîmprospătare 365 de zile. Cu tokenul de reîmprospătare se obține o pereche nouă fără certificat, dar după expirarea lui este nevoie din nou de autentificarea cu certificatul digital.

Putem lucra prin API pentru mai multe firme din grup cu un singur certificat?

Tokenul permite accesul la firmele pe care le reprezintă certificatul folosit la autentificare, adică acelea pentru care titularul are drepturi SPV de reprezentant legal, reprezentant desemnat sau împuternicit. Fără aceste drepturi pe o firmă, aplicația nu poate lucra pentru ea.

Ce se întâmplă cu facturile primite pe care nu le-am descărcat în 60 de zile?

După 60 de zile de la validare, mesajele sunt arhivate și nu se mai pot descărca din SPV sau prin API, ci doar la cerere. De aceea, facturile primite trebuie descărcate și păstrate în sistemul propriu cât mai repede după sosire.

Modulul nostru de e-Factura folosește deja API-ul. Mai avem nevoie de integrare?

Poate nu. Dacă modulul acoperă și starea facturilor emise, și descărcarea facturilor primite, pentru toate firmele, iar rezultatele ajung în ERP fără intervenție manuală, aveți deja o integrare. Dacă acoperă doar trimiterea, restul fluxului rămâne manual.

Surse

  1. ANAF, Procedura de înregistrare a aplicațiilor în portalul ANAF (OAuth), versiunea din 17 octombrie 2024.
  2. Ministerul Finanțelor, Informații tehnice e-Factura, cu documentația API și limitele de apeluri.
  3. Paycode, Documentație tehnică e-Factura, care reproduce limitele de apeluri pe servicii. Consultat în octombrie 2026.
  4. anafpy, Referință API e-Factura, cu lista serviciilor și a ferestrei de 60 de zile, pe baza documentației Ministerului Finanțelor. Consultat în octombrie 2026.
  5. ANAF, OUG 89/2025, art. X, publicată în Monitorul Oficial nr. 1203 din 24 decembrie 2025.
  6. Fiscalitatea.ro, Emitentul este obligat să descarce fișierul XML în momentul trimiterii facturii?, 5 februarie 2024.
  7. Gândul, ANAF: nu a fost luată în calcul dezvoltarea unei aplicații stand alone pentru gestiunea facturii electronice, 14 iulie 2025.

Vă spunem dacă fluxul dumneavoastră de e-Factura are nevoie de integrare.

Într-o discuție gratuită ne descrieți câte facturi emiteți și primiți, din ce sistem pleacă și cine le urmărește în SPV. Nu avem nevoie de acces în sisteme. Vă spunem direct dacă are sens să lucrăm împreună sau dacă ce aveți acum este suficient.

Despre analiza gratuită