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:
GET {API URL}/articles
GET {API URL}/fixed-assets
GET {API URL}/locations
GET {API URL}/warehouses
X-API-Key: <API Ključ>
Accept: application/jsonVaš 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:
[
{ "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
| Endpoint | Ključ | Polja |
|---|---|---|
/articles | code | name, unit, price, tax_rate, weight, description, status |
/fixed-assets | inventory_number | name, unit, serial_number, type (fixed_asset / small_inventory), quantity, price, description, status |
/locations | code | name, city, address, email, status |
/warehouses | code | name, location_code, status |
- Zapis bez ključa (
code, odnosnoinventory_number) se preskače.statusjeactiveiliinactive(inačeactive). - 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_codelokacije 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:
POST {API URL}/report
X-API-Key: <API Ključ>
Content-Type: application/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.

