Integrări FirstBill cu platforme de comerț electronic
Actualizat la
Pe scurt
FirstBill emite automat factura pentru fiecare comandă din magazinul tău online. WooCommerce și Shopify trimit comenzile direct, printr-un webhook semnat. Pentru Wix, Squarespace, BigCommerce, PrestaShop, OpenCart, Magento, Gomag, MerchantPro și restul platformelor folosești formatul de comandă FirstBill, prin Zapier, Make, n8n sau cod propriu. Integrările necesită planul Pro.
Cum funcționează o integrare
- Creezi o conexiune în FirstBill, la Configurare → Magazine online, și primești o adresă webhook și un secret.
- Configurezi magazinul (sau un instrument de automatizare) să trimită comenzile la acea adresă.
- FirstBill emite factura o singură dată pentru fiecare comandă, cu clientul, TVA-ul și transportul, și înregistrează încasarea dacă a fost plătită.
- Dacă ai activat transmiterea automată în SPV, factura pleacă în RO e-Factura ca orice altă factură.
Platformele pentru care avem pagină de integrare
- WooCommerceWebhook direct, semnat
- ShopifyWebhook direct, semnat
- WixPrin formatul FirstBill și un instrument de automatizare
- WeeblyPrin formatul FirstBill și un instrument de automatizare
- VolusionPrin formatul FirstBill și un instrument de automatizare
- SquarespacePrin formatul FirstBill și un instrument de automatizare
- PrestaShopPrin cod sau modul propriu
- OpenCartPrin cod sau modul propriu
- MerchantProPrin formatul FirstBill și un instrument de automatizare
- MagentoPrin cod sau modul propriu
- JumpsellerPrin formatul FirstBill și un instrument de automatizare
- JoomlaPrin cod sau modul propriu
- HubSpotPrin formatul FirstBill și un instrument de automatizare
- GomagPrin formatul FirstBill și un instrument de automatizare
- EcwidPrin formatul FirstBill și un instrument de automatizare
- DrupalPrin cod sau modul propriu
- CS-CartPrin cod sau modul propriu
- ContentSpeedPrin formatul FirstBill și un instrument de automatizare
- BigCommercePrin formatul FirstBill și un instrument de automatizare
- 3dcart (Shift4Shop)Prin formatul FirstBill și un instrument de automatizare
Trei metode de conectare
| Metodă | Pentru ce platforme | Ce ai nevoie |
|---|---|---|
| Webhook direct | WooCommerce, Shopify | Doar setările de webhook din magazin; FirstBill verifică semnătura. |
| Instrument de automatizare (Zapier, Make, n8n, Pabbly) | Platforme SaaS: Wix, Squarespace, BigCommerce, Jumpseller, Ecwid, HubSpot și altele | Un cont în instrumentul ales, cu conector pentru platforma ta. |
| Cod propriu sau modul | PrestaShop, OpenCart, Magento, Joomla, Drupal, CS-Cart | Un dezvoltator; exemplu de cod PHP în fiecare pagină. |
Siguranță și corectitudine
- WooCommerce și Shopify: semnătura HMAC-SHA256 a fiecărui mesaj este verificată înainte de orice emitere.
- Celelalte platforme: un token secret, trimis în antet sau în adresă; tokenul se păstrează criptat.
- Idempotență: aceeași comandă retrimisă nu emite a doua factură.
- Planul contului este verificat la fiecare mesaj, iar cererile sunt limitate ca să protejeze serverul.
- Erorile (de exemplu o comandă fără nume de client) se văd în FirstBill, la conexiunea respectivă.
Ce nu face integrarea
- Nu sincronizează stocul sau produsele între magazin și FirstBill; folosești importul de produse din CSV sau XLSX.
- Nu are conectori dedicați pentru platformele românești (Gomag, MerchantPro, ContentSpeed); folosești formatul FirstBill prin API-ul lor, dacă abonamentul include accesul.
- Plugin-urile de magazin (module instalabile) sunt în dezvoltare; până atunci, metodele de mai sus acoperă nevoia.
Câmpurile comenzii FirstBill
Comenzile se trimit ca JSON, la adresa webhook a conexiunii. Doar identificatorul comenzii, numele clientului și produsele sunt obligatorii.
| Câmp | Ce trimiți din platformă |
|---|---|
| externalId | Numărul sau ID-ul unic al comenzii. Aceeași valoare retrimisă nu emite o a doua factură. |
| customer.name | Denumirea firmei sau numele persoanei. |
| customer.cui | CUI-ul, dacă magazinul îl colectează (câmp personalizat la checkout). Fără CUI, clientul rămâne persoană fizică. |
| customer.address, city, county, email, phone | Datele de facturare. Județul poate fi numele sau codul (Vrancea sau VN). |
| lines[].name, quantity, unitPrice | Produsele. Prețul este fără TVA, sau cu TVA dacă pui priceIncludesVat true. |
| lines[].vatRate | Cota de TVA (21, 11 sau 0). Dacă lipsește, se folosește 21 pentru firmele plătitoare de TVA. |
| lines[].discount | Valoarea totală a reducerii liniei, în aceeași logică a prețului. |
| shipping.price | Costul transportului, trecut ca linie separată pe factură. |
| priceIncludesVat | true dacă prețurile din magazin includ TVA. |
| paid, paymentMethod | paid true înregistrează și încasarea. Metode: CARD_ONLINE, COD (ramburs), TRANSFER, CASH, CARD și altele. |
Întrebări frecvente
- Ce platforme de comerț electronic se pot integra cu FirstBill?
- WooCommerce și Shopify direct, prin webhook semnat. Wix, Weebly, Volusion, Squarespace, PrestaShop, OpenCart, MerchantPro, Magento, Jumpseller, Joomla, HubSpot, Gomag, Ecwid, Drupal, CS-Cart, ContentSpeed, BigCommerce și 3dcart prin formatul de comandă FirstBill, cu un instrument de automatizare sau cod propriu.
- Cât costă integrarea?
- Este inclusă în planul Pro, de 69 RON/lună fără TVA. Instrumentele de automatizare externe (Zapier, Make etc.) se taxează separat de furnizorii lor.
- Ce se întâmplă dacă platforma retrimite o comandă?
- FirstBill recunoaște comanda după identificator și nu emite a doua factură.
- Pot integra o platformă care nu este în listă?
- Da. Orice sistem care poate trimite un mesaj JSON la o adresă HTTP poate folosi formatul de comandă FirstBill.
- Se emite factura la plasarea comenzii sau la plată?
- Alegi tu, la fiecare conexiune: la plată (recomandat pentru plăți online) sau la plasarea comenzii.
- Funcționează cu e-Factura?
- Da. Factura emisă din comandă se transmite în SPV conform setărilor firmei, ca orice altă factură.
- Pot importa clienții și produsele din magazin?
- Da, din fișiere CSV sau XLSX, din Nomenclatoare → Import din alte programe.
Începe gratuit
Creează un cont și emite prima factură în câteva minute. Nu ai nevoie de card pentru planul gratuit.