Ce primesti
Webhook Netopia sau Stripe confirmă plata → site-ul face POST la API FGO cu datele complete (produse, TVA, client, serie factură). Factura PDF e generată în maxim 3 secunde, atașată automat în comanda WooCommerce și trimisă pe email-ul clientului. Zero intervenție manuală pentru tine.
Pentru clienții B2B (cu CUI), FGO trimite automat factura în SPV ANAF în format XML UBL 2.1 (e-Factura). Validăm CUI-ul prin API ANAF înainte de submit, primim înapoi indexul de încărcare și salvăm dovada în comanda magazinului. Conformitate completă cu OUG 130/2021.
Stocul din FGO devine sursa de adevăr. La fiecare comandă plătită, FGO actualizează stocul, iar webhook-ul informează site-ul. Pentru ajustări manuale făcute direct în FGO (recepții, transferuri), site-ul preia modificările într-un job programat sau în timp real. Sfârșit problemelor cu overselling.
FGO permite atașarea de câmpuri personalizate pe produse — folosim asta pentru licențe software, abonamente, coduri voucher, downloads protejate. Factura include linkul de descărcare sau cheia generată, totul tracked în nomenclatorul FGO pentru raportare contabilă corectă.
FGO suportă atașarea unui link de plată direct pe factura proformă sau pe factura fiscală pentru clienții care plătesc ulterior. Configurăm conexiunea cu contul tău Netopia mobilPay sau Stripe, astfel încât clientul primește email cu factura și buton „Plătește acum”. Confirmarea plății se sincronizează înapoi în FGO automat.
Mapăm fiecare produs din magazin la o intrare din nomenclatorul FGO (sau le creăm automat la prima utilizare). Categorii TVA corecte (19%, 9% pentru cărți, 5% pentru locuințe), unități de măsură, conturi contabile asignate. Dacă ai 50 sau 5000 SKU, scriem script de import una-singură.
Fiecare apel către API FGO e logat structurat (request, response, timing). Erorile sunt trimise în Sentry cu alertă pe Slack sau email. Dashboard intern unde vezi: câte facturi azi, ce a eșuat și de ce, queue de retry pentru cele neprocesate. Vizibilitate totală, nu doar „pare că merge”.
Token-ul Bearer FGO stocat criptat în variabile de mediu (Vercel, Cloudflare, .env). Rotație trimestrială recomandată cu procedură documentată. Setăm mediu de staging cu cont demo FGO separat — testăm orice modificare acolo înainte să atingă producția. Zero risc de facturi greșite emise.
Cum functioneaza
Ziua 1
Sesiune 30 min în care mapăm: ce stack ai (WooCommerce, Shopify, Next.js), ce fluxuri vrei automatizate (doar facturi, sau și proforme, avize, chitanțe), volumul lunar de comenzi, dacă ai e-Factura activat. Ne dai acces la contul FGO (user dedicat dezvoltator cu permisiuni API) și la repo-ul magazinului.
Zilele 2-3
Generăm token Bearer pentru API v2, configurăm seriile de facturi (fiscale, proforme), mapăm primele 10-20 produse de test în nomenclatorul FGO. Validăm că putem face POST la api.fgo.ro/v2/Bills cu un payload minimal și primim înapoi un PDF valid.
Zilele 3-7
Scriem connector-ul propriu-zis: plugin WooCommerce, serverless function pentru Shopify, sau API route Next.js. Tratăm cazurile speciale (client persoană fizică vs juridic, plată cash vs card vs transfer, livrare vs ridicare). Toate cu logging și gestionare erori.
Zilele 7-10
Plasăm 5-10 comenzi de test cu carduri reale (cu sume mici), validăm că factura ajunge în FGO, în SPV ANAF (pentru B2B), pe email-ul clientului și în comanda WooCommerce. Verificăm că stocul se decrementează corect. Edge cases: comandă cu cupon, refund parțial, produs digital.
Zilele 10-12
Activăm integrarea pe producție într-o fereastră de trafic minim. Monitorizăm primele 24h cu alertă instantă dacă apare orice eroare. Validăm primele 50 facturi reale generate. Setăm dashboard de control pentru tine.
Zilele 12-14
Sesiune 60 min cu echipa ta: cum verifici dacă o factură s-a generat corect, ce faci dacă apare o eroare, cum modifici manual o factură în FGO dacă e nevoie. Documentație scrisă livrată, plus 30 zile suport pentru bug-uri.
Stack suportat
Plugin oficial + custom
Cea mai matură integrare. Plugin FGO oficial extins cu filtre WordPress pentru cazuri speciale.
Connector serverless
Fără plugin oficial, scriem connector Cloudflare Workers care ascultă webhook-urile Shopify.
Modul custom PHP
Modul cu hook-uri pe orderConfirmed și actionPaymentConfirmation. Compatibil 1.7+ și 8.x.
Extension custom
Pentru magazine enterprise. Observer pattern + queue cu RabbitMQ pentru volume mari.
API routes + webhooks
Integrare direct în route handlers. Cache Redis pentru nomenclator, queue Upstash pentru retry.
Server endpoints
Pentru magazine headless cu Snipcart sau Crystallize. Endpoint-uri TypeScript dedicate.
Plugin + REST API
Combinație plugin FGO clasic + endpoint-uri REST către frontend Next.js sau Nuxt.
SDK propriu
SDK PHP scris de noi, distribuit ca pachet Composer. Compatibil PHP 7.4+ și 8.x.
Prețuri
300€
livrare 3-5 zile
750€
livrare 5-10 zile
1500€+
livrare 10-21 zile
Intrebari frecvente
Implementarea one-off pornește de la 300€ pentru un magazin WooCommerce standard (facturare automată la comandă plătită + e-Factura ANAF) și ajunge la 1500€ pentru proiecte Next.js custom cu nomenclator dinamic, sincronizare stoc bidirecțională și webhook-uri în timp real. Lunar: 0-50€ pentru mentenanță, plus abonamentul FGO direct la ei (de obicei 15-40€/lună după nivel). Ce împinge prețul: număr de fluxuri (facturi, proforme, avize, chitanțe), conectare cu plăți online, sincronizare stoc în mai multe locații, custom fields pentru produse digitale, raportare contabilă personalizată. Iei ofertă în 4h cu URL-ul magazinului.
Depinde de stack și preferințe. SmartBill: cel mai folosit din România, API matur, ideal pentru contabili care vor un instrument familiar. Oblio: interfață modernă, plan gratuit generos pentru firme mici, API curat. FGO: software românesc cu suport contabilitate primară completă, gestiune stoc avansată și plată online integrată direct (Netopia, Stripe), foarte bun pentru firme care vor un singur tool pentru tot. Dacă ai deja contabil care folosește FGO sau vrei suite all-in-one cu stoc + facturare + e-commerce, FGO câștigă. Dacă vrei doar facturi simple, Oblio sau SmartBill sunt suficiente. Te ghidăm la alegere fără agendă comercială.
WooCommerce standard cu facturare automată la plată confirmată: 3-5 zile lucrătoare. Include API key setup, mapare produse, configurare serii facturi, e-Factura ANAF activat, testare cu 5 comenzi reale. Shopify sau PrestaShop: 5-7 zile (lipsă plugin oficial, scriem connector custom). Next.js custom cu webhook-uri bidirecționale (FGO către site + site către FGO): 7-14 zile, include staging environment și documentație tehnică. Proiecte mari cu nomenclator complex, multiple gestiuni, contabilitate primară integrată: 14-21 zile cu sesiuni săptămânale de validare. Înainte de start: brief tehnic 30 min ca să aliniem scope-ul exact.
Fluxul tipic e-commerce: 1) Client plasează comandă pe site → 2) După confirmare plată (Netopia/Stripe webhook), site-ul face POST la api.fgo.ro/v2/Bills cu Bearer token, payload JSON cu produse, prețuri, TVA, date client. 3) FGO returnează numărul facturii și PDF URL. 4) Site-ul trimite automat factura pe email client + atașează PDF în comanda WooCommerce. 5) FGO trimite în paralel în SPV ANAF (e-Factura) pentru clienții B2B. 6) Webhook FGO către site la încasare confirmată → marchează comanda „plătită contabil”. Pentru stoc: sincronizare nightly sau real-time la fiecare comandă, în funcție de volum.
Toate. WooCommerce: plugin oficial FGO + configurări custom prin filtre WordPress (recomandăm pentru 80% din clienți). Shopify: nu există plugin oficial, scriem connector serverless (Cloudflare Workers sau Vercel Functions) care ascultă webhook-urile Shopify și transformă comenzile în request-uri către FGO API. PrestaShop și Magento: modul custom PHP cu hook-uri pe orderConfirmed. Next.js / Astro custom (e-commerce headless): integrare direct în API routes, cu cache Redis pentru nomenclatorul de produse, queue cu Upstash pentru retry la erori. WordPress headless: combinație plugin FGO + REST API către frontend. PHP custom legacy: SDK PHP scris de noi, documentat, livrat ca dependență Composer.
Top 5 erori întâlnite real: 1) Token Bearer expirat sau invalid — implementăm refresh automat cu retry exponențial și alertă în Sentry. 2) Produs lipsă din nomenclator — fallback la creare automată cu cod generic sau queue manual review. 3) CUI client invalid pentru B2B + e-Factura — validare ANAF înainte de submit, mesaj clar pentru client. 4) Depășire rate limit API FGO (60 req/min) — queue cu BullMQ și retry inteligent. 5) Discrepanță TVA între site și FGO (cota 19% vs 9% pentru cărți, medicamente) — mapare explicită per categorie produs. Toate cu logging structurat și dashboard pentru tine să vezi ce s-a întâmplat.
Inclus în implementare: 30 zile suport bug-uri (orice nu funcționează cum am specificat în brief — fix gratuit). Pentru intervenții ulterioare avem două variante: 1) Pay-per-incident la 60€/h, răspuns în max 24h ore lucrătoare. 2) Pachet mentenanță 50€/lună care include monitorizare automată (alertă dacă FGO API răspunde cu erori repetate), 2h intervenție lunară inclusă, prioritate la cereri. Pentru schimbări majore (FGO actualizează API la v3, contul tău se mută între planuri): cost separat la oră sau pachet. Documentația de implementare e livrată completă — orice dev poate continua, nu te legăm doar de noi.
Nu recomandăm FGO dacă: 1) Emiteți sub 10 facturi/lună — orice plan plătit FGO devine inutil, mergeți pe Oblio gratuit sau facturi manuale. 2) Aveți deja contabil care folosește exclusiv SmartBill — nu schimbăm tool-ul contabilului pentru un site, integrăm cu SmartBill direct. 3) Sunteți firmă cu raportare contabilă complexă (multi-țară, IFRS, consolidări) — FGO e bun pentru SRL standard, nu pentru holdinguri; recomandăm un ERP real ca NextUp, Senior sau Saga. 4) Folosiți deja un ERP intern (SAP, Charisma) — facem integrare directă cu acel ERP, nu mai adăugăm FGO ca intermediar. Onestitatea înainte de vânzare ne aduce mai mulți clienți decât invers.
Integrări conexe
Dacă vrei trimitere directă în SPV ANAF fără să treci prin FGO, integrăm direct cu API-ul ANAF.
Alternativă populară pentru firme cu contabil care folosește SmartBill. API matur și suport excelent.
Plan gratuit generos, API curat, ideal pentru firme mici care emit sub 100 facturi/lună.