# BokaPOS za WooCommerce: uputstvo za prodavce

> Podešavanje u pet koraka, šta se dešava sa porudžbinom, refundacije, avansi, predračun i kopija, prelazak na produkciju i ko šta može. Isto uputstvo koje dolazi uz dodatak.

Izvor: https://bokapos.rs/woocommerce/uputstvo · BokaPOS for WooCommerce 1.0.0

Ovaj dodatak povezuje vašu WooCommerce prodavnicu sa BokaPOS-om, cloud ESIR-om za prodaju na daljinu. Svaka plaćena porudžbina dobija fiskalni račun preko virtuelnog procesora fiskalnih računa Poreske uprave (V-PFR): PFR broj, link za proveru, QR kod i PDF. Sve se vidi na ekranu porudžbine i stiže kupcu. Poreska uprava je rešenjem br. 000-092-00-00171/2026-0000 od 2. septembra 2026. odobrila BokaPOS 1.0.0 kao ESIR, IB 1656.

## Šta vam treba

- WordPress 6.5 ili noviji, WooCommerce 8.9 ili noviji, PHP 8.1 ili noviji.
- Pristup BokaPOS-u. Pišite na office@bokagroup.rs ili preko kontakt stranice na bokapos.rs. BokaPOS otvara organizaciju, dodeljuje probni (sandbox) sertifikat i izdaje client id i tajnu. Sandbox je besplatan i nikad se ne blokira.

## Podešavanje u pet koraka

1. **Povezivanje.** WooCommerce, BokaPOS, kartica Povezivanje. Unesite sandbox client id i tajnu, kliknite "Testiraj vezu". Izaberite obveznika i poslovni prostor, sačuvajte.
2. **Porezi.** Kartica Porezi. Dodatak čita poreske oznake uživo od V-PFR-a (sandbox ima probni skup oznaka, produkcija zvanične srpske oznake). Svakoj WooCommerce poreskoj klasi dodelite oznaku; posebno redove za dostavu i naknade. Ako je obveznik van sistema PDV-a, sve redove mapirajte na oznaku bez PDV-a.
3. **Plaćanja.** Kartica 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.** Kartica Fiskalizacija. Podrazumevano fiskalizujete ručno, sa ekrana porudžbine ili masovnom akcijom. Ako uključite automatsku fiskalizaciju, preporučeni status je "Završeno" (roba isporučena ili usluga izvršena). Obratite pažnju na upozorenje na toj kartici: ako neki način plaćanja uzima novac pre nego što isporučite, račun vezan za "Završeno" stiže kasnije nego što zakon traži, pa vam kartica kaže koji su to načini i kako da to rešite. Tu su i kasir, podrazumevana jedinica mere, naziv linije dostave, tekst ispod fiskalnog dela, avansi i predračuni.
5. **Dostava računa.** Kartica Dostava računa. Uključite WooCommerce e-poštu sa PDF-om, e-poštu iz BokaPOS-a (modul E-mail), 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.

## Šta se dešava sa porudžbinom

- **Automatski (ako je uključeno).** Nekoliko sekundi posle promene statusa dodatak u pozadini šalje porudžbinu BokaPOS-u. Račun postoji samo kad BokaPOS odgovori "fiskalizovano". Beleška na porudžbini i kolona "Fiskalni račun" u listi porudžbina pokazuju rezultat.
- **Ručno.** Dugme "Fiskalizuj sada" na porudžbini, ili masovna akcija "Fiskalizuj preko BokaPOS-a" u listi porudžbina.
- **Stare porudžbine.** Porudžbine nastale pre aktivacije dodatka se ne fiskalizuju: račun bi nosio današnje vreme, ne datum porudžbine.

## Kad nešto zapne

| Status | Značenje | Šta da radite |
| --- | --- | --- |
| Ponavljanje zakazano | BokaPOS ili V-PFR privremeno nisu dostupni. Ništa nije izdato. | Ništa. Dodatak ponavlja isti zahtev sa istim ključem (5 s, 30 s, 2 min, 10 min, 30 min, 60 min). |
| Ishod se proverava | Zahtev je možda stigao do V-PFR-a, odgovor nije. | Ništa. Dodatak nikad ne šalje ponovo; proverava ishod sa BokaPOS-om dok se ne razreši. Ne fiskalizujte porudžbinu ponovo. |
| Odbijeno | V-PFR ili BokaPOS odbili zahtev (npr. oznaka nije aktuelna, cena sa tri decimale). Ništa nije izdato. | Pročitajte belešku, ispravite podatke (proizvod, mapiranje), pa "Fiskalizuj ponovo (novi zahtev)". |
| Zahteva pažnju | Dodatak je stao i čeka odluku čoveka. | Beleška na porudžbini i e-pošta administratoru kažu zašto. Posle rešavanja kliknite odgovarajuće dugme, pa "Ukloni oznaku". |

Filter "BokaPOS: zahteva pažnju" u listi porudžbina i stranica "BokaPOS dnevnik" prikazuju sve takve porudžbine.

## Refundacije

Refundaciju pravite kao i inače (dugme "Refundiraj" na porudžbini). U panelu za refundaciju dodatak dodaje:

- "Fiskalizuj ovu refundaciju kod BokaPOS-a",
- identifikaciju kupca (propis traži identifikaciju na svakoj refundaciji: broj lične karte, PIB firme, pasoš i ostale zvanične vrste),
- vrstu vraćanja novca.

