# FiskalAPI

> Online fiskalna kasa (ESIR) za e-fiskalizaciju u Srbiji preko REST API-ja. Izdavanje fiskalnih računa jednim API pozivom, bez fizičkog uređaja i bez mesečne pretplate — plaća se samo po izdatom računu.

FiskalAPI je namenjen svima koji prodaju online potrošačima (fizičkim licima) u Srbiji i po zakonu moraju da izdaju fiskalni račun: web prodavnice (WooCommerce, Shopify, custom), SaaS i pretplatnički servisi, aplikacije, kursevi i digitalni proizvodi. Radi po modelu e-fiskalizacije Poreske uprave Republike Srbije (odobreni ESIR + V-PFR), svaki račun ima QR kod i link za verifikaciju.

## Cena
- API, integracija i sandbox: besplatno (bez pretplate, bez ugovorne obaveze).
- Naplata samo po izdatom računu, stepenasto (mesečno): prvih 100 računa po 9 din, 101–500 po 4 din, 501–1000 po 3 din, 1001–5000 po 1,5 din; preko 5000 po dogovoru. Primer: 500 računa = 2.500 din, 1.000 = 4.000 din mesečno.
- Obračun i faktura na kraju meseca (B2B — nije fiskalni račun).

## Kako radi
1. Klijent zatraži pristup i odmah dobije test (sandbox) ključ; live ključ dobija kad sam poveže svoj bezbednosni element (pribavlja ga na еПорези).
2. Od FiskalAPI-ja klijent dobija samo API ključ i javnu dokumentaciju — nema uređaja, instalacije, pretplate ni jednokratne naknade za setup.
3. Klijent zove REST API iz svog sistema; račun se potpisuje elementom TOG klijenta.
4. Vraća se broj računa, QR kod i verifikacioni link — klijent ga prosledi kupcu.

## Ključni API pozivi
- POST /api/racuni — promet prodaja (fiskalni račun)
- POST /api/racuni/avans — avansni račun (pretplate, uplate unapred)
- POST /api/racuni/avans/refundacija — zatvaranje avansa; konačni račun (POST /api/racuni) se poziva na tu avansnu refundaciju
- Račun kupcu šalje prodavac, svojim mejlom: `qrKod`, `verifikacija` i `zurnal` stižu u odgovoru. Polje `kupac.email` se podrazumevano zanemaruje.
- POST /api/racuni/obuka — račun za obuku (proba kase; bez poreske obaveze i bez naplate)
- POST /api/racuni/refundacija — refundacija (uz referencu na original)
- POST /api/racuni/kopija — kopija već izdatog računa (uz referencu na original)
- POST /api/racuni/predracun, /api/racuni/predracun/refundacija — predračun (nije fiskalni račun)
- POST /api/racuni/obuka/refundacija — refundacija računa za obuku
- GET /api/racuni — pretraga izdatih računa (od, do, kupac, broj, vrsta)
- GET|PUT /api/artikli — izvoz i uvoz liste artikala
- GET /api/racuni/{id} — čitanje izdatog računa, po transactionId ili PFR broju
- GET /api/status — podaci obveznika i poreske stope
- GET /api/usage — potrošnja i mesečni trošak
Autentikacija: Authorization: Bearer <API_KLJUC> (fapi_live_… ili fapi_test_… za sandbox).

## Za koga NIJE
- Za prodaju isključivo pravnim licima (B2B) fiskalizacija po pravilu nije potrebna (izdaju se fakture). FiskalAPI pokriva fiskalizaciju maloprodaje (B2C), uključujući online prodaju.

## Strane i vodiči
- Online fiskalna kasa (bez uređaja, za prodaju preko interneta): https://fiskalapi.rs/online-fiskalna-kasa/
- E-fiskalizacija u Srbiji — kako radi sistem (ESIR, PFR, element, V-PFR/L-PFR, izmene zakona 2026): https://fiskalapi.rs/e-fiskalizacija/
- Fiskalizacija online prodavnice — moduli za WooCommerce, Shopify, Magento, PrestaShop, OpenCart: https://fiskalapi.rs/fiskalizacija-online-prodavnice/
- WooCommerce fiskalizacija — besplatan dodatak: https://fiskalapi.rs/woocommerce-fiskalizacija/
- Shopify fiskalizacija — besplatna aplikacija, račun za svaku plaćenu porudžbinu: https://fiskalapi.rs/shopify-fiskalizacija/
- Magento fiskalizacija — besplatan modul za Magento 2: https://fiskalapi.rs/magento-fiskalizacija/
- PrestaShop fiskalizacija — besplatan modul za PrestaShop 1.7 i 8: https://fiskalapi.rs/prestashop-fiskalizacija/
- OpenCart fiskalizacija — besplatan modul za OpenCart 3: https://fiskalapi.rs/opencart-fiskalizacija/
- Fiskalizacija preko REST API-ja — za sajt, SaaS ili aplikaciju pravljenu po meri (jedan POST po računu, zaštita od duplog računa): https://fiskalapi.rs/rest-api-fiskalizacija/
- MCP konektor — FiskalAPI kao alat AI asistenta u ChatGPT-u, Claude-u i Cursor-u (izdavanje, refundacija, kopija i pretraga računa, uz potvrdu korisnika); adresa servera https://api.fiskalapi.rs/mcp: https://fiskalapi.rs/mcp-konektor/
- Vodič: bezbednosni element (ePorezi, ПГЈО, PIN (lozinka) i ПАК, obnova na 3 godine): https://fiskalapi.rs/bezbednosni-element/
- Vodič: avansni račun (10–13: Аванс, avans → avansna refundacija → konačni račun): https://fiskalapi.rs/avansni-racun/
- Vodič: fiskalni račun (primer računa, broj računa, ПФР broj naspram ESIR broja, provera QR kodom, refundacija, kazne): https://fiskalapi.rs/fiskalni-racun/
- Vodič: poreske oznake (Ђ 20%, Е 10%, Г promet oslobođen PDV-a (0%), А za paušalce i ne-obveznike PDV-a; izdvajanje poreza iz cene, ispravka pogrešne oznake): https://fiskalapi.rs/poreske-oznake/
- Vodič: način plaćanja na fiskalnom računu (sedam načina iz čl. 6 Pravilnika, pouzeće, PayPal, kombinovano plaćanje): https://fiskalapi.rs/nacini-placanja-na-fiskalnom-racunu/
- Vodič: fiskalizacija pretplata, usluga i digitalnih proizvoda (avans ili promet, obnova, otkaz i povraćaj): https://fiskalapi.rs/fiskalizacija-pretplata-i-usluga/
- Svi vodiči na jednom mestu: https://fiskalapi.rs/vodici/

## Linkovi
- Sajt: https://fiskalapi.rs/
- Dokumentacija API-ja (javna, bez naloga): https://fiskalapi.rs/docs/
- Akreditacija (podaci iz rešenja PU, ESIR IB 1609): https://fiskalapi.rs/esir/
- Klijentski panel („Moj nalog"): https://fiskalapi.rs/nalog/
- Cene: https://fiskalapi.rs/#cene
- Kontakt: https://fiskalapi.rs/kontakt/