Referenca

Katalog

Proizvodi i usluge sa cenom, jedinicom mere, GTIN-om i poreskim oznakama; uvoz i izvoz CSV-a.

6 operacija

Pročitaj proizvod

get/v1/products/{productId}

Scope catalogue:read

Jedan proizvod po identifikatoru.

Parametri

getProduct: Parametri
Polje	Gde	Tip	Opis
`productId`obavezno	path	uuid

Primer

GET /v1/products/{productId}

curl -X GET "https://api.bokapos.rs/v1/products/d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN"

Odgovori

getProduct: Odgovori
200 OK	Product`Product`
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`

200 OK

{
  "id": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60",
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "sku": "BT-HP-001",
  "gtin": "8606012345678",
  "name": "Bluetooth slušalice",
  "unitOfMeasure": "kom",
  "grossUnitPrice": 8990,
  "taxLabels": [
    "F"
  ],
  "isActive": true,
  "createdAt": "2026-08-22T10:00:00.000Z",
  "updatedAt": "2026-08-22T10:00:00.000Z"
}

Odgovor: Product

Opisi polja su preuzeti iz OpenAPI ugovora i na engleskom su; nazivi polja i vrednosti su isti u oba jezika.

getProduct: Odgovor
Polje	Tip	Opis
`id`obavezno	uuid
`taxpayerId`obavezno	uuid
`sku`obavezno	string
`gtin`opciono	string\| null (može biti null)
`name`obavezno	string
`unitOfMeasure`opciono	string\| null (može biti null)
`grossUnitPrice`obavezno	number	>= 0
`taxLabels`obavezno	array<string>
`isActive`obavezno	boolean
`createdAt`obavezno	date-time
`updatedAt`obavezno	date-time

Izmeni proizvod

put/v1/products/{productId}

Scope catalogue:write

Zamena svih uređivih polja. Obveznik je nepromenljiv; deaktivacija čuva istorijske snimke na računima.

Beleške iz ugovora (OpenAPI, engleski)

The owning taxpayer is immutable; deactivation preserves historical receipt snapshots.

Parametri

updateProduct: Parametri
Polje	Gde	Tip	Opis
`productId`obavezno	path	uuid

Telo zahteva application/json

updateProduct: Telo zahteva
Polje	Tip	Opis
`sku`obavezno	string	min 1max 100
`gtin`opciono	string\| null (može biti null)	max 32
`name`obavezno	string	min 1max 500
`unitOfMeasure`obavezno	string	min 1max 50
`grossUnitPrice`obavezno	number	>= 0step 0.01
`taxLabels`obavezno	array<string>	min 1 itemsunique
`isActive`obavezno	boolean

Primer

PUT /v1/products/{productId}

curl -X PUT "https://api.bokapos.rs/v1/products/d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "sku": "BT-HP-001",
  "gtin": "8606012345678",
  "name": "Bluetooth slušalice Pro",
  "unitOfMeasure": "kom",
  "grossUnitPrice": 9490,
  "taxLabels": [
    "F"
  ],
  "isActive": true
}'

Odgovori

updateProduct: Odgovori
200 OK	Updated product`Product`
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`
409 Conflict	The requested resource conflicts with an existing tenant-scoped record`Conflict`
422 Unprocessable Content	The command violates a Boka or fiscal rule`ErrorCode`

200 OK

{
  "id": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60",
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "sku": "BT-HP-001",
  "gtin": "8606012345678",
  "name": "Bluetooth slušalice Pro",
  "unitOfMeasure": "kom",
  "grossUnitPrice": 9490,
  "taxLabels": [
    "F"
  ],
  "isActive": true,
  "createdAt": "2026-08-22T10:00:00.000Z",
  "updatedAt": "2026-09-04T12:00:00.000Z"
}

Odgovor: Product

Opisi polja su preuzeti iz OpenAPI ugovora i na engleskom su; nazivi polja i vrednosti su isti u oba jezika.

