The Cicada Vaccine Forecasting Engine and Guide
0.1.0 - ci-build
The Cicada Vaccine Forecasting Engine and Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft as of 2026-09-02 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="forecast-reason"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem forecast-reason</b></p><a name="forecast-reason"> </a><a name="hcforecast-reason"> </a><p>This case-sensitive code system <code>http://fhirfli.dev/fhir/ig/cicada/CodeSystem/forecast-reason</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td></tr><tr><td style="white-space:nowrap">series-complete<a name="forecast-reason-series-complete"> </a></td><td>Patient series is complete</td><td>Every target dose in the series is satisfied. Maps to ImmDS #complete.</td></tr><tr><td style="white-space:nowrap">not-recommended-history<a name="forecast-reason-not-recommended-history"> </a></td><td>Not recommended at this time due to past immunization history</td><td>Maps to ImmDS #notRecommended.</td></tr><tr><td style="white-space:nowrap">exceeded-maximum-age<a name="forecast-reason-exceeded-maximum-age"> </a></td><td>Patient has exceeded the maximum age</td><td>Maps to ImmDS #maximumAge.</td></tr><tr><td style="white-space:nowrap">past-seasonal-end<a name="forecast-reason-past-seasonal-end"> </a></td><td>Past seasonal recommendation end date</td><td>Maps to ImmDS #seasonalPast.</td></tr><tr><td style="white-space:nowrap">complete-for-the-season<a name="forecast-reason-complete-for-the-season"> </a></td><td>Patient is complete for the season</td><td>The series is complete for the current season and a further dose falls in a later one. Maps to ImmDS #seasonalComplete. A deliberate deviation from CDSi, which has no such reason: ACIP defines influenza and RSV recommendations by season, and without this a patient who has had this year's dose is indistinguishable from one who never needs another.</td></tr><tr><td style="white-space:nowrap">evidence-of-immunity<a name="forecast-reason-evidence-of-immunity"> </a></td><td>Patient has evidence of immunity</td><td>No ImmDS concept.</td></tr><tr><td style="white-space:nowrap">contraindication<a name="forecast-reason-contraindication"> </a></td><td>Patient has a contraindication</td><td>No ImmDS concept.</td></tr><tr><td style="white-space:nowrap">cannot-finish-before-maximum-age<a name="forecast-reason-cannot-finish-before-maximum-age"> </a></td><td>Patient is unable to finish the series prior to the maximum age</td><td>No ImmDS concept.</td></tr><tr><td style="white-space:nowrap">below-minimum-age-to-start<a name="forecast-reason-below-minimum-age-to-start"> </a></td><td>Patient has not reached the minimum age to start</td><td>No ImmDS concept.</td></tr><tr><td style="white-space:nowrap">shared-clinical-decision-making<a name="forecast-reason-shared-clinical-decision-making"> </a></td><td>Recommended by shared clinical decision-making</td><td>ACIP recommends this series by shared clinical decision-making rather than routinely, so it is not a care gap. Read from CDC's own marking in the series name, and for HPV from the 27-45 year band CDC states in its guidance. No CDSi or ImmDS concept; ICE calls it CLINICAL_PATIENT_DISCRETION.</td></tr></table></div>
</text>
<url value="http://fhirfli.dev/fhir/ig/cicada/CodeSystem/forecast-reason"/>
<version value="0.1.0"/>
<name value="CicadaForecastReasonCS"/>
<title value="Cicada Forecast Reason Code System"/>
<status value="draft"/>
<date value="2026-09-02T22:18:14-04:00"/>
<publisher value="FHIR-FLI"/>
<contact>
<name value="FHIR-FLI"/>
<telecom>
<system value="url"/>
<value value="http://fhirfli.dev"/>
</telecom>
</contact>
<description
value="Why the engine forecast what it did. The ImmDS ForecastReason code system covers four of these; the rest have no ImmDS concept, and the ImmDS binding on ImmunizationRecommendation.recommendation.forecastReason is example strength, so they travel as a second coding rather than being dropped."/>
<caseSensitive value="true"/>
<content value="complete"/>
<count value="10"/>
<concept>
<code value="series-complete"/>
<display value="Patient series is complete"/>
<definition
value="Every target dose in the series is satisfied. Maps to ImmDS #complete."/>
</concept>
<concept>
<code value="not-recommended-history"/>
<display
value="Not recommended at this time due to past immunization history"/>
<definition value="Maps to ImmDS #notRecommended."/>
</concept>
<concept>
<code value="exceeded-maximum-age"/>
<display value="Patient has exceeded the maximum age"/>
<definition value="Maps to ImmDS #maximumAge."/>
</concept>
<concept>
<code value="past-seasonal-end"/>
<display value="Past seasonal recommendation end date"/>
<definition value="Maps to ImmDS #seasonalPast."/>
</concept>
<concept>
<code value="complete-for-the-season"/>
<display value="Patient is complete for the season"/>
<definition
value="The series is complete for the current season and a further dose falls in a later one. Maps to ImmDS #seasonalComplete. A deliberate deviation from CDSi, which has no such reason: ACIP defines influenza and RSV recommendations by season, and without this a patient who has had this year's dose is indistinguishable from one who never needs another."/>
</concept>
<concept>
<code value="evidence-of-immunity"/>
<display value="Patient has evidence of immunity"/>
<definition value="No ImmDS concept."/>
</concept>
<concept>
<code value="contraindication"/>
<display value="Patient has a contraindication"/>
<definition value="No ImmDS concept."/>
</concept>
<concept>
<code value="cannot-finish-before-maximum-age"/>
<display
value="Patient is unable to finish the series prior to the maximum age"/>
<definition value="No ImmDS concept."/>
</concept>
<concept>
<code value="below-minimum-age-to-start"/>
<display value="Patient has not reached the minimum age to start"/>
<definition value="No ImmDS concept."/>
</concept>
<concept>
<code value="shared-clinical-decision-making"/>
<display value="Recommended by shared clinical decision-making"/>
<definition
value="ACIP recommends this series by shared clinical decision-making rather than routinely, so it is not a care gap. Read from CDC's own marking in the series name, and for HPV from the 27-45 year band CDC states in its guidance. No CDSi or ImmDS concept; ICE calls it CLINICAL_PATIENT_DISCRETION."/>
</concept>
</CodeSystem>