Payer Optimization
Independent practices lose revenue to avoidable denials and under-coding while fearing the compliance consequences of over-coding. Payer Optimization is a practice-level feature — off by default, opt-in with disclosure — that surfaces clinically grounded coding suggestions, applies a quarterly-updated payer-specific rules engine, and gives the practice a data-driven view of payer performance. Hard guardrails: never reduces Medicare/Medicaid access, never discriminates on protected categories, never displays payer-margin to the patient. One feature among many, not the moat.
Key Capabilities
Payer Contract Repository
The PayerOptimizationConfig entity gates all features with an
explicit opt-in. Once enabled, the PayerRule repository captures
per-payer contract requirements — documentation thresholds, modifier rules,
pre-auth triggers, coding nuances, and bundling policies. Rules are org-scoped
and effective-dated: quarterly updates create new rows while retiring the prior
set. The billing manager reviews changes before they go live. Every rule carries
a structured JSON definition (RuleDefinitionText) that the engine
evaluates at coding time.
Fee Schedule Comparison Across Payers
The platform ingests and parses fee schedules from the practice's configured payers, enabling side-by-side comparison of allowed amounts for the same CPT codes across different payers. The comparison surfaces where reimbursement rates diverge and which payers consistently underpay relative to the contracted rate. Fee schedule data is org-scoped — only this practice's contracted rates are visible — and no per-patient margin data is displayed.
Reimbursement Rate Analysis
The ROI dashboard tracks reimbursement rates by payer over time, comparing actual allowed amounts against contracted fee schedules. The analysis surfaces payers whose actual reimbursement is trending below the contracted rate — flagging potential under-payment patterns. Data is aggregated at the org level; no per-patient reimbursement detail is exposed. The practice manager can drill down by CPT code family, payer, and time period.
Contract Renewal Alerts
When a payer contract is approaching its renewal date, the system surfaces an alert to the practice manager. The alert includes the contract's current terms, the practice's reimbursement trend under that payer, and a comparison against the anonymized cohort benchmark (Phase 3). The alert does not automate contract negotiation — that is a business-operations activity outside the platform — but it ensures no contract expires unnoticed.
Under-Payment Detection
At ERA posting time, the system compares the payer's allowed amount against the contracted fee schedule. When the allowed amount falls below the contracted rate for a given CPT code, the system flags an under-payment and creates a follow-up task in Task Management. The under-payment detection algorithm applies payer-specific fee schedule lookup, considers contract term matching, and accounts forbundling adjustments. Under-payment flags are surfaced on the ROI dashboard with payer-level aggregation.
Payer Performance Dashboards
A practice-level, org-scoped dashboard shows denial-rate trends by payer, coding-suggestion acceptance rates, payer-mix composition over time, and the net impact of optimization actions. The dashboard is aggregate-only — no per-patient margin display, no patient-identifiable data. Payer performance benchmarking against a de-identified cohort is available in Phase 3. The dashboard refreshes with the latest ERA posting and denial triage data.
Compliant Coding Suggestions
The coding optimization engine analyzes clinical documentation against the
applicable payer rules and surfaces coding suggestions — more specific ICD-10
codes, required modifiers, or E/M level adjustments. Every suggestion carries
an IsCompliantBool flag; the engine never surfaces
a suggestion that cannot be verified against the documented clinical findings.
E/M downcode suggestions are surfaced alongside upcodes to ensure balanced
guidance and protect against audit risk. The clinician accepts or rejects; the
disposition is recorded in the immutable audit trail. Target: 30–70% acceptance
rate — below 30% signals irrelevant suggestions; above 70% suggests automation
bias.
Persona Connections
- Practice Manager — Primary user. Manages payer rules configuration, reviews quarterly updates, monitors denial trends on the ROI dashboard, and reviews under-payment flags. Enables or disables the feature at the practice level (opt-in with disclosure). Needs payer-specific knowledge codified so it is not locked in staff memory. Operates at level 70–80.
- RCM / Priya — Tracks reimbursement patterns and under-payment flags. Uses the payer performance dashboard to identify which payers are generating the most friction. Feeds denial data from RCM into the optimization analytics. Operates at level 50–70 depending on role.
- Doctor — Receives coding suggestions at charge capture; accepts or rejects with one click. Needs confidence that suggestions are clinically supported and that E/M downcodes are surfaced too. Values the audit trail for compliance protection. Sees the coding impact of payer-specific rules on their documentation patterns. Operates at level 60.
Technical Highlights
-
Contract data model. The
PayerOptimizationConfigentity is the opt-in gate — one row per org, off by default. ThePayerRuleentity stores per-payer contract requirements as structured JSON definitions with effective dating. Both are org-scoped withOrganizationIDpartition-key isolation. The config records the enabling user, disclosure text acknowledged, and timestamp. All other features checkIsEnabledBoolbefore operating — enforced at the API layer, not just the UI layer. - Fee schedule parsing. The platform ingests payer fee schedules in multiple formats (CSV, X12 835-derived, payer portal export) and normalizes them into a structured lookup keyed by CPT code, modifier, and payer plan ID. Parsing is effective-dated to support quarterly updates. The fee schedule data feeds the reimbursement rate analysis and under-payment detection engine. Parsing completes in ≤30 seconds for schedules with up to 10,000 CPT entries.
-
Payer comparison engine. The engine evaluates a coding context
(CPT codes, modifiers, ICD-10 pointers) against all active
PayerRulerows for the org. Evaluation completes in ≤500ms p95 for a rule set of up to 200 active rules per org. The engine producesCodingOptimizationSuggestionrows with the suggested code, original code, reason, and compliance flag. Non-compliant suggestions are discarded before reaching the UI. -
Under-payment detection algorithm. At ERA posting, the
algorithm compares the payer's allowed amount per CPT line against the
contracted fee schedule rate. The comparison accounts for: fee schedule rate
for the CPT+modifier combination, payer-specific bundling adjustments,
contract term effective dates, and COB-adjusted allowed amounts. When the
allowed amount falls below the contracted rate by more than a configurable
threshold (default: $5 or 5%, whichever is greater), the system flags an
under-payment and creates a
WorkTaskin Task Management for follow-up. - Compliance guardrails. Three hard guardrails are enforced at the rules-engine level: (1) never reduce Medicare/Medicaid access — scheduling guidance must not deprioritize appointments for Medicare/Medicaid beneficiaries; (2) never discriminate on protected categories — no rule or guidance may use race, ethnicity, gender, age, or disability as a factor; (3) never display payer-margin to the patient — the patient-facing experience is identical whether Payer Optimization is enabled or not. These guardrails have automated integration tests that run on every deploy; a guardrail test failure blocks the deploy.
-
Immutable audit trail.
OptimizationAuditEntryrecords every optimization action: config enabled/disabled, suggestion accepted/rejected, scheduling guidance applied, rule created/retired/updated. Entries are append-only — never modified or soft-deleted (DeletedDateTimeUTCis always NULL). The audit trail is tamper- evident and supports compliance review at any point. Every entry records the actor, action type, affected patient (where applicable), and structured detail payload.
Optimization Pipeline
The spine of this module transforms payer-specific knowledge into compliant, data-driven revenue improvement — with every suggestion auditable, every guardrail enforced, and every patient protected:
- Practice owner opts in with disclosure acknowledgment →
PayerOptimizationConfig.IsEnabledBoolset to true. - Billing manager configures payer rules and imports fee schedules →
PayerRulerows created with effective dates. - Clinician completes encounter → coding optimization engine evaluates documentation against active payer rules.
- Engine produces
CodingOptimizationSuggestionrows — only compliant suggestions reach the UI; E/M downcodes surfaced alongside upcodes. - Clinician accepts or rejects →
OptimizationAuditEntrycreated with disposition, original code, suggested code, and reason. - ERA posting → under-payment detection compares allowed vs. contracted → flags create follow-up tasks.
- ROI dashboard aggregates denial trends, acceptance rates, payer-mix composition, and net impact — org-scoped, aggregate-only.
Delivery Phases
The practice-level opt-in configuration ships with full disclosure text and audit logging. The
PayerRule repository is available for the
billing manager to manually enter and curate payer-specific rules. Rules are
effective-dated but there is no automated quarterly update feed — updates are
manual. The coding optimization engine is not yet active. The ROI dashboard
shows basic payer-mix composition and denial rates by payer from
RCM data. No scheduling-side payer guidance. No
under-payment detection. The compliance audit log records all config changes
and rule authoring events. Target: ≥40% opt-in adoption within 6 months.
The coding optimization engine is live: it analyzes encounter documentation against active payer rules and surfaces compliant coding suggestions with E/M downcodes. Suggestion acceptance/rejection is logged in the immutable audit trail. Fee schedule import and parsing is active. Under-payment detection at ERA posting compares allowed amounts against contracted rates and creates follow-up tasks. The ROI dashboard adds reimbursement rate analysis and payer comparison views. Scheduling-side payer-aware slot guidance is available with the three hard guardrails enforced. Quarterly payer rules updates can be imported and reviewed before go-live. Target: 30–70% coding suggestion acceptance rate, ≥15% denial rate reduction within 90 days.
Cross-practice, de-identified benchmarking of payer denial rates, turnaround times, and reimbursement patterns is available. Practices see how their payer performance compares to the anonymized cohort — no patient-level or practice- identifiable data crosses the org boundary. The E/M downcode surfacing rate is tracked and balanced: ≥1 downcode surfaced for every 3 upcode suggestions. Contract renewal alerts surface when payer contracts approach expiration. Advanced payer performance dashboards with trend analysis, forecasting, and renegotiation support are live. The full compliance audit trail viewer is searchable by date range, action type, actor, and patient. Target: 0% unsupported-code suggestions ever, 100% audit log completeness.
Compliance Guardrails
Three hard guardrails are non-negotiable and enforced at the rules-engine level, not merely at the UI layer:
- No Medicare/Medicaid access reduction. Scheduling-side payer prioritization will never deprioritize, limit, or discourage appointments for Medicare or Medicaid beneficiaries. This is a hard compliance guardrail, not a configurable setting. Implemented as a mandatory rule filter that removes any guidance output that would reduce Medicare/Medicaid access, and it cannot be overridden by any configuration.
- No protected-category discrimination. No optimization rule or scheduling guidance may use patient race, ethnicity, gender, age (where protected), disability status, or any other protected category as a factor. The engine validates this at rule-authoring time (rejecting rules that reference protected categories) and at runtime (blocking guidance that would discriminate).
- No payer-margin visibility to patient. Patients will never see payer-margin, reimbursement-rate, or profitability data about their visit or appointment. The patient-facing experience is identical whether Payer Optimization is enabled or not. Enforced at the API layer by role-level filtering and at the component layer by conditional rendering.
Success Metrics
- Opt-in adoption rate: ≥40% of eligible practices within 6 months of launch — measures whether practices find enough value to enable the feature.
- Coding suggestion acceptance rate: 30–70% — below 30% suggests suggestions are irrelevant; above 70% suggests automation bias.
- Unsupported-code suggestion rate: 0% — zero unsupported code suggestions ever. Any unsupported code suggestion is a defect, not a metric to optimize.
- E/M downcode surfacing rate: ≥1 downcode surfaced for every 3 upcode suggestions — ensures balanced guidance and protects against audit risk.
- Denial rate reduction: ≥15% reduction in avoidable denials within 90 days of enablement — measures whether payer rules and coding suggestions translate into fewer denials.
- Medicare/Medicaid access compliance: 100% — zero instances of reduced access. Any instance is a compliance violation.
- Audit log completeness: 100% of optimization actions logged with actor, action, patient, detail, and timestamp — full audit log is non-negotiable for compliance.
Module Dependencies
- Upstream — Coding / CDS authors and versions the coding rules that Payer Optimization consumes as a payer-specific overlay at charge-capture time via CDS Hooks. Clinical Documentation provides the encounter findings, diagnoses, and procedures that the coding optimization engine reads as source of truth.
- Lateral — RCM provides denial data that feeds the ROI dashboard and the under-payment detection engine. Scheduling receives advisory payer-aware slot guidance, subject to the three hard guardrails.
- Downstream — Task Management receives under-payment follow-up tasks and coding suggestion audit events. The practice owner and compliance officer consume the audit trail for regulatory review.