Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

User access in the OneStock platform is managed across three platforms: Store App, Order Management Center (OMC aka backoffice), and API. Users can be granted access to one or more of these platforms.

Users can be managed from the Order Management Center or from the Store App:

  • From the Order Management Center you are able to create, edit and delete users across the whole of OneStock. You will be able to gran access to Store App, Order Management Center and API as well.

  • From the Store App, you can only manager Store App users with individual access to the store you are logged at.

image-20240617-100446.png

Management from the Order Management Center

Panel
panelIconId261d
panelIcon:point_up:
panelIconText
bgColor#DEEBFF

The “Users” page is only accessible to Client Admin, Client Headquarters and Client Retail Directors

image-20240617-100601.png

Access is granted per site and application. Rights per application depend on the role that is assigned to the user. Details about rights are detailed per application:

If a Store App user does not have an email for login credentials, a new user account with an email login must be generated to provide access to the OMC.

Multiple Site access

A user can have access to multiple sites. To grant access to a new site, you need to be logged in with a user who already has access to one of the existing sites the user is authorized to access. Simply click on the "assign site" button and provide access to the new site.

Store App Access

Store app access details are provided in the following table.

Store App Roles

Info

Green = Full access (write) Blue = limited access (read only) Red = No access

Rank

Store App role

API Key

Can access the store app

Can create & manage users in store

0

Vendor manager

vendor_manager

 

 

1

Vendor

vendor

 

 

Access to all stock locations or some

Access can be granted to all stock locations or to a specific list.

image-20240531-144646.png

Order Management Center (OMC) Access

OMC access details are provided in the following table.

Order Management Center Roles

Info

Green = Full access (write) Blue = limited access (read only) Red = No access

Rank

Backoffice roles

API Key

Analytics

BI suite

Orders

Stock

Buffers

Items

Stock locations

Orchestration

 

Workflows

Delivery

 

Users

Configuration

0

Client Admin

client_admin

 

 

 

 

 

 

 

 

 

 

 

 

1

Client Headquarters

headquarters

 

 

 

 

 

 

 

 

 

 

 

 

3

Client Retail Director

retail_director

 

 

 

 

 

 

 

 

 

 

 

 

4

Client Customer Services

customer_service

 

 

 

 

 

 

 

 

 

 

 

 

5

Client Customer Services Configuration Manager

customer_service_conf_manager

 

 

 

 

 

 

 

 

 

 

 

 

6

Client Configuration Manager

conf_manager

 

 

 

 

 

 

 

 

 

 

 

 

7

Client Viewer

client_viewer

 

 

 

 

 

 

 

 

 

 

 

 

8

Client Viewer Limited

client_viewer_limited

 

 

 

 

 

 

 

 

 

 

 

 

9

Client Customer Service Analytics

client_service_analytics

 

 

 

 

 

 

 

 

 

 

 

 

10

Client Analytics Viewer

client_analytics

 

 

 

 

 

 

 

 

 

 

 

 

Access to all sales channels or some

Access can be granted to all sales channels (default) or limited to a list of sales channels.

image-20240531-144722.png

Impact of Sales Channel Limitations:

  1. Orders Page: Only displays orders from accessible sales channels.

  2. Analytics: Only displays data for accessible sales channels.

  3. Stock Page: Only shows stock queries for accessible sales channels.

API Access

API Roles

Info

Green = Full access (write) Blue = limited access (read only) Red = No access

Rank

Backoffice roles

API Key

All public routes in the API Portal

0

API User

api_user

 

API access is divided into two common use cases:

  1. External Systems: Interact with OneStock through API.

    • Recommendation: Create a user with basic authentication.

  2. Human Users: Interact with OneStock through API.

    • Recommendation: Assign both Order Management Center access and API access. Authentication can be either basic or SSO.

Security

Users can be configured with:

  • Basic Authentication: User passwords stored in OneStock.

  • Single Sign-On (SSO): A more secure option allowing authentication policies to be managed through a dedicated Identity Provider. Learn more about SSO here.

Accessing API as an SSO User

If you are a user with both access to the Order Management Center and API, and you authetication is setup to SSO, you can easily communicate with OneStock through API thanks to a long duration token. You will just have to pass the long duration token in your API calls in the token field.

Generating a long duration token

  • Generate a long-duration token from your information page in the OMC.

  • The token is displayed only once; store it securely.

  • Ensure the user has both OMC access and API access for this feature to be accessible.

generate long duration token client.gif

Disable

a user users on the fly and enable them back when you see fitIf you are working with an integrator that requires access only at specific moment, you can simply disable his user and enable it when he should be able to

users

Easily disable or enable a user’s access to OneStock as needed.

This feature is ideal when working with external integrators who require access only at specific times. You can disable their user account and re-enable it when they need access again.

Important: disabling Disabling a user will revoke revokes all access to OneStock as a whole. Once disabled, the user will no longer be able to access , including the OMC, SA, and API (he . The user will be logged out on the spot)immediately upon disabling.

disable user.gif

Constraints

  • User Login Modification: Cannot be modified after creation; it persists throughout the user lifecycle.

  • Email Requirement: A user must have an email as their login to be granted rights to access the OMC. If a Store App user lacks an email login, a new user must be created.

  • Multi-Site User Modification: In a multi-site scenario, if you want to modify the list of sales channels or stock locations for a user with access to multiple sites, you need to be logged into the specific site you want to modify. For example, to make changes for Site Fashion Market, you must be in Fashion Market in the OMC. You cannot make this modification from another site, even if you have access to both sites.