Integrare SmartBill cu magazinul online: cum faci și pe site custom?

Codrin Strâmbu, fondator FlowStone Agency · 19 octombrie 2026 · 10 min citire

Dacă ai un magazin online și copiezi fiecare comandă de mână în SmartBill, știi deja unde apar problemele: o factură uitată, un stoc care nu mai corespunde, un retur rezolvat după trei zile. Din acest articol afli ce variante de integrare ai, ce abonament îți trebuie, cum legi un site făcut la comandă și ce faci la retururi.

Răspuns scurt: integrarea SmartBill cu magazinul online se face cu pluginul oficial dacă ai WooCommerce, PrestaShop, OpenCart sau Magento, cu un abonament compatibil. Stocul se sincronizează doar pe pachetul eCommerce. Pe un site custom, legătura se face prin API-ul SmartBill, direct din cod sau printr-un flux n8n; la FlowStone, o astfel de automatizare pornește de la 500 EUR, iar un flux simplu se livrează în 5–10 zile lucrătoare.

Ce variante ai pentru integrarea SmartBill cu magazinul online?

Ai trei drumuri, iar alegerea depinde mai mult de platforma pe care e construit magazinul decât de mărimea lui. SmartBill oferă pluginuri oficiale pentru câteva platforme și un API, adică o interfață prin care alte programe pot emite facturi direct în contul tău.

Pluginurile au versiuni suportate precise. Conform paginii oficiale de pluginuri SmartBill, PrestaShop e acceptat între versiunile 1.7.0.0 și 9.1.5, OpenCart între 3.0.0.0 și 3.0.3.9, iar Magento între 2.2 și 2.4. Dacă magazinul tău rulează o versiune în afara acestor intervale, pluginul poate să nu funcționeze corect.

Nu toate pluginurile fac același lucru. Pluginul pentru Magento face doar emitere de facturi, în timp ce cel pentru WooCommerce acoperă și încasarea, emailul și stocul. Dacă ai magazinul pe o platformă închiriată, verifică întâi în documentația ei dacă are deja un conector SmartBill, ca să nu plătești pentru ceva ce ai inclus.

Pentru un site făcut la comandă, de exemplu un magazin construit în Next.js, nu există plugin. Aici rămâne API-ul, despre care vorbim mai jos.

Ce abonament SmartBill îți trebuie pentru integrare?

Abonamentul contează la fel de mult ca platforma, pentru că unele funcții sunt blocate pe pachetele de bază. Pe pagina de pluginuri, SmartBill spune că pluginurile cer pachetul Platinum, Gestiune Plus sau eCommerce, iar sincronizarea stocului merge doar pe pachetul eCommerce.

Pe de altă parte, articolul de ajutor despre integrarea API menționează că integrarea prin API cu magazinul online e disponibilă pentru abonamentele Facturare Platinum. Cele două pagini nu spun exact același lucru, așa că nu te baza pe una singură.

• Intră în contul SmartBill, la Contul meu, și verifică ce integrări permite abonamentul tău actual.
• Dacă vrei stoc sincronizat între magazin și SmartBill, pornește de la pachetul eCommerce.
• Dacă ai site custom, confirmă cu suportul SmartBill că pachetul tău include accesul la API.
• Prețul abonamentelor îl vezi pe site-ul SmartBill, pentru că se poate schimba de la an la an.

Cum conectezi un magazin WooCommerce sau PrestaShop la SmartBill?

Pe platformele cu plugin oficial, integrarea o poți face și singur, dacă ai acces de administrator la magazin. Pașii de mai jos sunt orientativi; denumirile exacte ale setărilor diferă puțin de la o platformă la alta.

1. Verifică versiunea platformei și abonamentul SmartBill, ca în secțiunile de mai sus.
2. Descarcă pluginul de pe pagina oficială SmartBill și instalează-l în magazin.
3. Conectează pluginul la contul SmartBill cu datele de integrare din Contul meu > Integrări.
4. Alege statusul comenzii la care se emite factura, de exemplu „finalizată” sau „plătită”.
5. Setează seria de facturare, cotele de TVA și trimiterea facturii pe email.
6. Plasează câteva comenzi de probă și verifică facturile rezultate înainte să lași integrarea să ruleze singură.

Pluginul pentru WooCommerce emite factura automat când se schimbă statusul comenzii și o poate marca drept încasată la plățile cu Stripe sau Netopia. Mai știe să emită facturi în limbă străină, să preia CIF-ul intracomunitar, să sincronizeze stocul și să trimită factura pe email, afișând-o și în contul clientului.

