Mercenza - B2B for WooCommerce Free documentation

Mercenza lets you sell wholesale from your existing WooCommerce store without running a second shop. Buyers apply for a trade account, you approve them, and from then on they see their own prices, their own minimum quantities and only the products you want them to see. Retail customers notice nothing: a visitor who is not in a group sees your normal WooCommerce price.

The plugin is built around customer groups. Each group has its own prices, price display, catalog mode, stock display, tax display and order limits. On top of group prices you can add quantity tiers, prices for one customer or company, and dynamic pricing rules. Catalog rules hide products or block buying for guests, groups or everyone, and quantity rules set minimums, maximums, steps and pack sizes.

For buyers, Mercenza adds a B2B area in My Account with a quick order form (by name, SKU, barcode or a pasted list), shopping lists, reorders, recurring orders, company profiles and sub accounts. For you, there is a setup wizard, a dashboard, an approval queue, a price inspector, CSV import and export, migration from other wholesale plugins and an audit log. Everything is explained inside the plugin under Mercenza > Help.

Mercenza needs WooCommerce. Install and activate WooCommerce first, then install Mercenza from WordPress.org. If a requirement is missing, activation stops and the message names the unmet requirement.

The setup wizard configures the essentials in six steps: Welcome, Store access, Wholesale group, Wholesale discount, Applications and Done. It opens the first time you activate Mercenza and stays available from the dashboard checklist until you finish. You can use Back and Skip this step at any time, and nothing is shown to buyers until you decide.

1. Welcome: enter the name of the wholesale area shown in My Account (default B2B) and click Start setup.
2. Store access: choose between "Everyone can browse. Wholesale prices only appear for wholesale buyers." and "Only logged in visitors can browse. Everyone else is sent to the login page." The login, registration, privacy and terms pages always stay open. You can allow more pages later under Settings > Catalog.
3. Wholesale group: use an existing group or Create a new group, then choose how the group sees prices and whether it can buy online.
4. Wholesale discount: enter a Percent off the regular price for the whole catalog, or leave it empty to skip.
5. Applications: choose I review every application (recommended) or Approve everyone automatically. Approved buyers join the group you set up. If no page shows the application form yet, click Create the application page.
6. Done: a summary lists what is set up and what is left, with a link to each screen. Click Go to the dashboard.

Mercenza > Dashboard is your wholesale overview: what needs attention today, how the business is doing and the steps left to finish setup.

• Needs your attention: for example the number of applications waiting for review. A notice at the top of every Mercenza screen also links to pending applications.
• Last 30 days: wholesale revenue and order count, retail revenue, and your top wholesale customers.
• Recent notifications: new applications, group changes and other events.
• System health: checks for the database schema, custom tables, Action Scheduler, object cache, conflicting wholesale plugins, capabilities, the encryption key, outdated template overrides and pricing integrity. Click Open Tools for details and fixes to go to the diagnostics screen.

A WARNING on Object cache only means price resolution could be faster with Redis or Memcached on busy stores. Mercenza still works without it.

Mercenza > Customers lists every customer with their group, company, order count and amount spent. Use SEARCH and the GROUP filter (any group, No group, or a specific group), then click Filter.

• Select customers with the checkboxes to assign a group to many people at once.
• Click a name to open the profile, change the group or set Setting overrides for that one customer (any group setting can be overridden for a single customer).
• When a customer belongs to a company, the Group column shows "(via company)" and the Company column shows their role.

Log in as lets staff see the store exactly as that customer does. The session lasts one hour, a banner with a return link is shown on every page, and start and end are written to the audit log. Administrators and shop managers can never be impersonated, and attempts are rate limited under Settings > Security.

The WordPress user edit screen shows the same group selector, the company and a summary of overrides.

Customer groups decide who sees wholesale prices and which rules apply. Start with one group such as "Wholesale" and add tiers later. Open Mercenza > Customers > Groups and click Add group.

The group editor has five tabs: General, Settings, Members, Rules and Onboarding.

General

