Skip to content

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:
http
Authorization: Bearer <vaš token>
Accept: application/json
Content-Type: application/json
Accept-Language: sr

Accept-Language bira jezik poruka u odgovoru (npr. sr, en).

Odgovor ​

Svaki odgovor ima isti oblik:

json
{
  "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 kodZnačenje
401Token nije ispravan ili je poništen.
403Nema pristupa; kod PACKAGE_EXPIRED znači da je paket firme istekao.
404Zapis ne postoji.
422Podaci nisu ispravni (detalji u errors), ili bi se prešlo ograničenje paketa.
429Previše zahteva (kod TOO_MANY_ATTEMPTS): najviše 600 zahteva u minuti.

Čitanje šifarnika ​

http
GET /articles?page=1&per_page=200&search=mleko
GET /fixed-assets
GET /locations
GET /warehouses

Parametri: 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.

http
POST /articles/bulk-sync
json
{
  "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}.

EndpointKljučPolja
POST /articles/bulk-synccodename, unit, price, tax_rate, weight, description, status (active / inactive)
POST /fixed-assets/bulk-syncinventory_numbername, unit, serial_number, type (fixed_asset / small_inventory), quantity, price, description, status
POST /locations/bulk-synccodename, city, address, email, status
POST /warehouses/bulk-synccodename, location_code, status
  • Pošaljite lokacije pre magacina: magacin sa nepoznatom location_code se 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 ​

http
GET /counts?completed_only=1&date_from=2026-09-01&date_to=2026-09-30

Filteri: status, completed_only=1, type, date_from, date_to, location_id.

http
GET /counts/{id}/report-data
GET /counts/latest/report-data

Vrać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:

json
{
  "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.