Settle commercial identity nuances with consolidated enums and linking rules

Add commercial-identity-nuance-settlement.md resolving control_basis,
binding_trigger, cross-registry Synonymity strengths, OPI branch modeling,
escrow commitment type, reputation portability, payment edge cases, CRM renewal
rules, Person Account adapters, and eIDAS wallet scope. Update canon, OpenQuestions,
and all commercial-identity source notes.
This commit is contained in:
2026-06-21 23:21:21 +02:00
parent 6ea582cd9e
commit 08361f6fb7
18 changed files with 403 additions and 64 deletions

View File

@@ -76,8 +76,10 @@ lifecycle.
Examples: LEI (ISO 17442 / ICD 0199), national company registration number,
SAM.gov UEI, VAT number, ALEI (ISO 8000-116).
Recommended fields: `scheme` (ICD or scheme URI), `authority`, `authority_class`,
`jurisdiction`, `value`, `renewal_required`, `lifecycle_state`, `evidence_source`.
Recommended fields: `scheme` (ICD or scheme URI), `authority`, `authority_class`
(`government_registry`, `regulatory_global`, `commercial_proxy`, `tax`,
`industry_association`), `jurisdiction`, `value`, optional `organization_part_id`
(ISO 6523 OPI for branches), `renewal_required`, `lifecycle_state`, `evidence_source`.
Registry records (GLEIF entry, D&B profile, SAM registration) map to
**Commercial Record** or **Identity Record**, not to the identifier itself.
@@ -102,7 +104,8 @@ sector, tenant, realm, application, namespace, or other scope.
Evidence or secret material used to prove control, entitlement, or a claim.
Examples: password, passkey, certificate, hardware token, verifiable
credential, recovery code, signed assertion.
credential, qualified electronic seal (`credential_type: qualified_seal`),
recovery code, signed assertion.
Excludes: payment card PAN, CVV, track data, and other PCI cardholder data —
those stay in payment-provider or PCI-scoped downstream vaults. Excludes
@@ -206,7 +209,9 @@ Recommended metadata:
- `ownership_prong` — meets equity threshold (e.g., 25%+).
- `control_prong` — meets substantial control/management test.
- `equity_percentage` — when ownership prong applies.
- `control_basis`role basis when control prong applies (e.g., CEO, managing member).
- `control_basis``senior_managing_official`, `chief_executive`, `chief_financial`,
`managing_member`, `general_partner`, `board_chair`, `trustee`, `settlor_with_control`,
or `other_control` (with detail text).
- `intermediary_chain` — trust or entity look-through when required.
- `regulatory_basis` — CDD Rule, national statute, or registry filing type.
- `scope`, `evidence_reference`, `lifecycle_state`.
@@ -214,6 +219,15 @@ Recommended metadata:
Do not model as an Ownership subtype. Operational ownership (records, tenants,
resources, corporate parents) uses **Ownership Relationship** separately.
## Beneficial Ownership Exemption
**Evidence Source** recording that a Legal Entity or Organization customer is
**exempt** from beneficial ownership collection under a stated rule (e.g.,
publicly traded, government entity, regulated financial institution).
Use explicit exemption Evidence instead of inferring from absent BO relationships.
Carries `exemption_type`, `regulatory_basis`, and `lifecycle_state`.
## Customer
A commercial role played by an actor (usually an Organization, sometimes a
@@ -252,7 +266,12 @@ fulfilled, expired, revoked) and may attach to Commercial Relationship,
Commercial Record, or Legal Entity/Organization actors.
Recommended `commitment_type`: `contract` | `subscription` | `payment_mandate` |
`regulatory_onboarding` | `purchase_order` | other.
`purchase_order` | `escrow` | `regulatory_onboarding` | `amendment` | other.
`binding_trigger` on promotion from **Pipeline Pursuit**: `quote_accepted`,
`loi_signed`, `purchase_order_executed`, `contract_executed`, `subscription_activated`,
`regulatory_onboarding_complete`, `org_policy_closed_won` (downstream policy
Evidence required).
Does not include CRM pipeline stages by default — see **Pipeline Pursuit**.
Salesforce Forecast "Commit" category is sales confidence, not this concept.
@@ -287,11 +306,12 @@ binding **Commercial Commitment** exists.
Examples: Salesforce Opportunity, HubSpot deal, renewal pursuit on existing
account.
Carries `stage`, `forecast_category`, expected amount/date, and `lifecycle_state`
(open, won, lost). Stage changes are **Evidence Source** (internal telemetry);
they do not alone create Commercial Commitment. Promote to commitment only when
a `binding_trigger` is satisfied (signed quote/LOI → `proposed`; executed
contract/PO/subscription → `active`).
Carries `stage`, `forecast_category`, `pursuit_role` (`customer`, `partner`,
`vendor`), expected amount/date, and `lifecycle_state` (open, won, lost).
Stage changes are **Evidence Source** (internal telemetry); they do not alone
create Commercial Commitment. Promote only on `binding_trigger`. Renewals on an
existing contract use **commitment amendment** on the prior Commercial Commitment
(optional Pipeline Pursuit for forecast); competitive rebids use new Pipeline Pursuit.
## Commercial Record