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

CodeSystem: Cicada Forecast Reason Code System

Official URL: http://fhirfli.dev/fhir/ig/cicada/CodeSystem/forecast-reason Version: 0.1.0
Draft as of 2026-09-02 Computable Name: CicadaForecastReasonCS

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.

This Code system is referenced in the content logical definition of the following value sets:

This case-sensitive code system http://fhirfli.dev/fhir/ig/cicada/CodeSystem/forecast-reason defines the following codes:

CodeDisplayDefinition
series-complete Patient series is complete Every target dose in the series is satisfied. Maps to ImmDS #complete.
not-recommended-history Not recommended at this time due to past immunization history Maps to ImmDS #notRecommended.
exceeded-maximum-age Patient has exceeded the maximum age Maps to ImmDS #maximumAge.
past-seasonal-end Past seasonal recommendation end date Maps to ImmDS #seasonalPast.
complete-for-the-season Patient is complete for the season 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.
evidence-of-immunity Patient has evidence of immunity No ImmDS concept.
contraindication Patient has a contraindication No ImmDS concept.
cannot-finish-before-maximum-age Patient is unable to finish the series prior to the maximum age No ImmDS concept.
below-minimum-age-to-start Patient has not reached the minimum age to start No ImmDS concept.
shared-clinical-decision-making Recommended by shared clinical decision-making 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.