The B2B landscape in e-commerce requires a level of complexity far beyond standard retail. Wholesalers need custom pricing, restricted access, and streamlined ordering processes. The BSS Commerce B2B Package for Magento 2 is a comprehensive suite designed to transform a standard Magento installation into a powerhouse for business-to-business transactions.

This guide walks you through the lifecycle of setting up this package—from preparation and installation to granular configuration of its core modules.

Prepare For Installation

Before running a single command, preparation is vital. Because the B2B package interacts with core checkout and catalog logic, a safety-first approach is required.

Prerequisites

• Complete Backup: Never install a multi-module package on a live site without a full backup. Ensure you have a snapshot of your database and a compressed archive of your media, code, and vendor folders.
• Version Compatibility: Verify that your Magento version (such as 2.4.6 or 2.4.7) matches the extension version provided by BSS. Check your PHP version requirements as well; Magento 2.4.x typically requires PHP 8.1 or 8.2.
• Environment Check: Ensure your Cron jobs are running correctly. Many B2B features, such as email notifications for quotes, rely on the Magento Cron system.
• Theme Compatibility: If you are using a custom theme, you may need specific compatibility patches provided by BSS Commerce to ensure the interface elements align correctly.

Choose Your Method

You have two primary routes: Composer or Manual Upload.

• Composer is highly recommended for professional environments as it manages dependencies and makes future updates seamless.
• Manual Upload is suitable for local development or environments where SSH and Composer access are restricted.

Install The B2B Modules

The BSS Commerce B2B extension Magento is modular. Depending on your plan (Basic, Pro, or Premium), you will be handling a variety of tools including Force Login, B2B Registration, Catalog Permission, Request for Quote, Wholesale Fast Order, Multiple Wishlists, and Store Credit.

Option A: Install Via Composer (Preferred)

1. Obtain Credentials: Email BSS Commerce with your order number to receive your unique Composer username and password.
2. Add Repository: Open your terminal and navigate to your Magento root. Run the following command: composer config repositories.bsscommerce composer https://composer.bsscommerce.com/community
3. Install Package: Execute the requirement command: composer require bsscommerce/b2b-package:1.x.x (Note: Replace 1.x.x with the version number provided in your account dashboard).

Option B: Manual Upload (app/code)

1. Extract: Unzip the B2B Package archive on your local machine.
2. Upload: Use SFTP to upload the contents. You must create the directory structure: app/code/Bss/[ModuleName].
3. Structure: For example, the B2B Registration module should reside in app/code/Bss/B2bRegistration.

Enable Modules and Deploy

Once the files are in place, you must register the new modules with the Magento system. Run the following sequence in your SSH terminal from the Magento root directory:

1. Update the Database Schema: bin/magento setup:upgrade
2. Compile Code: bin/magento setup:di:compile
3. Deploy Static Assets: bin/magento setup:static-content:deploy -f
4. Clear Cache: bin/magento cache:flush

Note: If you have Javascript merging or CSS minification enabled in your settings, disable them before running these commands to prevent deployment errors. Re-enable them once you verify the installation is successful.

Configure B2B Features In Admin

After the system deployment is successful, the core of your work shifts to the Magento Admin Panel. The BSS Commerce B2B Package is not a “plug-and-play” single switch; it is a collection of logic layers that must be synchronized. Navigate to Stores > Configuration > BSSCOMMERCE to begin the granular setup.

Force Login and Access Restriction

For many B2B entities, price privacy is a competitive necessity. This module ensures your wholesale pricing isn’t scraped by competitors or viewed by retail shoppers.

• Global vs. Specific Restrictions: You can choose to lock the entire website or only specific categories and product pages. For SEO purposes, some merchants leave the homepage and “About Us” page public while locking all product-related URLs.
• Redirect Logic: Decide where the user goes when they hit a restricted link. You can send them to the standard login page or a custom B2B landing page that explains the benefits of becoming a wholesale partner.
• Alert Messages: Customize the “Access Denied” message to be more welcoming, such as “Welcome to our wholesale portal. Please log in to view our exclusive inventory and pricing.”

B2B Registration and Customer Approval

This module replaces the standard, simplified Magento registration with a robust business application process.

• Custom Fields: You can add specific fields to the registration form such as VAT/Tax ID, Company Website, Years in Business, or Business License Number.
• Customer Group Assignment: One of the most powerful features is the ability to auto-assign users to a “Pending” group upon registration. Once you manually review their credentials, you can move them to “Wholesale” or “VIP” groups.
• Admin Notifications: Configure the system to email your sales manager immediately when a new application is submitted. This reduces the “time-to-first-sale” by allowing your team to approve leads in real-time.

Once an account is approved, roles and sub-users can be configured to control permissions across the organization.

Catalog Permission and Hide Price

Once customers are grouped, you must control what they see. This is where you manage the “visibility” layer of your catalog.

• Granular Visibility: You can set permissions at the Category level. For example, “General” customers see the “Standard Hardware” category, but only the “Industrial” group can see the “Heavy Machinery” category.
• Price Replacement: Instead of just hiding the price, you can replace it with a “Call for Price” button or a “Login to View Price” link. This keeps the user engaged rather than showing them a blank space.
• Add to Cart Control: You can allow users to see the product and the price but disable the “Add to Cart” button until they meet specific criteria or belong to a verified group.

Request For Quote (RFQ)

The RFQ module manages the “Negotiation” phase, which is common in high-volume B2B transactions where the MSRP is just a starting point.

