Guide for Commercetools Multi Vendor Marketplace Integration

Commercetools Multi Vendor Marketplace extension makes it easy to create a platform where various independent sellers can showcase and sell their products to customers.

This feature enables Commercetools admin to launch a scalable multi-vendor marketplace with minimal effort.

This adaptable and expandable marketplace lets vendors handle their products and manage orders efficiently.

Customers can explore a variety of products and place orders that include items from different sellers, all while enjoying a seamless checkout process.

Payments are handled and divided between the marketplace and the individual vendors.

This ensures that each one gets their fair share through the Commercetools Multi Vendor Marketplace integration.

Additionally, feel free to explore our top-notch services for developing scalable marketplace applications tailored for enterprises.

Check out the video mentioned below for a brief overview of the module:

• This extension transforms Commercetools into a Multi Vendor Marketplace (MVM).
• It imports data from Commercetools into the Multi Vendor Marketplace.
• Ensure automatic synchronization of data between Commercetools and the Marketplace.
• Facilitate admin oversight of user roles and permissions.
• Enable product and inventory management through the Commercetools Multi Vendor Marketplace Integration.
• Simplify the management of seller commissions and payouts.
• Provides order management within the Multi Vendor Marketplace.
• Establish a distinct vendor registration area on the storefront.
• Create individual profile pages for vendors displaying their information on the storefront.
• Implement separate management panels for vendor products, orders, and payments.
• Enable MVM sellers to include products into their offerings by providing a feature within their vendor account dashboard.
• By default, product taxes will be applied to items in accordance with the settings established by the MVM admin.
• A panel is available for customers, allowing them to access their profiles, manage shipping details, review order history, and monitor the order status.
• Customers will have the opportunity to submit reviews and ratings for products, as well as provide feedback regarding their overall shopping experience.

Once, the Project has been setup at CT end, navigate to Commercetools sidepanel and navigate to Settings>Developer Settings.

Next, tap on Create New API Client to generate a new API client. In the next screen, Enter the Name and select the Scopes as per requirement.

Once done, tap on Create API Client to successfully generate the API credentials. Please note that the API credentials will be visible only once so make sure to save them.

To start the process of connecting the Multi Vendor Marketplace with Commercetools, the admin must first register on it.

First, they’ll log on to the MVM and then start the sign up process as per the image below,

Here, they’ll enter the following details,

• Email: Enter the Email ID here.
• Domain Name: Input the Domain Name.
• Password: Enter the password as per choice.
• Confirm Password: Re-enter the password.

Next, they’ll tap on Sign Up to proceed to the next page which will be as below,

On this page, the admin will enter the below details,

• Project Key: Enter the generated project key.
• Client ID: Enter the Client ID
• Client Secret: Enter the Secret Client Key in this field.
• API Host: Input the API Host credential here.
• Auth Host: Input the Authorization Host credential in this field.

Once the above fields are filled, tap on Add Details to add the Commercetools project details to the Multi Vendor Marketplace,

Once details are successfully added, the admin will be successfully redirected to the Multi Vendor Marketplace seller dashboard.

They will also be logged in as Seller in the MVM as per the below image,

Next, let’s check the options available in the Multi Vendor Marketplace Admin Panel Dashboard below,

Configuration

General Configuration

Under this section, admin can configure the MVM as per the options provided.
General Configuration is provided where information like Business Email, Store Email and Domain Name can be entered.

Further, fields like Currency, Weight Unit, Time Zone and Shop Type is entered and selected as per the image below,

Next, more options are available like Login as Seller, Dimension Unit and SAP Storefront URL and Feedback check.

After filling out and selecting the required options, admin will click on Save Details.

Product Configuration

In this section, admin can check the settings for Product related details and configurations. The below options are available,

• Auto Approve Product: By this option, all the products added to your marketplace store will be auto approved hence you don’t need to approve each new added product.
• Auto Disable Product: From this Option, your products automatically disabled after the specified date.
• Product Add by CSV: From this Option, you will be able to add products in bulk at one time, you just need to follow a particular format of CSV which you can download from Add Product Section.
• Allow Seller to Add Product: From this Option, you will be able to allow sellers so, they can also add products to your marketplace store.
• Allow Seller to Delete Product: From this Option, you will be able to allow sellers so, they can also Delete products from your marketplace store.
• Product Wise Commission: From this option, you can add commission to a particular product.
• Charge Taxes Checkbox: This option will add ‘Charge Taxes’ option to ‘Add Product/Edit Product’ Section, which will allow you to add or remove tax for that particular product.
• Charge Taxes on Products by Default: Charge taxes on products by default.
• Require Shipping for Normal Products: From this Option you can choose whether normal products require shipping by default or not.
• SKU for Digital Products: From this Option you can Choose whether you want SKU for digital products or not.

