NBKB B2B Wholesale Pro for WooCommerce

1. Overview & Architecture

NBKB B2B Wholesale Pro is the commercial add-on designed for fast-growing distributors, manufacturers, and direct-to-business merchants. It seamlessly expands the free core plugin (nbkb-b2b-wholesale) with enterprise-grade wholesale features:

2. System Requirements & Compatibility

NBKB B2B Wholesale Pro is engineered to modern WordPress and WooCommerce standards, ensuring blazing-fast query execution and future-proof stability.

3. Installation & Dependency Guide

Step-by-Step Installation:

1. Install the Free Core Plugin

   In your WordPress dashboard, navigate to Plugins > Add New. Search for NBKB B2B Wholesale and click Install Now, then Activate. (Alternatively, download it from WordPress.org).

2. Upload the Pro ZIP File

   Go to Plugins > Add New > Upload Plugin. Choose the nbkb-b2b-wholesale-pro.zip file from your order confirmation email or NBKB Labs account.

3. Activate Pro Plugin

   Click Install Now, and once uploaded, click Activate Plugin.

4. Access B2B Wholesale Control Center

   Navigate to WooCommerce > B2B Wholesale in your left admin sidebar. You will notice new Pro tabs added: Roles, Approvals, Quotes, Order Rules, and License.

4. License Activation & Automatic Updates

Activating your license unlocks automatic, 1-click background updates directly within your WordPress Plugins screen whenever a new version is released.

1. Locate Your License Key

   Check your purchase confirmation email from NBKB Labs (or log into your customer portal) to copy your Freemius License Key.

2. Navigate to the License Tab

   In your WordPress dashboard, go to WooCommerce > B2B Wholesale > License.

3. Activate Your Store

   Paste your License Key into the input box and click Activate License.

5. Tiered Bulk Quantity Pricing

Tiered pricing incentivizes wholesale customers to order in larger quantities by automatically reducing unit prices as order volume increases.

Configuring Tiers on a Simple Product:

1. Edit any product in Products > All Products.
2. Under Product Data > General, locate the B2B Tiered Volume Discounts [PRO] box.
3. Click + Add Tier to create discount rules:
   • Min Qty: The quantity threshold to trigger the discount (e.g., 10).
   • Discount Type: Select from % Discount, Fixed Unit Price ($), or Fixed Discount ($).
   • Value: Enter the numeric discount amount (e.g., 15 for 15% off).
4. Repeat to add multiple tiers (e.g., 10 units = 15% off, 50 units = 25% off, 100 units = 8/unit).
5. Click Update to save the product.

Configuring Tiers for Variable Products:

For variable products, expand any variation in the Variations tab. Each individual variation includes its own independent tiered pricing table, allowing you to set specific bulk volume thresholds per SKU.

Frontend Live Quantity Price Table:

When a logged-in wholesale customer views the product page, an interactive pricing table automatically displays above the Add to Cart form. As the customer increases or decreases the quantity selector, the table dynamically highlights the active tier and recalculates the total.

6. Custom Wholesale Customer Groups

Not all wholesale buyers are the same. Pro comes pre-configured with industry-standard wholesale customer tiers:

Managing Global Role Discounts:

Navigate to WooCommerce > B2B Wholesale > Roles. Here you can define global catalog-wide discount percentages for each customer group. If a product does not have an explicit wholesale price entered, the role's global discount percentage is automatically deducted from the retail price.

7. Registration Approval Workflow & Fraud Prevention

Protect your wholesale margins from retail shoppers and unauthorized sign-ups with our built-in manual verification workflow.

Enabling Registration Approvals:

1. Go to WooCommerce > B2B Wholesale > Approvals.
2. Check the box: Enable Manual Admin Approval for B2B Registrations.
3. Click Save Changes.

How the Workflow Functions:

• When a new business registers via the wholesale registration form, their user account is assigned the nbkb_b2b_pending status.
• Pending accounts cannot see wholesale pricing or purchase at discounted rates until approved.
• Store managers see a live red count badge on the Approvals tab indicating applicants waiting for review.
• The admin can inspect business details (Company Name, Tax/VAT ID) and click Approve or Reject with one click.
• Upon approval, the customer instantly receives an automated email notification confirming their B2B account is active.

8. Request a Quote Inquiry Engine

B2B trade often involves custom negotiations. The built-in Quote Engine allows wholesale buyers to request quotes on products, build a quote inquiry basket, and submit customized project requests.

Enabling Quote Requests:

