Vonalkódolvasó

Használati útmutató

Keszlet.app - Vonalkódolvasó. Használat a raktárban és bekötés a saját rendszeredbe.

Verzió 1.12026. november 20.

1. rész

Használat

Telepítés

Az app iPhone-on működik, iOS 26 vagy újabb rendszerrel.

  1. 1
    Töltsd le az appot

    Keresd így: Keszlet.app - Vonalkódolvasó. Az iPhone-on Kódolvasó néven látod.

  2. 2
    Engedd meg a kamerát

    Az első indításkor az app engedélyt kér. A kamerát csak kódolvasásra használja.

  3. 3
    Pá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 gépen

A programban kérj párosító QR kódot.

A telefonon

Koppints a Párosítás gombra, és olvasd be.

Kész

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özMire jó
LámpaKoppintás ki-be. Hosszan nyomva automatikus módra is állíthatod.
Nagyítás1×, 1,5×, 2× és 3× között váltasz, az app megjegyzi.
Kézi beírásSérült címkénél beírhatod a kódot.
IsmétlésszűrésUgyanazt 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.

RendbenEgy rövid, magas sípolásMegvan a cikk, mentve.
FigyeljKét közepes sípolásNem ezen a polcon van.
HibaMély hang, erős rezgésIsmeretlen kód.
InfóHalk koppintásCsak tájékoztatás.

É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

  1. 1
    Nyisd 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.

  2. 2
    Kattints a Párosítás gombra

    Olvasd be a QR kódot az appal. A telefon megjelenik a Párosított telefonok listában.

  3. 3
    Használd

    Infó, küldés gépre és leltár. A leltárhoz leltár jogosultság kell.

2. rész

Bekötés saját rendszerbe

Hogyan működik?

Az app beolvas, a programod válaszol, az app megmutatja.

Kódolvasó appbeolvas, jelez, megjelenít
POST /scans eredmény
A programodmegkeresi, eldönti, menti

Mit kell megírnod?

Nem kell mindent. Az első két szinttel már működik.

1
PárosításAz app összekapcsolódik a programoddal.
POST /pair · GET /manifest · DELETE /pair
2
InfóBeolvasott kód adatai a telefonon.
POST /scans (lookup)
3
Küldés gépreA kód a gépen nyitott ablakba kerül.
POST /scans (send)
4
FolyamatokLépésenként vezetett munka.
POST /sessions · GET /sessions/{id} · POST …/actions/{id} · POST /prompts/{id}
5
Futó munkák és állapotVálasztás a futó munkák közül, Állapot panel.
workflows[].items · GET /sessions/{id}/details
6
Valós időA más telefonon történt változás azonnal látszik.
manifest events · SSE
7
Push értesítésÉrtesítés és jelvény, akkor is, ha az app zárva van.
PUT /device · relé /send

Alapszabá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.
Fejlécek minden kérésben
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

A QR kód tartalma
keszletscan://pair?v=1&url=https%3A%2F%2Fapp.example.hu%2Fapi%2Fscanner&code=K7Q2-9XLM
ParaméterJelentés
vProtokoll verzió, most 1.
urlAz alap URL, URL-kódolva. Csak https lehet, fejlesztéskor helyi cím is.
codeEgyszer használható kód. Javaslat 5 perc érvényesség, legalább 8 véletlen karakter.

2. Az app párosít

POST/pairtoken nélkül

Az eszköz id-ja állandó. Újrapárosításkor ugyanazt küldi, így felülírhatod a régit.

