Automatizarea Facturării cu n8n: Integrare SmartBill și FGO

De ce pierzi bani și timp cu facturarea manuală

Un antreprenor român petrece în medie 6-8 ore pe lună doar pe emiterea și gestionarea facturilor. Adună date din Excel, le copiază în SmartBill sau FGO, verifică fiecare sumă, trimite factura pe email și apoi notează plata într-un alt fișier. Pare cunoscut?

Această rutină consumă timp prețios pe care l-ai putea investi în dezvoltarea afacerii. Mai mult, fiecare copiere manuală a datelor este o oportunitate pentru erori – o cifră greșită, un client uitat, o factură trimisă cu întârziere.

Automatizarea facturării cu n8n rezolvă exact această problemă. În loc să lucrezi între 3-4 aplicații diferite, creezi un workflow care le conectează pe toate și le transformă într-un sistem autonom.

În acest tutorial, îți arăt exact cum să configurezi integrarea n8n cu SmartBill și FGO, pas cu pas, fără să ai nevoie de cunoștințe de programare.

Ce este n8n și de ce este potrivit pentru automatizare facturare n8n

n8n este o platformă de automatizare open-source care îți permite să conectezi diferite aplicații și servicii între ele. Gândește-te la el ca la un conductor care coordonează toate instrumentele din orchestra ta digitală.

Spre deosebire de Zapier sau Make, n8n poate fi găzduit pe propriul tău server. Asta înseamnă datele tale rămân la tine, ai control total asupra securității și nu plătești pentru fiecare task executat.

Avantaje specifice pentru facturare

• Control complet asupra datelor financiare – facturile și informațiile clienților nu trec prin servere terțe
• Workflow-uri complexe – poți adăuga condiții, verificări și aprobări înainte de emiterea facturii
• Costuri reduse – o dată configurat, rulează fără costuri suplimentare per tranzacție
• Flexibilitate – integrezi orice API, inclusiv cele românești de la SmartBill și FGO

La Lazart Studios, am implementat această soluție pentru mai multe companii din România, iar rezultatul a fost o reducere cu 80% a timpului petrecut pe facturare.

SmartBill integrare: configurarea API-ului pas cu pas

SmartBill este una dintre cele mai populare soluții de facturare din România, folosită de peste 100.000 de companii. API-ul lor permite emiterea automată a facturilor, gestionarea clienților și sincronizarea stocurilor.

Pregătirea contului SmartBill

Înainte de a crea workflow-ul în n8n, ai nevoie de câteva elemente din contul tău SmartBill:

1. Accesează Setări → Integrări → API din contul SmartBill
2. Generează un token de acces nou – notează-l într-un loc sigur
3. Notează ID-ul companiei din aceeași pagină
4. Verifică că ai cel puțin un produs/serviciu configurat în sistem
5. Asigură-te că seria de facturare este activă și configurată

Conectarea la n8n cu nodul HTTP Request

SmartBill nu are un nod nativ în n8n, dar API-ul lor REST este bine documentat. Folosești nodul HTTP Request cu următoarea configurație:

• Method: POST
• URL: https://ws.smartbill.ro/SBORO/api/invoice
• Authentication: Header Auth cu token-ul tău
• Content-Type: application/json

Datele le transmiți în body ca JSON, cu structura specificată în documentația SmartBill. Câmpurile obligatorii includ seria, numărul, data, clientul și liniile de produse.

FGO facturare: automatizarea completă a procesului

FGO (Facturare Gratuită Online) este alternativa populară pentru freelanceri și afaceri mici. API-ul lor este mai simplu decât cel al SmartBill, dar la fel de eficient pentru automatizare.

Avantajele integrării FGO în n8n

FGO oferă avantaje specifice pentru anumite tipuri de business:

• Facturare gratuită până la 10 facturi lunar – ideal pentru startup-uri
• API direct – mai ușor de configurat decât SmartBill
• Semnătură electronică inclusă – facturile sunt valide fiscal fără semnătură fizică
• Rapoarte automate – export direct către contabil

Configurarea nodului FGO în n8n

Pentru FGO, procesul este similar dar cu endpoint-uri diferite:

1. Creează cont pe app.fgo.ro și activează API-ul din Setări
2. Generează cheia API – vei primi un API Key și un API Secret
3. În n8n, configurează nodul HTTP Request cu autentificare Basic Auth
4. Username este API Key, parola este API Secret
5. Endpoint pentru facturi: https://app.fgo.ro/api/v1/invoices

Tutorial practic: workflow complet de automatizare facturare n8n

Acum că avem ambele servicii pregătite, să construim un workflow funcțional care automatizează întregul proces de facturare.

Scenariul de business

Imaginează-ți că ai un magazin online de produse artizanale. Când un client finalizează comanda pe site, vrei să:

• Se creeze automat clientul în SmartBill (dacă nu există deja)
• Se emită factura cu toate produsele comandate
• Factura să fie trimisă automat pe email clientului
• Să primești o notificare pe Slack când factura e emisă

Pasul 1: Trigger – Webhook din platforma e-commerce

Primul nod este un Webhook care ascultă pentru notificări de la magazinul tău online. Configurează-l cu:

