# Fiskalizacija WooCommerce prodavnice, bez uređaja i bez programiranja

> Instalirajte BokaPOS dodatak, unesite pristupne podatke i mapirajte poreske klase jednom. Od tada svaka porudžbina dobija fiskalni račun Poreske uprave: PFR broj, QR kod, verifikacioni link i PDF, na ekranu porudžbine i u e-pošti kupcu.

Izvor: https://bokapos.rs/woocommerce · Uvek besplatan, bez doplate · Odobren ESIR · IB 1656 · WordPress 6.5+ · WooCommerce 8.9+ · HPOS

- Preuzmite dodatak (ZIP, v1.0.0): https://bokapos.rs/wp/bokapos-for-woocommerce-1.0.0.zip
- Uskoro i u WordPress.org katalogu
- Uputstvo za prodavce: https://bokapos.rs/woocommerce/uputstvo

## Šta dodatak radi

Sve što web shop u Srbiji mora da uradi sa fiskalnim računom, unutar WooCommerce ekrana koje već koristite.

- **Fiskalizacija jednim klikom ili automatski.** Sa ekrana porudžbine, masovnom akcijom iz liste porudžbina ili automatski na statusu koji izaberete (preporučeno Završeno).
- **Refundacija iz WooCommerce panela.** Delimična refundacija po stavkama, obavezna identifikacija kupca i potpisana kopija kada se novac vraća u gotovini.
- **Avansni lanac.** Avansni račun kad novac stigne, avansna refundacija i konačni račun pri isporuci, za načine plaćanja koje označite kao avans.
- **Kopija, predračun i obuka.** Izdaju se sa ekrana porudžbine, bez odlaska u drugi sistem. Kopija je moguća i za konačni račun avansnog lanca.
- **Dostava računa kupcu.** WooCommerce e-pošta sa PDF prilogom, e-pošta iz BokaPOS-a, stranica Hvala i Moj nalog. Kupac bira format: A4, 80 mm ili 58 mm.
- **PIB kupca na kasi.** Polje za PIB u klasičnom i u blok checkoutu; identifikacija kupca se štampa na računu, a naziv firme iz registra NBS stiže uz račun.
- **Dnevnik i izveštaj o prometu.** Lokalni fiskalni dnevnik, pretraga BokaPOS dnevnika, CSV izvoz i promet po periodu, sve u WordPress-u.
- **Katalog i jezici.** Opciona sinhronizacija proizvoda sa BokaPOS-om. Interfejs na srpskom (latinica) i engleskom.

## Podešavanje u pet koraka

Prvi probni račun izdajete isti dan, u besplatnom sandbox okruženju. Produkcija se uključuje kada je bezbednosni element obveznika aktiviran.

1. **Povezivanje.** WooCommerce, BokaPOS, kartica Povezivanje. Unesite sandbox client id i tajnu, kliknite Testiraj vezu, izaberite obveznika i poslovni prostor.
2. **Porezi.** Dodatak čita poreske oznake uživo od V-PFR-a. Svakoj WooCommerce poreskoj klasi dodelite oznaku, posebno redovima za dostavu i naknade. Obveznik van sistema PDV-a sve mapira na oznaku bez PDV-a.
3. **Plaćanja.** Dodatak predlaže vrstu plaćanja za svaki način plaćanja: pouzeće je gotovina, virman je prenos na račun, kartične kapije su platna kartica. Ispravite gde treba.
4. **Fiskalizacija.** Podrazumevano fiskalizujete ručno. Ako uključite automatsku fiskalizaciju, izaberite status; kartica vas upozorava ako neki način plaćanja uzima novac pre isporuke i kaže kako to rešiti avansom.
5. **Dostava računa.** Uključite e-poštu sa PDF-om, prikaz računa na stranici Hvala i u Mom nalogu i polje PIB na kasi.

Zatim napravite probnu porudžbinu. Na ekranu porudžbine vidite kutiju BokaPOS fiskalizacija sa statusom, PFR brojem, linkom za proveru i PDF-om.

## Pravila koja dodatak poštuje

Fiskalni račun je pravni dokument, pa dodatak radije stane i pita nego da pogodi.

- Račun postoji samo kada BokaPOS odgovori 201 i `fiscalized: true`. Ništa drugo se ne računa: ni zakazan posao, ni e-pošta, ni PDF.
- Svaki zahtev nosi idempotentni ključ sačuvan pre slanja, pa prekid veze ne može da proizvede dva računa za jednu porudžbinu.
- Nepoznat ishod se nikad ne šalje ponovo; dodatak proverava rezultat kod BokaPOS-a i kaže kada čovek treba da odluči.
- Poreske oznake se čitaju uživo od V-PFR-a preko BokaPOS-a; nijedna stopa nije ukodirana.
- Porudžbine nastale pre aktivacije dodatka se ne fiskalizuju, jer bi račun nosio današnje vreme.
- Sandbox i produkcioni pristupni podaci su razdvojeni; sandbox ključ u produkcionom polju se odbija pre čuvanja.
- Porudžbina u stranoj valuti, stavka bez poreza mapirana na 20% ili popust veći od stavke se odbijaju umesto da se pogrešno fiskalizuju.

## Zahtevi

| | |
| --- | --- |
| WordPress | 6.5 ili noviji, testiran do 7.1 |
| WooCommerce | 8.9 ili noviji, testiran do 11.0 |
| PHP | 8.1 ili noviji |
| Skladište porudžbina | klasično i HPOS |
| Pozadinski poslovi | Action Scheduler koji dolazi uz WooCommerce |
| Nalog | BokaPOS nalog; sandbox je besplatan |
| Licenca | GPLv2 ili novija, otvoren kod |
| Verzija | 1.0.0, objavljena 2. septembra 2026. |

