e-Factura (ANAF SPV)

Pagina e-Factura (Administrativ → e-Factura, /efactura) trimite facturile de ieșire emise din Financiar în sistemul național RO e-Factura și preia facturile primite de la furnizori.

Specificațiile după care lucrează:

• Formatul facturii: UBL 2.1 (OASIS), standardul european EN 16931 cu specificația română CIUS-RO (Ordinul MF 1366/2021 și actualizările publicate de MF pe mfinante.gov.ro → e-Factura). XML-ul se verifică pe schemele UBL 2.1 oficiale și pe regulile CIUS-RO (BR-RO) înainte de trimitere.
• Serviciile web: „Prezentare servicii web pentru Sistemul național privind factura electronică RO e-Factura” (MF) — serviciile de încărcare (upload, uploadb2c), starea mesajului (stareMesaj), lista mesajelor (listaMesajePaginatieFactura) și descărcarea, pe adresele api.anaf.ro/test și api.anaf.ro/prod. Validarea (FACT1 / FCN) și transformarea în PDF sunt publicate de MF doar în producție, deci Nexus le cheamă la serviciul public fără autentificare (webservicesp.anaf.ro) și în modul Test.
• Autentificarea: profilul OAuth2 ANAF (logincert.anaf.ro/anaf-oauth2/v1): aplicația se înregistrează în portalul ANAF, iar autorizarea se face o dată cu certificatul digital al persoanei care are drept în SPV pentru CUI-ul spitalului. Tokenul de acces e valabil 90 de zile, cel de reîmprospătare 365 de zile; Nexus reînnoiește tokenul automat cu 7 zile înainte de expirare.

Moduri

Setarea efactura.mod (Sistem → Raportări și instituții → e-Factura (ANAF SPV)):

• Simulat (implicit): nimic nu pleacă din Nexus. Simulatorul SPV din Nexus răspunde în aceleași formate, după aceeași validare locală; e potrivit pentru instruire și pentru verificarea datelor. Indexul de încărcare simulat e unic și după o repornire a serverului (continuă peste cel mai mare index simulat salvat), deci două facturi nu primesc același index.
• Test ANAF: mediul de test al ANAF (api.anaf.ro/test): facturile nu produc efecte fiscale.
• Producție ANAF: facturile ajung la cumpărători prin SPV. Înainte de trimitere, Nexus cere confirmarea „PRODUCȚIE ANAF”.

Test și producție cer autorizarea OAuth (tabul Conexiune ANAF).

Facturi emise

Lista facturilor de ieșire pe interval, cu starea e-Factura (netrimisă, încărcată, validată, respinsă, în transmitere). Pe fiecare factură:

• Validează: generează XML-ul UBL și arată erorile de validare și datele care lipsesc (CUI-ul, adresa, localitatea și județul unității și ale clientului). Cu dreptul financiar.administrare, în modurile Test și Producție XML-ul se validează și la serviciul ANAF (fără el și în modul simulat, doar local). Descarcă XML-ul salvează fișierul generat.
• Trimite în SPV: încarcă factura în SPV; o factură care nu trece validarea nu pleacă. O factură deja încărcată, validată sau în transmitere nu se mai retrimite (s-ar dubla la client); două trimiteri simultane ale aceleiași facturi ajung la SPV o singură dată.
• În transmitere: SPV nu a răspuns la încărcare (conexiune căzută, timeout), deci nu se știe dacă factura a ajuns. Retrimiterea e blocată. Verificați în SPV (sau cu Sincronizează cu SPV), apoi deschideți mesajul din jurnal și apăsați Rezolvă transmiterea: cu indexul de încărcare găsit în SPV mesajul devine „încărcată” (starea se ia apoi cu Verifică starea); lăsând indexul gol, factura e considerată neajunsă și se poate retrimite. Motivul se păstrează în jurnal.
• Persoane fizice (B2C): un client fără CUI (sau cu un CNP în câmpul CUI) cere CUI-ul, cât timp setarea Facturi către persoane fizice (B2C) e pe „nu” (implicit). Pe „da”, factura pleacă prin serviciul ANAF de raportare B2C (uploadb2c), cu CNP-ul clientului sau cu identificatorul tehnic de 13 cifre de 0. Porniți-o doar după ce contabilul șef confirmă obligația de raportare B2C a unității.
• Trimite stornarea: pentru o factură validată de ANAF și apoi anulată în Nexus se trimite nota de creditare (CreditNote, standardul CN), cu trimitere la factura inițială.

