Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Marketplace Concept Guide 

OroMarketplace is a powerful open-source digital B2B marketplace solution for businesses that want to build a marketplace for their own industry and expand by adding additional sellers or suppliers. Unlike most marketplace platforms, it is specifically designed for the B2B sector, enabling distributors, retailers, brands, or manufacturers to sell physical goods and services to other businesses. OroMarketplace is based on OroCommerce Enterprise, which allows for handling all storefront and back-office components and automating B2B processes using various workflows.

Organizations 

Sellers vs Operator 

OroMarketplace operates with a model where there is one central marketplace operator and multiple sellers.

A marketplace seller can be either an individual or a company that sells products or services on the platform. OroMarketplace offers a platform that enables these sellers to manage their product listings and handle orders. Each seller can have multiple users associated with their operations on the platform, including individuals with different roles and responsibilities such as sales reps, product managers, and customer support reps. It is possible to create any number of sellers via the back-office.

On the other hand, a marketplace operator owns and manages the overall operation and infrastructure of the marketplace platform for the marketplace seller(s). Users associated with the marketplace operator are responsible for providing an environment that enables sellers to list their products or services and facilitates transactions with buyers. These users usually include individuals or roles responsible for managing and administering the overall functionality of the marketplace platform, such as platform administrators, technical support, and user account managers.

Sellers and the Operator in OroMarketplace are represented by organizations.

Types of Organizations 

OroMarketplace uses organization types to differentiate between Marketplace Seller organizations and the Marketplace Operator, and define what features are available for a particular organization. By default, there are two organization types, General and Marketplace Seller.

  • The General organization type allows access to all application functionality without any restrictions.

  • The Marketplace Seller type has limitations and offers only essential functionality that sellers might need, such as access to their orders and inventory, restricting them from viewing irrelevant or sensitive data.

Illustration of how marketplace seller ownership type restricts features and menus for sellers

Marketplace Operator must be of the General organization type to access all application functionality without restrictions. It must also have a global access level to create a seller organization and view records of other sellers. Please be aware that the Oro application can have only one organization with global access level.

Marketplace owner has global access level and is of General type

Important

Although there are two default organization types out-of-the-box, more custom organization types can be configured by the developer to advance and customize specific implementation needs. New custom organization types can have any set of features or restrictions added to match any business criteria.

Seller Registration 

There are three ways to create a marketplace seller in the application:

  • Via the marketplace storefront by filling in a seller registration form (using Seller Registration Workflow)

  • Via the back-office by manually creating a new seller registration request

  • Via the back-office by creating a new organization for the marketplace seller

In scenario one, the system creates a Marketplace seller admin, inventory and warehouse, and one default seller price list. A price list is also set up when a new marketplace seller organization is created as a new organization. Creating seller products is allowed by default for all seller organizations. Other configurations and scenarios involve manually creating the features listed above in the marketplace owner organization.

Registering via Storefront 

Prospective sellers looking to sell via the marketplace can submit a registration form online on the marketplace website.

Seller registration button in the storefront

The details provided in the registration form are immediately displayed in the OroMarketplace back-office under Sales > Seller Registration Requests, where you can view every such request and transition it through the corresponding workflow.

Seller registration workflow

A person responsible for registration in the marketplace owner organization (marketplace operator) can then start processing the request, accept it immediately, or decline it using the back-office Seller Registration Request workflow. Once accepted, the seller will be assigned a username and receive access to their own newly created seller organization in OroMarketplace. At each step of registration, an email is sent to the seller informing them about the progress of his application.

Email templates for the seller registration process

When a prospective seller creates a registration request from the website and has their request accepted, they automatically have a seller organization created for them by the marketplace owner, including a user record, a default price list, inventory and a warehouse.

Creating a Registration Request via the Back-Office 

A seller registration request can also be created via the back-office under Sales > Seller Registration Requests in the marketplace owner organization, provided that the person managing such requests has the details of the prospective seller. They can also create a seller organization via the back-office straight away. In both cases, the process is manual and a designated person from the marketplace owner organization must create a user for the new seller organization so they could log in to their back-office, in addition to setting up inventory and warehouse, and one default price list.

