Integrare Oblio — facturare automată, e-Factura ANAF și stoc sincronizat

Implementarea o facem între 300€ (conectare simplă POST /api/docs/invoice la fiecare comandă plătită, cu seriesName și number înapoi în baza de date) și 1200€ (sincronizare bidirecțională cu stoc, chitanțe la încasare cash on delivery, proforme automate pentru B2B, e-Factura ANAF semnată și trimisă la SPV, dashboard intern cu KPI). Cele mai multe magazine SMB intră în 500-800€ pentru WooCommerce sau Next.js cu webhook complet. Abonamentul Oblio: plan gratuit până la 75 documente/lună (cu funcții reduse), plan Basic 7€/lună pentru 250 documente, Smart 14€/lună pentru 500 documente, Pro 28€/lună nelimitat cu e-Factura inclus. Fără cost setup la Oblio.

Oblio: alternativă mai modernă și mai ieftină decât SmartBill, API REST curat cu documentație clară, plan gratuit real pentru micro-business (până la 75 documente/lună), e-Factura ANAF inclus din planul Pro, interfață rapidă, suport responsive. SmartBill: lider de piață, ecosistem mai mare cu integrări native peste tot, dar mai scump (24-50€/lună), API mai stufos. FGO: cel mai ieftin (de la 5€/lună), API decent, dar interfață mai veche și ecosistem de integrări limitat. Recomandare: Oblio pentru firme noi sau care fac switch de la SmartBill pentru cost mai bun, SmartBill dacă ai deja flow setat și nu vrei să schimbi, FGO dacă optimizezi agresiv costul.

Depinde de scope: integrare simplă (factură la fiecare comandă plătită prin webhook plată, PDF trimis la client pe email) — 3-5 zile cu testare în sandbox Oblio. Integrare medie (facturi + chitanțe pentru COD + proforme B2B + sincronizare clienți cu CIF/CUI) — 7-10 zile. Integrare completă (toate documentele + stoc sincronizat + e-Factura ANAF semnată cu certificat și trimisă la SPV + retry queue pentru downtime + dashboard contabilitate) — 14-21 zile. Toate includ testare cu workspace Oblio test (separat de live), validare manuală a primelor 5-10 facturi cu contabilul tău, documentație pentru echipa ta.

Livrăm: 1) Cont Oblio configurat cu datele firmei (CUI, IBAN, serii facturi conform Codul Fiscal), Workspace ID izolat pentru API. 2) Bearer token API generat și stocat securizat în env vars (nu hardcoded în cod). 3) Endpoint /api/oblio/invoice care apelează POST oblio.eu/api/docs/invoice cu produsele, clientul, totalul și TVA-ul corect, primește înapoi seriesName + number factură pe care îl stocăm. 4) PDF factură descărcat automat și atașat la email confirmare comandă. 5) Webhook handler care la payment_intent.succeeded (Stripe) sau IPN (NETOPIA) declanșează automat factura. 6) Retry queue cu Bull sau Inngest dacă Oblio API răspunde 500. 7) Pentru e-Factura ANAF: semnare cu certificat și trimitere la SPV via API Oblio. 8) Logging Sentry pentru erori și dashboard intern cu lista facturi/luna.

Toate. WooCommerce: plugin Oblio oficial pentru WP + customizare hooks pentru momentul corect de emitere (order processing vs completed) și retry logic. Shopify: nu există plugin oficial Oblio, scriem middleware Node.js între Shopify webhooks și Oblio API (deploy pe Cloudflare Workers sau Vercel Functions). PrestaShop: modul comunitar Oblio + adaptări pentru flow specific. Magento 2: integrare custom via extension PHP cu Oblio SDK. Next.js / Astro custom: SDK npm sau direct fetch către oblio.eu/api/docs/invoice din route handlers App Router. WordPress headless: WP back pentru produse + middleware Next.js care orchestrează plata și factura Oblio. PHP custom (Laravel, Symfony): pachet Composer comunitar sau Guzzle direct către API REST.

1) Bearer token expirat sau invalid — răspuns 401 din API, factura nu se emite, client așteaptă confirmarea. Fix: refresh automat token cu 24h înainte de expirare și fallback retry. 2) Workspace ID greșit în header — facturile ajung în alt cont. Fix: validare la deploy că env var WORKSPACE_ID corespunde cu mediul (test vs live). 3) TVA hardcoded 19% când vinzi produse cu TVA 9% sau 5% — erori contabile la ANAF. Fix: TVA din settings produs, nu din cod. 4) Numerotare facturi cu hub-uri — Oblio gestionează singur seriesName + number, nu generăm noi numere paralel. 5) Retry fără idempotency — facturi duplicate la network errors. Fix: idempotency key din order ID + verificare existent înainte de POST. 6) Lipsa CIF/CUI valid pentru clienți PJ — refuzat la e-Factura. Fix: validare format CUI înainte de a trimite.

90 zile suport bug-uri inclus în implementare: dacă API-ul Oblio schimbă endpoint (rar, anunțat în changelog), dacă webhook nu mai primește events de la procesatorul de plăți, dacă facturi rămân blocate în retry queue — intervenim gratuit. Monitoring uptime al endpoint-ului intern Oblio cu Healthchecks.io alertare în 2 minute dacă rata de emitere scade. Pentru schimbări legislative ANAF (cum a fost RO e-Factura B2B obligatoriu din 2025): adaptare gratuită în primele 90 zile, după aceea pachet mentenanță 30-50€/lună include orice update legal forțat. Documentația noastră (Markdown + diagrame Mermaid) permite oricărui dev să intervină — nu te legăm. Pentru optimizare conversie checkout + facturare automată COD: pachet consultanță separat.

Oblio nu e potrivit dacă: 1) Ai deja ecosistem complet cu SmartBill conectat la POS, CRM, ERP și migrarea costă mai mult decât economisești pe 2 ani — rămâi cu SmartBill. 2) Volumul tău e sub 20 facturi/luna și planul gratuit Oblio (75 documente) e oricum mai mult decât ai nevoie — atunci orice soluție merge, alegi pe interfață. 3) Ai nevoie de funcții ERP avansate (gestiune mai multe gestiuni de stoc cu transferuri între ele, BOM-uri producție, salarizare integrată) — Oblio face facturare + stoc simplu, nu ERP. Alege NextUp sau SAGA. 4) Operezi în mai multe țări simultan cu TVA local diferit — Oblio e focus RO, alege Xero sau QuickBooks. 5) Contabilul tău refuză să lucreze cu altceva decât SAGA sau WizCount — diplomația cere să-l asculți.