FacturareIntră în aplicație
Integrare în aplicația taCele trei moduri · pagina 1 din 10

RO e-Factura în aplicația ta

Trei moduri, de la un iframe fără niciun rând de cod la o integrare care vorbește cu aplicația ta. În niciunul nu scrii XML și nu vorbești cu ANAF.

Începe cu iframe-ulCompară modurile

Utilizatorii primesc platforma întreagă: facturi, proforme, chitanțe, încasări, conexiunea cu SPV și facturile primite. Treci de la un mod la altul fără să pierzi nimic.

Doar iframe-ul, în pagina ta

<iframe src="https://facturare.chappa.ro/embed/"
        width="100%" height="820" style="border:0"></iframe>

Cu utilizatorii tăi, în pagina randată de serverul tău

<?php $a = chappa_assertion($user->id); ?>
<iframe src="https://facturare.chappa.ro/embed/#assertion=<?= $a ?>"
        width="100%" height="820" style="border:0"></iframe>

Cu API-ul, în pagina ta

<iframe src="https://facturare.chappa.ro/embed/?api"
        width="100%" height="820" style="border:0"></iframe>

← { "type": "ready" }
→ { "type": "init", "payload": { "assertion": "eyJhbGci…" } }
→ { "type": "setProducts", "payload": { "products": [ … ] } }
→ { "type": "newInvoice", "payload": { "client": …, … } }
← { "type": "document.accepted", "payload": { "id": 812, … } }
Utilizatorii intră cu contul Chappa, gratuit, fără cod. Sau semnezi tu cine sunt, pe server. Sau vorbești cu iframe-ul din pagina ta.

Cele trei moduri

Toate afișează aceeași platformă în pagina ta. Diferă cine își autentifică utilizatorii și cât vorbește pagina ta cu ea.

CriteriuDoar iframe-ulCu utilizatorii tăiCu API-ul
Ce scriiUn iframeO funcție pe server care semnează, plus iframe-ulAceeași funcție, plus mesaje JSON
Cine își autentifică utilizatoriiChappa: fiecare intră cu contul luiTu, pentru utilizatorul logat la tineTu, pentru utilizatorul logat la tine
FirmeleLe adaugă utilizatorulLe poți da tu și le poți fixaLa fel, plus schimbarea firmei din pagina ta
Pagina ta poateAsculta evenimenteleAsculta evenimenteleTrimite produse și facturi precompletate, emite, trimite la ANAF, cere PDF-ul, schimba ecranul
SesiuneaȚine 14 zile de la ultima folosire, pe site-ul tăuȚine cât lucrează utilizatorul; după o oră de pauză, reîncarcă paginaSe reînnoiește singură
CostGratuitGratuit în modul test, apoi per utilizator activ pe lună (prețuri)
TimpUn minutAproximativ 20 de minuteAproximativ o oră

Ce au în comun

  • Platforma întreagă. Facturi, proforme, stornări, chitanțe, încasări, facturile primite din SPV și trimiterea în RO e-Factura, cu validarea CIUS-RO făcută de noi.
  • PDF-ul și emailul. PDF-ul îl facem noi, cu datele firmei și contul bancar, iar factura pleacă la client pe email din platformă, cu suma, scadența și IBAN-ul în mesaj, la facturile recurente și automat. Nu randezi nimic și nu trimiți niciun email; trimiterea pe email pornește după ce firma e conectată la ANAF.
  • ANAF pe firmă. O firmă se conectează la SPV o singură dată, de cine are certificatul ei, din iframe sau printr-un link trimis contabilului (autorizarea ANAF).
  • Aceleași firme. O firmă verificată este una singură în toată platforma Chappa: cine își dovedește drepturile SPV pentru ea îi găsește tot istoricul, indiferent de modul prin care a intrat (firme și drepturi).
  • Urci fără să refaci. De la utilizatorii tăi la API adaugi doar mesajele, cu aceeași aserțiune. Iframe-ul își citește modul din propria adresă, nu din cod.

Documentația

  1. Doar iframe-ulCodul, ce văd utilizatorii, parametrii adresei.
  2. Cu utilizatorii tăiAserțiunea în adresa iframe-ului, pas cu pas, în PHP, Node.js și Python.
  3. Cu API-ulMesajele JSON: comenzile, evenimentele și erorile.
  4. AserțiuneaCheile, câmpurile și semnarea ES256 în Node.js, Python, PHP și C#.
  5. Firme și drepturiFirmele utilizatorilor, firmele verificate, persoanele fizice, permisiunile.
  6. Autorizarea ANAFConectarea la SPV din iframe, cu întoarcere la tine sau prin contabil.
  7. SecuritateCe trece prin browser și de ce nu poate fi refolosit, verificat pe viu.
  8. Test, înregistrare, cheiModul test, portalul, rotația cheilor, nivelurile.

Resurse