Token SPV (OAuth ANAF)

Tokenul OAuth ANAF este perechea de chei software pe care ANAF o emite după ce te autentifici o dată cu certificatul digital: o cheie de acces valabilă 90 de zile și o cheie de reînnoire valabilă 365 de zile. Ele susțin accesul automat la e-Factura, fără ca tokenul USB să mai fie conectat.

Termenul „token SPV” înseamnă, în practică, două lucruri diferite, ușor de confundat. Pe de o parte există tokenul USB — stickul care conține certificatul digital calificat și cu care îți dovedești identitatea în fața ANAF. Pe de altă parte există tokenul OAuth — perechea de chei software pe care ANAF o emite în urma acelei autentificări. Această pagină descrie al doilea înțeles: tokenul OAuth care face posibil accesul automat, nesupravegheat.

Cum se obține tokenul OAuth

ANAF folosește un mecanism OAuth 2.0. Te autentifici o singură dată cu certificatul pe site-ul ANAF, iar ANAF îți dă apoi două chei software. Certificatul folosit la autorizare trebuie să fie înrolat în SPV cu unul dintre drepturile de persoană juridică — reprezentant legal, reprezentant desemnat sau împuternicit.

ANAF îți dă astfel două chei:

• cheia de acces — valabilă 90 de zile; cu ea se preiau efectiv facturile din e-Factura;
• cheia de reînnoire — valabilă 365 de zile; nu accesează direct nimic, ci servește exclusiv la obținerea unei chei de acces noi când cea curentă expiră.

Reînnoirea — și de ce contează schimbarea cheilor

Când cheia de acces de 90 de zile expiră, se cere una nouă pe baza cheii de reînnoire, prin software, fără certificat. Detaliul esențial: la fiecare reînnoire ANAF returnează atât o cheie de acces nouă, cât și o cheie de reînnoire nouă — așadar ambele se schimbă. Cheia de reînnoire anterioară nu mai este valabilă, iar cea nouă trebuie salvată imediat, altfel lanțul se rupe și ai nevoie de o nouă autorizare cu tokenul USB.

Atâta timp cât cheia de reînnoire este folosită și împrospătată înainte de a împlini un an, accesul rulează continuu. Dacă, în schimb, cheia de reînnoire iese din fereastra de 365 de zile fără să fie reînnoită, perechea de chei moare și trebuie reconectat o dată tokenul USB pentru a porni un nou ciclu. Aceasta este toată miza reînnoirii automate: să nu ajungi niciodată în punctul în care un lanț expirat te trimite înapoi la stick.

Ce este și ce nu este în token

Conținutul tokenului poate fi citit. Conform documentației oficiale ANAF, el cuprinde identificatorul aplicației, emitentul, rolul atribuit și seria certificatului. Ce nu conține este la fel de important: nu există în token nicio listă de CUI-uri și nicio enumerare a firmelor. Legătura dintre certificat și firmele pentru care are drept în SPV stă doar pe serverele ANAF și apare separat, când ANAF îți returnează lista de mesaje, pentru fiecare CUI în parte.

Modelul „autorizezi o dată, rulează singur”

Tokenul OAuth este exact mecanismul pe care se bazează preluarea automată din eFacturaSPV. Conectezi ANAF o singură dată cu tokenul USB; de acolo lucrăm doar cu perechea OAuth oficială, pe care o reînnoim în fundal înainte de expirare. Așa rămâne validă autorizarea pentru descărcarea automată a facturilor primite din SPV, fără să mai intri în SPV și fără să mai atingi stickul. Detaliile tehnice ale acestei conexiuni sunt descrise pe pagina conectorului e-Factura.

← Înapoi la dicționarul e-Factura