Understanding Buyer, User Group and User concepts in Sitecore OrderCloud

Hello everyone, In this blog we will try to understand what is Buyer, Buyer Organization, User Group, Users in Sitecore OrderCloud. We will also see how we can create all these in Sitecore OrderCloud portal.

Buyer : Buyer is real world entity who come to your ecommerce website and look for products to buy. He can also navigate through your website without purchasing anything

Users : Users are basically a single entity in Sitecore OrderCloud who perform some operation in Marketplace. They can either be Buyer user or Seller user

User Groups: This is basically a collection of users with same interest or common persona in market place. Ex. Different user with similar interest in one category in ecommerce website.

Buyer Organization : Buyer Organization is an umberalla under which User Group containing common persona and interest resides. Its a collection of User and User Groups.

Now let's see that how in Sitecore OrderCloud Portal, we can create those.

Creating a Buyer Organization in Sitecore OrderCloud

To create a Buyer Organization, we need to navigate to API console in Sitecore OrderCloud Portal. Select the Marketplace and Navigate to Buyer section in panel as shown in image below.Then select the post option to create a new Buyer Organization. The 3 basic parameters which is required is BuyerOrganization ID, Name of the Buyer Organization and active = true to make the buyer organization active in market place.

Creating Buyer User in Sitecore OrderCloud

To create a buyer user, navigate to User section in left panel. Select Post operation to create a new user. BuyerOrganization ID is mandatory field.Provide the Buyer Organization ID which we just created as it map the user to that Organization. Also define the other mandatory field as shown in below image and click send. In right side section, we can see a 201 success code with the user details which is created successfully.

Creating Buyer User Group in Sitecore OrderCloud

To create Buyer usergroup, navigate to User Group section in left panel. Select post operation to create new user group. BuyerOrganization ID is mandatory field. Provide the Buyer Organization ID which we just created as it map the user group to that Organization. Give the UserGroup a unique id. We can use this id while mapping user to user group

Assigning User and User Group to Buyer Organization

To assign usergroup and user to Buyer Organization, navigate to User Group section in left panel. Select post operation to create or update a user group user assignment as shown below.

Once it is completed. Let's see, how we can verify whether its assigned properly or not. Select Get operation from dropdown to get a list of user group user assignment.You can see both user and usergroup we created is assigned to Buyer Organization.

Thanks for reading. We will see how we can create Seller, Seller group in our next blog. we will also see what is Seller Admin.

Happy Learning, Happy Sitecoring!!