~

Uputstvo za konfiguraciju servisa za fiskalizaciju - WooCommerce

💡 Možete testirati ovu funkcionalnost besplatno ukoliko imate naš NestPay redirect plugin u demo režimu upotrebom DEMO PIB-a 000000000. Ovo vam omogućava da se uhodate sa sistemom i proverite sve funkcionalnosti pre nego što pređete na produkciju sa stvarnim PIB-om.

ℹ️ Važna napomena: Razlika između fiskalnog servisa za online fiskalizaciju i fiskalne kase ESIR

Fiskalni servis za online fiskalizaciju NIJE isto što i fiskalna kasa ESIR.

✅ Značajne prednosti fiskalnog servisa za online fiskalizaciju

Sprečavanje grešaka i rad u online okruženju su značajne prednosti ovog servisa:

Ovaj servis omogućava integraciju WooCommerce prodavnice sa sistemom za fiskalizaciju (ESIR/VPFR) u Republici Srbiji.

Fiskalni servis se povezuje na WooCommerce sajt preko našeg standardnog redirect NestPay plugina. Plugin se isporučuje u sklopu modula za plaćanje, ali podržava fiskalizaciju za sve metode plaćanja na sajtu, bez obzira da li se koristi nase kartično plaćanje za samu naplatu. Naše kartično plačanje čak može biti i isključeno.

Napomena: HolestPay je naprednije rešenje koje takođe nudi fiskalizaciju, ali ova varijanta je sasvim podesna za klasičnu prodaju sa fiskalizacijom i povezuje se preko našeg standardnog redirect NestPay plugina.

HOLEST E-COMMERCE DOO | https://ecommerce.holest.com

Proces naručivanja i aktivacije servisa

Nakon naručivanja servisa za fiskalizaciju:

Bez ovih podataka, servis ne može biti aktiviran i konfigurisan za produkcijski rad.

Korisni linkovi:

Sadržaj

Pregled podešavanja fiskalizacije

Slika 1: Pregled podešavanja fiskalizacije u WooCommerce administraciji

Demo PIB 000000000 - upotrebni ključ nije potreban

Slika 1a: Prikaz da za demo PIB 000000000 upotrebni ključ nije potreban

1. Osnovna podešavanja

Kako se povezuje: Fiskalni servis se povezuje na WooCommerce sajt preko našeg standardnog redirect NestPay plugina. Plugin se isporučuje u sklopu modula za plaćanje, ali može da fiskalizuje narudžbine plaćene bilo kojom platnom metodom. Ako ne želite da koristite NestPay za naplatu, možete jednostavno sakriti metodu plaćanja, a i dalje koristiti fiskalizaciju za sve ostale metode.
Omogući dodatak za fiskalnu integraciju (Samo Srbija) / Enable FISCALIZATION add-on (Republic of Serbia only)
Opis: Glavni prekidač za aktivaciju modula za fiskalizaciju. Bez aktivacije ovog parametra, sve ostale opcije fiskalizacije su neaktivne.
Vrednosti:
  • Yes - Aktivira modul za fiskalizaciju. Omogućava sve funkcionalnosti vezane za kreiranje fiskalnih računa.
  • No (ili neštiklovano) - Modul je deaktiviran. Fiskalizacija se neće izvršavati.
Napomena: Ova opcija mora biti aktivirana pre nego što možete koristiti bilo koju drugu funkcionalnost fiskalizacije.
Upravljaj FISKALIZACIJOM za sve metode plaćanja / Handle FISCALIZATION for all other payment methods
Opis: Određuje da li će plugin upravljati fiskalizacijom i za druge metode plaćanja koje nisu NestPay (npr. PayPal, direktan bankovni transfer, pouzećem, itd.).
Vrednosti:
  • Yes - Plugin će dodati interfejs za fiskalizaciju na sve porudžbine, bez obzira na metodu plaćanja. Ovo je korisno ako imate više metoda plaćanja ali želite centralizovano upravljanje fiskalizacijom.
  • No - Fiskalizacija će biti dostupna samo za porudžbine koje koriste NestPay metode plaćanja.
Napomena: Čak i ako postavite "No", manuelni interfejs za fiskalizaciju je uvek dostupan u detaljima porudžbine. Ova opcija određuje samo da li će automatska fiskalizacija raditi za sve metode. Takođe, možete sakriti NestPay metodu plaćanja ako ne želite da je koristite, a i dalje koristiti fiskalizaciju za sve ostale metode.

2. Režim rada i PIB

FISKALIZACIJA - režim rada / FISCALIZATION mode
Opis: Određuje da li se fiskalizacija izvršava u testnom (development) ili produkcijskom (live) režimu.
Vrednosti:
  • RAZVOJ/PROBA / DEVELOPMENT - Testni režim. Generišu se fiktivni fiskalni računi koji nisu vezani za stvarni ESIR/VPFR sistem. Koristi se za testiranje funkcionalnosti bez potrebe za validnim sertifikatom i API ključem. Napomena: Pristup ESIR-u nije moguć u DEMO okruženju.
  • PRODUKCIJA / LIVE - Produkcijski režim. Fiskalizacija se izvršava preko stvarnog ESIR/VPFR sistema. Zahteva validan PIB i API ključ.
VAŽNO: Pre prelaska na LIVE režim, obavezno testirajte sve funkcionalnosti u DEVELOPMENT režimu. U LIVE režimu se kreiraju stvarni fiskalni računi koji se šalju poreskoj upravi. Pristup ESIR-u nije moguć u DEMO okruženju.
FISKALIZACIJA - PIB / FISCALIZATION TAX NO (PIB)
Opis: Poreski identifikacioni broj (PIB) vaše firme koji se koristi za fiskalizaciju. Ovaj PIB mora biti registrovan u sistemu ESIR/VPFR.
Vrednosti:
  • 000000000 - Testni PIB koji se koristi u DEVELOPMENT režimu. Ne zahteva API ključ i generiše fiktivne račune.
  • Vaš stvarni PIB - 9-cifreni PIB vaše firme. Koristi se u LIVE režimu i zahteva validan API ključ.
