Today I am going to explain what a user and user groups are and the process to create a user for buyer organization in Sitecore OrderCloud.
Users
In Sitecore OrderCloud, a user refers to an individual who interacts with the e-commerce platform. Users can have various roles and permissions assigned to them, determining their level of access and capabilities within the system. For instance, an admin user in the marketplace organization has administrative access, which enables them to add users and products.
Each user has a user account associated with their credentials, which allows them to log in to the Sitecore OrderCloud platform. Moreover, users can be assigned specific roles that define their access rights and permissions within the system. Role control what actions a user can perform, such as managing products, processing orders, or accessing specific sections of the platform.
Users also have user profiles that store information about them, such as their contact details, preferences, or other relevant data. These profiles can be used for personalization or customization purposes.
User Groups
In Sitecore OrderCloud, user groups are collections of users with similar roles or permissions. User groups provide a convenient way to manage and assign permissions to multiple users at once rather than configuring permissions for individual users.
User groups allow you to group users based on their roles, responsibilities, properties, or any other criteria that make sense for your organization. For example, you might have user groups for customers who are interested in refurbished products.
Note: You first need to create a Buyer Organization before creating a user for the Organization.
Creating a user for Buyer Organization
Step 1: Login into the Sitecore OrderCloud portal (https://portal.ordercloud.io/login).
Step 2: On Dashboard, click on “New Tab” under the API Console.
Step 3: Next, click on “SELECT A CONTEXT” in the upper left corner to select the marketplace you want to interact with.
Step 4: Scroll to the Buyers section in the left-hand side resource menu and select “Users”.
Step 5: Click on the operation selection tab, and you will see a list of the endpoints that are available to buyers’ resources. From the list select “POST Create a new user”.
Step 6: There are two ways to create a new buyer organization. You may either fill out the form on the left-hand side or type in the JSON input on the right-hand side.
Step 7: Since we are creating a buyer user, we need to specify for which buyer organization Sitecore OrderCloud needs to add the user. Enter the buyer ID in the “Buyer ID” field.
Step 8: Enter the details in the necessary “Username”, “Password”, “First Name”, “Last Name” and “Email” fields. The ID is an optional field. If you don’t specify the ID, OrderCloud will auto-generate one for the user. Also, check the checkbox “Active” to activate the user.
Step 8: When you are ready. Click “Send”.
You can also use the following JSON to create the same user for buyer organization in Sitecore OrderCloud:
{
"ID": "TShirtUser-0",
"Active": true,
"Username": "Master",
"Password": "xxxxxxxx",
"FirstName": "Chirag",
"LastName": "Goel",
"Email": "chirag.goel@fakemail.com",
"TermsAccepted": "2023-05-20"
}You can use the same process to create a Supplier Organization.
Read more about Buyers’ API references at “https://ordercloud.io/api-reference/buyers”.
Read more about the Suppliers’ API references at “https://ordercloud.io/api-reference/suppliers”.
References
Create a new User - https://ordercloud.io/api-reference/buyers/users/create
That’s all for Today.
Happy Coding