• HTTP Method: POST
• Path: /new-order (sau orice path dorești)
• Response Code: 200

Când o comandă nouă vine, platforma ta trimite datele către acest webhook – detalii client, produse, cantități, prețuri.

Pasul 2: Verificare client existent

Înainte de a emite factura, verifici dacă clientul există deja în SmartBill. Folosești un nod HTTP Request GET către:

https://ws.smartbill.ro/SBORO/api/client?cif=CIF_CLIENT

Dacă primești răspuns pozitiv, folosești ID-ul clientului. Dacă nu, treci la pasul următor.

Pasul 3: Creare client nou (dacă e necesar)

Cu un nod IF, verifici dacă clientul a fost găsit. Dacă nu, trimiți un POST către endpoint-ul de clienți cu datele din comandă:

• Nume companie sau persoană fizică
• CIF/CNP
• Adresa completă
• Email și telefon

Pasul 4: Emitere factură

Acum ai tot ce îți trebuie pentru a emite factura. Construiești JSON-ul cu toate liniile de produse și trimiți POST către API-ul de facturi.

Un aspect important: calculează TVA-ul corect înainte de a trimite. Dacă vinzi produse cu TVA 19%, asigură-te că prețurile sunt corect formatate.

Pasul 5: Trimitere email și notificare

După emitere, folosești nodul Gmail sau SMTP pentru a trimite factura către client. În paralel, un nod Slack te notifică pe canalul dedicat.

Greșeli frecvente în automatizarea facturării

După implementarea a zeci de workflow-uri de facturare, am identificat cele mai comune greșeli pe care le fac antreprenorii:

1. Nu validează datele înainte de emitere

Dacă un câmp lipsește sau este formatat greșit, factura fie nu se emite, fie se emite cu erori. Adaugă întotdeauna un nod de validare care verifică că toate câmpurile obligatorii sunt prezente și corect formatate.

2. Nu gestionează erorile API

API-urile pot eșua din diverse motive – serverul SmartBill este temporar indisponibil, token-ul a expirat, datele sunt invalide. Configurează nodul de error handling pentru a reîncerca de 3 ori și a te notifica dacă problema persistă.

3. Nu verifică duplicatele

Dacă webhook-ul primește aceeași comandă de două ori, vei emite două facturi. Adaugă un nod care verifică în baza ta de date locală dacă comanda a fost deja procesată.

4. Folosește credentiale hardcodate

Nu pune niciodată API keys direct în noduri. Folosește variabile de mediu sau credential store-ul din n8n pentru a le gestiona securizat.

Optimizări avansate pentru workflow-ul tău

Odată ce ai workflow-ul de bază funcțional, poți adăuga funcționalități suplimentare pentru a automatiza și mai mult procesul.

Sincronizare cu sistemul contabil

Adaugă un nod care exportă automat facturile în format SAFT sau XML pentru importul în sistemul contabil. Majoritatea contabililor din România acceptă astfel de exporturi.

Procesare automată a plăților

Integrează webhook-ul din procesatorul de plăți (Netopia, Stripe, EuPlătesc) pentru a marca automat facturile ca plătite când se primește confirmarea.

Rapoarte săptămânale

Configurează un trigger programat care generează un raport săptămânal cu facturile emise, sumele încasate și plățile restante. Trimite-l automat pe email către tine și contabil.

Backup automat

O dată pe zi, exportă toate facturile emise într-un folder de backup. Datele financiare sunt critice – nu te baza doar pe stocarea din SmartBill sau FGO.

De ce contează automatizarea facturării pentru business-ul tău

Automatizarea facturării nu este doar o chestiune de confort. Are impact direct asupra cash flow-ului și relației cu clienții.

Facturile emise imediat după comandă sunt plătite în medie cu 5 zile mai repede decât cele emise manual. Când clientul primește factura în câteva minute de la achiziție, procesul de plată este încă proaspăt în mintea lui.

De asemenea, eliminarea erorilor umane reduce disputările și retururile. O factură corectă, cu toate detaliile clare, construiește încredere și profesionalism.

Statistic, companiile care automatizează facturarea reduc costurile administrative cu 25-30% și îmbunătățesc rata de încasare cu 15-20%.

Concluzie și următorii pași

Automatizarea facturării cu n8n prin integrarea SmartBill și FGO transformă un proces care îți lua ore întregi într-unul care rulează autonom. Configurarea inițială necesită câteva ore de investiție, dar economia de timp pe termen lung este substanțială.

Pentru a recapitula pașii esențiali:

• Configurează API-urile din SmartBill și FGO
• Creează workflow-ul în n8n cu trigger, verificări și emitere
• Adaugă gestionarea erorilor și notificări
• Testează cu date reale înainte de a pune în producție
• Monitorizează și optimizează constant

Dacă vrei să implementezi automatizarea facturării dar nu ai timpul sau expertiza necesară, echipa Lazart Studios te poate ajuta să configurezi un workflow personalizat pentru business-ul tău. Contactează-ne pentru o consultanță gratuită și îți arătăm exact cum ar arăta automatizarea pentru cazul tău specific.