Integrare SmartBill prin API: facturare automată pentru magazinul tău

Integrarea SmartBill prin API elimină facturarea manuală: fiecare comandă din magazinul tău online generează automat factura, o trimite clientului pe email și actualizează stocul. Pentru un magazin cu zeci de comenzi pe zi, asta înseamnă ore de muncă recuperate în fiecare săptămână, zero greșeli de transcriere și rapoarte financiare mereu la zi.

La WebForge construim integrări de facturare pentru magazine online românești de ani buni, iar SmartBill este, de departe, cel mai des întâlnit program de facturare la clienții noștri. În acest ghid îți explicăm ce poate face API-ul SmartBill, cum arată un flux complet de automatizare facturare pentru e-commerce, când are sens o integrare directă față de una prin n8n, cât costă onest un astfel de proiect și ce greșeli vedem cel mai des în implementările făcute în grabă.

Ce permite API-ul SmartBill

API-ul SmartBill permite, în esență, tot ce ai face manual din interfața web: emiterea de facturi fiscale și proforme, gestionarea stocurilor, înregistrarea încasărilor și obținerea documentelor în format PDF — totul programatic, din aplicația ta sau dintr-o platformă de automatizare. Cu alte cuvinte, orice operațiune repetitivă de facturare poate fi declanșată automat de un eveniment din afacerea ta.

La nivel general, capabilitățile principale acoperă:

• Emitere facturi și proforme — creezi documente fiscale cu datele clientului, produsele, cotele de TVA și seria dorită, iar SmartBill returnează documentul generat;
• Stornare și anulare — poți corecta programatic documentele emise greșit, esențial pentru retururi în e-commerce;
• Înregistrare încasări — marchezi facturile ca plătite atunci când procesatorul de plăți confirmă tranzacția, ca soldul clienților să fie mereu corect;
• Gestionare stocuri — interoghezi și actualizezi stocurile din gestiunea SmartBill, ca site-ul să nu vândă produse pe care nu le mai ai;
• Documente PDF și trimitere pe email — descarci factura generată sau o trimiți direct clientului, cu aspectul configurat în contul tău SmartBill.

Un detaliu important de onestitate tehnică: nu enumerăm aici endpoint-uri și parametri exacți, pentru că documentația oficială SmartBill este sursa de adevăr și se actualizează periodic. Ce contează pentru tine, ca proprietar de magazin, este că toate operațiunile uzuale de facturare sunt expuse prin API și pot fi orchestrate fără intervenție umană.

Scenariul clasic e-commerce: de la comandă la raportare, fără clicuri

Fluxul standard pe care îl implementăm pentru magazine online arată așa: comanda este plasată, factura se emite automat, clientul primește emailul cu factura, stocul se actualizează, iar datele ajung în raportare — totul în câteva secunde, fără ca cineva din echipă să atingă tastatura. Concret, pașii sunt:

1. Comanda este plasată în WooCommerce, Shopify, PrestaShop sau platforma ta custom, iar un webhook anunță sistemul de integrare;
2. Datele clientului sunt validate — CUI verificat pentru firme, adresă completă, cotă TVA corectă pentru fiecare produs;
3. Factura se emite în SmartBill pe seria potrivită (persoane fizice vs. juridice, de exemplu), cu numerotare gestionată de SmartBill;
4. Clientul primește factura pe email, fie prin SmartBill, fie prin sistemul tău de email tranzacțional, atașată confirmării de comandă;
5. Stocul se actualizează în gestiune, iar dacă sincronizezi în ambele sensuri, site-ul reflectă stocul real;
6. Încasarea se înregistrează automat la confirmarea plății cu cardul sau la încasarea rambursului de la curier;
7. Raportarea este mereu la zi — contabilul tău vede în SmartBill exact ce s-a vândut, fără exporturi și importuri manuale de fișiere.

Diferența față de facturarea manuală nu e doar timpul economisit. Este și consistența: un om obosit la finalul zilei greșește un CUI sau sare o comandă; un flux automat bine construit nu o face niciodată.

Integrare directă vs. integrare prin n8n

Răspunsul scurt: integrarea prin n8n este mai rapidă de implementat și mai ușor de modificat, în timp ce integrarea directă (cod custom în aplicația ta) oferă control total și performanță maximă — alegerea depinde de complexitatea afacerii și de cine va întreține soluția. Ambele variante folosesc același API SmartBill; diferă doar locul în care trăiește logica.

Criteriu	Integrare prin n8n	Integrare directă (cod custom)
Timp de implementare	Zile	Săptămâni
Cost inițial	De la câteva sute EUR	1.000–4.000 EUR
Modificări ulterioare	Rapide, vizuale, fără deploy	Necesită intervenția unui programator
Control și logică complexă	Bun pentru fluxuri standard	Nelimitat, integrat nativ în aplicație
Potrivit pentru	Majoritatea magazinelor mici și medii	Volume mari, reguli de business complexe

