Spajate vaš WooCommerce webshop s FIRA-om kako bi se automatski mogli generirati ponude, računi ili fiskalni računi kada stigne narudžba ili kada u Shopify označite da je narudžba završena.
Pogledajte naš video tutorial kako spojiti WooCommerce s FIRA-om.
FIRA webshop postavke
1. Opće postavke
Vašu webshop domenu treba kopirati, uključujući "https://" na početku i bez završne "/" na kraju.
Tajni ključ sami određujete — može biti bilo koja kombinacija slova, brojeva i/ili znakova — i spremite ga u FIRA-i i u WooCommerce webhooku za FIRA-u (WooCommerce > Settings > Advanced > Webhooks).
Ako želite preuzeti, uz naziv proizvoda, i opis proizvoda iz WooCommerce-a, označite opciju "Uključiti opis proizvoda u webshop račune". Imajte na umu da uz opis u većini slučajeva mogu stići i meta podaci koji su nečitljivi. Ako to primijetite tijekom testiranja, potrebno je ponovno deaktivirati ovu opciju.
Pogledajte naš video tutorial za postavljanje webhooka.
2. Postavke broja računa
Webshop ponude u FIRA-i generiraju se isključivo s rednim brojem. Ako je posljednja ponuda, primjerice, broj 43, sljedeća koja se generira na temelju webshop narudžbe bit će 44.
Format transakcijskih i fiskalnih računa možete sami definirati, poslovni prostor i naplatni uređaj možete za webshop račun odvojeno odrediti.. Račun ili fiskalni račun generirat će se prema tom formatu.
Napomena: Fiskalne račune možete generirati samo ako je pod postavkama — Fiskalizacija — učitan vaš fiskalni certifikat te su popunjene sve potrebne informacije.
3. Postavke načina plaćanja
U WooCommerce-u postavite jedan webhook s temom (Topic) "Order updated". Preko tog webhooka, FIRA će preuzeti informacije za dva događaja:
- Order creation — kada kupac napravi narudžbu.
- Order fulfillment — kada vi promijenite status narudžbe u "fulfilled" (završeno).
Za svaki događaj možete definirati koji dokument želite da FIRA generira, ovisno o načinu plaćanja te narudžbe.
Također možete odrediti hoće li se generirani dokument automatski slati na e-mail kupca i želite li da se na ponudama i računima prikaže QR kod za brzo plaćanje.
Primjer: Na vašem webshopu nudite načine plaćanja: PayPal, bankovni transfer i kartično plaćanje (primjer kao na slici pod 3.).
-
Ako kupac plaća karticom, želite da se fiskalni račun odmah generira kod 1. Order creation → dodajte "Card" u matricu kod Order creation i Fiskalni račun (Kartica).
-
Ako kupac plaća PayPal-om, želite da se račun odmah generira kod 1. Order creation → dodajte "PayPal" u matricu kod Order creation i Račun.
-
Ako kupac plaća bankovnim transferom, želite da se ponuda generira uz QR kod za brzo plaćanje kod 1. Order creation i automatski pošalje kupcu e-mailom → dodajte "Bank deposit" u matricu kod Order creation i Ponuda.
-
Nakon uplate na transakcijski račun, želite da se račun generira kod 2. Order fulfillment → dodajte "Bank deposit" u matricu kod Order fulfillment i Račun.
Važne napomene
Način plaćanje
Postoje razni načini plaćanja (Stripe, CorvusPay, itd.) koji se mogu integrirati u WooCommerce. Ako se pojavi narudžba s načinom plaćanja koji niste unaprijed mapirali (3. postavke načina plaćanja), FIRA će automatski generirati ponudu i obavijestiti vas da je prepoznat novi način plaćanja.
Tada je potrebno mapiranje tog načina plaćanja — npr. za "Stripe" postavite kod 1. Order creation → Fiskalni račun (Kartica), kako bi FIRA kod sljedeće narudžbe mogla generirati fisklani račun.
Testiranje
Prije nego što pustite integraciju u rad, važno je provjeriti generiraju li se vaši računi ili ponude ispravno.
Preporučujemo da tijekom testiranja u matrici postavite generiranje isključivo ponuda, kako biste izbjegli potrebu za storniranjem računa ili fiskalnih računa u testnoj fazi.
FIRA WooCommerce integracija uspješno radi sa standardnim postavkama bez dodatnih plugina. Također je uspješno testirana s određenim brojem plugina, no zbog velikog broja dostupnih dodataka, nije moguće jamčiti kompatibilnost u svim kombinacijama.
Plugins
Postoji jako veliki broj raznih pluginova koji se mogu dodatno instalirati u Wordpress za WooCommerce. Pluginovi mogu utjecati na proizvode, cijene ili popuste, a nažalost mogu promijeniti i standardni set podataka koji WooCommerce šalje putem webhooka FIRA-i, zbog čega se ponuda ili račun možda neće moći ispravno ili uopće generirati u FIRA-i.
Zato je izuzetno važno temeljito testirati inicijalnu integraciju, kao i svaku promjenu posebno nakon dodavanja novog plugina.
Bruto i neto cijena proizvoda
FIRA izračunava cijenu proizvoda i ukupnu cijenu na temelju neto principa. Na ukupno neto cijenu proizvoda (osnovica za PDV) dodaje se PDV kako bi se dobila ukupna bruto cijena. Webshopovi obično rade na bruto principu i šalju preko webhooka bruto cijene, uključujući PDV.
Kako bi se takva bruto cijena ispravno preračunala u neto cijenu, potrebno je koristiti tri decimale neto cijene proizvoda, jer inače postoji mogućnost razlike u cijeni zbog zaokruživanja.
PDV i bez PDV-a
Ako ste u FIRA-i označili da je vaš poslovni subjekt u sustavu PDV-a, bitno je da cijena vaših proizvoda u WooCommerce-u također uključuje PDV, što se može odrediti u "Settings" > "Tax" > "Yes, I will enter prices inclusive of tax".
Ako vaš poslovni subjekt nije u PDV-u, tada cijene u WooCommerce-u moraju biti bez PDV-a.
Dostava i popust
Cijena dostave ili popusti na određeni proizvod ili ukupnu narudžbu prikazuju se u FIRA-i kao zasebna stavka na računu.
Obratite pažnju da ako ste u sustavu PDV-a, cijena za dostavu također mora sadržavati PDV, jer će se u suprotnom prikazivati na ponudi ili računu sa 0% PDV-a.
B2B račun
Ako želite omogućiti B2B prodaju – tj. prodaju drugim tvrtkama putem vašeg webshopa – potrebno je u WooCommerce checkout formu dodati:
-
Polje za naziv tvrtke (billing_company)
-
Polje za unos OIB-a, koje možete postaviti tako da iskoristite postojeće "billing_address_2" polje i preimenujete ga u "OIB"
Na taj način, FIRA će automatski preuzeti ove dodatne podatke (naziv tvrtke i OIB) prilikom generiranja ponude ili računa temeljenog na webshop narudžbi.
Webhook HMAC-SHA256 verfification failed pogreška
Ako Vam se dogodio ovaj error vjerojatno imate neki plugin koji mjenja sadržaj API-ja nakon potpisa sa wordpress strane. Najčešće se radi o TranslatePress pluginu. Morate excludati woocommerce iz prijevoda.
Gettext niz ostavite prazno, a Domena: woocommerce