• Name, Slug (leave empty to generate it from the name), Description and Color tag.
• Priority: higher wins when rules for several groups match.
• Inherits from: a parent group. Settings left as inherit take the parent's value. A price set on a nearer group beats its parent.
• WordPress role sync: members receive this role for plugins that work with roles. You can pick an existing role or create a dedicated one.
• Default group for approved B2B registrations and Guest fallback group (visitors who are not logged in use this group). Only one group can hold each flag. The Groups list shows them as DEFAULT B2B and Guests.
• Status: inactive groups are ignored.

Settings (each can inherit from the parent)

• Ordering: Minimum order value, Maximum order value, Minimum order quantity, Maximum order quantity, Order notes required, Backorders (Product setting, Always allow backorders, Never allow backorders).
• Pricing and catalog: Price display (Wholesale price only, Retail struck through with wholesale, Wholesale with savings percentage, "Login to see prices", Hidden completely), Price suffix (for example "ex VAT"), Catalog mode (Normal shopping, Hide add to cart, Show enquiry button instead of add to cart, Read only browsing), Stock display (Exact quantity, In stock or low stock only, Hidden), Tax display (Store default, Including tax, Excluding tax).
• My Account: Buyer portal mode (an app like My Account with a quick order bar, live cart and keyboard shortcuts) and Allow recurring orders (on by default).

Members: add or remove members one by one.

Rules: assignment rules place customers into the group automatically by total spend, order count, email domain, billing country, a registration field value, a purchased product or a purchased category. Rules never override a manual assignment. They run when an order is completed or processing, when a user registers, and once a day for everyone.

Onboarding: emails sent after a customer is approved into the group, each with a subject, body, delay in days and active flag. You can use {first_name}, {last_name}, {group_name}, {site_title}, {my_account_url} and {shop_url}.

When you delete a group that has members, you choose where they go, for example No group (retail).

A company groups several users under one business with a shared group and address book. Open Mercenza > Customers > Companies, search with SEARCH COMPANIES, or click Add company.

A company record holds the legal name, trading name, VAT number, registration number, addresses and notes. Tax id and VAT number are encrypted at rest.

Members have one of these roles: Owner, Purchaser, Approver, Viewer or Custom. Each role maps to permissions: place orders, view company orders, manage addresses, manage sub accounts and edit the company profile. Custom roles pick permissions one by one, and each member can have an order limit (orders above it are blocked).

• A user belongs to at most one company.
• The owner cannot be removed or demoted. Change the owner on the company first.
• Owners and members who can manage sub accounts invite people by email from My Account > B2B > Sub accounts, or you invite them from this screen. The invitation link works once, expires after seven days and only works for a logged in user whose email matches the invitation.

Mercenza > Customers > Registrations is the approval queue for trade applications. Filter by STATUS (All, Pending, Approved, Rejected, with counts) and SEARCH EMAIL OR ANSWERS, then click Filter.

Click an applicant to see every submitted value, uploaded documents, the VAT status, consent records, internal notes and reviewer history. Select several rows to approve or reject them in bulk.

• Approve: the applicant joins the form's target group (or the default B2B group) right away and receives the approval email.
• Reject: pick a reason from the templates set under Settings > Registration or write your own. The reason is emailed to the applicant, and the account is deleted after the number of days in Delete rejected accounts after (days).

Applicants can follow their status under My Account > B2B > Application.

Mercenza > Customers > Forms holds the forms customers fill in to apply. A Wholesale application form is created on activation. Click Add form to create another one.

Each form has:

• Type: B2B forms put the approved user in the target group (or the group flagged as default for B2B registrations). B2C forms create a retail customer.
• Fields: text, textarea, email, password, phone, number, select, multiselect, radio, checkbox, date, file, country, state, address, VAT number, company name, business type, website, hidden, heading, HTML, consent, first name and last name. Each field has a label, placeholder, help text, required flag, width, validation rules and conditions. Every form needs an email field.
• Conditions: show a field only when other fields match. Hidden fields are never validated or stored.
• Steps: assign fields to steps and turn on Multi step for a progress indicator.
• Approval mode: manual review, automatic, email domain allow list, valid VAT number, or referral code (from a hidden field with id referral_code, filled from the ref link parameter). When an automatic mode does not match, the application falls back to manual review.
• Reviewer approvals required: more than one turns on multi reviewer approval.
• Settings: introduction, submit label, success message, pending page, redirect after approval, upgrade requests from logged in retail customers, login while the application is pending (use the default, block or allow), bot protection, allow disposable email domains, policy version recorded with consent, company creation on approval, and admin notification recipients.

