Integrare WooCommerce cu FirstBill: facturi automate din comenzi
Actualizat la
Pe scurt
WooCommerce poate trimite comenzile direct la FirstBill printr-un webhook semnat (HMAC-SHA256). În FirstBill creezi o conexiune în Configurare → Magazine online, apoi fiecare comandă devine factură o singură dată, cu clientul, TVA-ul și încasarea. Integrarea necesită planul Pro.
Ce face integrarea WooCommerce – FirstBill
- Emite automat factura pentru fiecare comandă, cu numerotarea și seria firmei tale.
- Caută clientul după CUI (sau după email și nume) și îl creează dacă nu există.
- Preia cotele de TVA, reducerile și transportul din comandă.
- Înregistrează încasarea pe factură când comanda este plătită.
- Nu emite niciodată două facturi pentru aceeași comandă, chiar dacă platforma retrimite notificarea.
- Afișează în FirstBill, la conexiune, numărul de facturi emise și ultima eroare, dacă apare.
Metode de integrare pentru WooCommerce
WooCommerce este plugin-ul de magazin online pentru WordPress. Poate trimite comenzile la o adresă externă prin webhook-uri semnate, iar FirstBill le înțelege direct, fără instrumente intermediare.
| Metodă | Disponibilitate | Observații |
|---|---|---|
| Webhook direct WooCommerce → FirstBill | Disponibil | Cea mai simplă metodă: semnătura HMAC-SHA256 este verificată de FirstBill. |
| Zapier, Make, n8n | Posibil | Nu e necesar, dar poți folosi formatul FirstBill dacă ai deja scenarii. |
| Cod propriu | Posibil | Pentru reguli speciale, prin API. |
Cum conectezi WooCommerce la FirstBill, pas cu pas
- În FirstBill: Configurare → Magazine online, alege platforma WooCommerce și apasă „Creează conexiunea”. Copiază adresa webhook și secretul (se afișează o singură dată).
- În WordPress deschide WooCommerce → Setări → Avansat → Webhook-uri, apoi „Adaugă webhook”.
- Nume: FirstBill. Stare: Activ. Subiect: „Comandă actualizată” (recomandat: prinde și trecerea comenzii la plătită) sau „Comandă creată”, dacă emiți factura la plasarea comenzii.
- URL de livrare: adresa webhook copiată din FirstBill. Secret: secretul copiat. Versiunea API: cea implicită.
- Salvează. WooCommerce trimite un mesaj de verificare, pe care FirstBill îl confirmă fără să emită nimic.
- Plasează o comandă de probă și verifică factura în Vânzări → Facturi emise. La conexiune apar numărul de facturi emise și ultima eroare.
TVA, CUI și transport
- Cotele de TVA se iau din comandă. Dacă magazinul nu are taxe configurate, prețurile se tratează ca având TVA inclus.
- Pentru clienți persoane juridice, magazinul trebuie să colecteze CUI-ul la checkout (câmp personalizat). FirstBill nu importă CNP-ul: persoanele fizice rămân fără CUI.
- Transportul apare ca linie separată, cu cota lui de TVA.
- Firmele neplătitoare de TVA emit facturi fără TVA, indiferent de cotele din comandă.
- Dacă ai activată transmiterea automată în SPV, factura emisă din comandă se transmite ca orice altă factură.
Particularități WooCommerce
- Emiterea la plată: lasă opțiunea „când comanda este plătită” și alege subiectul „Comandă actualizată”. Comenzile în așteptarea plății sunt ignorate și se factureză când trec la „În curs de procesare” sau „Finalizată”.
- CUI și Reg. Com. sunt citite din câmpurile personalizate ale comenzii al căror nume conține cui, cif, cod fiscal sau reg com (de exemplu _billing_cui), cum fac majoritatea modulelor de checkout pentru firme.
- Comenzile anulate, eșuate, rambursate sau în coșul ciornă se ignoră.
- Metodele de plată se mapează: ramburs → COD, transfer bancar → TRANSFER, cec → CHECK, restul plăților online → CARD_ONLINE.
Ce îți trebuie
- Un cont FirstBill cu planul Pro (integrările cu magazine online folosesc conexiuni webhook și API).
- Acces de administrator în magazin, ca să poți adăuga un webhook sau o automatizare.
- Pentru e-Factura: firma conectată la ANAF în FirstBill (planul Start sau Pro).
Întrebări frecvente
- Funcționează cu plugin-uri de CUI la checkout?
- Da, dacă pluginul salvează CUI-ul într-un câmp personalizat al comenzii cu un nume care conține cui, cif sau cod fiscal. Altfel, clientul este creat fără CUI.
- Pe ce subiect webhook creez în WooCommerce?
- Pentru emitere la plată, „Comandă actualizată”. Pentru emitere la plasarea comenzii, „Comandă creată”.
- De ce nu apare factura imediat?
- Dacă ai ales emiterea la plată, factura apare când comanda trece la plătită. Verifică și eroarea afișată la conexiune în FirstBill.
- Pot emite automat facturi din comenzile WooCommerce?
- Da, în planul Pro. Fiecare comandă WooCommerce devine o factură în FirstBill, o singură dată, cu încasarea înregistrată dacă este plătită.
- Ce se întâmplă dacă WooCommerce trimite aceeași comandă de două ori?
- FirstBill recunoaște comanda după identificatorul ei și întoarce factura deja emisă, fără să creeze alta.
Începe gratuit
Creează un cont și emite prima factură în câteva minute. Nu ai nevoie de card pentru planul gratuit.