PatientNotificationType

Reference data entity for types of notifications and communications in healthcare. Used to define and manage patient and contact communication preferences.

Overview

PatientNotificationType catalogs the different types of notifications that healthcare systems can send to patients and their contacts. Notifications are categorized by purpose (clinical, administrative, financial, general) and include appointment reminders, lab results, billing notices, and health campaigns. This reference data enables granular control over communication preferences.

Key Concepts

Notification Categories

Notifications are grouped by their purpose:

Category	Purpose	Examples
Clinical	Health-related information	Lab results, imaging results, prescription updates
Administrative	Scheduling and logistics	Appointment reminders, confirmations, cancellations
Financial	Billing and payment	Invoices, payment reminders, insurance updates
General	Other communications	Health campaigns, surveys, announcements

Standard Notification Types

Administrative Notifications

APPOINTMENT_REMINDER - Upcoming appointment reminders
APPOINTMENT_CONFIRMATION - Booking confirmations
APPOINTMENT_CANCELLATION - Cancelled appointment notices
APPOINTMENT_RESCHEDULED - Schedule change notifications

Clinical Notifications

LAB_RESULTS - Laboratory test results available
IMAGING_RESULTS - Radiology/imaging results ready
PRESCRIPTION_READY - Prescription ready for pickup
PRESCRIPTION_REFILL - Medication refill reminders

Financial Notifications

INVOICE - New bill or invoice available
PAYMENT_REMINDER - Outstanding balance reminders
PAYMENT_CONFIRMATION - Payment receipt confirmations
INSURANCE_UPDATE - Insurance or claims status changes

General Notifications

GENERAL_ANNOUNCEMENT - Facility announcements
HEALTH_CAMPAIGN - Preventive care campaigns
SURVEY_REQUEST - Patient satisfaction surveys

Preference Management

Notification types are used in:

PatientContact notificationPreferences - Which notifications contacts receive
Patient communication settings - What patients want to be notified about
Opt-in/opt-out management - Regulatory compliance (e.g., marketing)

Use Cases

Contact Notification Setup

When configuring contact preferences:

Display available notification types by category
Allow selection of desired notification types
Store preferences in notificationPreferences array
Apply preferences when sending notifications

Appointment Reminder System

For scheduled reminders:

Query patients with upcoming appointments
Check notification preferences for APPOINTMENT_REMINDER
Send via preferred channel (SMS, email, phone)
Log notification delivery status

Results Notification

When results are ready:

Determine notification type (lab, imaging, etc.)
Check if patient opted into result notifications
Send notification to patient and authorized contacts
Record notification in patient communication log

Financial Communication

For billing notifications:

Check patient's financial notification preferences
Send invoices only if INVOICE preference enabled
Follow up with PAYMENT_REMINDER if opted in
Confirm payments with PAYMENT_CONFIRMATION

Marketing Compliance

For promotional communications:

Separate HEALTH_CAMPAIGN from clinical notifications
Require explicit opt-in for marketing
Provide easy opt-out mechanism
Track consent for regulatory compliance

Related Entities

Entity	Relationship	Description
PatientContact	Referenced by	Contact notification preferences

Enums

Value	Description
`clinical`	Health and medical information (results, prescriptions, clinical updates)
`administrative`	Scheduling and operational communications (appointments, check-ins)
`financial`	Billing and payment communications (invoices, statements, insurance)
`general`	General communications (announcements, campaigns, surveys)

Standard Values

Code	Label	Category	Description
`APPOINTMENT_REMINDER`	Appointment Reminder	administrative	Reminder for upcoming appointment
`APPOINTMENT_CONFIRMATION`	Appointment Confirmation	administrative	Confirmation of scheduled appointment
`APPOINTMENT_CANCELLATION`	Appointment Cancellation	administrative	Notice of cancelled appointment
`APPOINTMENT_RESCHEDULED`	Appointment Rescheduled	administrative	Notice of rescheduled appointment
`LAB_RESULTS`	Lab Results	clinical	Laboratory test results available
`IMAGING_RESULTS`	Imaging Results	clinical	Radiology/imaging results available
`PRESCRIPTION_READY`	Prescription Ready	clinical	Prescription ready for pickup
`PRESCRIPTION_REFILL`	Prescription Refill	clinical	Medication refill reminder
`INVOICE`	Invoice	financial	New bill or invoice
`PAYMENT_REMINDER`	Payment Reminder	financial	Reminder for outstanding payment
`PAYMENT_CONFIRMATION`	Payment Confirmation	financial	Confirmation of received payment
`INSURANCE_UPDATE`	Insurance Update	financial	Insurance or claims status update
`GENERAL_ANNOUNCEMENT`	General Announcement	general	Facility-wide announcements
`HEALTH_CAMPAIGN`	Health Campaign	general	Preventive care and wellness campaigns
`SURVEY_REQUEST`	Survey Request	general	Patient satisfaction survey requests