The Shortcode column shows the code to place the form on a page, for example [mercenza_registration_form form="wholesale-application"]. You can also use the Mercenza Registration Form block.

Mercenza > Pricing sets wholesale prices per customer group. The Bulk editor tab lists products and variations with their Retail price and one column per group. Use FIND PRODUCTS (name or SKU) and Show groups to choose which groups appear.

In each cell, pick a price type and type an amount:

• = a fixed price for that group.
• % a percentage off the retail price.
• - an amount off the retail price.

Apply to every product on this page changes many products at once. Choose the GROUP, choose SET AS, enter the value and click Apply:

Remove group price clears the selected group's prices on the page. Nothing is saved until you click Save. Changed cells turn yellow, and you can use Undo to step back. Cells that fail are highlighted with the reason.

You can also set prices on each product's Mercenza tab in the product editor, including per variation prices and prices for one customer or company.

The Tiers tab under Mercenza > Pricing lists quantity breaks such as "10 to 49: 5% off". Click Add tier to create one, or Edit and Delete on a row.

A tier has:

• Scope: everyone, a group, a company or a customer.
• Target: a product, a variation, a category or the whole catalog.
• Quantity: the range, for example 10 to 49, or 50 and more.
• Price: a fixed price, a percentage off or an amount off the resolved price.
• Cumulative: per line, or counted across all variations of the product or across a whole category in the cart.

The most specific scope with a tier wins, then the most specific target. When Show tier table on product pages is on (Settings > Pricing), the product page shows a Volume pricing table and a "buy X more" hint. The cart uses the same tiers.

The Import and export tab moves prices and tiers in CSV files.

Import CSV: the columns are type (price or tier), sku or product_id (an id, category:ID or all), scope_type, scope (group slug, customer email or id, or company id), kind, amount, currency, starts_at, ends_at, min_qty, max_qty and cumulative. Choose the file and click Validate. Every row is checked and previewed before anything is written. The import then runs in the background, can resume, and reports errors per row. Recent imports lists past imports.

Export: click Download all prices and tiers (CSV).

The maximum number of rows per file is set in Settings > Pricing > CSV import row limit. With starts_at and ends_at you can schedule promotional prices or future increases ahead of time.

The Inspector tab (Price Resolution Inspector) explains any price. Pick a PRODUCT, a CUSTOMER (leave it empty to price as a guest) and a QUANTITY, then click Inspect.

The result shows the base price source, the tier, the rules that ran, the final price and the other candidates that were considered. Use it whenever a buyer reports a price you did not expect.

Prices are resolved in the order set in Settings > Pricing > Price source order: a customer price, a company price, a group price (or the nearest parent group with one), a group discount, a category rule, a catalog wide rule, and finally the regular price. Quantity tiers apply next, then dynamic rules.

Mercenza > Pricing > Rules holds automatic discounts and offers, for example "10 percent off for distributors", "buy 10 get 1" or "free shipping over 500". Rules run after explicit prices and tiers, highest priority first. Click Add rule to create one.

• Conditions: group, user, company, product, category, tag, attribute, cart subtotal, cart quantity, date range, day of week, first order, order count, lifetime spend, shipping country and currency.
• Actions: percentage discount, fixed discount, fixed price, buy X get Y, free shipping, gift product, and exclude from other rules.
• Priority, a stop processing flag, a total usage limit and a per customer limit.

The Uses column counts how often each rule was used in orders.

Mercenza > Pricing > Catalog controls who may see and buy which products. On the Visibility tab, click Add rule and choose:

• Who it applies to: Everyone, Guests (not logged in) or A customer group.
• What it targets: A product, A single variation, A category, A tag or A brand.
• The effect: Hide it, Show it, Show it, but block buying or Allow buying.

When several rules match, the most specific one wins: group beats guests beats everyone, and a variation beats its product, which beats its category, tag or brand. Use Show it to make exceptions inside a broader hidden rule.

