haau3 FHIR Implementation Guide (HFIG)
1.0.0 - ci-build United States of America flag

haau3 FHIR Implementation Guide (HFIG) - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Extension: Plan Benefits Source Release

Official URL: https://haau3.com/fhir/StructureDefinition/plan-benefits-source-release Version: 1.0.0
Draft as of 2026-10-14 Computable Name: PlanBenefitsSourceRelease

The CMS release a Plan Benefits plan was read from: the release's name, and for each of CMS's files in it, the address CMS publishes it at, the date CMS last changed it and its SHA-256, so anyone can fetch the same file and check it. The SBC guide has no element for the source of a plan's data; haau3 publishes this extension until it does.

Context of Use

    This extension may be used on the following element(s)

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Extension 0..* Extension Plan Benefits Source Release
Extension.extension 2..* Extension Extension
Extension.Slices for extension Content/Rules for all slices
Extension.Slices for extension.extension:release 1..1 Extension The release's name: program, plan year and CMS's date
Extension.Slices for extension.extension:release.extension 0..0 Extension
Extension.Slices for extension.extension:release.url 1..1 uri "release"
Extension.Slices for extension.extension:release.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-1
Extension.Slices for extension.extension:file 1..* Extension One of CMS's files in the release
Extension.Slices for extension.extension:file.extension 3..* Extension Extension
Extension.Slices for extension.extension:file.Slices for extension Content/Rules for all slices
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl 1..1 Extension Where CMS publishes the file
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.extension 0..0 Extension
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.url 1..1 uri "downloadUrl"
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.value[x] 0..1 uri Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified 1..1 Extension The date CMS last changed the file
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.extension 0..0 Extension
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.url 1..1 uri "lastModified"
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.value[x] 0..1 date Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256 1..1 Extension The file's SHA-256, in lowercase hexadecimal
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.extension 0..0 Extension
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.url 1..1 uri "sha256"
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-2
Extension.Slices for extension.extension:file.url 1..1 uri "file"
Extension.Slices for extension.extension:file.value[x] 0..0 Value of extension
Extension.url 1..1 uri "https://haau3.com/fhir/StructureDefinition/plan-benefits-source-release"

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Extension 0..* Extension Plan Benefits Source Release
Extension.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:release 1..1 Extension The release's name: program, plan year and CMS's date
Extension.Slices for extension.extension:release.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:release.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:release.url 1..1 uri "release"
Extension.Slices for extension.extension:release.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-1
Extension.Slices for extension.extension:file 1..* Extension One of CMS's files in the release
Extension.Slices for extension.extension:file.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension 3..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension Content/Rules for all slices
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl 1..1 Extension Where CMS publishes the file
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.url 1..1 uri "downloadUrl"
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.value[x] 0..1 uri Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified 1..1 Extension The date CMS last changed the file
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.url 1..1 uri "lastModified"
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.value[x] 0..1 date Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256 1..1 Extension The file's SHA-256, in lowercase hexadecimal
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.url 1..1 uri "sha256"
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-2
Extension.Slices for extension.extension:file.url 1..1 uri "file"
Extension.url 1..1 uri "https://haau3.com/fhir/StructureDefinition/plan-benefits-source-release"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: The CMS release a Plan Benefits plan was read from: the release's name, and for each of CMS's files in it, the address CMS publishes it at, the date CMS last changed it and its SHA-256, so anyone can fetch the same file and check it. The SBC guide has no element for the source of a plan's data; haau3 publishes this extension until it does.

  • release: string: The release's name: the program (ma or aca), the plan year and the date CMS last changed its files, for example ma-2027-2026-10-01. One release per program is served at a time, and every plan in an answer names the release it came from.
  • downloadUrl: uri: An Extension
  • lastModified: date: The date of the file's Last-Modified header when haau3 fetched it from CMS.
  • sha256: string: An Extension

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Extension 0..* Extension Plan Benefits Source Release
Extension.extension 2..* Extension Extension
Extension.Slices for extension Content/Rules for all slices
Extension.Slices for extension.extension:release 1..1 Extension The release's name: program, plan year and CMS's date
Extension.Slices for extension.extension:release.extension 0..0 Extension
Extension.Slices for extension.extension:release.url 1..1 uri "release"
Extension.Slices for extension.extension:release.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-1
Extension.Slices for extension.extension:file 1..* Extension One of CMS's files in the release
Extension.Slices for extension.extension:file.extension 3..* Extension Extension
Extension.Slices for extension.extension:file.Slices for extension Content/Rules for all slices
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl 1..1 Extension Where CMS publishes the file
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.extension 0..0 Extension
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.url 1..1 uri "downloadUrl"
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.value[x] 0..1 uri Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified 1..1 Extension The date CMS last changed the file
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.extension 0..0 Extension
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.url 1..1 uri "lastModified"
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.value[x] 0..1 date Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256 1..1 Extension The file's SHA-256, in lowercase hexadecimal
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.extension 0..0 Extension
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.url 1..1 uri "sha256"
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-2
Extension.Slices for extension.extension:file.url 1..1 uri "file"
Extension.Slices for extension.extension:file.value[x] 0..0 Value of extension
Extension.url 1..1 uri "https://haau3.com/fhir/StructureDefinition/plan-benefits-source-release"
Extension.value[x] 0..0 Value of extension

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Extension 0..* Extension Plan Benefits Source Release
Extension.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension 2..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:release 1..1 Extension The release's name: program, plan year and CMS's date
Extension.Slices for extension.extension:release.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:release.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:release.url 1..1 uri "release"
Extension.Slices for extension.extension:release.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-1
Extension.Slices for extension.extension:file 1..* Extension One of CMS's files in the release
Extension.Slices for extension.extension:file.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension 3..* Extension Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension Content/Rules for all slices
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl 1..1 Extension Where CMS publishes the file
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.url 1..1 uri "downloadUrl"
Extension.Slices for extension.extension:file.Slices for extension.extension:downloadUrl.value[x] 0..1 uri Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified 1..1 Extension The date CMS last changed the file
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.url 1..1 uri "lastModified"
Extension.Slices for extension.extension:file.Slices for extension.extension:lastModified.value[x] 0..1 date Value of extension
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256 1..1 Extension The file's SHA-256, in lowercase hexadecimal
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.id 0..1 string Unique id for inter-element referencing
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.extension 0..0 Extension
Slice: Unordered, Open by value:url

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.url 1..1 uri "sha256"
Extension.Slices for extension.extension:file.Slices for extension.extension:sha256.value[x] C 0..1 string Value of extension
Constraints: plan-benefits-2
Extension.Slices for extension.extension:file.url 1..1 uri "file"
Extension.url 1..1 uri "https://haau3.com/fhir/StructureDefinition/plan-benefits-source-release"

doco Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: The CMS release a Plan Benefits plan was read from: the release's name, and for each of CMS's files in it, the address CMS publishes it at, the date CMS last changed it and its SHA-256, so anyone can fetch the same file and check it. The SBC guide has no element for the source of a plan's data; haau3 publishes this extension until it does.

  • release: string: The release's name: the program (ma or aca), the plan year and the date CMS last changed its files, for example ma-2027-2026-10-01. One release per program is served at a time, and every plan in an answer names the release it came from.
  • downloadUrl: uri: An Extension
  • lastModified: date: The date of the file's Last-Modified header when haau3 fetched it from CMS.
  • sha256: string: An Extension

 

Other representations of profile: CSV, Excel, Schematron

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
plan-benefits-1 error Extension.extension:release.value[x] A release's name is the program, the plan year and CMS's date: ma-2027-2026-10-01. matches('^(ma|aca)-[0-9]{4}-[0-9]{4}-[0-9]{2}-[0-9]{2}$')
plan-benefits-2 error Extension.extension:file.extension:sha256.value[x] A SHA-256 is 64 lowercase hexadecimal characters. matches('^[0-9a-f]{64}$')