1. Go to WooCommerce > B2B Wholesale > Quotes.
2. Enable the global switch: Enable Request a Quote for Wholesale Customers.
3. Optionally enable or disable quotes on specific products via the product edit screen.

Managing Inquiries & 1-Click Order Conversion:

• Customers add products to their quote basket and submit project notes via the shortcode: [nbkb_b2b_quote_basket].
• Submitted quotes appear under WooCommerce > B2B Wholesale > Quotes.
• Store managers can review requested quantities, propose negotiated pricing, and click Convert to Invoice.
• A real WooCommerce Order is created with pending payment status, and the customer is emailed an invoice link to pay online.

9. Cart Order Rules & Gateway Visibility

Control checkout thresholds and payment terms to enforce profitable B2B operations.

Available Controls (under Order Rules tab):

• Minimum Wholesale Cart Subtotal: Require wholesale accounts to purchase a minimum amount (e.g., 50.00) before checkout is allowed.
• Minimum Wholesale Item Quantity: Prevent retail order sizes by enforcing a minimum total item count (e.g., 10 units minimum).
• Payment Gateway Visibility: Hide retail payment methods (like Cash on Delivery) from wholesale buyers, or hide B2B terms (like Net 30 / Bank Wire) from retail guests.

10. Shortcodes Reference

11. Developer Hooks & Filters

NBKB B2B Wholesale Pro provides clean WordPress action and filter hooks for custom theme and custom code integration.

Core Filter Hooks:

// 1. Modify the calculated wholesale price programmatically
add_filter( 'nbkb_b2b_calculated_product_price', function( , , ,  ) {
    // Custom business logic
    return ;
}, 10, 4 );

// 2. Add custom wholesale customer roles to the recognition list
add_filter( 'nbkb_b2b_wholesale_roles', function(  ) {
    [] = 'custom_corporate_role';
    return ;
} );

// 3. Customize minimum order restriction error notice
add_filter( 'nbkb_b2b_min_order_error_message', function( ,  ) {
    return sprintf( 'Wholesale orders require at least $%s.', number_format( , 2 ) );
}, 10, 2 );

Core Action Hooks:

// Triggered when a new wholesale registration applicant is submitted
add_action( 'nbkb_b2b_user_registered_pending', function( ,  ) {
    // Send custom Slack or CRM webhook notification
}, 10, 2 );

// Triggered when a pending wholesale applicant is approved by admin
add_action( 'nbkb_b2b_user_approved', function(  ) {
    // Sync contact to ERP or newsletter
} );

// Triggered when a customer submits a new quote request
add_action( 'nbkb_b2b_quote_submitted', function( ,  ) {
    // Dispatch custom internal sales alert
}, 10, 2 );

12. Troubleshooting & FAQ

Q: Wholesale prices or tiered tables do not appear on product pages.

A: Wholesale prices and tiered tables are strictly visible to users who are logged in with an authorized wholesale customer role (e.g., Wholesale Customer, VIP Wholesale, Distributor). Guest visitors and retail customers will only see standard retail pricing.

Q: I activated Pro, but I see a warning about Lite.

A: Pro requires the free core plugin (nbkb-b2b-wholesale). Simply install and activate NBKB B2B Wholesale from your WordPress dashboard under Plugins > Add New.

Q: Does this plugin work with WooCommerce HPOS (High-Performance Order Storage)?

A: Yes! NBKB B2B Wholesale and the Pro add-on are 100% native HPOS compatible, declaring official compatibility and using WooCommerce CRUD order methods exclusively.

Q: Are the new WooCommerce Cart and Checkout Blocks supported?

A: Absolutely. Tier pricing and wholesale cart rules execute at the cart calculation hook layer, ensuring full compatibility with both classic shortcodes and the modern block checkout.

13. Changelog & Support

Version 1.0.0 (Official Release)

• Initial commercial release of NBKB B2B Wholesale Pro.
• Tiered volume bulk quantity pricing engine for simple and variable products.
• Wholesale customer groups: VIP Wholesale, Distributor, Tier 1 Partner.
• Manual admin approval workflow with applicant verification queue and email dispatch.
• Request a quote inquiry system with 1-click WooCommerce invoice conversion.
• Minimum order subtotal and minimum item quantity restrictions.
• Payment gateway role visibility controls.
• Freemius secure license activation and 1-click automatic dashboard updates.
• 100% HPOS and Block Checkout compatibility.

Official Support & Helpdesk:

Need assistance or have questions? Our support team is ready to help:

• Helpdesk & Support: https://nbkblabs.com/#support
• Email Support: support@nbkblabs.com