SmartBill

Integrare SmartBill: conectăm SmartBill Cloud prin API la sursele voastre de plăți, CRM sau magazin online. Factură emisă în sub 2 secunde de la tranzacție, cu serie corectă, TVA aplicat după țara clientului și PDF trimis pe email.

Scenarii pe care le acoperim cu SmartBill

Folosim API SmartBill Cloud pe endpoint /SBORO/api/invoice cu autentificare Basic (username + token) pentru a acoperi cazuri pe care pluginurile native nu le rezolvă:

• Facturare Stripe live + abonamente. Pentru un SaaS B2B am conectat webhook-ul invoice.payment_succeeded la n8n, am adăugat CUI-ul din metadata și am generat factura în SmartBill cu cota TVA 19% sau reverse charge (taxare inversă), după țara de facturare.
• Proforme la comenzi magazin. La checkout WooCommerce cu plată prin transfer bancar, creăm proforma automat, atașăm PDF-ul în emailul de confirmare și urmărim statusul. Dacă plata intră în 7 zile, proforma devine factură fiscală; dacă nu, o anulăm.
• Stornări la refund. Un refund în Stripe sau retur în WooCommerce declanșează factura de stornare cu referință la factura originală, astfel încât contabilitatea rămâne aliniată fără intervenție manuală.
• Sincronizare clienți în nomenclator. La prima facturare salvăm clientul în SmartBill cu CUI, adresă, cod poștal și persoană de contact, ca să apară corect pe facturile următoare fără dubluri.
• Raportare vânzări către Google Sheets sau BI. Citim lista de facturi din SmartBill zilnic și o împingem într-un sheet sau BigQuery pentru dashboard-uri de cashflow, top clienți și zile medii de încasare.

Cum integrăm SmartBill

Plecăm de la contul SmartBill (generăm token API din Setări, Cont, Integrare API) și de la sursa de eveniment (Stripe, WooCommerce, Typeform, CRM). În n8n sau direct în aplicația clientului apelăm endpoint-ul de emitere factură cu payload JSON minim:

POST https://ws.smartbill.ro/SBORO/api/invoice
Authorization: Basic base64(email:token)
{
  "companyVatCode": "RO12345678",
  "client": { "name": "Client SRL", "vatCode": "RO87654321", "country": "Romania" },
  "issueDate": "2026-04-16",
  "seriesName": "RBM",
  "currency": "RON",
  "products": [{ "name": "Licență Pro", "price": 199, "measuringUnitName": "buc", "quantity": 1, "taxPercentage": 19 }]
}

Răspunsul conține numărul facturii și link PDF, pe care le salvăm în CRM și le atașăm la emailul către client.

Limitări și pricing

SmartBill Cloud Factura pornește de la 29 lei/lună pentru firme mici, iar pachetul cu API inclus (Factura PRO sau Gestiune) este în jur de 59-119 lei/lună. Rate limit-ul API nu este publicat oficial, dar în practică peste 200 de cereri/minut ne-au returnat 429. Seriile de facturare trebuie create manual în aplicație înainte să fie folosite prin API. Emisia facturilor în valută cere activarea modulului multi-currency în cont.

FAQ

Se conectează SmartBill direct la Stripe fără cod? Există integrarea nativă, dar nu acoperă taxarea inversă pentru clienți UE cu CUI valid și nici stornările automate. De aceea trecem fluxul prin n8n, unde decidem cota TVA și tipul documentului.

Ce facem dacă API-ul SmartBill pică? Punem cererile într-o coadă (Redis sau tabel MySQL) și le reîncercăm exponențial. Peste 3 eșecuri trimitem alertă pe Slack și emitem factura manual din interfață, iar sistemul rămâne consistent.

Trimite SmartBill automat factura la ANAF e-Factura? Da, dacă modulul e-Factura e activ pe cont, SmartBill transmite XML-ul către SPV după emitere. Noi doar setăm flag-ul corect pe factură.

Alternative

Oblio – facturare cu API simplu și plan gratuit pentru volume mici, preferat de freelanceri și SRL-uri sub 300 facturi/lună. FGO – potrivit pentru firme cu gestiune de stocuri, API documentat și suport rapid. Facturis – ieftin, dar API-ul e mai limitat la tipuri de documente și campuri custom.

Integrarea face parte din serviciul nostru de automatizare facturare. Vezi toate opțiunile pe pagina de automatizări marketing sau studiul de caz facturare automată Stripe + SmartBill.

Vrei facturare SmartBill pusă pe pilot automat? Scrie echipei RoboMarketing și trecem peste partea manuală.