How to enable advanced editor for vendors

In the section “Advanced editor” you can enable an advanced editor for allowing vendors to enter their own shop description. The editor used is the one integrated in WordPress and allows also HTML tags.

Enable advanced editor for vendors

Advanced editor - Vendor side

By enabling the button “media” in the advanced editor, each vendor is given the possibility to add media files belonging to the site gallery into the description.

Media button for vendor

Add media

How to enable the vendor vacation

By activating the “Seller Vacation” option (in “YITH Plugins -> Multi Vendor -> Add-ons”), vendors will be free to close their shops “for vacation” for a certain amount to time they can decide.

Vendor vacation

With this section, vendors will be free to set their shops as “closed” for a certain amount of time, showing customers a customized message in the vendor page and in product detail pages.

Vacation section

During this period, vendors can decide whether to continue selling their products or preventing purchase them.
The latter will remove the “Add to Cart” button on every vendor’s product, even if these will be available in catalog mode, but removed from the “Shop” page.

Vacation section

Order synchronization

Order synchronization allows you to update the parent order and suborder (also more than one suborder) status automatically if editing one of them.

Orders can be synchronized when:

  • the parent order status changes
  • the suborder status changes
  • both previous cases

Let’s learn about how the synchronization manages the order status change.

Parent-suborder synchronization

The suborder updates automatically when the parent order status changes, acquiring the same status.

To let the synchronization work correctly, that you activate the option “Parent-suborder synchronization”, which you can find in the tab “Vendors” of the plugin settings dashboard.

order management

Suborder-parent order status synchronization

The parent order updates automatically when the status of one of the suborders changes.

To activate this synchronization, enable the entry “Suborder-parent order status synchronization”.

Suborder-parent syncronization

How is the parent order status set when the suborder status changes? 

  • If all suborders are set as completed, the parent order acquires the completed status
  • If all suborders are set as refunded, the parent order acquires the refunded status
  • If all suborders have the completed and refunded status (related to a partial refund of the parent order), the parent order status is set as completed 
  • If suborders have different statuses, the parent order acquired the processing status. 

Please note: if the parent order has only one suborder, both order statuses are always perfectly synchronized.

 

How to edit vendor details

Administration side

You can find a complete list of all vendors registered in section “Vendors”.

List of vendors

Click on vendor’s name to open his/her profile and edit, if necessary, his/her information.

List of vendors

Following you find a complete list of the editable pieces of information.

  • “Name”: vendor shop name
  • “Slug”: vendor shop slug; if the vendor has registered in frontend, the slug will be automatically processed depending on the shop name.
  • “Description”: vendor shop description (shown in vendor shop page)
  • “Header image”: image shown in the vendor shop page
  • “Vendor shop owner”: user to which the shop has been associated. He/she can manage all products in the vendor shop and payment data of the vendor.
  • “Vendor Shop Admins”: name of the user(s) that will be given the role of administrator of this vendor shop. Each vendor shop admin can manage all products of this vendor shop and information displayed in vendor shop page; you can give this role to any user of your shop that you will enter here and select among the results of an ajax search. Vendor shop admin or admins can be chosen also by the vendor shop owner.
  • “Contact information”: contact information shown in the page. Among these information there are also VAT and Company legal notes.
  • “Social Profile”: URL of social profiles associated to the vendor. Social networks available are Facebook, Twitter, Google+, LinkedIn, Youtube, Vimeo, Instagram, Pinterest, Flickr, Behance and Tripadvisor.
  • “PayPal email address”: PayPal email address used by the vendor
  • “Bank Account (IBAN/BIC)”: IBAN/BIC associated to vendor. It showed in Commissions list.
  • “Enable sales”: this option lets you enable or disable each single vendor’s sales.
  • “Skip admin review”: this option allows vendor to publish new products without admin permission and overrides “Skip admin review” option in “YIT Plugins -> Multi Vendor -> Vendors”.
  • “Commission”: commission percentage owed to the vendor for each product sold in his/her shop. Default commission is the same as the one specified in the tab “Commissions” in plugin panel option, but it can be changed any time using this option.
  • “Registration date”: date in which the vendor shop was created.

