Fiskalizacija preko API-ja za web shop i platforme

Kada kupac plati, vaš sistem pošalje jedan zahtev. BokaPOS izda fiskalni račun preko V-PFR-a Poreske uprave i vrati broj računa, QR kod, verifikacioni link i PDF.

Zatražite demo API dokumentacija

Probno okruženje je besplatno. WooCommerce dodatak je besplatan.

Odobren od Poreske uprave

IB 1774

Rešenje: 000-092-00-00256/2026-0000
Datum: 29. oktobra 2026.
Model: BokaPOS 1.0.1, ESIR klase Napredni
Namena: Isključivo prodaja na daljinu, prenosivo

Rešenje (PDF)Registar Poreske uprave

Primer: jedna porudžbina, jedan fiskalni računKako radi API za fiskalizaciju

POST/v1/fiscal-documents

curl -X POST "https://api.bokapos.rs/v1/fiscal-documents" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  -H "Idempotency-Key: order-4127-sale-1" \
  -H "Content-Type: application/json" \
  -d '{
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
  "clientReference": "ORDER-4127",
  "invoiceType": "NORMAL",
  "transactionType": "SALE",
  "cashier": {
    "id": "web-shop"
  },
  "items": [
    {
      "name": "Bluetooth slušalice",
      "unitOfMeasure": "kom",
      "quantity": 1,
      "unitPrice": 8990,
      "taxLabels": [
        "F"
      ]
    }
  ],
  "payments": [
    {
      "type": "CARD",
      "amount": 8990
    }
  ]
}'

Zahtev primljenIsti ključ porudžbine nikad ne izda dva računa.
Poreske oznake proverenePrema važećoj konfiguraciji Poreske uprave za vaš prostor.
Poslat V-PFR-uVeza ide preko bezbednosnog elementa obveznika, V-PFR potpisuje račun.
Račun sačuvan201 stiže tek kada je potpisan odgovor trajno sačuvan.

201Created

{
  "id": "9f8e7d6c-5b4a-4321-8765-0fedcba98761",
  "clientReference": "ORDER-4127",
  "status": "FISCALIZED",
  "fiscalized": true,
  "pfr": {
    "invoiceNumber": "JWX4K9PL-JWX4K9PL-1042",
    "sdcTime": "2026-09-01T10:15:32.483+02:00",
    "totalAmount": 8990,
    "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA..."
  },
  "receipt": {
    "pdfA4Url": "/v1/fiscal-documents/9f8e7d6c-5b4a-4321-8765-0fedcba98761/representations/pdf-a4"
  }
}

JWX4K9PL-JWX4K9PL-1042Broj fiskalnog računa iz potpisanog odgovora.

Povežite prodavnicu koju već imate

Za WooCommerce postoji besplatan dodatak. Sve ostale platforme pozivaju isti API, jednim pozivom po porudžbini.

Sve integracije

Svaka vrsta računa koju propis poznaje

BokaPOS je ESIR napredne klase. Uz promet podržava tokove koje online prodaja i naplata firmama traže svakog dana.

Vrste računa

VrstaU API-juKada

Promet prodajaNORMALSALEkupac je platio porudžbinu

Promet refundacijaNORMALREFUNDpovraćaj, uz poziv na originalni račun

AvansADVANCESALEuplata unapred, zatvaranje konačnim računom

PredračunPROFORMASALEponuda kupcu pre plaćanja

ObukaTRAININGSALEvežbanje koje ne ulazi u promet

KopijaCOPYSALEzvanična kopija ranijeg računa

Prikazi računa

Sve mogućnosti

Svaki fiskalizovan račun ima sedam prikaza. Kupcu šaljete PDF ili link, svom sistemu JSON.

Zvanični tekstofficial-text
PDF A4pdf-a4
PDF 80 mmpdf-80mm
PDF 58 mmpdf-58mm
Slika za e-mailpreview-png
QR kod za proveruqr-svg
JSON paketcanonical-json

Račun postoji tek kada ga Poreska uprava potpiše

