Firme și drepturi

Utilizatorul lucrează pe firme: companii, PFA-uri sau persoane fizice. În modurile cu utilizatorii tăi le poți da tu, din aserțiune; altfel și le adaugă singur.

Firmele utilizatorilor

Un utilizator poate avea oricâte firme și persoane fizice. Fără ent, utilizatorul își adaugă singur firmele în iframe (cu completare automată din registrul ANAF). Cu ent, tu le dictezi:

"ent": [
  { "ref": "org_42", "kind": "pj",  "cif": "RO18547290", "name": "Alfa SRL", "reg_com": "J12/34/2010",
    "address": "Str. Unirii 1", "city": "Cluj-Napoca", "county": "Cluj", "vat_payer": true, "role": "admin" },
  { "ref": "pf_17",  "kind": "pf",  "cif": "1800101221144", "name": "Ion Pop", "city": "Sector 3", "county": "București",
    "efactura_registered": false }
],
"ent_lock": true

• ref este identificatorul firmei la tine, unic în integrarea ta. Doi utilizatori cu același ref lucrează pe aceeași firmă (aceleași serii, documente, conexiune ANAF), cât timp ea nu e verificată; într-o firmă verificată intră doar cine își dovedește drepturile SPV (mai jos).
• kind: pj (persoană juridică), pfa (PFA, II, IF, identificate prin CUI), pf (persoană fizică, după CNP). role: owner, admin, member, viewer (implicit admin).
• Cu ent_lock, datele trimise suprascriu profilul unei firme neverificate la fiecare aserțiune, iar utilizatorul nu poate adăuga alte firme.
• Codul fiscal al unei firme cu documente emise nu se mai poate schimba; pentru altă firmă folosește alt ref.
• O aserțiune nu dă niciodată acces la conexiunea ANAF a cuiva: conexiunea se creează doar printr-o autorizare reală la ANAF, pentru acea firmă, în integrarea ta (vezi).

Firme verificate

O firmă devine verificată când cineva își dovedește drepturile SPV pentru codul ei fiscal, conectând-o la ANAF. De atunci este o singură firmă în toată platforma Chappa, cu tot istoricul (documente, chitanțe, facturi trimise și primite). Cine își dovedește drepturile SPV pentru ea, din orice aplicație, devine administrator verificat și o vede întreagă.

• Din aplicația ta, drumul spre o firmă verificată este dovada SPV a utilizatorului. ent nu dă acces la ea: dacă utilizatorul nu e încă în firmă, iframe-ul i-o arată cu „Conectează-te la ANAF”, iar după dovadă intră. Răspunsul la init le listează în pendingAccess.
• Tu hotărăști ce înseamnă un utilizator. sub poate fi o persoană sau un cont de client la tine. Dacă mai mulți oameni de la tine lucrează pe aceeași firmă, trimite-le același sub: o singură dovadă SPV ajunge pentru toți, iar cu scope diferit pe fiecare aserțiune le dai permisiuni diferite.
• Aplicațiile nu se văd între ele. În iframe-ul tău nu apar alte aplicații sau oamenii lor, iar pe site-ul Chappa nu apar utilizatorii tăi. Iframe-ul tău nu are nici fila de utilizatori: cine lucrează pe ce o stabilești tu.
• Profilul și codul fiscal ale unei firme verificate nu se mai schimbă prin aserțiune; ent_lock doar le face needitabile în iframe-ul tău și ascunde firmele pe care nu le numești.
• Când firma pe care lucrau mai mulți devine verificată, rămâne în ea doar cel care a dovedit drepturile; ceilalți revin prin propria dovadă SPV (pe site-ul Chappa, și printr-o invitație de la un administrator verificat).
• ref-urile tale pentru clienți și produse rămân ale tale: alte aplicații care folosesc aceeași firmă nu le văd și nu le suprascriu.

Persoane fizice. Din 1 iunie 2026 (Legea 88/2026) RO e-Factura este opțională pentru furnizorii identificați prin CNP; cei înscriși în Registrul RO e-Factura opțional (formularul 081) trimit facturile în SPV cu CNP-ul (efactura_registered: true), ceilalți emit facturi clasice. PFA/II/IF au CUI și obligație e-Factura. Facturile către persoane fizice (B2C) se trimit în SPV cu CNP-ul clientului sau cu 0000000000000.

Permisiuni

scope restrânge ce poate face utilizatorul (lipsă = tot ce îi permite rolul):

Exemplu, un operator care doar emite: "scope": "documents:read documents:write documents:issue documents:submit payments clients products".