PatientAdministrativeDocument

Administrative documents associated with a patient, such as identity documents, insurance cards, and other official paperwork required for healthcare administration.

Overview

PatientAdministrativeDocument tracks the various official documents that patients provide to healthcare facilities. These documents are essential for patient identification, insurance verification, and regulatory compliance. The entity manages document validity periods and links documents to their issuing authorities.

Key Concepts

Document Types

Documents are categorized by their documentType via DocumentType:

Identity Documents

National ID cards
Passports
Driver's licenses
Birth certificates

Insurance Documents

Health insurance cards
Medicare/Medicaid cards
Supplemental insurance cards

Other Documents

Power of attorney
Legal guardianship documents
Immigration documents

Document Identification

Each document can have multiple identifiers via Identifier:

Primary document number (e.g., passport number)
Chip/electronic identifiers (e.g., ePassport chip ID)
Barcode or QR code values

Validity Tracking

The validityPeriod via Period tracks:

startDate - When the document became valid
endDate - When the document expires

The calculated field isExpired automatically determines if the document has expired based on the current date.

Issuing Authority

The issuingOrganization via Organization identifies who issued the document:

Government agencies (Ministry of Interior, DMV)
Insurance companies
Healthcare organizations

Use Cases

Patient Registration

During registration, staff record identity documents:

Scan or photograph the document
Create PatientAdministrativeDocument record
Extract identifiers (document number, chip ID)
Set validity period from document dates
Link to issuing organization

Insurance Verification

Before appointments or procedures:

Query patient's insurance documents
Check isExpired to verify current coverage
Use identifiers for eligibility verification
Update if patient provides new insurance card

Document Expiration Alerts

Healthcare systems can:

Query documents approaching expiration
Notify patients to provide updated documents
Flag expired documents during check-in

Related Entities

Entity	Relationship	Description
Patient	Belongs to	The patient who owns this document
DocumentType	References	Type classification of the document
Identifier	Contains many	Document numbers and electronic IDs
Period	Contains	Validity date range
Organization	References	Authority that issued the document

Calculated Fields

Field	Type	Description
`isExpired`	boolean	True if current date is past `validityPeriod.endDate`

7 properties

Schema

Properties

Property	Type	Mode	Description	Required
patient	Patient	stored	Patient this document belongs to	Required
documentType	DocumentType	stored	Type of administrative document	Required
identifiers	Identifier[]	stored	Document identifiers (e.g., passport number, chip ID)	Optional
validityPeriod	Period	stored	Period during which the document is valid	Optional
issuingOrganization	Organization	stored	Authority or organization that issued the document	Optional
isExpired	boolean	calculated	Whether the document has expired based on expirationDate	Optional
notes	string	stored	Additional notes about the document	Optional

Examples

Example 1

{
  "@type": "PatientAdministrativeDocument",
  "patient": {
    "@type": "Patient",
    "givenName": "John",
    "familyName": "Smith"
  },
  "documentType": {
    "@type": "DocumentType",
    "code": "ID_CARD",
    "label": "Identity Card",
    "category": "identity"
  },
  "identifiers": [
    {
      "@type": "Identifier",
      "system": "NATIONAL_ID",
      "value": "123456789012",
      "type": "national-id"
    }
  ],
  "validityPeriod": {
    "@type": "Period",
    "startDate": "2020-05-10",
    "endDate": "2030-05-10"
  },
  "issuingOrganization": {
    "@type": "Organization",
    "name": "Ministry of Interior"
  }
}

Example 2

{
  "@type": "PatientAdministrativeDocument",
  "patient": {
    "@type": "Patient",
    "givenName": "Robert",
    "familyName": "Williams"
  },
  "documentType": {
    "@type": "DocumentType",
    "code": "INSURANCE_CARD",
    "label": "Insurance Card",
    "category": "insurance"
  },
  "identifiers": [
    {
      "@type": "Identifier",
      "system": "BCBS",
      "value": "BCBS-123456789",
      "type": "financial"
    }
  ],
  "validityPeriod": {
    "@type": "Period",
    "startDate": "2024-01-01",
    "endDate": "2024-12-31"
  },
  "issuingOrganization": {
    "@type": "Organization",
    "name": "Blue Cross Blue Shield"
  }
}

Example 3

{
  "@type": "PatientAdministrativeDocument",
  "patient": {
    "@type": "Patient",
    "givenName": "John",
    "familyName": "Smith"
  },
  "documentType": {
    "@type": "DocumentType",
    "code": "PASSPORT",
    "label": "Passport",
    "category": "identity"
  },
  "identifiers": [
    {
      "@type": "Identifier",
      "system": "PASSPORT",
      "value": "AB1234567",
      "type": "travel"
    },
    {
      "@type": "Identifier",
      "system": "PASSPORT_CHIP",
      "value": "CHIP-9876543210",
      "type": "electronic"
    }
  ],
  "validityPeriod": {
    "@type": "Period",
    "startDate": "2022-06-15",
    "endDate": "2032-06-15"
  },
  "issuingOrganization": {
    "@type": "Organization",
    "name": "Ministry of Foreign Affairs"
  }
}