Managing users and roles

As an admin, you can manage users and roles to allow users to use specific features and apps.

Ensure that you create an account for:

• Each store associate who handles orders and in-store purchases via NewStore Associate App.
• Each store associate who fulfills orders and handles inventory via NewStore Fulfillment App.
• Each company employee who requires business reports, customer care, and administrative information from NewStore Omnichannel Manager.

The user accounts in your business are displayed on the Settings > Users & Roles page. To find a specific user account, you can search by first name, last name, and the associated email ID.

Managing roles

A role represents a set of permissions, which can be assigned to a user account to grant them these permissions. A typical example is the Admin role, granting all rights to the user of this role.

If a user has multiple roles assigned, the user gets the permissions of each assigned role. If no roles are assigned to a user, the user can still access the NewStore mobile apps but not NewStore Omnichannel Manager

Default roles and permissions

NewStore Omnichannel Manager provides you with the following roles. The descriptions provided in this table are the default access rights for each role. You can edit or delete all these roles, to update the access provided or associated permissions, except for the Admin role.

Role	Description
Admin	Grants full rights. This role cannot be deleted or edited.
Customer Service Supervisor	Can view and edit orders with all order maintenance features. Can view discounts and coupons. Can also update the shipping status of a fulfillment request, the shipment for which was processed outside of the NewStore platform.
Merchandiser	Can view orders and dashboards. Can manage discounts and coupons.
Fulfillment Manager	Can view orders, discounts, coupons, and inventory management. Can also manage orders via NewStore Omnichannel Manager, such as order exports, order exceptions, and shipping. Can enable or disable stores for order fulfillment and manager shipment limits for orders. Can import and export safety stock. Can also update the shipping status of a fulfillment request, the shipment for which was processed outside of the NewStore platform.
Corporate Operations	Can view and export orders. Can view dashboards, discounts, coupons, cash management, and inventory management. Can manage all settings except for users and roles.
Store Manager	Can view orders, dashboards, discounts, coupons, cash management, inventory management, and assign associates to stores. Can also import and export safety stock.
Keyholder	Has no access to NewStore Omnichannel Manager but can perform cash management operations in NewStore Associate App.
Associate	Can log in and use NewStore Associate App. Assign this role to a store associate to enable default NewStore Associate App permissions .

You can create or edit roles and use the following permissions:

Permission	Effect
Log in to Omnichannel Manager	Enables users to log in to NewStore Omnichannel Manager.
View orders	Enables users to view the Sales tab, sales orders and access order details.
Edit shipping	Enables users to modify shipping during the grace period.
Swap product	Enables users to swap products during the grace period.
Cancel store orders	Enables users to cancel pending orders and orders that have been routed to a store but have not yet been shipped.
Cancel DC orders	Enables users to cancel orders that have been routed to a distribution center but have not yet been shipped. For more information, see Modifying orders for customers and Allowing DC-fulfilled order cancelation .
Issue refunds	Enables users to issue appeasement refunds.
Manage order exceptions	Enables users to handle exceptions for on hold orders.
Export orders	Enables users to export sales orders and save as a CSV file.
Update status for shipments processed externally	Enables users to update the shipping status of a fulfillment request, the shipment for which was processed outside of the NewStore platform.
View customers	Enables users to view a customer overview list, and customer details. When using this permission, retailers can have role-based access control over the customer pages in Omnichannel Manager. For more information, see Added permission to view customers .
View promotions	Enables users to access the Promotions tab to view discounts and coupons.
Manage discounts	Enables users to create discounts.
Manage coupons	Enables users to create coupons and coupon codes.
View cash management	Enables users to view cash management reporting.
View inventory management	Enables users to view inventory management reporting.
View fiscal reports	Enables users to view fiscal reports and download an electronic log of transactions in the store.
View settings	Enables users to access the `Settings` module and external payment reports.
Manage users and roles	Enables users to create, modify, and delete users and roles (including store assignment).
Assign associates to stores	Enables users to assign associates to stores.
Modify reason codes	Enables users to view and manage reason codes for returns and order modifications.
View locations	Enables users to view stores and warehouses.
Manage locations	Enables users to create and edit warehouses.
Manage shipping	Enables users to view and manage shipping options, carrier services, and shipping zones.
Manage clienteling	Enables users to access the Clienteling tab in Settings, to view and manage clientelingopt-in messages and quick replies
Manage shipment limits	Enables users to create and manage limits on the number of shipments allowed for an order in your business. This is required to ship large orders or when multiple locations fulfill an order. See Shipping split orders . Note This permission is assigned to the Fulfillment Manager role by default. However, you can choose to assign it to other user roles as well.
View system settings	Enables users to view and manage system settings in NewStore Omnichannel Manager. For example, users with this permission assigned can view or update the timezone or email settings for the retailer.
Manage templates	Enables users to view and manage templates in NewStore Omnichannel Manager to generate PDF files and text snippets as invoices, return receipts, or as the subject and body of emails sent to customers.
View dashboards	Enables users to view analytical dashboards.
Edit fulfillment availability	Enables users to enable or disable stores for order fulfillment. See Enabling or disabling a store for order fulfillment .
Manage safety stock	Enables users to export and import safety stock.
Create support cases	Enables users to submit support cases to report issues via NewStore Omnichannel Manager. The Contact Support button in the left menu is displayed only for users with this permission.
View tools	Enables users to view developer tools in Omnichannel Manager in `Tools`, such as Event Stream event logs or other audit data.