Refundirajte cele jedinice po ceni sa računa (izaberite stavke i količine). Refundacija "iznosa" bez stavki ne može da se fiskalizuje. Fiskalna refundacija se šalje u pozadini nekoliko sekundi posle klika na "Refundiraj"; osvežite porudžbinu da vidite rezultat u odeljku Refundacije, gde su i dugmad za ponavljanje. Kad se vraća gotovina, BokaPOS odmah izdaje i kopiju za potpis kupca; odštampajte je sa ekrana porudžbine.

Na računu se štampa samo identifikacija kupca. BokaPOS pri izdavanju i dalje pronalazi firmu u registru NBS i vraća je uz račun; ekran porudžbine prikazuje taj naziv pored identifikacije, a dodatak sam ne pretražuje registar.

Opciono polje kupca (obrasci za poresko oslobođenje, korporativna kartica) je polje računa prodaje. Popunite ga na porudžbini pre fiskalizacije prodaje; ono nikad ne ide na refundaciju, avansni račun, predračun ni dokument obuke, a u avansnom lancu se pojavljuje na završnom računu.

## Avansi

Ako kupac plaća pre isporuke, u kartici Fiskalizacija označite načine plaćanja koji su avansi. Avansni račun se po zakonu izdaje u trenutku kada novac stigne, a ne pri isporuci, pa lanac ima dva svoja statusa: na statusu otvaranja (podrazumevano "U obradi") dodatak otvara avansni slučaj i izdaje avansni račun, a na statusu zatvaranja (podrazumevano "Završeno") BokaPOS izdaje avansnu refundaciju i konačni račun. Oba koraka rade samo ako je uključena automatska fiskalizacija; u suprotnom ih pokrećete dugmadima na ekranu porudžbine. U produkciji je potreban modul Avans u licenci.

## Predračun, obuka, kopija

Sa ekrana porudžbine možete izdati predračun (ponuda bez poreskog dejstva) i dokument obuke (za testiranje, nema poresko dejstvo) dok porudžbina još nema fiskalni račun, a kopiju računa kad ga ima. Predračun može da se izdaje automatski pri prijemu porudžbine za izabrane načine plaćanja.

Svaki fiskalizovan račun može da se kopira, uključujući i konačni račun avansnog lanca. Kopija je i sama dokument u dnevniku, sa oznakom ОВО НИЈЕ ФИСКАЛНИ РАЧУН, pa je izdajte kada kupac zatraži, a ne iz navike.

## Avansi na rate i raniji avansi

Ekran porudžbine prima iznos, pa lanac može da počne kaparom i primi još rata, svaka sa svojim avansnim računom; ako iznos ostavite prazan, fiskalizuje se cela porudžbina odjednom, kao i ranije. Pod "Avans je primljen pre eFiskalizacije" prijavljujete novac primljen na papirnom dokumentu, pre nego što je prodavnica uopšte imala eFiskalizaciju: BokaPOS se u lancu poziva na taj dokument i dodaje iznos u završnu refundaciju. Popunite to pre prvog avansnog računa, jer je posle toga lanac već otvoren. Broj dokumenta sadrži samo cifre; Poreska uprava odbija svaki drugi oblik.

## Napredna podešavanja

Kartica Napredno drži ono što se podesi jednom: koliko dodatak upisuje u WooCommerce zapisnik (podrazumevano samo greške), jezik interfejsa i da li deinstalacija dodatka briše i njegovu tabelu dnevnika. Ovo poslednje je namerno isključeno, jer je lokalni dnevnik deo vaše evidencije; brisanje uklanja samo kopiju na ovom sajtu, nikada dokumente kod BokaPOS-a ni kod Poreske uprave. Kartica prikazuje i verziju dodatka, kada je aktiviran (starije porudžbine se nikada ne fiskalizuju) i vezu ka njegovim pozadinskim poslovima. Izmene ovde može da radi samo administrator, ne i menadžer prodavnice.

## Kada se lanac izgubi

BokaPOS dnevnik, "Avansni lanci kod BokaPOS-a", prikazuje sve lance koje vaša organizacija ima otvorene, bez obzira na to koji ih je sistem otvorio, sa WooCommerce porudžbinom pored njih tamo gde je ovaj sajt zna. Tu se lanac pronalazi posle vraćanja baze ili obrisane porudžbine, da bi mogao da se zatvori umesto da zauvek ostane otvoren.

## Prelazak na produkciju

1. Ovlašćeno lice obveznika traži bezbednosni element (sertifikat) za poslovni prostor na portalu Poreske uprave i preuzima ZIP.
2. Vlasnik ga otprema na BokaPOS portalu (cloud.bokapos.rs, Bezbednosni elementi). BokaPOS proverava i aktivira element i izdaje licencu.
3. BokaPOS izdaje produkcioni client id i tajnu. Unesite ih u karticu Povezivanje, izaberite obveznika i prostor, prebacite okruženje na Produkciju, sačuvajte.
4. U kartici Porezi ponovo mapirajte klase (produkcija ima druge oznake).
5. Prvi produkcioni račun proverite na suf.purs.gov.rs preko linka na porudžbini.

Sandbox pristup ostaje aktivan za dalje testiranje.

## Ko šta može

Menadžer prodavnice (WooCommerce uloga Shop manager) radi sve na porudžbinama i menja kartice Fiskalizacija, Porezi, Plaćanja, Dostava računa i Katalog. Pristupne podatke, okruženje (sandbox ili produkcija) i brisanje podataka menja samo administrator sajta.

## Pomoć

BokaPOS Administracija: office@bokagroup.rs, +381 69 558 55 88. Uz upit pošaljite broj porudžbine i "id dokumenta" iz tehničkih detalja na porudžbini; nikad tajnu ili sertifikat. Dnevnik dodatka: WooCommerce, Status, Zapisnici, izvor "bokapos".