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.
Prerequisites
Section titled “Prerequisites”- 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.
Create a company
Section titled “Create a company”-
Go to B2B → Companies and choose Add company.
-
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,activeorsuspended— starts at pending -
Save. The company appears in the list with a member count of zero.
-
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.
Statuses
Section titled “Statuses”| 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. |
Add members
Section titled “Add members”A member is an existing customer plus a role.
-
On the company, open the Members tab and choose Add member.
-
Search for the customer by name or email and pick them.
-
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 -
Add. The member appears with their role and their ship-to scope.
Restricting ship-to addresses
Section titled “Restricting ship-to addresses”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.
Addresses
Section titled “Addresses”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.
VAT validation
Section titled “VAT validation”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.
Creating an order for a company
Section titled “Creating an order for a company”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.
Common problems
Section titled “Common problems”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.
