Multi-vendor Beginner's Guide for Vendors
page last edited on 13 November 2015
The Multi-vendor Beginner’s guide for X-Cart vendors covers:
- the steps that a vendor should make to configure vendor-dependent part of the marketplace;
- the tasks that need to be performed by the vendor a day-to-day basis.
In this manual, by “vendor” we mean a marketplace vedor/seller/merchant or an agent acting on their behalf and represented by an X-Cart store user with the access level “Administrator” and the role “Vendor”. Vendors are allowed to log in to the store’s back end, but have access only to a limited set of features (This is called a “Vendor area”).
- Steps to Configure a Vendor Area in X-Cart-based Marketplace
- Step 1: Access the Vendor Area of X-Cart-based Marketplace
- Step 2: Read the Onboarding Welcome Message
- Step 3: Check and Adjust the Vendor Profile
- Step 4: Check the Profile Financial Details
- Step 5: Populate Catalog with Products
- Step 6: Assign Tax Classes to Products
- Step 7: Configure Shipping
- Step 8: Configure Coupons and Discounts
- Vendor Everyday Routine
Steps to Configure a Vendor Area in X-Cart-based Marketplace
Step 1: Access the Vendor Area of X-Cart-based Marketplace
After a vendor account has been registered (see Vendor Registration), the vendor can log in to their personal Vendor area using any user login form in the store.
For example, they can use:
- the regular Sign in/Sign up form for customers,
- the URL for administrator users:
- the URL for vendors:
http://<your-domain>/<x-cart-5-directory>needs to be replaced with the actual address of your X-Cart 5 store).
After logging in, the vendor will see a page similar to the following:
Step 2: Read the Onboarding Welcome Message
If a vendor onboarding welcome message has been provided by the storefront operator (similar to the one in the screenshot above, titled “Welcome to our marketplace”), the vendor should read the message and follow the instructions provided therein.
Step 3: Check and Adjust the Vendor Profile
The vendor should check the information in their user profile and see if anything needs to be added or corrected. See Managing vendor profile information as a vendor.
Step 4: Check the Profile Financial Details
Please note that vendor users do not set tax rates. Setting tax rates is the responsibility of the store administrator.
If, according to the store’s Multi-vendor configuration settings, vendors have been given the responsibility to collect sales tax on their own sales, and an automated sales tax calculation solution like AvaTax or TaxJar is used by the store, the vendor must check the Financial details section in their profile (My account > Financial details) and see if there is any tax related configuration to be done there.
For example, vendors in the U.S. need to ensure that all the US states in which they are going to do business and which pertain to their nexus (and only those states) are listed in the “US tax calculation” settings section. This is needed to ensure that tax calculation requests to AvaTax/TaxJar are sent properly for the vendor.
For more information on the usage of AvaTax Sale Tax Automation with X-Cart Multivendor, see AvaTax Sales Tax Automation: Usage with Multivendor.
Failure to specify the states in the Financial details section properly may result in the store’s failure to send tax calculation requests to AvaTax/TaxJar for the vendor’s products.
Step 5: Populate Catalog with Products
The vendor should populate the catalog with the products they are going to sell. See Managing the catalog as a vendor for information on how vendors can add products to the catalog manually. See Vendor import/export for information on how vendors can add products using CSV import.
Information on the use of product classes and attributes by vendors can be found in the section Vendor access to product classes and attributes.
Step 6: Assign Tax Classes to Products
The vendor does not take part in the configuration of taxes, tax rates or tax classes; it is the responsibility of the store administrator.
However, to ensure that the store’s tax configuration works for them, the vendor needs to assign the tax classes created by the store administrator to their products and (if the store is set to work in the “Vendors as separate shops” multivendor mode, and the vendor has their own shipping methods to which tax rates need to be applied) shipping methods. The store administrator can check whether the tax classes configured by them have been assigned to the vendor products and shipping methods as expected and, if required, can correct the classes assigned. In the event that a proper tax class is not assigned to the vendor’s products or shipping methods by the vendor or by the store administrator, the default tax class will be used for them. For more info on tax classes, see Tax Classes.
Step 7: Configure Shipping
If the store is set to work in the “Vendors as separate shops” multivendor mode:
The vendor must specify the address from which their products will be shipped. This address will be used to calculate the cost of delivery of an order from the vendor’s warehouse to the buyer. See Managing vendor profile information as a vendor
The vendor must specify the shipping methods they are going to use. See Managing shipping methods as a vendor.
In “Warehouse” mode, the products of different vendors are shipped from the same warehouse, so the “ship-from” address and shipping methods are the same for all the vendors; the configuration of the “ship-from” address and shipping methods in this case is done by the store administrator.
Step 8: Configure Coupons and Discounts
If the option to create coupons and discounts has been enabled for the vendor by the store administrator, the vendor can create coupons and discounts for their products. See Coupons: Usage with Multivendor and Volume Discounts: Usage with Multivendor.
Vendor Everyday Routine
Task 1: Check Orders and Order Statistics
Once customers start buying products owned by the vendor, the vendor will be able to view the orders via the Orders section. They will also have access to sales statistics including their order statistics and best selling products. See Vendor access to orders and statistics.
Task 2: Request Vedor Payouts
With every purchase of the vendor’s products, the vendor’s earnings will be accumulated on the vendor’s earning balance. As soon as a sufficient amount of money has been accumulated on the vendor’s earning balance, the vendor will be able to request a payout of the money due to them. See Requesting a payout of one’s earnings as a vendor.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.