Polaris FHIR Implementation Guide
1.9.9 - ci-build

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

Extension: ShadowBillExtension - FSH Source

Draft as of 2026-04-21

FSH source of the oscar-billing-shadow-bill-extension extension.

Raw FSH | Download

Extension: ShadowBillExtension
Id: oscar-billing-shadow-bill-extension
Title: "Shadow Bill Extension"
Description: "True when the Invoice represents a shadow bill (capitated FHO/FHN submission) rather than a regular FFS claim. Derived from Oscar billing status `H` (Capitated)."
* ^url = "https://fhir.apps.health/StructureDefinition/oscar-billing-shadow-bill-extension"
* ^version = "1.0.0"
* ^status = #draft
* ^date = "2026-04-21"
* ^publisher = "Polaris FHIR Implementation Guide"
* ^contact.name = "Polaris FHIR Implementation Guide"
* ^contact.telecom.system = #url
* ^contact.telecom.value = "https://fhir.apps.health"
* ^jurisdiction = urn:iso:std:iso:3166#CA "Canada"
* ^context[0].type = #element
* ^context[0].expression = "Invoice"
* . ^short = "Shadow bill indicator"
* . ^definition = """
True when the Invoice represents a shadow bill — a capitated submission under Ontario's
FHO/FHN models where payment is via capitation and the bill is submitted for tracking and
utilization-reporting purposes only. Derived from Oscar Pro's `billing_on_cheader1.status = 'H'`
(Capitated).

When true, `Invoice.totalGross` reflects the shadow bill value (typically a fraction of the FFS
rate under FHO/FHN capitation; exact percentages are set by Ontario MoH policy and not encoded
in Oscar source — consult the OHIP Schedule of Benefits + the relevant MoH contract). Consumers
should not expect a payment remittance for shadow bills.
"""
* extension 0..0
* url 1..1
* value[x] 1..1 MS
* value[x] only boolean
* valueBoolean ^short = "Whether this invoice is a shadow bill"
* valueBoolean ^definition = "True if this invoice represents a shadow bill (capitated submission), false otherwise."