Popis API
Vaš program poziva Popis: šalje šifarnike i čita rezultate popisa. Na portalu izaberite režim Oni pristupaju našem API-ju i kliknite Generiši token (API sinhronizacija). Token se prikazuje samo jednom — odmah ga kopirajte.
Svaki poziv sa poljima, primerima i dugmetom Try it: API referenca
Pristup
- Bazni URL:
https://portal.popis.pro/api/v1 - Zaglavlja:
Authorization: Bearer <vaš token>
Accept: application/json
Content-Type: application/json
Accept-Language: srAccept-Language bira jezik poruka u odgovoru (npr. sr, en).
Odgovor
Svaki odgovor ima isti oblik:
{
"status": true,
"message": "success",
"data": [ ... ],
"meta": { "pagination": { "current_page": 1, "per_page": 50, "total": 128, "last_page": 3, "from": 1, "to": 50 } },
"errors": [],
"code": ""
}| HTTP kod | Značenje |
|---|---|
| 401 | Token nije ispravan ili je poništen. |
| 403 | Nema pristupa; kod PACKAGE_EXPIRED znači da je paket firme istekao. |
| 404 | Zapis ne postoji. |
| 422 | Podaci nisu ispravni (detalji u errors), ili bi se prešlo ograničenje paketa. |
| 429 | Previše zahteva (kod TOO_MANY_ATTEMPTS): najviše 600 zahteva u minuti. |
Čitanje šifarnika
GET /articles?page=1&per_page=200&search=mleko
GET /fixed-assets
GET /locations
GET /warehousesParametri: page, per_page (podrazumevano 10, najviše 200), search, sort_by, sort_direction (asc / desc). Stranice su opisane u meta.pagination.
Slanje šifarnika (bulk-sync)
Jednim zahtevom šaljete više zapisa. Postojeći se prepoznaju po šifri i menjaju, novi se dodaju, a ništa se ne briše.
POST /articles/bulk-sync{
"items": [
{ "code": "ART001", "name": "Mleko 1L", "unit": "kom", "price": 89.99, "tax_rate": 20, "weight": 1.05, "status": "active" },
{ "code": "ART002", "name": "Hleb beli", "unit": "kom" }
]
}Odgovor: {"synced": 2, "new": 1, "updated": 1}.
| Endpoint | Ključ | Polja |
|---|---|---|
POST /articles/bulk-sync | code | name, unit, price, tax_rate, weight, description, status (active / inactive) |
POST /fixed-assets/bulk-sync | inventory_number | name, unit, serial_number, type (fixed_asset / small_inventory), quantity, price, description, status |
POST /locations/bulk-sync | code | name, city, address, email, status |
POST /warehouses/bulk-sync | code | name, location_code, status |
- Pošaljite lokacije pre magacina: magacin sa nepoznatom
location_codese preskače (odgovor:{"synced": …, "skipped": …}). - Ako bi novi zapisi prešli ograničenje paketa, zahtev se odbija sa 422.
- Barkodove, pakovanja i praćenje artikla šaljete pojedinačno, preko
POST /articles— polja su opisana u API referenci.
Rezultati popisa
GET /counts?completed_only=1&date_from=2026-09-01&date_to=2026-09-30Filteri: status, completed_only=1, type, date_from, date_to, location_id.
GET /counts/{id}/report-data
GET /counts/latest/report-dataVraća izveštaj popisa (latest = poslednji završeni popis). U izveštaj ulaze samo završene popisne liste. Parametri: group_by_warehouse=1, warehouse_id, row_filter=uncounted ili duplicates, page, per_page (podrazumevano 50, najviše 500). Kod ovog endpointa stranice su u data.pagination. Sadržaj polja data:
{
"count": { "id": 254, "number": "DOK-0022-2026", "type": "goods", "status": "completed", "location": "Lokacija 1", "warehouse": "Magacin robe", "completed_at": "2026-09-18 10:15:00" },
"items": [
{ "code": "ART001", "name": "Mleko 1L", "unit": "kom", "barcode": "8600001234567",
"counted": 98, "in_stock": 100, "difference": -2, "price": 89.99,
"counted_value": 8819.02, "stock_value": 8999.0, "diff_value": -179.98, "tax_rate": 20, "is_counted": true }
],
"totals": { "unique_items": 1, "counted": 98, "in_stock": 100, "difference": -2, "counted_value": 8819.02, "stock_value": 8999.0 },
"pagination": { "current_page": 1, "per_page": 50, "total": 1, "last_page": 1 }
}in_stock i vrednosti stanja postoje kada magacin ima stanje. Isti podaci se u portalu vide u Izveštaju popisa.