updateProduct: Odgovor
Polje	Tip	Opis
`id`obavezno	uuid
`taxpayerId`obavezno	uuid
`sku`obavezno	string
`gtin`opciono	string\| null (može biti null)
`name`obavezno	string
`unitOfMeasure`opciono	string\| null (može biti null)
`grossUnitPrice`obavezno	number	>= 0
`taxLabels`obavezno	array<string>
`isActive`obavezno	boolean
`createdAt`obavezno	date-time
`updatedAt`obavezno	date-time

Uvezi katalog (CSV)

post/v1/products/import

Scope catalogue:write

Sve ili ništa: do 1.000 redova ili 5 MB, oznake razdvojene sa |. Prihvata i CSV iz srpskog Excela (BOM, sep=;, decimalni zarez).

Beleške iz ugovora (OpenAPI, engleski)

The import is all-or-nothing, accepts at most 1,000 rows or 5 MB, and uses `|` between tax labels.

Parametri

importProducts: Parametri
Polje	Gde	Tip	Opis
`taxpayerId`obavezno	query	uuid

Telo zahteva text/csv

text/csv

Primer

POST /v1/products/import

curl -X POST "https://api.bokapos.rs/v1/products/import?taxpayerId=3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  -H "Content-Type: text/csv" \
  --data-binary @katalog.csv

Odgovori

importProducts: Odgovori
200 OK	Import counts`ProductImportResult`
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`
409 Conflict	The requested resource conflicts with an existing tenant-scoped record`Conflict`
422 Unprocessable Content	The command violates a Boka or fiscal rule`ErrorCode`

200 OK

{
  "created": 1,
  "updated": 1,
  "total": 2
}

Odgovor: ProductImportResult

Opisi polja su preuzeti iz OpenAPI ugovora i na engleskom su; nazivi polja i vrednosti su isti u oba jezika.

importProducts: Odgovor
Polje	Tip	Opis
`created`obavezno	integer	>= 0
`updated`obavezno	integer	>= 0
`total`obavezno	integer	>= 1<= 1000

Izvezi katalog (CSV)

get/v1/products/export

Scope catalogue:read

Deterministički CSV jednog obveznika, isti format kao uvoz.

Parametri

exportProducts: Parametri
Polje	Gde	Tip	Opis
`taxpayerId`obavezno	query	uuid

Primer

GET /v1/products/export

curl -X GET "https://api.bokapos.rs/v1/products/export?taxpayerId=3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  --output katalog.csv

Odgovori

exportProducts: Odgovori
200 OK	Catalogue CSV using invariant decimals and `\|`-separated tax labels
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`

200 OK · text/csv

sku,name,gtin,unitOfMeasure,grossUnitPrice,taxLabels,isActive
BT-HP-001,Bluetooth slušalice,8606012345678,kom,8990.00,F,true
SRV-INST,Instalacija,,h,4000.00,F,true

Odgovor: ErrorCode

Opisi polja su preuzeti iz OpenAPI ugovora i na engleskom su; nazivi polja i vrednosti su isti u oba jezika.

exportProducts: Odgovor
Polje	Tip	Opis
`code`obavezno	string
`message`opciono	string

Lista proizvoda

get/v1/products

Scope catalogue:read

Katalog po obvezniku, sa pretragom po nazivu, šifri ili GTIN-u i filterom aktivnosti. Stranice preko cursor-a.

Parametri

listProducts: Parametri
Polje	Gde	Tip	Opis
`taxpayerId`opciono	query	uuid
`search`opciono	query	string	max 200
`isActive`opciono	query	boolean
`cursor`opciono	query	uuid
`pageSize`opciono	query	integer	>= 1<= 200default 50

Primer

GET /v1/products

curl -X GET "https://api.bokapos.rs/v1/products?taxpayerId=3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11&search=slu%C5%A1alice&isActive=true" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN"

Odgovori

listProducts: Odgovori
200 OK	Product page`ProductPage`
400 Bad Request	The command violates a Boka or fiscal rule`ErrorCode`
422 Unprocessable Content	The command violates a Boka or fiscal rule`ErrorCode`

