Használat
Telepítés
Az app iPhone-on működik, iOS 26 vagy újabb rendszerrel.
- 1Töltsd le az appot
Keresd így: Keszlet.app - Vonalkódolvasó. Az iPhone-on Kódolvasó néven látod.
- 2Engedd meg a kamerát
Az első indításkor az app engedélyt kér. A kamerát csak kódolvasásra használja.
- 3Párosíts, vagy kezdd el saját listával
Párosítás nélkül is olvashatsz. Ilyenkor a kódok a Saját listába kerülnek.
Párosítás
Egyszer kell megcsinálni.
A programban kérj párosító QR kódot.
Koppints a Párosítás gombra, és olvasd be.
Erősítsd meg, és a főképernyőn látod a programot.
- A QR kód néhány percig érvényes, és csak egyszer használható.
- A telefon a te nevedben és a te jogosultságaiddal dolgozik.
Az app módjai
Hogy melyik látszik, azt a párosított program dönti el.
Infó
Gyorsan megnéznéd egy cikk adatait.Beolvasod a kódot, és látod a nevét, cikkszámát, készletét, polcát.
Küldés gépre
A gépen dolgozol, de nincs kézi olvasód.A kód abba a mezőbe kerül, ahol a gépen a kurzor áll, a végén Enterrel.
Folyamatok
Leltár, bevételezés, komissiózás.A program lépésenként mondja, mit olvass be, és mennyiséget is kérhet.
Saját lista
Nincs párosítás, vagy csak gyűjtenél.A kódok darabszámmal listába kerülnek, amit CSV-ben megoszthatsz.
Futó munkák
Ha a programodban fut egy leltár, azt a csempén látod.
- Egy futó munkánál a csempére koppintva rögtön abban dolgozol. Ha több fut, kiválasztod, melyikben.
- A felső sorban a munka neve áll. Rákoppintva másikra válthatsz.
- Az állapotsorra vagy a ⋯ menü Állapot pontjára koppintva látod a részleteket, pl. a köröket, a kész és a hátralévő polcokat, és hogy ki számol most.
- A sárga sáv azt jelzi, hogy polckódot vár. Szürke sávnál a cikket olvasd be.
- A piros szám azt mutatja, hány teendő vár rád, pl. egy megerősítés. A Teendőid listában koppintással megnyitod.
- Ha egy kolléga közben máshol dolgozik ugyanabban, azonnal látod.
Olvasás
Tartsd a kódot a keretbe.
Folyamatos olvasás
Az app magától olvas, amint kódot lát. Gyors, ha sok cikket olvasol egymás után.
Gombnyomásos olvasás
Csak a nagy gomb vagy a hangerőgomb nyomása alatt olvas. Zsúfolt polcnál ezzel nem olvasol be véletlenül mást.
| Eszköz | Mire jó |
|---|---|
Lámpa | Koppintás ki-be. Hosszan nyomva automatikus módra is állíthatod. |
Nagyítás | 1×, 1,5×, 2× és 3× között váltasz, az app megjegyzi. |
Kézi beírás | Sérült címkénél beírhatod a kódot. |
Ismétlésszűrés | Ugyanazt a kódot 2 mp-ig nem olvassa újra. A Beállításokban állíthatod. |
Jelzések
A hangból tudod, mi történt, nem kell a képernyőt nézned.
Értesítések
- Ha a programod szól, az app értesítést küld, amikor dolgod van, pl. egy megerősítés vár rád. Rákoppintva a megfelelő munka nyílik meg.
- Az app ikonján a teendőid száma látszik.
- Az értesítéseket a telefon Beállítások menüjében kapcsolhatod ki.
Ha nincs net
- Ahol a program engedi, az app elmenti a beolvasást, és amint van net, elküldi.
- Kétszer nem számolódik semmi, akkor sem, ha valamit újra kell küldeni.
keszlet.app-pal
- 1Nyisd meg a Beállítások → Vonalkódolvasó menüt
Minden felhasználó eléri, mert mindenki a saját telefonját párosítja.
- 2Kattints a Párosítás gombra
Olvasd be a QR kódot az appal. A telefon megjelenik a Párosított telefonok listában.
- 3Használd
Infó, küldés gépre és leltár. A leltárhoz leltár jogosultság kell.
Bekötés saját rendszerbe
Hogyan működik?
Az app beolvas, a programod válaszol, az app megmutatja.
Mit kell megírnod?
Nem kell mindent. Az első két szinttel már működik.
POST /pair · GET /manifest · DELETE /pairPOST /scans (lookup)POST /scans (send)POST /sessions · GET /sessions/{id} · POST …/actions/{id} · POST /prompts/{id}workflows[].items · GET /sessions/{id}/detailsmanifest events · SSEPUT /device · relé /sendAlapszabályok
- HTTPS és JSONUTF-8, camelCase kulcsok.
- Relatív végpontokAz alap URL a QR kódból jön, pl. https://app.example.hu/api/scanner.
- IdőpontokISO 8601, UTC-ben, pl. 2026-11-19T10:15:30Z.
- MennyiségekTizedes pontos string, pl. "2.5", hogy ne legyen kerekítési hiba.
- Minden kulcs legyen ottHa nincs érték, null vagy []. Ismeretlen kulcsot az app átugrik.
- A szöveget te adodCímek, üzenetek a felhasználó nyelvén. Az app nem fordít.
Authorization: Bearer <token>
Accept: application/json
Accept-Language: hu
X-Scanner-Protocol: 1
X-Scanner-Device: <eszközazonosító>A POST /pair kivételével minden kérésben ott a token.
Párosítás
1. A programod QR kódot mutat
keszletscan://pair?v=1&url=https%3A%2F%2Fapp.example.hu%2Fapi%2Fscanner&code=K7Q2-9XLM| Paraméter | Jelentés |
|---|---|
v | Protokoll verzió, most 1. |
url | Az alap URL, URL-kódolva. Csak https lehet, fejlesztéskor helyi cím is. |
code | Egyszer használható kód. Javaslat 5 perc érvényesség, legalább 8 véletlen karakter. |
2. Az app párosít
/pairtoken nélkülAz eszköz id-ja állandó. Újrapárosításkor ugyanazt küldi, így felülírhatod a régit.
{
"code": "K7Q2-9XLM",
"device": {
"id": "6F1C2B0E-6A43-4C3C-9B8E-2C1D7F0A9E11",
"name": "Raktár iPhone",
"model": "iPhone17,1",
"system": "iOS 26.1",
"appVersion": "1.0.0"
}
}{
"token": "a3f9c1e07b…",
"manifest": { … }
}A token nem jár le, de visszavonhatod. Érvénytelen kódra 400 vagy 410 a válasz.
3. Párosítás megszüntetése
/pairTöröld a tokent, és válaszolj 204-gyel. Ha nincs net, az app ettől még a saját oldalán megszünteti a párosítást.
Manifest
Ebből tudja az app, mit mutasson a főképernyőn.
/manifestInduláskor, előtérbe kerüléskor és a főképernyő lehúzásakor kéri le.
{
"protocolVersion": 1,
"host": {
"name": "Saját ERP",
"account": "Minta Kft.",
"logoUrl": "https://app.example.hu/logo-256.png"
},
"user": { "name": "Kiss Anna" },
"capabilities": { "lookup": true, "send": true, "push": true },
"badge": 1,
"events": {
"url": "https://rt.example.hu/scanner/events?ticket=eyJ…",
"expiresAt": "2026-11-20T16:15:30Z"
},
"workflows": [
{
"id": "stocktake",
"title": "Leltár",
"subtitle": "Polconként számolsz",
"icon": "list.clipboard",
"offline": false,
"badge": 1,
"itemsTitle": "Futó leltárak",
"emptyText": "Nincs futó leltár",
"requiresItem": true,
"items": [
{
"id": "inv-7",
"title": "Őszi leltár",
"subtitle": "Központi raktár",
"icon": null,
"color": null,
"badge": 1,
"sessionId": "st-1842"
}
]
}
],
"sessions": []
}| Mező | Jelentés |
|---|---|
host.name | A program neve a főképernyőn. |
host.account | Cég vagy fiók neve. Lehet null. |
host.logoUrl | Négyzetes kép, legalább 128×128 px. Lehet null. |
capabilities | lookup az Infó mód, send a Küldés gépre, push a push értesítés. |
badge | A felhasználóra váró teendők száma. Az app ikonján látszik. |
events | A valós idejű értesítés címe, lásd lent. Lehet null. |
workflows | Indítható folyamatok. Az icon egy SF Symbol név. |
workflows[].items | A futó munkák, pl. leltárak. Egynél a csempe rögtön abba visz, többnél választani lehet. |
workflows[].requiresItem | Ha true, a folyamat csak egy futó munkához indul. |
sessions | Nyitott munkamenetek a Folytatás alatt, ha a folyamatnak nincsenek items-ei. |
Beolvasás és eredmény
Minden beolvasott kód ide jön. A target mondja meg, melyik módban.
/scans{
"id": "0B6E8A55-2E1D-4F6B-8C07-3B4A1D6E9F20",
"code": "5990000000017",
"symbology": "ean13",
"scannedAt": "2026-11-19T10:15:30Z",
"target": "lookup",
"sessionId": null
}{
"tone": "success",
"title": "Bőr hátizsák, barna",
"subtitle": "BAG-0142",
"imageUrl": "https://app.example.hu/img/bag-0142.jpg",
"fields": [
{ "label": "Készlet", "value": "14 db" },
{ "label": "Polc", "value": "A-01-03" }
],
"prompt": null,
"session": null
}| Mező | Jelentés |
|---|---|
id | Idempotencia kulcs. Ha ugyanez jön újra, add vissza ugyanazt az eredményt. |
target | lookup (Infó), send (Küldés gépre) vagy session (folyamat). Send esetén a kódot juttasd el a gépen nyitott ablakba, pl. websocketen. |
sessionId | Csak session célnál, egyébként null. |
symbology | ean13, ean8, upce, code128, code39, code93, itf14, interleaved2of5, codabar, gs1DataBar, gs1DataBarExpanded, gs1DataBarLimited, qr, microQR, dataMatrix, pdf417, microPDF417, aztec, manual |
Az eredmény mezői
| Mező | Jelentés |
|---|---|
tone | success, warning, error vagy info. Ez dönti el a hangot és a színt. |
title | Rövid, egy sor. Ez a legnagyobb felirat. |
subtitle | Pl. cikkszám. Lehet null. |
fields | Címke-érték párok. Legfeljebb 6 ajánlott. |
prompt | Ha még adat kell, lásd a Bekérésnél. Egyébként null. |
session | session célnál a munkamenet friss állapota. |
Bekérés
Ha egy beolvasás után adat kell (pl. mennyiség), az eredménybe prompt kerül.
{
"id": "pr-77812",
"kind": "quantity",
"title": "Hány darab van?",
"message": "Bőr hátizsák, barna",
"submitLabel": "Mentés",
"quantity": { "value": "1", "unit": "db", "decimals": 0, "min": "0", "max": null },
"text": null,
"choice": null
}| kind | Mit kér és mi a válasz |
|---|---|
quantity | Mennyiség mértékegységgel, korlátokkal. A válasz pl. "12". |
text | Szöveg, default vagy number billentyűzettel. A válasz a beírt szöveg. |
choice | Választás a listából. A válasz a választott id. |
confirm | Igen vagy mégse. A válasz null. |
/prompts/{id}A válaszod újabb eredmény, benne akár újabb prompttal. Így a lépések láncolhatók.
{ "answer": "submit", "value": "12" }
// Mégse esetén
{ "answer": "cancel", "value": null }Folyamatok
Egy folyamat (pl. leltár) a programodban egy munkamenet.
/sessionsTörzs: { "workflowId": "stocktake", "itemId": "inv-7" }. Ugyanahhoz a munkához a meglévő munkamenetet add vissza. A fejlécben váltáskor is ez hívódik.
/sessions/{id}Friss állapot, amikor a felhasználó visszatér egy munkamenethez.
/sessions/{id}/actions/{actionId}Gombnyomás a munkamenet alján. Törzs nélkül, a válasz az új állapot.
{
"id": "st-1842",
"workflowId": "stocktake",
"title": "Őszi leltár",
"subtitle": "Központi raktár",
"itemId": "inv-7",
"status": "open",
"hint": "Olvasd be a polc kódját",
"hintIcon": "square.grid.3x3",
"hintColor": "yellow",
"context": [{ "label": "Szakasz", "value": "Számlálás", "icon": "flag", "color": null, "tone": null }],
"progress": { "done": 12, "total": 40, "label": "polc", "segments": null },
"details": true,
"detailsTitle": "Állapot",
"actions": [
{
"id": "submit",
"title": "Polc leadása",
"style": "primary",
"confirm": "Leadod a polcot? Utána már nem számolhatsz rajta.",
"icon": "tray.and.arrow.up"
}
],
"prompt": null,
"linesTitle": "Teendőid",
"linesBadge": 1
}| Mező | Jelentés |
|---|---|
status | open vagy closed. Lezártnál az app visszalép a főképernyőre. |
title | A munka neve, ez áll a fejlécben. |
hint | Mit olvasson most. A kamera képén látszik, legyen nagyon rövid. |
hintIcon, hintColor | A sáv ikonja és halvány színe, pl. polckódra várva yellow. Egyébként null. |
context | Hol tart, pl. melyik polcnál. Legfeljebb 3, ikonnal is. |
progress | done és total. A total lehet null. |
details | Ha true, van Állapot panel (GET /sessions/{id}/details). |
linesBadge | Piros szám a lista gombján, pl. a teendők száma. |
actions | Gombok. style lehet default, primary vagy destructive. |
actions[].confirm | Ha megadod, a gombot nyomva kell tartani. Lezárásnál mindig adj meg. |
prompt | Pl. indításkor választás a nyitott leltárak közül. |
Állapot panel
A munka teljes állapota, jobbról becsúszó panelen.
/sessions/{id}/detailsCsak ha a munkamenetben details: true. Megnyitáskor és minden valós idejű jelzésre újra lekéri. Lezárt munkamenetnél 409.
{
"title": "Őszi leltár",
"subtitle": "Központi raktár · indult 2026.11.18.",
"summary": [
{ "label": "Kész polc", "value": "28 / 40", "icon": "checkmark.circle", "color": null, "tone": null }
],
"sections": [
{
"title": "Körök",
"footer": null,
"rows": [
{
"icon": "1.circle",
"color": null,
"title": "1. kör",
"subtitle": "Kiss Anna, Nagy Béla",
"value": "38 / 40",
"tone": null,
"progress": { "done": 38, "total": 40 },
"badge": null,
"lineId": null
}
]
}
]
}| Mező | Jelentés |
|---|---|
summary | Nagy számok a panel tetején, legfeljebb 4. |
sections[].rows | Sorok ikonnal, értékkel, haladással. |
rows[].lineId | Ha megadod, a sorra koppintva az app a sor végpontját hívja. |
Valós idő
Az app SSE kapcsolaton értesül a változásról.
- A manifest events.url címe önmagában hitelesít, pl. egy rövid életű jeggyel. Az app nem küld rá tokent.
- Az esemény csak jelzés. Az app utána a szokásos végpontokon kéri le a friss állapotot.
- Legalább 20 másodpercenként küldj életjelet. A lejáratkor bontsd a kapcsolatot.
event: changed
data: {"scope":"session","id":"st-1842"}
event: changed
data: {"scope":"manifest"}
: pingPush értesítés
A push a keszlet.app reléjén megy, az Apple kulcsa nem kell hozzá.
/deviceCsak ha capabilities.push: true. Az app elküldi a telefon adatait és a relé tokenjét. Ha a push null, töröld a tokent.
POST https://admin.keszlet.app/api/push/v1/send
Authorization: Bearer kp1.eyJ…
{
"id": "verify-551",
"title": "Megerősítés vár rád",
"body": "Kiss Anna leadta az ellenőrzést: A-01-03 polc",
"badge": 1,
"sound": true,
"threadId": "stocktake-7",
"open": { "workflowId": "stocktake", "itemId": "inv-7", "sessionId": null }
}- Szöveg nélkül csendes értesítés megy, csak a jelvény frissül.
- 410 esetén a token már nem érvényes, töröld.
- Tokenenként percenként legfeljebb 30 értesítés mehet.
Offline mód
Ha egy folyamatnál offline: true, az app hálózati hibánál elmenti a beolvasást, és később az eredeti id-vel és scannedAt-tel küldi el.
Hibák
Minden nem 2xx válasz törzse ilyen.
{
"error": {
"code": "PAIRING_CODE_EXPIRED",
"message": "A párosító kód lejárt. Kérj újat a programban."
}
}- A message-et az app változtatás nélkül mutatja. Mondja meg, mi a teendő.
- A code gépi azonosító, az app csak naplózza.
- 401-nél az app megszünteti a párosítást, és szól a felhasználónak.
Teljes példa: leltár
Így néz ki egy leltár az elejétől a végéig.
- Párosítás
POST /pairA kolléga beolvassa a programodban mutatott QR kódot.
- Leltár indítása
POST /sessionsA Leltár csempén látszik a futó leltár. Rábök, az app az itemId-vel indítja.
- Mit olvasson?
hintA válaszban: „Olvasd be a polc kódját”.
- Polc beolvasása
POST /scanssuccess, a contextben a polc, az új hint „Olvasd be a cikket”.
- Cikk beolvasása
POST /scanssuccess és quantity bekérés: „Hány darab van?”
- Mennyiség
POST /prompts/{id}Beírja, hogy 12. A progress eggyel nő.
- Polc leadása
POST /sessions/{id}/actions/submitA menüből leadja a polcot, és jöhet a következő.
Ellenőrzőlista élesítés előtt
- A válaszidő 300 ms alatt marad.
- Ugyanazt a beolvasás id-t nem számolod kétszer.
- Minden válaszban ott van minden kulcs, üresen null vagy [].
- A tone pontos. Ismeretlen kód error, nem info.
- A hibaüzenet megmondja, mit tegyen a felhasználó.
- Lezárásnál és törlésnél van confirm kérdés.
- Minden olyan változásnál jelzel (events), ami a telefonon mást mutatna.
- Pusht csak akkor küldesz, ha a felhasználónak tennie kell valamit.
- Van eszközlista, ahol a párosított telefonok törölhetők.
- Minden beolvasást a párosító felhasználó nevén naplózol.
Használati útmutató