Limitele sunt spuse chiar de SmartBill. Pluginul WooCommerce e compatibil doar cu funcționalitatea de bază a WooCommerce, deci extensiile pentru abonamente, pachete de produse sau câmpuri suplimentare pot să nu fie acoperite. Suportul SmartBill se oprește la configurarea pluginului și nu include magazinul sau serverul tău.

Cum integrezi SmartBill cu un site custom prin API și n8n?

Pe un site custom, magazinul și SmartBill comunică prin API. Poți scrie legătura direct în codul site-ului sau o poți construi în n8n, o platformă de automatizare în care fluxurile se compun din blocuri și care poate rula pe serverul tău. Varianta n8n e mai ușor de modificat ulterior, de exemplu când adaugi un al doilea canal de vânzare.

Prin API poți emite, șterge, anula și restaura facturi, poți genera PDF-uri pentru facturi și proforme, poți adăuga produse și clienți la emitere, poți transforma o proformă în factură după plată, poți înregistra încasarea și poți trimite documentul pe email. Lista completă e în documentația SmartBill despre integrarea API.

Un flux tipic pentru un magazin cu plată online arată așa:

1. Clientul plătește, iar procesatorul de plăți confirmă tranzacția.
2. Magazinul trimite un webhook, adică un mesaj automat către alt sistem în momentul în care se întâmplă ceva, aici o comandă plătită.
3. n8n primește datele comenzii, le verifică și le transformă în formatul cerut de SmartBill.
4. Se emite factura în SmartBill, cu produsele, clientul și cota de TVA corectă.
5. Factura e marcată ca încasată, iar PDF-ul pleacă pe email la client.
6. Fiecare pas e logat. Dacă ceva nu se potrivește, fluxul se oprește și anunță un om, în loc să emită o factură greșită.

Cota de TVA trebuie trimisă explicit

Prin API, factura primește cota de TVA pe care o trimiți în cerere, nu una calculată de SmartBill. Conform documentației SmartBill Gestiune, cotele noi sunt 21% și 11%, aplicate după 1 august 2025, iar cotele vechi (19%, 9%, 5%) se trimit cu denumirea „Veche”. Un cod vechi rămas uitat în site poate genera facturi cu TVA greșit, așa că verifici asta la fiecare integrare.

Limita de 3 apeluri pe secundă

API-ul SmartBill acceptă doar conexiuni HTTPS și are o limită de 3 apeluri pe secundă. Dacă o depășești, accesul se blochează 10 minute. La un vârf de comenzi, fiecare factură poate însemna mai multe apeluri (emitere, încasare, email), deci limita se atinge mai repede decât pare.

Soluția e o coadă de procesare: comenzile intră într-o listă de așteptare și sunt trimise spre SmartBill în ritmul permis. Clientul primește confirmarea comenzii imediat, iar factura vine câteva secunde sau minute mai târziu, fără blocaje.

Cât costă și cât durează

Pentru exemple de alte procese pe care le poți automatiza în același fel, vezi și articolul despre automatizări pentru afaceri mici. Dacă încă nu ai magazinul și te gândești la unul custom, găsești costurile de construcție pe pagina de dezvoltare web și în ghidul despre cât costă un magazin online.

Ce faci la retururi: factura storno automată sau manuală?

Retururile sunt partea pe care majoritatea ghidurilor de integrare o sar. Conform articolului SmartBill despre stornare, factura storno se folosește la corectarea unei facturi sau la returul de produse.

• Tipuri de stornare: integrală, parțială sau multiplă.
• Mod de stornare: pe poziții (produs cu produs) sau valoric, setat din Preferințe personale.
• Cote de TVA diferite pe aceeași factură: merge doar stornarea pe poziții.
• Schimbarea statutului de plătitor de TVA: facturile emise înainte nu pot fi stornate fără revenirea temporară la statutul vechi.

Recomandarea mea practică: automatizezi doar returul complet, când clientul trimite înapoi toată comanda și storno-ul e integral. Returul parțial, de exemplu un client care păstrează o pereche de pantofi din trei, trece prin verificarea unui om. Înainte de orice automatizare a storno-ului, verifică în documentația API ce tip de stornare suportă și cum se leagă de factura inițială.

Fluxul de retur pornește de la politica afișată pe site. Dacă nu ai pusă la punct pagina de retur, găsești ce trebuie să conțină în checklistul despre paginile obligatorii pentru un magazin online.

