Vudux Fiskalizacija - Korisničko uputstvo

1.Uvod

Vudux Fiskalizacija je WordPress/WooCommerce dodatak koji automatski fiskalizuje porudžbine vaše internet prodavnice preko Teron Cloud Middleware-a, u skladu sa srpskim propisima o eFiskalizaciji (SUF).

Za svaku porudžbinu plugin sam izdaje fiskalni račun i čuva njegove podatke (broj računa, verifikacioni link i žurnal - evidenciju koju izdaje fiskalni sistem) direktno na porudžbini.

Pored automatske fiskalizacije, iz WordPress administracije možete ručno da izdate kopiju računa, uradite refundaciju (punu ili delimičnu) ili storno - sve na istom mestu, bez odlaska u druge sisteme.

Šta vam je potrebno pre početka

• API key i serijski broj (SN) - dobijate ih od Vudux/Teron tima uz licencu.
• Bezbednosni element (sertifikat) - ZIP fajl, lozinka 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).
• WordPress sa aktivnim WooCommerce-om i HTTPS-om.

2.Instalacija plugina

1. U WordPress adminu otvorite Dodaci → Dodaj novi → Otpremi dodatak.
2. Izaberite ZIP fajl plugina koji ste dobili (npr. vudux-fiskalizacija-1.9.3.zip) i kliknite Postavi sada.
3. Nakon instalacije kliknite Aktiviraj.

Posle aktivacije, u levom meniju se pojavljuje nova stavka Vudux Fiskalizacija:

3.Korak 1 - Registracija licence

Otvorite Vudux Fiskalizacija u meniju. Traka napretka na vrhu vodi vas kroz 3 koraka podešavanja - prvi je registracija licence.

1. U polje API key unesite ključ koji ste dobili. Zbog bezbednosti, ova vrednost se neće prikazivati nakon čuvanja.
2. U polje SN / Serial number unesite serijski broj uređaja.
3. Izaberite jezik interfejsa (srpski ili engleski) i kliknite Sačuvaj podešavanja.
4. Kliknite Proveri licencu. Status u zaglavlju treba da postane Aktivna.

Dugme Ukloni licencu (ispod tabele) briše API key, SN i stanje licence sa sajta - koristi se npr. kad prelazite na novi SN. Fiskalni podaci vaših porudžbina ostaju netaknuti.

4.Korak 2 - VPFR podešavanje

U ovom koraku povezujete svoj bezbednosni element (sertifikat Poreske uprave) sa Teron virtuelnim procesorom fiskalnih računa.

1. Unesite lozinku sertifikata (Password).
2. Unesite PAC.
3. Izaberite ZIP sertifikat - fajl tačno onakav kakav ste dobili, bez raspakivanja.
4. Kliknite Podesi VPFR. Zelena poruka „VPFR je uspešno podešen" (HTTP 200) potvrđuje da je sve u redu.

Na istom tabu nalazi se i Provera dostupnosti - brz test da li je Teron servis dostupan za vaš API key i SN:

Dugme Resetuj VPFR status briše samo lokalno sačuvan rezultat ovog koraka, da biste mogli da ga ponovite ispočetka. Teronu se pri tome ništa ne šalje.

5.Korak 3 - WooCommerce podešavanja

Omogući WooCommerce fiskalizaciju

Ovo je glavni prekidač automatske fiskalizacije. Dok je isključen, porudžbine se ne fiskalizuju same - ali ručne akcije na porudžbini (fiskalizuj, kopija, refundacija) i dalje rade. Uključite ga tek kada završite podešavanja i uspešno fiskalizujete jednu probnu porudžbinu (poglavlje 6).

Trigger status

Ovde birate koji status porudžbine pokreće fiskalizaciju: Processing (odmah po plaćanju/prijemu) ili Completed (kad porudžbinu sami označite kao završenu). Za većinu prodavnica sa pouzećem preporučujemo Completed.

Default tax label (poreska oznaka)

Ovo je podrazumevana SUF poreska oznaka koja važi za sve vaše artikle: А 0% (niste u sistemu PDV-a), Ђ 20% (opšta stopa), Е 10% (posebna stopa), Г 0% (oslobođeno). Oznaka mora biti napisana ćirilicom - ako unesete nešto van ovog seta, Teron/SUF može da odbije zahtev.

Cashier (kasir)

Ime koje se ispisuje na fiskalnom računu kao kasir - najčešće ime radnje ili npr. „Webshop".

Include shipping (dostava)

Uključite obavezno ako vaša prodavnica naplaćuje dostavu kupcu - dostava je tada deo vašeg prometa i mora da bude na računu. Ostavite isključeno ako dostavu naplaćuje kurirska služba za svoj račun (kurir tada sam izdaje svoj fiskalni račun za dostavu).

