01API REST · chei de acces · jurnal complet

ERP-ul tău trimite un JSON. La ANAF ajunge o factură validă.

Integrarea directă cu SPV e un proiect în sine: OAuth cu certificat, token reînnoit la ~90 de zile, UBL 2.1, RO_CIUS, urmărirea indexului de încărcare, citirea erorilor din arhiva ANAF. Toate astea sunt deja făcute. Sistemul tău trimite datele facturii într-un JSON, iar restul rămâne în sarcina noastră.

Creare și trimitere factură din API  ·  XML de import SAGA și WinMentor  ·  Endpointuri custom la cerere

02Ce te costă azi

Integrarea cu ANAF pare o săptămână de lucru. Sunt luni de întreținere.

Nu specificația e problema, ci ce vine după: tokenuri care expiră, statusuri de urmărit, erori de citit din arhive, schimbări de format.

01

OAuth și tokenuri de întreținut

Autorizarea trebuie reînnoită periodic, altfel fluxul se oprește tăcut. Cineva din echipa ta ajunge responsabil de asta, permanent.

02

UBL scris de mână

Categorii de TVA, unități de măsură, coduri obligatorii. Fiecare colț ratat înseamnă respingere și un ciclu de debug.

03

Retastare în contabilitate

Facturile ajung în sistem, apoi sunt reintroduse manual în programul de contabilitate. De două ori aceeași muncă — și de două ori riscul de greșeală.

03API public

Un apel, și factura pleacă

Trimiți datele facturii dintr-un sistem extern, autentificat cu o cheie de API. Platforma calculează TVA-ul, construiește XML-ul UBL 2.1 în varianta RO_CIUS, îl încarcă în SPV și urmărește statusul mai departe — pe aceleași reguli ca facturile create în interfață.

  • Autentificare cu chei de API emise per integrare, nu cu parola contului.
  • Retrimitere și trimitere forțată pentru cazurile în care ceva a mers prost pe drum.
  • Endpointuri custom la cerere — de exemplu, citirea facturilor nou primite direct în sistemul tău.
  • Webhook-uri semnate pentru statusul e-Factura — te anunțăm noi când ANAF acceptă sau respinge, fără interogare periodică.
  • Jurnal complet al cererilor, cu ecran dedicat de inspecție a traficului API — depanezi fără să ne suni.
  • Trimitere în masă: sute de facturi dintr-un fișier, din interfață; pe API, la cerere.
POST /api/v2/invoices Authorization: Bearer dh_xxxxx Content-Type: application/json { "client": { "id": "kL9mN2pQ7rS1" }, "date": "2026-08-01", "currency": "RON", "send_spv": true, "items": [ { "name": "Servicii mentenanță", "unit": "H87", "qty": 1, "price": 1500.00, "vat_rate": 21 } ] }

Exemplu din API v2. Referința completă — clienți, proforme, facturi, webhook-uri, coduri de eroare — e publică în documentația API. API v1 (/api/v1/invoice/add) rămâne activ pentru integrările care îl folosesc deja.

Vinzi pe WooCommerce?

Nu scrii nimic din API-ul de mai sus — pluginul gratuit conectează magazinul direct, iar API v2 (folosit și de plugin) acoperă orice altă integrare custom.

04Integrare contabilă

Datele ajung în contabilitate fără să le mai tasteze cineva

Alegi perioada și trimiți totul contabilului dintr-un buton: XML-ul de import plus un singur PDF cu toate facturile, gata de printat. Detalii pe pagina pentru contabili.

SAGA

Export SAGA

XML în formatul SAGA, pe intervalul de date ales. Îl descarci sau îl trimiți pe email contabilului, care îl importă în loc să retasteze.

WM

Export WinMentor

Același lucru pentru WinMentor, cu selector de perioadă, dintr-un ecran dedicat de export.

XML

Încărcare XML gata făcut

Dacă sistemul tău produce deja XML valid, îl încarci direct către SPV din platformă — pentru e-Factura și pentru e-Transport.

05Diferența

Ce cumperi nu e lista de endpointuri. E partea de ANAF pe care nu o mai întreții tu.

Într-un singur apel intră: XML conform RO_CIUS, încărcarea în SPV, urmărirea statusului, citirea erorilor din arhiva ANAF, arhivarea răspunsurilor și reînnoirea autorizării. Niciuna nu rămâne în sarcina echipei tale, nici acum, nici la următoarea schimbare de format.

Ai nevoie de un câmp, un format sau un flux care nu există? Îl construim — vezi dezvoltare la cerere.

Validare
Aceleași reguli de validare ca în interfață — nu un flux paralel, mai slab.
Arhivă
Facturile trimise prin API intră în aceeași arhivă write-once ca restul.
Trafic
Cererile primite sunt jurnalizate și au ecran de inspecție. Când o factură iese greșit, vezi exact ce a trimis sistemul tău.
Chei
Fiecare sistem conectat primește cheia lui separată, deci o poți revoca fără să oprești restul.
06Obiecții rezolvate

Întrebări despre API și integrări

Cât durează o integrare?
Depinde de sistemul tău, dar partea grea — relația cu ANAF — e deja făcută. Tu trimiți datele facturii; noi ne ocupăm de XML, transmisie, status și arhivare. În demo ne uităm împreună la ce scoate sistemul tău și îți spunem concret ce e de făcut.
Ce se întâmplă dacă ANAF respinge o factură trimisă prin API?
Statusul se urmărește ca la orice altă factură, iar erorile citite din arhiva ANAF sunt disponibile. Ai endpointuri de retrimitere și trimitere forțată pentru corecții.
Pot citi facturile primite din programul meu?
Da — printr-un endpoint custom construit la cerere pentru integrarea ta. Sistemul tău preia astfel ce a coborât din SPV fără să intre cineva în interfață.
Nu am echipă de dezvoltare.
Atunci fie folosești exporturile SAGA și WinMentor și interfața, fie construim noi integrarea. Vezi dezvoltare personalizată.
Sunt limite de volum?
Planurile sunt pe volum de facturi, nu pe număr de apeluri. Detaliile sunt pe pagina de prețuri, iar pentru volume mari discutăm direct.
Ce este un API pentru facturare electronică și la ce folosește?
E o modalitate prin care sistemul tău — ERP, magazin online sau program propriu — trimite automat datele facturii către platformă, fără ca cineva să completeze manual un formular. Platforma construiește XML-ul UBL 2.1 RO_CIUS, îl trimite la ANAF prin SPV și urmărește statusul până la acceptare, la fel ca o factură creată din interfață.
API-ul folosește parola contului meu?
Nu. Autentificarea se face cu chei de API emise per integrare, nu cu parola contului, iar fiecare sistem conectat primește cheia lui separată — pe care o poți revoca fără să oprești restul.
Vând pe alt magazin decât WooCommerce. Pot integra?
Da. API v2 e deschis pentru orice integrare — pe el rulează și pluginul de WooCommerce. Pentru OpenCart, PrestaShop, Magento, Shopify, GoMag sau MerchantPro conectăm magazinul la cerere, de regulă într-o zi lucrătoare — vezi integrări și platforme.
Module legate

Adu-ne un exemplu de factură din sistemul tău.

Ne uităm la ce produce ERP-ul tău și îți spunem în aceeași discuție cât de aproape e de un apel funcțional către ANAF prin API-ul nostru.

Fără obligații · Răspundem în aceeași zi lucrătoare