Ce este Spațiul Privat Virtual (SPV)?
Spațiul Privat Virtual este platforma online a ANAF prin care firmele și persoanele fizice comunică electronic cu administrația fiscală: primesc documente, transmit declarații și — cel mai important pentru facturare — accesează sistemul RO e-Factura.
Toate facturile electronice ale firmei tale circulă prin SPV. De aceea, accesul programatic la SPV este fundația oricărei automatizări de facturare.
Cum obții acces la SPV pentru firma ta
Înrolarea firmei în SPV se face pe portalul ANAF, de regulă pe bază de certificat digital calificat înregistrat pe reprezentantul legal sau pe un împuternicit. Odată înrolată firma, poți autoriza aplicații terțe să acceseze datele e-Factura în numele ei.
- Obții un certificat digital calificat (dacă nu ai deja)
- Înregistrezi certificatul la ANAF și înrolezi firma în SPV
- Din acel moment poți autoriza aplicații prin mecanismul OAuth ANAF
Cum funcționează conectarea prin OAuth ANAF
OAuth este mecanismul standard prin care autorizezi o aplicație să acceseze date în numele tău, fără să îi dai parola sau certificatul. Practic: aispv.ro te redirecționează către ANAF, te autentifici acolo cu certificatul tău, iar ANAF eliberează aplicației un token de acces cu durată limitată.
Tokenul poate fi revocat oricând, iar aispv.ro nu are niciodată acces la certificatul sau credențialele tale ANAF. Este exact modelul folosit și de conectările „Sign in with Google”.
De reținut: Autorizarea OAuth se face o singură dată; reînnoirea tokenului se face automat, iar tu primești notificare doar dacă e nevoie de reautorizare.
Pașii de conectare în aispv.ro
După ce îți creezi contul și adaugi firma (o validăm automat după CUI la ANAF), conectarea SPV durează aproximativ două minute:
- Apeși „Conectează SPV” din aplicație
- Ești redirecționat pe portalul ANAF, unde te autentifici cu certificatul
- Confirmi autorizarea pentru firma ta
- Revii automat în aispv.ro — sincronizarea începe imediat
Ce se întâmplă după conectare
Din momentul conectării, aispv.ro verifică periodic SPV-ul și descarcă automat toate facturile noi — primite și trimise — împreună cu mesajele SPV. Fiecare factură este parsată din XML, trecută prin cele 5 verificări automate și adăugată în arhiva de 5 ani.
Dacă accesul expiră sau este revocat, primești imediat notificare și poți reconecta contul într-un minut, fără să pierzi nimic din arhiva existentă.