Seller Dashboard 

Dashboards are typically the first thing merchants see when they log in to the back-office. In addition to out-of-the-box widget dashboards that provide significant business KPIs, OroMarketplace offers an additional dashboard for sellers demonstrating e-commerce statistics for orders revenue and count, product statistics, and top-selling items. It is an interactive dashboard that also breaks this information down over a period of time, allowing sellers to analyze nearly any aspect of their business. There is no limit to how many dashboards of this type a seller can create in their organization.

Seller dashboard

Products and Brands 

Master Catalog is a tree structure that helps organize products into categories. Administrators of the marketplace owner organization manage a single global master catalog, the structure of which is subsequently shared with all sellers. This way, the products that sellers add from their organization are classified based on existing categories. Sellers cannot affect the structure of the global master catalog. Should they need to place products in a category that does not yet exist, they can always reach out to the manager of the global catalog for assistance. Similarly, if the marketplace owner uses a web catalog to organize products in the storefront, sellers from other organizations cannot affect its structure. It is possible to display products in the storefront by the seller via the web catalog feature. For this, add a condition to a web catalog content variant to filter products by organization attributes of your choice (e.g., name).

Configuring a product collection to display items from specific sellers

By default, all sellers can create new products in their organization. This capability can be toggled in the configuration settings of each organization, if necessary.

Product Creation option in the organization configuration settings

Sellers manage their own inventory, warehouses, and products, but the global marketplace organization stores all products from all sellers, which makes it possible to browse all existing products on the global storefront website. All products in the storefront display the name of the seller in product listings, product details, shopping lists, and on order pages. This is a feature that a marketplace owner can toggle in the global system configuration and per organization.

Seller's name enabled and displayed in the storefront

You can associate each product with a specific product brand. Brands can be managed by the marketplace owner, a seller, or both. Depending on the requirements, permissions to view, create, and edit brands are toggled per role. However, sellers cannot edit or delete brands created in the global marketplace organization from within their respective organizations. Sellers can only see brands created in their organization and the global marketplace organization and cannot view or in any way affect the brands of other sellers. There is no limit to the number of brands that can be created in any given organization.

Brands displayed in the global organization vs seller organization

Pricing Management 

As OroMarketplace has integrated OroCommerce, it has the advantage of using its dynamic pricing engine that automates price configuration and calculation. OroMarketplace pricing functionality enables sellers to quickly set up and customize different price lists for specific customers, customer groups, and websites and build aggregated price lists with any amount of price attributes, tiers, or currencies. Sellers can use the price attribute as a base value for manually or automatically generated price lists.

In OroMarketplace, price lists are managed per organization so that sellers can diversify price offerings by personalizing prices according to specific strategies, customer accounts, order quantities, or other factors.

Orders and Shipping 

Marketplace owners can configure shipping integrations and shipping rules for all sellers and per seller so proper shipping fees are calculated based on seller needs and warehouse data. The default shipping methods are Fixed Product Shipping Cost and Flat Rate Shipping with 0 value, which are created automatically after seller’s registration. Sellers can then adjust the amount as needed.

When a buyer submits an order with items sold by different sellers with different shipping options, their order is split into one parent order and sub-orders in the back-office. Each respective seller receives their portion of the order and is responsible for shipping the items sold to the buyer. The marketplace owner organization has the record of the source parent order containing information about its suborders per seller, line items, payment details, etc.

Orders split by seller in the back-office

For the orders to be split by seller (i.e., organization), a person responsible for permissions from the global marketplace organization’s owner must enable this capability in the global organization’s configuration settings.

Organization Settings of the Global Marketplace Organization

If a seller decides against using multi-shipping and the multi shipping feature is disabled for a seller organization, the marketplace owner must add the seller’s warehouse to the list of enabled warehouses in the system configuration, so buyers could proceed through the checkout and place their orders online.

Promotions 

As of OroMarketplace version 5.1.7, sellers have the capability to create their own promotions and coupons within their respective stores under Marketing > Promotions in the main menu. This feature can be toggled in the system configuration at the global level. However, sellers do not have the ability to manipulate the Restrictions and Expression fields or add segments in the advanced products filter.

Related Articles