---
title: CertificateHolder
summary: API reference for CertificateHolder.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-24
library: SAIF.Domain
reference_type: package
---

# CertificateHolder

`CertificateHolder` wraps a `certData.CertificateHolder` entity and implements the certificate-holder lifecycle for [OP-DOM-17](../../operations-processes.md#op-dom-17): a new certificate holder is created directly from a `CertificateHolderEdit` contract, an existing one is updated the same way, and its expired/superseded flags are toggled by dedicated methods that stamp the acting user and timestamp ([DOM-BR-170](../../business-rules.md#dom-br-170-holder-save)–[DOM-BR-172](../../business-rules.md#dom-br-172-holder-save)).

## Purpose
- Creates a brand-new certificate holder from a `CertificateHolderEdit` contract, mapping every editable field (name, address, phone/fax, email) onto the entity and stamping create/update user and date, then adds it to the repository.
- Updates an existing certificate holder in place from a `CertificateHolderEdit` contract, re-mapping the same fields and stamping the update user/date.
- Expires, reinstates, and supersedes a certificate holder, each toggling the relevant flag and stamping the update user/date ([DOM-BR-170](../../business-rules.md#dom-br-170-holder-save)–[DOM-BR-172](../../business-rules.md#dom-br-172-holder-save)).

## Context
- Namespace: `SAIF.Domain.Model.Policies.Certificates`
- Assembly/package: `SAIF.Domain` (packaged in `SAIF.SAIFCode.Core`)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| CertificateHolder (constructor by id) | `public CertificateHolder(IRepositoryFactory factory, string userId, long id)` | Loads the certificate holder identified by `id` and captures `userId` as the acting user for future updates. |
| CertificateHolder (constructor, create from edit) | `public CertificateHolder(IRepositoryFactory factory, string userId, CertificateHolderEdit certificateHolderEdit)` | Creates a new certificate holder entity, maps `certificateHolderEdit` onto it, stamps create/update user (`userId`) and date, and adds it to the repository. |
| CertificateHolder (constructor, update from edit) | `public CertificateHolder(IRepositoryFactory factory, string userId, long id, CertificateHolderEdit certificateHolderEdit)` | Loads the certificate holder identified by `id`, re-maps `certificateHolderEdit` onto it, and stamps the update user (`userId`) and date. |
| Data | `public certData.CertificateHolder Data { get; }` | Exposes the underlying certificate-holder entity. |
| Expire | `public void Expire()` | Sets `IsExpired` to `true` and stamps the update user/date ([DOM-BR-170](../../business-rules.md#dom-br-170-holder-save)). |
| Reinstate | `public void Reinstate()` | Sets `IsExpired` to `false` and stamps the update user/date ([DOM-BR-171](../../business-rules.md#dom-br-171-holder-save)). |
| Supersede | `public void Supersede(certData.CertificateHolder newCertficateHolder)` | Links `newCertficateHolder` as the record that supersedes this one, sets `IsSuperseded` to `true`, and stamps the update user/date ([DOM-BR-172](../../business-rules.md#dom-br-172-holder-save)). |

## Inherited public members

Members in this section are inherited from `DomainBase<TItem>` in `SAIF.Domain`. They are available on this type through inheritance (via the intermediate `DomainRepositoryBase<TItem>` base).

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| HasData | `public virtual bool HasData { get; }` | Reports whether the wrapped certificate-holder entity is present, evaluated as `!DataItem.IsNull()`. | `SAIF.Domain` — `DomainBase<TItem>` |

## Behavioral notes
- Only the constructor-by-id overload chains to `: base(factory)`; the two edit-based constructors do not call a base constructor with `factory`, so they run against `DomainRepositoryBase<TItem>`'s internal parameterless constructor and leave the protected `Factory` field unset on those code paths — meaning any later code path on those instances that depends on `Factory` would find it `null`*.
- The country code is only overwritten from the edit contract when the certificate holder `IsForeign`; otherwise it is hard-coded to `"US"`, regardless of what the edit contract's `CountryCode` was ([DOM-BR-170](../../business-rules.md#dom-br-170-holder-save)).
- Address text fields are passed through `ReplaceUnicodeCharacters`, converting Unicode characters to their ASCII equivalents before persisting, likely to satisfy a downstream system's character-set constraints*.

## Constraints and usage notes
- Callers using the two edit-based constructors should be aware that `Factory` is not set on the resulting instance (see behavioral note above); any subsequent repository operation through `Factory` on those instances would not function as expected.

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts.

## Sources
- `Domain/SAIF.Domain/Model/Policies/Certificates/CertificateHolder.cs`
- `Domain/SAIF.Domain/DomainBase.cs`
- `Domain/SAIF.Domain/DomainRepositoryBase.cs`