Hidden products disappear from the shop, search, feeds, sitemaps, related products and the REST and Store API for that buyer. Opening one directly returns a 404 or redirects to the shop (see Settings > Catalog). Products that cannot be bought stay visible, and a cart line that becomes unavailable blocks checkout with a message.

You can also set an audience on a product's Mercenza tab (everyone, wholesale customers only, or retail customers only), or on a product category under Products > Categories with Mercenza audience. A category audience applies to all products in it and its child categories, and a product's own audience wins over its categories.

The Quantity rules tab sets minimum and maximum order quantities, steps (multiples) and pack sizes. Click Add rule, choose who it applies to and which products, then set at least one of minimum, maximum, step or pack size.

When several rules match, the most specific one wins for each limit: a group rule beats an everyone rule, and a variation beats its product, which beats its category. Quantity fields on a product's Mercenza tab apply to everyone.

A pack size implies the step and a minimum of one pack, and the product page shows "Sold in packs of X (price per pack)". Rules are checked on the product page, when adding to the cart, in the cart and at checkout, and in the Store API.

The Check a product tab (Check what a buyer sees) tells you whether a customer can see a product, buy it and order a given quantity. Pick a PRODUCT, a CUSTOMER (leave it empty to check as a guest) and a QUANTITY, then click Check. Use it to confirm visibility and quantity rules before you announce them.

Mercenza > Settings holds store wide rules. Pick a topic on the left, change what you need and click Save changes. Use FIND A SETTING to search for any setting by name. Every field has a description, a Learn more link and a way to reset it to its default.

The General topic covers labels, data retention and developer mode:

• B2B area label: the name of the wholesale area in My Account and in the admin menu badges.
• Keep data on uninstall: when on, deleting the plugin keeps its tables, settings and customer data so you can reinstall later. Turn it off only if you want everything removed when you delete the plugin. WooCommerce data and users are never removed.
• Developer mode: writes detailed logs to WooCommerce > Status > Logs under the "mercenza" source. Turn it off on production stores.
• Audit log retention (days): entries older than this are deleted by the daily maintenance task. Between 30 and 3650 days.

The Pricing topic controls how wholesale prices are resolved, shown and combined with coupons.

• Price source order: the order in which price sources are checked, highest priority first. Allowed values: customer, company, group, group_discount, category, global, regular. Unknown entries are ignored and missing ones are added at the end.
• Base price for discounts: Regular price, or Sale price when set to start percentage and amount discounts from an active sale price.
• Coupons with wholesale prices: Allow coupons on wholesale prices, Block coupons for wholesale customers, or Apply coupons to the retail price only. This applies to customers in a group.
• Show tier table on product pages: shows quantity tiers with the active tier highlighted and a hint toward the next tier.
• Email customers about price changes: when a group price changes, customers in that group who bought the product get one email per product, sent in a batch a few minutes after the change.
• Price cache lifetime (minutes): how long resolved prices are cached. The cache is cleared when prices, rules, groups or products change. The lifetime also limits how late a scheduled price can start.
• CSV import row limit: the maximum number of rows per import file.

The Catalog topic covers store access, enquiries and the wholesale shop page.

• Require login to view the store: visitors who are not logged in are sent to the login page, except on the allowed pages.
• Pages allowed without login: comma separated page ids. The login, registration, privacy and terms pages are always allowed.
• Enquiry link: where the "Enquire" button points for groups in enquiry catalog mode. When empty, it uses the My Account application page.
• Wholesale shop page: the id of the page that holds the [mercenza_shop] shortcode. Wholesale members are offered it instead of the retail shop, for example when they return from an empty cart.
• Hidden product behavior: what happens when a buyer opens a product hidden from them: Not found (404) or Redirect to the shop page.

The Ordering topic covers the quick order form, barcode lookup, reorders and recurring orders.

• Quick order rows per page: how many products the quick order table loads at a time (5 to 200).
• Allow guests to use the quick order form: when off, visitors are asked to log in first.
• Barcode lookup field: which product field a scanned or typed barcode matches: GTIN, UPC, EAN, or ISBN field, SKU, or GTIN first, then SKU.
• Show "Add to list" on product pages: logged in buyers can save a product to a shopping list from its page. When off, lists stay available in My Account.
• Show reorder actions: adds a Reorder button to past orders and a frequently purchased panel to My Account.
• Recurring order payment: how scheduled orders are paid. Create a pending order and email a payment link creates each due order as pending payment and emails the customer an invoice.

