Skip to content

Vaš API (Popis preuzima) ​

Popis poziva vaš API i preuzima šifarnike. Na portalu izaberite režim Mi preuzimamo sa njihovog API-ja, upišite API URL i API Ključ i uključite šta se sinhronizuje (API sinhronizacija).

Svaki poziv koji Popis šalje, sa poljima i primerima: API referenca

Zahtevi koje Popis šalje ​

Za svaki uključeni šifarnik Popis šalje jedan zahtev:

http
GET {API URL}/articles
GET {API URL}/fixed-assets
GET {API URL}/locations
GET {API URL}/warehouses

X-API-Key: <API Ključ>
Accept: application/json

Vaš API treba da:

  • odgovori kodom 2xx i zaglavljem Content-Type: application/json;
  • vrati sve zapise odjednom (Popis ne traži stranice), kao niz [ … ] ili kao { "data": [ … ] };
  • odgovori za najviše 60 sekundi.

Primer odgovora za /articles:

json
[
  { "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", "price": 45 }
]

Polja koja Popis čita ​

EndpointKljučPolja
/articlescodename, unit, price, tax_rate, weight, description, status
/fixed-assetsinventory_numbername, unit, serial_number, type (fixed_asset / small_inventory), quantity, price, description, status
/locationscodename, city, address, email, status
/warehousescodename, location_code, status
  • Zapis bez ključa (code, odnosno inventory_number) se preskače. status je active ili inactive (inače active).
  • Postojeći zapisi se prepoznaju po ključu i menjaju, novi se dodaju. Preuzimanje nikada ništa ne briše u Popisu.
  • Magacin mora imati location_code lokacije koja već postoji u Popisu — zato lokacije sinhronizujte pre magacina.
  • Barkodove Popis ne preuzima preko ovog API-ja; unesite ih u Popisu ili ih pošaljite preko Popis API-ja.

Podatke preuzimate ručno, dugmadima Ručna sinhronizacija na portalu; automatskog preuzimanja nema.

Test konekcije ​

Testiraj konekciju na portalu poziva svaki uključeni endpoint i proverava da prvi zapis ima ključ i name. Poruke: Svi endpointi (N) su uspešno provereni., U odgovoru nedostaje obavezno polje "…"., Odgovor nije validan JSON niz.

Izveštaj posle popisa ​

Ako je uključeno Automatski pošalji izveštaj po završetku popisa, Popis po završetku svakog popisa (na portalu ili u aplikaciji) šalje:

http
POST {API URL}/report
X-API-Key: <API Ključ>
Content-Type: application/json
json
{
  "count_number": "DOK-0022-2026",
  "type": "goods",
  "mode": "complete",
  "status": "completed",
  "location": "Lokacija 1",
  "warehouse": "Magacin robe",
  "items": [
    { "code": "ART001", "name": "Mleko 1L", "unit": "kom", "counted": 98, "price": 89.99, "barcode": "8600001234567",
      "rows": [ { "list_number": "LST-0013-2026", "bin": null, "serial": null, "lot": null, "quantity": 98, "expire_date": null } ] }
  ]
}

Kod popisa osnovnih sredstava code je inventarni broj. rows su pojedinačni unosi sa popisnih lista (sa pozicijom, serijskim brojem ili lotom i njegovim rokom trajanja, ako se vode). Vaš API treba da odgovori za najviše 30 sekundi.