Terminal POS Management

These endpoints allow you to toggle the operating mode of your hardware terminals between "Standalone" and "Point of Sale" modes.

Enable Terminal POS

Enables POS mode for a specific terminal.

Endpoint

PUT /api/pos/terminals/:id/enable-pos

Operating Modes

POINT_OF_SALE: Standard POS mode.
PDV: Spanish abbreviation for Point of Sale mode.

Response

{
  "message": "Terminal enabled for Point of Sale",
  "data": {
    "pos_information_id": "...",
    "operating_mode": "POINT_OF_SALE"
  }
}

Disable Terminal POS

Disables Point of Sale mode for a terminal.

Endpoint

PUT /api/pos/terminals/:id/disable-pos

Response

{
  "message": "Terminal disabled for Point of Sale",
  "data": {
    "pos_information_id": "...",
    "operating_mode": "STANDALONE"
  }
}

Get POS Terminals

Retrieves all terminals with POS information.

Endpoint

GET /api/pos/terminals/point-of-sale

Query Parameters

Parameter	Type	Description
`status`	string	Filter by terminal status (default: "active")
`pos_branches_id`	string	Filter by branch
`has_register`	boolean	Filter by register linkage
`page`	number	Page number
`limit`	number	Items per page

Response

{
  "data": [
    {
      "_id": "...",
      "serial_number": "...",
      "is_point_of_sale": true,
      "operating_mode": "POINT_OF_SALE",
      "sales_register": { ... },
      "branch": { ... }
    }
  ],
  "pagination": {
    "total": 10,
    "page": 1,
    "limit": 50,
    "pages": 1
  }
}

Updated 20 days ago