Integrare Shopify cu FirstBill: facturi automate din comenzi
Actualizat la
Pe scurt
Shopify 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 Shopify – 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 Shopify
Shopify poate trimite comenzile la o adresă externă prin webhook-uri semnate. FirstBill înțelege direct formatul Shopify și verifică semnătura cu cheia de semnare afișată de Shopify.
| Metodă | Disponibilitate | Observații |
|---|---|---|
| Webhook direct Shopify → FirstBill | Disponibil | Semnătura HMAC-SHA256 din antetul X-Shopify-Hmac-Sha256 este verificată. |
| Zapier, Make, n8n | Posibil | Folosești formatul FirstBill, fără semnătură Shopify. |
| Aplicație personalizată | Posibil | Cu secretul clientului aplicației pe post de cheie de semnare. |
Cum conectezi Shopify la FirstBill, pas cu pas
- În Shopify deschide Setări → Notificări și derulează până la secțiunea „Webhook-uri”. Copiază cheia de semnare afișată acolo (la webhook-urile create de aplicații personalizate se folosește secretul clientului aplicației).
- În FirstBill: Configurare → Magazine online, alege Shopify, lipește cheia de semnare și apasă „Creează conexiunea”. Copiază adresa webhook.
- Înapoi în Shopify, la „Webhook-uri”, apasă „Creează webhook”.
- Eveniment: „Plata comenzii” (recomandat) sau „Crearea comenzii”. Format: JSON. URL: adresa webhook din FirstBill. Alege versiunea API stabilă cea mai recentă.
- Salvează. Nu folosi „Trimite notificare de test” pe firma reală: ar emite o factură din datele de probă.
- Plasează o comandă de probă și verifică factura în Vânzări → Facturi emise.
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 Shopify
- Shopify nu are un câmp CUI nativ. FirstBill citește CUI-ul din atributele comenzii (note_attributes) al căror nume conține cui, cif sau cod fiscal, sau folosește câmpul „Companie” din adresa de facturare ca denumire.
- Cotele de TVA se iau din liniile de taxă ale comenzii. Dacă prețurile includ taxe (setarea magazinului), FirstBill scade TVA-ul din preț.
- Comenzile anulate, anulate la plată sau rambursate se ignoră.
- Plățile „cash on delivery” se înregistrează ca ramburs, cele manuale ca transfer, iar celelalte ca plăți online cu cardul.
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
- De unde iau cheia de semnare Shopify?
- Din Shopify, la Setări → Notificări, în secțiunea Webhook-uri, unde este afișată cheia cu care sunt semnate webhook-urile magazinului. Pentru webhook-urile unei aplicații personalizate, se folosește secretul clientului aplicației.
- Ce eveniment Shopify aleg?
- „Plata comenzii” (orders/paid), dacă vrei factura la plată; „Crearea comenzii” (orders/create) pentru factură la plasarea comenzii.
- Pot trimite testul din Shopify?
- Nu pe firma reală: testul trimite o comandă fictivă și FirstBill o tratează ca pe una adevărată. Folosește o comandă de probă sau o firmă de test.
- Pot emite automat facturi din comenzile Shopify?
- Da, în planul Pro. Fiecare comandă Shopify devine o factură în FirstBill, o singură dată, cu încasarea înregistrată dacă este plătită.
- Ce se întâmplă dacă Shopify 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.