În practică, recomandăm n8n pentru majoritatea magazinelor: fluxul vizual leagă platforma de e-commerce, SmartBill, emailul și chiar un canal de Slack sau WhatsApp pentru notificări, iar modificările se fac în minute. Am scris pe larg despre abordarea noastră în ghidul de automatizări cu n8n. Integrarea directă rămâne alegerea corectă atunci când facturarea este parte din logica de bază a aplicației tale — de exemplu un SaaS cu abonamente sau un marketplace cu reguli de comision.

Vrei să afli care variantă se potrivește magazinului tău? Scrie-ne și îți răspundem cu o recomandare concretă, nu cu un șablon de vânzare.

Legătura cu e-Factura și SPV: lanțul complet, automat

Vestea bună: SmartBill trimite facturile în SPV (Spațiul Privat Virtual) pentru e-Factura, deci un flux automat construit peste API-ul SmartBill acoperă întregul lanț legal — de la comandă până la raportarea către ANAF. Tu nu mai gestionezi XML-uri, semnături sau termene de transmitere; emiți factura prin API, iar SmartBill se ocupă de drumul ei către SPV.

În contextul în care e-Factura a devenit obligatorie pentru relațiile B2B și ulterior și pentru B2C, acest detaliu transformă integrarea dintr-un confort într-o necesitate: fiecare factură emisă manual și uitată este un risc de conformitate. Am detaliat întregul subiect — termene, obligații, capcane — în articolul despre automatizarea e-Factura, pe care îl recomandăm oricui vinde online în România.

Practic, fluxul complet devine: comandă → factură emisă prin API → email către client → stoc actualizat → transmitere automată în SPV → raportare. Un singur eveniment (comanda) declanșează tot lanțul, iar tu vezi doar rezultatul: documente corecte, la timp, peste tot unde trebuie.

Alternative pe piața românească: Oblio, FGO, Facturis

SmartBill nu este singura opțiune, iar onestitatea ne obligă să o spunem direct: Oblio, FGO și Facturis oferă și ele API-uri de facturare, iar arhitectura de integrare pe care o descriem aici se aplică aproape identic la oricare dintre ele. Dacă deja folosești unul dintre aceste programe și echipa ta este mulțumită, rareori merită să migrezi doar de dragul integrării.

• Oblio — popular la firmele mici, cu API documentat și prețuri accesibile; o alternativă solidă pentru fluxuri standard de facturare;
• FGO — apreciat în zona de servicii și colaborarea cu contabilii, cu suport pentru e-Factura;
• Facturis — orientat și spre gestiune și producție, util când stocurile sunt partea complicată a afacerii.

Criteriile reale de alegere nu țin de marketing, ci de: calitatea documentației API, modul în care gestionează seriile și gestiunile multiple, suportul pentru e-Factura și costul lunar la volumul tău de documente. Noi implementăm integrări cu oricare dintre ele — recomandarea o facem după ce înțelegem fluxul tău, nu înainte.

Pașii unui proiect de integrare SmartBill

Un proiect de integrare bine făcut urmează aceiași pași, indiferent că este implementat în n8n sau în cod custom: obținerea cheilor API, maparea datelor, construirea fluxului, gestionarea erorilor și testarea pe scenarii reale. Iată cum arată în practică:

1. Chei API și mediu de test — activăm accesul API din contul SmartBill și configurăm un mediu în care putem emite documente de probă fără să afectăm facturarea reală;
2. Maparea datelor — stabilim corespondența dintre câmpurile platformei tale și cele din SmartBill: serii de facturi pentru fiecare tip de client, cote de TVA pe categorii de produse, gestiuni, monede, metode de plată;
3. Validări înainte de emitere — verificăm CUI-ul, completitudinea adresei și corectitudinea totalurilor înainte să atingem API-ul; o factură respinsă târziu e mai scumpă decât o validare devreme;
4. Gestionarea erorilor și retry — orice API are momente de indisponibilitate; fluxul trebuie să reîncerce automat, dar inteligent, cu protecție împotriva duplicatelor (aceeași comandă nu are voie să genereze două facturi);
5. Loguri și alerte — fiecare factură emisă sau eșuată lasă o urmă; dacă ceva pică la ora 2 noaptea, dimineața știi exact ce comenzi necesită atenție;
6. Testare pe scenarii reale — comandă persoană fizică, firmă cu CUI valid, retur, plată ramburs, comandă cu produse cu TVA diferit; abia după ce toate trec, pornim fluxul pe producție.

Punctele 4 și 5 sunt cele care despart o integrare profesionistă de un script scris într-o seară. Facturarea este un proces fiscal, nu un experiment — fiabilitatea nu este opțională.

