Cum integrăm e-Factura ANAF într-un ERP custom
Obligativitatea e-Factura a prins multe firme nepregătite. Dacă folosiți un ERP custom sau o soluție proprie de facturare, integrarea cu sistemul ANAF SPV este posibilă prin API REST. Iată cum abordăm această integrare în proiectele noastre.
Ce este e-Factura ANAF?
E-Factura este sistemul național de facturare electronică obligatorie, implementat de ANAF. Din 2024, emiterea și transmiterea facturilor B2B în format XML UBL 2.1 prin SPV (Spațiul Privat Virtual) este obligatorie pentru companiile impozabile din România.
Arhitectura integrării
Integrarea dintr-un ERP custom presupune trei componente principale:
- Generarea XML UBL 2.1 — conversia datelor din ERP în formatul cerut de ANAF
- Autentificarea OAuth 2.0 cu SPV folosind certificat digital sau token de acces
- Transmiterea și monitorizarea prin API-ul REST ANAF e-Factura
Pași tehnici de implementare
1. Generarea fișierului XML
ANAF acceptă UBL 2.1 (Universal Business Language). Fișierul XML trebuie să conțină: date furnizor/client, linii de factură cu cod CPV, TVA defalcat pe cote, monedă și curs valutar BNR.
2. Autentificarea
API-ul ANAF folosește OAuth 2.0 cu token-uri de acces de scurtă durată (60 minute). Aplicația ERP trebuie să gestioneze refresh automat al token-ului și să stocheze credențialele în siguranță.
3. Transmiterea facturii
POST https://api.anaf.ro/prod/FCTEL/rest/upload
Content-Type: multipart/form-data
Authorization: Bearer {access_token}
file: [fisier_xml_semnat.xml]
cif: [CIF_firma]
4. Verificarea statusului
ANAF returnează un ID de tranzacție. Trebuie interogat periodic (polling) sau prin webhook dacă ANAF activează această funcționalitate.
Statusurile posibile: ok, nok, in prelucrare.
Ce oferim noi
În cadrul proiectelor ERP custom, implementăm modulul e-Factura ca o componentă separată, testabilă, cu suport pentru facturat în lei și valută, generare automată la confirmare comandă și arhivare XML locală. Contactați-ne pentru o evaluare a integrării în sistemul vostru existent.