dashback/docs/api/routes/posterminal/upsert.md

PUT /posterminal

Protected. Requires a valid session cookie (credentials: 'include').

Create POS terminal

Creates a new POS terminal for the selected company. The pairingpin is randomly generated server-side and returned in the response.

Body (JSON)

Field	Required	Type	Description
name	yes	string
rootCategoryId	no	integer
syncRootArticles	no	boolean
sort	no	integer
enabled	no	boolean

{
  "name": "Kassa 1"
}

Response 200

Created posterminal with generated pairingpin

{
  "posterminal": {
    "id": 1,
    "name": "…",
    "pairingpin": "…",
    "token": "…",
    "pairedAt": "…",
    "clientserial": "…",
    "rootCategoryId": 1,
    "syncRootArticles": true,
    "sort": 1,
    "enabled": true,
    "clientversion": "…",
    "lastseenAt": "…",
    "updatedAt": "…",
    "categoryIds": [
      1
    ]
  }
}

Errors

Status	Description
400	Invalid posterminal or no company selected — {"error":"…"}
401	Unauthorized — {"error":"…"}
403	Not authorized — {"error":"…"}
404	Company not found — {"error":"…"}

---

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.