Skip to content

Companies & buyers

A company is the trade customer you have an agreement with. A member is a person at that company who may buy on its terms. Keeping the two separate is what lets five people at one buyer share one price list, one credit limit and one approval chain while each signs in with their own account.

Plans: B2B, B2B Growth, Enterprise

Requires app: B2B & Wholesale. Install B2B & Wholesale from Settings → Apps before these screens appear.

  • The Wholesale app installed, and a plan that includes b2b.companies.
  • The people you want to add as members already exist as customers in your store. A membership links an existing customer; it does not create an account.
  1. Go to B2B → Companies and choose Add company.

  2. Fill in the fields:

    Field Required Notes
    Name Yes What you call them day to day; up to 255 characters
    Legal name No The registered entity, for documents
    Tax ID No VAT or tax number, up to 64 characters
    Status Yes pending, active or suspended — starts at pending
  3. Save. The company appears in the list with a member count of zero.

  4. Open the company to reach its seven tabs: Members, Addresses, Pricing, Catalog, Approvals, Credit and Tax exemptions.

The Companies list can be searched by name and filtered by status, which is the fast way to find the companies still waiting to be activated.

Status What it means for buyers
pending Set-up state. Members do not get contract pricing yet.
active Live. Members get contract pricing, the assigned catalog and credit terms.
suspended Switched off without deleting anything — use this rather than deleting a company you may reinstate.

A member is an existing customer plus a role.

  1. On the company, open the Members tab and choose Add member.

  2. Search for the customer by name or email and pick them.

  3. Choose a role:

    Role Can place orders Can approve orders Ship-to restriction
    Buyer Yes No Can be restricted to chosen addresses
    Approver Yes Yes, where the policy routes to them Can be restricted
    Admin Yes Yes Never restricted — always all addresses
  4. Add. The member appears with their role and their ship-to scope.

A buyer with no restriction may ship to any of the company’s addresses. To tie a branch manager to their own branch, use Locations on their row and pick the addresses they may use. The Members table then shows how many addresses they are restricted to, instead of “All addresses”.

Admins cannot be restricted. If you need an admin limited to one site, make them an approver or a buyer instead.

The Addresses tab holds the company’s shipping and billing addresses.

Field Notes
Type shipping or billing
Label A human name like “Main warehouse” — this is what buyers pick from
Line 1 Address autocomplete fills the rest of the fields when you pick a suggestion
Line 2, city, state, postal code, country Standard address fields
Default One default per company

Give every address a clear label. A buyer choosing between “Main warehouse” and “Southside store” makes fewer mistakes than one choosing between two street addresses.

The company header carries the VAT/tax ID, a two-letter VAT country and a Validate VAT action. The validation status is shown as a badge and starts at unchecked.

Validation records whether the number checks out, which is what you want on file before you invoice a business. It does not by itself change the tax charged — that follows your market and tax settings, plus any certificate on the Tax exemptions tab.

An active company’s page has a Create order action, so you can place an order on a buyer’s behalf — the phone-order case. The order is created against the company, so it uses the company’s contract prices and counts against its credit.

The customer does not appear in the member search. They have no customer account yet. Create the customer first, then add the membership.

A member sees retail prices. The company is still pending, or the buyer has the storefront switch set to buy personally rather than as the company.

A buyer cannot pick the address they need. They are restricted to a subset. Open Locations on their row and add the address, or clear the restriction.

Remove is greyed out on an admin’s Locations button. Admins have no address restriction by design, so there is nothing to edit.

Deleting a company is not what you want. Set it to suspended. The history, invoices and ledger stay intact and you can reinstate it by flipping the status back.

What is the difference between a customer and a company member? The customer account is the person who signs in. The membership links that person to a company in a role. Remove the membership and the person still has their customer account — they simply stop buying on the company’s terms.

What do the three member roles do? Buyer places orders. Approver can also sign off orders that your approval policy routes to them. Admin can do both and is never restricted to specific ship-to addresses.

Why is a company pending instead of active? Pending is the staging state — you can set everything up while the buyer still sees retail prices. Contract pricing and company checkout start only when the company is Active.

Does validating a VAT number change the tax charged? Validation records whether the number checks out, which is what you need on file. Tax treatment itself follows your market and tax settings, and any exemption certificate on the company’s Tax exemptions tab.