Datele care intră în XML: seria și numărul, data, scadența, unitatea (din Sistem → Unitatea → Unitatea sanitară și din setările e-Factura: județul ca cod ISO, ex. RO-B, localitatea — în București SECTOR1 … SECTOR6, codul poștal), clientul (din Financiar → Clienți: CUI, adresă, localitate, județ, țară, plătitor de TVA), liniile cu unitatea de măsură (UN/ECE Rec. 20, implicit C62) și categoria de TVA. Serviciile medicale sunt scutite: categoria implicită E, cu motivul scutirii din efactura.motiv_scutire; pentru o unitate neplătitoare de TVA se poate alege O. O unitate neplătitoare de TVA (setarea „Unitatea e plătitoare de TVA” = nu) facturează doar fără TVA, cu categoria O sau E: o linie cu cotă de TVA (de exemplu 21 %, categoria S) e o eroare la Validează și oprește trimiterea, cu mesajul „Linia „…” are TVA 21 % (categoria S), dar unitatea nu e plătitoare de TVA …”; se pune cota 0 pe linie sau, dacă unitatea e înregistrată în scopuri de TVA, se schimbă setarea. Regula nu se aplică notei de creditare (stornarea): ea reia liniile facturii inițiale, deja validate de ANAF, cu TVA-ul lor, chiar dacă între timp setarea a devenit „nu”.

Facturi primite

Sincronizează cu SPV citește din SPV lista mesajelor din ultimele zile (cel mult 60, limita ANAF), descarcă facturile primite și actualizează stările facturilor trimise. O factură primită se vede cu emitentul, numărul, data și totalul; Înregistrează ca factură de furnizor (ciornă) o înregistrează în Financiar → Facturi de intrare ca ciornă (furnizorul se găsește sau se creează după CUI), iar contabilul completează capitolul bugetar și NIR-ul.

Jurnal SPV

Toate schimburile cu ANAF: direcția, factura, indexul de încărcare, starea ANAF, mesajul și fișierele (XML-ul trimis, arhiva ZIP descărcată cu factura semnată de MF sau cu erorile, PDF-ul), fiecare cu amprenta SHA-256. Verifică starea interoghează din nou o încărcare aflată „în prelucrare”; Rezolvă transmiterea încheie un mesaj rămas „în transmitere” (vezi mai sus); PDF (transformare ANAF) cere vizualizarea facturii de la serviciul public de transformare ANAF.

Conexiune ANAF

Arată modul, adresa, CUI-ul și ce lipsește. Pași, o singură dată:

1. În portalul ANAF (anaf.ro → Servicii online → Înregistrare aplicații OAuth) se înregistrează aplicația, cu serviciul E-Factura și Callback URL = adresa paginii /efactura/autorizare din Nexus (aceeași adresă se pune în setarea efactura.redirect_uri).
2. Client ID-ul și Client secret-ul primite se trec în setările efactura.client_id și efactura.client_secret.
3. Conectare ANAF (certificat digital) deschide pagina de autentificare ANAF; după alegerea certificatului, ANAF revine la /efactura/autorizare, iar Nexus salvează tokenurile (setări secrete, mascate în jurnale). Autorizarea se finalizează în aceeași filă a browserului, de același utilizator, în cel mult 15 minute (pornirea lasă în filă un bilet semnat, pe care pagina de revenire îl trimite cu codul ANAF); altfel porniți din nou Conectare ANAF.

Reînnoiește tokenul cere imediat un token nou; Deconectare șterge tokenurile din Nexus. Pornirea și finalizarea autorizării cer dreptul admin.sistem.

Drepturi

financiar.vizualizare vede facturile, jurnalul, fișierele și validează local; financiar.administrare validează și la ANAF, trimite, stornează, rezolvă transmiterile rămase fără răspuns, sincronizează și preia facturile primite; admin.sistem gestionează conexiunea OAuth.