Include fees (naknade)

Dodatne naknade koje sami naplaćujete kupcu (doplata za pouzeće, pakovanje...) deo su vašeg prometa i treba da budu na računu - preporučujemo da ovo bude uključeno.

Automatska identifikacija kupca

Ovo polje koristite samo ako na vašoj korpi (checkout) postoji dodatno polje u koje kupac sam unosi PIB ili drugi identifikacioni broj. Upišite interni naziv tog polja (tzv. meta ključ, npr. _billing_pib) i izaberite tip identifikacije - plugin će taj podatak sam stavljati na fiskalni račun. Više detalja u poglavlju 10.

Način plaćanja na fiskalnom računu

Zakon zahteva da na fiskalnom računu piše kako je kupac platio (gotovina, kartica, virman...). Vaša prodavnica interno koristi svoje nazive za način plaćanja (npr. „pouzeće", „WooPayments", „bankovni transfer"), a Teron/Poreska uprava prihvata samo tačno određene tipove. Ovim mapiranjem povezujete jedno sa drugim: za svaki svoj način plaćanja birate kako da ga prikažete na računu.

Kako dodajete mapiranje:

1. U levom meniju izaberite način plaćanja iz vaše prodavnice (lista je već popunjena vašim stvarnim načinima plaćanja).
2. U desnom meniju izaberite odgovarajući fiskalni tip (tabela ispod).
3. Kliknite + Dodaj mapiranje ako želite da podesite i sledeći način plaćanja.

Koji fiskalni tip da izaberete?

Red „Svi ostali (podrazumevano)"

Prvi red u listi je poseban - on važi za svaki način plaćanja koji niste posebno podesili. Zahvaljujući ovome ne morate ručno da mapirate baš svaki gateway: podesite one najčešće, a za sve ostale ostavite razuman podrazumevani tip. Za „Svi ostali" preporučujemo Card, jer je većina online plaćanja kartična.

Kad završite, kliknite Sačuvaj podešavanja.

6.Provera pre početka rada

Kad su sva tri koraka završena, traka napretka pokazuje 100% i zelenu potvrdu:

Statusi u zaglavlju u svakom trenutku vam pokazuju stanje sistema:

Pre nego što uključite automatski rad, proverite da sve zaista radi:

1. Napravite probnu porudžbinu i prebacite je u izabrani trigger status (ili je fiskalizujte ručno iz porudžbine).
2. Proverite da je račun dobio broj i verifikacioni link (poglavlje 8).
3. Tek onda uključite „Omogući WooCommerce fiskalizaciju" za automatski rad.

Tab Dijagnostika & pomoć sadrži go-live pregled, zdravlje sistema (licenca, Teron, red za obradu) i ovo uputstvo, tako da uvek možete brzo da proverite stanje.

7.Fiskalizacija porudžbina

Kad je automatska fiskalizacija uključena, svaka porudžbina koja pređe u izabrani status automatski dobija fiskalni račun, u pozadini - bez ikakve vaše akcije. Ako Teron trenutno nije dostupan (tehnička smetnja), plugin sam ponavlja slanje u razmacima, bez vaše intervencije i bez rizika od duplih računa.

Rezultat se upisuje direktno na porudžbinu: broj računa, vreme, brojač, verifikacioni link i žurnal. Ovako izgleda izdat fiskalni račun:

8.Pregled fiskalnih računa

Podmeni Vudux Fiskalizacija → Računi prikazuje sve fiskalizovane porudžbine: status, broj računa, iznos, tip (račun / kopija / refundacija), verifikacioni link i vreme izdavanja. Listu možete filtrirati po statusu.

Klik na Otvori u koloni Verifikacija otvara zvaničnu proveru računa na sajtu Poreske uprave. Na glavnoj strani plugina nalazi se i brza statistika: koliko je fiskalizovano danas, koliko ukupno i koliko ima grešaka.

9.Kopija, refundacija i storno

Na stranici svake porudžbine (desna kolona) nalazi se Vudux Fiskalizacija panel sa sledećim akcijama:

10.Kad kupac traži račun sa PIB-om

Kad pravno lice traži račun sa svojim PIB-om (tzv. „ИД купца"), plugin ga uključuje na fiskalni račun u obliku TIP:BROJ (npr. 10:123456789 za PIB). Podržani su svi SUF tipovi identifikacije - PIB, JMBG, lična karta, pasoš i drugi.

Tri načina da unesete PIB

1. Sa korpe, automatski: ako vaša tema/checkout ima polje za PIB, povežite ga u podešavanjima (poglavlje 5, „Automatska identifikacija kupca"). Kupac tada sam unosi PIB pri kupovini i on završava na računu.
2. Ručno na porudžbini: u Vudux panelu porudžbine izaberite tip, unesite broj i kliknite „Sačuvaj identifikaciju kupca" - pre nego što porudžbina bude fiskalizovana. Ručni unos uvek ima prednost nad automatskim.
3. Zapamćeno na nalogu kupca: pri ručnom unosu možete štiklirati „Zapamti na nalogu kupca". Identifikator se tada automatski popunjava na svim budućim porudžbinama tog registrovanog kupca.

Rezultat vidite na primeru računa iz poglavlja 7: red „ИД купца: 10:123456789" na fiskalnom računu.

11.Ažuriranja plugina

Plugin ima ugrađeno automatsko ažuriranje - nove verzije stižu direktno sa Vudux servera, kroz standardni WordPress mehanizam:

1. Kad je dostupna nova verzija, obaveštenje se pojavljuje na strani Dodaci i u Kontrolna tabla → Ažuriranja.
2. Kliknite Update now / Ažuriraj sada - WordPress sam preuzima i instalira novu verziju. Sva vaša podešavanja i fiskalni podaci ostaju netaknuti.

12.Rešavanje problema

Ako problem i dalje postoji, pošaljite nam broj porudžbine, kratak opis i poruku o grešci - podaci za kontakt su ispod.

13.Logovanje i dijagnostika (napredno)

Ovo poglavlje je namenjeno naprednim korisnicima i situacijama kad podrška traži dodatne podatke - u svakodnevnom radu vam ništa od ovoga ne treba, jer plugin sam beleži rezultat svake fiskalizacije na porudžbini. Slobodno preskočite ovo poglavlje ako ne rešavate konkretan problem.

Logovanje se pali i gasi preko konstanti u fajlu wp-config.php vašeg sajta. Postoje tri nezavisna prekidača i sva tri su podrazumevano isključena - ne morate ništa da dodajete da bi ostali isključeni; dodajete ih samo ako želite neki od njih da uključite.

Kako se uključuje

U wp-config.php, iznad linije /* That's all, stop editing! */, dodajte željene linije:

• Za dijagnostiku jedne porudžbine:
  define( 'VUDUX_FISKALIZACIJA_DEBUG', true );
• Za centralni log u Dijagnostici (obe linije zajedno):
  define( 'VUDUX_FISKALIZACIJA_ENABLE_INTEGRATION_LOGS', true );
define( 'VUDUX_FISKALIZACIJA_SHOW_INTEGRATION_LOGS', true );

Da isključite logovanje, obrišite te linije ili im vrednost promenite u false.

14.Vudux Portal (opciono)

Vudux Portal je poseban veb pregled na adresi portal.duxvu.com 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.

Čemu služi

Umesto da statistiku sklapate ručno, portal vam na jednom ekranu pokazuje:

• Broj izdatih i neuspešnih računa za izabrani period (danas, 7 dana, mesec...).
• Promet - ukupan i prosečnu vrednost računa.
• Kupovine sa PIB-om (pravna lica) naspram kupovina bez PIB-a (fizička lica).
• Najprodavanije proizvode po količini i po prometu.
• Načine plaćanja i raspored prodaje po danima i satima.
• Zdravlje sistema - status licence, verziju plugina i da li se prodavnica redovno javlja.

Gde se nalazi u pluginu

U levom meniju, ispod Vudux Fiskalizacija, nalazi se stavka Portal:

Kako se povezujete (registracija)

Povezivanje je jednokratno i traje minut. Klik na Portal otvara ovu stranicu:

1. Zatražite token za povezivanje od Vudux podrške (kontakt na dnu ovog uputstva). Token je jedinstveni ključ vaše prodavnice.
2. Nalepite ga u polje Token za povezivanje.
3. Ostavite štiklirane opcije slanja (podrazumevano su sve uključene) i kliknite Poveži Portal.
4. Status na vrhu se menja iz Nije povezan u Povezan. Od tog trenutka prodavnica u pozadini šalje anonimnu statistiku portalu.
5. Za prijavu na sam portal (portal.duxvu.com) dobijate od Vudux podrške email sa linkom na kom postavljate svoju lozinku. Posle toga se prijavljujete svojom email adresom i lozinkom.

Šta znače opcije (kvačice)

Ako se kasnije predomislite, dovoljno je da isključite kvačice i sačuvate - slanje portalu prestaje, a fiskalizacija nastavlja da radi normalno.

15.Podrška

Tu smo za sva pitanja oko instalacije, podešavanja i rada Vudux Fiskalizacije (Teron).

Za brži odgovor, uz poruku nam pošaljite: naziv sajta, verziju plugina (piše u zaglavlju plugin strane) i broj porudžbine na koju se problem odnosi.