Napomena: Poreske stope za vašu firmu se automatski učitavaju iz fiskalnog sertifikata koji se preuzima sa TaxCore portala (e-porezi sistem). Za testni PIB 000000000, stope su fiktivne i služe samo za testiranje. Za detaljno uputstvo kako se preuzima bezbednosni element (sertifikat), pogledajte: Fiskalizacija – kako se preuzima bezbednosni element sa e-porezi
API kljuć pristupa ESIR servisu
Opis: Bezbednosni ključ koji dobijate prilikom kupovine servisa za fiskalizaciju. Ovaj ključ omogućava pristup ESIR servisu.
Kada je potreban:
  • LIVE režim - Obavezno je potreban validan API ključ.
  • DEVELOPMENT režim sa PIB 000000000 - Nije potreban.
VAŽNO: Ne menjajte lozinku ESIR-a sa ESIR panela. Ukoliko želite da promenite lozinku, kontaktirajte support@holest.com. ESIR vam nije potreban za rad sa fiskalizacijom na sajtu - potreban je vašem knjigovođi zbog izveštaja. Napomena: Pristup ESIR-u nije moguć u DEMO okruženju.

3. Automatizacija fiskalizacije

FISKALIZACIJA - automatizacija / FISCALIZATION automation
Opis: Određuje kada će se automatski kreirati fiskalni računi. Možete izabrati da se fiskalizacija izvršava automatski za sve ili određene porudžbine, ili da se izvršava samo manuelno.
Detaljno objašnjenje automatizacije:
  • Osnovna automatska fiskalizacija: Pod osnovnom automatskom fiskalizacijom znači da će se fiskalni računi automatski napraviti i odmah prokazati kupcu, biti poslati na njegov mail u sadržaju maila i kao PDF attachment ukoliko je do naplate došlo. Tj. ukoliko je npr. naplata preko IPS skeniranja ili kartičnog plaćanja, pod uslovom da nije bila pre-autorizacija.
  • Pre-autorizacija: Ukoliko je bila pre-autorizacija, pošto je novac zarobljen ali ne i naplaćen na kartici, normalno se ne smatra da je do plaćanja došlo sve dok trgovac ne izvrši post-autorizaciju (ovo je bekend operacija i zahteva da bekend automatizacija bude uključena ukoliko želite da izbegnete potrebu za klikom na dugme za kreiranje fiskalnog računa). U pluginu postoji parametar koji je vezan za njegov platni deo kojim se može obeležiti da se pre-autorizacija smatra izvršenim plaćanjem, te će ukoliko je on aktivan, fiskalni račun biti kreiran čak i pri pre-autorizaciji ukoliko je uključena automatizacija.
Parametar za pre-autorizaciju

Slika 2a: Parametar kojim se može podesiti da se pre-autorizacija smatra gotovim plaćanjem

Detaljno objašnjenje automatizacije:
  • Metode bez automatske detekcije plaćanja: Za metode poput bankovne uplate, Pouzeće, pošto sistem ne može znati kada je do plaćanja došlo, nije moguća automatizacija i računi se moraju kreirati ili na klik, ili ako je uključena automatizacija u bekendu, onda će se izvršavati kada se narudžbina u WooCommerce označi kao "Gotovo" / Completed, "Vraćena" / Refund.
Vrednosti:
  • Isključivo manuelno preko bekend interfejsa / Manually initiated only (interactive) - Fiskalizacija se ne izvršava automatski. Morate ručno kliknuti na dugme u detaljima porudžbine da biste kreirali fiskalni račun. Preporučeno za početak dok se ne uhodate sa sistemom.
  • Ako je Srbija zemlja za naplatu / If Serbia is a billing country - Automatska fiskalizacija samo ako je zemlja naplate (billing country) Srbija.
  • Ako je Srbija zemlja za isporuku / If Serbia is a shipping country - Automatska fiskalizacija samo ako je zemlja dostave (shipping country) Srbija.
  • Ako je Srbija zemlja za naplatu ili isporuku / If Serbia is a billing or a shipping country - Automatska fiskalizacija ako je bilo billing ili shipping zemlja Srbija.
  • Samo na zahtev - na strani plaćanja dodaće se polje koje kupac može obeležiti / Only on demand - when a customer requests it on checkout - Fiskalizacija se izvršava samo ako kupac zahteva fiskalni račun tokom checkout procesa (ako imate opciju za to).
  • za bilo koju narudžbinu / for all orders - Automatska fiskalizacija za sve porudžbine, bez obzira na zemlju ili drugi uslov. Preporučeno za domaće prodavnice koje prodaju samo u Srbiji.
