Fiskalizacija za velike sisteme, po modelu koji birate

Cena, otvoreno

Bez cene na upit. Dva modela: birate onaj koji odgovara vašem obimu, a ugovor i usluga su isti.

Kada se šta isplati: uz kurs od oko 117 dinara za evro, fiksni model je povoljniji od oko 46.800 računa mesečno po sajtu, a ispod toga model po računu.

Primer, dva sajta (recimo B2C prodavnica i marketplace): u fiksnom modelu 1.600 € mesečno i 5.000 € jednokratno; u modelu po računu 2 RSD za svaki račun i 10.000 € jednokratno.

Uslovi Enterprise nivoa, verzija 1.0, ažurirano 14.10.2026.

Šta je u ceni

Sve što ima paket Biznis, plus ono što traži sistem sa više kanala i više pravnih lica.

• Sve iz paketa Biznis, na Enterprise obimu
• Deljene isporuke: avansni pa konačni računi po politici isporuke
• Marketplace: računi kupcu na PIB prodavca, provizija kroz SEF
• Spoljni kanali: sajtovi, ERP, kase, paketomati i kuriri izdaju račune API-jem
• Bankovni izvodi iz više banaka, sravnjenje po banci i računu
• Svaki račun i kao PDF i kao termalni, isto za sve kanale
• Više pravnih lica, white-label, SLA sa dežurstvom

API dokumentacija

REST sa JSON telom, opisan u OpenAPI 3.1 (verzija 1.6.0). Specifikacija je javna i bez ključa, pa je vaš tim može uvesti u Postman, Swagger ili generator klijenta i pre ugovora.

Adresa

https://pos.narbiz.com

Format

JSON preko HTTPS-a (TLS)

Autentikacija

Zaglavlje X-Tezga-Api-Key; ključ ima oblik tzg_ plus 48 heksadecimalnih znakova

Ključevi

Do 20 imenovanih ključeva po firmi, jedan po sistemu; svaki se opoziva posebno, može biti samo za čitanje i vezan za listu IP adresa

Potpis tela

HMAC-SHA256 u zaglavlju X-Tezga-Signature; kad je tajna postavljena, obavezan za svaki upis

Idempotentnost

Po externalId: ponovljen zahtev vraća isti dokument sa statusom „postojalo“, nikad drugi račun

Ograničenja

120 upisa i 240 čitanja u minuti po firmi; za Enterprise se podiže do 10.000 u minuti

Veličina

Telo do 512 KB, do 500 stavki po pozivu

Okruženja

Produkcija, sandbox Poreske uprave i simulacija; isti ključ i isti kod, okruženje se čita iz GET /tax-labels

Svi pozivi

curl -X POST "https://pos.narbiz.com/api/integrations/order?provider=custom" \
  -H "X-Tezga-Api-Key: tzg_…" \
  -H "X-Tezga-Signature: sha256=…" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "WEB-100245981",
    "tok": "fiskalni",
    "nacinPlacanja": "Kartica",
    "cenaIzZahteva": true,
    "posaljiMejl": true,
    "kupac": { "naziv": "Kupac", "email": "kupac@primer.rs" },
    "stavke": [
      { "sifra": "JAK-0042", "naziv": "Jakna", "kolicina": 1,
        "cenaSaPdv": 12990, "poreskaStopa": "20" },
      { "naziv": "Dostava", "kolicina": 1, "cenaSaPdv": 390,
        "poreskaStopa": "20", "jedinicaMere": "usluga" }
    ]
  }'

{
  "ok": true,
  "status": "kreirano",
  "documentId": "b3f1…",
  "broj": "RAC2026000123",
  "statusDokumenta": "izdat",
  "ukupnoSa": "13380.00",
  "nacinPlacanja": "Kartica",
  "fiskalni": {
    "pfrBroj": "AB12CD34-AB12CD34-123",
    "pfrVreme": "2026-10-14T10:00:02.000Z",
    "brojacRacuna": "123/130ПП",
    "esirBroj": "1597/1.1",
    "verifikacioniUrl": "https://suf.purs.gov.rs/v/?vl=…"
  },
  "javniUrl": "https://pos.narbiz.com/r/7f3a…",
  "javniPdfUrl": "https://pos.narbiz.com/r/7f3a…/pdf"
}

