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, reînnoire de token, UBL 2.1, RO_CIUS, urmărirea statusului, arhivarea răspunsurilor. Noi le-am făcut deja. Tu apelezi un endpoint și te ocupi de afacerea ta — mai repede de integrat, cu mai puține locuri unde poate ieși o factură greșită.

Discută integrarea → Dezvoltare la cerere

Creare și trimitere factură din API  ·  Citire facturi nou primite  ·  Export SAGA și WinMentor

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 cheie de API. Platforma construiește XML-ul UBL 2.1 în varianta RO_CIUS, îl încarcă în SPV și urmărește statusul mai departe, exact ca pentru 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.
  • ✓Endpoint pentru facturile nou primite, ca sistemul tău să afle ce a coborât din SPV.
  • ✓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 sau direct prin API.
POST /api/v1/invoice/add X-Api-Key: cheia-ta-de-api Content-Type: application/json { "client": { "cif": "RO12345678" }, "serie": "FCT", "data": "2026-08-01", "moneda": "RON", "linii": [ { "denumire": "Servicii mentenanță", "um": "H87", "cantitate": 1, "pret": 1500.00, "cota_tva": 21, "categorie_tva": "S" } ] }

Structura exactă a câmpurilor și documentația completă se transmit la activarea cheii de API. Exemplul de mai sus e ilustrativ.

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.

WC

Plugin WooCommerce

Descarcă, instalează, conectează cheia — gata.
V2

Documentație API v2

Clienți, proforme, facturi — referință completă cu exemple curl.
04Integrare contabilă

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

SAGA

Export SAGA

Export XML în formatul SAGA, pe intervalul de date ales. Contabilul importă, nu retastează.

WM

Export WinMentor

Aceeași logică 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

API-ul nu e o listă de endpointuri. E partea de ANAF pe care nu o mai întreții tu.

Ce livrezi cu un apel: XML conform, încărcare în SPV, urmărirea statusului, citirea erorilor din arhiva ANAF, arhivarea răspunsurilor și reînnoirea autorizării. Nimic din toate astea nu rămâne în sarcina echipei tale.

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 ceva nu merge, vezi exact ce s-a trimis.
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, există endpoint pentru facturile nou primite, ca sistemul tău să preia 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 custom — e folosit chiar de pluginul WooCommerce. Pentru platforme ca OpenCart, PrestaShop, Magento, Shopify, GoMag sau MerchantPro construim conectori la cerere — vezi integrări și platforme.
Module legate
01 Emitere facturi Aceleași reguli de validare, și în interfață, și prin API. → 02 Facturi primite din SPV Sursa datelor pe care le citește integrarea ta. → 11 Pentru contabili Multi-firmă, roluri, delegare, export contabil. → 12 Dezvoltare la cerere Formate, câmpuri și fluxuri construite pe nevoia ta. → 04 Nomenclator și stocuri Produse și costuri, alimentate din facturi. → 03 Arhivare e-Factura Tot ce trece prin API intră în aceeași arhivă. →

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.

Discută integrarea →

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