Preporuka: Za početak koristite "Manually initiated only" da biste se uhodali sa sistemom, a zatim prebacite na automatski režim kada budete sigurni da sve radi kako treba.
FISKALIZACIJA - isključi user role za automatizaciju / FISCALIZATION automation exclude roles
Opis: Omogućava da isključite određene korisničke uloge (roles) iz automatske fiskalizacije. Korisno je ako trgovac ima B2B kuće kojima izdaje e-invoice ili račune za firmu umesto fiskalnih računa. Na ovaj način možete automatski fiskalizovati porudžbine fizičkih lica, dok za B2B klijente (koji imaju određenu ulogu) možete izdavati e-invoice ili obične račune.
Napomena: WooCommerce i WordPress nemaju multi-role opciju (korisnik može imati samo jednu ulogu). Za dodeljivanje više uloga jednom korisniku potreban je dodatni plugin.
Primer: Ako imate B2B klijente koji imaju posebnu ulogu (npr. "B2B Customer" ili "Wholesale Customer"), možete ih isključiti iz automatske fiskalizacije. Tako će se automatski fiskalizovati porudžbine fizičkih lica, dok za B2B klijente možete izdavati e-invoice ili obične račune. Fiskalni račun i dalje može biti kreiran manuelno ako je potreban.
FISKALIZACIJA - automatizacija i u bekendu / FISCALIZATION automation in backend
Opis: Određuje da li će se automatska fiskalizacija izvršavati i kada se porudžbina kreira ili menja u WordPress backend-u (administraciji).
Vrednosti:
  • Yes - Automatska fiskalizacija će se izvršavati i kada se porudžbina kreira ili menja u backend-u. Korisno ako integrišete sa drugim pluginima koji kreiraju porudžbine programski.
  • No - Automatska fiskalizacija se neće izvršavati u backend-u, samo na frontend-u (kada kupac završi porudžbinu).
Napomena: Podrazumevano je automatska fiskalizacija isključena u backend-u da bi se izbeglo slučajno kreiranje računa tokom testiranja ili ručnih izmena.
FISKALIZACIJA - automatizacija: keriraj automatski STORNO račun pri povratu novca / FISCALIZATION automation: auto create refund receipt for refunded orders
Opis: Ako je uključeno, automatski će se kreirati fiskalni račun za refundaciju (storniranje) kada se porudžbina refundira u WooCommerce-u u bekendu.
Vrednosti:
  • Yes - Automatski se kreira refundacioni račun kada se porudžbina refundira, ali samo ako postoji fiskalni račun za originalnu porudžbinu i ako postoji identifikacija kupca (BuyerTin - PIB ili JMBG).
  • No - Refundacioni račun se mora kreirati manuelno iz detalja porudžbine.
VAŽNO: Za automatsko kreiranje refundacionog računa, neophodno je da kupac ima unet PIB ili JMBG u porudžbini. Bez toga, automatska refundacija neće raditi.

4. Email podešavanja

FISKALIZACIJA - mejlovi sa fiskalnim dokumentima / FISCALIZATION: receipt emails
Opis: Kontroliše kako se fiskalni račun šalje kupcu putem email-a.
Vrednosti:
  • Šalji u zasebnom mejlu / Send in separate e-mail - Fiskalni račun se šalje u posebnom email-u, nezavisno od standardnih WooCommerce email-ova. Kupac dobija poseban email sa linkom ka fiskalnom računu i PDF prilogom.
  • Ubaci u standardne WC e-majlove / Include in WC mails - Fiskalni račun se dodaje u standardne WooCommerce email-ove (npr. u email za potvrdu porudžbine). Link ka računu i PDF se dodaju u postojeći email.
  • Ne / No - Fiskalni račun se ne šalje automatski putem email-a. Kupac može da ga preuzme sa "Thank You" stranice ili iz detalja porudžbine u svom nalogu.
Preporuka: "Ubaci u standardne WC e-majlove / Include in WC mails" je najpraktičnije rešenje jer kupac dobija sve informacije u jednom email-u.
Slanje fiskalnog računa na mail kupcu

Slika 4a: Slanje fiskalnog računa na mail kupcu

NAPOMENA: Plugin se može vezati na redirect NestPay plugin za WordPress/WooCommerce platformu, pri čemu može da fiskalizuje narudžbine plaćene bilo kojom platnom metodom. U sklopu je HolestPay sistema (ne naručivati posebno ako je uz HolestPay), ali može se koristiti i nezavisno sa našim standardnim NestPay redirect pluginom.
Prikaz fiskalnog računa na Thank You strani

Slika 2: Fiskalni račun se prikazuje na Thank You strani kada je plaćanje instant (npr. karticno) ako se aktivira automatsko kreiranje

Fiskalizacija na Thank You strani

Slika 2b: Fiskalizacija na Thank You strani

5. Polja za proizvode i kupce

FISKALIZACIJA: sta korisiti za GTIN / FISCALIZATION: what should be used for the GTIN
Opis: Određuje koje polje iz WooCommerce proizvoda će se koristiti kao GTIN (Global Trade Item Number) na fiskalnom računu. GTIN je jedinstveni identifikator proizvoda (npr. EAN, UPC kod).
Vrednosti:
  • _sku (podrazumevano) - Koristi se SKU (Stock Keeping Unit) proizvoda kao GTIN.
  • Drugo polje - Možete uneti bilo koje custom meta polje proizvoda (npr. "_ean", "_barcode", itd.).
Napomena: Ako navedeno polje ne postoji ili je prazno, sistem će koristiti ID proizvoda kao fallback vrednost.
FISKALIZACIJA: meta_key iz postmeta tabele koji se koristi za identifikaciju kupca / FISCALIZATION: Order billing/shipping metafield for Buyer Id/Tax ID
Opis: Određuje koje polje iz porudžbine (billing ili shipping metafield) sadrži identifikaciju kupca (PIB za firme ili JMBG za fizička lica). Ovo polje je obavezno za određene tipove fiskalnih računa (npr. refundaciju, avans, predračun).
Vrednosti:
  • billing_pib (podrazumevano) - Koristi se polje "billing_pib" za PIB kupca.
  • Drugo polje - Možete uneti bilo koje custom meta polje koje počinje sa "billing_" (npr. "billing_tax_id", "billing_jmbg", itd.).
  • Prazno - Ako ostavite prazno, sistem će automatski dodati polje za unos PIB/JMBG na checkout stranici ako ga nema.