The Notifications topic controls in app notifications and messages to Slack and Microsoft Teams.

• In app notifications: shows a notification bell in My Account and in the admin bar. Store staff receive new registrations, and customers receive updates about their application.
• Keep notifications for (days): older notifications are deleted by the daily maintenance task (7 to 3650 days).
• Slack incoming webhook URL and Microsoft Teams incoming webhook URL: paste the URL of an incoming webhook. Both are stored encrypted. The field shows "Enter a value to replace the stored one" and a Show link.
• Events sent to Slack and Teams: only the selected events are posted. In this edition the event is New B2B registration. Use Select all or Select none.

Set up a channel

1. Create the incoming webhook in Slack or Teams and copy its URL.
2. Paste it in the matching field.
3. Tick the events to send.
4. Click Save changes.

Nothing is sent until you add a URL. Each selected event posts a short message with a title, a summary, a few facts (such as the customer or company name) and a link back to your admin. To check the setup, submit a test application on your registration page and confirm the message arrives.

Mercenza also adds webhook topics under WooCommerce > Settings > Advanced > Webhooks, for example registration received, approved or rejected. WooCommerce delivers them to the URL you enter there.

The Security topic covers rate limits and how visitors are identified.

• Trust reverse proxy headers: use X-Forwarded-For, CF-Connecting-IP or X-Real-IP to identify visitors for rate limiting and audit entries. Turn it on only behind a trusted proxy, such as Cloudflare or a load balancer, that overwrites these headers on every request.
• REST list requests per minute: the maximum list requests one user or IP can make to Mercenza REST endpoints per minute.
• Registration attempts per hour per IP: the maximum B2B registration submissions from one IP address per hour.
• Log in as customer attempts per hour: the maximum impersonation attempts per admin user per hour.
• VAT validation calls per hour per IP: the maximum live VAT number checks from one IP address per hour.

Set any limit to 0 to turn it off.

The Registration topic covers bot protection, email rules, uploads and approval housekeeping for registration forms.

Captcha

Every form already has a honeypot field and a signed timing check (forms sent faster than three seconds or older than a day are refused). CAPTCHA PROVIDER adds a bot check from an outside provider:

To set up a provider:

1. In the provider's dashboard, create keys for your site.
2. Choose the provider in CAPTCHA PROVIDER.
3. Paste the public key in Captcha site key and the private key in Captcha secret key. The secret key is stored encrypted and never shown again after saving.
4. For reCAPTCHA v3, adjust reCAPTCHA v3 minimum score if needed.
5. Click Save changes, then submit a test application on your registration page.

The provider's script only loads when a provider is selected. On submit, the visitor's captcha response, IP address and your site address are sent to the provider for verification.

VAT numbers

Check VAT numbers online is off by default. When on, an EU VAT number is checked with the European Commission's VIES service and a UK number (starting with GB) with HMRC's "Check a UK VAT number" API. The check runs when the applicant pauses typing and again on submit, the result (valid, invalid or unknown) is stored with the application, and a valid result is cached for a day. When off, nothing leaves your site and VAT numbers are reviewed manually. Numbers from Australia, New Zealand, the United States, India and Canada are checked for the right format on your own site.

Email rules

• Block disposable email domains: refuses registrations from known throwaway email providers. Individual forms can allow them.
• Additional blocked domains: one domain per line, added to the bundled list.
• Always allowed domains: one domain per line. Overrides the block list.

Uploads

• Maximum upload size (MB): applies to registration documents unless a field sets its own limit.
• Allowed upload extensions: comma separated. Executable and script types are never allowed. Files are stored in a protected folder under random names, and only the owner or staff who can approve registrations can download them.

Approval housekeeping

• Delete rejected accounts after (days): accounts created by a rejected application are removed after this period unless approved later or they placed an order. 0 keeps them.
• Block login until approved (default): the default for forms that do not set their own login gate.
• Rejection reason templates: one reason per line, offered when you decline an application.

