Feature · Account Hierarchy

B2B account & user structure built for how companies buy: Accounts, Users, Roles, shared Address Book, and Credit Limits.

Map your real-world customer organizations to a hierarchical Accounts → Users model with shared address books, hundreds of role-based permissions, Account Balances and Credit Limits for pre-paid contracts, and complete Sales-Group visibility. A CFO, a buyer, and a procurement manager at the same company each see exactly the orders, invoices, and credits they're supposed to. Synced bi-directionally to your ERP source of truth through Clarity Connect.

1 : Many Account → Users
Hundreds Role-Based Permissions
Shared Account-Level Address Book
25+ ERP Customer Masters Synced
Real-time Bi-Directional Sync

What is Account Hierarchy in Clarity eCommerce?

B2B accounts typically mean singular companies with multiple contacts. Account Hierarchy in the Clarity eCommerce Framework is the data model that connects companies ( Accounts ) to the people who buy on their behalf ( Users ), with shared address books, hundreds of role-based access controls, account-level credit, and Sales-Group lifecycle traceability. In CEF, an Account represents the company. A User is an individual contact with their own login. Multiple Users can be associated with a single Account, but each User belongs to exactly one Account. This account-as-anchor model lets you grant access, apply pricing, share addresses, manage credit, and trace orders at the entity that actually holds the contract, not at the individual person.

So why does this affect the eCommerce platform? This pattern matters because B2B procurement is fundamentally a team sport. A single customer relationship typically spans a buyer who shops, a manager who approves, a finance lead who pays, an AP clerk who reconciles, and a CFO who oversees. Generic consumer-grade carts assume one shopper, one cart, one card. They break the moment a procurement team tries to use them. Account Hierarchy fixes that by giving every member of the buying team their own login with their own permissions, all rolling up to the Account that has the commercial relationship with you.

The division of entities with specific role-based access assignments is key to making this all work. Account Hierarchy is a core component of the Clarity eCommerce Framework's B2B layer, working alongside Customer-Specific Pricing (which uses the Account to determine which tier or contract applies), the Customer Portal (which surfaces shared data to every authorized User), and the Sales-Group spine that threads quotes , orders , and invoices into one auditable transaction history.

The problem: B2B procurement is a team sport, and generic carts don't know that.

Single-shopper consumer carts force B2B procurement teams into ugly workarounds: shared logins, side-channel emails, spreadsheet reconciliation, and the eternal “let me CC my manager.” The friction is real, quantifiable, and entirely avoidable with the right account model.

Step-by-step walkthrough

Setup Workflow

Standing up an Account Hierarchy from scratch

Seven steps from creating the first Account to bulk-onboarding your full customer base.

1

Create the Account record

In the Admin Portal Accounts module, create the master Account record for the company. Capture Company Name, Key / ID, Description, Tax Exemption Number, and Tax Entity Use Code. The Account holds every commercial term that should flow to every User on the team.

2

Add Users under the Account

Create User records for each contact at the company: First Name, Last Name, Display Name, Phone, Fax, Email. Multiple Users can be associated with a single Account, but each User belongs to exactly one Account.

3

Assign Roles and permissions

The Roles module exposes hundreds of granular access points. Assign each User the Role that matches their job (buyer, viewer, manager, finance, super-admin) with the permissions that role requires and nothing it doesn't.

4

Build the shared Address Book

Add the Account's billing and shipping addresses. Entries are shared across all Users under the Account and dynamically populate the Payment Sections of both Checkout and the Invoice Details page. Add once, everyone sees it.

5

Apply customer-specific pricing

Tag the Account with the appropriate pricing tier or contract. The Multi-Tiered Pricing engine applies the right prices the moment any User on the Account logs in, including quantity-break tiers and account-specific overrides.

6

Set Account Balance and Credit Limit

For pre-paid contract customers, set the Account Balance and Credit Limit so any authorized User can complete checkout using Account Credit. Manage limits in the Admin Portal or sync them from your ERP customer master through Clarity Connect.

7

Bulk-import your existing customer base

Onboard your existing B2B customers via the Import Customers / Users workflow: one spreadsheet of Accounts, one of Users, role assignments inline. Thousands of customer relationships transferred from a legacy cart or ERP in a single import.

Benefits & business impact: what a real account model delivers.

Getting Account Hierarchy right does more than clean up your data model. It reshapes how your B2B customers interact with you, how your AR team operates, and how predictable your sales cycle becomes.

Faster procurement throughput

Every member of the procurement team buys with their own login and their own permissions. No more “send the password to John,” no more email approvals copy-pasted into the cart, no more weekly delays waiting for one shared user to be free.

Audit trail that holds up

Every order is attributed to the specific User who placed it. Sales Groups tie quotes, orders, sub-orders, and invoices into one chain. Compliance and finance audits get clean answers without forensic spreadsheet work.

Customer-specific pricing accuracy

