Claims Denial Management & Appeals — Integration Document

import { useTaskMutation } from '@/platform/tasks';

// Called from PM-29 appeal submit handler
const { create } = useTaskMutation();

create({
  organization_id: organizationId,
  title: `Follow up: appeal for claim ${claimNumber}`,
  description: `Appeal submitted for denial on ${denialDate}. Payer: ${payerName}. Category: ${denialCategory}.`,
  status: 'open',
  priority: 'high',             // Overdue risk: missed deadline = lost revenue
  assigned_to: assignedTo,      // Defaults to current user; reassignable
  due_date: payerAppealDeadline, // DATE string from pm_claim_denials.payer_appeal_deadline
  source_type: 'pm_appeal',     // PM-29 source type; extend TaskSourceType union
  source_id: appealSubmissionId, // pm_appeal_submissions.id
  custom_fields: {
    denial_id: denialId,
    claim_id: claimId,
    denial_category: denialCategory,
  },
});