Vudux logo

Vudux Fiskalizacija za Shopify - Korisničko uputstvo

Fiskalizacija Shopify porudžbina preko Teron Cloud Middleware-a

Shopify aplikacija

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.
Kako radiPre svakog slanja računa aplikacija proverava vašu licencu. Sama fiskalizacija ide preko Teron servisa - aplikacija nikad ne komunicira direktno sa Poreskom upravom.

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.

  1. U Shopify adminu otvorite Apps → Vudux Fiskalizacija.
  2. 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.
  3. Otvara se ekran Pregled (poglavlje 3), odakle krećete u podešavanje.
Jedna aplikacija = jedna prodavnicaSvaka Shopify prodavnica ima svoju instalaciju i svoja podešavanja. Ako imate više prodavnica, svaku podešavate posebno.

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.

Ekran Pregled sa statusnim karticama i dugmadima
Ekran „Pregled" - stanje sistema na prvi pogled

Šest statusnih kartica pokazuje stanje svakog dela sistema:

KarticaŠta znači
Status aplikacijeDa li je aplikacija instalirana i koje dozvole ima (npr. read_orders).
FiskalizacijaDa li je automatska fiskalizacija uključena i da li je Shopify „webhook" (obaveštenje o plaćenoj porudžbini) aktivan.
LicencaDa li je licenca proverena i aktivna.
Teron konekcijaDa li aplikacija uspešno komunicira sa Teron servisom.
VPFR setupDa li je bezbednosni element (sertifikat) uspešno podešen.
Poslednji fiskalni računKada 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).

Boje tačkicaZelena tačka znači da je taj deo u redu, žuta da još nešto treba podesiti, a crvena da nešto nedostaje ili nije uneto. Cilj je da ključne kartice budu zelene.

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.

Tab Licenca pre unosa - sve kartice crvene
Korak 1 „Licenca" - na početku su statusi crveni jer još ništa nije uneto
  1. U polje Serijski broj (SN) unesite serijski broj koji ste dobili uz aplikaciju.
  2. Štiklirajte Uključi fiskalizaciju. Dok je ovo isključeno, plaćene porudžbine se ne šalju na Teron.
  3. 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:

Tab Licenca sa unetim SN i aktivnom licencom
Licenca aktivna - poruka vas usmerava na sledeći korak
Bez aktivne licence nema fiskalizacijeAplikacija ne šalje nijedan zahtev ka Teronu dok licenca nije aktivna. Ako status ostane „Nije proverena" ili „Neaktivna", proverite da li je SN tačno unet (bez razmaka) ili se javite podršci (poglavlje 14).
Opasna zona (na dnu svakog koraka)Dugme Resetuj VPFR status briše samo lokalno sačuvan rezultat VPFR koraka. Dugme Totalni reset briše sve - licencu, kredencijale, sertifikat i pravila. Koristite ih samo ako želite da krenete ispočetka. Teronu se pri tome ništa ne šalje, a fiskalni računi koji su već izdati ostaju netaknuti.

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.

Tab Teron i sertifikat - API key, PAC, lozinka i ZIP sertifikat
Korak 2 „Teron i sertifikat"
  1. Unesite Teron API key.
  2. Unesite PAC.
  3. Unesite Lozinku sertifikata.
  4. Kod polja VPFR sertifikat kliknite Choose file i izaberite .zip fajl sertifikata - tačno onakav kakav ste dobili, bez raspakivanja (najviše 10MB).
  5. 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.
Vaši tajni podaci su zaštićeniSve osetljive vrednosti (API key, PAC, lozinka) čuvaju se šifrovano. Kad su već sačuvane, u polju piše „(sačuvano)" - tada polje možete ostaviti prazno da biste zadržali postojeću vrednost, a popunjavate ga samo ako želite da je promenite.

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).

Kartice postaju zelenePosle uspešnog koraka 2, kartice Teron API key, VPFR sertifikat i VPFR setup postaju zelene. Kartica Teron veza se potvrđuje kad kliknete „Proveri licencu i Teron konekciju" na Pregledu.

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.

Tab Pravila računa - kasir, poreska oznaka, načini plaćanja i šta ulazi u račun
Korak 3 „Pravila računa"

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.

Dok oznaka nije izabrana, računi se ne šaljuPoreska oznaka je obavezna. Ako je ne unesete, aplikacija neće slati račune i dobićete jasnu poruku da oznaka nedostaje.

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).

Aplikacija je već pametnaZa svaki način plaćanja ispod naziva piše preporuka (npr. „preporuka: Card"). Ako se sa njom slažete, ne morate ništa da menjate. Podešavajte samo one koje želite drugačije. Za sve što niste posebno podesili, važi red Svi ostali, a ako ni tu ništa ne odlučite, koristi se Rezervni tip na dnu.

Koji fiskalni tip da izaberete?

Fiskalni tipKada 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.

Tab Napredno - PIB kupca, obaveštenja, Vudux Portal i dijagnostika
Korak 4 „Napredno"

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:

  1. Na ekranu Pregled kliknite Proveri licencu i Teron konekciju - kartice Licenca i Teron konekcija treba da postanu zelene.
  2. 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).
  3. Tek onda se oslonite na automatski rad za sve buduće porudžbine.
PodsetnikFiskalizacija radi samo dok je u koraku 1 uključena kvačica „Uključi fiskalizaciju" i dok je licenca aktivna. Ova dva uslova su srce sistema.

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:

Primer fiskalnog računa sa QR kodom
Fiskalni isečak sa QR kodom za proveru na suf.purs.gov.rs
Zaštita od duplih računaIsta porudžbina se nikad ne fiskalizuje dvaput kao običan (Normal) račun - aplikacija to sprečava čak i ako Shopify pošalje isto obaveštenje više puta.

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:

  1. U temi prodavnice (ili preko aplikacije) dodajte na korpu polje u koje kupac upisuje PIB - Shopify ga čuva kao „cart attribute".
  2. 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").
  3. 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.

Ako nemate takvo poljeOstavite „Naziv polja u korpi" prazno - tada svi računi idu bez PIB-a (kao za fizička lica), što je i najčešći slučaj.

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.

Portal je potpuno opcionFiskalizacija radi identično i bez portala. Portal ništa ne menja u aplikaciji, ništa ne šalje Poreskoj upravi niti Teronu i ne dira vašu licencu - on samo prikazuje statistiku.

Kako se povezujete

  1. U Vudux Portalu otvorite Izvori i dodajte novi Shopify izvor za ovu prodavnicu.
  2. Portal vam da jednokratni kod za povezivanje (počinje sa vpt_). Kopirajte ga.
  3. 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.
  4. 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.
Privatnost je zaštićenaPortal nikada ne dobija ime, email, telefon, adresu, PIB/JMBG kupca, vaš API ključ niti kompletan fiskalni odgovor. Šalju se samo brojke i status (iznos računa, da li je kupovina bila sa PIB-om, naziv proizvoda i količina) - nikad ko je kupac.

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čenaU 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škuProverite API key, PAC i lozinku sertifikata. ZIP mora biti originalan fajl Poreske uprave, bez raspakivanja i ponovnog pakovanja, do 10MB.
Poruka da poreska oznaka nedostajeU koraku 3 unesite poresku oznaku (Ђ/Е/А/Г). Dok nije izabrana, računi se ne šalju.
Porudžbina nije fiskalizovanaDa 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čunuU 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.

Pišite nam - odgovaramo brzo:

kontakt@duxvu.com

✉ Pošalji email podršci

Za brži odgovor, uz poruku nam pošaljite: naziv Shopify prodavnice i broj porudžbine na koju se problem odnosi.