VAŽNO: Polje mora počinjati sa "billing_" da bi sistem mogao da ga prepozna. Ako sajt nema ovo polje u metafield-ovima porudžbine, sistem će ga automatski dodati na checkout stranici.
Kada je potrebno: Identifikacija kupca je obavezna za:
  • Refundaciju (storniranje) - obavezno JMBG (prefix 11) ili PIB (prefix 10)
  • Avans - obavezno PIB (prefix 10) za pravna lica
  • Predračun - obavezno PIB (prefix 10) za pravna lica
Identifikacija kupca za refundaciju, avans i predračun

Slika 3: Refundacija, avans i predračun zahtevaju identifikaciju kupca. Identifikacija ima prefix i vrednost - prefix 10 je PIB, prefix 11 je JMBG (za refundaciju)

FISKALIZACIJA: Polje ID kupca/Poreski ID – nije dodato / FISCALIZATION: Buyer Id/Tax ID field - no add
Opis: Ako je uključeno, sistem neće automatski dodavati polje za unos PIB/JMBG na checkout stranici ako polje ne postoji.
Vrednosti:
  • Yes - Sistem neće dodavati polje za PIB/JMBG na checkout-u ako ga nema. Korisno ako već imate custom polje ili ne želite da dodajete ovo polje.
  • No (ili neštiklovano) - Sistem će automatski dodati polje za PIB/JMBG na checkout stranici ako polje nije pronađeno u metafield-ovima porudžbine.
Prefiks za ID Kupca
Opis: Određuje tip identifikacije kupca koji će se koristiti na fiskalnom računu. Prefiks se dodaje ispred vrednosti (npr. "10:123456789" za PIB).
Dostupni prefiksi:
  • 10: PIB kupca - Koristi se za pravna lica (9 cifara)
  • 11: JMBG - Koristi se za fizička lica (13 cifara). Obavezno za refundaciju kada se novac vraća na račun.
  • 12: PIB i JBKJS kupca - Kombinovano
  • 20: Broj lične karte - Broj lične karte
  • 21: Broj izbegličke legitimacije
  • 22: EBS - Evidencijski broj stranca
  • 23: Broj pasoša (Srpski pasoš)
  • 30: Broj pasoša (Strani pasoš)
  • 31: Broj Diplomatske legitimacije/LK
  • 32-35: Broj lične karte - Za države MKD, MNE, ALB, BIH
  • 40: Poreski ID iz strane države (TIN)
  • Manuelni unos prefiksa PREFIKS:VREDNOST - Omogućava ručno unošenje prefiksa i vrednosti
  • Automatski - Sistem automatski određuje prefiks na osnovu dužine: 13 cifara = JMBG (11:), 9 cifara = PIB (10:)
Preporuka: "Automatski" je najpraktičnije rešenje jer sistem sam određuje da li je unet PIB ili JMBG na osnovu dužine.

6. Mapiranje poreskih stopa

Mapiranje poreskih stopa i metoda plaćanja

Slika 4: Potrebno je mapirati platne metode na sajtu na fiskalne platne metode i mapirati poreske stope sa sajta na poreske stope koje se čitaju iz fiskalnog sertifikata za firmu

Poreske stope - mapiranje
Opis: Tabela za mapiranje WooCommerce poreskih klasa i stopa na fiskalne poreske stope koje se koriste u ESIR sistemu. Sistem automatski učitava poreske stope iz vašeg fiskalnog sertifikata na osnovu PIB-a, ali morate povezati vaše WooCommerce poreske klase sa odgovarajućim fiskalnim oznakama.
Kako funkcioniše:
  • Sistem prikazuje tabelu sa svim kombinacijama "Tax Class" i "Tax Rate" koje postoje u vašoj WooCommerce prodavnici.
  • Za svaku kombinaciju, morate izabrati odgovarajuću fiskalnu poresku stopu iz padajuće liste.
  • Fiskalne stope se učitavaju automatski sa servisa poreske uprave na osnovu vašeg PIB-a.
VAŽNO - Fiktivne demo stope: Gore navedene stope (A, Ж, F, E, T, P, N, B, C, X) su fiktivne demo stope koje se koriste samo za testiranje sa PIB-om 000000000. Ne koriste se u produkciji!
Prave fiskalne poreske stope u produkciji (Srbija):

Sve firme u Republici Srbiji u produkciji imaju samo 4 poreske stope koje se čitaju iz fiskalnog sertifikata:

  • Г - 0.00% Без ПДВ - Oslobođeno od PDV-a
  • А - 0.00% Није у ПДВ - Van PDV sistema
  • Ђ - 20.00% О-ПДВ - Osnovna PDV stopa 20% (najčešća)
  • Е - 10.00% П-ПДВ - Povlašćena PDV stopa 10%
Kako se učitavaju poreske stope:
  • Poreske stope se automatski učitavaju iz fiskalnog sertifikata vaše firme
  • Fiskalni sertifikat se preuzima sa TaxCore portala (e-porezi sistem)
  • Za detaljno uputstvo kako se preuzima bezbednosni element (sertifikat), pogledajte: Fiskalizacija – kako se preuzima bezbednosni element sa e-porezi
  • Sistem automatski čita stope iz sertifikata na osnovu vašeg PIB-a kada prelazite na LIVE režim
VAŽNO: Za probni PIB 000000000, stope su fiktivne i služe samo za testiranje. Obavezno proverite mapiranje kada prelazite na LIVE režim sa stvarnim PIB-om i sertifikatom.
Primer mapiranja (produkcija):
  • WooCommerce "Standard rate" (20% PDV) → Fiskalna stopa "Ђ - 20.00% О-ПДВ"
  • WooCommerce "Reduced rate" (10% PDV) → Fiskalna stopa "Е - 10.00% П-ПДВ"
  • WooCommerce "Zero rate" (0%) → Fiskalna stopa "Г - 0.00% Без ПДВ" ili "А - 0.00% Није у ПДВ"