Here you find an example of vendor page in which all vendor shop information is collected.

Vendor shop page

Vendor side

If logged as vendor, information about the shop can be edited both in “Vendor settings” and in “Front page” sections.

Vendor settings - Vendor side

Frontpage settings - Vendor side

General notes about the commission management

Definition of terms
Commission: it refers to the partial amount that admin pays to sellers/vendors on each product sold.

In the tab Commissions in the plugin options panel, you can set general conditions for vendor’s commission management.

General settings

The commissions that go to the vendor can include coupons or not. Check or uncheck the option Include coupons in commission calculations to do that.

Enable coupons

You can decide how to credit tax fees. Select one of the options available in the drop-down menu next to Taxes to credit taxes either to the admin, or the vendor or to both of them.

You can choose among:

  • Credit taxes to the website admin
  • Split tax by percentage between website admin and vendor
  • Credit taxes to the vendor

 

Enable taxes

Let’s make an example to clarify how this option work:

Suppose we have:

  • product A that costs $12 ($10 product price + $2 tax);
  • vendor A who gets 50% commissions on each product sold.

If you select Credit taxes to the website admin, the vendor will get 50% of the product price, that is $5. The remaining 50% and the tax fee goes to the admin, who gets $5 + $2 = $7.

If you select Split tax by percentage between website admin and vendor, the vendor gets 50% of the product price and 50% of the tax fee, that is $5 + 1 = $6.

If you select Credit taxes to the vendor, the vendor will get 50% of the product price, and $2 tax, for a total of $7. The admin will get the remaining 50% of the product price, so, $5.

Override commission percentage on vendor/product level

The commission amount is a general one and applies to all the shop vendors. Yet, you can override the general settings and specify a different commission percentage for each vendor and/or for every single product.

Commission for vendor

Vendor commission

Commission for product

Commission for product

If you set both a custom commission by vendor and for a given product, the vendor commission settings will be overridden and the product commission settings will apply.

How to access to commission details

To view the status of all vendor’s commissions, go to Commissions menu that you can find in WordPress admin area.

You can search specific commissions also by order ID from the related search field.

Vendor commissions

Let’s see together information given for each single commission::

  • ID: commission ID, available also in order detail page
  • Product: product associated to the commission
  • Rate: commission rate associated to the product
  • User: user associated to the vendor shop
  • Vendor: name of the vendor to whom the selected commission is credited
  • Ship to: shipping list of the user who made the order
  • Amount: amount of the commission owed to the vendor
  • Date: commission generation date
  • Last Update: date of the last update of the commission
  • Actions: directly from “Commissions” page, you can pay commissions via PayPal, using the specific button that you find next to each commission. Once sent a payment request to PayPal, the commission state will be switched to “Pending” and then to “Paid” when PayPal payment has been successful.

All information is available in commission details page.

Commissions details

For payment of commissions to your vendors, please, read more on this page.

How to change the commission status based on the order status

The commission status is directly bond to the status of the order it’s linked to, and it’s handle in different ways according to whether you are using manual payment or automatic payment through MassPay and PayPal Adaptive Payments.

Please note that since PayPal does no longer support MassPay and Adaptive Payments services, they cannot be activated on new users’ accounts.
Yet, users who had previously activated either PayPal MassPay or Adaptive Payments services can keep using them to manage payments automatically and can refer to the following information for the configuration.

Manual payment

Order statusCommission status
on-holdpending
processingpending
completedunpaid

Automatic Payment using MassPay

Once an order is created, its commission is automatically generated on unpaid status, this status will later change into processing.

As soon as your system receives the IPN code from PayPal, the commission status will turn into Paid.

Order statusCommission status
refundedrefunded
cancelledcancelled

Automatic Payment using PayPal Adaptive Payments