Svaki zahtev dobija status, a samo jedan status znači račun. Ono što nije potvrđeno nikad se ne prikazuje kao račun i nikad se ne šalje ponovo naslepo.

Bezbednosni element: Šifrovan u trezoru, otvara se samo za tačan poslovni prostor.
Podaci: U Evropskoj uniji, odvojeni po organizaciji, svaki račun trajno sačuvan.
Pristup: Sistemi pristupnim ključem, ljudi e-mailom i lozinkom, uloge po organizaciji.

FiskalizovanFISCALIZED
V-PFR je potpisao račun i odgovor je trajno sačuvan. Jedini status koji znači račun.
OdbijenREJECTED
Poreska uprava je odbila podatke. Ništa nije izdato; ispravite i pošaljite sa novim ključem.
Nije fiskalizovanNOT_FISCALIZED
Ništa nije poslato. Isti zahtev sa istim ključem može ponovo, bez rizika od dva računa.
Ishod nepoznatOUTCOME_UNKNOWN
Zahtev je možda stigao, odgovor nije. Ne šalje se ponovo; BokaPOS razrešava ishod samo čitanjem.

Statusi u dokumentaciji

Kada prodaja ne ide kroz web shop, tu je cloud POS

Operater izdaje račun iz pregledača, sa istim katalogom, obveznikom i dnevnikom kao API.

Prodaja, refundacija, avans, predračun, obuka i kopija
Katalog proizvoda sa GTIN-om i uvozom iz CSV tabele
Dnevnik sa pretragom, izvozom i svim formatima računa
Podešavanje logotipa, boja i komercijalne poruke

Otvorite cloud.bokapos.rs

`cloud.bokapos.rs`Nova prodaja u cloud POS-u

Jedna cena po elementu, bez skrivenih stavki

Osnova po produkcionom bezbednosnom elementu, uključeni dokumenti za celu organizaciju i dva modula koje uključite kada zatrebaju.

Izračunajte mesečni iznos

Prvi mesec se obračunava srazmerno broju dana. Nema blokade na prekoračenju.

Mesečna pretplata

1.600RSD mesečno

po produkcionom bezbednosnom elementu, sa PDV-om

Uključeno dokumenata: 600 / mesec
Preko uključenih: 1 RSD / dokument
Modul Avans: +600 RSD / mesec
Modul E-mail: +600 RSD / mesec
Sandbox okruženje: besplatno

Česta pitanja

Sva pitanja

Da li mi treba fiskalni uređaj ili L-PFR?

Ne. BokaPOS je ESIR koji fiskalizuje preko virtuelnog procesora (V-PFR) Poreske uprave. Potreban je samo bezbednosni element u obliku datoteke koji obveznik dobija od Poreske uprave za prodaju na daljinu.

Za koga je BokaPOS?

Za web shopove, SaaS i pretplate, marketplace platforme, dostavu i svaku prodaju na daljinu gde račun nastaje u sistemu, a ne na kasi. Cloud POS pokriva i deo prodaje koji operater unosi ručno.

Šta se dešava kada pređem uključenih 600 dokumenata?

Svaki dodatni dokument u tom kalendarskom mesecu je 1 RSD. Nema blokade i nema promene paketa; iznos se vidi na stranici pretplate tokom meseca.

Šta se računa kao dokument?

Svaki dokument koji dobije potpisan odgovor Poreske uprave: prodaja, refundacija, avans, predračun, obuka i kopija. Odbijeni i neuspešni pokušaji se ne naplaćuju.

Koliko traje integracija?

Dan ili dva za tipičnu integraciju web shopa, uključujući testiranje refundacije. Jedan poziv izdaje račun, drugi ga preuzima u željenom formatu, a uz probno okruženje i primere sve testirate pre prvog pravog računa.

Prvi račun u probnom okruženju, isti dan

Pošaljite nam par rečenica o prodaji. Javljamo se istog radnog dana sa probnim pristupom i primerima za vaš sistem.

Zatražite demo Pročitajte API dokumentaciju