# Core Organization Data Model

## Overview

The **Core Organization** domain represents a non‑clinical organization. This domain models an organization at a foundational level, capturing legal identity, names, locations, contact details, identifiers, classifications, and business attributes. It is intended for organizations that are not healthcare providers, such as payers, employers, vendors, partners, or corporate entities.

## When to Use This Domain

* **Use the Core Organization domain when:**
  * You are modeling a non‑clinical organization.
  * Legal, operational, or business identity attributes are required.
  * The organization participates in workflows outside of direct care delivery.
  * You need a canonical organizational identity shared across systems.
* **Do not use this domain when:**
  * Modeling healthcare delivery organizations (use **Provider – Health Facility** instead).


## Relationship to Other Domains

* **Entity:** Organization
* **Base Domain:** Core Organization
* **Note:** This domain provides a canonical organizational identity. Domain extensions may be introduced for specialized organizational contexts in the future.


## Data Model

The Core Organization schema is composed of legal, contact, classification, and business attribute groups. All fields are optional unless otherwise noted.

### Organization Names

Represents the various legal and alternate names used by the organizational identity.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `legalBusinessName` | Text | Legal business name |
|  | `otherOrgName` | Text | Alternate organization name |
|  | `tradingName` | Text | Doing‑business‑as (DBA) name |
|  | `parentOrgName` | Text | Parent organization name |


### Contact Information (Grouped)

Organization contact information captured as grouped records.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
| Address | `Address` | - | Organization address with validity and geolocation |
| Phone List | `Phone List` | - | One or more phone numbers |
| Fax List | `Fax List` | - | Fax numbers |
| Best Time to Contact | `day` | Code Set | Day of the week the contact window applies to |
|  | `startTime` | Time | Start time of the preferred contact window |
|  | `endTime` | Time | End time of the preferred contact window |
|  | `allDay` | Boolean | Indicates availability for the entire day |


### Standalone Addresses

Detailed attributes for organizational physical locations when not grouped.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `addressName` | Text | Address label |
|  | `addressType` | Code Set | Address type |
|  | `line1` | Text | Address line 1 |
|  | `line2` | Text | Address line 2 |
|  | `city` | Text | City |
|  | `district` | Text | District |
|  | `state` | Text | State |
|  | `postalCode` | Text | Postal code |
|  | `country` | Text | Country |
|  | `latitude` | Number | Latitude |
|  | `longitude` | Number | Longitude |
|  | `validFrom` | Date | Start date |
|  | `validTo` | Date | End date |


### Phone, Fax, and Email

Standard communication channel attributes.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
| Phone Numbers | `number` | Text | Phone number |
|  | `type` | Code Set | Phone type |
| Fax Numbers | `number` | Text | Fax number |
|  | `type` | Code Set | Fax type |
| Emails | `email` | Text | Email address |
|  | `type` | Code Set | Email type |
|  | `validFrom` | Date | Start date |
|  | `validTo` | Date | End date |


### Organizational Identifiers

Identifiers used for alternate tracking and unique system recognition.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
| Alternate Identifiers | `description` | Text | Identifier description |
|  | `type` | Code Set | Identifier type |
|  | `value` | Text | Identifier value |
|  | `status` | Text | Identifier status |
|  | `issuer` | Text | Issuing authority |
|  | `issueDate` | Date | Issue date |
|  | `startDate` | Date | Valid from |
|  | `endDate` | Date | Valid to |
| External Unique Identifiers | `issuer` | Text | Issuing authority or system |
|  | `value` | Text | Identifier value |
|  | `status` | Text | Identifier status |
|  | `startDate` | Date | Valid from |
|  | `endDate` | Date | Valid to |
| Employer Identification Number | `value` | Text | EIN value |
|  | `status` | Boolean | Status |
|  | `issuer` | Text | Issuer |
|  | `issueDate` | Date | Issue date |
|  | `validFrom` | Date | Valid from |
|  | `validTo` | Date | Valid to |


### Authorized Officials

Individuals authorized to act on behalf of the organization.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `title` | Text | Title |
|  | `prefix` | Text | Name prefix |
|  | `first` | Text | First name |
|  | `middle` | Text | Middle name |
|  | `last` | Text | Last name |
|  | `suffix` | Text | Name suffix |
|  | `credential` | Text | Credentials |
|  | `phoneNumber` | Text | Contact phone number |


### Classification & Business Attributes

Industry-specific data and legal standing.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
| NAICS Classifications | `sector` | Code Set | Industry classification hierarchy |
| SIC Classifications | `code` | Code Set | SIC industry codes |
| Organization Types | `type` | Text | Organization type |
|  | `subType` | Text | Organization subtype |
| Legal Status | `type` | Code Set | Legal status type |
|  | `source` | Text | Source of verification |
|  | `effectiveDate` | Date | Effective date |
|  | `verificationDate` | Date | Verification date |
|  | `jurisdiction` | Text | Jurisdiction |
|  | `registrationCountry` | Code Set | Country of registration |


### Products & Services

Represents offerings associated with the organization.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
|  | `name` | Text | Product or service name |
|  | `code` | Text | Product code |
|  | `type` | Code Set | Product type |
|  | `category` | Text | Category |
|  | `price` | Number | Price |
|  | `status` | Code Set | Status |
|  | `description` | Text | Description |
|  | `launchDate` | Date | Launch date |
|  | `market` | Text | Market |
|  | `lineOfBusiness` | Text | Line of business |
| Service Lines | `serviceLine` | Text | Primary service line |
|  | `subServiceLine` | Text | Specific sub-service |


### Operational Profile & Qualifications

Company metrics and standing.

| Embedded Cluster | Attribute | Type | Description |
|  --- | --- | --- | --- |
| Number of Employees | `numberOfEmployees` | Number | Employee count |
| Founded Date | `foundedDate` | Date | Date founded |
| Annual Revenue | `annualRevenue` | Number | Revenue |
|  | `year` | Date | Revenue year |
| Qualifications | `type` | Code Set | Qualification type |
|  | `qualification` | Text | Qualification |
|  | `status` | Code Set | Status |
|  | `issuer` | Text | Issuer |
|  | `issueDate` | Date | Issue date |
|  | `validFrom` | Date | Valid from |
|  | `validTo` | Date | Valid to |