1.Uvod
Vudux Fiskalizacija za Shopify je aplikacija koja automatski fiskalizuje porudžbine vaše Shopify prodavnice preko Teron Cloud Middleware-a, u skladu sa srpskim propisima o eFiskalizaciji (SUF).
Čim je porudžbina plaćena, aplikacija u pozadini sama izda fiskalni račun i sačuva njegove podatke (broj računa, verifikacioni link, žurnal - evidenciju koju izdaje fiskalni sistem). Vi ne morate ništa da radite ručno - sve se dešava automatski.
Za razliku od klasične kase, ovde je sve u vašoj Shopify administraciji: podešavanje, pregled izdatih računa i provera statusa - na jednom mestu, bez odlaska u druge sisteme.
Šta vam je potrebno pre početka
- Serijski broj (SN) i Teron API key - dobijate ih od Vudux/Teron tima uz licencu.
- Bezbednosni element (sertifikat) - ZIP fajl, lozinka sertifikata i PAC (šifra koju dobijate uz sertifikat), koje ste dobili od Poreske uprave za virtuelni procesor fiskalnih računa (VPFR - servis Poreske uprave koji obrađuje vaše fiskalne račune).
- Shopify prodavnica u koju je aplikacija instalirana.
2.Instalacija aplikacije
Aplikaciju vam instalira Vudux tim ili je instalirate preko linka koji dobijete. Posle instalacije, u Shopify adminu se u levom meniju, pod Apps, pojavljuje Vudux Fiskalizacija.
- U Shopify adminu otvorite Apps → Vudux Fiskalizacija.
- Prilikom prvog otvaranja Shopify traži da odobrite pristup porudžbinama (dozvola
read_orders) - to je neophodno da bi aplikacija znala kada je porudžbina plaćena. Kliknite Install / Instaliraj. - Otvara se ekran Pregled (poglavlje 3), odakle krećete u podešavanje.
3.Ekran „Pregled"
Pregled je početni ekran aplikacije. Na jednom mestu pokazuje da li je sve spremno za rad. Na vrhu su tri dugmeta: Pregled, Računi i Podešavanja - njima se krećete kroz aplikaciju.

Šest statusnih kartica pokazuje stanje svakog dela sistema:
| Kartica | Šta znači |
|---|---|
| Status aplikacije | Da li je aplikacija instalirana i koje dozvole ima (npr. read_orders). |
| Fiskalizacija | Da li je automatska fiskalizacija uključena i da li je Shopify „webhook" (obaveštenje o plaćenoj porudžbini) aktivan. |
| Licenca | Da li je licenca proverena i aktivna. |
| Teron konekcija | Da li aplikacija uspešno komunicira sa Teron servisom. |
| VPFR setup | Da li je bezbednosni element (sertifikat) uspešno podešen. |
| Poslednji fiskalni račun | Kada je izdat poslednji račun (ili poruka da još nema poslatih računa). |
Ispod kartica su tri dugmeta: Teron podešavanja (vodi na ekran za podešavanje), Fiskalni računi (lista izdatih računa) i Proveri licencu i Teron konekciju (brza provera da li su licenca i veza sa Teronom u redu).
4.Korak 1 - Licenca
Kliknite Podešavanja u vrhu aplikacije. Podešavanje je podeljeno u 4 koraka (taba): 1 Licenca, 2 Teron i sertifikat, 3 Pravila računa i 4 Napredno. Prolazite ih redom. Na vrhu su iste statusne kartice kao na Pregledu, da uvek vidite dokle ste stigli.

- U polje Serijski broj (SN) unesite serijski broj koji ste dobili uz aplikaciju.
- Štiklirajte Uključi fiskalizaciju. Dok je ovo isključeno, plaćene porudžbine se ne šalju na Teron.
- Kliknite Proveri licencu. Time se unos sačuva, proveri licenca i veza sa Teronom, i aplikacija vas vodi na korak 2. Ovim dugmetom se ne izdaje nijedan račun - samo se proverava.
Kada je sve u redu, kartica Licenca postaje zelena i piše Aktivna sa datumom provere:

