Za programere · integracija je besplatna
Fiskalizacija iz tvog koda, bez hardvera
Tvoja platforma pozove REST API, Tezga izda i fiskalizuje račun preko V-PFR-a i vrati PFR broj, QR i PDF. Bez lokalne instalacije i uređaja, a API pozivi se ne naplaćuju.
- ИБ odobrenog ESIR-a
- 1597ИБ odobrenog ESIR-a
- bez lokalnog hardvera
- V-PFRbez lokalnog hardvera
- server-to-server
- RESTserver-to-server
- po API pozivu
- 0 RSDpo API pozivu
Tvoj sajt, Tezga i Poreska u jednom toku
Kako radi, uživo
Tvoj sajt, Tezga i Poreska u jednom toku
Kupac plati na sajtu, fiskalni račun nastaje sam.
- 1Kupac → Tvoj sajt
plaćena porudžbina
Kupac završi kupovinu na tvom sajtu.
- 2Tvoj sajt → Tezga
POST /order
- 3Tezga → Poreska (V-PFR)
račun na potpis
- 4Poreska (V-PFR) → Tezga
PFR broj + QR
- 5Tezga → Tvoj sajt
racun.fiskalizovan
- 6Tezga → Kupac
PDF na mejl
Šta API pokriva, za poređenje
- REST API, server-to-server
- Sandbox i simulacija
- Refundacija
- Avansni račun
- Storno
- PDF, QR i verifikacioni URL
- Idempotentnost
- Webhook obaveštenja
- Ograničenje zahteva
- Fiskalni račun i e-faktura (SEF)
- Naplata po pozivu
Radi sa svakim stekom: Next.js, Laravel, Node, PHP, Symfony, React, Vue, WordPress i headless prodavnice.
Prvi račun
curl -X POST https://pos.narbiz.com/api/integrations/order?provider=custom \
-H "X-Tezga-Api-Key: tzg_…" \
-H "Content-Type: application/json" \
-d '{
"externalId": "NALOG-1042",
"tok": "fiskalni",
"nacinPlacanja": "Kartica",
"kupac": { "naziv": "Kupac", "email": "kupac@primer.rs" },
"stavke": [
{ "naziv": "Paket od 10 časova", "kolicina": 1, "cenaSaPdv": 24000 }
]
}'Odgovor nosi fiskalni.pfrBroj, brojacRacuna, verifikacioniUrl i javniPdfUrl koji radi bez prijave.
Za šta se koristi
Jedan API, isti poziv: razlika je samo u toku koji izabereš.
Avansni računi: više uplata, jedno zatvaranje
Kupac može da plati unapred više puta: prva uplata otvara avansni račun, a svaka sledeća se vezuje na isti posao (vezani avansi, po Tehničkom uputstvu Poreske uprave). Kad isporučiš, jedan poziv sa zatvori: true izda refundaciju avansa pa konačni račun. Ako refundacija ne prođe, konačni račun se ne izdaje, pa dupli promet ne može da nastane.
Plaćanje: radi sa svima
Tezga fiskalizuje posle potvrde uplate, pa ne zavisi od platnog posrednika. Kartica, IPS instant ili gotovina: za API je isti poziv, samo drugačiji nacinPlacanja.
Platni posrednici
Čim tvoj sistem dobije potvrdu uplate, pozove Tezgu.
Banke i njihova kartična rešenja
E-commerce servisi banaka rade preko gornjih posrednika; Tezgi je svejedno ko je naplatio.
Novčanici i instant
Apple Pay i Google Pay idu kroz tvog posrednika; IPS QR je ugrađen.
Ugrađen NBS IPS QR: kupac skenira i plati instant
Na računu, predračunu i avansnom računu stoji IPS QR po NBS standardu: kupac ga skenira u aplikaciji banke i plati instant, bez poziva na broj. Izvodi se uvoze sami. Svaki fiskalni račun nosi i verifikacioni QR Poreske uprave.
Radiš vibecoding? Tezga je spremna.
Tezga ima MCP konektor: u claude.ai se dodaje kao custom connector (https://pos.narbiz.com/mcp), a u Claude Code, Cursor ili Codex preko mcp.json. Asistent sam izdaje probne račune, radi storno i avans dok ti gradiš. Radi i sa Codexom, Windsurfom, Copilotom i svakim MCP klijentom; mobilne aplikacije zovu isti REST API iz bekenda.
Primeri koda po steku
46 pitanja koja nam integratori najčešće pošalju
Kako radi
Da li je Tezga cloud ESIR, bez lokalne instalacije i hardvera?
Postoji li direktan REST API, nezavisno od gotovih konektora?
Kako se zahtev autentikuje?
Koje operacije API pokriva?
Šta dobijam u odgovoru kad se račun izda?
Pouzdanost
Šta se dešava kada V-PFR Poreske uprave nije dostupan?
Kako se sprečava dupli račun?
Postoje li webhook obaveštenja?
Postoji li ograničenje broja zahteva?
Pod kojim odobrenjem Tezga radi?
Prodaja na daljinu i ulaznice
Kako izgleda tok kod prodaje na daljinu, na primer ulaznica?
Prodajem u ime organizatora događaja, kako to izgleda kod vas?
Kako se radi povraćaj novca za otkazanu ulaznicu?
Da li kupac mora da dobije papirni račun?
Bezbednosni element i nalozi
Koristi se moj bezbednosni element ili tražite novi?
Kako se rešava više portala ili više poslovnih prostora?
Kako izgleda test pre produkcije?
Kako da u kodu sprečim da test izda pravi račun?
Kako se čuvaju poreske stope ako nisam u sistemu PDV-a?
Cena i rokovi
Koji paket je potreban za direktan API pristup?
Ima li ugovorne obaveze i otkaznog roka?
Koliko traje integracija?
Šta je na vama, a šta na meni?
Podaci na računu iz web shopa i ERP-a
Šalje se ceo sadržaj računa ili samo ukupan iznos?
Kako se na fiskalnom računu vide popusti i promo kodovi iz shopa?
Kako se evidentiraju stope od 20 i 10 odsto kad je korpa mešovita?
Prepoznaje li sistem da li je kupac fizičko ili pravno lice?
Ide li B2B račun iz web shopa i na SEF, ili to radi ERP?
Kako ide avansni račun kad kupac plati karticom unapred?
Radi li delimičan povraćaj, na primer jedan od tri artikla?
Kako se stornira porudžbina kad kupac odustane, iz ERP-a ili iz shopa?
Račun kupcu iz web shopa
Kako kupac iz web shopa dobije fiskalni račun?
Je li račun PDF u prilogu ili samo link za proveru?
Može li mejl sa računom da nosi ime i podatke moje firme?
Obim, dostupnost i vezivanje sistema
Koliki obim API podnosi i može li da se podigne?
Kakvu dostupnost i nadzor imate, kad shop radi non-stop?
Sa kojim e-commerce platformama već radite?
Kako se artikli iz ERP-a nađu u Tezgi?
Koliko integracija sme da bude na jednom nalogu?
Uloge, podaci i ažuriranja
Kako se naplaćuje: po API pozivu, po računu ili fiksno?
Kako izgleda podrška van radnog vremena?
Gde su podaci i ko vidi bezbednosni element?
Koliko korisnika i kakve uloge postoje?
Ko arhivira fiskalne račune i koliko dugo se čuvaju?
Šta se dešava kad Poreska promeni propise, da li ažuriranje prekida sajt?
Mogu li da testiram integraciju pre nego što platim?
API dokumentacija (PDF)
Kompletno uputstvo sa svim pozivima i primerima. Ažurirano 06.10.2026.. Integracija je besplatna.
