Doar iframe-ul
Un iframe în pagina ta. Utilizatorii intră cu contul Chappa și au toată platforma, fără să iasă din aplicația ta.
Codul
Pune iframe-ul unde vrei facturarea, într-o pagină a aplicației tale:
<iframe src="https://facturare.chappa.ro/embed/"
width="100%" height="820" style="border:0" allow="clipboard-write"
title="Facturare"></iframe>Atât. Nu ai chei, nu ai server, nu ai JavaScript. Înălțimea o alegi tu; 760 până la 900 de pixeli arată tot ecranul de facturare fără derulare dublă.
Iframe-ul are nevoie să afle ce site îl afișează, ca să i-l arate utilizatorului înainte de autentificare. Browserul i-o spune singur, dacă pe iframe nu pui referrerpolicy="no-referrer". Orice altă valoare, inclusiv lipsa atributului, este bună.
Ce văd utilizatorii
- Un ecran cu butonul Intră cu contul Chappa.
- O fereastră Chappa în care confirmă că site-ul tău, numit cu adresa lui, poate afișa facturarea lor. Apoi se autentifică, sau își fac un cont, gratuit.
- Platforma întreagă, în pagina ta: firmele lor, facturi, proforme, chitanțe, încasări, conexiunea cu SPV, facturile primite.
Sesiunea rămâne pe site-ul tău 14 zile de la ultima folosire, așa că utilizatorii nu se autentifică la fiecare vizită. Browserul o păstrează separat pentru fiecare site care afișează Facturare: autentificarea pe site-ul tău nu deschide Facturare pe alt site.
Utilizatorii își adaugă singuri firmele, cu datele completate din registrul ANAF după CUI, exact ca pe facturare.chappa.ro. Tot ce fac aici se vede și acolo: e același cont.
Parametri în adresă
| Parametru | Valori | Ce face |
|---|---|---|
view | dashboard, invoices, new-invoice, new-proforma, received, payments, clients, products, settings, anaf | Ecranul cu care se deschide. |
theme | light, dark, auto | Ziua sau noaptea; auto urmează sistemul. Culorile, fontul și navigarea se schimbă prin API (aspectul). |
<iframe src="https://facturare.chappa.ro/embed/?view=new-invoice&theme=light" …></iframe>Evenimente, dacă vrei să le asculți
Iframe-ul anunță pagina ta când se întâmplă ceva: factură emisă, trimisă, validată sau respinsă de ANAF, încasată. Nu e nevoie să le asculți. Dacă vrei, sunt mesaje JSON obișnuite:
addEventListener('message', ev => {
if (ev.origin !== 'https://facturare.chappa.ro') return;
const m = ev.data;
if (m?.chappa === 'facturare/1' && m.kind === 'event') console.log(m.type, m.payload);
});Lista completă e în API.
Când alegi alt mod
- Utilizatorii tăi ar trebui să lucreze fără un cont Chappa, direct pe contul din aplicația ta: cu utilizatorii tăi.
- Vrei să trimiți facturi precompletate, produsele tale sau să emiți din pagina ta: cu API-ul.
Cost
Gratuit, pentru tine și pentru utilizatori, fără limită de facturi sau de firme. Platforma se finanțează din integrările în care autentificarea o faci tu (prețuri).