Cât costă o integrare SmartBill: cifre oneste

O integrare simplă prin n8n pornește de la câteva sute de euro, iar o integrare custom completă se încadrează de regulă între 1.000 și 4.000 EUR, în funcție de complexitate. Nu există un preț unic corect, dar există repere oneste:

• Flux standard prin n8n (comandă → factură → email → stoc, o singură platformă de e-commerce): de la câteva sute EUR, livrat în câteva zile;
• Flux extins prin n8n (serii multiple, validări CUI, încasări, notificări, rapoarte): undeva între nivelul de bază și zona de 1.500 EUR;
• Integrare custom completă (cod în aplicația ta, sincronizare bidirecțională de stocuri, reguli de business complexe, volume mari): 1.000–4.000 EUR, în funcție de complexitate și de starea codului existent.

La aceste costuri se adaugă abonamentul SmartBill (pe care probabil îl plătești deja) și, eventual, găzduirea instanței n8n — costuri lunare mici în raport cu timpul economisit. Calculul de rentabilitate e simplu: dacă cineva din echipă petrece o oră pe zi cu facturile, integrarea se amortizează de regulă în primele luni.

Greșeli frecvente în integrările de facturare

Cele mai costisitoare greșeli pe care le vedem nu țin de API în sine, ci de lipsa de rigoare în jurul lui: erori negestionate, serii greșite și duplicate generate la retry. Pe scurt:

• Lipsa gestionării erorilor — fluxul funcționează în ziua demonstrației, apoi API-ul răspunde cu o eroare într-o vineri seara și 40 de comenzi rămân nefacturate fără ca nimeni să afle;
• Serii de facturi greșite — facturile pentru firme emise pe seria de persoane fizice (sau invers) înseamnă stornări în lanț și discuții neplăcute cu contabilul;
• Duplicate la retry — fluxul reîncearcă după un timeout, dar prima cerere reușise de fapt; rezultatul: două facturi pentru aceeași comandă. Soluția este verificarea înainte de reemitere, ca fiecare comandă să producă exact un document;
• Cote de TVA scrise în cod — legislația se schimbă, iar valorile fixate în cod devin bombe cu ceas; cotele trebuie să vină din configurare, nu din obișnuință;
• Zero vizibilitate — fără loguri și alerte, afli despre probleme de la clienți sau de la ANAF, adică în cel mai prost mod posibil.

Toate aceste greșeli sunt evitabile cu o arhitectură gândită de la început pentru eșec — pentru momentele în care rețeaua pică, API-ul răspunde greu sau datele vin incomplete. Exact asta plătești, de fapt, când lucrezi cu o echipă cu experiență.

Următorul pas: de la facturare la o afacere automatizată

Integrarea SmartBill este, pentru multe firme, prima automatizare serioasă — și cea cu cel mai vizibil efect imediat. De aici, drumul continuă natural: sincronizarea cu AWB-urile curierilor, rapoarte automate de vânzări, răspunsuri inteligente la întrebările clienților. Fluxul complet, de la comanda plătită la coletul predat, este descris pas cu pas în automatizarea comenzilor din magazinul online. Dacă vrei imaginea de ansamblu, am pus tot ce știm în ghidul complet de automatizări AI.

Dacă vrei să discutăm concret despre magazinul tău — platformă, volum de comenzi, fluxul actual de facturare — trimite-ne un mesaj pe pagina de contact. Îți răspundem cu o estimare onestă de cost și termen, de obicei în aceeași zi lucrătoare.

Întrebări frecvente

Cât durează o integrare SmartBill?

Un flux standard prin n8n este funcțional în câteva zile lucrătoare. O integrare custom completă, cu sincronizare de stocuri și reguli de business specifice, durează de regulă două până la patru săptămâni, incluzând testarea pe scenarii reale.

Funcționează integrarea cu WooCommerce sau Shopify?

Da. Ambele platforme expun webhook-uri la plasarea comenzii, care declanșează fluxul de facturare. Același principiu se aplică pentru PrestaShop, Magento sau o aplicație custom — dacă platforma poate anunța o comandă nouă, putem emite factura automat.

Ce se întâmplă dacă SmartBill este temporar indisponibil?

Un flux corect construit pune comanda într-o coadă de reîncercare și emite factura imediat ce serviciul revine, cu protecție împotriva duplicatelor. Tu primești o alertă doar dacă problema persistă — nicio comandă nu rămâne nefacturată în liniște.

Facturile emise prin API ajung automat în SPV pentru e-Factura?

Da, SmartBill gestionează transmiterea facturilor către SPV, deci fluxul automat acoperă și obligația de e-Factura. Detalii despre termene și obligații găsești în articolul nostru despre automatizarea e-Factura.