Poreska stopa za isporuku
Opis: Određuje koja poreska stopa će se koristiti za troškove dostave (shipping) na fiskalnom računu. Ako nije posebno zadato, koristiće se ista stopa kao za proizvode ili podrazumevana stopa.
Vrednosti:
  • --nije posebno zadata-- - Koristi se podrazumevana logika (najčešće ista stopa kao za proizvode)
  • Bilo koja fiskalna stopa - Možete izabrati specifičnu poresku stopu za dostavu (npr. ako je dostava oslobođena PDV-a, izaberite "(B) - 0.00% VAT")

7. Mapiranje metoda plaćanja

Metode plaćanja - mapiranje
Opis: Tabela za mapiranje WooCommerce metoda plaćanja na fiskalne metode plaćanja koje se koriste na fiskalnom računu. Svaka metoda plaćanja na sajtu mora biti mapirana na odgovarajuću fiskalnu metodu.
Dostupne fiskalne metode plaćanja:
  • Keš (TotalCashAmount) - Gotovinsko plaćanje. Koristi se za plaćanje pouzećem ili gotovinom u radnji.
  • Kartica (TotalCardAmount) - Koristi se za fizički karticni terminal u radnji. NE koristite ovo za online plaćanje karticama - za online kartice koristite "Ostale bezgotovinske uplate".
  • Ček (TotalCheckAmount) - Plaćanje čekom
  • Vaučer (TotalVoucherAmount) - Plaćanje vaučerom
  • WIRE TRANSFER (TotalWireTransfer) - Bankovni transfer, direktna uplata na račun
  • MobileMoney - Mobilno plaćanje
  • Ostale bezgotovinske uplate (TotalOther) - Ovo je ispravna opcija za sve online metode plaćanja! Uključuje: online plaćanje karticama (NestPay, PayPal kartice, itd.), bankovnu uplatu, PayPal, COD (ako kurir plaća na račun firme), i bilo šta što ide online. Prema pravilima fiskalizacije, sve online metode plaćanja se vode kao "Ostale bezgotovinske uplate", a ne kao "Kartica" (koja se odnosi samo na fizički karticni terminal u radnji).
KRITIČNO VAŽNO ZA ONLINE METODE:
  • Sve online metode plaćanja (online kartice - NestPay, PayPal kartice, bankovna uplata, PayPal, COD ako kurir plaća na račun firme, itd.) → Mapirajte na "Ostale bezgotovinske uplate (TotalOther)"
  • Fizičke transakcije: Ukoliko primate keš u radnji, imate karticni aparat u radnji, ili vam kurir donosi keš, onda možete koristiti odgovarajuće metode plaćanja (Keš, Kartica, itd.) umesto "Ostale bezgotovinske uplate".
Primeri mapiranja:
  • NestPay Intesa (online kartice) → Ostale bezgotovinske uplate
  • PayPal (online) → Ostale bezgotovinske uplate
  • Bankovna uplata (BACS, direktna uplata) → Ostale bezgotovinske uplate
  • COD (pouzećem, ako kurir plaća na račun firme) → Ostale bezgotovinske uplate
  • Plaćanje pouzećem (kurir vam donosi gotovinu) → Keš
  • --default-- (za sve ostale online metode) → Ostale bezgotovinske uplate (najsigurnija opcija)

8. Dodatna podešavanja

Margina za fiskalni štampač
Opis: Određuje margine (u pikselima) koje će se koristiti pri štampanju fiskalnog računa. Koristi se za formatiranje PDF-a fiskalnog računa.
Vrednosti:
  • 4 (podrazumevano) - Standardna margina od 4px
  • Bilo koji broj - Možete podesiti margine prema vašim potrebama za štampu
Napomena: Ovo podešavanje utiče samo na PDF format fiskalnog računa, ne na sam fiskalni račun koji se šalje poreskoj upravi.

9. Korišćenje interfejsa

9.1. Interfejs u detaljima porudžbine

Nakon konfiguracije, u detaljima svake porudžbine u WooCommerce administraciji videćete sekciju za fiskalizaciju sa dostupnim akcijama.

Interfejs za upravljanje fiskalizacijom

Slika 5: Interfejs koji se dodaje na WooCommerce interfejs ima sve opcije za lako upravljanje fiskalizacijom. Može se dobiti PDF za bilo koji fiskalni dokument ili poslati kupcu.

Opcije za pregled i sinhronizaciju

Slika 5c: Opcije za pregled i sinhronizaciju

Dostupne akcije
Opis: Dostupne akcije se dinamički menjaju na osnovu trenutnog statusa fiskalizacije porudžbine.
Kada nema fiskalnog računa:
  • PLAĆANJE - Kreira konačni fiskalni račun za prodaju
  • AVANS - Kreira fiskalni račun za avans (zahteva PIB kupca)
  • PREDRAČUN - Kreira predračun (zahteva PIB kupca)
Dostupne fiskalne komande kada fiskalni račun još nije izdat

Slika 5a: Dostupne fiskalne komande kada fiskalni račun još nije izdat

Kada postoji fiskalni račun:
  • OPOZIV - Opoziva (poništava) fiskalni račun. Koristi se kada kupac ne želi da da JMBG/broj lične karte (zakon o privatnosti je jači od zakona o fiskalnim računima).
  • REFUNDACIJA - Kreira refundacioni račun (storniranje). Zahteva JMBG (prefix 11) ili PIB (prefix 10) kupca. Ako kupac ne želi da da JMBG, MORATE koristiti Opoziv.
  • PREGLED - Prikazuje pregled fiskalnog računa
  • PDF - Preuzima PDF fiskalnog računa
  • POŠALJI KUPCU - Šalje fiskalni račun kupcu putem email-a
Dostupne fiskalne komande kada je račun prodaje izdat

Slika 5b: Dostupne fiskalne komande kada je račun prodaje izdat

