Automatska fiskalizacija web shop-a: račun kupcu bez ijednog klika

Web shop koji radi u Srbiji ima obavezu da za svaki račun izdat građaninu pošalje fiskalni račun. Ako to znači da vlasnik svake večeri sedne i klika 40 puta „fiskalizuj", posao ne trpi samo vlasnika, nego i kupca koji čeka. Automatska fiskalizacija je drugačija: procesor kartica ili banka potvrdi uplatu, sistem sam pozove V-PFR, kupac za par sekundi u pošti nađe fiskalizovan račun sa QR kodom. Nula klikova.

Kad je fiskalizacija stvarno automatska?

Rečenica „automatska fiskalizacija" kruži tržištem, ali u praksi znači tri različite stvari. Prvi nivo je „poluautomatski": aplikacija je otvorena u pretraživaču, admin vidi novu porudžbinu i klikne „fiskalizuj". Radi, ali ako admin ne radi u petak uveče, kupac u petak uveče ne dobija račun. Drugi nivo je „automatski sa prisustvom": aplikacija sama okine fiskalizaciju kad je porudžbina u statusu „plaćeno", ali samo ako je aplikacija u tom trenutku pokrenuta (otvoren tab, uključen računar). Ako računar spava, red se pravi. Treći, pravi nivo, je „server-to-server automatski": web shop server pošalje poziv ka Tezga API-ju čim procesor potvrdi naplatu; ni admin ni njegov računar nisu deo lanca.

Cilj je uvek treći nivo. On radi po noći, vikendom i za vreme godišnjeg odmora, jer nema ljudske komponente. Sve ostale varijante rade dok neko gleda.

Šta se dešava od trenutka „Plati" do fiskalnog računa u mejlu?

Pet učesnika, jedan tok, nula ljudi između kupca i računa u pošti.

Ceo tok traje 2 do 8 sekundi. Kupac ostaje na strani „Hvala na kupovini" dok procesor javi ishod, shop server istog sekunda pošalje podatke ka Tezga API-ju, V-PFR odgovori sa potpisanim fiskalnim brojem i QR kodom, a Tezga sam pošalje mejl sa računom, PDF-om i linkom. Kupac otvori pošu dok pije kafu; ništa nije čekao.

WooCommerce (WordPress + Woo)