Ce stabilești cu contabilul înainte să pornești automatizarea?

O integrare emite facturi în numele firmei tale, deci regulile le stabilește contabilul, nu developerul. Developerul le transformă în setări și cod.

• e-Factura: dacă și când se transmit facturile în RO e-Factura, inclusiv cele către persoane fizice, și cine verifică transmiterea. Termenele și regulile s-au modificat în ultimii ani, așa că le confirmi pe site-ul ANAF.
• Momentul emiterii: la plată, la expediere sau la livrare, mai ales pentru comenzile cu ramburs.
• Cotele de TVA pe categorii de produse și eventualele produse cu cote diferite.
• Tipul de stornare preferat, pe poziții sau valoric.
• Seriile de facturare, dacă vinzi pe mai multe canale.

Ce greșeli apar des și cum le testezi înainte de Black Friday?

În proiectele de automatizare a facturării, cele mai multe probleme nu vin din API, ci din date care nu se potrivesc între sisteme. Le găsești ușor dacă testezi cu comenzi reale de probă, nu doar cu una singură.

• Coduri de produs diferite în magazin și în SmartBill, care duc la produse duplicate sau la stoc greșit.
• Cote de TVA vechi rămase în cod sau în setările unor produse.
• Limita de 3 apeluri pe secundă depășită la vârf, cu blocare de 10 minute.
• Statusuri de comandă setate greșit, care emit factura înainte de plată sau o emit de două ori.
• Extensii neacoperite de plugin, de exemplu pachete de produse sau reduceri complicate.

Testează cu câteva săptămâni înainte de perioadele aglomerate: o comandă plătită cu cardul, una cu ramburs, una cu discount, una pentru o firmă cu CIF și un retur. Verifică fiecare factură rezultată în SmartBill. Pentru restul pregătirilor tehnice, folosește checklistul de pregătire a magazinului online de Black Friday.

Când ceva nu merge, suportul SmartBill pentru API și pluginuri se face doar prin email. Din Contul meu > Integrări poți trimite datele de conectare direct dezvoltatorului, fără să-ți împarți parola contului.

Întrebări frecvente

SmartBill are plugin oficial pentru Shopify?

Pe lista oficială de pluginuri SmartBill apar WooCommerce, PrestaShop, OpenCart și Magento, nu Shopify. Pentru un magazin Shopify verifici aplicațiile disponibile în Shopify sau construiești legătura prin API-ul SmartBill.

Pot sincroniza stocul dintre SmartBill și WooCommerce?

Da, pluginul oficial SmartBill pentru WooCommerce are sincronizare de stoc. Funcția merge însă doar pe pachetul SmartBill eCommerce, nu pe Platinum sau Gestiune Plus.

Ce se întâmplă dacă depășesc limita API-ului SmartBill?

API-ul SmartBill acceptă 3 apeluri pe secundă, iar la depășire accesul se blochează 10 minute. De aceea, integrările pentru magazine cu volum mare trimit cererile printr-o coadă de procesare.

Factura emisă automat ajunge la client pe email?

Da. Pluginul WooCommerce trimite factura pe email și o afișează în contul clientului, iar prin API poți trimite documentul pe email după emitere.

Pot anula prin API o factură emisă greșit?

API-ul SmartBill permite ștergerea, anularea și restaurarea facturilor. Pentru un retur de produse se folosește însă factura storno, iar ce variantă aplici la o eroare stabilești cu contabilul.

Cine mă ajută dacă integrarea SmartBill nu funcționează?

SmartBill oferă suport prin email doar pentru configurarea pluginului sau a API-ului, nu pentru magazin sau server. Problemele din site, server sau fluxurile custom le rezolvă developerul care a făcut integrarea.

Concluzie

Regula e simplă: dacă magazinul e pe WooCommerce, PrestaShop, OpenCart sau Magento și nu ai fluxuri speciale, instalezi pluginul oficial și verifici abonamentul. Dacă ai site custom, vinzi pe mai multe canale sau vrei retururi tratate automat, ai nevoie de o integrare prin API, cu loguri și verificare umană acolo unde contează. Detaliile despre cum construim astfel de fluxuri și cât costă le găsești pe pagina de automatizări și agenți AI, iar pentru o estimare pe magazinul tău poți folosi pagina de contact.

Vrei să automatizezi un proces din firma ta?

Spune-ne ce faceți manual acum și primești o ofertă clară, cu fluxurile propuse și termenul de livrare.

Cere ofertă