Documentation
Customers Admin Guide
What this page controls
The Customers area is where you create and manage buyer companies for your wholesale portal. From here you can maintain billing and shipping details, set order minimums and credit terms, assign price lists, manage buyer user access, and review recent account changes. Everything here applies to the selected customer across your catalog and orders.
Quick start
- Open the Customers page to see your list.
- Use the search box to find by Code, Name, or Email. Optional filter: Active only.
- Click + New Customer to create a record, or select an existing customer to edit.
- Fill in billing and shipping details, set Order Minimum, choose Credit Terms, and (optionally) set a Credit Limit.
- Assign a Default Price List and add Tags for segmentation.
- Add buyer users under Buyer Users: you can create a new login or link an existing buyer account and choose whether they are an admin.
- Save changes with Save Customer. You can come back at any time to update details.
Customers list view
Use this page to browse, search, and sort customers. Each row shows key info and quick actions.
- Search: Type part of a code, name, or email.
- Filters: Show All, Active, or Inactive customers.
- Sorting: Click any column header (Code, Name, Email, Order Min, Terms, Balance, Active).
- Paging: Use First / Prev / Next / Last to move through results. Page size is adjustable.
- Balance: Shows the sum of open (not paid/void) invoices for that customer.
- Manage: Opens the full customer editor. Activate/Deactivate toggles visibility for ordering.
Creating or editing a customer
Details
- Code and Name are required. Codes must be unique per account.
- Email and Phone are optional; they are helpful for invoices and sales communication.
Billing & Shipping
- Enter full billing address; use shipping address if different.
- You can add additional ship-to locations after saving (see Ship-To Addresses below).
Terms & Minimums
- Order Minimum: Dollar amount required to place an order.
- Credit Terms: Choose PREPAID, NET15, NET30, NET45, or NET60.
- Credit Limit: Optional. Leave blank for no limit.
- Default Tax Rate (%): Optional per-customer default such as 8.25. If the account has a resale certificate, check Resale/Tax Cert On File to treat orders as tax-exempt.
- Credit Hold: When checked, net terms are blocked and the buyer must prepay.
Pricing
- Default Price List: Sets the fallback price tier for this customer.
- Customer-specific prices and volume pricing still override the list when present.
Sales reps
- After saving, you will see assigned sales reps, if any, for quick reference.
Tags & Internal notes
- Tags: Comma-separated keywords like vip, key-account, tax-exempt.
- Internal Notes: Freeform notes visible to your team only.
Buyer users for a customer
Buyer users are the logins your customer uses to sign in, place orders, and see invoices.
Add a user
- Create New: Enter email, first/last name, and a temporary password. Choose whether they are an admin.
- Link Existing: If the buyer already has a login under your account, you can link it to this customer and optionally grant admin.
Admin vs non-admin
- Admin buyers can invite/manage additional buyers for their company and may see more order history.
- Toggle admin on or off at any time.
Enable / disable access
- Use Enable or Disable to control a buyer’s access for this customer without deleting the login.
- If a user’s account itself is suspended, their link will show as suspended.
The bottom of the section shows Recent Buyer User Changes so you can audit who linked, activated, or changed admin status.
Price lists and overrides
- Default Price List: Sets a base price tier for the customer.
- Customer Prices: Specific product overrides (if configured) take precedence.
- Volume Pricing: Quantity-based tiers can be global or customer-specific and apply automatically when the quantity threshold is met.
Understanding balances
The Balance column in the list view shows the total of open invoices (not paid or void). This helps you spot accounts with A/R exposure before shipping new orders.
CSV import tips
- Customer Code must be unique per customer.
- Supported credit terms: prepaid, net15, net30, net45, net60.
- Leave credit_limit blank if not used.
- You can assign price lists after import if your import does not include them.
Security and access
- Only users with role owner or staff can use this page.
- Session timeouts and subscription status are enforced before access is granted.
- All sensitive field changes are recorded for auditing (order minimum, terms, limits, tax rate, active status, price list, credit hold, resale cert, shipping defaults, notes).
Troubleshooting
- Cannot save customer: Check for required fields (Code, Name) and duplicate codes.
- Credit terms rejected: Only prepaid, net15, net30, net45, net60 are allowed.
- Buyer cannot log in: Ensure the buyer’s user account is active and the customer link is enabled. Also confirm the customer itself is Active.
- Tax rate error: Use a number up to two decimals (e.g., 8.25). Leave blank to unset.
- Price not as expected: Check for customer-specific pricing and volume pricing that may override the default price list.
Field reference
| Field | What it does | Notes |
|---|---|---|
| Code | Unique identifier for the customer | Required; must be unique |
| Name | Customer company name | Required |
| Order Minimum | Minimum order amount | Numeric, two decimals |
| Credit Terms | Payment terms | PREPAID / NET15 / NET30 / NET45 / NET60 |
| Credit Limit | Optional maximum A/R | Leave blank for none |
| Default Tax Rate (%) | Tax rate applied by default | Blank = unset; use up to two decimals |
| Resale/Tax Cert On File | Marks customer as tax-exempt | Orders treat tax as exempt |
| Credit Hold | Blocks net terms | For risk control |
| Default Price List | Sets base pricing tier | Overrides: customer prices & volume pricing |
| Tags | Keywords for segmentation | Comma-separated; lowercased |
| Active | Enables ordering and visibility | Deactivate to hide from ordering |