Because pricing tier and contract live on the Account, every User on that Account sees the right prices automatically. No more “buyer A got the right price but buyer B got list” phone calls.

CFO & finance visibility

A finance-Role User on the Account sees every open quote, every order in flight, every invoice due, and every dollar of pre-paid credit remaining, without ever having placed an order themselves.

Eliminated shared-login risk

Shared logins are a compliance and security disaster: no accountability, no audit, no easy way to deactivate a former employee. Per-User logins under the Account close that hole without slowing the team down.

Scales to thousands of accounts

Whether you're onboarding 50 distributors or 5,000 enterprise customers, the model holds: bulk import gets you live fast, ERP sync keeps records aligned, and role-based access keeps every customer's team operating cleanly.

The people who benefit span every B2B persona: buyers get a clean account-aware experience without re-keying their own context every visit, managers get approval visibility without becoming a bottleneck, finance teams get audit-ready order and invoice history, CFOs and controllers get the panoramic view they need without having to do the buying themselves, and your own sales and AR teams stop spending hours each week patching up problems that exist only because the account model wasn't right to start with.

Frequently asked questions

What is Account Hierarchy in Clarity eCommerce?
Account Hierarchy is the data model that connects companies (Accounts) to the contacts who buy on their behalf (Users). One Account represents the company. Each User is an individual with a login. Multiple Users can be associated with a single Account, but each User belongs to exactly one Account. Accounts carry the shared Address Book, customer-specific pricing tier, Account Balance / Credit Limit, and Tax Exemption profile, so every User on the Account inherits the same commercial terms automatically.
How many Users can be associated with one Account?
There is no hard limit. A single Account can have anywhere from one User (a sole proprietor) to dozens of Users (large enterprise customers with separate buyers, approvers, finance staff, and read-only auditors). Account-level data (addresses, pricing, credit, payment methods stored in the PCI-compliant Wallet, and Sales-Group visibility) is shared across every User on the Account.
Can different Users on the same Account have different permissions?
Yes. The Roles module exposes hundreds of granular access points across the storefront and admin portal. A buyer Role can place orders. A viewer Role can browse and view past activity but not buy. An approver Role can review and release staged orders. A finance Role can pay invoices and apply account credit. A super-admin Role can manage other Users on the Account. Custom Roles are highly configurable, so the same Account can host a procurement team with very different responsibilities under one commercial relationship.
How does the shared Address Book work?
Address Book entries are shared across all Users under the Account and dynamically populate into the Payment Sections of both Checkout and the Invoice Details Page. If your customer's procurement office adds twelve approved Ship-To locations (regional warehouses, branch offices, job sites), every User on that Account picks from the same twelve. New addresses added by one User are immediately available to everyone else on the Account. No retyping, no rogue addresses.
What are Account Balances and Credit Limits used for?
Account Balances and Credit Limits support B2B pre-paid contracts, line-of-credit arrangements, and account-credit checkout. The customer pays a deposit (or has an open line of credit), and any User on the Account can complete checkout using Account Credit instead of a card or ACH. Balances and limits are manageable in the Admin Portal or, with Clarity Connect, synced from your ERP's customer master so the storefront stays in step with finance.
How do Sales Groups thread quotes, orders, and invoices together?
Sales Groups maintain the relationship across the full transaction lifecycle: a quote request becomes an order, which can split into multiple sub-orders, which generate invoices, all threaded into one Sales Group. Any User on the Account can enter at any stage and see the whole chain. A CFO who receives an invoice can immediately see what was bought, where it shipped, what stage each line is at, and which buyer placed the order. No phone calls or spreadsheets required.
How does Account Hierarchy sync with my ERP customer master?
Clarity Connect syncs Accounts, Users, contracted pricing, Account Balances, Credit Limits, and Address Book entries bi-directionally with your ERP's customer master. Parent-child hierarchies common in tier-supply chains, EDI mailbox IDs, quality / contract flow-down requirements, and Sales-Group lifecycle data all flow through Connect. The ERP stays the system of truth for AR. The storefront is the buyer-facing self-service layer with consistent customer data on both sides. Supported ERPs include SAP S/4HANA / ECC, Oracle NetSuite / EBS / JDE, Microsoft Dynamics 365 (Business Central, F&O), Sage Intacct / X3 / 100, Acumatica, Epicor Kinetic, Infor CloudSuite / M3 / SyteLine, SYSPRO, and many more.

Related features

See it with your accounts

Bring your customer base. Walk away with a working Account Hierarchy preview.

Schedule a 30-minute walkthrough and we'll show Account Hierarchy running against a sandbox of your own customers and Users, with the right pricing tiers, the right Address Book entries, the right Roles, and a live feed from your ERP customer master through Clarity Connect. Pre-paid Account Credit, Sales-Group lifecycle, hundreds of role permissions: whatever your B2B procurement model needs is already built in.

1,600+B2B Clients
25+ERPs Synced
Real-timeBi-Directional Sync