4 properties

Schema

Properties

Property	Type	Mode	Description	Required
code	string	stored	Unique code identifying the notification type Example: `"APPOINTMENT"`	Required
label	string	stored	Human-readable name of the notification type Example: `"Appointment"`	Required
category	string	stored	Category of notification Values: `clinical, administrative, financial, general` Example: `"administrative"`	Required
description	string	stored	Additional details about the notification type	Optional

Examples

Example 1

{
  "@type": "PatientNotificationType",
  "code": "APPOINTMENT_REMINDER",
  "label": "Appointment Reminder",
  "category": "administrative",
  "description": "Reminders for upcoming appointments"
}

Example 2

{
  "@type": "PatientNotificationType",
  "code": "APPOINTMENT_CONFIRMATION",
  "label": "Appointment Confirmation",
  "category": "administrative",
  "description": "Confirmation of scheduled appointments"
}

Example 3

{
  "@type": "PatientNotificationType",
  "code": "APPOINTMENT_CANCELLATION",
  "label": "Appointment Cancellation",
  "category": "administrative",
  "description": "Notification of cancelled appointments"
}

Example 4

{
  "@type": "PatientNotificationType",
  "code": "APPOINTMENT_RESCHEDULED",
  "label": "Appointment Rescheduled",
  "category": "administrative",
  "description": "Notification of rescheduled appointments"
}

Example 5

{
  "@type": "PatientNotificationType",
  "code": "LAB_RESULTS",
  "label": "Lab Results",
  "category": "clinical",
  "description": "Laboratory test results available"
}

Example 6

{
  "@type": "PatientNotificationType",
  "code": "IMAGING_RESULTS",
  "label": "Imaging Results",
  "category": "clinical",
  "description": "Imaging and radiology results available"
}

Example 7

{
  "@type": "PatientNotificationType",
  "code": "PRESCRIPTION_READY",
  "label": "Prescription Ready",
  "category": "clinical",
  "description": "Prescription ready for pickup"
}

Example 8

{
  "@type": "PatientNotificationType",
  "code": "PRESCRIPTION_REFILL",
  "label": "Prescription Refill",
  "category": "clinical",
  "description": "Prescription refill reminder"
}

Example 9

{
  "@type": "PatientNotificationType",
  "code": "INVOICE",
  "label": "Invoice",
  "category": "financial",
  "description": "New invoice or bill available"
}

Example 10

{
  "@type": "PatientNotificationType",
  "code": "PAYMENT_REMINDER",
  "label": "Payment Reminder",
  "category": "financial",
  "description": "Reminder for outstanding payment"
}

Example 11

{
  "@type": "PatientNotificationType",
  "code": "PAYMENT_CONFIRMATION",
  "label": "Payment Confirmation",
  "category": "financial",
  "description": "Confirmation of received payment"
}

Example 12

{
  "@type": "PatientNotificationType",
  "code": "INSURANCE_UPDATE",
  "label": "Insurance Update",
  "category": "financial",
  "description": "Insurance coverage or claims update"
}

Example 13

{
  "@type": "PatientNotificationType",
  "code": "GENERAL_ANNOUNCEMENT",
  "label": "General Announcement",
  "category": "general",
  "description": "General facility announcements"
}

Example 14

{
  "@type": "PatientNotificationType",
  "code": "HEALTH_CAMPAIGN",
  "label": "Health Campaign",
  "category": "general",
  "description": "Health awareness campaigns and preventive care"
}

Example 15

{
  "@type": "PatientNotificationType",
  "code": "SURVEY_REQUEST",
  "label": "Survey Request",
  "category": "general",
  "description": "Request to complete satisfaction survey"
}