PayPal statusOrder statusCommission status
CancelledCancelledCancelled
CreatedOn-HoldProcessing
CompletedCompletedPaid
IncompletePayment Method Parallel: On Hold
Payment Method Chained Delay: Completed
Completed
ErrorFailedUnpaid
ReversalerrorFailedUnpaid
ProcessingOn-HoldProcessing
PendingPendingProcessing

How to include costs of goods in a commission page

WooCommerce Costs of Goods is a plugin that allows adding the production costs to each product.

Thanks to the integration between the two plugins, you can decide to include this cost in the commissions due to the vendor.

To do it, go to YITH Plugins -> Multi Vendor -> Commissions and enable the entry Cost of goods handling.

Cost of Goods handling

To show the production costs on the detail page of the commission, enable the Show Cost of goods information entry.

Show cost of goods

Report

Administration side

YITH WooCommerce Multi Vendor gives you the possibility to report all moves connected to vendors in the specific report section within WooCommerce Report. You’ll find the tab Vendors in WooCommerce report.

Report

The report is made of two main sections: report of sales associated to vendors and the one reporting vendors’ registrations.
You’ll find the first one in the section “Vendor Sales”.

Report for vendor

Sales report can be filtered using the following filters:

  • Search Vendors: enter the name of a vendor, to display his/her sales only.
  • Top Sellers: select and view the sales report for one of the vendors with most sales on your store.
  • Top Earners: select and view the sales report for one of your top earners.

On the contrary, in “Registered Vendors” you can see the report with all vendors’ registrations into your store.

Report vendor registrati

The plugin allows you to set the maximum number of rows shown for each report through the option Vendor Report limit that you can find in the tab Reports in the plugin option panel.

Vendor report limit

Vendor side

Each vendor can trace statistics related to his/her own products in “Sales report” section

Vendor report

General information about payment methods

Payment of vendors’ commission can either be done manually or automatically using one of the supported and activated payment gateways.

Manual Payment

It’s up to the global shop admin to manage the manual payment.
To do that, please, verify whether there are commissions to be paid and then proceed to pay them: once this action is completed, commissions can be marked as paid by changing their status from the settings page.

Methods available

Automatic Payment

To enable a default payment on checkout that splits commissions between the admin and the vendors, go to YITH Plugins > Multi Vendor > Gateways and select your preferred payment method from the dropdown menu called Pay commissions to vendors during checkout.

gateways_dropdown

Multi currency support

If your payment gateways support the multi currency option, this plugin will let you pay vendors’ commissions in every currency you have. Meaning that if you are running a multi currency store, commissions will be calculated and paid with the same currency they have been generated.

For example, if you are running a store in Euros and USD, your vendors will get commissions in Euros for orders placed and completed in Euros, and commissions in USD for orders placed and completed in USD.

Supported gateways

At the moment the supported payment methods are the following:

  1. Stripe Connect
  2. PayPal Mass Pay or Adaptive Payments (deprecated services)

1. Stripe Connect

Thanks to Stripe Connect integration, you will be able to issue payments to your vendors automatically and instantly during the checkout. Please, refer to this page to learn more about how to enable and configure this payment the right way.

2. PayPal

Since PayPal does no longer support MassPay and Adaptive Payments services, they cannot be activated on new users’ accounts. Yet, users who had previously activated either PayPal MassPay or Adaptive Payments services can keep using them to manage payments automatically and can refer to the following information for the configuration.

Note: as the above services have been deprecated, you’ll have to install a free module that you can download from this page.

Support for PayPal deprecated services

Automatic commission payment is provided only if vendors have specified PayPal address and you have correctly set your PayPal Business account.
You’ll need to have activated at least one of the two provided payment services: MassPay and PayPal Adaptive Payments (Only available if you already own YITH Paypal Adaptive Payments for WooCommerce).

In the case of automatic payment, the commissions can be paid immediately or only after reaching a specific threshold. The global administrator of the shop can set a payment threshold valid for all the vendors. On the contrary, if any threshold has been set, each vendor can configure a different value directly from their profile.