Za WooCommerce postoji Tezga plugin. Instaliraš ga iz WP admin panela (Plugins → Add New → „Tezga eKasa fiskalizacija") i uneseš API ključ iz Tezga kontrolne table. Plugin se sam okači na Woo hook woocommerce_order_status_completed i woocommerce_payment_complete, pa čim porudžbina uđe u status „completed" ili čim procesor javi „paid", ide poziv ka Tezgi. Za paket koji imaš u Woo-u, plugin sam mapira artikle iz WooCommerce baze u Tezga oblik. Manuelno mapiranje treba samo za neuobičajene poreske oznake.

Neuobičajene stavke (poklon vaučer, dostava kao PDV oporeziva ili oslobođena, popust preko kupona) plugin nudi kroz posebna podešavanja pre puštanja. Preporuka: uključi plugin u režim „samo test" prve tri porudžbine, potvrdi da fiskalni broj stiže, pa prebaci na „produkcija".

Shopify

Shopify nema nativni fiskalni plugin za Srbiju, ali ima Admin API i webhook orders/paid. Tezga integracija ide preko dodatka „Shopify → Tezga" koji je zapravo servis koji sluša taj webhook i preslikava porudžbinu u Tezga API poziv. Instalacija je otvaranje trial-a servisa, unos API ključeva sa obe strane i klik „Poveži". Servis se preporučuje zbog složenosti PDV pravila (Shopify računa PDV po lokaciji, mi po srpskom zakonu). Alternativa je sopstveni Node ili Ruby server koji radi isti posao, sa punom kontrolom.

PrestaShop, Magento, OpenCart

PrestaShop 8+ ima modul (Tezga Fiskalizacija) koji se instalira sa marketplace-a ili iz zip fajla. Radi na Presta hook hookActionOrderStatusPostUpdate: čim admin ili sistem promeni status u „isporučeno" ili „naplaćeno", zove Tezga API. Za Magento 2 postoji ekstenzija sa istom logikom, ali kroz Magento observer. OpenCart 3 i 4 imaju plugin sa event catalog/model/checkout/order/addOrderHistory. Svi rade po istom obrascu: hook na promenu statusa, poziv ka Tezga API-ju.

Wix, Squarespace, Webflow (bez servera)

Wix, Squarespace i Webflow ne daju ti pravi server, pa direktan poziv ka Tezga API-ju iz njihovog admin panela nije bezbedan (ključ bi izašao u pregledač). Rešenje je posrednik: n8n instanca ili Zapier tok. Ti u panelu platforme okineš webhook „nova porudžbina" ka n8n; n8n proveri da li je porudžbina plaćena, čita stavke i pozove Tezga API sa serverskog niza. Odgovor Tezge ide nazad u Wix/Squarespace kao note na porudžbini. Za Webflow logika je ista, ali se najčešće veže sa Stripe ili LemonSqueezy naplatnim tokom.

Refundacija, storno i otkazivanje

Automatika ne prestaje sa izdavanjem računa. Ako kupac vrati robu, fiskalizovan račun se ne briše (zakon to zabranjuje). Umesto brisanja, izdaje se novi fiskalni dokument refundacije koji se poziva na broj originala i anulira ga u knjigama Poreske uprave. U svakom pluginu za web shop, to je odvojena akcija „Refundiraj u Tezgi" koja se okine kad se u shop-u promeni status u „refunded" ili „canceled" (posle uspešne naplate).

Situacija	Šta se dešava na kasi	Kupac dobija
Porudžbina plaćena i isporučena	Fiskalni račun (avans ili promet)	Račun i QR mejlom, PDF u prilogu
Uplata potvrđena, roba još nije isporučena	Fiskalni avansni račun	Avansni račun, konačni ide kasnije
Porudžbina otkazana pre naplate	Ništa (nije bilo prometa)	Ništa, kupac vidi status u shop-u
Naplata izvršena, roba vraćena	Refundacija (novi fiskalni dokument)	Fiskalni dokument refundacije mejlom
Naplata jednim delom, ostatak pouzećem	Dva odvojena fiskalna dokumenta	Dva mejla sa dva QR koda

Šta pravi duple ili nedovršene račune?

Najčešća greška je poziv ka Tezga API-ju odmah kad kupac klikne „Naruči", pre nego što procesor potvrdi naplatu. Ako procesor odbije karticu, izdat je fiskalni račun a novca nema; obračun se ne poklapa i knjigovođa gubi vreme. Rešenje je čekanje potvrde naplate, koje procesori signaliziraju webhook-om (Stripe, NestPay, Monri, IPS) ili status promenom (Woo payment_complete).

Druga greška je odsustvo externalId. Kad shop server ne dobije odgovor od Tezge za 5 sekundi (mreža je pukla, Tezga trenutno prima veliki broj poziva), pokušava ponovo. Bez externalId, drugi pokušaj napravi drugi račun za istu porudžbinu; kupac dobija dva mejla, dve nedelje kasnije se ispravlja ručno. Ako svakoj porudžbini daš isti externalId pri svakom pokušaju (broj porudžbine iz shop baze), Tezga vidi da je posao već obavljen i vrati isti račun iz prvog pokušaja. Duplog izdavanja nema.

Treća greška je pogrešan izbor poreske oznake. Ako plugin uvek šalje 20% PDV a stvarno prodaješ hranu koja ide na 10%, poreska uprava vidi neuredan obračun. Zato je preporuka da poresku oznaku ne postavljaš iz podešavanja plugina već iz definicije proizvoda u shop-u (Woo product meta, Shopify variant tax code).