Skip to content

Update HCC recapture#1320

Open
andreas-homeward wants to merge 50 commits intotuva-health:mainfrom
andreas-homeward:update-hcc-recapture
Open

Update HCC recapture#1320
andreas-homeward wants to merge 50 commits intotuva-health:mainfrom
andreas-homeward:update-hcc-recapture

Conversation

@andreas-homeward
Copy link
Copy Markdown
Contributor

@andreas-homeward andreas-homeward commented Apr 22, 2026

Features

  • Suspect lists can be added by turning the hcc_recapture_suspect_list to true and passing in the suspect_hccs input
  • Chronic HCC definitions besides CMS definitions can be provided by setting the hcc_recapture_chronic_hccs variable to true and providing the chronic_hccs input.
  • Allows acute HCCs to flow through, where before they were filtered out entirely. Recapture rates are filtered using the recapturable_flag, which is defined as only chronic + eligible claims.
  • Refactored models provide better organization and insight in recaptured HCCs
  • New/updated fields that provide better insight into HCCs, including:
      - name: recapturable_flag
        description: >
          Whether or not the HCC is recapturable. Includes the following values:
            - '1': condition is a chronic condition appropriate for recapture and has been documented in the prior 2 years
            - '0': condition is not a chronic condition appropriate for recapture or has not been documented in the prior 2 years
      - name: hcc_type
        description: >
          The type of HCC. Includes the following values:
            - 'coded': condition was coded in a claim during the collection year
            - 'captured': condition is considered captured according to a different source besides claims, such as a clinical source
            - 'suspect': condition is suspected to be present based on some other criteria besides claims diagnoses
        tests:
          accepted_values:
            values: ['coded', 'captured', 'suspect']
      - name: hcc_source
        description: >
          The source of the HCC information. Includes the following values:
            - 'payer': HCC was identified in data received from the payer such as claims or suspect lists
            - 'clinical': HCC was identified in clinical data such as the EHR 
        tests:
          accepted_values:
            values: ['payer', 'clinical']
      - name: hcc_chronic_flag
        description: Whether the HCC is considered chronic or not. A 1 indicates the HCC is chronic.

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 22, 2026

Deploy Preview for thetuvaproject canceled.

Name Link
🔨 Latest commit 8ccc6ee
🔍 Latest deploy log https://app.netlify.com/projects/thetuvaproject/deploys/69f28e2cdc473c0007102a41

@amartinson193 amartinson193 changed the title Update hcc recapture Update HCC recapture Apr 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 👀 Ready for Review

Development

Successfully merging this pull request may close these issues.

4 participants