• Quote Expiration and Reminders: Set an automatic expiration date for quotes (e.g., 7 days). The system can send a reminder email to the customer 24 hours before the quote expires to encourage conversion.
• Cart-to-Quote Conversion: Allow customers to move their entire shopping cart into a quote request. This is useful for buyers who want a bulk discount on a diverse mix of items.
• Admin Modification: Administrators can open a quote on the backend, add or remove items, adjust quantities, and apply a custom discount percentage or a flat-rate price before sending it back to the customer for approval.

Wholesale Fast Order

Efficiency is the primary goal for repeat B2B buyers who order the same SKUs weekly.

• Search and Auto-complete: As the buyer types a SKU or product name into the fast order line, the system provides a dropdown of matches with thumbnail images to prevent ordering errors.
• Pre-filled Quantities: You can configure the form to default to your “Minimum Order Quantity” (MOQ) to ensure every line item meets your wholesale requirements.
• Product Attribute Support: The fast order form supports “Configurable Products.” If a buyer enters a SKU for a shirt, a popup will allow them to select the size and color without leaving the fast order interface.

Store Credit and Multiple Wishlists

These modules handle the financial and planning aspects of the B2B relationship.

• Store Credit Rules: Define how credit is earned or spent. You can allow customers to see their credit balance directly in their “My Account” dashboard and apply it at the final step of checkout.
• Credit Logs: For accounting purposes, the system maintains a strict log of every credit transaction, which can be exported for use in external ERP or accounting software.
• Multiple Wishlists for Project Management: B2B buyers often act as procurement officers for different projects. By allowing multiple wishlists, you enable them to save “Project A” items and “Project B” items separately, making it easy for them to reorder an entire project’s worth of supplies in the future.

Test The Setup

A B2B configuration is only as good as its user experience. You must test from two perspectives:

Frontend (The Buyer Experience)

1. Access: Try to access the site as a guest. Are you blocked or redirected as expected?
2. Registration: Fill out the B2B form. Does the administrator receive the notification?
3. Checkout: Once approved, use the Fast Order tool. Does it handle bulk quantities and tier pricing correctly?
4. Negotiation: Submit a Quote. Can you see the quote status in the My Account dashboard?

Backend (The Administrator Experience)

1. Customer Management: Go to Customers, then All Customers. Can you easily see which accounts are Pending Approval?
2. Quote Management: Navigate to Sales, then Quotes. Can you edit the price of a requested item and send a counter-offer?
3. Credit Management: Manually add store credit to a test account. Does it appear correctly in the customer balance?

Optional: API and GraphQL Support

If you are running a Headless Magento setup or a mobile app, you will need to utilize the BSS API and GraphQL endpoints.

• The B2B Package includes specialized schema for Store Credit, Company Accounts, and Request for Quote.
• Ensure your Authorization Bearer tokens are correctly configured in your testing tool (such as Postman) to access these protected B2B endpoints.

Best Practices for Magento 2 B2B Configuration

To ensure your B2B environment remains stable and user-friendly, follow these strategic guidelines when managing the BSS Commerce package.

Strategic Planning and Group Management

• Define Workflows First: Map out your customer journey before toggling settings. Determine which groups require manual approval and who is eligible for quote negotiations versus direct checkout.
• Segment Intelligently: Establish clear customer groups (e.g., Wholesale, Corporate, VIP). Use these as the foundation for your Catalog Permissions and Store Credit rules to maintain a scalable structure.
• Phase the Rollout: Do not enable every module simultaneously. Start with core functions like B2B Registration and Force Login, then introduce advanced tools like Request for Quote once the basic access logic is verified.

Technical Stability and Performance

• Staging First: Always deploy and configure modules in a staging environment. B2B modules often override core checkout and pricing logic, which can conflict with third-party Magento extensions.
• Standard Deployment Routine: After any configuration change, follow the standard Magento deployment cycle:
  • bin/magento setup:upgrade
  • bin/magento setup:di:compile
  • bin/magento cache:flush
• Theme Verification: If using a custom theme, check for layout breaks on the Fast Order and Registration pages immediately after installation.

Customer Experience and Internal Alignment

• Professional Registration: Keep the B2B registration form concise. Request only essential business documentation (Tax IDs or Licenses) to reduce friction for new leads.
• Clear Communication: Customize system messages for “Pending Approval” or “Login Required.” Ambiguous messaging can lead to high bounce rates from potential wholesale partners.
• Internal Workflow Alignment: Ensure your sales team knows their role in the digital ecosystem. Define who is responsible for:
  • Reviewing and approving new account applications.
  • Responding to and editing Quote requests in the backend.
  • Allocating and auditing Store Credit balances.

Security and Optimization

• SEO Awareness: When using Force Login, ensure SEO-critical pages (like the homepage or blog) are whitelisted so search engines can still crawl your site.
• Regular Audits: Periodically review your approval lists and permission logs to ensure access remains restricted to authorized business entities only.
• Data-Driven Refinement: Monitor usage metrics such as Fast Order adoption and Quote conversion rates. Use this data to simplify the interface or adjust your pricing strategies.

Applying expert tips when configuring the BSS Commerce Magento 2 B2B Extension helps avoid common pitfalls and ensures long-term scalability.

Final Thoughts

Configuring the BSS Commerce B2B Package is a process of turning a retail-centric platform into a sophisticated corporate tool. By following this structured approach—preparing thoroughly, installing cleanly, and configuring with the user in mind—you create a frictionless experience for your business clients.

Key Takeaway: Start with B2B Registration and Catalog Permissions first, as these form the foundation of your customer segments. Other features like Fast Order and Quote management, can be fine-tuned once your access logic is solid.