200 OK

{
  "items": [
    {
      "id": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60",
      "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
      "sku": "BT-HP-001",
      "gtin": "8606012345678",
      "name": "Bluetooth slušalice",
      "unitOfMeasure": "kom",
      "grossUnitPrice": 8990,
      "taxLabels": [
        "F"
      ],
      "isActive": true,
      "createdAt": "2026-08-22T10:00:00.000Z",
      "updatedAt": "2026-08-22T10:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Odgovor: ProductPage

Opisi polja su preuzeti iz OpenAPI ugovora i na engleskom su; nazivi polja i vrednosti su isti u oba jezika.

listProducts: Odgovor
Polje	Tip	Opis
`items`obavezno	array<Product>
`id`obavezno	uuid
`taxpayerId`obavezno	uuid
`sku`obavezno	string
`gtin`opciono	string\| null (može biti null)
`name`obavezno	string
`unitOfMeasure`opciono	string\| null (može biti null)
`grossUnitPrice`obavezno	number	>= 0
`taxLabels`obavezno	array<string>
`isActive`obavezno	boolean
`createdAt`obavezno	date-time
`updatedAt`obavezno	date-time
`nextCursor`obavezno	uuid\| null (može biti null)

Dodaj proizvod

post/v1/products

Scope catalogue:write

Proizvod ili usluga sa šifrom, nazivom, jedinicom mere, bruto cenom (dve decimale) i poreskim oznakama. Stavke računa mogu, ali ne moraju, da se pozivaju na katalog.

Telo zahteva application/json

createProduct: Telo zahteva
Polje	Tip	Opis
`taxpayerId`obavezno	uuid
`sku`obavezno	string	min 1max 100
`gtin`opciono	string\| null (može biti null)	max 32
`name`obavezno	string	min 1max 500
`unitOfMeasure`obavezno	string	min 1max 50
`grossUnitPrice`obavezno	number	>= 0step 0.01
`taxLabels`obavezno	array<string>	min 1 itemsunique

Primer

POST /v1/products

curl -X POST "https://api.bokapos.rs/v1/products" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "sku": "BT-HP-001",
  "gtin": "8606012345678",
  "name": "Bluetooth slušalice",
  "unitOfMeasure": "kom",
  "grossUnitPrice": 8990,
  "taxLabels": [
    "F"
  ]
}'

Odgovori

createProduct: Odgovori
201 Created	Product`Product`
409 Conflict	The requested resource conflicts with an existing tenant-scoped record`Conflict`
422 Unprocessable Content	The command violates a Boka or fiscal rule`ErrorCode`

201 Created

{
  "id": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60",
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "sku": "BT-HP-001",
  "gtin": "8606012345678",
  "name": "Bluetooth slušalice",
  "unitOfMeasure": "kom",
  "grossUnitPrice": 8990,
  "taxLabels": [
    "F"
  ],
  "isActive": true,
  "createdAt": "2026-08-22T10:00:00.000Z",
  "updatedAt": "2026-08-22T10:00:00.000Z"
}

409 Conflict

{
  "code": "CATALOGUE_SKU_ALREADY_EXISTS",
  "message": "A product with this SKU already exists for the taxpayer."
}

Odgovor: Product

Opisi polja su preuzeti iz OpenAPI ugovora i na engleskom su; nazivi polja i vrednosti su isti u oba jezika.

createProduct: Odgovor
Polje	Tip	Opis
`id`obavezno	uuid
`taxpayerId`obavezno	uuid
`sku`obavezno	string
`gtin`opciono	string\| null (može biti null)
`name`obavezno	string
`unitOfMeasure`opciono	string\| null (može biti null)
`grossUnitPrice`obavezno	number	>= 0
`taxLabels`obavezno	array<string>
`isActive`obavezno	boolean
`createdAt`obavezno	date-time
`updatedAt`obavezno	date-time