Dinamički prikaz dostupnih akcija

Slika 6: U detaljima ordera se prikazuju samo oni tasteri koji su mogući kao fiskalna akcija na osnovu statusa fiskalizacije narudžbine

Modalni prozor za fiskalne akcije

Slika 7: Još jedan prikaz modala fiskalne akcije pokrenut iz detalja WooCommerce narudžbine

9.2. Masovna fiskalizacija

U listi svih porudžbina (WooCommerce → Orders), možete selektovati više porudžbina i primeniti "Bulk Action" za masovnu fiskalizaciju.

✅ Sigurnost: Opcija je sigurna i neće kreirati duple fiskalne račune ukoliko već postoje. Sistem automatski proverava da li porudžbina već ima fiskalni račun i preskače je ukoliko postoji.
Masovna fiskalizacija

Slika 8: Opcija za masovnu fiskalizaciju postoji u listi masovnih akcija za narudžbine

Kako koristiti masovnu fiskalizaciju:
  1. Idite na WooCommerce → Orders
  2. Selektujte porudžbine koje želite da fiskalizujete (checkbox-ovi)
  3. Iz padajuće liste "Bulk actions" izaberite odgovarajuću fiskalnu akciju za masovno kreiranje fiskalnih računa
  4. Kliknite na "Apply"

9.3. Tipovi fiskalnih računa

Izbor tipa fiskalnog računa

Slika 9: Izbor tipa fiskalnog računa

Tipovi fiskalnih računa
Dostupni tipovi:
  • Fiskalni dokument prodaje / Sale receipt - Konačni fiskalni račun za prodaju. Kreira se kada je porudžbina kompletirana i plaćena.
  • STRONIRANJE / Refund receipt - Fiskalni račun za refundaciju. Kreira se kada se porudžbina refundira. Zahteva identifikaciju kupca (JMBG za fizička lica, PIB za pravna lica). Ako kupac ne želi da da JMBG/broj lične karte, MORATE koristiti Opoziv (zakon o privatnosti je jači od zakona o fiskalnim računima).
  • Pro-faktura / Pro Forma - Predračun koji se izdaje pre finalizacije porudžbine. Zahteva PIB kupca.
  • Avans / Advance - Fiskalni račun za avansno plaćanje. Zahteva PIB kupca.
  • Opoziv / Cancelation - Opoziv (poništavanje) fiskalnog računa. Koristi se u slučaju lošeg kreiranja dokumenta ili kada kupac ne želi da da JMBG/broj lične karte za refundaciju (zakon o privatnosti je jači od zakona o fiskalnim računima).

9.4. Shortcode za prikaz fiskalnog računa

Shortcode: [fiscalreceipt]
Opis: Plugin nudi shortcode koji omogućava prikaz fiskalnog računa na bilo kojoj stranici ili u email-u. Shortcode automatski prikazuje fiskalni račun za trenutnu narudžbinu ili za određenu narudžbinu.
Osnovna upotreba:
  • [fiscalreceipt] - Prikazuje poslednji fiskalni račun za trenutnu narudžbinu (ako je dostupan u kontekstu)
  • [fiscalreceipt id="123"] - Prikazuje fiskalni račun za narudžbinu sa ID 123
Dostupni parametri:
  • id - ID narudžbine. Ako nije naveden, koristi se trenutna narudžbina iz konteksta (npr. na Thank You stranici).
  • type - Tip računa koji se prikazuje. Podrazumevano je "last" (poslednji).
  • title - Naslov koji se prikazuje iznad računa. Podrazumevano: "Vaš fiskalni račun / Your fiscal receipt"
  • notitle - Ako je postavljen, ne prikazuje se naslov.
  • nolinks - Ako je postavljen, ne prikazuju se linkovi (PDF download i verifikacioni link).
  • pdfcaption - Tekst za link preuzimanja PDF-a. Podrazumevano: "Preuzmi kao PDF / Download as PDF"
  • verifycaption - Tekst za verifikacioni link. Podrazumevano: "Verifikacioni link / Receipt verification link..."
Primeri korišćenja:
  • [fiscalreceipt] - Osnovni prikaz sa svim linkovima
  • [fiscalreceipt id="456" title="Fiskalni račun za narudžbinu #456"] - Prikaz za određenu narudžbinu sa custom naslovom
  • [fiscalreceipt nolinks="1" notitle="1"] - Prikaz bez naslova i linkova (samo HTML računa)
  • [fiscalreceipt pdfcaption="Preuzmi PDF računa" verifycaption="Proveri račun na portalu"] - Prikaz sa prilagođenim tekstovima linkova
Napomena: Shortcode će prikazati prazan string ako narudžbina nema fiskalni račun ili ako narudžbina ne postoji. Korisno je koristiti shortcode na Thank You stranici, u email template-ima, ili na stranici "Moje narudžbine" gde kupac može videti svoje fiskalne račune.

10. Opšta pravila fiskalizacije

Ova sekcija objašnjava osnovna pravila i koncepte fiskalizacije u Republici Srbiji, kada se koristi koji tip fiskalnog dokumenta i kako se pravilno identifikuje kupac.

10.1. On-line sertifikovani ESIR u sklopu ponude

Opis sistema: On-line sertifikovani ESIR u sklopu ponude (nije dostupan u DEMO rezimu)
Kako funkcioniše: Kada se kreira fiskalni račun, podaci se automatski šalju na ESIR sistem, koji ih prosleđuje poreskoj upravi. Fiskalni račun dobija jedinstveni QR kod i JIK (Jedinstveni Identifikacioni Kod) koji ga čine verifikovanim dokumentom.
VAŽNO: Pristup ESIR-u nije moguć u DEMO okruženju. ESIR pristup je dostupan samo u produkcijskom (LIVE) režimu sa validnim PIB-om i API ključem.
Online Sertifikovani ESIR

