HL7 Czech Shared Health Record Implementation Guide
0.0.1 - ci-build

HL7 Czech Shared Health Record Implementation Guide, published by HL7 Czech Republic. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7-cz/szz/ and changes regularly. See the Directory of published versions

## ConceptMap: CZ Header Model to this guide Map (Experimental)

Official URL: https://hl7.cz/fhir/szz/ConceptMap/Header2FHIR-cz | Version: 0.0.1
Draft as of 2025-12-22 | Computable Name: Header2FHIR

CZ Shared Health Record Model to this guide mapping

Mapping from (not specified) to (not specified)

Group 1 Mapping from A.1 - Document header to Organization (CZ core)

Source Code | Relationship | Target Code
Header.payer.insuranceCode (A.1.3.1 - Health insurance code) | is equivalent to | Organization.identifier.KP
Header.payer.insuranceName (A.1.3.2 - Health insurance name) | is equivalent to | Organization.name

Group 2 Mapping from A.1 - Document header to Coverage (CZ)

Source Code | Relationship | Target Code
Header.coverage.insuranceNumber (A.1.3.3 - insuranceNumber) | is equivalent to | CZ_Coverage.identifer

Group 3 Mapping from A.1 - Document header to Patient (CZ core)

Source Code | Relationship | Target Code | Comment
Header.subject (A.1.1 - Identification and A.1.2 - related contact information of the Patient/subject) | is equivalent to | Patient | Composition.subject.ofType(Patient).conformsTo('https://hl7.cz/fhir/core/StructureDefinition/cz-patient-core')
Header.payer.insuranceNumber (A.1.3.3 - Health insurance number) | is equivalent to | Patient.identifier | If treated as one of the Patient identifiers; this applies in some jurisdictions.

Group 4 Mapping from A.1 - Document header to Practitioner Role (CZ core)

Source Code | Relationship | Target Code | Comment
Header.informationRecipient.identifier (A.1.4.1 - Recipient identifier) | is equivalent to | PractitionerRole.identifier | Composition.extension:information-recipient.valueReference.resolve()
Header.author (A.1.5 - Author (by whom the SZZ was/were authored). Multiple authors could be provided.) | is equivalent to | PractitionerRole | Composition.author.resolve().ofType(PractitionerRole).confirmsTo('https://hl7.cz/fhir/core/StructureDefinition/cz-practitioner-core')
Header.author.identifier (A.1.5.1 - Author identifier) | is equivalent to | PractitionerRole.identifier |
Header.author.name (A.1.5.2 - Author name) | is equivalent to | PractitionerRole.practictioner.name | If PractitionerRole
Header.author.organizationID (A.1.5.3 - Author organisation ID) | is equivalent to | PractitionerRole.organization.identifier | If Organization
Header.author.organization (A.1.5.4 - Author organisation) | is related to | PractitionerRole.organization |

Group 5 Mapping from A.1 - Document header to Bundle (SZZ CZ)

Source Code | Relationship | Target Code | Comment
Header.documentMetadata.identifier (A.1.6.1 - Document ID) | is equivalent to | Bundle.identifier | If it is the identifier of a particular report instance
Header.documentMetadata.dateTime (A.1.6.4 - Report date and time) | is equivalent to | Bundle.timeStamp | If it is when this particular version of this report has been assembled into a Bundle.
Header.digitalSignature (A.1.7 - Digital signature) | is equivalent to | Bundle.signature | Digital signature of the Bundle

Group 6 Mapping from A.1 - Document header to Composition (SZZ CZ)

Source Code | Relationship | Target Code | Comment
Header.subject (A.1.1 - Identification and A.1.2 - related contact information of the Patient/subject) | is equivalent to | Composition.subject |
Header.payer (A.1.3 - Health insurance and payment information - Health insurance information is not always required, however, in some jurisdictions, the insurance number is also used as the patient identifier. It is necessary not just for identification but also forms access to funding for care.) | is related to | Composition.extension:basedOn:order | To be disucssed if the payor data are conveyed with the request or thorugh other means. Check also the extension to be used.
Header.payer (A.1.3 - Health insurance and payment information - Health insurance information is not always required, however, in some jurisdictions, the insurance number is also used as the patient identifier. It is necessary not just for identification but also forms access to funding for care.) | is related to | Composition.section:sectionPayers.entry | Composition.section:sectionPayers.entry.ofType(Coverage).conformsTo('https://hl7.cz/fhir/core/StructureDefinition/cz-coverage')
Header.informationRecipient (A.1.4 - Information recipient - (intended recipient or recipients of the report), if applicable) | is related to | Composition.extension:information-recipient | Composition.extension:information-recipient.valueReference.resolve().ofType(PracittionerRole)
Header.informationRecipient.name (A.1.4.2 - Recipient name) | is equivalent to | PractitionerRole.practitioner.name |
Header.informationRecipient.organizationID (A.1.4.3 - Recipient organisation ID) | is equivalent to | PractitionerRole.practitioner.organization.identifier |
Header.informationRecipient.organization (A.1.4.4 - Recipient organisation) | is related to | PractitionerRole.practitioner.organization |
Header.informationRecipient.address (A.1.4.5 - Address) | is related to | PractitionerRole.address |
Header.informationRecipient.country (A.1.4.6 - Country) | is related to | PractitionerRole.country |
Header.informationRecipient.telecom (A.1.4.7 - Telecom) | is related to | PractitionerRole.telecom |
Header.author (A.1.5 - Author (by whom the SZZ was/were authored). Multiple authors could be provided.) | is equivalent to | Composition.author |
Header.author.dateTime (A.1.5.5 - Date Time) | is equivalent to | Composition.date |
Header.documentMetadata (A.1.6 - Document metadata) | is related to | Composition |
Header.documentMetadata.type (A.1.6.2 - Document type) | is equivalent to | Composition.type |
Header.documentMetadata.status (A.1.6.3 - Document status) | is equivalent to | Composition.status |
Header.documentMetadata.dateTime (A.1.6.4 - Report date and time) | is equivalent to | Composition.date | If it is when this document has been created (indipendently by its version)
Header.documentMetadata.title (A.1.6.5 - Document title) | is equivalent to | Composition.title |
Header.documentMetadata.custodian (A.1.6.6 - Report custodian) | is equivalent to | Composition.custodian |
Header.documentMetadata.confidentiality (A.1.6.7 - Confidentiality) | is equivalent to | Composition.confidentiality |
Header.documentMetadata.language (A.1.6.8 - Language) | is related to | Composition.language |
Header.documentMetadata.version (A.1.6.9 - Version) | is equivalent to | Composition.extension:versionNumber.valueString | As business version, not as resource version