Permissions for NewStore Associate App

The following permissions are specific to NewStore Associate App.

Permission	Effect
Login to NewStore Associate App	Enables access to NewStore Associate App for the store associate. Important This is the default permission for NewStore Associate App. Ensure that a role is assigned to the store associate before enabling this permission. Currently, associates assigned to a store can log into NewStore Associate App. Supported from This feature is supported from Associate App v1.2.0 and later.
Approve orders	Enables associates to approve certain orders in NewStore Associate App, based on approval rules configured for your business. Supported from This feature is supported from Associate App v1.3.0 and later. This permission is assigned to the Store Manager role by default. However, you can choose to assign it to other user roles as well.
Allow switch to Test Mode	Enables associates to switch between staging and production environments in NewStore Associate App. Supported from This feature is supported from Associate App v1.2.0 and later. Additionally, this feature must be enabled via the configuration API .
Clienteling operations	Enables associates to access clienteling features in NewStore Associate App, such as chat and inbox. Supported from This feature is supported from Associate App v1.2.0 and later.
Perform cash management operations	Enables associates to perform cash management functions in the store.
Access cash management settings	Enables associates to configure cash management and cash drawer settings in the store. note You can only enable this permission for the user if the Perform cash management operations permission is enabled.
Approve orders	Enables associates to approve certain orders in NewStore Associate App, based on approvals rules configured for your business. See Managing order approvals . Supported from This feature is supported from Associate App v1.3.0 and later.
Manage Associate App	Enables NewStore Omnichannel Manager users to configure Associate App settings and customizations. See Managing Associate App customizations for more information. Supported from This feature is supported from Associate App v1.23.0 and later.

Creating a user account

Permission required

This action can be performed by users with the Manage users and roles permission.

1. Log in with a user account that has the Admin role or a role that has the Manage Users and Roles permission assigned to it. Only these roles can create accounts.

2. Go to Settings > Users & Roles.

3. In the Users section, click Add User.

4. Enter the first name, last name, email address, and telephone number.

5. In the Access section, select a user type:

   • Corporate directory: The user can log in with their own company email and password. The user should not expect an account activation email from NewStore.

     note

     This feature must be enabled before you can use it. See Configuring identity and access management .

   • NewStore directory: The user account is created in NewStore and the user will receive an account activation email from NewStore with instructions to create their password.

   note

   The user type changes how the users log in to the apps. See logging-in.

6. Choose the roles to assign to the user. View Default roles and permissions for more information. When using several roles, the user gets all the permissions of the selected roles.

   Important

   A user account without a role can log into the NewStore mobile apps but cannot log into NewStore Omnichannel Manager.

7. In the Store field, assign the user to a store. This is required to enable the user to use NewStore Associate App or NewStore Fulfillment App.

   note

   Once you assign a store to a user, this store cannot be removed but only replaced by another store.

8. Click Save.

The user is created immediately.

Creating filters for a user role

Permission required

This action can be performed by users with the Manage users and roles permission.

For each user role that you create in NewStore Omnichannel Manager, you can create and apply filters to curate the list of orders that will be visible to the users on the Sales > Orders page.

You can only assign filters to pre-existing user roles. The Table filters area does not appear when creating a new user role.

Important

If a user has been assigned multiple roles with different filters, only the filters assigned to the first role in the platform is taken into account. The other filters are ignored, even if the remaining roles have these filters assigned to them.

To create role based filters:

1. Log in with a user account that has the Admin role or a role that has the Manage Users and Roles permission assigned to it. Only these roles can create accounts and assign role filters.

2. Go to Settings > Users & Roles.

3. In the Roles section, click the specific role that you want to assign filters to.

4. In the Table filters area, create the filters and click Save filters.

   For example, you can specify that users in your business operating from New York can only see in-store orders, which have been fulfilled by locations in the US.

   The filters will then look like this:

```none
{
 channel:
 [
  "in-store"
  ]
 products.fulfillmentLocation:
  [
  "US*"
  ]
 }
```

5. Click Save.

Deactivating and deleting user accounts

Permission required

This action can be performed by users with the Manage users and roles permission.

Deactivated users cannot access any NewStore applications. If the user account that you are deactivating has fulfillment requests that have not been completed, contact the support team.

To deactivate a user account:

1. Click Settings > Users & Roles.

2. Click the user name that you want to deactivate.

3. Click Disable account and confirm. The account is disabled and cannot be used to log in the apps.

   note

   App users are not logged out immediately.

Once an account is deactivated, you can:

• Reactivate the user account by clicking Enable account.

• Delete the user account by clicking Delete permanently

  note

  Deleting a user does not delete the history related to this user account, such as the orders with which the user was involved.

Related topics

• Managing locations in NewStore