Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Marketplace user documentation (#14028)
jaburghes73e14fa0a699
diff --git a/docs/docs.json b/docs/docs.jsonindex 5f991cf233..fb9ee78f4d 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -733,8 +733,14 @@{"group": "Vendors","pages": [- "user/vendors/invite-vendor",- "user/vendors/vendor-onboarding"+ "user/settings/marketplace",+ "user/vendors/vendor-onboarding-shopify",+ "user/vendors/vendor-onboarding-woocommerce",+ "user/vendors/vendor-onboarding-manual",+ "user/vendors/vendor-management",+ "user/vendors/commission-rates",+ "user/vendors/vendor-payouts",+ "user/vendors/multi-vendor-checkout"]},{diff --git a/docs/images/user/settings/marketplace/1-marketplace-overview.png b/docs/images/user/settings/marketplace/1-marketplace-overview.pngnew file mode 100644index 0000000000..0b92af1a5aBinary files /dev/null and b/docs/images/user/settings/marketplace/1-marketplace-overview.png differdiff --git a/docs/images/user/vendors/4.2.10VendorOnboarding-WooCommercePopup.png b/docs/images/user/vendors/4.2.10VendorOnboarding-WooCommercePopup.pngdeleted file mode 100644index ad366169fc..0000000000Binary files a/docs/images/user/vendors/4.2.10VendorOnboarding-WooCommercePopup.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.11VendorOnboarding-ApproveAccess.png b/docs/images/user/vendors/4.2.11VendorOnboarding-ApproveAccess.pngdeleted file mode 100644index 792c1c9cc4..0000000000Binary files a/docs/images/user/vendors/4.2.11VendorOnboarding-ApproveAccess.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.12VendorOnboarding-WooCommerceConnected.png b/docs/images/user/vendors/4.2.12VendorOnboarding-WooCommerceConnected.pngdeleted file mode 100644index fb3edcc6fe..0000000000Binary files a/docs/images/user/vendors/4.2.12VendorOnboarding-WooCommerceConnected.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.13VendorOnboarding-DashboardOnboarding.png b/docs/images/user/vendors/4.2.13VendorOnboarding-DashboardOnboarding.pngdeleted file mode 100644index b597a596e3..0000000000Binary files a/docs/images/user/vendors/4.2.13VendorOnboarding-DashboardOnboarding.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.14VendorOnboarding-StoreCreated.png b/docs/images/user/vendors/4.2.14VendorOnboarding-StoreCreated.pngdeleted file mode 100644index 1cc1759f56..0000000000Binary files a/docs/images/user/vendors/4.2.14VendorOnboarding-StoreCreated.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.15VendorOnboarding-Addproducts.png b/docs/images/user/vendors/4.2.15VendorOnboarding-Addproducts.pngdeleted file mode 100644index ba958b85cd..0000000000Binary files a/docs/images/user/vendors/4.2.15VendorOnboarding-Addproducts.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.16VendorOnboarding-AddBillingAddress.png b/docs/images/user/vendors/4.2.16VendorOnboarding-AddBillingAddress.pngdeleted file mode 100644index 4cb25c59a7..0000000000Binary files a/docs/images/user/vendors/4.2.16VendorOnboarding-AddBillingAddress.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.17VendorOnboarding-BillingAddressAdded.png b/docs/images/user/vendors/4.2.17VendorOnboarding-BillingAddressAdded.pngdeleted file mode 100644index 7d99fbbdec..0000000000Binary files a/docs/images/user/vendors/4.2.17VendorOnboarding-BillingAddressAdded.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.18VendorOnboarding-ConnectStripeAccount.png b/docs/images/user/vendors/4.2.18VendorOnboarding-ConnectStripeAccount.pngdeleted file mode 100644index f4c6cf27ce..0000000000Binary files a/docs/images/user/vendors/4.2.18VendorOnboarding-ConnectStripeAccount.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.19VendorOnboarding-StripeOnboardingComplete.png b/docs/images/user/vendors/4.2.19VendorOnboarding-StripeOnboardingComplete.pngdeleted file mode 100644index 40c5cac323..0000000000Binary files a/docs/images/user/vendors/4.2.19VendorOnboarding-StripeOnboardingComplete.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.1VendorOnboarding-EmailInvite.png b/docs/images/user/vendors/4.2.1VendorOnboarding-EmailInvite.pngdeleted file mode 100644index c9d0a5bfa6..0000000000Binary files a/docs/images/user/vendors/4.2.1VendorOnboarding-EmailInvite.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.20VendorOnboarding-CompleteStripeOnboarding.png b/docs/images/user/vendors/4.2.20VendorOnboarding-CompleteStripeOnboarding.pngdeleted file mode 100644index 842cd03152..0000000000Binary files a/docs/images/user/vendors/4.2.20VendorOnboarding-CompleteStripeOnboarding.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.21VendorOnboarding-ReturnAddress.png b/docs/images/user/vendors/4.2.21VendorOnboarding-ReturnAddress.pngdeleted file mode 100644index f2e6cefb2e..0000000000Binary files a/docs/images/user/vendors/4.2.21VendorOnboarding-ReturnAddress.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.22VendorOnboarding-ReturnAddressAdded.png b/docs/images/user/vendors/4.2.22VendorOnboarding-ReturnAddressAdded.pngdeleted file mode 100644index 14db63e7cb..0000000000Binary files a/docs/images/user/vendors/4.2.22VendorOnboarding-ReturnAddressAdded.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.23VendorOnboarding-SetShippingRates.png b/docs/images/user/vendors/4.2.23VendorOnboarding-SetShippingRates.pngdeleted file mode 100644index be404f8321..0000000000Binary files a/docs/images/user/vendors/4.2.23VendorOnboarding-SetShippingRates.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.24VendorOnboarding-ShippingMethods.png b/docs/images/user/vendors/4.2.24VendorOnboarding-ShippingMethods.pngdeleted file mode 100644index 4e9a734064..0000000000Binary files a/docs/images/user/vendors/4.2.24VendorOnboarding-ShippingMethods.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.25VendorOnboarding-ShippingRatesConfirmed.png b/docs/images/user/vendors/4.2.25VendorOnboarding-ShippingRatesConfirmed.pngdeleted file mode 100644index 55f9ef000d..0000000000Binary files a/docs/images/user/vendors/4.2.25VendorOnboarding-ShippingRatesConfirmed.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.26VendorOnboarding-ReturnsPolicy.png b/docs/images/user/vendors/4.2.26VendorOnboarding-ReturnsPolicy.pngdeleted file mode 100644index f3daca65e0..0000000000Binary files a/docs/images/user/vendors/4.2.26VendorOnboarding-ReturnsPolicy.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.27VendorOnboarding-ReturnsPolicyAdded.png b/docs/images/user/vendors/4.2.27VendorOnboarding-ReturnsPolicyAdded.pngdeleted file mode 100644index ebe562e8d1..0000000000Binary files a/docs/images/user/vendors/4.2.27VendorOnboarding-ReturnsPolicyAdded.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.2VendorOnboarding-AccountCreation.png b/docs/images/user/vendors/4.2.2VendorOnboarding-AccountCreation.pngdeleted file mode 100644index c8359755fe..0000000000Binary files a/docs/images/user/vendors/4.2.2VendorOnboarding-AccountCreation.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.3VendorOnboarding-CommercialTerms.png b/docs/images/user/vendors/4.2.3VendorOnboarding-CommercialTerms.pngdeleted file mode 100644index 5bb113781c..0000000000Binary files a/docs/images/user/vendors/4.2.3VendorOnboarding-CommercialTerms.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.4VendorOnboarding-VendorDashboard.png b/docs/images/user/vendors/4.2.4VendorOnboarding-VendorDashboard.pngdeleted file mode 100644index b3913597f8..0000000000Binary files a/docs/images/user/vendors/4.2.4VendorOnboarding-VendorDashboard.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.5VendorOnboarding-ConnectShop.png b/docs/images/user/vendors/4.2.5VendorOnboarding-ConnectShop.pngdeleted file mode 100644index cafa6cfacc..0000000000Binary files a/docs/images/user/vendors/4.2.5VendorOnboarding-ConnectShop.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.6VendorOnboarding-InstallApp.png b/docs/images/user/vendors/4.2.6VendorOnboarding-InstallApp.pngdeleted file mode 100644index bca577ca09..0000000000Binary files a/docs/images/user/vendors/4.2.6VendorOnboarding-InstallApp.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.7VendorOnboarding-SetupScreen.png b/docs/images/user/vendors/4.2.7VendorOnboarding-SetupScreen.pngdeleted file mode 100644index e13ee8e8ce..0000000000Binary files a/docs/images/user/vendors/4.2.7VendorOnboarding-SetupScreen.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.8VendorOnboarding-Synchronization.png b/docs/images/user/vendors/4.2.8VendorOnboarding-Synchronization.pngdeleted file mode 100644index 0693eb5e63..0000000000Binary files a/docs/images/user/vendors/4.2.8VendorOnboarding-Synchronization.png and /dev/null differdiff --git a/docs/images/user/vendors/4.2.9VendorOnboarding-StoreConnected.png b/docs/images/user/vendors/4.2.9VendorOnboarding-StoreConnected.pngdeleted file mode 100644index ca21519751..0000000000Binary files a/docs/images/user/vendors/4.2.9VendorOnboarding-StoreConnected.png and /dev/null differdiff --git a/docs/images/user/vendors/commission-rates/1-vendors-tab.png b/docs/images/user/vendors/commission-rates/1-vendors-tab.pngnew file mode 100644index 0000000000..2e4c499fdfBinary files /dev/null and b/docs/images/user/vendors/commission-rates/1-vendors-tab.png differdiff --git a/docs/images/user/vendors/commission-rates/2-vendor-commission-rate.png b/docs/images/user/vendors/commission-rates/2-vendor-commission-rate.pngnew file mode 100644index 0000000000..a46cb7f073Binary files /dev/null and b/docs/images/user/vendors/commission-rates/2-vendor-commission-rate.png differdiff --git a/docs/images/user/vendors/commission-rates/3-products-tab.png b/docs/images/user/vendors/commission-rates/3-products-tab.pngnew file mode 100644index 0000000000..8588c214d2Binary files /dev/null and b/docs/images/user/vendors/commission-rates/3-products-tab.png differdiff --git a/docs/images/user/vendors/commission-rates/4-platform-fee.png b/docs/images/user/vendors/commission-rates/4-platform-fee.pngnew file mode 100644index 0000000000..2db78a7bedBinary files /dev/null and b/docs/images/user/vendors/commission-rates/4-platform-fee.png differdiff --git a/docs/images/user/vendors/invite_vendor/1.invite_vendor.png b/docs/images/user/vendors/invite_vendor/1.invite_vendor.pngdeleted file mode 100644index 86c1f74998..0000000000Binary files a/docs/images/user/vendors/invite_vendor/1.invite_vendor.png and /dev/null differdiff --git a/docs/images/user/vendors/invite_vendor/2.click_invite.png b/docs/images/user/vendors/invite_vendor/2.click_invite.pngdeleted file mode 100644index 44eb2296bd..0000000000Binary files a/docs/images/user/vendors/invite_vendor/2.click_invite.png and /dev/null differdiff --git a/docs/images/user/vendors/invite_vendor/3.invite_sent.png b/docs/images/user/vendors/invite_vendor/3.invite_sent.pngdeleted file mode 100644index 7c96a989c7..0000000000Binary files a/docs/images/user/vendors/invite_vendor/3.invite_sent.png and /dev/null differdiff --git a/docs/images/user/vendors/invite_vendor/4.vendor_profile.png b/docs/images/user/vendors/invite_vendor/4.vendor_profile.pngdeleted file mode 100644index 806980c336..0000000000Binary files a/docs/images/user/vendors/invite_vendor/4.vendor_profile.png and /dev/null differdiff --git a/docs/images/user/vendors/invite_vendor/5.invitation_link.png b/docs/images/user/vendors/invite_vendor/5.invitation_link.pngdeleted file mode 100644index e7325ca64e..0000000000Binary files a/docs/images/user/vendors/invite_vendor/5.invitation_link.png and /dev/null differdiff --git a/docs/images/user/vendors/multi-vendor-checkout/1-multi-vendor-cart.png b/docs/images/user/vendors/multi-vendor-checkout/1-multi-vendor-cart.pngnew file mode 100644index 0000000000..aeddfc35e3Binary files /dev/null and b/docs/images/user/vendors/multi-vendor-checkout/1-multi-vendor-cart.png differdiff --git a/docs/images/user/vendors/multi-vendor-checkout/2-shipping-methods.png b/docs/images/user/vendors/multi-vendor-checkout/2-shipping-methods.pngnew file mode 100644index 0000000000..412aa877adBinary files /dev/null and b/docs/images/user/vendors/multi-vendor-checkout/2-shipping-methods.png differdiff --git a/docs/images/user/vendors/vendor-management/1-vendor-list.png b/docs/images/user/vendors/vendor-management/1-vendor-list.pngnew file mode 100644index 0000000000..898ebb3fa1Binary files /dev/null and b/docs/images/user/vendors/vendor-management/1-vendor-list.png differdiff --git a/docs/images/user/vendors/vendor-management/2-vendor-profile.png b/docs/images/user/vendors/vendor-management/2-vendor-profile.pngnew file mode 100644index 0000000000..502ba28050Binary files /dev/null and b/docs/images/user/vendors/vendor-management/2-vendor-profile.png differdiff --git a/docs/images/user/vendors/vendor-management/3-branding.png b/docs/images/user/vendors/vendor-management/3-branding.pngnew file mode 100644index 0000000000..e624ec2e64Binary files /dev/null and b/docs/images/user/vendors/vendor-management/3-branding.png differdiff --git a/docs/images/user/vendors/vendor-management/4-onboarding-progress.png b/docs/images/user/vendors/vendor-management/4-onboarding-progress.pngnew file mode 100644index 0000000000..9879f86025Binary files /dev/null and b/docs/images/user/vendors/vendor-management/4-onboarding-progress.png differdiff --git a/docs/images/user/vendors/vendor-management/5-account-information.png b/docs/images/user/vendors/vendor-management/5-account-information.pngnew file mode 100644index 0000000000..cc8d234d08Binary files /dev/null and b/docs/images/user/vendors/vendor-management/5-account-information.png differdiff --git a/docs/images/user/vendors/vendor-management/6-payments-payouts.png b/docs/images/user/vendors/vendor-management/6-payments-payouts.pngnew file mode 100644index 0000000000..bb503b03d0Binary files /dev/null and b/docs/images/user/vendors/vendor-management/6-payments-payouts.png differdiff --git a/docs/images/user/vendors/vendor-management/7-returns-billing.png b/docs/images/user/vendors/vendor-management/7-returns-billing.pngnew file mode 100644index 0000000000..a1d7793213Binary files /dev/null and b/docs/images/user/vendors/vendor-management/7-returns-billing.png differdiff --git a/docs/images/user/vendors/vendor-management/8-vendor-subtabs.png b/docs/images/user/vendors/vendor-management/8-vendor-subtabs.pngnew file mode 100644index 0000000000..cd4adcb057Binary files /dev/null and b/docs/images/user/vendors/vendor-management/8-vendor-subtabs.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/1-vendors-tab.png b/docs/images/user/vendors/vendor-onboarding-manual/1-vendors-tab.pngnew file mode 100644index 0000000000..66c42aa2d7Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/1-vendors-tab.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/10-returns-address.png b/docs/images/user/vendors/vendor-onboarding-manual/10-returns-address.pngnew file mode 100644index 0000000000..6cc9fab6c8Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/10-returns-address.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/11-shipping-rates.png b/docs/images/user/vendors/vendor-onboarding-manual/11-shipping-rates.pngnew file mode 100644index 0000000000..4c2b59c4ccBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/11-shipping-rates.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/12-returns-policy.png b/docs/images/user/vendors/vendor-onboarding-manual/12-returns-policy.pngnew file mode 100644index 0000000000..702afc5740Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/12-returns-policy.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/2-invite-vendor.png b/docs/images/user/vendors/vendor-onboarding-manual/2-invite-vendor.pngnew file mode 100644index 0000000000..d31df3228fBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/2-invite-vendor.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/3-invitation-sent.png b/docs/images/user/vendors/vendor-onboarding-manual/3-invitation-sent.pngnew file mode 100644index 0000000000..7e6d4f359aBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/3-invitation-sent.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/4-invitation-link.png b/docs/images/user/vendors/vendor-onboarding-manual/4-invitation-link.pngnew file mode 100644index 0000000000..10f14b7167Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/4-invitation-link.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/5-account-signup.png b/docs/images/user/vendors/vendor-onboarding-manual/5-account-signup.pngnew file mode 100644index 0000000000..2b43fe33baBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/5-account-signup.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/6-getting-started-tasks.png b/docs/images/user/vendors/vendor-onboarding-manual/6-getting-started-tasks.pngnew file mode 100644index 0000000000..57c522bd43Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/6-getting-started-tasks.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/7-connect-shop-options.png b/docs/images/user/vendors/vendor-onboarding-manual/7-connect-shop-options.pngnew file mode 100644index 0000000000..9c8732adecBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/7-connect-shop-options.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/8-billing-address.png b/docs/images/user/vendors/vendor-onboarding-manual/8-billing-address.pngnew file mode 100644index 0000000000..72929b7381Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/8-billing-address.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-manual/9-connect-stripe.png b/docs/images/user/vendors/vendor-onboarding-manual/9-connect-stripe.pngnew file mode 100644index 0000000000..f24cd42d84Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-manual/9-connect-stripe.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/1-create-version-form.png b/docs/images/user/vendors/vendor-onboarding-shopify/1-create-version-form.pngnew file mode 100644index 0000000000..1144f03cf6Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/1-create-version-form.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/10-vendor-account-creation.png b/docs/images/user/vendors/vendor-onboarding-shopify/10-vendor-account-creation.pngnew file mode 100644index 0000000000..df2de7d8a8Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/10-vendor-account-creation.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/11-getting-started-tasks.png b/docs/images/user/vendors/vendor-onboarding-shopify/11-getting-started-tasks.pngnew file mode 100644index 0000000000..0c3087be2dBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/11-getting-started-tasks.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/12-confirm-shipping-rates.png b/docs/images/user/vendors/vendor-onboarding-shopify/12-confirm-shipping-rates.pngnew file mode 100644index 0000000000..dd48eac95eBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/12-confirm-shipping-rates.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/13-connect-stripe.png b/docs/images/user/vendors/vendor-onboarding-shopify/13-connect-stripe.pngnew file mode 100644index 0000000000..0fbd595f20Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/13-connect-stripe.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/2-select-distribution-method.png b/docs/images/user/vendors/vendor-onboarding-shopify/2-select-distribution-method.pngnew file mode 100644index 0000000000..5838429e5eBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/2-select-distribution-method.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/3-custom-distribution.png b/docs/images/user/vendors/vendor-onboarding-shopify/3-custom-distribution.pngnew file mode 100644index 0000000000..a013ceb333Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/3-custom-distribution.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/4-install-link.png b/docs/images/user/vendors/vendor-onboarding-shopify/4-install-link.pngnew file mode 100644index 0000000000..4f6acc70fcBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/4-install-link.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/5-app-credentials.png b/docs/images/user/vendors/vendor-onboarding-shopify/5-app-credentials.pngnew file mode 100644index 0000000000..52feb49412Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/5-app-credentials.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/6-spree-shopify-apps.png b/docs/images/user/vendors/vendor-onboarding-shopify/6-spree-shopify-apps.pngnew file mode 100644index 0000000000..5acfa3ce6dBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/6-spree-shopify-apps.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/7-new-shopify-app-form.png b/docs/images/user/vendors/vendor-onboarding-shopify/7-new-shopify-app-form.pngnew file mode 100644index 0000000000..0f3d0ff9a8Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/7-new-shopify-app-form.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/8-vendor-store-select.png b/docs/images/user/vendors/vendor-onboarding-shopify/8-vendor-store-select.pngnew file mode 100644index 0000000000..393a23da73Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/8-vendor-store-select.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-shopify/9-vendor-accept-install.png b/docs/images/user/vendors/vendor-onboarding-shopify/9-vendor-accept-install.pngnew file mode 100644index 0000000000..7afa3d4d2aBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-shopify/9-vendor-accept-install.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/1-vendors-tab.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/1-vendors-tab.pngnew file mode 100644index 0000000000..66c42aa2d7Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/1-vendors-tab.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/10-billing-address.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/10-billing-address.pngnew file mode 100644index 0000000000..72929b7381Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/10-billing-address.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/11-connect-stripe.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/11-connect-stripe.pngnew file mode 100644index 0000000000..f24cd42d84Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/11-connect-stripe.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/12-returns-address.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/12-returns-address.pngnew file mode 100644index 0000000000..6cc9fab6c8Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/12-returns-address.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/13-shipping-rates.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/13-shipping-rates.pngnew file mode 100644index 0000000000..4c2b59c4ccBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/13-shipping-rates.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/14-returns-policy.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/14-returns-policy.pngnew file mode 100644index 0000000000..702afc5740Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/14-returns-policy.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/2-invite-vendor.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/2-invite-vendor.pngnew file mode 100644index 0000000000..3cc0c7b8beBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/2-invite-vendor.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/3-invitation-sent.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/3-invitation-sent.pngnew file mode 100644index 0000000000..155f87c220Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/3-invitation-sent.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/4-invitation-link.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/4-invitation-link.pngnew file mode 100644index 0000000000..133e76e601Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/4-invitation-link.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/5-account-signup.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/5-account-signup.pngnew file mode 100644index 0000000000..0f499af849Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/5-account-signup.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/6-getting-started-tasks.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/6-getting-started-tasks.pngnew file mode 100644index 0000000000..57c522bd43Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/6-getting-started-tasks.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/7-connect-shop-options.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/7-connect-shop-options.pngnew file mode 100644index 0000000000..9c8732adecBinary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/7-connect-shop-options.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/8-woocommerce-url.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/8-woocommerce-url.pngnew file mode 100644index 0000000000..c500dead36Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/8-woocommerce-url.png differdiff --git a/docs/images/user/vendors/vendor-onboarding-woocommerce/9-woocommerce-approve.png b/docs/images/user/vendors/vendor-onboarding-woocommerce/9-woocommerce-approve.pngnew file mode 100644index 0000000000..f4b76296f0Binary files /dev/null and b/docs/images/user/vendors/vendor-onboarding-woocommerce/9-woocommerce-approve.png differdiff --git a/docs/images/user/vendors/vendor-payouts/1-vendors-tab.png b/docs/images/user/vendors/vendor-payouts/1-vendors-tab.pngnew file mode 100644index 0000000000..4adfd69699Binary files /dev/null and b/docs/images/user/vendors/vendor-payouts/1-vendors-tab.png differdiff --git a/docs/images/user/vendors/vendor-payouts/2-payments-payouts.png b/docs/images/user/vendors/vendor-payouts/2-payments-payouts.pngnew file mode 100644index 0000000000..5ed9075200Binary files /dev/null and b/docs/images/user/vendors/vendor-payouts/2-payments-payouts.png differdiff --git a/docs/images/user/vendors/vendor_onboarding_products.png b/docs/images/user/vendors/vendor_onboarding_products.pngdeleted file mode 100644index ad551d0d3f..0000000000Binary files a/docs/images/user/vendors/vendor_onboarding_products.png and /dev/null differdiff --git a/docs/images/user/vendors/vendor_onboarding_shipping.png b/docs/images/user/vendors/vendor_onboarding_shipping.pngdeleted file mode 100644index d2e303ebc6..0000000000Binary files a/docs/images/user/vendors/vendor_onboarding_shipping.png and /dev/null differdiff --git a/docs/images/user/vendors/vendor_onboarding_signup.png b/docs/images/user/vendors/vendor_onboarding_signup.pngdeleted file mode 100644index 7384f60326..0000000000Binary files a/docs/images/user/vendors/vendor_onboarding_signup.png and /dev/null differdiff --git a/docs/images/user/vendors/vendor_onboarding_tasks.png b/docs/images/user/vendors/vendor_onboarding_tasks.pngdeleted file mode 100644index 688823d2fc..0000000000Binary files a/docs/images/user/vendors/vendor_onboarding_tasks.png and /dev/null differdiff --git a/docs/user/settings/marketplace.mdx b/docs/user/settings/marketplace.mdxnew file mode 100644index 0000000000..be0e139f07--- /dev/null+++ b/docs/user/settings/marketplace.mdx@@ -0,0 +1,53 @@+---+title: "Marketplace Configuration"+description: "Learn how to configure marketplace-wide settings for your multi-vendor marketplace in Spree Commerce."+---++<Warning>Marketplace settings are only available in Spree Enterprise Edition with the multi-vendor module enabled.</Warning>++The Marketplace settings page is the central place to configure how vendors operate on your marketplace by default. It's where you set the default commission rate new vendors will be invited under, how often vendors get paid, what merchants see when they install your Shopify app, and the terms of service every vendor agrees to. Most of these defaults can be overridden at a more granular level later (per vendor, category, or product), so think of this page as setting the baseline that everything else builds on.++To configure marketplace settings, navigate to **Settings → Marketplace** in the admin dashboard.++++## Vendor Commission Rate++This is the default percentage of each sale that your marketplace retains from a vendor's revenue. It applies to all newly invited vendors and can be overridden later per vendor, per category-vendor pairing, or per individual product.++- **Commission Rate** - the percentage taken from each sale. Used as the default for all newly invited vendors.++<Warning>Changing this value only affects newly invited vendors. Existing vendors keep their current commission rate — to update an existing vendor's rate, edit it from their vendor profile.</Warning>++## Vendor Payouts++This setting controls how frequently vendors can receive payouts through their Stripe dashboard. Vendors can choose to follow the marketplace default or set their own schedule from their vendor profile.++- **Preferred Vendor Payouts Schedule Interval** - how often vendors are paid by default.+ - Daily+ - Weekly+ - Bi-weekly+ - Monthly++<Note>Changing this option also updates the payout schedule for any existing vendors whose schedule is set to **Use marketplace default interval**. Vendors who have a specific schedule set won't be affected.</Note>++## Shopify App++If your marketplace uses the Shopify integration to onboard Shopify vendors, this image is displayed to Shopify merchants when they install your app. A clear, branded image helps vendors recognize the marketplace they're connecting to.++- **Upload New Media** - the image shown on the Shopify install screen.+ - **Recommended size:** 600 × 300 pixels.++<Note>For more on the broader Shopify vendor onboarding flow, see [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify).</Note>++## Vendor Terms of Service++The terms of service displayed to vendors when they accept their invitation to join the marketplace. Vendors must agree to these terms before they can complete onboarding. The editor supports rich formatting including headings, bold, italic, links, lists, quotes, and code blocks.++- **Vendor Terms of Service** - the full terms vendors must agree to at invitation time.++<Note>Updating the terms doesn't require existing vendors to re-accept — only vendors invited after the change will see the new version at sign-up.</Note>++## Saving Changes++After making any updates, click **Update** at the bottom of the page to save your changes, otherwise any changes you've made will not be saved.diff --git a/docs/user/vendors/commission-rates.mdx b/docs/user/vendors/commission-rates.mdxnew file mode 100644index 0000000000..824e0a7ad3--- /dev/null+++ b/docs/user/vendors/commission-rates.mdx@@ -0,0 +1,70 @@+---+title: "Commission Rates"+description: "Learn how to set and override commission rates across your multi-vendor marketplace in Spree Commerce."+---++<Warning>Multi-vendor capabilities are only available in Spree Enterprise Edition.</Warning>++Your commission rate is the percentage of each sale that your marketplace retains from a vendor's revenue — it's how the marketplace itself makes money, so getting it right matters. But "right" rarely means a single rate that fits every vendor and every product, which is why Spree lets you set commission rates at three different levels.++You can start with a single default rate for the whole marketplace, override it for specific vendors when you bring them on, and then fine-tune it even further at the individual product level. The most specific rule always wins, so you can layer overrides confidently without worrying about conflicts.++## 1. Default Marketplace Commission Rate++The default rate is the baseline that applies to every newly invited vendor unless overridden. It's configured under **Settings → Marketplace** and is the rate every other level falls back on.++See [<u>Marketplace Configuration</u>](https://spreecommerce.org/docs/user/settings/marketplace) for details on setting and updating the default.++<Note>Changing the default rate only applies to vendors invited after the change — existing vendors keep their current rate. To update an existing vendor, use one of the vendor-specific methods below.</Note>++## 2. Vendor-Specific Commission Rate++You can set a custom commission rate for individual vendors in two ways: during the invitation flow, or from the vendor's profile after they've been invited.++### When Inviting a Vendor++For WooCommerce and Manual/CSV vendors, the Invite Vendor form includes a **Commission Rate** field where you can set the rate at the same time you send the invitation. This is the easiest way to onboard a vendor on a custom rate from day one.++See [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce) or [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual) for the full invitation flow.++<Note>Shopify vendors don't go through the email invitation flow, so commission rates for Shopify vendors are set from the vendor profile after they've signed up. See the next section.</Note>++### From the Vendor Profile++For existing vendors (and for Shopify vendors), you can update the commission rate at any time from their vendor profile.++Navigate to **Vendors** in the admin dashboard and click on the vendor you'd like to update.++++Find the **Commission Rate** field on the vendor profile page and update it to the new percentage.++++Click **Update** at the bottom of the page to save your changes.++## 3. Product-Specific Commission Rate++For the most granular control, you can override the commission rate on individual products — useful when a vendor's catalog includes items with very different margins, or when you've struck a deal on a specific product with a vendor.++Navigate to **Products** in the admin dashboard and open the product you'd like to update.++++Scroll down to the **Platform Fee** section of the product editor and update the commission rate.++++Click **Update** at the bottom of the page to save your changes.++<Note>A product-specific commission rate overrides both the vendor-specific rate and the marketplace default for that product.</Note>++## Which Rate Applies?++When a sale is processed, Spree applies the most specific commission rate available, in the following order:++1. **Product-specific rate** — if set on the product, this wins.+2. **Vendor-specific rate** — if no product rate is set, the vendor's rate is used.+3. **Marketplace default rate** — if neither of the above is set, the default applies.++This means you can keep your overrides minimal — only set them where you genuinely need to deviate from the rate above.diff --git a/docs/user/vendors/invite-vendor.mdx b/docs/user/vendors/invite-vendor.mdxdeleted file mode 100644index ad27d6f164..0000000000--- a/docs/user/vendors/invite-vendor.mdx+++ /dev/null@@ -1,70 +0,0 @@-----title: "Invite a Vendor"-description: "In this Spree user doc, you'll learn how to invite a vendor to your multivendor marketplace."------<Warning>- The Vendors tab, and so the ability to invite vendors, is only available in Spree Enterprise Edition.-</Warning>--If you're running a marketplace, then the ability to invite vendors is an essential part of launching and scaling your platform.--By default, vendors must be invited to start selling on the marketplace. If you're interested in vendor self-signup, then please reach out to us directly.--## Navigate to Vendors Tab--To invite a vendor, navigate to the Vendors tab of the admin dashboard.----Here you would usually see a list of all the vendors that have been invited or are already onboarded to the marketplace, but for now it will be blank since you first need to invite some vendors.--## Click "Invite Vendor"--Click on "Invite Vendor" in the top right corner and a popup will appear.----You must fill in the following fields:--- **Company Name or Brand Name** - this is how the vendor will be displayed in the admin dashboard (if they onboard using Shopify, may be overwritten)-- **Contact Person Email** - preferably the work email address of the person who should receive the invitation-- **Commission Rate** - the pre-agreed commission rate to be shared with the marketplace--<Note>- The commission rate can be different for each vendor and also updated at a later time.-</Note>--## Send Invitation--Double check that you've added all of the information correctly, and then click "Send Invitation".--The newly invited vendor will now be added to your list of vendors.----The vendor will receive an email invitation to the specified email address where they can begin the self-service onboarding process.--### Alternative Method--If, for some reason, the vendor didn't receive the email, or they prefer to use a different channel of communication, you can send them a copy of the invitation link instead.--To do so, click on the vendor to open up their vendor profile.----Navigate to the "Invitations" subtab, click the three dots and select "Copy invitation link" from the dropdown menu.----### Cancel Invitation--If, for whatever reason, you decide to terminate your partnership with the vendor before they start the onboarding process, you can cancel their invitation to block their access to the platform.--Simply navigate to the "Invitations" subtab as shown previously, click the three dots and select "Delete" from the dropdown menu.--## Next Steps--Now that the invitation has been sent, you can sit back and relax while the vendor completes the guided, self-service onboarding process.--If you'd like to see what the vendor onboarding process looks like, or if a vendor is asking for onboarding support, please refer to the Vendor Onboarding support article.\ No newline at end of filediff --git a/docs/user/vendors/multi-vendor-checkout.mdx b/docs/user/vendors/multi-vendor-checkout.mdxnew file mode 100644index 0000000000..45cd7ea3b2--- /dev/null+++ b/docs/user/vendors/multi-vendor-checkout.mdx@@ -0,0 +1,56 @@+---+title: "Multi-Vendor Checkout"+description: "Learn how multi-vendor checkout works in Spree Commerce — customers shop across multiple vendors in a single cart and complete one unified checkout."+---++<Warning>Multi-vendor capabilities are only available in Spree Enterprise Edition.</Warning>++One of the biggest UX challenges in running a multi-vendor marketplace is the cart and checkout flow. Many marketplaces force customers to check out separately for each vendor — adding friction, hurting conversion rates, and frustrating shoppers who just want to buy what's in their cart and move on. Spree Commerce solves this with native multi-vendor checkout: customers can fill a single cart with products from any number of vendors, pick the shipping method they want for each vendor's package, pay once, and receive separate tracking updates as each vendor fulfills their part of the order.++Best of all, there's nothing to configure. Multi-vendor checkout is supported out of the box with the Spree Next.js Storefront starter — as long as your marketplace is running on the multi-vendor module and the Next.js storefront, customers will get the full multi-vendor checkout experience automatically.++## How It Works++### Adding Items from Multiple Vendors++Customers shop across all vendor catalogs as one experience. Products from different vendors are added to a single shared cart — to the customer, it feels like shopping any normal online store.++++### Selecting Shipping Methods at Checkout++At checkout, customers are shown the shipping methods available for each vendor's package separately, grouped by vendor. They select one shipping method per vendor and continue without needing to leave the checkout flow.++++This is where Spree's multi-vendor checkout really shines: shoppers retain full control over how each shipment is fulfilled (express, standard, pickup, etc.) without juggling multiple separate checkouts.++### Completing Payment++The customer pays once for the full order, with all vendor totals consolidated into a single transaction. Behind the scenes, Spree records the order as a single customer purchase but prepares it to be split into separate suborders for downstream processing.++## What Happens After Checkout++Once the order is placed, Spree automatically splits it into suborders — one per vendor involved in the order. Each suborder is then routed to where the vendor will actually fulfill it:++- **Manual/CSV vendors** see their suborder in their Spree vendor dashboard.+- **Shopify vendors** see their suborder in their Shopify admin (in addition to their Spree vendor dashboard), thanks to the marketplace's Shopify sales channel app.+- **WooCommerce vendors** see their suborder in their WooCommerce admin (in addition to their Spree vendor dashboard), via the WooCommerce integration.++This means each vendor handles the part of the order that belongs to them in the environment they're most comfortable with — without ever needing to see or coordinate with other vendors involved in the same customer purchase.++## Fulfillment and Tracking++Each vendor ships their portion of the order independently — using their own carriers, packaging, and timelines. As each vendor marks their package as fulfilled in their dashboard, the customer receives a separate tracking email for that specific shipment.++A customer who ordered from three vendors will receive three independent tracking notifications as each package ships, with no risk of confusion between them. From the marketplace's perspective, all of this happens automatically — no manual coordination is required between vendors, the marketplace owner, or the customer.++## Next Steps++For more on how vendors fulfill orders from their own dashboards, see the relevant onboarding guide:++- [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify)+- [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce)+- [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual)++For marketplace-wide configuration that affects checkout (including commission rates and payout schedules), see [<u>Marketplace Configuration</u>](https://spreecommerce.org/docs/user/settings/marketplace).diff --git a/docs/user/vendors/vendor-management.mdx b/docs/user/vendors/vendor-management.mdxnew file mode 100644index 0000000000..f86b613622--- /dev/null+++ b/docs/user/vendors/vendor-management.mdx@@ -0,0 +1,147 @@+---+title: "Vendor Management"+description: "Learn how to view, manage, and configure vendors from the admin dashboard in Spree Commerce."+---++<Warning>Multi-vendor capabilities are only available in Spree Enterprise Edition.</Warning>++Running a marketplace means juggling relationships with potentially dozens or hundreds of vendors — each at a different stage of onboarding, with their own product catalogs, revenue trajectories, and operational needs. The Vendors tab is mission control for all of it.++From a single page, you can see the status of every vendor, dig into any individual vendor's full profile to manage their branding, commission rate, payout schedule, and storefront policies, and review their products, orders, and team in detail. Whether you're approving a new vendor that just finished onboarding, troubleshooting one that's stuck, or pulling lifetime revenue figures for a top performer, this is where it all happens.++To get started, navigate to **Vendors** in the admin dashboard.++## Vendor List Overview++The main table displays every vendor on your marketplace alongside key metrics and status indicators.++++The default columns are:++- **Name** - the vendor's brand or company name.+- **Status** - the current state of the vendor relationship:+ - **Invited** - invitation sent, not yet accepted.+ - **Onboarding** - vendor is working through onboarding tasks.+ - **Ready for Review** - vendor has completed onboarding and is awaiting your approval.+ - **Approved** - vendor is live and selling on the marketplace.+ - **Rejected** - vendor was not approved during review.+ - **Suspended** - vendor's access has been temporarily revoked.+- **Onboarding Progress** - a count of completed onboarding tasks (e.g., 4/6).+- **Integration** - the vendor's connection type:+ - **Shopify**+ - **WooCommerce**+ - **N/A** (Manual/CSV vendors)+- **Products** - total number of products in the vendor's catalog.+- **Revenue** - lifetime sales generated by the vendor.+- **Commission** - lifetime commission your marketplace has earned from the vendor.+- **Created At** - when the vendor was first invited.++From this view you can apply filters, sort by any column, customize the visible columns, and export the data by clicking **Export** in the top right corner.++## Managing a Vendor++To manage a specific vendor, click their row in the table to open their full vendor profile.++++From the vendor profile you can view and configure the sections below.++### Branding++++Click **Edit** at the top of the profile to open the branding panel. You can configure:++- **About** - a short description of the vendor.+- **Logo** - the vendor's primary logo (rectangular formats supported).+- **Square Logo** - recommended for avatars and compact display areas.+- **Cover Photo** - a wider banner image, similar to a Facebook cover photo.++These assets may be displayed on the vendor's storefront pages and within their vendor dashboard.++### Onboarding Progress++++A detailed breakdown of which onboarding tasks the vendor has and hasn't completed.++This helps you:++- Identify blockers that are holding a vendor up.+- Follow up with vendors who are stuck mid-flow.+- Approve vendors once they've met all the requirements.++For a walkthrough of what vendors see during onboarding, see [<u>Shopify</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify), [<u>WooCommerce</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce), or [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual).++### Account Information++++A quick snapshot of vendor performance and financial terms:++- **Commission Rate** - the rate currently applied to this vendor. Click the pencil icon to update.+- **Number of Products** - total products in the vendor's catalog.+- **Total Sales** - lifetime sales generated by the vendor.+- **Country / Location** - the vendor's registered country.++For more on how commission rates work across the marketplace, see [<u>Commission Rates</u>](https://spreecommerce.org/docs/user/vendors/commission-rates).++### Payments & Payouts++++If the vendor is using Stripe Connect, you can manage their payout setup here:++- **Stripe Account ID** - copy the vendor's Stripe Account ID for reference or support purposes.+- **Payout Schedule** - how often the vendor receives payouts. Options:+ - **Daily**+ - **Weekly**+ - **Bi-weekly**+ - **Monthly**+ - **Use Marketplace Default Interval**++<Warning>Stripe Connect is only available in Spree Enterprise Edition. If your marketplace uses a different payment provider, payout schedule controls won't be available here.</Warning>++For more on configuring payout schedules across the marketplace, see [<u>Vendor Payouts</u>](https://spreecommerce.org/docs/user/vendors/vendor-payouts).++### Returns & Billing Address++++These sections display the vendor's registered returns and billing addresses. Both are view-only — vendors update their own addresses from their vendor dashboard.++## Vendor Subtabs++Similar to customer profiles, the vendor profile includes several subtabs for deeper management of the vendor's activity.++++### Overview++A sales-over-time graph and a list of the vendor's top-performing products — useful for a quick performance read at any point.++### Products++Every product associated with the vendor. From here you can apply filters, sort results, perform bulk actions, and review product-level performance.++### Orders++Every order placed with the vendor. You can filter orders, review payment and shipment states, and monitor fulfillment activity.++### Users++All vendor users associated with the account — that is, users who have accepted invitations and now have access to the vendor dashboard. Useful for tracking who on the vendor's team has access.++### Invitations++All invitations sent to vendor users. From this tab you can see invitation status, copy pending invite links, and monitor which users haven't yet joined.++### Policies++The vendor's policies, including:++- **Returns Policy** (default)+- Any other policies you require from the vendor++Admins can edit these policies directly from this section.diff --git a/docs/user/vendors/vendor-onboarding-manual.mdx b/docs/user/vendors/vendor-onboarding-manual.mdxnew file mode 100644index 0000000000..0dc9959f2f--- /dev/null+++ b/docs/user/vendors/vendor-onboarding-manual.mdx@@ -0,0 +1,158 @@+---+title: "Manual/CSV Vendor Onboarding"+description: "Learn how to invite and onboard a vendor who'll upload products manually or via CSV to your multi-vendor marketplace in Spree Commerce."+---++<Warning>Multi-vendor capabilities are only available in Spree Enterprise Edition.</Warning>++<Note>This guide covers vendors who'll add products manually through the vendor dashboard or import them via CSV. For other vendor types, see [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify) and [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce).</Note>++Not every vendor will be running on Shopify or WooCommerce. Some don't yet have an online store at all, some use platforms without a direct Spree integration, and some simply prefer to manage their marketplace catalog independently. For all of these cases, the Manual/CSV onboarding path is the catch-all — it works with any vendor regardless of their backend setup.++Onboarding a Manual/CSV vendor has two distinct parts: an **Admin Setup** that the marketplace owner completes by sending an invitation, and a **Vendor Onboarding** flow that the vendor themselves completes after receiving the invite.++## Prerequisites++Before you can onboard Manual/CSV vendors, you'll need:++- The **`spree_multi_vendor` Enterprise gem** installed on your Spree instance.++---++## Admin Setup++This section is for the marketplace owner. Inviting a Manual/CSV vendor uses the same invitation flow as WooCommerce vendors — the vendor selects their preferred method (manual or CSV) during their own onboarding.++### Send the Invitation++To invite a vendor, navigate to **Vendors** in the admin dashboard.++++Click **Invite Vendor** in the top right corner to open the invitation form.++++Fill in the following fields:++- **Company Name or Brand Name** - how the vendor will be displayed in the admin dashboard.+- **Contact Person Email** - the work email address of the person who should receive the invitation.+- **Commission Rate** - the pre-agreed commission rate to be shared with the marketplace.++<Note>The commission rate can be different for each vendor and updated later from the vendor's profile.</Note>++Double-check the details and click **Send Invitation**. The newly invited vendor will appear in your list of vendors with a pending status.++++The vendor will receive an email at the specified address with a link to begin onboarding.++### Share the Invitation Link Manually++If the vendor doesn't receive the email, or they prefer a different communication channel, you can copy the invitation link and send it directly.++Click on the vendor in the list to open their vendor profile, navigate to the **Invitations** subtab, click the three-dot menu, and select **Copy invitation link**.++++### Cancel an Invitation++If you need to withdraw the invitation — whether the wrong contact was invited, the vendor's details need correcting, or the partnership ended before they began onboarding — navigate to the **Invitations** subtab as above, click the three-dot menu, and select **Delete**.++<Warning>Cancelling an invitation is irreversible. To re-invite the vendor later, you'll need to start the invitation flow from scratch.</Warning>++---++## Vendor Onboarding++This section is for the vendor. Once you've received the invitation from the marketplace owner, follow these steps to set up your vendor account and start adding products.++### 1. Accept the Invitation++You'll receive an email invitation from the marketplace owner with a link to get started. Click the link to be directed to your vendor account creation page.++### 2. Create Your Vendor Account++Fill in the sign-up form to create your vendor account, then click **Create Account**.++++You'll then be redirected to your new vendor dashboard, where you'll see a **Getting Started** checklist of onboarding tasks.++++### 3. Set Up Your Shop++Click on the **Connect or Create a Shop** task in the checklist, then click **Use CSV and/or Admin dashboard**.++++The task will be marked complete and you'll be ready to start adding products.++### 4. Add Your Products++Unlike vendors who connect Shopify or WooCommerce, you'll need to add products to your marketplace catalog yourself. You have two options:++- **Add products manually, one-by-one** — best for small catalogs or when you're testing things out. See [<u>Create a Product</u>](https://spreecommerce.org/docs/user/products/creating-products) for the full walkthrough of the product editor.+- **Upload products in bulk via CSV** — best for larger catalogs or when migrating from another platform. See [<u>Import Products</u>](https://spreecommerce.org/docs/user/manage-products/import-products) for a step-by-step guide to preparing and uploading your CSV file.++You can mix and match these methods as needed — for example, bulk-importing the initial catalog and then adding new products manually as they're released.++### 5. Complete Your Remaining Onboarding Tasks++With your shop set up, you'll still need to complete a few more tasks before you can start selling.++#### Add Billing Address++Your company's billing address is needed for vendor payouts and invoices. Click on the task in your checklist, fill in the form, and click **Save**.++++#### Connect Your Stripe Account++Stripe is used by the marketplace to process payments and send your payouts. To receive your earnings, you'll need to connect a Stripe account.++1. Click on **Connect Stripe Account** in your onboarding checklist.+2. Click **Connect your bank account** to be guided through Stripe's short onboarding process.+3. Follow the Stripe prompts to set up a new account or connect an existing one.++++An existing Stripe account isn't required — you can create one as part of this flow. The whole process usually takes around five minutes. Once connected, you'll receive payouts whenever you ship orders.++<Note>If you're not the one handling your company's financials, you can invite another team member to complete this step instead.</Note>++<Warning>Some marketplaces use payment providers other than Stripe. If that's the case, you'll be prompted to connect your bank account through a different flow — your marketplace owner will let you know the specifics.</Warning>++#### Add Returns Address++A returns address ensures customers know where to send returns. Click on the task in your checklist, enter your company's return address, and click **Save**.++++#### Set Shipping Rates++Since you're not connecting an external store, you'll need to add your shipping methods and rates manually.++Click on the **Set Shipping Rates** task, then click **Manage Shipping Rates** to be taken to the **Settings → Shipping** section of your vendor dashboard. Add each shipping method you'd like to offer along with its rate, then click **Confirm Shipping Rates** in the top right corner.++++<Note>You can edit existing shipping methods or add new ones at any time after onboarding is complete.</Note>++#### Add Policies++A clear returns policy builds customer trust, sets clear expectations, and helps prevent disputes over returns and refunds.++1. Click on **Add Policies** to be redirected to **Settings → Policies**.+2. Click on the policy you'd like to update to enter the editor.+3. Paste your policy into the text field.+4. Click **Save**.++++## Next Steps++Once onboarding is complete, your products will be sent to the marketplace owner for review. Once they're approved, they'll go live on the storefront, and you can manage your business directly from your Spree vendor dashboard.++For other vendor types, see [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify) or [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce).diff --git a/docs/user/vendors/vendor-onboarding-shopify.mdx b/docs/user/vendors/vendor-onboarding-shopify.mdxnew file mode 100644index 0000000000..dbdbfab3de--- /dev/null+++ b/docs/user/vendors/vendor-onboarding-shopify.mdx@@ -0,0 +1,199 @@+---+title: "Shopify Vendor Onboarding"+description: "Learn how to invite and onboard a Shopify-based vendor to your multi-vendor marketplace in Spree Commerce."+---++<Warning>Shopify vendor onboarding is only available in Spree Enterprise Edition.</Warning>++<Note>This guide covers vendors who'll connect their Shopify store to your marketplace. For other vendor types, see [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce) and [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual).</Note>++Shopify is one of the most common platforms your prospective vendors will already be running on, so it's worth setting up a smooth, automated path for them to join your marketplace. With the right setup in place, a Shopify vendor can connect their store in just a few clicks — products, inventory, orders, and shipping all sync between Shopify and your marketplace automatically.++Onboarding a Shopify vendor has two distinct parts: a one-time **Admin Setup** that the marketplace owner completes per vendor in their Shopify Partners account and Spree admin, and a much shorter **Vendor Onboarding** flow that the vendor themselves completes after receiving the install link.++## Prerequisites++Before you can onboard Shopify vendors, you'll need:++- A **Shopify Partners account** — this is where you'll create the custom Shopify apps used to connect each vendor's store.+- The **`spree_multi_vendor` Enterprise gem** installed on your Spree instance.++---++## Admin Setup++This section is for the marketplace owner. It's a one-time setup per vendor — once complete, the vendor only needs to install the app and complete a few onboarding tasks.++### 1. Create the Shopify App++Each Shopify vendor requires their own dedicated app, created from your Shopify Partners account.++1. Sign in to your **Shopify Partners** account and open the **Dev Dashboard**.+2. Click **Create app**.+3. Give the app a name that identifies which vendor it's for. We recommend writing the name in kebab-case (lowercase words separated by hyphens), e.g., `example-vendor`.+4. You'll be redirected to the **Versions → Create version** page. Fill in the form using the values below:++ - **App name** - already pre-filled from the previous step.+ - **App URL** - `<app-base-url>/shopify/apps/<app-handle>` (e.g., `https://spree-marketplace.com/shopify/apps/example-vendor`).+ - The `<app-handle>` can be set arbitrarily but must be unique across all your Shopify apps. We recommend using the app name from step 3 (already in kebab-case).+ - **Embed app in Shopify admin** - leave unchecked.+ - **Preferences URL** - leave empty.+ - **Webhooks API Version** - `2025-07`.+ - **Scopes** - paste the following list exactly:+ ```+ write_orders,read_inventory,read_products,read_fulfillments,read_locations,read_translations,read_locales,read_shipping+ ```+ - **Optional scopes** - leave empty.+ - **Use legacy install flow** - leave unchecked.+ - **Redirect URLs** - add both of the following:+ - `<app-base-url>/shopify/apps/<app-handle>/auth`+ - `<app-base-url>/shopify/apps/<app-handle>/auth_callback`++5. Click **Release** at the bottom of the form, then confirm in the modal that appears.++After completing these steps, you should see an overview of the version you just released.++++### 2. Get the App's Credentials++Spree needs the app's Client ID and Secret to authenticate against Shopify.++1. In the **Shopify Dev Dashboard**, select the app you just created.+2. Open the app's **Settings** page.+3. Copy and save both the **Client ID** and the **Secret**.++++### 3. Register the App in Spree++Now register the new Shopify app inside your Spree admin so the marketplace can communicate with it.++1. In the Spree admin dashboard, navigate to **Settings → Shopify Apps**.++++2. Click **New Shopify App** in the top right corner.+3. Fill in the form and click **Create**:+ - **Handle** - must match the `<app-handle>` you used in step 1 (e.g., `example-vendor`).+ - **Name** - can be anything, but we recommend matching the handle for consistency.+ - **Client ID** - paste the Client ID from step 2.+ - **Secret** - paste the Secret from step 2.++++### 4. Generate the Install Link++With the app created and connected to Spree, the next step is to generate the install link the vendor will use to connect their store.++1. From the app's **Overview** page in the **Shopify Partner dashboard**, click **Select distribution method**.++++2. Choose **Custom Distribution** and click **Select**. Confirm in the modal.++++3. Fill in the Distribution form:+ - **Store domain** - the vendor's Shopify store domain, formatted as either `<shopify-domain>.myshopify.com` or `admin.shopify.com/store/<shopify-domain>` (e.g., `admin.shopify.com/store/jessicas-gym`).+ - **Allow multi-store install for one Plus organization** - check this option.+4. Click **Generate link** and confirm in the modal.+5. Copy the **install link** and save it — you'll send this to the vendor in step 5.++++### 5. Share the Install Link with the Vendor++Send the install link you saved in step 4 to the vendor through any communication channel — email, Slack, or whatever you normally use. From here, the rest of the flow is on the vendor — see the **Vendor Onboarding** section below for what they'll experience.++<Note>Vendor accounts are matched by the Shopify store owner's email address. If you're connecting multiple Shopify stores that share an owner email, each store will need a unique email set under **Shopify Store Settings → General → Store details**.</Note>++<Warning>If you're testing the flow yourself, make sure you're signed out of the marketplace owner account before opening the install link — otherwise installation will fail. If that happens, simply open the install link again.</Warning>++---++## Vendor Onboarding++This section is for the vendor. Once you've received the install link from the marketplace owner, follow these steps to connect your Shopify store and complete your onboarding.++### 1. Install the Shopify App++1. Open the install link the marketplace owner sent you.+2. Log in to Shopify and select the store you'll be connecting to the marketplace.++++3. Accept the app installation.++++### 2. Create Your Vendor Account++After accepting the installation, you'll be redirected to a Spree onboarding screen and asked to create a vendor account.++++Fill in the form and submit. A few minutes after submitting, your Shopify products will start appearing in your Spree vendor dashboard.++### 3. Complete Your Onboarding Tasks++When you arrive at your vendor dashboard, you'll see a **Getting Started** checklist. Most tasks are auto-completed for Shopify vendors thanks to the integration, but a few still need your attention.++++#### Auto-Completed Tasks++The following tasks are marked complete automatically when you install the app — just verify the imported information is correct:++- **Connect or Create a Shop** — completed by the app installation itself.+- **Add Billing Address** — imported from your Shopify store's billing details.+- **Add Returns Address** — imported from your Shopify store's address.+- **Add Returns Policy** — imported from your Shopify store, provided you have a returns policy configured there.++#### Confirm Shipping Rates++Your Shopify shipping methods and rates are synced automatically, but you still need to confirm them to mark this task complete.++Navigate to **Settings → Shipping** in your vendor dashboard and click **Confirm Shipping Rates** in the top right corner.++++<Note>You can edit existing shipping methods or add new ones at any time after onboarding is complete.</Note>++#### Connect Your Stripe Account++Stripe is used by the marketplace to process payments and send your payouts. To receive your earnings, you'll need to connect a Stripe account.++1. Click on **Connect Stripe Account** in your onboarding checklist.+2. Click **Connect your bank account** to be guided through Stripe's short onboarding process.+3. Follow the Stripe prompts to set up a new account or connect an existing one.++++An existing Stripe account isn't required — you can create one as part of this flow. The whole process usually takes around five minutes. Once connected, you'll receive payouts whenever you ship orders.++<Note>If you're not the one handling your company's financials, you can invite another team member to complete this step instead.</Note>++<Warning>Some marketplaces use payment providers other than Stripe. If that's the case, you'll be prompted to connect your bank account through a different flow — your marketplace owner will let you know the specifics.</Warning>++---++## What Syncs Between Shopify and the Marketplace++Once your Shopify store is connected, the following data syncs automatically:++- **Active products** are imported into the marketplace catalog.+- **Inventory levels** sync in both directions in real-time.+- **Shipping methods and rates** sync from Shopify to the marketplace.+- **Orders** placed on the marketplace appear in your Shopify dashboard for fulfillment, just like normal Shopify orders.+- **Fulfillment status and shipment tracking** sync back to the marketplace and trigger customer notifications automatically.+- **Price updates** made in Shopify sync to the marketplace.+- **Content updates** (descriptions, images) sync to the marketplace, unless the marketplace owner has edited them.++<Note>You can choose which products to list on the marketplace by adding or removing the marketplace sales channel on each product in your Shopify admin.</Note>++## Next Steps++Once onboarding is complete, your products will be sent to the marketplace owner for review. Once they're approved, they'll go live on the storefront, and you can manage your business primarily from your Shopify dashboard.++For other vendor types, see [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce) or [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual).diff --git a/docs/user/vendors/vendor-onboarding-woocommerce.mdx b/docs/user/vendors/vendor-onboarding-woocommerce.mdxnew file mode 100644index 0000000000..57f6e5ace1--- /dev/null+++ b/docs/user/vendors/vendor-onboarding-woocommerce.mdx@@ -0,0 +1,173 @@+---+title: "WooCommerce Vendor Onboarding"+description: "Learn how to invite and onboard a WooCommerce-based vendor to your multi-vendor marketplace in Spree Commerce."+---++<Warning>WooCommerce vendor onboarding is only available in Spree Enterprise Edition.</Warning>++<Note>This guide covers vendors who'll connect their WooCommerce store to your marketplace. For other vendor types, see [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify) and [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual).</Note>++WooCommerce is one of the most widely used ecommerce platforms in the world, so it's worth making it easy for WooCommerce-based vendors to join your marketplace. Once connected, a vendor's products, inventory, orders, and shipping flow automatically between their WooCommerce store and your marketplace — no manual reconciliation required.++Onboarding a WooCommerce vendor has two distinct parts: an **Admin Setup** that the marketplace owner completes by sending an invitation, and a **Vendor Onboarding** flow that the vendor themselves completes after receiving the invite.++## Prerequisites++Before you can onboard WooCommerce vendors, you'll need:++- The **`spree_multi_vendor` Enterprise gem** installed on your Spree instance.++---++## Admin Setup++This section is for the marketplace owner. Inviting a WooCommerce vendor uses the same invitation flow as Manual/CSV vendors — the vendor chooses WooCommerce as their connection method during their own onboarding.++### Send the Invitation++To invite a vendor, navigate to **Vendors** in the admin dashboard.++++Click **Invite Vendor** in the top right corner to open the invitation form.++++Fill in the following fields:++- **Company Name or Brand Name** - how the vendor will be displayed in the admin dashboard.+- **Contact Person Email** - the work email address of the person who should receive the invitation.+- **Commission Rate** - the pre-agreed commission rate to be shared with the marketplace.++<Note>The commission rate can be different for each vendor and updated later from the vendor's profile.</Note>++Double-check the details and click **Send Invitation**. The newly invited vendor will appear in your list of vendors with a pending status.++++The vendor will receive an email at the specified address with a link to begin onboarding.++### Share the Invitation Link Manually++If the vendor doesn't receive the email, or they prefer a different communication channel, you can copy the invitation link and send it directly.++Click on the vendor in the list to open their vendor profile, navigate to the **Invitations** subtab, click the three-dot menu, and select **Copy invitation link**.++++### Cancel an Invitation++If you need to withdraw the invitation — whether the wrong contact was invited, the vendor's details need correcting, or the partnership ended before they began onboarding — navigate to the **Invitations** subtab as above, click the three-dot menu, and select **Delete**.++<Warning>Cancelling an invitation is irreversible. To re-invite the vendor later, you'll need to start the invitation flow from scratch.</Warning>++---++## Vendor Onboarding++This section is for the vendor. Once you've received the invitation from the marketplace owner, follow these steps to connect your WooCommerce store and complete your onboarding.++### 1. Accept the Invitation++You'll receive an email invitation from the marketplace owner with a link to get started. Click the link to be directed to your vendor account creation page.++### 2. Create Your Vendor Account++Fill in the sign-up form to create your vendor account, then click **Create Account**.++++You'll then be redirected to your new vendor dashboard, where you'll see a **Getting Started** checklist of onboarding tasks.++++### 3. Connect Your WooCommerce Store++Click on the **Connect or Create a Shop** task in the checklist, then click **WooCommerce**.++++A popup will appear asking for your WooCommerce store's URL.++++Enter your store URL and click **Continue**. You'll be redirected to a page asking you to approve the marketplace's connection to your store.++++Click **Approve**. You'll be redirected back to your vendor dashboard, and the task will be marked complete.++A few minutes after connecting, your WooCommerce products will start appearing in your Spree vendor dashboard.++### 4. Complete Your Remaining Onboarding Tasks++With your store connected, you'll still need to complete a few more tasks before you can start selling.++#### Add Billing Address++Your company's billing address is needed for vendor payouts and invoices. Click on the task in your checklist, fill in the form, and click **Save**.++++#### Connect Your Stripe Account++Stripe is used by the marketplace to process payments and send your payouts. To receive your earnings, you'll need to connect a Stripe account.++1. Click on **Connect Stripe Account** in your onboarding checklist.+2. Click **Connect your bank account** to be guided through Stripe's short onboarding process.+3. Follow the Stripe prompts to set up a new account or connect an existing one.++++An existing Stripe account isn't required — you can create one as part of this flow. The whole process usually takes around five minutes. Once connected, you'll receive payouts whenever you ship orders.++<Note>If you're not the one handling your company's financials, you can invite another team member to complete this step instead.</Note>++<Warning>Some marketplaces use payment providers other than Stripe. If that's the case, you'll be prompted to connect your bank account through a different flow — your marketplace owner will let you know the specifics.</Warning>++#### Add Returns Address++A returns address ensures customers know where to send returns. Click on the task in your checklist, enter your company's return address, and click **Save**.++++#### Set Shipping Rates++Your WooCommerce shipping methods are synced to the marketplace automatically, but rates aren't — you'll need to set them manually.++Click on the **Set Shipping Rates** task, then click **Manage Shipping Rates** to be taken to the **Settings → Shipping** section of your vendor dashboard. Set the rate for each shipping method, then click **Confirm Shipping Rates** in the top right corner.++++<Note>You can edit existing shipping methods or add new ones at any time after onboarding is complete.</Note>++#### Add Policies++Clear policies build customer trust, sets clear expectations, and helps prevent disputes over shipping, returns and refunds.++1. Click on **Add Policies** in your onboarding checklist to be redirected to **Settings → Policies**.+2. Click on the policy you like to update.+3. Add content to the field in the policy editor.+4. Click **Save**.++++---++## What Syncs Between WooCommerce and the Marketplace++Once your WooCommerce store is connected, the following data syncs automatically:++- **Active products** are imported into the marketplace catalog.+- **Inventory levels** sync in both directions in real-time.+- **Shipping methods** sync from WooCommerce to the marketplace — note that **rates do not sync** and must be set manually in your vendor dashboard.+- **Orders** placed on the marketplace appear in your WooCommerce dashboard for fulfillment, just like normal WooCommerce orders.+- **Fulfillment status and shipment tracking** sync back to the marketplace and trigger customer notifications automatically.+- **Price updates** made in WooCommerce sync to the marketplace.+- **Content updates** (descriptions, images) sync to the marketplace, unless the marketplace owner has edited them.++## Next Steps++Once onboarding is complete, your products will be sent to the marketplace owner for review. Once they're approved, they'll go live on the storefront, and you can manage your business primarily from your WooCommerce dashboard.++For other vendor types, see [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify) or [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual).diff --git a/docs/user/vendors/vendor-onboarding.mdx b/docs/user/vendors/vendor-onboarding.mdxdeleted file mode 100644index 0c4a552025..0000000000--- a/docs/user/vendors/vendor-onboarding.mdx+++ /dev/null@@ -1,246 +0,0 @@-----title: "Vendor Onboarding"-description: "In this Spree user doc, you'll learn how to onboard as a vendor to a multivendor marketplace."------<Warning>- Vendor onboarding is a feature available only in Spree Enterprise Edition.-</Warning>--<Note>- This guide is intended for vendors, but may also be useful for marketplace owners should they wish to understand the onboarding process more clearly.-</Note>--Vendors are the backbone of any marketplace - without them, there is no marketplace. The onboarding process, including product catalog synchronization, must be as simple as possible to avoid deterring potential partners with technical complexity or disrupting their daily operations.--For vendors, connecting to a marketplace couldn't be easier thanks to the guided, self-service vendor onboarding process available in Spree Enterprise Edition.--Here are the steps you should follow to connect with a Spree-powered marketplace.--## Accept Invitation----First things first, you should have been sent an email invitation or provided with an invitation link to join the marketplace.--Simply click on the link and you'll be directed to the next step.--<Note>- The above screenshot is the default email template. The actual email and content may be quite different.-</Note>--## Create an Account----Next, you'll need to set up a vendor account with the marketplace. Fill in all fields and click 'Create Account' to continue.--<Note>- The above screenshot shows the default sign up page. The design, content, and commercial terms may differ.-</Note>--## Vendor Dashboard--Once you've created your account, you'll be redirected to your vendor dashboard.----In the 'Getting Started' tab, you'll see six onboarding tasks that need to be completed before you can start selling on the marketplace. Clicking on the tasks will reveal the actions that need to be taken. Let's look at each task in more detail.--<Note>- There are six tasks by default, but the marketplace you're joining may have more or less depending on its business model.-</Note>--### Connect or Create a Shop----The first task, and arguably the most important, is to connect or create a shop.--Right now there are three self-service options available for use (Shopify, WooCommerce, and CSV/admin dashboard) but more will be available in the future.--<Note>- Custom integrations can be developed to sync products and inventory if the vendor's store is not running on any of the available platforms. Please reach out to us if you require integration support.-</Note>--#### Shopify--If you are running a Shopify store, you'll be glad to know that onboarding is completely automated.--To connect your store to the marketplace, click the 'Shopify' button.--Doing so will redirect you to the Shopify app store with a prompt to install the marketplace's app.--Click 'Install' and you'll be redirected to your Shopify dashboard with another prompt to install the app.----Click 'Install' again to install the app, and you'll be redirected to the setup screen.----Simply click 'Start Setup' and your store will start synchronizing with the marketplace.----Here's a summary of how it works:--- Active products are synced with the marketplace-- Inventory levels are synced both ways in real-time-- Shipping methods (including prices) are synced with marketplace-- Orders are routed to your Shopify dashboard for fulfillment-- Fulfillment status and shipment tracking is synced with the marketplace-- Future price updates are synced with the marketplace-- Content updates are synced with the marketplace (if not previously edited by the marketplace owner)--Of course, you can select which products you'd like to make available to the marketplace by adding/removing the sales channel to the products.--<Note>- Once the app is set up, it's essentially business as usual for Shopify stores - no need to use the Spree vendor dashboard other than for completing the rest of the onboarding steps and accessing payout information or invoices on occasion.-</Note>--Navigating back to the vendor dashboard, you'll see that this task is now marked as completed.----#### WooCommerce--The WooCommerce store connector works similarly to the Shopify connector by automating important parts of the onboarding process.--To connect your WooCommerce store to the marketplace, click 'WooCommerce'.--Doing so will open a popup that requires you to enter your WooCommerce store's URL.----Enter the URL, click 'Continue', and you'll be redirected to a page that asks you to approve the marketplace's connection to your store.----Click 'Approve' and you'll be redirected to the vendor dashboard and the task will be marked as complete.----Here's a summary of how it works:--- Active products are synced with the marketplace-- Inventory levels are synced both ways in real-time-- Shipping methods (not including prices) are synced with marketplace-- Orders are routed to your WooCommerce dashboard for fulfillment-- Fulfillment status and shipment tracking is synced with the marketplace-- Future price updates are synced with the marketplace-- Content updates are synced with the marketplace (if not previously edited by the marketplace owner)--#### Use CSV and/or Admin dashboard--As the name suggests, this method requires you to add products manually one-by-one or by uploading a product CSV file.--To use this method to add products to the marketplace, click 'Use CSV and/or Admin dashboard' and the task will be checked off.----While the task is complete, you'll still need to add products to your store if you want to sell anything on the marketplace.--To do so, navigate to the Products tab of the vendor dashboard.----Please refer to the Products section of our user docs for guides on how to add products to your vendor account.--### Add billing address--Adding your company's billing address is essential as it is needed for vendor payouts and invoices.--Simply click on the task to reveal the form and enter your company's billing information.----Fill in all the required fields, click 'Save', and the task will be marked as completed.----<Note>- If you use the Shopify store connector, your billing address will be automatically imported.-</Note>--### Connect Stripe account----Stripe is used to process payments and to send vendor payouts. In order to receive your payouts, you'll need to connect a Stripe account to the marketplace's account.--An existing Stripe account is not required. Clicking on 'Connect your bank account' will lead you through a short Stripe onboarding process which should only take a few minutes.--When an order is placed, you'll receive the money instantly whenever you ship the order.--If you're not in charge of the financial responsibilities of your company, you can invite another team member to complete this task instead.--Once Stripe onboarding is complete, the associated task will be checked off.----If you've missed any information when submitting your Stripe account, the task will not be marked off and you'll be asked to complete onboarding.----<Warning>- While Stripe is popular among marketplace platforms, the marketplace you are joining may not use Stripe. However, you will likely still be required to connect a bank account to receive payouts unless they are reconciling them manually.-</Warning>--### Add returns address--Adding a return address as a vendor is important because it ensures customers know where to send returns, streamlining the return process and helping maintain a positive customer experience.--Simply click on the task to reveal the form, and enter your company's return address.----Fill in all the required fields, click 'Save', and the task will be marked as completed.----<Note>- If you use the Shopify store connector, your billing address will be automatically imported.-</Note>--### Set shipping rates----Shipping rates must be set up and confirmed. Otherwise, customers will not be able to order your products.--Click on 'Manage Shipping Rates' and you'll be redirected to 'Shipping Methods' section of the vendor dashboard's Settings menu.----How you completed the first task (Connect or Create a Shop) determines what you'll need to do here:--- If you connected Shopify, your shipping methods and rates will be synced. You'll just need to click 'Confirm Shipping Rates' in the top right corner.-- If you connected WooCommerce, your shipping methods will be synced. You'll need to set the rate of each method, and then click 'Confirm Shipping Rates'.-- If you imported a product CSV, you'll need to add shipping methods and rates, and then click 'Confirm Shipping Rates'.--Whatever the case, please refer to our support article on Shipping Methods to learn how to setup and manage shipping methods.--After confirming the shipping rates, the task will be marked as completed.----<Note>- You can edit existing shipping methods or add new ones at any time.-</Note>--### Add returns policy--Last but not least, you'll need to add a return policy. Adding a return policy as a vendor is important because it builds trust with customers, sets clear expectations, and helps prevent disputes over returns and refunds.--Simply click on the task to reveal the text field.----Copy and paste your returns policy into the field, click 'Save' and the task will be completed.----## Onboarding Completed\!--Congratulations, you have successfully completed the onboarding process. All that's left now is for the marketplace owner to approve your vendor profile, merchandise your products and brand page, and start selling\!\ No newline at end of filediff --git a/docs/user/vendors/vendor-payouts.mdx b/docs/user/vendors/vendor-payouts.mdxnew file mode 100644index 0000000000..ac64834bea--- /dev/null+++ b/docs/user/vendors/vendor-payouts.mdx@@ -0,0 +1,59 @@+---+title: "Vendor Payouts"+description: "Learn how to set and override vendor payout schedules across your multi-vendor marketplace in Spree Commerce."+---++<Warning>Multi-vendor capabilities are only available in Spree Enterprise Edition.</Warning>++<Warning>Vendor payout scheduling is a Stripe Connect feature. If your marketplace is configured with a different payment provider, the payout schedule controls described below won't be available in your admin or vendor dashboards.</Warning>++Vendor payouts are how your vendors actually receive the money they've earned from sales on your marketplace. Spree's payout flow runs through Stripe Connect, which means once a vendor has connected their Stripe account during onboarding, they'll be paid automatically on whatever schedule you've configured — no manual transfers, no chasing invoices.++Like with [<u>commission rates</u>](https://spreecommerce.org/docs/user/vendors/commission-rates), one fixed schedule rarely suits every vendor. Some may want frequent payouts to manage cash flow, others may prefer larger, less frequent transfers. Spree lets you set a marketplace-wide default and override it per vendor as needed.++## 1. Default Marketplace Payout Schedule++The default payout schedule applies to every vendor whose schedule is set to **Use marketplace default interval**. It's configured under **Settings → Marketplace** and serves as the fallback for everyone who hasn't opted into a custom schedule.++See [<u>Marketplace Configuration</u>](https://spreecommerce.org/docs/user/settings/marketplace) for details on setting and updating the default schedule.++<Note>Changing the default also updates the payout schedule for any existing vendors who are still on the marketplace default. Vendors who've chosen a specific schedule of their own won't be affected.</Note>++## 2. Vendor-Specific Payout Schedule++You can override the payout schedule for individual vendors directly from their vendor profile — useful when a particular vendor has cash flow needs that differ from the rest of your marketplace.++Navigate to **Vendors** in the admin dashboard and click on the vendor you'd like to update.++++Scroll down to the **Payments & Payouts** section of the vendor profile and choose a payout schedule from the dropdown.++++The available options are:++- **Use marketplace default interval** - the vendor follows whatever default is configured under Settings → Marketplace.+- **Daily** - payouts are issued every business day.+- **Weekly** - payouts are issued once per week.+- **Bi-weekly** - payouts are issued every two weeks.+- **Monthly** - payouts are issued once per month.++Click **Update** at the bottom of the page to save your changes.++<Note>If you set a vendor to a specific schedule (anything other than **Use marketplace default interval**), future changes to the marketplace default will no longer affect them. To bring them back in line, set them back to **Use marketplace default interval**.</Note>++## Which Schedule Applies?++When a payout is processed, Spree applies the most specific schedule available, in the following order:++1. **Vendor-specific schedule** — if set to a specific interval, this wins.+2. **Marketplace default schedule** — used whenever a vendor is set to **Use marketplace default interval**.++## Next Steps++For more on how vendors connect their Stripe accounts during onboarding (which is what makes automated payouts possible), see the relevant onboarding doc:++- [<u>Shopify Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-shopify)+- [<u>WooCommerce Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-woocommerce)+- [<u>Manual/CSV Vendor Onboarding</u>](https://spreecommerce.org/docs/user/vendors/vendor-onboarding-manual)