How Do I Manage Entities?
Entities are the people and companies linked to a case. A company onboarding case might have a dozen entities — the company itself, its directors, UBOs, and shareholders. This guide explains how to navigate, manage, and track verification status for all of them.What you’ll learn
- How to read the entity panel and UBO tree
- What each entity role means for required checks
- How to view an entity’s verification status
- How person cases work for individual entities
- How cross-case entity history works
The entity panel
When you open a case, the entity panel shows all linked entities in two views:- UBO Tree View
- List View
The tree view shows the ownership and control structure:
- Root node — the primary entity (company)
- Branch nodes — directors, UBOs, and shareholders, connected by lines showing their relationship
- Ownership percentages — displayed next to UBO nodes
- Status indicators — colored dots showing each entity’s verification status
What does each entity role require?
The entity’s role determines which checks are automatically created:| Check | Primary (Company) | UBO | Director | Shareholder |
|---|---|---|---|---|
| PEP/Sanctions Screening | Required | Required | Required | Required |
| Adverse Media | Required | Required | Required | — |
| Identity Verification | — | Required | Required | Required |
| Address Verification | — | Required | — | — |
| Source of Wealth | — | If High Risk | If High Risk | — |
If a UBO or director is flagged as high risk during screening, additional checks (Source of Wealth, Enhanced Due Diligence) are automatically added to their requirements.
How do I view an entity’s verification status?
Click an entity in the tree or list view to open its detail panel. The panel shows:- Overall status — a summary badge: Pending (grey), In Progress (blue), Verified (green), Failed (red), Expired (orange)
- Check progress — a breakdown of each check type with its current status
- Document progress — which documents have been received and which are still outstanding
- Alerts — any open alerts related to this specific entity
- Verified — all required checks are Complete with a Pass result
- Failed — any required check has a Fail result that has not been resolved
- In Progress — at least one check is running or pending
- Expired — a previously verified entity whose checks have passed their validity period
What are person cases?
When a company case includes individual entities (UBOs, directors, shareholders), the system automatically creates person cases for each one. Person cases:- Track the individual’s verification independently
- Can be shared across multiple company cases (if the same person appears in multiple companies)
- Are linked back to the company case via a relationship field
How does cross-case entity history work?
Zenoo tracks verification at the entity level, not just the case level. This means:- Reused checks — if an entity was verified recently (within the validity period), new cases can reuse those check results instead of running them again. Reused checks show a “Reused” badge with the source case name.
- Entity-level status — each Account and Contact in Salesforce has an overall verification status that reflects their latest checks across all cases.
- Verification history — click “View History” on an entity to see all past checks across all cases, with dates, results, and validity periods.