HL7 Czech PS Implementation Guide
0.0.1 - ci-build
HL7 Czech PS Implementation Guide
0.0.1 - ci-build
HL7 Czech PS 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/ps/ and changes regularly. See the Directory of published versions
| Official URL: https://hl7.cz/fhir/ps/ConceptMap/socialHistory2FHIR-cz-ps | Version: 0.0.1 | |||
| Draft as of 2025-12-29 | Computable Name: SocialHistory2FHIRCzPs | |||
PS Social History Model to this guide mapping
Mapping from (not specified) to (not specified)
Group 1 Mapping from A.2.6 Social History to Composition (CZ PS)
| Source Code | Relationship | Target Code |
| substanceUse (A.2.7 - Social History) | is equivalent to | Composition.section:sectionSocialHistory |
| substanceUse.alcoholUse (A.2.6.1.1 Alcohol) | is equivalent to | Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation) |
| substanceUse.tobaccoUse (A.2.6.1.2 Tobacco use) | is equivalent to | Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation) |
| substanceUse.drugUse (A.2.6.1.3 Drugs) | is equivalent to | Composition.section:substanceUse.entry:drugUse.ofType(Observation) |
Group 2 Mapping from A.2.6 Social History to Observation – Alcohol Use (CZ PS)
| Source Code | Relationship | Target Code | Comment |
| alcoholUse.status (A.2.6.1.1.1 Status) | is equivalent to | Observation.valueCodeableConcept | Use valueCodeableConcept to represent the current alcohol use status (e.g., current/former/never). |
| alcoholUse.periodAndQuantity (A.2.6.1.1.2 Period and quantity) | is equivalent to | Observation.effectivePeriod | Use effectivePeriod to capture the time interval the reported alcohol use applies to. |
| alcoholUse.periodAndQuantity (A.2.6.1.1.2 Period and quantity) | is equivalent to | Observation.component[x].valueQuantity | Represent amount/frequency as component(s). Each component SHALL have component.code defining what is measured (e.g., units/week, drinks/day) and valueQuantity with UCUM units where possible. Multiple components may be used. |
| alcoholUse.comment (A.2.6.1.1.3 Comment) | is equivalent to | Observation.note |
Group 3 Mapping from A.2.6 Social History to Observation – Tobacco Use (CZ PS)
| Source Code | Relationship | Target Code | Comment |
| tobaccoUse.status (A.2.6.1.2.1 Status) | is equivalent to | Observation.valueCodeableConcept | Smoking status as a coded value (e.g., current/former/never). |
| tobaccoUse.periodAndQuantity.period (A.2.6.1.2.2 Period and quantity - period) | is equivalent to | Observation.effectivePeriod | Time interval the reported tobacco use applies to. |
| tobaccoUse.periodAndQuantity.quantity (A.2.6.1.2.2 Period and quantity - quantity) | is equivalent to | Observation.component.valueQuantity | Average amount as component(s); each component SHALL define component.code (e.g., cigarettes/day) and use UCUM where possible. |
| tobaccoUse.comment (A.2.6.1.2.3 Comment) | is equivalent to | Observation.note |
Group 4 Mapping from A.2.6 Social History to Observation – Drug Use (CZ PS)
| Source Code | Relationship | Target Code | Comment |
| drugUse.status (A.2.6.1.3.1 Status) | is equivalent to | Observation.valueCodeableConcept | Current status of drug use/dependence as coded value (e.g., current/former/never). |
| drugUse.periodAndQuantity.period (A.2.6.1.3.2 Period and quantity - period) | is equivalent to | Observation.effectivePeriod | Time interval the reported drug use applies to. |
| drugUse.periodAndQuantity.quantity (A.2.6.1.3.2 Period and quantity - quantity) | is equivalent to | Observation.component.valueQuantity | Represent administered amount/average quantity as component(s). Each component SHALL carry component.code (what is quantified) and valueQuantity with UCUM units where possible. |
| drugUse.substanceType (A.2.6.1.3.3 Substance type) | is equivalent to | Observation.component.valueCodeableConcept | Record the substance type as a component (component.code identifies 'substance'; valueCodeableConcept contains the substance code, e.g., ICD-10/SNOMED CT). |
| drugUse.routeOfAdministration (A.2.6.1.3.4 Route of administration) | is equivalent to | Observation.component.valueCodeableConcept | Route(s) of administration as component(s) (repeatable). component.code identifies 'route'; valueCodeableConcept holds the route code. |
| drugUse.comment (A.2.6.1.3.5 Comment) | is equivalent to | Observation.note |
Group 5 Mapping from A.2.6 Social History to Observation – Other Addictions (CZ PS)
| Source Code | Relationship | Target Code | Comment |
| otherAddictions (A.2.6.1.4 Other addictions) | is equivalent to | Observation.valueCodeableConcept | Create one Observation per entry. Use valueCodeableConcept for ICD-10/SNOMED coding; if only free text is available, populate CodeableConcept.text (and optionally Observation.note). |