Gestionarea tokenurilor virtuale

Tokenul virtual este de fapt o parola si este folosit pentru autentificare in E-factura si E-tranport fara a fi nevoie de prezenta tokenului fizic (semnatura electronica) in portul USB al calculatorului pe care lucram.
Tokenul virtual poate fi folosit numai daca "metoda de acces SPV" este OAUTH

Tokenul poate fi stocat in baza de date (recomnadat) sau in fisierul "tokenuri.txt" dupa dorinta ,configurabil la "Tokenul OAUTH se afla in"

Daca folosim tokenul stocat in baza putem avea tokenuri diferite pentru grupuri de firme folosite in program. Pentru fiecare token trebuie sa enumeram cuiurile care-l vor folosi in campul "Cuiuri"
Daca folosim tokenul stocat in fisierul "tokenuri.txt" , cuiurile nu mai fac diferenta si va fi utilizat pentru toate firmele care au selectata optiunea "fisierul tokenuri.txt"

In fereastra "Tokenuri" avem functii pentru obtinerea tokenului virtual , reinnoirea acestuia in momentul expirarii(refresh) sau stergerea din SPV
Este suficient si necesar sa avem un singur token valid la un moment dat
Grila principala a ferestrei Tokenuri contine toate tokenurile valide si invalide folosite (este indicat sa pastram istoricul tuturor tokenurilor)
Un rand din grila reprezinta un Token
Nu este necesar sa avem mai mult de un token valid pentru o SC (un CUI) la un moment dat
Campurile folosite in aceasta activitate pot fi grupate in perechi si sunt:
- perechea Callback-ID-Secret - se obtine din SPV. Perechea este unica in SPV dar nu este unica in aceasta fereastra pentru ca fiecare pereche poate avea mai multe tokenuri
- perechea Token-Refresh - se obtine prin aceasta aplicatie pe baza unei perechi Callback-ID-Secret. Perechea Token-Refresh este unica in aceasta grila Tokenul este folosit pentru autentificare in E-factura si E-trasport , iar Refreshul se foloseste pentru obtinerea unui token nou in momentul expirarii

Obtinerea tokenului

1-Pentru a putea crea si utiliza un token virtual este necesar sa ne inscriem mai intai in portalul ANAF ca "utilizator pentru API" Acest lucru se face o singura data la https://anaf.ro, sectiunea: Servicii Online > Inregistrare utilizatori > Dezvoltatori aplicatii > Inregistrare prtr API (vezi ghidul paginile 6-9) In urma acestui pas vom avea un Utilizator si o Parola

2-Cu Utilizatorul si Parola obtinute ca mai sus merge in portalul ANAF la Autentificare utilizator si dupa ce mai completam cateva campuri (paginile 14-17 din ghid) obtinem un clientID si un clientSecret ,astfel:
-ne autentificam (vezi 2 din fig.de mai jos) in SPV la Autentificare Utilizator (NU Autentificare certificat) cu userul si parola de mai sus
-primim un cod pe mail pe care-l introducem (vezi 3 mai jos)
- click pe Editare profil OAUTH

- in fereastra deschisa la Editare profil OAUTH completam : Denumire aplicatie ,Callback URL cu valoarea: "https://www.anaf.ro/" si la Servciu bifam ambele optiuni (E-Factura si E-Transport)
si apoi  click pe Genereare Client ID
- mai jos in aceeasi pagina vor apare valorile ClientID si ClientSecret

3-Apoi mergem in pagina Efactura > butonul Tokenuri virtuale. Se da click pe butonul Nou si se completeaza campurile: Callback, ID si Secret cu valorile obtinute in portalul ANAF
! copiati neaparat folosind copy-paste
Mai departe pe calculatorul pe care lucram introducem semnatura electonica in portul USB si dam click pe butonul "Genereaza token pentru acest ID" Se va cere PINul
Daca toate lucrurile functioneaza bine , in campurile Token si Refresh vor apare cate un sir de caractere si vom fi anuntati despre finalizarea operatiei
La intrebrarea "doriti sa folositi acest token.. " click pe Yes
Valabilitatea tokenului obtinut este de cca 3 luni ( a se vedea Data de expirare) dupa care va trebui sa obtinem un token nou prin functia "refresh Token"
Puteti genera mai multe tokenuri noi dar nu are sens , mai ales ca numarul tokenurilor se pare ca este este limitat la o valoare necunoscuta. Deci nu generati tokenuri noi fara sa fie necesar

Refresh token

Este metoda cea mai convenabila de prelungirea a functionarii peste perioada de viata normala a unui token de 3 luni
Refreshul trebuie facut pana in data expirarii (ubeori se poate si cateva zile dupa expirare) si este anuntat de program cu o saptamana inainte
Nu este necesar tokenul fizic pentru realizarea acestei operatii
Practic , in fereastra tokenuri ne pozitionam pe randul cu tokenul valid inca si actionam butonul "Refresh Token"
Daca Refreshul se realizeaza corect se va crea o inregistrare noua avand acelasi Callback,Id si Secret dar cu tokenul nou
Daca apar erori in timpul activitati de generare suntem avertizati prin mesaj
Tokenul vechi (inregistrarea initiala) va fi marcat ca "inactiv" Daca tokenul vechi era valid inaintea acestei operatii va fi in continuare valid (folosibil)

Alte functii disponibile