Pređi na sadržaj

API dokumentacija

Prelazak u produkciju

Kod se ne menja. Menjaju se sertifikat, licenca i kredencijal, a nekoliko stvari koje su u sandboxu bile opuštene postaju stroge. Ovo je redosled i kontrolna lista.

Ažurirano: 29. 8. 2026. · Verzija ugovora 1.0.0

Redosled

  1. 01

    Vlasnik pribavi bezbednosni element

    Ovlašćeno lice obveznika u portalu Poreske uprave zatraži bezbednosni element u obliku datoteke za poslovni prostor za prodaju na daljinu i preuzme originalni ZIP (PFX, lozinka, PAK). BokaPOS nikad ne pristupa portalu Poreske uprave u vaše ime.

  2. 02

    Vlasnik otpremi element u BokaPOS portal

    U cloud.bokapos.rs, Bezbednosni elementi: originalni ZIP plus lozinka i PAK, kroz šifrovanu jednokratnu sesiju u pregledaču. Element je vezan za tačnog obveznika i prodajno mesto.

  3. 03

    BokaPOS proveri i aktivira

    BokaPOS administracija proverava lanac, JID i PIB i aktivira element jednim dokumentom obuke (Обука), koji ne utiče na porez. Od tada element može da potpisuje.

  4. 04

    Licenca

    BokaPOS izdaje licencu organizaciji (osnovna pretplata po produkcionom elementu, plus moduli Avans i E-mail po potrebi). GET /v1/license vraća productionFiscalizationAllowed: true.

  5. 05

    Produkcioni kredencijal

    BokaPOS izdaje boka-prod-... client id i tajnu. Vaš sistem ih dobija kao tajnu konfiguracije.

  6. 06

    Zamena i provera

    Zamenite client id i tajnu, pozovite GET /v1/runtime, pa GET /v1/tax-rates. Prvi produkcioni račun proverite na suf.purs.gov.rs preko pfr.verificationUrl.

  7. 07

    Sandbox ostaje dostupan

    Sandbox kredencijal i element nastavljaju da rade za dalje testiranje. Od trenutka kada je produkcioni kredencijal aktivan, portal sakriva sandbox podatke organizacije (probnog obveznika BOKA GROUP DOO, njegovo prodajno mesto, probni element i sve sandbox dokumente) da ih niko ne pomeša sa pravim računima; vlasnik ih može ponovo prikazati u Podešavanjima. API to ne menja: svaki ključ vidi samo svoje okruženje.

Šta je drugačije u produkciji

TemaSandboxProdukcija
Adresa i kodapi.bokapos.rsisto
Kredencijalboka-sbx-...boka-prod-...; objekat drugog okruženja je za vas 404, a ukrštanje elementa vraća 403 CREDENTIAL_ENVIRONMENT_MISMATCH
Podacisamo sandbox obveznici, prodajna mesta, elementi i dokumentisamo produkcioni; isti PIB može da postoji jednom u svakom okruženju
Bezbednosni elementBokaPOS-ov iz fonda, PIB BOKA GROUP DOO na računuvaš sertifikat, vaš PIB i naziv na računu
Verifikacijasandbox.suf.purs.gov.rssuf.purs.gov.rs
Poreske oznaketest skup (F, A, Ж...)zvanične srpske oznake (Ђ, Е, Г, А...), iz GET /v1/tax-rates
Avansne stavke10: Аванс (X) za bilo koju oznakuisključivo 10: Аванс (Ђ), 11: Аванс (Е), 12: Аванс (Г), 13: Аванс (А)
Licencanikad ne blokiraprodaja, kopija, predračun, obuka i avans traže važeću licencu; refundacija i storno nikad
Modulisve radiAvans i E-mail traže uključen modul
Dostava e-poštomradi ako je uključena u portaluisto, plus modul E-mail
Cenabesplatnopo cenovniku; 600 dokumenata mesečno uključeno

Kontrolna lista pre prvog produkcionog računa

  • Poreske oznake se čitaju iz GET /v1/tax-rates, ne iz konfiguracije; mapiranje vaših poreskih grupa na oznake je proverljivo i pokriva sve stope koje prodajete.
  • Idempotency-Key se čuva pre slanja i ponavlja istim ključem posle prekida.
  • Obrada OUTCOME_UNKNOWN postoji i testirana je: bez novog zahteva, sa praćenjem GET /v1/operations/{id} i eskalacijom operateru.
  • Iznosi su na dve decimale, količine na tri; zbir stavki i plaćanja se poklapa.
  • Kupac dobija verifikacioni link (i PDF ili sliku) za svaki račun, a fiskalni deo se ne menja.
  • Refundacija ide kroz /v1/refund-workflows sa identifikacijom kupca; kod gotovine štampate kopiju za potpis.
  • Ako koristite avanse: nazivi avansnih stavki se sastavljaju iz oznake, commercialFooter je popunjen, zatvaranje šalje samo doplatu.
  • Nadzor: GET /v1/security-elements (istek sertifikata) i GET /v1/license (stanje) se proveravaju periodično; 401/403/503 se alarmiraju.
  • Tajna kredencijala je samo na serveru, u tajnama okruženja; logovi ne sadrže token.
  • Test u sandboxu je prošao: jedna prodaja, jedna delimična refundacija, jedna pretraga dnevnika, jedan PDF.

Podrška

BokaPOS administracija: office@bokagroup.rs, +381 69 558 55 88. Uz zahtev pošaljite id operacije i clientReference; nikad token, tajnu ni sertifikat. Promene ugovora se najavljuju u OpenAPI datoteci (verzija u info.version) i na ovoj stranici.