## Dodatak je besplatan i ostaje besplatan

Nema doplate, nema premium verzije, nema naplate po instalaciji. Plaća se samo BokaPOS pretplata za produkciju: 1.600 RSD mesečno po produkcionom bezbednosnom elementu, 600 fiskalizovanih dokumenata mesečno uključeno, 1 RSD po dodatnom dokumentu, PDV uračunat. Probno okruženje je besplatno i nikad se ne blokira.

## Šta dodatak šalje i kome

Posle unosa pristupnih podataka dodatak se obraća adresama auth.bokapos.rs (pristupni token) i api.bokapos.rs (provera veze, fiskalizacija, prikazi računa, katalog, dnevnik, izveštaji). Pri fiskalizaciji šalje stavke porudžbine, iznose, vrstu plaćanja i, po potrebi, identifikaciju kupca, da bi BokaPOS izdao račun obveznika preko V-PFR-a. Ne šalje analitičke ni reklamne podatke. PDF i slike računa se ne čuvaju kao lokalne datoteke, nego se preuzimaju od BokaPOS-a kada zatrebaju.

## Za developere

Dodatak je pisan po WooCommerce pravilima: `wc_get_order()` i meta API, HPOS, Action Scheduler za pozadinski rad, šabloni koje tema može da prepiše.

- Konstante u `wp-config.php`: `BOKAPOS_ENVIRONMENT`, `BOKAPOS_SANDBOX_CLIENT_ID`, `BOKAPOS_SANDBOX_CLIENT_SECRET`, `BOKAPOS_PRODUCTION_CLIENT_ID`, `BOKAPOS_PRODUCTION_CLIENT_SECRET`.
- Filteri: `bokapos_order_items`, `bokapos_order_buyer`, `bokapos_client_reference`, `bokapos_order_eligibility_problem`, `bokapos_validate_pib_checksum`, `bokapos_order_payments` za podeljeno plaćanje.
- Akcije: `bokapos_order_fiscalized`, `bokapos_refund_fiscalized`, `bokapos_advance_fiscalized`.
- Šabloni u temi pod `bokapos-for-woocommerce/`: `order-receipt.php`, `emails/bokapos-receipt.php`, `emails/plain/bokapos-receipt.php`.

## Česta pitanja o WooCommerce fiskalizaciji

**Da li je dodatak zaista besplatan?**

Da. Dodatak je besplatan i ostaje besplatan, bez doplate, bez premium verzije i bez naplate po prodavnici. Plaća se samo BokaPOS pretplata za produkcione račune; probno okruženje je besplatno.

**Da li mi treba fiskalna kasa, štampač ili L-PFR?**

Ne. BokaPOS je ESIR u cloudu koji fiskalizuje preko virtuelnog procesora (V-PFR) Poreske uprave. Potreban je samo bezbednosni element u obliku datoteke koji obveznik dobija od Poreske uprave za prodaju na daljinu.

**Da li dodatak fiskalizuje porudžbine napravljene pre instalacije?**

Ne. Račun nosi vreme kada ga V-PFR potpiše, pa bi stare porudžbine dobile današnje vreme. Fiskalizuju se samo porudžbine nastale posle aktivacije dodatka.

**Šta se dešava kada V-PFR ne radi?**

Ništa se ne izdaje. Dodatak ponavlja isti zahtev sa istim ključem nekoliko puta sa rastućim razmacima (5 s, 30 s, 2 min, 10 min, 30 min, 60 min); ako servis ostane nedostupan, označava porudžbinu i šalje e-poštu administratoru. Jedno dugme Ponovi ponavlja isti zahtev.

**Šta znači status Ishod se proverava?**

Zahtev je možda stigao do V-PFR-a, ali odgovor nije stigao nazad. Dodatak ga nikad ne šalje ponovo; periodično pita BokaPOS za rezultat i završava porudžbinu čim je ishod poznat. Ne fiskalizujte porudžbinu ponovo ručno.

**Može li refundacija bez broja lične karte ili PIB-a kupca?**

Ne. Propis traži identifikaciju kupca na svakoj refundaciji. Panel za refundaciju je traži: broj lične karte, PIB firme, pasoš i ostale zvanične vrste.

**Podržava li dodatak pouzeće, karticu, uplatnicu i IPS?**

Da. Dodatak mapira WooCommerce načine plaćanja na svih sedam zvaničnih vrsta: gotovina (pouzeće), platna kartica, ček, prenos na račun, vaučer, instant plaćanje i drugo bezgotovinsko plaćanje. Podeljeno plaćanje je moguće preko filtera.

**Radi li sa HPOS-om i blok checkoutom?**

Da. Dodatak koristi WooCommerce API za porudžbine, pa radi i sa klasičnim skladištem i sa HPOS-om, a polje PIB postoji i u klasičnom i u blok checkoutu.

**Kada će dodatak biti na WordPress.org?**

Dodatak je prijavljen u WordPress.org katalog i u postupku je pregleda. Do objave preuzmite ZIP sa ove stranice; ažuriranja i za tu instalaciju stižu kroz WordPress kao za svaki drugi dodatak.

**Kako prelazim na produkciju?**

Ovlašćeno lice obveznika traži bezbednosni element na portalu Poreske uprave, Vlasnik ga otprema na BokaPOS portalu, BokaPOS ga aktivira i izdaje produkcione pristupne podatke. Unesete ih u karticu Povezivanje, ponovo mapirate poreske klase (produkcija ima druge oznake) i proverite prvi račun na sajtu Poreske uprave.