Skip to content

armgit / spree

Public Imported from GitHub
0

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.

Documentation edits made through Mintlify web editor

mintlify[bot]636cbc6489cf
diff --git a/docs/docs.json b/docs/docs.json
index 7ec6e4054f..9ab9c3f7ac 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -997,6 +997,15 @@
"use-case/multi-tenant/multi-brand-enterprise-model",
"use-case/multi-tenant/white-label-saas"
]
+ },
+ {
+ "group": "B2B Commerce",
+ "pages": [
+ "use-case/b2b/b2b-commerce-model",
+ "use-case/b2b/b2b-capabilities",
+ "use-case/b2b/b2b-admin-capabilities",
+ "use-case/b2b/b2b-buyer-capabilities"
+ ]
}
]
}
diff --git a/docs/use-case/b2b/b2b-admin-capabilities.mdx b/docs/use-case/b2b/b2b-admin-capabilities.mdx
new file mode 100644
index 0000000000..05b1428917
--- /dev/null
+++ b/docs/use-case/b2b/b2b-admin-capabilities.mdx
@@ -0,0 +1,53 @@
+---
+title: "B2B Admin Capabilities"
+description: "Learn how Spree empowers merchants to manage B2B buyers, pricing, and workflows with full flexibility."
+---
+
+As the operator of a B2B storefront, you have full control over how business buyers access your platform, interact with your catalog, and complete their purchases. Unlike B2C commerce, B2B environments often require complex account structures, custom pricing, gated access, and high-volume order workflows.
+
+Spree Commerce Enterprise gives you the flexibility to tailor these experiences to suit your sales model - whether you’re selling to independent retailers, distributor networks, or large procurement teams. From customer segmentation and pricing logic to fulfillment, tax handling, and integrations, Spree provides the foundational tools needed to configure and scale a powerful B2B platform.
+
+<Note>
+Some advanced capabilities may require a bit of custom development or integration work depending on your exact business needs.
+</Note>
+
+## Account & Access Controls
+
+- Create gated storefronts that require login to browse products or view prices
+- Approve or reject buyer signups based on survey data or business logic
+- Assign customers to buyer segments or organizations
+
+## Segmentation & Pricing
+
+- Set up custom pricing per organization, customer, or segment
+- Define volume discounts or pricing tiers based on order quantities
+- Offer exclusive promotions or terms to specific buyer types
+
+## Product & Ordering Workflows
+
+- Allow bulk ordering via quantity selectors or CSV uploads
+- Enable repeat orders and saved order templates
+- Monitor and export B2B-specific orders for processing or fulfillment
+
+## Buyer Organizations & Permissions
+
+- Associate users with a parent organization (company account)
+- Manage roles within the organization (e.g., buyers, approvers, finance)
+- Apply account-level rules for checkout, payment, or shipping
+
+## Fulfillment & Inventory Models
+
+- Assign inventory across multiple warehouses
+- Set warehouse-based fulfillment logic for B2B customers
+- Use ERP integrations to sync catalog and stock levels
+
+## Invoicing, Tax & Compliance
+
+- Configure on terms or invoice-based payment options
+- Automate tax exemption logic based on buyer profile
+- Control compliance and approval workflows based on industry or region
+
+## Further Reading
+- [<u>B2B Commerce Model</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-commerce-model)
+- [<u>B2B Capabilities</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-capabilities)
+- [<u>B2B Buyer Experience</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-buyer-experience)
\ No newline at end of file
diff --git a/docs/use-case/b2b/b2b-buyer-capabilities.mdx b/docs/use-case/b2b/b2b-buyer-capabilities.mdx
new file mode 100644
index 0000000000..42bbe80eef
--- /dev/null
+++ b/docs/use-case/b2b/b2b-buyer-capabilities.mdx
@@ -0,0 +1,41 @@
+---
+title: "B2B Buyer Experience"
+description: "Learn how Spree delivers a seamless and efficient purchasing experience tailored to B2B buyers."
+---
+
+Whether you're selling to independent retailers, wholesale distributors, or enterprise procurement teams, your buyers expect efficiency, transparency, and control. In a B2B setting, these expectations go far beyond simply adding items to a cart - they often involve custom pricing, team-based purchasing, invoice payments, and streamlined reordering.
+
+Spree Commerce Enterprise supports a wide range of buyer experiences tailored specifically to the needs of professional purchasing. With personalized catalogs, account-based pricing, flexible order tools, and business-friendly checkout flows, Spree enables you to deliver a seamless and self-service B2B experience that keeps buyers coming back.
+
+<Note>
+Some advanced capabilities may require a bit of custom development or integration work depending on your exact business needs.
+</Note>
+
+## Account Management
+
+- Register through a configurable signup form with business-specific fields
+- Access personalized dashboards with order history, invoices, and account status
+- Manage team members and roles within an organization (if applicable)
+
+## Shopping & Ordering
+
+- View personalized product lists, pricing and availability
+- Use quick order tools like CSV upload, favorites, or reorder from history
+- Place orders with multiple line items and high quantities or configure recurring orders efficiently
+
+## Checkout & Payment
+
+- Choose from business-relevant payment methods (e.g., invoice, ACH, credit card)
+- Apply tax exemptions automatically at checkout
+- Save and select shipping addresses or PO numbers for faster repeat purchases
+
+## Communication & Support
+
+- Receive personalized notifications for approvals, shipment tracking, and invoices
+- Contact account managers or support directly through the dashboard
+- Review order and payment history, purchase terms, policies, and company documents
+
+## Further Reading
+- [<u>B2B Commerce Model</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-commerce-model)
+- [<u>B2B Capabilities</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-capabilities)
+- [<u>B2B Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-admin-capabilities)
\ No newline at end of file
diff --git a/docs/use-case/b2b/b2b-capabilities.mdx b/docs/use-case/b2b/b2b-capabilities.mdx
new file mode 100644
index 0000000000..8c8fbae36d
--- /dev/null
+++ b/docs/use-case/b2b/b2b-capabilities.mdx
@@ -0,0 +1,66 @@
+---
+title: "B2B Capabilities"
+description: "Learn how Spree Commerce supports advanced B2B commerce operations"
+---
+
+Spree Commerce Enterprise Edition offers a flexible and powerful foundation for building custom B2B ecommerce platforms.
+
+With support for customer segmentation, per customer or segment pricing logic, account hierarchies, and gated storefronts, Spree enables merchants to deliver tailored experiences for business buyers - whether serving small retailers, wholesale partners, or large procurement teams.
+
+Many of the features listed below can be configured using Spree’s APIs and flexible architecture. 
+
+<Note>Some advanced capabilities may require a bit of custom development or integration work depending on your exact business needs.</Note>
+
+## Admin Capabilities
+
+Spree empowers B2B merchants to define how buyers interact with their platform and manage complex sales workflows.
+
+- **Account Access & Controls** – Create gated storefronts, approve or reject signups, and assign customers to segments.
+- **Customer Segmentation & Pricing** – Set organization-specific pricing, volume discounts, and buyer-specific promotions.
+- **Product & Ordering Workflows** – Enable bulk ordering, saved templates, and repeat purchases for high-volume buyers.
+- **Buyer Organizations & Permissions** – Group buyers under organizations with role-based permissions and shared access.
+- **Fulfillment & Inventory Models** – Assign inventory to multiple warehouses and configure custom fulfillment logic to multiple destinations per customer
+- **Invoicing, Tax & Compliance** – Support on terms payments, third-party invoicing and tax calculations, and support  industry-specific sales processes, including post-purchase documentation
+
+## Buyer Capabilities
+
+Spree delivers a streamlined and personalized experience for business buyers—whether individuals or part of a purchasing team.
+
+- **Account Management** – Register with business-specific fields and manage team members, roles, and profiles.
+- **Easy B2B Ordering** – Access personalized pricing, use quick order tools, and place large or recurring orders through quick-order forms instead of adding to cart,
+- **B2B Checkout & Payments** – Choose from B2B payment methods, multiple delivery addresses, convenient delivery methods and save purchase details for later use.
+- **Post-purchase support** – Access order, shipment and invoicing history, shipment tracking, product related documentation, certificates and other documents to meet regulatory requirements.
+- **Communication & Support** – Receive notifications, contact support, and check account audit logs to retrace your team’s steps, if needed.
+
+## Custom B2B Logic
+
+Spree’s architecture allows you to tailor nearly every aspect of the B2B experience:
+
+- Build gated onboarding flows, extend inventory management, pricing rules, ordering and payments flows, delivery, and integrate with any third-party applications such as ERP,CRM, POS, accounting, banking systems.
+- Deploy flexible permission models and checkout behavior across customer segments or accounts.
+- Use Spree’s APIs to deliver custom buyer portals or back-office workflows within mobile apps or existing web apps.
+
+## Full Ownership And Control
+
+With Spree Enterprise, you’re not locked into a black-box SaaS model. You retain complete control over your infrastructure, data, and roadmap, enabling long-term flexibility, scalability, and compliance.
+
+- **API-Driven Extensibility**
+ - **Full API Coverage** - extend the platform via REST APIs for storefronts, checkout, vendor dashboards, or 3rd-party integrations. See: [<u>API Reference</u>](https://spreecommerce.org/docs/api-reference/introduction)
+ - **Custom Integrations** - seamlessly connect with ERPs, CRMs, payment providers, POS systems, or headless frontends.
+- **Deployment Flexibility**
+ - **Self-Hosting Options** - deploy Spree anywhere; your cloud provider, on-premise, or in specific geographic regions. See: [<u>Deployment Guide</u>](https://spreecommerce.org/docs/developer/deployment/render)
+ - **Provider Agnostic** - run on AWS, GCP, Azure, or [Render.com](http://Render.com). Tailor infrastructure to budget, compliance, and performance needs.
+- **Scalability & Performance**
+ - **Built for Scale** - Spree supports advanced architectures using load balancers, Redis caching, CDN layers (e.g., Cloudflare or Fastly).
+ - **High Availability** - avoid downtime during peak sales periods or global rollouts with scalable infrastructure.
+- **Security Under Your Control**
+ - **Anti-DDoS & Rate Limiting** - configure your own network protections using preferred security services.
+ - **Vulnerability Management** - patch quickly, audit dependencies, and apply security policies with no vendor bottlenecks.
+- **Compliance Ownership**
+ - **Full Compliance Control** - build to meet your exact regulatory requirements, whether WCAG, GDPR, HIPAA, or SOC2.
+ - **Data Sovereignty** - keep data within borders required by your industry or region.
+
+## Further Reading
+- [<u>B2B Commerce Model</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-commerce-model)
+- [<u>B2B Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-admin-capabilities)
+- [<u>B2B Buyer Experience</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-buyer-experience)
\ No newline at end of file
diff --git a/docs/use-case/b2b/b2b-commerce-model.mdx b/docs/use-case/b2b/b2b-commerce-model.mdx
new file mode 100644
index 0000000000..871c07cf21
--- /dev/null
+++ b/docs/use-case/b2b/b2b-commerce-model.mdx
@@ -0,0 +1,65 @@
+---
+title: "B2B Commerce Model"
+description: "Learn about the B2B commerce model."
+---
+
+Spree Commerce Enterprise Edition supports robust B2B commerce operations through its flexible architecture and customizable workflows.
+
+Whether you're selling wholesale, managing distributor networks, or running a B2B2C hybrid, Spree gives you the tools to tailor every part of the buyer journey while maintaining full ownership and control over your platform.
+
+## What is B2B Ecommerce?
+
+B2B ecommerce (business-to-business) refers to commercial transactions between companies, rather than between a company and individual consumers. These storefronts serve business accounts with structured workflows, not casual shoppers.
+
+B2B platforms typically feature:
+
+- Role-based access and buyer teams
+- Volume pricing, customer-specific rates, and payment terms
+- Bulk ordering and order repeat functionality
+- Restricted or gated storefront access
+- ERP or procurement integrations
+
+## Why Choose the B2B Ecommerce Model?
+
+- **Streamlined Sales Operations**: Digitizing your B2B sales process reduces manual effort, minimizes errors, and allows for faster order turnaround—especially for high-volume, repeat purchases.
+- **24/7 Self-Service for Buyers**: Business buyers increasingly expect ecommerce-like convenience. A B2B storefront allows them to browse products, check prices, and place orders on their own schedule.
+- **Account-Based Customization**: B2B ecommerce enables personalized pricing, product availability, and tax rules based on account, segment, or purchasing history.
+- **Scalable Growth**: An ecommerce-driven sales channel can complement or even replace traditional sales teams—helping you scale operations to more accounts or regions without adding headcount.
+- **Integration with Back-Office Systems**: B2B platforms often need to plug into ERPs, CRMs, and procurement systems to streamline fulfillment, invoicing, and customer management.
+
+## Common B2B Use Cases
+
+- **Wholesale Ordering Portals**: Buyers log into secure portals to access bulk pricing, submit large orders, and reorder frequently.
+- **Buyer Organizations**: Multiple users (buyers, managers, finance) operate under one account with shared order history, role-based permissions, and organizational pricing.
+- **Member-Only Storefronts**: Access requires approval. Anonymous visitors can’t see pricing or checkout. Sign-up forms can be customized for customer vetting.
+- **Dealer / Reseller Portals**: Offer customized catalogs and prices by account. Resellers place orders directly and may access sales and inventory reports.
+
+## Challenges in B2B Ecommerce
+
+- **Role-Based Buyer Structures**: Supporting multi-user organizations with permissions and approval workflows adds complexity that most B2C platforms don’t account for.
+- **Custom Pricing Logic**: B2B pricing often includes tiers, discounts, and customer-specific contracts. A flexible pricing engine is critical.
+- **Gated Storefront Access**: Restricting visibility of products and pricing until account approval is a must for many B2B businesses.
+- **Large Quantities, Repeat Orders**: Business buyers need to place large orders efficiently - often reordering from CSVs or previous orders.
+- **ERP & Fulfillment Integration**: Orders typically need to flow into ERP systems, with real-time sync for inventory, shipping, and invoicing.
+- **Regulatory & Contractual Complexity**: Tax exemptions, special terms, and compliance requirements (e.g. for regulated products or specific industries) must be supported.
+
+## How Spree Supports B2B Commerce
+
+Spree gives B2B teams the building blocks to tailor storefronts and workflows to match their specific business logic.
+
+While many B2B features depend on custom implementation, Spree’s extensibility allows you to:
+
+- Require signup or login before showing products or prices or allowing checkout
+- Serve different catalogs or prices by customer segment or account
+- Group users into buyer organizations with shared access but varied permissions
+- Offer tiered pricing, bulk discounts, and volume-based promotions
+- Implement order approval or quoting flows
+- Enable reordering from past purchases or CSV upload
+- Integrate with your ERP, CRM, or accounting platform via API
+
+Spree’s goal is to provide the infrastructure and freedom you need to create a high-performing B2B experience without being boxed in by off-the-shelf tools.
+
+## Further Reading
+- [<u>B2B Capabilities</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-capabilities)
+- [<u>B2B Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-admin-capabilities)
+- [<u>B2B Buyer Experience</u>](https://spreecommerce.org/docs/use-case/b2b/b2b-buyer-experience)
\ No newline at end of file