Barcode for Digital Products: From this Option you can Choose whether you want Barcode for digital products or not.

• Make Collections Mandatory: From this Option you can Choose whether you want to mandate collections while adding/editing product.
• Add Seller Product By: From this option, you can select whether you want to assign products to the sellers using the seller shop name or seller email.
• Want To Use Your Amazon S3 Credential for Digital Product: From here you can enable an option to upload the marketplace products using your own amazon S3
• Product Description: From this Option, You can select whether you want to edit the product description in TinyMCE editor or plain text area.
• Transaction Charge: Choose whether you want to manage transaction charges on your store orders or not.
• Show Product Policy: This option will allow you to show product policy on the product description page of your store.
• Directory Listing for Normal Products: This option will enable the directory listing of normal products.
• Maximum Collections Allowed Per Product: Maximum number of category allowed to a product

Additional Configurations

• Allow Seller to Add Product’s Meta Fields: From this Option, seller can also add meta fields for product.
• Allow Seller to Disable Product: From this Option, seller can also disable product.
• Manage Default Track Product Inventory: From here, you can set a default option to manage the tracking of product inventory
• Add Option To Select Alternate Template File for Product: From here, you can set a default template for Newly added product
• Allow Sellers to Set Minimum Purchase Quantity Per Product: From this option you can allow minimum purchase quantity for products.
• Allow Sellers to set Maximum Purchase Quantity Per Product: From this option you can allow maximum purchase quantity for products.
• Allow Seller to set product price to Zero: Enabling this option, you can allow sellers to set product prices to 0 and create Free Products.
• Product Form Help Text: Enable Help Text on Product Form.
• Delivery Day: By this option, you will add delivery time on product.
• Avalara Avatax: From this option, you can add Avalara tax codes to the products.
• Reapprove Seller Products After they were updated: From this option, once a seller edits a product, the admin needs to approve the changes before they become live on the storefront.
• Hide Product Tag Field While Adding Products: From this option, you can hide the product tag field from the “Add/Edit Product” form.

Allow to add link for Digital Product:

From this option, you allow to add link for digital product.

• Allow seller to add country of origin for product: From this option, you can allow seller to add country of origin on the product.
• Allow to add video while editing products: From this option, you can add video on a product while editing product form.
• Show Product Image field under “Product Listing” section: By enabling this option, You can show the product image field under product listing section.
• Dual Sync Product: Enabling this configuration, you can allow sync of selected product details into Multivendor Marketplace App ,when changes are made from Commercetools end.
• Product Price Round Off: Round off product price upto the decimal value.
• Allow Seller to add cost price: From This Option Allow Seller To Add Cost Price.
• Disabled Products List Send on mail once every day: From This Option email is send to the admin regarding all the products disabled. Email is triggered once every day.
• Image at Variant Level: Enabling this configuration, will manage images at product level.
• Multiple Images at Variant Level: Enabling this configuration, will manage multiple images at variant level.

Once settings are done, Admin will click on Save Changes to save the selected settings.

Seller Configuration

Admin can also configure the seller settings from the dashboard, the below options are available for them,

• Allow Seller to Fulfill Item: From this Option, You can allow the sellers to fulfill their order products.
• Auto Approve Seller: From this Option, You can approve a new seller automatically.
• Seller Add by CSV: From this Option, You can add new sellers in your store by uploading a CSV file containing seller details.
• Allow seller to view customer details: From this Option, You can allow seller to view customer contact details.
• Allow seller to view customer email: From this Option, You can allow seller to view customer email.
• Allow Seller to view customer contact number: From this Option, You can allow seller to view customer contact number.
• Seller Policy: Select the Policy for sellers.
• Restrict Seller Signup: From this option, you can restrict your sellers to signup from seller panel.
• Seller Email Verification: From this option, you can verify your sellers email before Sign in.
• Allow Seller to change weight unit: From this option, Seller can add/update product weight unit.