Kérés
{
  "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"
  }
}
Válasz · 200
{
  "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

DELETE/pair

Tö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.

GET/manifest

Induláskor, előtérbe kerüléskor és a főképernyő lehúzásakor kéri le.

Válasz · 200
{
  "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.nameA program neve a főképernyőn.
host.accountCég vagy fiók neve. Lehet null.
host.logoUrlNégyzetes kép, legalább 128×128 px. Lehet null.
capabilitieslookup az Infó mód, send a Küldés gépre, push a push értesítés.
badgeA felhasználóra váró teendők száma. Az app ikonján látszik.
eventsA valós idejű értesítés címe, lásd lent. Lehet null.
workflowsIndítható folyamatok. Az icon egy SF Symbol név.
workflows[].itemsA futó munkák, pl. leltárak. Egynél a csempe rögtön abba visz, többnél választani lehet.
workflows[].requiresItemHa true, a folyamat csak egy futó munkához indul.
sessionsNyitott 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.

POST/scans
Kérés
{
  "id": "0B6E8A55-2E1D-4F6B-8C07-3B4A1D6E9F20",
  "code": "5990000000017",
  "symbology": "ean13",
  "scannedAt": "2026-11-19T10:15:30Z",
  "target": "lookup",
  "sessionId": null
}
Válasz · eredmény
{
  "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
idIdempotencia kulcs. Ha ugyanez jön újra, add vissza ugyanazt az eredményt.
targetlookup (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.
sessionIdCsak session célnál, egyébként null.
symbologyean13, 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
tonesuccess, warning, error vagy info. Ez dönti el a hangot és a színt.
titleRövid, egy sor. Ez a legnagyobb felirat.
subtitlePl. cikkszám. Lehet null.
fieldsCímke-érték párok. Legfeljebb 6 ajánlott.
promptHa még adat kell, lásd a Bekérésnél. Egyébként null.
sessionsession 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.

prompt az eredményben
{
  "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
}
kindMit kér és mi a válasz
quantityMennyiség mértékegységgel, korlátokkal. A válasz pl. "12".
textSzöveg, default vagy number billentyűzettel. A válasz a beírt szöveg.
choiceVálasztás a listából. A válasz a választott id.
confirmIgen vagy mégse. A válasz null.
POST/prompts/{id}

A válaszod újabb eredmény, benne akár újabb prompttal. Így a lépések láncolhatók.

Kérés
{ "answer": "submit", "value": "12" }

// Mégse esetén
{ "answer": "cancel", "value": null }

Folyamatok

Egy folyamat (pl. leltár) a programodban egy munkamenet.

POST/sessions

Tö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.

GET/sessions/{id}

Friss állapot, amikor a felhasználó visszatér egy munkamenethez.

POST/sessions/{id}/actions/{actionId}

Gombnyomás a munkamenet alján. Törzs nélkül, a válasz az új állapot.

A munkamenet
{
  "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
statusopen vagy closed. Lezártnál az app visszalép a főképernyőre.
titleA munka neve, ez áll a fejlécben.
hintMit olvasson most. A kamera képén látszik, legyen nagyon rövid.
hintIcon, hintColorA sáv ikonja és halvány színe, pl. polckódra várva yellow. Egyébként null.
contextHol tart, pl. melyik polcnál. Legfeljebb 3, ikonnal is.
progressdone és total. A total lehet null.
detailsHa true, van Állapot panel (GET /sessions/{id}/details).
linesBadgePiros szám a lista gombján, pl. a teendők száma.
actionsGombok. style lehet default, primary vagy destructive.
actions[].confirmHa megadod, a gombot nyomva kell tartani. Lezárásnál mindig adj meg.
promptPl. indításkor választás a nyitott leltárak közül.

Állapot panel

A munka teljes állapota, jobbról becsúszó panelen.

GET/sessions/{id}/details

Csak ha a munkamenetben details: true. Megnyitáskor és minden valós idejű jelzésre újra lekéri. Lezárt munkamenetnél 409.

Válasz · 200
{
  "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
summaryNagy számok a panel tetején, legfeljebb 4.
sections[].rowsSorok ikonnal, értékkel, haladással.
rows[].lineIdHa 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.
Események
event: changed
data: {"scope":"session","id":"st-1842"}

event: changed
data: {"scope":"manifest"}

: ping

Push értesítés

A push a keszlet.app reléjén megy, az Apple kulcsa nem kell hozzá.

PUT/device

Csak 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.

Küldés a relén át
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.

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

  1. PárosításPOST /pair

    A kolléga beolvassa a programodban mutatott QR kódot.

  2. Leltár indításaPOST /sessions

    A Leltár csempén látszik a futó leltár. Rábök, az app az itemId-vel indítja.

  3. Mit olvasson?hint

    A válaszban: „Olvasd be a polc kódját”.

  4. Polc beolvasásaPOST /scans

    success, a contextben a polc, az új hint „Olvasd be a cikket”.

  5. Cikk beolvasásaPOST /scans

    success és quantity bekérés: „Hány darab van?”

  6. MennyiségPOST /prompts/{id}

    Beírja, hogy 12. A progress eggyel nő.

  7. Polc leadásaPOST /sessions/{id}/actions/submit

    A 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.

Te döntöd el, engedélyezed-e az analitikát és a marketingmérést. Az elutasítás nem korlátozza az oldal használatát.

Szükséges tárolás

Megjegyzi a választásodat 180 napig, hogy ne kelljen minden látogatásnál újra megadnod.

Mindig aktív

Részletek az adatkezelési tájékoztatóban