# User Management

# Adding User & Assigning Location to a User

### <span id="bkmrk-adding-users-1">Adding users</span>

To add a new user , follow the steps given below

1. Go to **User Management -&gt; Users -&gt;Add New**   
    [![Screenshot 2025-10-06 162450.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/screenshot-2025-10-06-162450.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/screenshot-2025-10-06-162450.png)
2. Fill the user details, select user role, give a unique username.  
    [![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/0DCimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/0DCimage.png)
3. **Sales Commission Percentage (%)**: Provide the commission % for this user. This option gets applied if the commission agent feature is enabled. *(Not available in Senangurus-Enterprise)* [![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/3JGimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/3JGimage.png)
4. **Is active?:** Activate/Deactivate the user.  
    [![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/tuUimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/tuUimage.png)
5. You can <span style="color: rgb(53, 152, 219);">**Edit**</span>/<span style="color: rgb(224, 62, 45);">**Delete**</span> a user.  
      
    [![Screenshot 2025-10-06 170117.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/screenshot-2025-10-06-170117.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/screenshot-2025-10-06-170117.png)

### <span id="bkmrk-assing-locations-1">Assign locations</span>

While adding the user, select the locations that the user can access. You can either select all locations or select one or more particular locations.

Refer to the image below:

[![Screenshot 2025-10-06 164847.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/rGFscreenshot-2025-10-06-164847.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/rGFscreenshot-2025-10-06-164847.png)

### <span id="bkmrk-max-sales-discount%3A-1">Max sales discount</span>

[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/xrTimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/xrTimage.png)

The maximum discount that an user can give during sales in the POS &amp; sales screen. If you don’t want to have this restriction then simply keep this value blank.

### <span id="bkmrk-disable-login-1">Disable login</span>

You can provide login permission for an user or deny it. If you allow user to login, then you have to provide the username and password for that user.

Refer to the image below

[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/s60image.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/s60image.png)

### Video Demonstration:

<iframe allowfullscreen="allowfullscreen" height="478" src="https://www.youtube.com/embed/qXYdwaiv5FQ" style="width: 854px; height: 478px;" width="854"></iframe>

# Role Management

# <span id="bkmrk-adding-roles-1">Adding Roles</span>

1. Every new business comes with some default roles – **Admin &amp; Cashier.** [![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/JWIimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/JWIimage.png)
    
     **Admin** have all permissions in the application.  
    **Cashier** have permission to only POS section.
2. You can create a role by clicking on **Add** button -&gt; Giving a **Role Name** and then selecting the appropriate permission for that role.  
    [![Discover Malaysia, One Homestay at a Time (1920 x 768 px).png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/3Xkdiscover-malaysia-one-homestay-at-a-time-1920-x-768-px.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/3Xkdiscover-malaysia-one-homestay-at-a-time-1920-x-768-px.png)
3. Sometime you may need to give a user access to a/some particular location(s) only. In this case, select the locations from **Access locations** permission. Select **All Locations** to give permission to access all locations for your business.  
    [![Screenshot 2025-10-06 164847.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/heNscreenshot-2025-10-06-164847.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/heNscreenshot-2025-10-06-164847.png)
4. Roles permissions can be <span style="color: rgb(53, 152, 219);">**Edited**</span> &amp; **<span style="color: rgb(224, 62, 45);">Deleted</span>**.  
    [![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/FRGimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/FRGimage.png)

<p class="callout info">You must update the role of an existing user before deleting a role.</p>

# Using Commission Agent feature

Commission Agent is useful for many businesses. Businesses pay sales agent/commission agent commission on every sale they bring.

# <span id="bkmrk-enabling-%26-choosing--1">Enabling &amp; Choosing Commission Agent Type:</span>

By default Commission Agent is Disabled. You can enable it from **Settings -&gt; Business Settings -&gt; Sale -&gt; Sales Commission Agent drop-down.**

[![Screenshot 2025-10-07 015422.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/screenshot-2025-10-07-015422.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/screenshot-2025-10-07-015422.png)

You will see **3** different types:[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/jMMimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/jMMimage.png)

1. **Logged in User:** If this option is used then the Logged in User will be automatically considered as the commission agent for the sales added by him. Meaning the user adding the sales will get the commission for the sales.
2. **Select from User’s List:** If this option is enabled then in POS &amp; Sales Screen you will see the list of “**users”** present in your business. The user adding the sales will select the commission agent from the list of users displayed.
3. **Select from Commission Agent List:** If this option is enabled then in POS &amp; Sales Screen you will see the list of **“Sales Commission Agents”** present in your business. The user adding the sales will select the commission agent from the list of “Sales Commission Agents” displayed.

<p class="callout info">Select the option as per your business requirements.</p>

## <span id="bkmrk-adding-commission-pe-1">Adding Commission Percentage:</span>

[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/2ugimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/2ugimage.png)

<p class="callout info">You can add commission % while adding/editing the **User** or **Sales Commission Agent** </p>

## <span id="bkmrk-commission-calculati-1">Commission Calculation Type:</span>

The commission for a user can be calculated based on two methods

<div aria-labelledby="message-username-1177149544857882636 uid_1 message-content-1177149544857882636 uid_2 message-timestamp-1177149544857882636" aria-roledescription="Message" aria-setsize="-1" class="message__80c10 cozyMessage__64ce7 groupStart__56db5 wrapper__09ecc cozy_f5c119 zalgo__39311" data-list-item-id="chat-messages___chat-messages-1177145061524373537-1177149544857882636" id="bkmrk-1.%C2%A0invoice-value%3A" role="article" tabindex="-1"><div class="contents_f41bb2"><div class="markup_a7e664 messageContent__21e69">1. **Invoice value:**   
</div></div></div>[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/A45image.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/A45image.png)  
With this method, commissions are calculated based on the total invoice amount generated by the agent.  
For instance, if an agent’s monthly invoice amount totals $5000 and the commission percentage is set at 10%, the user will receive $500 as commission.

<div aria-labelledby="message-username-1177149544857882636 uid_1 message-content-1177149544857882636 uid_2 message-timestamp-1177149544857882636" aria-roledescription="Message" aria-setsize="-1" class="message__80c10 cozyMessage__64ce7 groupStart__56db5 wrapper__09ecc cozy_f5c119 zalgo__39311" data-list-item-id="chat-messages___chat-messages-1177145061524373537-1177149544857882636" id="bkmrk-2.%C2%A0payment-received%3A" role="article" tabindex="-1"><div class="buttonContainer_dd4b62"><div aria-label="Message Actions" class="buttons__3766a container__9d616 isHeader__4c092" role="group"><div class="buttonsInner_bca8fa wrapper_c727b6"><div aria-label="Reply" class="button_d553e5" role="button" tabindex="0">  
</div></div></div></div><div class="contents_f41bb2"><div class="markup_a7e664 messageContent__21e69">2. **Payment Received:** </div></div></div>[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/GRcimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/GRcimage.png)  
Alternatively, commissions can be calculated based on the actual payments received.  
For instance: if the agent’s monthly invoice amount is $5000 with a 10% commission rate, but only $2000 is received within the month, the user will receive $200 as commission. If the remaining $3000 is received in the following month, the user will receive an additional $300 as commission.

## <span id="bkmrk-calculating-commissi-1">Calculating Commission Amount:</span>

To See the commission amount, Go to **Reports -&gt; Sales Representative Report.**

[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/mmOimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/mmOimage.png)

Select the User for which you want to see the commission amount.

[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/PH0image.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/PH0image.png)

On selecting it will show you the detailed summary of Total Sale, Total Sale Commission &amp; Total Expense. Also, the table below lists all the transactions.

[![image.png](https://docs.senangurus.com/uploads/images/gallery/2025-10/scaled-1680-/swmimage.png)](https://docs.senangurus.com/uploads/images/gallery/2025-10/swmimage.png)

<p class="callout info">Sales commission is calculated without shipping or tax. Sales commissions are from the sales of the items, not the overhead cost such as taxes, freight, shipping, handling, etc.</p>

## <span id="bkmrk-commission-payment%3A-1">Commission payment:</span>

After getting the commission amount, **SenangUrus ERP** have 2 ways to make payment for the commission.

### <span id="bkmrk-using-expense-1">Using expense</span>

- Calculate the commission from the sales representative report and after paying the amount add it as an expense in Add Expense menu.
- In Add expense, select the Expense-For dropdown

### <span id="bkmrk-using-hrm-module-1">Using HRM module</span>

- Use the HRM module.
- In the HR module, when creating payroll for a user, it will automatically include the sales commission.
- Sales commission will be shown as Payroll-Components so that the business owner and the user both know details of the commission.

# Adding superadmin user

### <span id="bkmrk-creating-superadmin--1">Creating Superadmin user:</span>

1. Login to the server from Cpanel or DirectAdmin or Plesk or Filezilla (FTP) or similar panels.
2. Open **.env** file with the file editor. **.env** file is present inside the UltimatePOS directory
3. Inside the env file, you will find “**ADMINISTRATOR\_USERNAMES**” configuration. Add the username of the user which you want to make as superadmin.  
    Example if you want “user1” to be superadmin then add it like below:  
    **ADMINISTRATOR\_USERNAMES=”user1″** NOTE: user1 mentioned here is for example only and the username is case sensitive.
4. You have to add an already existing/signed up username here. To add multiple users as superadmin you can add them comma separated.  
    **ADMINISTRATOR\_USERNAMES=”user1,user2,user3″**

NOTE: If super admin user is added, that user can

- Access modules tab in side menubar
- Can enable backup – [To enable backup using superadmin user](https://docs.senangurus.com/books/senangurus-business/page/enabling-backups-backup-in-server-aws-s3)