Endpoint - Overview

Introduction

In Perfect Gym, the POSWeb stations and Endpoints configuration allows you to map your physical hardware devices (like computers or tablets) to specific logical locations within your club. This feature ensures that when a staff member logs in to a specific device, the system recognizes exactly where they are working, such as the "Main Reception Desk" or "Bar POS."

• In this article, you will learn how to create and name new POSWeb stations, link technical endpoints to these stations, and resolve common configuration conflicts.

• This article will be helpful for System Administrators and Club Managers

Before You Start

• Permissions: You must have the SystemManager.EndpointsView permission enabled in your user role to access this section.

• Definitions:

  • Pos Station: A logical name for a physical location (e.g., "Main Reception Desk").

  • Endpoint: A technical record representing a specific device or computer that needs to be linked to a POSWeb Station.

Instruction

The following settings are used when configuring stations and endpoints:

• Name

  • Description: The descriptive label for a specific reception position. This is the name staff will see when selecting where they are working.

  • Usage: Enter a clear, recognizable name such as "Front Desk Left" or "Bar POS 1". This field is required and has a maximum length of 255 characters.

• Number

  • Description: A unique numeric identifier suffix assigned to a specific endpoint within a club.

  • Usage: Enter a number up to 7 digits long. This allows the system to distinguish between different devices in the same location.

• Pos station (Dropdown)

  • Description: A selection list used to link a technical Endpoint to a created Pos Station.

  • Usage: Search for and select the name of the "Pos Station" created earlier to assign the device to that physical location.

Configuration instructions

Managing POSWeb Stations

1. Navigate to the Reception positions page.

2. Click the POSWeb stations tab located in the header. 3. To create a new station, click the Add pos station button.

3. In the Add POSWeb station modal that appears, locate the Name field. 5. Enter a descriptive name for the station.

4. Click the Save button to confirm.

5. To modify an existing station, locate the station in the grid and click the Edit button (pencil icon).

6. To remove a station, click the Delete button next to the relevant row.

Configuring Endpoints

1. Navigate to the Reception positions page and click the Endpoints tab.

2. Review the grid, which displays the Club, Identifier, POSWeb station, and Number for each device.

3. To configure an endpoint, click the Edit button (pencil icon) next to the specific device ID. 4. In the Edit modal, verify the read-only Club and Id fields to ensure you are editing the correct device.

4. In the Number field, enter the unique numeric identifier for this endpoint.

5. In the POSWeb station dropdown, search for and select the physical station name you wish to link this device to.

6. Click the Save button to apply the changes.

Hints

• Unique Numbering: The system validates the Number field. You cannot assign a number that is already in use by another station within the same club. If you attempt to do so, the system will display the error: "There is station with the same number in this club".

• Search Limitations: When searching for a POSWeb Station in the dropdown, the search query is limited to 255 characters. Queries longer than this will be truncated.

• Deletion: Deleting a POSWeb Station performs a "soft delete" (marking it as IsDeleted), meaning it is removed from the view but retained in the database for data integrity.

• Successful Updates: Upon successfully saving an Endpoint configuration, a green notification stating "Endpoint has been updated" will appear.

• If you want to see what the sale process looks like in the POSweb, go to this article. 

Use Case Examples

Example 1: Setting up a New Reception Desk

• Goal: Create a new location for the main entrance reception team.

• Steps/Settings: On the POSWeb stations tab, click Add POSWeb station. Enter "Main Entrance Desk" in the Name field and click Save.

Example 2: Linking a Computer to the New Desk

• Goal: Assign a specific computer (Endpoint ID 105) to the newly created "Main Entrance Desk".

• Steps/Settings: On the Endpoints tab, find ID 105 and click Edit. In the POSWeb station dropdown, select "Main Entrance Desk". Enter "1" in the Number field to designate it as the first terminal.

Example 3: Correcting a Duplicate Number Error

• Goal: You receive an error saying "There is station with the same number in this club" when trying to save an endpoint.

• Steps/Settings: Check the Number field. If you entered "10", change it to "11" or another unused number to resolve the conflict and click Save.

Example 4: Renaming a Point of Sale Location

• Goal: Update "Bar Area" to "Nutrition Bar" to reflect a branding change.

• Steps/Settings: On the POSWeb stations tab, find "Bar Area". Click Edit. Change the Name text to "Nutrition Bar" and click Save.

Example 5: Decommissioning an Old Station

• Goal: Remove the "Temporary Kiosk" station that is no longer in use.

• Steps/Settings: On the POSWeb stations tab, search for "Temporary Kiosk". Click the Delete button in that row to remove it from the active list.