German Practice Management FHIR Profiles (R4)
Version 0.99.1 - release

Praxis-to-Billing Migration

Praxis-to-Billing Migration

Praxis is a medical clinical and practice-workflow composition package over the German Billing IG. Generic financial contracts are no longer independently evolved under Praxis canonicals.

Stable composition boundary

New Praxis financial profiles derive from de.cognovis.fhir.billing#0.2.0 and add only medical evidence or workflow constraints. This includes medical imaging ChargeItems, diagnosis-constrained final Claims, and the home-nursing and rehabilitation prior-authorization children. Encounter, presence, appointments, locations, HealthcareService, provider identity and credentialing, lab, imaging, referral, medication, Communication, Composition, and clinical CarePlan contracts remain owned by Praxis.

Canonical migration registry

The machine-readable canonical migration map gives each superseded Praxis canonical exactly one Billing or Billing Core family successor, or an explicit retirement record. A successor row does not claim element-for-element substitutability: migrationKind and compatibility state whether a code crosswalk, structural transformation, or absorption into a Billing profile is required. The companion live ownership inventory classifies every current Praxis canonical as one of:

  • billing-owned-transitional
  • medical-composition
  • retained-clinical-workflow
  • retired

The inventory is generated from the SUSHI resources and checked for drift. Unmatched canonicals fail generation; retained clinical/workflow ids are an explicit reviewed allowlist rather than the default classification.

The claim-subtype CodeSystem migrates to the Billing canonical with the code crosswalk recorded in codeMaps. Billing 0.2.0 still leaves the generic final Claim subtype optional. Praxis examples carry the Billing subtype, while the registry records this upstream contract delta and keeps publication blocked until it is resolved or explicitly accepted.

The retained Praxis family Claim canonicals therefore change Claim.subType from a required code in the Praxis CodeSystem to an optional pattern in the Billing CodeSystem. Existing producers must apply the recorded code crosswalk; the predecessor URL alone does not make an older instance compatible.

The home-nursing PAS child continues to require a clinical CarePlan reference. Billing 0.2.0 does not yet provide a generic supporting-information category for that evidence, so the transitional example retains the retired Praxis category code until Billing defines a successor or the category is explicitly retired.

Transition and release gate

Predecessor canonicals remain resolvable until every named downstream consumer has recorded cutover evidence. Their continued presence is a compatibility promise, not authority to add new generic billing semantics. Removal and publication of a clinical/workflow-only Praxis package are blocked until the registry records every named consumer as migrated and the corresponding repository and package scans pass.