Inregistrarea in SPV pentru serviciile API eFactura si eTransport pentru aplicatia SmartCash RMS

Din acest articol veti afla care sunt pasii necesari pentru a putea sa activati accesul folosind metoda oAuth2 la serviciile eFactura si eTransport pentru aplicatia SmartCash RMS.

Pentru a activa autentificarea firmei dvs. la serviciile API ANAF eFactura si eTransport sunt necesari cativa pasi care nu sunt totdeauna simplu de inteles de catre utilizatorul neinitiat.

Ne-am gandit asadar sa creem acest articol in care sa explicam in cativa pasi simpli care sunt etapele de obtinere a credentialelor necesare pentru conectarea la API-ul ANAF si cum sunt ele folosite la configurarea programului SmartCash ANAF Connector.

Pornim de la premiza ca deja sunteti inregistrat in SPV si aveti deja un stick USB cu semnatura digitala asociat contului firmei dvs. in SPV ANAF.

Pentru obtinerea datelor de acces la serviciile API ANAF, trebuie sa deschideti pagina: https://www.anaf.ro/anaf/internet/ANAF/servicii_online/inregistrare_utilizatori al carui aspect il vedeti in imagina urmatoare.

Folosind link-ul din coloana “Dezvoltatori Aplicatii” cu denumirea: “Inregistrare pentru API-uri” se deschide urmatoarea adresa: https://www.anaf.ro/InregOauth/index.xhtml.

Interfata ce este afisata este urmatoarea:

In cazul in care detineti deja un cont de persoana fizica in SPV ANAF, il puteti asocia direct si la interfata API fara a mai fi nevoie sa completati formularul. Pentru aceasta dati click pe textul “click aici” din prima linie de text a formularului si urmati instructiunile ce sunt afisate.

In cazul in care doriti insa crearea unui cont nou valabil doar pentru interfetele API, atunci completati toate campurile din formular cu date valide si dupa ce introduceti codul de verificare apasati butonul “Continua”.

Confirmati activarea contului prin intermediul unui link inclus in e-mail-ul care va fi transmis pe adresa utilizata la inregistrare.

Dupa ce contul este creat si activat va puteti conecta la sistemul de gestionare al interfetelor API ANAF folosind pagina de autentificare disponibila la adresa urmatoare: https://pfinternet.anaf.ro/

In urma autentificarii este disponibila urmatoarea interfata in care se vor introduce datele aplicatiei SmartCash RMS.

Pentru un cont deja existent pe portalul ANAF, butonul “Editare profil OAuth” apare la sfarsit in lista butoanelor superioare.

In cazul unui cont special doar pentru interfata API ANAF este afisat doar butonul “Editare profil OAuth”, alaturi de cel de Deconectare.

Interfata de control se va afisa folosind butonul “Editare profil OAuth”.

In formularul ce apare se vor completa campurile cu urmatoarele valori:

Denumire aplicatie: SmartCash_RMS (atentie cu “_” intre cuvinte nu spatiu);
Callback URL 1: https://www.smartcash.ro/anaf-oauth
Serviciu: Se va selecta atat e-Factura cat si e-Transport.

La final se apasa butonul “Generare Client ID”.

Folositi exact valorile descrise in acest exemplu deoarece ele sunt utilizate la randul lor ca cuvinte cheie in procesul de handshake automat al aplicatiei SmartCash ANAF Conector. Atentie la CallBack URL! Adresa trebuie sa fie exact cea de mai sus, fara alte caractere suplimentare!

Atentie, datorita unui bug al site-ului ANAF, efectul apasarii butonului “Generare Client ID” nu e vizibil decat dupa un refresh manual al paginii.

Prin urmare apasati tasta F5 sau dati refresh la pagina de browser pentru a vedea rezultatul operatiei.

Rezultatul este urmatorul:

Cu un click pe linia aplicatiei (pot fi definite maxim 5 aplicatii diferite pentru un cont), sunt afisate toate detaliile necesare pentu autentificarea la serviciul API ANAF.

In optiunile aplicatiei SmartCash ANAF Connector trebuiesc introduse valorile campurilor: Client ID si Client Secret, impreuna cu toate cele 3 URL-uri afisate in campul Auth URL, ca in imaginea urmatoare:

Dupa copierea si inserarea informatiilor mentionate in interfata de optiuni SmartCash ANAF Connector, se cupleaza la statia de lucru stick-ul USB continand semnatura digitala autorizata a firmei dvs.

Odata cuplat si instalat, stick-ul USB cu semnatura autorizata ANAF se apasa apoi butonul “Initializare Token cu Semnatura Digitala”.

In functie de software-ul Windows folosit, sunt afisate cel putin doua mesaje.

Primul este cel de selectie a semnaturii digitale de pe memory stick (in cazul in care sunt mai multe pe el).

Iar al doilea, ce se afiseaza dupa apasarea butonului OK, este PIN-ul memory stick-ului.

Dupa introducerea corecta a PIN-ului, daca conexiunea la internet exista si este activa, serverele ANAF sunt contactate si este initializat tokenul pentru acces la serviciul API ca in imaginea urmatoare:

Toate cele 3 campuri subliniate sunt completate automat. Apasati butonul OK pentru salvarea optiunilor respective.

De acum inainte, puteti extrage stick-ul de semnare din portul USB deoarece el nu mai este necesar.

SmartCash ANAF Connector isi va reimprospata automat Auth Tokenul dupa aproximativ 60 de zile, fara a mai trebui sa folositi semnatura digitala USB deloc pentru aceasta instanta de program.

Din acest articol veti afla care sunt pasii necesari pentru a putea sa activati accesul folosind metoda oAuth2 la serviciile eFactura si eTransport pentru aplicatia SmartCash RMS.

Referinte