Ce primesti
La fiecare comanda confirmata pe site (plata reusita prin Stripe, Netopia, EuPlatesc sau ramburs marcat ca livrat), apelam endpoint-ul POST ws.smartbill.ro/SBORO/api/invoice cu Basic Auth (email:token). SmartBill genereaza factura cu seria si numarul tau configurat, returneaza PDF si XML in raspuns sub 30 secunde.
Pentru facturile B2B obligatorii (peste plafonul ANAF curent), XML-ul UBL 2.1 generat de SmartBill este trimis automat in SPV-ul tau. Nu mai loghezi manual pe anaf.ro, nu mai uploadezi XML-uri, nu mai pierzi termene. Logging complet al raspunsului ANAF pentru audit fiscal.
La fiecare vanzare pe site, stocul scade automat in SmartBill. Daca primesti livrare in depozit si adaugi cantitati in SmartBill, stocul creste pe site. Pentru produse cu variante (marime, culoare), mapping pe SKU. Job cron de sincronizare la 5 minute sau realtime via webhook.
PDF-ul facturii e atasat automat la email-ul de confirmare comanda trimis clientului (template HTML personalizat cu logo si culorile tale). Clientul primeste pe email coletul cu factura completa fiscal, fara sa-i mai trimiti tu manual. Optional, factura si in contul lui din site.
Configurare mapping intre cotele TVA de pe site (19%, 9%, 5%, scutit, taxare inversa) si cele din SmartBill. Setare serii facturare separate pentru online vs offline daca ai nevoie. Logica pentru clienti UE (intracomunitar) si extra-UE (export). Validare CIF anti-fraud cu ANAF VAT check.
Daca API-ul SmartBill pica temporar sau site-ul tau are downtime in momentul comenzii, webhook-ul nu se pierde. Queue Redis cu retry 3x in 5 minute, dead-letter queue pentru investigare manuala, alerta Slack daca esueaza definitiv. Logging Sentry pentru orice eroare API.
Toata implementarea (plugin custom, API route Next.js, webhook handler) ramane in repository-ul tau. Documentatie scrisa cu fiecare endpoint folosit, fiecare camp mapat, fiecare edge case tratat. Daca maine vrei alt dezvoltator sa intervina, are tot ce-i trebuie.
Sesiune training 1h cu echipa care va folosi sistemul (cum verifici daca o factura s-a generat, ce faci la eroare CIF invalid, cum reemit o factura). Dashboard simplu cu ultimele 100 facturi generate, status (success/retry/failed), motiv esec, buton de retrimitere manuala.
Cum functioneaza
Ziua 1
Sesiune 30-45 min unde vedem stack-ul actual (WooCommerce, Shopify, Next.js, custom), volumul lunar de comenzi, planul tau SmartBill, daca ai nevoie de e-Factura B2B obligatoriu, cum sunt configurate seriile si cotele TVA. Identificam edge cases (livrare in afara RO, abonamente, vouchere).
Ziua 2-3
Generam token API in dashboard-ul tau SmartBill, configuram variabilele de mediu pe staging (email + token cu Basic Auth), facem maparea intre campurile site-ului si parametrii API SmartBill (CIF client, denumire produs, cantitate, pret, cota TVA, serie factura). Validam cu 2-3 cazuri test.
Ziua 4-6
Scriem cod-ul de integrare (plugin WooCommerce, API Route Next.js sau endpoint custom dupa stack). Implementam webhook handler care declanseaza POST catre ws.smartbill.ro/SBORO/api/invoice la confirmarea platii. Adaugam retry queue si logging Sentry. Test end-to-end pe staging cu plati reale de 1 RON.
Ziua 7-8
Pe staging cu cont SmartBill test, simulam scenarii: comanda B2C cu CIF lipsa, comanda B2B cu CIF valid, comanda cu produse TVA mixt (19% + 9%), comanda anulata cu refund, comanda cu storno. Verificam ca toate scenariile genereaza factura corecta sau esueaza grafios cu eroare clara.
Ziua 9-10
Promovam codul pe productie, schimbam credentialele cu cele live, monitorizam primele 24h cu alerta SMS daca apare eroare. Sesiune training 1h cu echipa ta, manual scris cum se gestioneaza erorile. 30 zile suport bug-uri inclus pentru orice ne scapa la testare.
Stack suportat
Recomandat
Plugin oficial SmartBill, cel mai matur. 3-5 zile setup.
Suportat
Integrare custom via Shopify Webhooks + SmartBill API. 7-10 zile.
Suportat
Modul comunitar disponibil, necesita configurare custom TVA.
Suportat
Extension comunitate sau dezvoltare custom pentru v2.
Recomandat
API Route sau Edge Function care apeleaza SmartBill REST. 5-7 zile.
Suportat
Endpoint serverless (Cloudflare Workers) la confirmarea platii.
Suportat
Combinatie WooCommerce REST + frontend separat, plugin standard.
Suportat
SDK comunitate sau Guzzle direct catre ws.smartbill.ro. 5-8 zile.
Preturi
300-500€
3-5 zile livrare
600-1000€
7-10 zile livrare
1000-1500€
10-15 zile livrare
Intrebari frecvente
Realist, depinde de complexitate. 1) Plugin standard WooCommerce + setup SmartBill = 300-500€ one-off, livrat in 3-5 zile, fara mentenanta lunara dincolo de abonamentul SmartBill (de la 19€/luna pentru pachetul de baza). 2) Integrare Shopify sau custom Next.js via API REST = 600-1000€ one-off, 7-10 zile, optional 30€/luna mentenanta pentru actualizari API. 3) Integrare complexa cu logica custom (multi-warehouse, preturi diferentiate, multi-currency, e-Factura B2B obligatoriu) = 1000-1500€, 10-15 zile. Daca cineva iti cere 3000€+ pentru o integrare simpla WooCommerce, intreaba ce face suplimentar.
SmartBill Cloud e cel mai utilizat soft de facturare din Romania (peste 100.000 firme active), are API REST documentat clar, suport in romana cu raspuns rapid si include e-Factura ANAF gratuit in toate planurile. Oblio e o alternativa solida cu UI mai modern dar API-ul e mai limitat pentru integrari avansate. FGO e bun pentru contabilitate completa dar mai scump. Facturis e cel mai ieftin dar instabil pe API. Recomandam SmartBill cand ai nevoie de facturare + stocuri + e-Factura intr-un singur loc, cu API matur si comunitate mare de developeri care l-au integrat deja.
Pentru WooCommerce cu plugin oficial: 3-5 zile lucratoare. Procesul concret: ziua 1 audit cont SmartBill si site, ziua 2 instalare plugin + configurare token API + mapare campuri (CIF, serie factura, TVA), ziua 3 testare cu 3-5 comenzi de proba pe staging, ziua 4-5 go-live cu monitorizare. Pentru Shopify, Next.js sau custom: 7-10 zile pentru ca scriem cod nou de conectare la endpoint-urile SmartBill. Pentru cazuri complexe (multi-store, marketplace, custom logic) 2-3 saptamani. Toate cu sesiune de training de 1h pentru echipa ta.
Flux tehnic: clientul plaseaza comanda pe site, plata e confirmata (Stripe/Netopia/EuPlatesc), webhook-ul declanseaza apelul POST catre ws.smartbill.ro/SBORO/api/invoice cu Basic Auth (email + token), SmartBill genereaza factura cu serie automata, returneaza PDF + XML in raspuns, sistemul ataseaza PDF-ul la email-ul de confirmare comanda catre client, XML-ul e trimis automat la e-Factura ANAF daca e factura B2B obligatorie, stocul scade in SmartBill, comanda apare in dashboard contabilitate. Totul automat in sub 30 secunde de la plata.
Suportam toate stack-urile principale. WooCommerce: plugin oficial SmartBill (cel mai matur, recomandat). Shopify: integrare custom via API REST + webhooks Shopify (5-7 zile dezvoltare). PrestaShop si Magento: module disponibile, mai complex la configurare. Next.js / Astro / React custom: scriem endpoint server-side care apeleaza SmartBill API la confirmarea comenzii (Edge Function sau API Route). PHP custom / Laravel / Symfony: SDK comunitate sau cod direct cu Guzzle. WordPress headless + WooCommerce REST: combinam pluginul WooCommerce cu API custom pe frontend. Pentru orice stack: te ghidam ce abordare e optima.
Top 5 erori intalnite: 1) Token API expirat sau gresit (Basic Auth cu email:token, nu username:parola) — rezolvare regenerare in dashboard SmartBill. 2) CIF client invalid sau lipsa pentru factura B2B — adaugam validare client-side ANAF VAT check inainte de plata. 3) Serie factura epuizata in plan SmartBill — alerta automata cand mai sunt 50 facturi din quota. 4) TVA mapat gresit intre site si SmartBill (19% vs scutit vs taxare inversa) — mapping table verificat la setup. 5) Webhook lost daca site-ul pica in momentul comenzii — retry queue cu 3 incercari + dead letter pentru investigare manuala. Toate cu logging in Sentry.
Inclus in pretul de implementare: 30 zile suport bug-uri post-livrare (bug = ceva ce am livrat noi nu functioneaza), documentatie scrisa cum se reconfigureaza credentialele cand expira, sesiune training 1h pentru echipa care va folosi sistemul. Pentru mentenanta ongoing oferim doua optiuni: 1) Pay-per-incident 50€/ora interventie cand apare ceva. 2) Pachet anual 30-50€/luna cu actualizari API garantate, monitoring uptime SmartBill, fix prioritar in 4h. SmartBill modifica API-ul rar (1-2 ori pe an) si pastreaza backward compatibility 6 luni minim, deci interventiile sunt rare.
Nu recomandam integrare SmartBill daca: 1) Firma ta emite sub 30 facturi pe luna — automatizarea nu se justifica economic, faci manual in 10 minute. 2) Lucrezi exclusiv B2B cu facturi custom complexe (storno, discount-uri negociate, plati partiale) — SmartBill e rigid pentru cazuri exotice, mai bine Oblio sau ERP custom. 3) Ai deja un ERP (NextUp, Charisma, SAP Business One) care factureaza — integrezi cu ERP-ul, nu adaugi SmartBill in plus. 4) Esti firma straina cu sediu in afara RO si nu ai obligatia ANAF — alegi Stripe Invoicing sau Xero. 5) Vrei doar emitere factura PDF fara conectare contabilitate — Oblio gratuit pana la 50 facturi/luna e suficient.
Integrari conexe
Trimitere automata XML UBL 2.1 in SPV ANAF pentru firme B2B obligate. Complementar cu SmartBill care genereaza XML-ul.
Alternativa la SmartBill cu UI mai modern, plan gratuit pana la 50 facturi pe luna. Bun pentru SMB-uri mici.
Soft contabilitate complet cu facturare integrata, mai potrivit pentru firme care vor un singur sistem pentru tot.