This guide is intended for the administrator of a Multivendor X-Cart store. 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.”
The guide covers:
the steps that need to be taken by an X-Cart store administrator to launch a multivendor store/online marketplace;
the tasks that need to be performed by the administrator to manage this multivendor store/online marketplace on a day-to-day basis.
Steps to Launch a Multivendor X-Cart-based Marketplace
Step 1: Ensure that the add-on Multi-vendor is enabled
A regular single-seller X-Cart store is transformed into a multivendor marketplace by the add-on Multi-vendor. The store administrator can check whether they are using an X-Cart store with multivendor functionality enabled by checking the “My Apps” section in the store Admin area. In Multivendor, the add-on “Multi-vendor” will be installed and active. In fact, due to the specifics of its architecture, this add-on may not be disabled, so it will always be active if installed. Therefore, the only way to remove multivendor functionality from an X-Cart store will be to remove the add-on “Multi-vendor" completely.
Note: General information on the management of add-ons in X-Cart is available in the section Managing Add-ons.
Step 2: Choose the Multi-vendor mode
The store administrator needs to configure it before anyone can sell products through an online marketplace based on X-Cart Multivendor. Besides all the configuration needed for a regular single-seller X-Cart store, a multivendor X-Cart store needs additional configuration through the Multi-vendor add-on 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”).
When a customer's cart contains items from more than one vendor, a single order is formed.
The store administrator does the processing of the order. Therefore, the vendors cannot edit the order.
The order is delivered as a single shipment from a single warehouse location. The cost of shipping is calculated for delivery from the Company address as specified by the store administrator.
Vendors as separate shops
When a customer's cart contains items from more than one vendor, a separate order is formed for every vendor.
The vendors can fully edit their orders.
Every order is delivered from the warehouse of the respective vendor. The cost of shipping is calculated for delivery from the address specified by the vendor.
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 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. Therefore, the store administrator will need to ensure that every vendor is properly instructed on 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 multivendor store/marketplace users - including vendors - have access permissions required to do their work. The administrator manages the access permissions using Roles (Users > Roles).
The add-on Multi-vendor introduces the role “Vendor.” The administrator can edit this role (rename the role / adjust the 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 add-on 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 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 add-on settings page. Another important task that the store administrator should complete before new vendor users log into 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. The administrator can use this message to provide an overview of the steps a new vendor must complete before they can start selling or 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 add-on 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 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 a vendor.
Step 7: Help vendors with the setup of their catalog
The store administrator needs to help 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 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 for the commissions' calculation. The store owner may choose to use the same commission rate for all the vendors or set commission rates specifically for each vendor individually. 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 recipient account. So, for the vast majority of payment methods, the administrator 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 the automated payment of earnings to the vendors - PayPal for Marketplaces. For details, see PayPal for Marketplaces: Overview.
Step 10: Decide on the shipping methods
In the “Warehouse” multivendor mode, different vendors' products are all shipped from the same warehouse. The storefront operator 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. You can find more info on the subject 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 selling vendor 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 who will be responsible for collecting taxes on the sales through the store/marketplace: the site owner or the vendor, in the Finance section of the Multi-vendor add-on settings page.
Regardless of who will 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 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:
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 do payouts into the accounts of the vendors. To facilitate the process, you can use payout requests. This feature enables vendors to request a payout of their share of the revenue accumulated by 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 add-on settings page.
For example, the administrator can set a minimum balance that a vendor must have to request a payout of their earnings, enable 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 add-on 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 add-ons
The store administrator may choose to extend the functionality of their multivendor X-Cart store/online marketplace by other X-Cart add-ons. See Multivendor Components Overview for an overview of the add-ons 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 removing vendor users, exporting vendor information, and accessing 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 add-ons Volume Discounts and Coupons, the store administrator can help vendors set up 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 processing 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 how the business of individual vendors on the marketplace is going from time to time. The store administrator has access to vendor statistics, including:
See Viewing Vendor Statistics for more information.
Task 5: View and manage vendor rating information
Task 6: 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), 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 the vendors should pay to the store owner remains in the hands of the store owner. X-Cart calculates 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 store owner has received the money, the vendor can request a payout of the money due to them. The store administrator should review the payout request and ensure that all is correct and 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 to 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 Vendor Payouts and Tracking the Flow of Money to and from the Vendors.