javniUrl i javniPdfUrl rade bez prijave, pa ih ugrađujete u potvrdu kupovine. Kad Poreska uprava ne prihvati račun, odgovor je 202 sa ok:false, dokument ostaje izdat, a Tezga sama ponavlja fiskalizaciju.

Kodovi odgovora

200

Dokument izdat i fiskalizovan, ili je već postojao (status „postojalo“).

202

Dokument izdat, Poreska uprava ga još nije prihvatila; Tezga sama ponavlja fiskalizaciju.

400

Telo nije ispravan JSON ili nedostaje obavezno polje.

401

Ključ nedostaje ili nije ispravan, ili potpis ne valja.

402

Pretplata nije aktivna ili paket ne uključuje API.

403

Ključ samo za čitanje, ključ kase ili IP adresa van liste ključa.

404

Dokument nije nađen u vašoj firmi.

409

Pravila ne dozvoljavaju, ili se isti zahtev upravo obrađuje.

413

Telo je veće od 512 KB.

422

Oblik je ispravan, ali pravila nisu (npr. popust veći od iznosa). Ništa nije izdato.

429

Prekoračeno ograničenje; Retry-After kaže posle koliko sekundi.

Webhook-ovi

Tezga šalje POST na vašu adresu za događaje racun.fiskalizovan, racun.greska, refundacija.izvrsena i storno.izvrsen. Svaka isporuka nosi zaglavlja X-Tezga-Event, X-Tezga-Delivery i X-Tezga-Signature (HMAC-SHA256 tela). Ako vaš server ne odgovori, slanje se ponavlja posle 1, 5, 15, 60 i 360 minuta. Do 5 adresa po firmi, svaka sa svojom tajnom, a u telu je vaš externalId, pa uparivanje ne traži Tezgin id.

POST /vas-webhook
X-Tezga-Event: racun.fiskalizovan
X-Tezga-Delivery: 5c0e…
X-Tezga-Signature: sha256=…

{
  "dogadjaj": "racun.fiskalizovan",
  "vreme": "2026-10-14T10:00:03.000Z",
  "tenantId": "…",
  "podaci": {
    "documentId": "b3f1…",
    "broj": "RAC2026000123",
    "fiskalni": { "pfrBroj": "AB12CD34-AB12CD34-123" },
    "externalId": "WEB-100245981",
    "provider": "custom"
  }
}

import { createHmac, timingSafeEqual } from "node:crypto";

export function potpisIspravan(telo, zaglavlje, tajna) {
  const ocekivano =
    "sha256=" + createHmac("sha256", tajna).update(telo).digest("hex");
  const a = Buffer.from(zaglavlje ?? "");
  const b = Buffer.from(ocekivano);
  return a.length === b.length && timingSafeEqual(a, b);
}

Kako izgleda uvođenje

1. 01

   Razgovor

   Sa vašim tehničkim i finansijskim timom: kanali, platforme, broj sajtova i pravna lica.

2. 02

   Ugovor i NDA

   Ugovor na najmanje 3 godine, SLA i ugovor o obradi podataka; NDA pre uvida u sisteme.

3. 03

   Integracija

   Povezujemo platformu i ERP sa Tezgom i mapiramo prodaju, povrat, avans i otkazivanje.

4. 04

   Probni rad

   Ceo tok u sandbox okruženju Poreske uprave, sa istim ključem i istim kodom kao u produkciji.

5. 05

   Produkcija

   Prelazak je zamena sertifikata na nalogu; kod i API ključ ostaju isti.