PH eReferral Implementation Guide
0.3.0-draft - draft
Philippines
PH eReferral Implementation Guide, published by UP Manila SILab. This guide is not an authorized publication; it is the continuous build for version 0.3.0-draft built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/jgsuess/ph-ereferral/ and changes regularly. See the Directory of published versions
Once an Implementation Guide has moved past the rapid agile draft phase, HL7 International provides a well-established framework for developing it further. This framework defines the stages an IG passes through as it gains maturity, the evidence required at each stage transition, and the governance processes that validate progress. Understanding it is essential for planning a realistic path from an initial draft to a published standard.
For context on where this fits in the overall IG evolution, see IG Evolution.
IG development progress is tracked along two related but distinct axes:
An IG progresses by accumulating FMM evidence, and at certain FMM thresholds it becomes eligible for the next ballot status. The two axes are related but not identical: an IG at a given FMM level may or may not yet have gone through the corresponding ballot process.
Ballot status: CI build only (no formal HL7 status) FMM level: 0–1
At this stage the IG is under active development, published only as a continuous-integration (CI) build. Breaking changes are expected at any time and no formal HL7 approval has been sought.
FMM criteria:
Who uses this? Project teams, early adopters, pilots, and teams preparing for Connectathon participation.
Ballot status: Draft ballot or STU ballot FMM level: 2 required for STU ballot
The first formal HL7 community review. Balloting:
A ballot can be a Draft ballot (earlier, higher change tolerance) or an STU ballot (more mature, intended for real-world trial use). To file an STU ballot the IG must have reached at least FMM 2.
FMM 2 criteria:
"Testing must occur one cycle before ballot." — HL7 IG process guidance.
Connectathons are not optional polish — for FHIR artifacts, interoperability testing is a formal gating criterion for FMM advancement, not a post-publication nicety.
A typical STU path looks like this:
Draft IG
↓
Connectathon testing (FMM 2)
↓
STU Ballot
↓
STU Publication
Connectathon evidence that HL7 accepts:
For IGs that go through multiple STU cycles, early Connectathons prove basic feasibility; later ones demonstrate stability, convergence, and cross-vendor consistency. This accumulating evidence directly feeds the case for Normative readiness.
Ballot status: STU FMM level: 3–4
STU is the most common "production-ready" state for a FHIR IG. It signals:
An IG commonly goes through multiple STU releases (STU 1, STU 2, STU 3…), each through a new ballot cycle. This is by design: each cycle allows the IG to absorb implementation feedback before the semantic model is locked.
FMM criteria:
Important rule: An IG cannot be more mature than the least mature core artifact it depends on.
Ballot status: Normative ballot in progress FMM level: 5 required
A Normative ballot signals intent to lock down the specification. It requires:
The ballot process at this stage is more stringent: all negative votes must be resolved, and final approval passes through the sponsoring Work Group, the FMG, and the Technical Steering Committee (TSC).
Ballot status: Normative FMM level: 5
The highest stability level in the HL7/FHIR ecosystem. A Normative IG:
Normative IGs are rare and slow to emerge — intentionally so. The bar is high because the governance commitment to maintain backward compatibility is real and long-lived.
The table below maps each FMM level to its corresponding ballot status and the evidence required to reach it.
| Phase | Ballot / Publication Status | FMM Level |
|---|---|---|
| Early development | Draft (CI build only) | FMM 0–1 |
| First review | Draft ballot / STU ballot | FMM 2 |
| Trial use | STU | FMM 3–4 |
| Locked specification | Normative | FMM 5 |
Moving to Normative is not just another ballot. It is a governance decision to lock the specification permanently. HL7 expects credible, documented evidence across four areas:
1. Production implementation
This evidence is specifically required for the FMM 4 → FMM 5 transition.
2. Stability across STU cycles
3. Broad and diverse review
This expectation is stated explicitly at FMM 3 and above, and carries forward to Normative decisions.
4. Interoperability history
While not always phrased as "attend X Connectathons", the interoperability evidence requirement persists through FMM 4–5.
Hard prerequisite: FMM 5 requires all of the following:
Even with FMM 5 evidence in hand, a Normative ballot is still required, all negatives must be resolved per ANSI rules, and final approval passes through the WG, FMG, and TSC.
Every formal HL7 publication involves a layered governance chain:
| Stage | Approving body |
|---|---|
| Draft / STU ballot submission | Sponsoring Work Group |
| Ballot reconciliation | Work Group + HL7 members |
| STU / Normative publication | FHIR Management Group (FMG) |
| Normative publication (final) | + Technical Steering Committee (TSC) |
The FMG is the body that accepts Connectathon evidence and adjudicates FMM advancement claims. The TSC provides the final governance gate for Normative publications.
Many national IGs — including AU Base, AU Core, and US Core — intentionally remain at STU for extended periods to:
Normative is a governance commitment, not just a technical milestone. If an IG still expects semantic churn, evolving slices, or frequent cardinality changes, it is not Normative-ready — and that is entirely appropriate for a maturing standard.
Most successful IGs spend years at STU by design. The PH eReferral IG, currently in agile draft, has a long and productive journey ahead before Normative is the right conversation.