5.Korak 2 - Teron i sertifikat
U ovom koraku unosite podatke koje ste dobili od Terona i povezujete svoj bezbednosni element (sertifikat Poreske uprave) sa Teron virtuelnim procesorom fiskalnih računa.

- Unesite Teron API key.
- Unesite PAC.
- Unesite Lozinku sertifikata.
- Kod polja VPFR sertifikat kliknite Choose file i izaberite .zip fajl sertifikata - tačno onakav kakav ste dobili, bez raspakivanja (najviše 10MB).
- Kliknite Podesi VPFR. Zelena poruka „VPFR uspešno podešen (HTTP 200)" potvrđuje da je sve u redu, i aplikacija vas vodi na korak 3.
Ako želite da zamenite postojeći sertifikat, izaberite novi ZIP - novi upload zamenjuje stari. Kvačica Ukloni postojeći sertifikat briše trenutno sačuvan sertifikat (koristite je samo ako zaista želite da ga uklonite).
6.Korak 3 - Pravila računa
Ovde podešavate kako će izgledati vaši fiskalni računi: ko je kasir, koja je poreska stopa, kako se prikazuju načini plaćanja i šta ulazi u račun.

Ime kasira na računu
Ime koje se štampa na fiskalnom računu kao kasir - najčešće ime radnje ili npr. „Webshop".
Poreska oznaka (obavezno)
Podrazumevana SUF poreska oznaka koja važi za sve vaše artikle. Za većinu prodavnica to je Ђ (opšta stopa PDV 20%). Ostale: Е (10%), А (0%, van sistema PDV-a), Г (0%, oslobođeno). Oznaka se piše ćirilicom.
Načini plaćanja
Zakon zahteva da na fiskalnom računu piše kako je kupac platio. Vaša Shopify prodavnica interno koristi svoje nazive za plaćanje (npr. shopify_payments, cash_on_delivery, paypal), a Teron/Poreska uprava prihvata samo tačno određene tipove. Ovom tabelom povezujete jedno sa drugim: za svaki svoj način plaćanja (levo) birate kako da se prikaže na računu (desno).
Koji fiskalni tip da izaberete?
| Fiskalni tip | Kada se koristi |
|---|---|
| Cash (gotovina) | Plaćanje pouzećem (cash on delivery) ili gotovinom pri preuzimanju. |
| Card (kartica) | Sve online kartične naplate: Shopify Payments, Stripe, PayPal, kartica kuriru. |
| WireTransfer (virman) | Uplata na vaš račun u banci (bank deposit, plaćanje po predračunu). |
| Check (ček), Voucher (vaučer), MobileMoney, Other (drugo) | Retki slučajevi - koristite samo ako vam tačno odgovaraju. |
Kod svakog reda birate iz padajućeg menija desno. Opcija ne mapiraj znači da za taj red ništa niste posebno odredili (pa važi „Svi ostali" / rezervni tip).
Šta ulazi u račun
- Uključi dostavu u račun - uključite samo ako kupcu naplaćujete dostavu (tada je dostava deo vašeg prometa i mora da bude na računu). Podrazumevano je isključeno.
- Uključi popuste - cene na računu su umanjene za popuste iz porudžbine. Preporučeno uključeno.
- Različite poreske stope po proizvodu - uključite samo ako prodajete proizvode sa različitim stopama PDV-a (npr. hrana 10% i oprema 20%). Oznaka po proizvodu se upisuje na proizvodu u Shopify-u (metafield
vudux.tax_label); proizvodi bez oznake koriste opštu oznaku odozgo.
Kad završite, kliknite Sačuvaj pravila - aplikacija vas vodi na poslednji korak.
7.Korak 4 - Napredno
Poslednji korak je opcion - služi za PIB kupca, email obaveštenja, povezivanje sa Vudux Portalom i dijagnostiku. Za rad fiskalizacije nije nužan, ali je koristan.

PIB kupca na računu (opciono)
Ako kupuju i firme, na fiskalni račun može da se upiše PIB kupca. Shopify u standardnoj kupovini nema polje za PIB, pa ga kupac unosi u dodatno polje na korpi (dodaje se u temi prodavnice kao „cart attribute" ili preko aplikacije). U polje Naziv polja u korpi upišite tačno onako kako se to polje zove (npr. PIB). U Vrsta identifikacije izaberite tip - podrazumevano 10: PIB firme (najčešće). Ostavite prazno ako vam ovo ne treba. Link Napredno: više polja odjednom služi za ређe slučajeve sa više identifikatora.
Obaveštenja (opciono)
U polje Email za obaveštenja o računima upišite svoju email adresu ako želite da vam stiže poruka o tome da li je račun uspešno izdat. Ostavite prazno ako ne želite obaveštenja.
Vudux Portal (opciono)
Povežite prodavnicu sa svojim Vudux Portal nalogom da tamo pratite promet i račune. U Portalu otvorite Izvori, dodajte Shopify izvor i kopirajte kod za povezivanje ovde, u polje Kod za povezivanje iz Portala (počinje sa vpt_). Kvačica Odmah uključi slanje statistike je podrazumevano uključena; ako je isključite, veza se napravi ali se ništa ne šalje dok je ne uključite. Kliknite Poveži sa Portalom (ovim se ne izdaje račun). Detaljnije o Portalu je u poglavlju 12.
Dijagnostika (opciono)
Kvačica Detaljno beleženje za podršku uključuje detaljan zapis rada koji podrška može da zatraži kad rešavate problem. Uključite je samo ako vas podrška to zamoli, i isključite kad završite. Tajni podaci se nikad ne beleže.
Na kraju kliknite Sačuvaj podešavanja - čuva sve korake odjednom i ostajete na ovom koraku.
8.Provera pre početka rada
Kad su koraci 1 i 2 zeleni u pregledu kartica, fiskalizacija je tehnički spremna. Pre nego što se oslonite na automatski rad, proverite da sve zaista radi:
- Na ekranu Pregled kliknite Proveri licencu i Teron konekciju - kartice Licenca i Teron konekcija treba da postanu zelene.
- Napravite probnu porudžbinu i platite je (ili je označite kao plaćenu), pa proverite da je dobila fiskalni račun sa brojem i verifikacionim linkom (poglavlje 10).
- Tek onda se oslonite na automatski rad za sve buduće porudžbine.
9.Fiskalizacija porudžbina
Kad je fiskalizacija uključena, svaka plaćena Shopify porudžbina automatski dobija fiskalni račun, u pozadini - bez ikakve vaše akcije. Shopify obavesti aplikaciju čim je porudžbina plaćena („webhook"), a aplikacija tada izda račun preko Terona.
Ako Teron trenutno nije dostupan (tehnička smetnja), aplikacija sama ponavlja slanje u razmacima, bez vaše intervencije i bez rizika od duplih računa. Ovako izgleda izdat fiskalni račun:

10.Pregled fiskalnih računa
Dugme Računi u vrhu aplikacije (ili Fiskalni računi / Lista fiskalnih računa) otvara listu svih fiskalizovanih porudžbina: status, broj računa, iznos, tip (račun / kopija / refundacija), verifikacioni link i vreme izdavanja.
Svaki račun ima svoj status:
| Status | Šta znači |
|---|---|
| Uspešno (success) | Račun je izdat i ima broj i verifikacioni link. |
| U obradi (sending / processing) | Račun se upravo šalje ili čeka na red. |
| Greška (error) | Slanje nije uspelo - uz status stoji kratka poruka. Aplikacija po pravilu sama ponavlja pokušaj kod tehničkih smetnji. |
Klik na verifikacioni link otvara zvaničnu proveru računa na sajtu Poreske uprave (suf.purs.gov.rs). Isti podatak nosi i QR kod na samom fiskalnom isečku.
11.Kad kupac traži račun sa PIB-om
Kad pravno lice traži račun sa svojim PIB-om (na računu se prikazuje kao „ИД купца"), aplikacija ga uključuje na fiskalni račun u obliku TIP:BROJ (npr. 10:123456789 za PIB firme). Podržani su i drugi SUF tipovi identifikacije.
Pošto Shopify u standardnoj kupovini nema polje za PIB, kupac ga unosi u dodatno polje na korpi. Da bi taj podatak sam stigao na račun:
- U temi prodavnice (ili preko aplikacije) dodajte na korpu polje u koje kupac upisuje PIB - Shopify ga čuva kao „cart attribute".
- U aplikaciji, u koraku 4 „Napredno", u polje Naziv polja u korpi upišite tačno isti naziv tog polja i izaberite Vrstu identifikacije (najčešće „10: PIB firme").
- Od tada, kad kupac unese PIB pri kupovini, on automatski završava na fiskalnom računu.
Rezultat vidite na primeru računa iz poglavlja 9: red „ИД купца" na fiskalnom računu.
12.Vudux Portal (opciono)
Vudux Portal je poseban veb pregled na kome vlasnik prodavnice na jednom mestu prati kako radi fiskalizacija i sama prodavnica - broj izdatih računa, promet, koliko je kupovina bilo sa PIB-om, najprodavanije proizvode i zdravlje sistema - i dobija email obaveštenja kad nešto krene loše.
Kako se povezujete
- U Vudux Portalu otvorite Izvori i dodajte novi Shopify izvor za ovu prodavnicu.
- Portal vam da jednokratni kod za povezivanje (počinje sa
vpt_). Kopirajte ga. - U aplikaciji otvorite Podešavanja → korak 4 „Napredno", nalepite kod u polje Kod za povezivanje iz Portala, ostavite štikliranu opciju slanja i kliknite Poveži sa Portalom.
- Za prijavu na sam portal dobijate od Vudux podrške email sa linkom na kome postavljate svoju lozinku, pa se dalje prijavljujete email adresom i lozinkom.
Ako se predomislite, u koraku 4 isključite slanje statistike i sačuvajte - slanje prestaje, a fiskalizacija nastavlja da radi normalno.
13.Rešavanje problema
| Problem | Šta proveriti |
|---|---|
| Licenca „Nije proverena" / „Neaktivna" | Da li je SN tačno unet (bez razmaka)? Kliknite „Proveri licencu". Ako je licenca istekla, javite se podršci. |
| Kartica „Fiskalizacija" nije uključena | U koraku 1 štiklirajte „Uključi fiskalizaciju" i sačuvajte. Bez toga plaćene porudžbine se ne šalju na Teron. |
| VPFR podešavanje javlja grešku | Proverite API key, PAC i lozinku sertifikata. ZIP mora biti originalan fajl Poreske uprave, bez raspakivanja i ponovnog pakovanja, do 10MB. |
| Poruka da poreska oznaka nedostaje | U koraku 3 unesite poresku oznaku (Ђ/Е/А/Г). Dok nije izabrana, računi se ne šalju. |
| Porudžbina nije fiskalizovana | Da li je porudžbina zaista plaćena? Da li je fiskalizacija uključena i licenca aktivna? Pogledajte status računa na listi „Računi" - kod greške stoji kratko objašnjenje. |
| Pogrešan način plaćanja na računu | U koraku 3, u tabeli „Načini plaćanja", podesite mapiranje za taj način plaćanja (ili promenite „Svi ostali" / rezervni tip). |
| Teron konekcija „Nije proverena" | Na ekranu „Pregled" kliknite „Proveri licencu i Teron konekciju". |
Ako problem i dalje postoji, pošaljite nam naziv prodavnice, broj porudžbine i kratak opis - podaci za kontakt su ispod.
14.Podrška
Tu smo za sva pitanja oko instalacije, podešavanja i rada Vudux Fiskalizacije za Shopify.
Za brži odgovor, uz poruku nam pošaljite: naziv Shopify prodavnice i broj porudžbine na koju se problem odnosi.