Mercenza > Settings > Tools holds health checks, CSV import and export, migration from other wholesale plugins and settings transfer.

The Diagnostics tab shows:

• Self diagnostics: database schema, custom tables, Action Scheduler, object cache, conflicting plugins, capabilities, encryption key, template overrides and pricing integrity (recent orders with a price snapshot compared with their stored totals).
• Actions: Run pending migrations (with the current schema version), Flush Mercenza caches (clears cached settings, groups, prices and catalog visibility) and Sync capabilities (re-adds every Mercenza capability to Administrator and Shop Manager).
• Environment: Mercenza, PHP, WordPress and WooCommerce versions, HPOS status, object cache, next maintenance run and encryption key id.
• Tables: every Mercenza table with its row count.

The Import tab imports CSV files. Choose WHAT TO IMPORT: Customers with group, Companies, Sub accounts, Registration submissions, Pricing rules, Group prices, Customer prices or Tiered prices. The columns for the chosen type are listed under the selector (fields marked with * are required).

1. Choose the file and click Upload and map columns.
2. Map the file's columns to the importer's columns. Headers that match are mapped for you.
3. Run a dry run to validate every row and download the error report.
4. Start the import. It runs in the background in chunks of 100 rows, survives timeouts and resumes from the last processed row.

Groups can be referenced by slug, name or id, customers and owners by email, and products by SKU or id.

The Export tab downloads the same record types as the importer: choose WHAT TO EXPORT (customers, companies, sub accounts, registrations, pricing rules, group prices, customer prices or tiers) and click Download. Files use the columns the importer accepts, so a file exported on one site can be imported on another.

The WooCommerce product exporter and importer also gain columns for Mercenza group prices, tiers and the minimum, maximum, step and pack size quantity rules.

The Migrate tab detects data from B2BKing, Wholesale Suite, WholesaleX and Whols. The Detected column shows whether data was found.

1. Click Preview to see what would move (groups, customers and prices).
2. Click Migrate. A rollback point is created first, and groups, customer assignments and fixed product prices are migrated.
3. If needed, restore a rollback point from the Rollback points panel.

Tiers and dynamic rules of other plugins are not migrated. Recreate them under Mercenza > Pricing.

The Settings transfer tab exports every setting except secrets as signed JSON.

• Export: optionally enter a PASSPHRASE (OPTIONAL) and click Download settings JSON. Without a passphrase the file can only be restored on the same site. With a passphrase it can move between sites.
• Import: enter the same passphrase, paste the file content into PASTE A SETTINGS JSON DOCUMENT TO IMPORT and click Import settings.

Imports are refused when the signature does not match, when the plugin or format differs, or when the file was made by a newer Mercenza. Keys that fail validation on the target site are skipped and reported. Secrets such as captcha and webhook keys are not included, so enter them again on the new site.

Mercenza > Settings > Audit Log records who changed what and when: approvals, prices, settings and log in as customer sessions. The log is append only.

Filter by EVENT (for example registration.approved, price.set or settings.updated), SEARCH, CHANGED BY, FROM (UTC) and TO (UTC), then click Filter. Click "field(s) changed" in the Changes column to see a diff. Export CSV downloads the filtered entries. Entries older than Audit log retention (days) are deleted automatically.

Mercenza > Help holds the complete documentation inside WordPress. Use FIND A TOPIC to search, and each guide has its own table of contents. Topics include Getting Started, Groups, Customers, and Companies, Registration, Pricing Engine, Catalog and Ordering Rules, Bulk Ordering, Lists, Reorders, and Recurring Orders, Emails, Notifications, and Webhooks, Import, Export, Migration, and Tools, Templates, WP-CLI Commands and the REST API.

Every screen also has a Guide for this screen link and a Help tab in the top right corner, and every setting has a Learn more link that opens the matching guide.

Every Mercenza email is a WooCommerce email. Find them under WooCommerce > Settings > Emails with names starting with "Mercenza:". They cover: registration received, new application (for the store team), registration approved, registration rejected, account already exists, onboarding steps, group changed, sub account invited, sub account permissions changed, and price change.

