Test, înregistrare, chei

Modul test și înregistrarea

Prima aserțiune validă cu o cheie nouă pornește o integrare în mod test: totul funcționează (inclusiv ANAF), cu o bandă „mod test” în iframe și limite:

Utilizatori per integrare	5
Documente emise per integrare	50
Durată	30 de zile
Integrări noi de test dintr-o rețea / zi	5
Integrări de test per site gazdă	3
Utilizatori pe toate integrările de test ale unui site	15
Documente emise prin integrări neînregistrate, per CUI/CNP	50

Limitele pe site, rețea și CUI există pentru că o cheie nouă nu costă nimic: rotirea cheilor nu resetează nimic important. La atingerea unei limite iframe-ul emite registration_required și explică utilizatorului; datele rămân.

Înregistrarea

1. Intră în portal cu contul Chappa și completează datele de facturare.
2. Asociază: portalul îți dă o provocare (purpose, nonce de unică folosință, sub = contul tău, aud). O semnezi cu cheia privată a integrării, cu chappa-sign.mjs:

   node chappa-sign.mjs chappa-private.pem '{"aud":"https://facturare.chappa.ro/dezvoltatori","purpose":"claim","nonce":"…","sub":"…"}'

3. Lipești dovada, vezi ce asociezi (utilizatori, prima origine, vechime) și confirmi.

Ai nevoie de ambele: dovada cheii private și confirmarea din contul tău. Cheia publică singură nu ajunge; o integrare deja asociată altui cont nu poate fi preluată. Poți înregistra și o cheie încă nefolosită: integrarea pornește direct înregistrată.

Rotația și revocarea cheilor

• Rotație: în portal → integrare → „Adaugă cheie”, semnezi provocarea cu cheia nouă. Ambele chei funcționează; mută serverul pe cheia nouă, apoi revocă-o pe cea veche. Utilizatorii sunt legați de integrare, nu de cheie, deci nu observă nimic.
• Revocare din portal: sesiunile deschise cu cheia se închid imediat; o cheie revocată nu poate porni nici o integrare nouă.
• Revocare de urgență (cheie scăpată, fără acces la portal): oricine deține cheia privată o poate revoca:

  node chappa-sign.mjs chappa-private.pem '{"aud":"https://facturare.chappa.ro/integrations","purpose":"revoke"}' > revoke.jws
  curl -X POST https://facturare.chappa.ro/api/facturare/integrations/revoke_key \
       -H 'Content-Type: application/json' -d "{\"token\":\"$(cat revoke.jws)\"}"

• Membrii integratorului primesc email la fiecare schimbare de chei.

Niveluri și facturare

	Gratuit	Test	Standard	Extins
Platforma în iframe	✓	✓	✓	✓
Utilizatori gestionați de tine (aserțiuni)	nu	✓ limitat	✓	✓
Comenzi (produse, ciorne, acțiuni), ent	navigare	✓	✓	✓
Temă (culoare, mod) și fără marcajul Chappa	nu	nu	nu	✓
Facturare	gratuit	gratuit	utilizatori activi / lună

Un utilizator activ = un sub care a deschis cel puțin o sesiune în luna respectivă (vezi „Utilizare lunară” în portal). Pentru utilizatorii finali, platforma rămâne gratuită.