Additional Configurations

• Restrict Seller to disable feedback: Disabling this option, you can restrict sellers to hide the seller feedback.
• Update Seller Handle: Enabling this option, you can update seller handle.
• Allow to redirect new page for seller email verification: From this option, you can verify your sellers email before Sign-in another page.

Allow Seller to add shop name at signup page: From this option, Seller will add the shop name at signup page.

• Auto Approve Seller Feeback: Auto approve all seller feedbacks.
• Advance Seller Feedback: Enable Advance Seller feedback option.
• Allow Seller to choose selling category: From this option, Seller will change Product Collection.
• SSO (Single Sign On) for Seller: Enable SSO “Single Sign ON”.

Next, they can tap on Save Changes to save the settings.

Orders Configuration

In this section, the admin can configure the order based settings and configurations.

Multiple options and selections are available for the admin to set such as Order Shipping method, order tracking number, product price tax inclusion etc.

Restrictions Configuration

The admin can configure various product based restrictions from this section.

Here, they set various restrictions on Products which will be listed on the multi vendor marketplace. Some restrictions include restricting product type, product collections etc.

Recaptcha Configuration

Admin add details and sets the Google reCaptcha configuration for the storefront.

Admin will have to enter the Google reCaptcha Site Key and Google reCaptcha V2 Secret Key to configure it.

Update Merchant Details

This section is to update the Merchant or API details. If there is any change in the credentials, the admin can update them from here.

The admin also gets the below listed sections to manage the Multi Vendor marketplace as per their requirement,

• Sellers: Manage the Listing of Sellers on Marketplace as well as add new Sellers.
• Products: Manage Product listing and import settings.
• Orders: Configure Order Listing and Invoice settings
• Commission: Configure Commission settings.
• Payment: Settings for Seller Payment and Payment Methods.
• Translation: Label Translation Configuration section
• Upgrade Plan: Section to check and upgrade plan.

Initially, the sellers will have to sign up or register on the marketplace platform to start selling their products on it.

They will enter the required details and create an account to register on the multi vendor marketplace.

Sellers will be able to register either through a registration link sent by admin or from the storefront.

Tap on Create My Account, to redirect to the below page which informs the seller regarding account approval,

Now, seller will tap on My Account to access the seller dashboard. Once the admin approves the seller, they will be able to view the options on dashboard and enabled configurations.

Apart from the Dashboard, the vendors will also get the following sections on the seller Panel. The configurations will be available which are enabled by admin,

• Configuration: Access the configurations enabled by admin.
• Products: Manage the Product based settings from this section.
• Orders: Seller can manage the orders from this section.
• Profile: Manage the profile and edit or update the profile information.

Vendor Adds Product

To add a product to the marketplace, vendor will navigate to Products>Product Listing. After that, they will tap on Add Product.

Next, fill out the required product details and tap on Save Changes to save the product and send it to the admin for approval.

Through the seller landing page, users can check the Register to become a seller on the marketplace.

Here, they can check how to Become a Seller and also view the list of Sellers registered on the marketplace.

When they tap on Become a Seller, user will be redirected to the seller registration and login page as per below image,

Users can also check the list of sellers on the marketplace. They’ll tap on View All Sellers to check the registered marketplace sellers.

Next, they can tap on a particular Seller to open the Seller Profile page and check the seller Products, Reviews, Policy and Contact information.

Customers will visit the storefront to check and purchase products from the marketplace.

Admin and Vendor listed products will be visible on the store front. Customers will be able to view the products based on category and specific product pages as well.

Next, the customer can tap on any product to view its details and proceed further for purchasing it.

They will proceed to add the product to cart by clicking on Add to Cart and then click on the cart button,

After adding the product to cart, customer can check the product details before proceeding to checkout or add more products to the cart as needed.

Now, customer taps on Checkout to go to the checkout page and process the order further. They will select the Payment and Shipping options here along with shipping & billing address.

Now tap on Place Order, and redirect to the storefront with a success message.

That was much about the Commercetools Multi Vendor Marketplace Integration, for any queries you can drop us an email at [email protected] or raise a ticket.

Additionally, you can also look at the Multivendor Marketplace For SAP Commerce Cloud which allows to convert SAP Commerce Cloud to a marketplace.