Multi-vendor Getting Started for Admin
page last edited on 30 March 2018
This article covers:
- Steps to Launch a Multivendor X-Cart-based Marketplace - The steps that need to be taken by an X-Cart store administrator to launch a multivendor store/online marketplace.
- Administrator Tasks to Manage a Multivendor Marketplace - The tasks that need to be performed by the administrator to manage this multivendor store/online marketplace on a day-to-day basis.
In this manual, by “administrator” we mean the store owner/storefront operator or an agent acting on their behalf and represented by an X-Cart store user with the access level “Administrator” and the role “Administrator”.
Steps to Launch a Multivendor X-Cart-based Marketplace
Step 1: Ensure that the addon Multi-vendor is active
A regular single-seller X-Cart store is transformed into a multivendor marketplace by the addon Multi-vendor. The store administrator can check whether they are using the X-Cart Multivendor edition by checking the “Installed Addons” section of the store: the addon “Multi-vendor” must be active. Information on the management of addons in X-Cart is available in the section Managing Addons.
Step 2: Choose the Multivendor mode
Before anyone can sell products through an online marketplace based on X-Cart Multivendor, the store administrator needs to configure it. Besides all the configuration needed for a regular single-seller X-Cart store, a multivendor X-Cart store needs some additional configuration through the Multi-vendor addon settings page. The first and most important setting that the store administrator needs to adjust on this page is Multivendor mode . With this setting, the store administrator needs to specify which store operation mode they want to use. Two modes are supported: “Warehouse” and “Vendors as separate shops”).
Vendors as separate shops
If the mode “Warehouse” is chosen, the store administrator will have to use the Company address section in the store’s Contact information) to specify the location of the warehouse from which the products will be shipped to the buyers. This address is needed for shipping and tax calculation and will be used as the ship-from address for all the vendors selling through the marketplace. The administrator will also have to configure the shipping methods that will be used to ship orders from that address.
If the mode “Vendors as separate shops” is chosen, there will be no common ship-from address: each vendor will ship their orders from their own business location, which means a separate ship-from address for every vendor. Also, every vendor will have to configure their own shipping methods. The store administrator will need to ensure that every vendor is properly instructed as to what address and shipping settings they need to configure in their Vendor area to ensure that shipping and tax calculation is done properly for their orders.
Step 3: Check and adjust the user access permissions (user roles + privacy and access settings)
The store administrator must ensure that all the users of the multivendor store/marketplace - including vendors - have the access permissions required to do their work. The administrator manages the access permissons using Roles (Users > Roles). The addon Multi-vendor introduces the role “Vendor”. The administrator can edit this role (rename the role / adjust the set of permissions given by the role) or create other vendor related roles. See the article Managing Vendor Access Permissions for details. The store administrator should also check and adjust the Privacy and access settings on the Multi-vendor addon settings page to specify their preferences as to whether the customers’ contact information may be shown to vendors, whether the vendors should have access to global attributes, and whether the vendors should be allowed to work with product ratings and reviews.
Step 4: Do the setup related to vendor onboarding
The store administrator must adjust the contents of the vendor registration page through which new sellers will apply for vendor accounts. This includes editing the welcome text and adjusting the set of form fields that will have to be completed by prospective vendors. See the article Managing the Vendor Registration Page for details. The store administrator should also specify which role needs to be assigned to new vendor users by default; this can be done using the setting Role to assign to new vendor users on the Multi-vendor addon settings page. Another important task that should be completed by the store administrator before new vendor users start to log in to the Vendor area is to adjust the onboarding welcome message for new vendors. The vendor onboarding message will be displayed on the Vendor area dashboard; this message can be used by the administrator to provide an overview of the steps a new vendor is required to complete before they can start selling or to share any other kind of important information with the vendors. The vendor onboarding message can be configured using the Vendor onboarding welcome message field on the Multi-vendor addon settings page.
Step 5: Check and adjust Multi-vendor email notifications
The store administrator must check the section Email notifications (Store setup > Email notifications) and adjust the notifications specific to Multi-vendor. For more info, see Managing Multi-vendor Email Notifications.
Step 6: Get some sellers to join your marketplace as vendors
Once the store has been configured to work as a multivendor marketplace, it is time to invite the sellers. The sellers will need vendor accounts. The store administrator can add new vendors via the Users section of the Admin area or have new sellers submit a vendor registration application via the “Become a seller” link on the storefront and then approve their applications in the Admin area. If someone who wants to be a vendor already has a customer account with the store/marketplace, the administrator can convert their existing customer account to vendor.
Step 7: Help vendors with the setup of their catalog
The store administrator needs to provide help to the vendors as they start adding their products to the catalog. At the minimum, this includes setting up the catalog categories for the vendors to use (because vendors do not have access to the creation of categories) and, if necessary, helping the vendors to set up the product classes, attributes and attribute values they require. More info on this is available in the section Supervising the Product Catalog. Generally, the store administrator will have full access to any products created by vendors and may help the vendors by reviewing/editing/removing products on their behalf. If necessary, the store administrator may even add products to the catalog on behalf of vendors (manually one by one, or via import - everything will work as usual with the only difference that the administrator will have to specify the vendor who will be the owner of the product).
Step 8: Set a commission for the vendors
In an X-Cart-based multivendor store/online marketplace, vendors pay a commission to the store owner/storefront operator on each sale. The store administrator must specify the commission rates that should be used to calculate the commissions. The store owner may choose to use the same commission rate for all the vendors, or to set commission rates specifically for each vendor on an individual basis. See Setting Vendor Commissions for more information.
Step 9: Choose and configure the payment methods
The store administrator chooses and configures the store’s payment methods. Most of the payment methods supported by X-Cart 5 support a single payment recepient account. So, for the vast majority of payment methods, it will be the administrator who will receive the money from all the sales at their account; the administrator will then have to distribute the earnings to the specific vendors. There is, however, a payment method that is currently integrated with X-Cart which supports automated payment of earnings to the vendors - PayPal Adaptive Payments. For details, see PayPal Adaptive Payments.
Step 10: Decide on the shipping methods
In the “Warehouse” multivendor mode, the products of different vendors are all shipped from the same warehouse, and it is the storefront operator who is responsible for shipping the orders out to the buyers. So, it is the store administrator who must configure the shipping settings. This is in no way different than configuring the shipping settings in a regular single-seller X-Cart store. More info on the subject can be found in the Shipping section of this manual. In the “Vendors as separate shops” multivendor mode, each vendor has to ship their own products from their own business location. For this reason, each vendor has to add and configure their own shipping methods. The process is the same as when completed by the store administrator, with the only difference - that the vendors have to configure their shipping methods in their own Vendor area. The store administrator must ensure that each of the selling vendors has at least one shipping method configured and enabled.
Step 11: Configure the taxes
Depending on the business model employed by the store, the taxes will have to be collected on the sales and paid to a government organization by either the vendors themselves or by the store owner/storefront operator. To ensure proper calculation of taxes, the store administrator must specify in the Finance section of the Multi-vendor addon settings page, who is going to be responsible for the collection of taxes on the sales through the store/marketplace: the site owner or the vendor.
Regardless of who is going to collect taxes (the store owner/storefront operator or the vendors), the setup of taxes and tax rates for the entire store/marketplace is the responsibility of the store owner/storefront operator.
The store administrator representing the store owner/storefront operator will need to configure tax calculation with one of the following methods:
- Using an X-Cart tax configuration addon like Sales tax, VAT/GST or Canadian taxes (This method involves extensive configuration of zones, taxes and tax rates). or
- Using an integration of an online tax calculation service like AvaTax or TaxJar (This method involves getting an account with one of the online tax calculation services and configuring the store to connect to the respective service to get tax rates for each order).
More information on the use of TaxJar and AvaTax integrations with X-Cart Multivendor is available here:
- AvaTax Sales Tax Automation: Usage with Multivendor;
- TaxJar Sales Tax Automation: Usage with Multivendor.
Step 12: Adjust the vendor payout options and payout request related email notifications
Unless the multivendor store/online marketplace has been configured to use a payment method that will automatically transfer the money from the sales to the accounts of participating vendors, the store owner will have to track vendor earnings and to do payouts into the accounts of the vendors. To facilitate the process, payout requests can be used. This feature enables vendors to request a payout of their share of the revenue accumulated on the account of the store owner/storefront operator, and the administrator - to approve or decline such a request. If the store administrator intends to use this feature, they should adjust the payout related settings in the Finance section of the Multi-vendor addon settings page. For example, the administrator can set a minimal balance that a vendor must have to be able to request a payout of their earnings, enable an email notification for payout requests, and so on. X-Cart provides a few payout request related email notifications; so, if the payout requests feature is going to be used, the store administrator should check the text and settings of these notifications. See Managing Multi-vendor Email Notifications for details.
Step 13: Check and adjust the Multi-vendor Appearance settings
The store administrator should set the Appearance preferences on the Multi-vendor addon settings page to adjust the appearance of the vendor list in the customer area and the way vendor rating is displayed.
Step 14: Consider activating other Multivendor-related addons
The store administrator may choose to extend the functionality of their multivendor X-Cart store/online marketplace by other X-Cart addons. See Multivendor Components for an overview of the addons typically used with Multi-vendor.
Administrator Tasks to Manage a Multivendor Marketplace
Task 1: Supervise the users
The store administrator manages the existing vendor users, including the removal of vendor users, export of vendor information and access to all the information associated with specific vendor profiles. See Managing Vendors for details.
Task 2: Supervise the catalog, coupons and discounts
The store administrator exercises the function of supervising the product catalog. See Supervising the Product Catalog for more information.
If the store uses the addons Volume Discounts and Coupons, the store administrator can help vendors with the setup of volume discounts and coupons, respectively. For more info, see Coupons: Usage with Multivendor and Volume Discounts: Usage with Multivendor.
Task 3: Work on the orders
The store administrator has full access to all the orders in the store.
In the “Warehouse” mode, the administrator performs the following functions:
- updates order statuses according to the store’s order processing flow;
- if necessary, makes changes to orders using the Advanced Order Management (AOM) capabilities;
- can send order tracking information to customers regarding the packages sent to them.
In the ”Vendors as separate shops” mode, the administrator has the same capabilities as in the ”Warehouse” mode, but, typically, only acts as a supervisor - whereas the processing of orders and making changes to the information of specific orders is carried out by the vendors.
Task 4: Get information on how your vendors’ business is going
It is always a good idea to check from time to time how the business of individual vendors on the marketplace is going. The store administrator has access to vendor statistics including:
- Order statistics,
- Best sellers,
- Vendor statistics,
- Transactions history.
See Viewing Vendor Statistics for more information.
Task 5: Pay the vendors and track the flow of money to and from the vendors
Unless the multivendor store/online marketplace uses a payment method that supports automated distribution of the money received from a buyer by way of order payment between the store owner and the vendors (like PayPal for Marketplaces or PayPal Adaptive Payments (Legacy)), all the money from the sales of vendor products ends up in the hands of the store owner who has to handle the distribution. The store owner needs to ensure that the money earned by the vendors goes to the vendors, whereas the commission that should be paid by the vendors to the store owner remains in the hands of the store owner. X-Cart does the calculation of the amounts earned by the vendors and the amounts earned by the store owner as a commission in each case. After a vendor’s product has been sold and the money has been received by the store owner, the vendor can request a payout of the money due to them. The store administrator should review the payout request and, after making sure that all is correct, ensure that the money is transferred to the vendor. If an order gets canceled/refunded, the respective adjustments need to be made, and some or all of the money received by the vendor may have to be returned to the store owner so they can handle the refund. To keep track of the transactions between the vendors on one end and the store owner on the other, the store administrator has to register all the cases when the money changes hands while being distributed to the vendors or goes back from the vendors to the store owner. More info on this is available in the section Vendor Payouts and Tracking the Flow of Money to and from the Vendors.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.