CustomerUnifiedListItem
One row in the advisor's unified customer directory: identity, source, location, and timestamps for listing and navigation.
This page contains
Fields
| customerId: ID! | Stable identifier for this customer within the advisor scope (use for correlation with detail views when available). |
| name: String | Display name. |
| email: String | Primary email. |
| sourceSystem: String | Source system of record (lineage). |
| sourceSystems: [String!]! | Distinct source systems across the canonical row and every absorbed party
that maps to it via gold.party_aliases. Lineage identifiers (monolith,
provider_sales, firstbase, box, vcom). Deduped and sorted alphabetically
(case-insensitive, lowercase). Empty array when no source systems are
present. Use this on list views that should show the full merge span;
|
| categories: [String!]! | Distinct tech-wheel product families across the canonical row and every absorbed party that maps to it via gold.party_aliases (energy, communications, saas, hardware, managed_services, infrastructure). Independent of sourceSystems. Deduped and sorted alphabetically (case-insensitive, lowercase). Empty array when none are present. |
| sourceId: String | Business key in the source system. |
| entityType: String | Entity type label. |
| city: String | City or locality. |
| state: String | State or region. |
| country: String | Country. |
| createdAt: DateTime | Record creation timestamp (RFC 3339). |
| updatedAt: DateTime | Last update timestamp (RFC 3339). |
| lastActivity: CustomerActivityEvent PREVIEW | Most recent activity event tied to this customer; null when no event is known.
Advisor-scoped queries resolve the queried advisor's activity. Marketplace-scoped queries
resolve the activity of the advisor reported in |
| pendingMergeCount: Int | Pending merge candidates involving this customer (silver.party_review_queue with
pending_review=true). Marketplace-scoped queries count across every advisor in the tenant,
or across the single advisor when the query narrows to one via |
| topMatchScorePercent: Int | Highest match probability among pending merge candidates, scaled to 0–100 (rounded). |
| advisorUuid: ID | Canonical lowercase advisor UUID for this customer (matches party_xref.advisor_uuid). Marketplace-manager UIs use this to filter the list down to a single advisor. |
| advisorName: String | Display name of the advisor that owns this customer; null when no advisor is resolved (e.g. an unmapped UUID). |
| orderCount: Int | Total orders placed by this customer, across every party absorbed into the canonical. Null
when the warehouse has no order summary for the customer yet; clients should treat null as
zero. Advisor-scoped queries count that advisor's orders only. Marketplace-scoped queries
count orders across every advisor in the tenant, or across the single advisor when the query
narrows to one via |
| phone: String | Primary phone number. |
| address: String | Street address line 1. |
| address2: String | Street address line 2. |
| zipcode: String | Postal or ZIP code. |
| website: String | Website URL. |
| industryId: String | Industry identifier as stored on the source record. |
| contactFirstName: String | Primary contact's first name. |
| contactLastName: String | Primary contact's last name. |
| mergeInProgress: Boolean! | True when a merge has been submitted for this customer but not yet applied, so its records are still listed separately. Clears once the unification job collapses them onto one customer. |
Parent objects of CustomerUnifiedListItem
| CustomerUnifiedListPage PREVIEW | Cursor-paginated unified customer directory for an advisor (no total count). |