Slika 10: Online Sertifikovani ESIR koji se dobija u sklopu ponude. Može se koristiti za izveštaje a i za direktno kreiranje fiskalnih računa

Izveštaji u Online Sertifikovani ESIR

Slika 10a: Izveštaji u Online Sertifikovani ESIR koji se dobija u sklopu ponude. Može se koristiti za izveštaje a i za direktno kreiranje fiskalnih računa

Mogućnost off-site kreiranja fiskalnog računa

Slika 10b: Mogućnost off-site kreiranja fiskalnog računa direktno sa ESIR-a. Ukoliko se pravi off-site fiskalni račun direktno sa ESIR-a, onda se moraju uneti artikli ukoliko već nisu uneti automatski prethodno sa sajta.

10.2. Tipovi fiskalnih dokumenata

Fiskalni dokument prodaje / Sale receipt
Kada se koristi: Konačni fiskalni račun za prodaju roba ili usluga. Ovo je najčešći tip fiskalnog dokumenta.
Karakteristike:
  • Izdaje se kada je porudžbina kompletirana i plaćena
  • Obavezan za sve prodaje u Republici Srbiji
  • Mora biti izdat u roku od 24 sata od momenta prometa
  • Ne zahteva obavezno unosenje PIB/JMBG kupca (osim u posebnim slučajevima)
Storniranje (Refundacija)
Kada se koristi: Fiskalni račun za refundaciju (povraćaj novca) kada se porudžbina otkazuje ili vraća.
Karakteristike:
  • Mora postojati originalni fiskalni račun za prodaju
  • Obavezno zahteva identifikaciju kupca: JMBG (prefix 11) za fizička lica ili PIB (prefix 10) za pravna lica
  • Može biti potpuna ili delimična refundacija
  • Mora se izdati kada se novac vraća kupcu

🚨 VAŽNO - Zakon o privatnosti

Za refundaciju je obavezno uneti JMBG kupca (prefix 11) ili broj lične karte ako je fizičko lice, ili PIB (prefix 10) ako je pravno lice.

Međutim, ako kupac ne želi da da svoj JMBG ili broj lične karte za refundaciju, trgovac MORA da uradi Opoziv umesto Refundacije jer je zakon o privatnosti jači od zakona o fiskalnim računima.

U tom slučaju, koristite opciju "Opoziv / Cancelation" umesto "Refundacija". Opoziv ne zahteva identifikaciju kupca, za razliku od refundacije.

Opoziv / Cancelation
Kada se koristi: Opoziv (poništavanje) fiskalnog računa. Koristi se u slučaju lošeg kreiranja dokumenta ili kada kupac ne želi da da svoj JMBG/broj lične karte za refundaciju.
Karakteristike:
  • Mora postojati originalni fiskalni račun
  • Ne zahteva identifikaciju kupca - za razliku od refundacije
  • Koristi se za poništavanje računa u slučaju greške u kreiranju
  • Koristi se kada kupac ne želi da da svoj JMBG ili broj lične karte

🚨 VAŽNO - Zakon o privatnosti

Ako kupac ne želi da da svoj JMBG ili broj lične karte za refundaciju, trgovac MORA da uradi Opoziv umesto Refundacije jer je zakon o privatnosti jači od zakona o fiskalnim računima.

Opoziv ne zahteva identifikaciju kupca, za razliku od refundacije.

Predračun
Kada se koristi: Predračun se izdaje pre finalizacije porudžbine, kada je potrebno da kupac (obično pravno lice) dobije dokument pre nego što se izvrši plaćanje ili isporuka.
Karakteristike:
  • Izdaje se pre finalizacije porudžbine
  • Obavezno zahteva PIB kupca (prefix 10) - obično se koristi za pravna lica
  • Nije konačan fiskalni račun - može se kasnije konvertovati u fiskalni račun za prodaju
  • Koristi se kada je potrebna dokumentacija pre plaćanja
Avans
Kada se koristi: Fiskalni račun za avansno plaćanje (depozit, kapara) kada kupac plaća deo iznosa unapred.
Karakteristike:
  • Izdaje se kada se prima avansno plaćanje
  • Obavezno zahteva PIB kupca (prefix 10) - obično se koristi za pravna lica
  • Može se kasnije izdati dodatni fiskalni račun za ostatak iznosa
  • Koristi se za rezervacije, depozite, kapare

10.3. PIB i TIN identifikacija kupca

Kada je potrebna identifikacija kupca: Identifikacija kupca (PIB ili JMBG) je obavezna za određene tipove fiskalnih dokumenata.
Obavezno za:
  • Refundaciju (Storniranje) - Obavezno JMBG (prefix 11) za fizička lica ili PIB (prefix 10) za pravna lica. 🚨 VAŽNO: Ako kupac ne želi da da JMBG/broj lične karte, trgovac MORA da uradi Opoziv umesto Refundacije jer je zakon o privatnosti jači od zakona o fiskalnim računima.
  • Predračun - Obavezno PIB (prefix 10) - obično za pravna lica
  • Avans - Obavezno PIB (prefix 10) - obično za pravna lica
Ne zahteva identifikaciju:
  • Opoziv / Cancelation - Ne zahteva identifikaciju kupca. Koristi se kada kupac ne želi da da JMBG/broj lične karte za refundaciju (zakon o privatnosti je jači od zakona o fiskalnim računima).
Nije obavezno za:
  • Prodaja (Fiskalni račun) - Nije obavezno, osim u posebnim slučajevima (npr. B2B transakcije gde kupac zahteva PIB na računu)
