Autorizarea ANAF

Cum se conectează o firmă

Autentificarea în aplicația ta și accesul la SPV-ul unei firme sunt lucruri separate. Pentru a trimite facturi și a citi facturile primite, o persoană cu certificat digital calificat și drepturi în SPV pentru firmă autorizează o dată (accesul ține până la un an):

• Din iframe: în Setări → e-Factura, butonul deschide ANAF într-o fereastră nouă; la final fereastra se închide și iframe-ul se actualizează (evenimentul anaf.connected). Utilizatorul nu iese din aplicația ta.
• Cu întoarcere în aplicația ta (pagină întreagă): f.startAnafAuthorization({ returnUrl: 'https://app.exemplu.ro/setari/facturare' }) întoarce adresa ANAF; după autorizare browserul revine la returnUrl cu ?chappa_anaf=ok (sau =error&chappa_anaf_code=…). La succes, chappa_anaf_code spune ce s-a întâmplat: verified (firma a devenit verificată), admin (utilizatorul a devenit administrator verificat al unei firme deja verificate), joined (firma era verificată în altă parte: utilizatorul a intrat în ea, iar copia lui rămâne separată până o mută). returnUrl trebuie să fie pe originea din ori sau pe una dintre originile înregistrate ale integrării.
• Link pentru contabil: f.createAnafAuthorizationLink() (sau din Setări) dă un link valabil 7 zile; contabilul nu are nevoie de cont și vede exact ce firmă conectează.

Accesul se acordă doar dacă certificatul are drepturi pe CUI-ul/CNP-ul acelei firme (verificăm la ANAF înainte să-l salvăm).

Cine o poate face

Orice utilizator al firmei care are permisiunea anaf:connect poate porni autorizarea. Dovada e a lui: cine se autentifică la ANAF cu certificatul (sau cel care trimite linkul contabilului) devine administrator verificat al firmei, iar firma devine verificată, una singură în toată platforma Chappa (firme verificate).

Dacă firma era deja verificată, autorizarea reînnoiește conexiunea pentru toți membrii ei; cel care a făcut-o devine și el administrator verificat.

În fiecare mod

• Doar iframe-ul și cu utilizatorii tăi: utilizatorul pornește autorizarea din iframe, în Setări → e-Factura și ANAF, într-o fereastră nouă, sau generează de acolo linkul pentru contabil.
• Cu API-ul: la fel, plus startAnafAuthorization (cu întoarcere în aplicația ta) și createAnafAuthorizationLink din pagina ta.

Cât ține

Accesul dat de ANAF ține un an de la autentificarea cu certificatul. Pagina firmei arată până când e valabil; o nouă autorizare îl prelungește. Dacă accesul dat de ultima autorizare expiră sau ANAF nu îl mai reînnoiește, conexiunea trece singură pe autorizarea dinainte, cât timp aceea e încă valabilă.

Evenimentul anaf.connected anunță pagina ta când o firmă a fost conectată.