Patient Payment Plans & Collections — Integration Documentation

Feature ID: PM-45
Owner: PM (Practice Management)
Created: 2026-04-08
Status: 📝 Planned

---

​

Integration Overview

PM-45 integrates with FA (Fund Accounting) for write-off financial adjustments, PF-10 for notifications/reminders, PM-16 for statement data, and PM-09 for payment posting context.

---

​

Event Contracts

​

Published Events

​

pm.payment_plan.created

• Publisher: PM (PM-45)
• Subscribers: FA (AR tracking)
• Channel: Platform event bus
• Payload:
  {
    payment_plan_id: string;
    patient_id: string;
    total_balance: number;
    organization_id: string;
  }
  
• Idempotency Key: payment_plan_id
• Status: 📝 Planned

​

pm.bad_debt_writeoff.approved

• Publisher: PM (PM-45)
• Subscribers: FA (posts financial adjustment to general ledger)
• Channel: Platform event bus
• Payload:
  {
    writeoff_id: string;
    patient_id: string;
    patient_account_id: string;
    writeoff_amount: number;
    reason_code: string;
    financial_adjustment_id?: string;
    approved_by: string;
    approval_date: string; // ISO 8601
    organization_id: string;
  }
  
• Idempotency Key: writeoff_id
• Status: 📝 Planned

​

Consumed Events

None. PM-45 reads PM-16 statement data via direct same-core data access (see Cross-Core Dependencies below).

---

​

Platform Integration Layer Dependencies

---

​

Cross-Core Dependencies

---

​

Validation Checklist

• Event contracts documented with payload schemas
• Idempotency keys specified for all published events
• Platform layer dependencies confirmed available
• FA subscriber implementation status tracked
• Security: no PHI in event payloads beyond minimum necessary

---

Last Updated: 2026-04-08