Each email has the standard fields: Enable/Disable, Subject, Email heading, Additional content, Email type (Plain text, HTML or Multipart), Cc(s) and Bcc(s). The Email preview shows the email, and Send a test email sends it to you.

• Mercenza: application received is sent to the customer when a wholesale application is received and waits for review.
• Mercenza: sub account invited is sent when a company invites someone to join as a sub account. It contains an Accept invitation button and the link's expiry date.

When someone registers with an email that already has an account, they see the same success message as a new applicant, and the account holder receives the "account already exists" email instead. To change the layout, copy the template files to yourtheme/mercenza/emails/.

The quick order form lets buyers add many products at once. Place [mercenza_quick_order] or the Mercenza Quick Order block on a page. It is also available under My Account > B2B > Quick order.

• The table lists only products the buyer may see, with their price, stock text and quantity rules. Variations appear on their own rows.
• Buyers search by name or SKU, filter by category, type quantities and click Add all to cart. Hidden, unavailable and off rule quantities are refused with the same messages as the product page.
• SKU quick entry: paste lines like ABC-123, 12 (comma, semicolon, tab or space separated, up to 500 lines) or upload a CSV. Duplicate SKUs are merged and unknown SKUs are reported.
• Barcode: on browsers that support it, "Start camera" scans with the device camera. Other browsers get a plain code input. Settings > Ordering decides which product field the code matches.
• Save quantities to a list saves the entered quantities to a shopping list.

Guests can use the form only when Allow guests to use the quick order form is on. On phones, rows collapse into a two column grid.

The [mercenza_shop] shortcode shows a separate wholesale shop: the products the buyer may see, category links, the buyer's prices and pagination.

1. Create a page, for example "Wholesale shop", and add [mercenza_shop].
2. Publish it and note its page id.
3. Enter the id in Settings > Catalog > Wholesale shop page and save.

Wholesale members are then offered this page instead of the retail shop, for example when they return from an empty cart.

Approved buyers get a B2B tab in My Account (the label comes from B2B area label). It follows your theme and has four parts: Overview, Shop, Company and Account.

• Overview: a welcome with the buyer's group, company and role, plus counts of items in the cart, shopping lists and unread notifications. A "Frequently purchased" panel appears when reorder actions are on.
• Shop: My products (products with a price negotiated for the account), Quick order, Shopping lists and Recurring orders.
• Company: Company (profile and address book) and Sub accounts (invite colleagues and choose what each can do).
• Account: Notifications and Application (the wholesale application and its status).

Shopping lists can be private or shared with the company. A list goes into the cart in one click. Recurring orders (for groups with Allow recurring orders) schedule repeat orders from a list weekly, every two weeks, monthly or every N days. The daily maintenance task creates each due order at the customer's current prices, sets it to pending payment and emails the invoice. Schedules can be paused, resumed or deleted.

To change the look, copy any file from the plugin's templates folder to yourtheme/mercenza/ and edit the copy.

Shoppers who are not in a group see your normal store. Approved wholesale buyers see their own prices everywhere: in the shop, on product pages, in the cart and at checkout.

• Shop and product pages: depending on the group's Price display, buyers see the wholesale price only, the retail price struck through, a savings percentage (for example "Save 25%"), "Login to see prices", or no price. A Price suffix such as "ex VAT" can follow the price.
• Volume pricing: product pages with quantity tiers show a table of quantities and unit prices, with a hint such as "Buy 9 more to save" that follows the quantity.
• Add to list: logged in buyers can save a product to a shopping list.
• Wholesale info: products with lead time, case dimensions and weight, HS code, country of origin or custom fields show a Wholesale info tab.
• Packs and limits: products with a pack size show "Sold in packs of X (price per pack)". Minimums, maximums and steps are checked in the cart.
• Catalog modes: groups in hide cart or enquiry mode cannot add to cart (enquiry mode shows an "Enquire" button), and read only groups are sent back from the cart and checkout.
• Trade account application: the registration form collects the details you configure, for example name, company, business type, VAT number (with the two letter country code), business address and a consent checkbox. After submitting, the applicant sees a confirmation and can follow the status in My Account.