Prefiksi za identifikaciju:
  • 10: PIB (Poreski identifikacioni broj) - 9 cifara, za pravna lica
  • 11: JMBG (Jedinstveni matični broj građana) - 13 cifara, za fizička lica
  • Automatski: Sistem može automatski prepoznati da li je unet PIB (9 cifara) ili JMBG (13 cifara) i dodeliti odgovarajući prefiks

10.4. Pravila i obaveze

⚠️ Važna pravila fiskalizacije:

ℹ️ Najčešći slučajevi korišćenja:

11. Važne napomene i preporuke

⚠️ Obavezne napomene:

✅ Preporuke za uspešnu implementaciju:

  1. Počnite sa DEVELOPMENT režimom - Koristite PIB 000000000 i testirajte sve funkcionalnosti pre prelaska na LIVE.
  2. Proverite mapiranje - Obavezno proverite da su sve poreske stope i metode plaćanja ispravno mapirane.
  3. Testirajte različite scenarije - Prodaja, refundacija, avans, predračun.
  4. Proverite email-ove - Uverite se da kupci dobijaju fiskalne račune kako treba.
  5. Dokumentujte podešavanja - Zabeležite vaša mapiranja za buduće reference.

ℹ️ Dodatne informacije:

Korisni linkovi:

12. Implementacije instrukcije za programare

✅ Važna napomena

Ovo je gotovo rešenje koje ne zahteva dodatno programiranje za osnovnu upotrebu. Plugin automatski upravlja svim aspektima fiskalizacije i čuva sve potrebne podatke.

Ova sekcija je namenjena samo programerima koji imaju potrebu da podatke o fiskalizaciji vežu sa nekim drugim sistemom (npr. ERP sistem, knjigovodstveni softver, custom integracije, itd.).

ℹ️ Meta field key-jevi za narudžbine

Plugin čuva podatke o fiskalizaciji u WooCommerce order meta poljima. Ova polja mogu biti korisna za programere koji žele da integrišu fiskalizaciju sa drugim pluginima ili da pristupe podacima o fiskalnim računima programski.

_fiscal_data_live | _fiscal_data_development
Opis: Ova meta polja sadrže sve podatke fiskalnih računa za narudžbinu. Polje zavisi od režima rada:
  • _fiscal_data_live - Koristi se u LIVE (produkcijskom) režimu
  • _fiscal_data_development - Koristi se u DEVELOPMENT (testnom) režimu
Struktura podataka:

Podaci se čuvaju kao serijalizovani niz (array). Za tačnu strukturu podataka, potrebno je utvrditi tip podataka (type) prilikom pristupa ovom polju.

Primer pristupa podacima: 
// Pristup podacima u PHP-u
$order_id = 123;
$mode = get_option('npintesa_fiscal_mode'); // 'live' ili 'development'

$meta_key = ($mode === 'live') ? '_fiscal_data_live' : '_fiscal_data_development';
$fiscal_data = get_post_meta($order_id, $meta_key, true);

if ($fiscal_data) {
    // $fiscal_data je array sa svim podacima o fiskalnim računima
    // Možete iterirati kroz sve fiskalne račune za narudžbinu
}
_last_fiscal_tran_type_live | _last_fiscal_tran_type_development
Opis: Ova meta polja čuvaju tip poslednje transakcije (transaction type) za narudžbinu. Polje zavisi od režima rada:
  • _last_fiscal_tran_type_live - Koristi se u LIVE (produkcijskom) režimu
  • _last_fiscal_tran_type_development - Koristi se u DEVELOPMENT (testnom) režimu
Moguće vrednosti:
  • Tip transakcije koji je poslednji izvršen za narudžbinu (npr. "sale", "refund", "advance", "proforma", "cancelation")
  • Vrednost se ažurira svaki put kada se kreira novi fiskalni račun
Primer pristupa podacima: 
// Pristup tipu poslednje transakcije u PHP-u
$order_id = 123;
$mode = get_option('npintesa_fiscal_mode'); // 'live' ili 'development'

$meta_key = ($mode === 'live') ? '_last_fiscal_tran_type_live' : '_last_fiscal_tran_type_development';
$last_tran_type = get_post_meta($order_id, $meta_key, true);

if ($last_tran_type) {
    // $last_tran_type sadrži tip poslednje transakcije
    // Možete koristiti za logiku koja zavisi od tipa fiskalne transakcije
}
_last_fiscal_inv_type_live | _last_fiscal_inv_type_development
Opis: Ova meta polja čuvaju tip poslednjeg fiskalnog dokumenta (invoice type) za narudžbinu. Polje zavisi od režima rada:
  • _last_fiscal_inv_type_live - Koristi se u LIVE (produkcijskom) režimu
  • _last_fiscal_inv_type_development - Koristi se u DEVELOPMENT (testnom) režimu
Moguće vrednosti:
  • Tip fiskalnog dokumenta koji je poslednji kreiran za narudžbinu (npr. "Sale receipt", "Refund receipt", "Advance", "Pro Forma", "Cancelation")
  • Vrednost se ažurira svaki put kada se kreira novi fiskalni dokument
Primer pristupa podacima: 
// Pristup tipu poslednjeg fiskalnog dokumenta u PHP-u
$order_id = 123;
$mode = get_option('npintesa_fiscal_mode'); // 'live' ili 'development'

$meta_key = ($mode === 'live') ? '_last_fiscal_inv_type_live' : '_last_fiscal_inv_type_development';
$last_inv_type = get_post_meta($order_id, $meta_key, true);

if ($last_inv_type) {
    // $last_inv_type sadrži tip poslednjeg fiskalnog dokumenta
    // Možete koristiti za logiku koja zavisi od tipa fiskalnog dokumenta
}

⚠️ Važne napomene za programere:

HOLEST E-COMMERCE DOO
https://ecommerce.holest.com
Uputstvo za konfiguraciju servisa za fiskalizaciju - WooCommerce
Verzija dokumenta: 1.0