Multivendor: Troubleshooting and FAQ

Solutions for common Multivendor problems: vendor menu missing, products not visible, vendors not credited, no shipping options, emails and API errors.

Vendor menu or blocks missing

  • Refresh Extensions > Modifications after each upload. See How to reset modification cache in Opencart 3.
  • Open the Multivendor settings once and save them.
  • Another theme: the My Account block, the vendor name on product pages and vendor orders in the customer order page come from changes of the default-theme templates. See Adapting a theme.
  • The customer has no vendor profile, it waits for approval, or it is disabled: My Vendor Account shows "Register vendor account", "Waiting for Approval" or "Vendor account is inactive".

Vendor cannot register or add products

  • "Page not found" on registration: Allow vendors to register in store is off.
  • The vendor waits for approval: approve it in Customers > Customer Approvals.
  • "You cannot add more products. The product limit reached": raise Products Limit in the Vendor tab of the customer.
  • The Category list is empty or misses a category: check Allow For Vendor in each category, including subcategories and their parent categories. The flag is not inherited.
  • "The selected category is not available for vendor products": the vendor chose a category that is not open for vendors. Open the category or choose another one.
  • No attributes in the form: add Attribute Groups to the category.

Product not visible in the store

Check in Catalog > Products:

  • Approval Status: drafts and products waiting for approval are disabled. Approve the product.
  • Status: approved products can still be disabled by the vendor.
  • The vendor is disabled, denied or the customer account is disabled: all vendor products were disabled. After you enable the vendor, enable the products again.
  • The product category, store and the usual OpenCart product settings (quantity, date available).

Vendor not credited

  • Vendors are credited only when the order gets a status of Complete Order Status (System > Settings > Edit store > Option). Check that the status you use for finished orders is in this list.
  • Delivery statuses and Confirm Delivery do not credit vendors.
  • Orders completed before 1.0.5.0 are not recalculated.
  • Store products have no vendor and no credit.
  • Look at the Transaction tab of the vendor: a later move out of the complete statuses adds "Sale of order #N is taken back".

No shipping options for a vendor

  • Rates are defined by vendors manually: the vendor needs at least one enabled method in Shipping Methods with rates for the buyer's zone, weight and subtotal. Without it the buyer sees "No shipping methods" and cannot finish the checkout.
  • Rates for vendor carts are taken from the global store configuration: your store shipping methods must give a quote for the vendor's part of the cart alone (its weight and subtotal, the buyer's address).
  • "Warning: Shipping method required!" at the Delivery Method step, or "Shipping method is not selected for '...'" at the confirm step: a vendor in the cart has no available method, or the buyer has not chosen one.

Vendors get no order emails

  • Check at least one status in Vendor Order Statuses. With an empty list vendors get neither "New Order #..." nor status update emails.
  • Check the store mail settings: How to configure emails in Opencart.
  • The email goes to the email of the vendor's customer account.

Vendor cannot change the delivery status

  • The current delivery status (or the order status, if no delivery status is set) must be one of the Vendor Order Statuses, and so must the new one.
  • Hide delivery status completely is on.

Reviews not shown

  • Allow Reviews must be on in the store settings.
  • New reviews are Pending until you approve them in Catalog > Vendor Reviews.
  • Obsolete reviews and reviews older than the Vendor rating period are not counted in the rating.

Vendor not shown in the vendor list

  • The vendor list page is not in the store menu by default; add a link to it. See Vendor list.
  • The vendor must be enabled, with an enabled customer account and a public name in the current language.

API errors

See the error table in Product API. Common cases:

  • "apikey is not correct": the vendor generated a new key (use the current one), or the customer account of the vendor is disabled.
  • "Product already exists with the specified MPN": use update for existing products.
  • "MPN is empty": send a non-empty mpn in every request.
  • "Category is not allowed for vendors: ID": open the category for vendors (Allow For Vendor, also on its parent categories) or send another category_id.
  • An added product is not visible: API products are submitted for approval and stay disabled until approved.

For PHP errors, see How to see extended error information.

How do I pay vendors?

Pay outside the store, then add a negative transaction in the vendor's Transaction tab. See Paying vendors.

Does the store owner have to be a vendor?

No. Products without a vendor are store products: they are sold as usual, without vendor orders and commission.