Add

[POST] .../v1/pos/fastitem/add

Adds an item to a quick item group. The added item must not be marked for deletion. Use this method to add an existing catalog item to a POS quick item group for faster cashier selection. The request requires group_id and item_id and may provide operating_cash_id; when operating_cash_id is not provided, the method uses the current accepted POS cash register and returns new_id for the quick item link. The method checks the current request user and requires an accepted cash register, while the controller does not perform a separate RBAC permission check; missing body, missing group_id, missing item_id, deleted item, missing accepted cash register and storage errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
group_id Int64 Required Fast item group ID.
item_id Int64 Required Item ID.
operating_cash_id Int64 Optional Cash register ID.

Request Example

{
  "group_id": 1,
  "item_id": 1,
  "operating_cash_id": 1
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Insert Created record result.

Response Example

{
  "ok": true,
  "result": {
    "new_id": 1
  }
}