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
| Draft as of 2025-12-29 |
{
"resourceType" : "ConceptMap",
"id" : "socialHistory2FHIR-cz-ps",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap socialHistory2FHIR-cz-ps</b></p><a name=\"socialHistory2FHIR-cz-ps\"> </a><a name=\"hcsocialHistory2FHIR-cz-ps\"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <a href=\"StructureDefinition-LogSocialHistoryCzEn.html\">A.2.6 Social History</a> to <a href=\"StructureDefinition-cz-composition-ps.html\">Composition (CZ PS)</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td></tr><tr><td>substanceUse (A.2.7 - Social History)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Composition.section:sectionSocialHistory</td></tr><tr><td>substanceUse.alcoholUse (A.2.6.1.1 Alcohol)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation)</td></tr><tr><td>substanceUse.tobaccoUse (A.2.6.1.2 Tobacco use)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation)</td></tr><tr><td>substanceUse.drugUse (A.2.6.1.3 Drugs)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Composition.section:substanceUse.entry:drugUse.ofType(Observation)</td></tr></table><hr/><p><b>Group 2 </b>Mapping from <a href=\"StructureDefinition-LogSocialHistoryCzEn.html\">A.2.6 Social History</a> to <a href=\"StructureDefinition-cz-observation-alcoholUse-ps.html\">Observation – Alcohol Use (CZ PS)</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>alcoholUse.status (A.2.6.1.1.1 Status)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>Use valueCodeableConcept to represent the current alcohol use status (e.g., current/former/never).</td></tr><tr><td>alcoholUse.periodAndQuantity (A.2.6.1.1.2 Period and quantity)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.effectivePeriod</td><td>Use effectivePeriod to capture the time interval the reported alcohol use applies to.</td></tr><tr><td>alcoholUse.periodAndQuantity (A.2.6.1.1.2 Period and quantity)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.component[x].valueQuantity</td><td>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.</td></tr><tr><td>alcoholUse.comment (A.2.6.1.1.3 Comment)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.note</td><td/></tr></table><hr/><p><b>Group 3 </b>Mapping from <a href=\"StructureDefinition-LogSocialHistoryCzEn.html\">A.2.6 Social History</a> to <a href=\"StructureDefinition-cz-observation-tobaccoUse-ps.html\">Observation – Tobacco Use (CZ PS)</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>tobaccoUse.status (A.2.6.1.2.1 Status)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>Smoking status as a coded value (e.g., current/former/never).</td></tr><tr><td>tobaccoUse.periodAndQuantity.period (A.2.6.1.2.2 Period and quantity - period)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.effectivePeriod</td><td>Time interval the reported tobacco use applies to.</td></tr><tr><td>tobaccoUse.periodAndQuantity.quantity (A.2.6.1.2.2 Period and quantity - quantity)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.component.valueQuantity</td><td>Average amount as component(s); each component SHALL define component.code (e.g., cigarettes/day) and use UCUM where possible.</td></tr><tr><td>tobaccoUse.comment (A.2.6.1.2.3 Comment)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.note</td><td/></tr></table><hr/><p><b>Group 4 </b>Mapping from <a href=\"StructureDefinition-LogSocialHistoryCzEn.html\">A.2.6 Social History</a> to <a href=\"StructureDefinition-cz-observation-drugUse-ps.html\">Observation – Drug Use (CZ PS)</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>drugUse.status (A.2.6.1.3.1 Status)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>Current status of drug use/dependence as coded value (e.g., current/former/never).</td></tr><tr><td>drugUse.periodAndQuantity.period (A.2.6.1.3.2 Period and quantity - period)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.effectivePeriod</td><td>Time interval the reported drug use applies to.</td></tr><tr><td>drugUse.periodAndQuantity.quantity (A.2.6.1.3.2 Period and quantity - quantity)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.component.valueQuantity</td><td>Represent administered amount/average quantity as component(s). Each component SHALL carry component.code (what is quantified) and valueQuantity with UCUM units where possible.</td></tr><tr><td>drugUse.substanceType (A.2.6.1.3.3 Substance type)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.component.valueCodeableConcept</td><td>Record the substance type as a component (component.code identifies 'substance'; valueCodeableConcept contains the substance code, e.g., ICD-10/SNOMED CT).</td></tr><tr><td>drugUse.routeOfAdministration (A.2.6.1.3.4 Route of administration)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.component.valueCodeableConcept</td><td>Route(s) of administration as component(s) (repeatable). component.code identifies 'route'; valueCodeableConcept holds the route code.</td></tr><tr><td>drugUse.comment (A.2.6.1.3.5 Comment)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.note</td><td/></tr></table><hr/><p><b>Group 5 </b>Mapping from <a href=\"StructureDefinition-LogSocialHistoryCzEn.html\">A.2.6 Social History</a> to <a href=\"StructureDefinition-cz-observation-otherAddictions-ps.html\">Observation – Other Addictions (CZ PS)</a></p><table class=\"grid\"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>otherAddictions (A.2.6.1.4 Other addictions)</td><td><a href=\"http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent\" title=\"equivalent\">is equivalent to</a></td><td>Observation.valueCodeableConcept</td><td>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).</td></tr></table></div>"
},
"url" : "https://hl7.cz/fhir/ps/ConceptMap/socialHistory2FHIR-cz-ps",
"version" : "0.0.1",
"name" : "SocialHistory2FHIRCzPs",
"title" : "ConceptMap: Social History to FHIR Patient Summary (CZ)",
"status" : "draft",
"experimental" : true,
"date" : "2025-12-29T14:27:43+00:00",
"publisher" : "HL7 Czech Republic",
"contact" : [
{
"name" : "HL7 Czech Republic",
"telecom" : [
{
"system" : "url",
"value" : "https://www.hl7.cz/"
}
]
}
],
"description" : "PS Social History Model to this guide mapping",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "CZ",
"display" : "Czechia"
}
]
}
],
"group" : [
{
"source" : "https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn",
"target" : "https://hl7.cz/fhir/ps/StructureDefinition/cz-composition-ps",
"element" : [
{
"code" : "substanceUse",
"display" : "A.2.7 - Social History",
"target" : [
{
"code" : "Composition.section:sectionSocialHistory",
"display" : "Composition.section:sectionSocialHistory",
"equivalence" : "equivalent"
}
]
},
{
"code" : "substanceUse.alcoholUse",
"display" : "A.2.6.1.1 Alcohol",
"target" : [
{
"code" : "Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation)",
"display" : "Composition.section:sectionSocialHistory.entry:entry:alcoholUse.ofType(Observation)",
"equivalence" : "equivalent"
}
]
},
{
"code" : "substanceUse.tobaccoUse",
"display" : "A.2.6.1.2 Tobacco use",
"target" : [
{
"code" : "Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation)",
"display" : "Composition.section:substanceUse.entry:tobaccoUse.ofType(Observation)",
"equivalence" : "equivalent"
}
]
},
{
"code" : "substanceUse.drugUse",
"display" : "A.2.6.1.3 Drugs",
"target" : [
{
"code" : "Composition.section:substanceUse.entry:drugUse.ofType(Observation)",
"display" : "Composition.section:substanceUse.entry:drugUse.ofType(Observation)",
"equivalence" : "equivalent"
}
]
}
]
},
{
"source" : "https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn",
"target" : "https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-alcoholUse-ps",
"element" : [
{
"code" : "alcoholUse.status",
"display" : "A.2.6.1.1.1 Status",
"target" : [
{
"code" : "Observation.valueCodeableConcept",
"display" : "Observation.valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "Use valueCodeableConcept to represent the current alcohol use status (e.g., current/former/never)."
}
]
},
{
"code" : "alcoholUse.periodAndQuantity",
"display" : "A.2.6.1.1.2 Period and quantity",
"target" : [
{
"code" : "Observation.effectivePeriod",
"display" : "Observation.effectivePeriod",
"equivalence" : "equivalent",
"comment" : "Use effectivePeriod to capture the time interval the reported alcohol use applies to."
}
]
},
{
"code" : "alcoholUse.periodAndQuantity",
"display" : "A.2.6.1.1.2 Period and quantity",
"target" : [
{
"code" : "Observation.component[x].valueQuantity",
"display" : "Observation.component[x].valueQuantity",
"equivalence" : "equivalent",
"comment" : "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."
}
]
},
{
"code" : "alcoholUse.comment",
"display" : "A.2.6.1.1.3 Comment",
"target" : [
{
"code" : "Observation.note",
"display" : "Observation.note",
"equivalence" : "equivalent"
}
]
}
]
},
{
"source" : "https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn",
"target" : "https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-tobaccoUse-ps",
"element" : [
{
"code" : "tobaccoUse.status",
"display" : "A.2.6.1.2.1 Status",
"target" : [
{
"code" : "Observation.valueCodeableConcept",
"display" : "Observation.valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "Smoking status as a coded value (e.g., current/former/never)."
}
]
},
{
"code" : "tobaccoUse.periodAndQuantity.period",
"display" : "A.2.6.1.2.2 Period and quantity - period",
"target" : [
{
"code" : "Observation.effectivePeriod",
"display" : "Observation.effectivePeriod",
"equivalence" : "equivalent",
"comment" : "Time interval the reported tobacco use applies to."
}
]
},
{
"code" : "tobaccoUse.periodAndQuantity.quantity",
"display" : "A.2.6.1.2.2 Period and quantity - quantity",
"target" : [
{
"code" : "Observation.component.valueQuantity",
"display" : "Observation.component.valueQuantity",
"equivalence" : "equivalent",
"comment" : "Average amount as component(s); each component SHALL define component.code (e.g., cigarettes/day) and use UCUM where possible."
}
]
},
{
"code" : "tobaccoUse.comment",
"display" : "A.2.6.1.2.3 Comment",
"target" : [
{
"code" : "Observation.note",
"display" : "Observation.note",
"equivalence" : "equivalent"
}
]
}
]
},
{
"source" : "https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn",
"target" : "https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-drugUse-ps",
"element" : [
{
"code" : "drugUse.status",
"display" : "A.2.6.1.3.1 Status",
"target" : [
{
"code" : "Observation.valueCodeableConcept",
"display" : "Observation.valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "Current status of drug use/dependence as coded value (e.g., current/former/never)."
}
]
},
{
"code" : "drugUse.periodAndQuantity.period",
"display" : "A.2.6.1.3.2 Period and quantity - period",
"target" : [
{
"code" : "Observation.effectivePeriod",
"display" : "Observation.effectivePeriod",
"equivalence" : "equivalent",
"comment" : "Time interval the reported drug use applies to."
}
]
},
{
"code" : "drugUse.periodAndQuantity.quantity",
"display" : "A.2.6.1.3.2 Period and quantity - quantity",
"target" : [
{
"code" : "Observation.component.valueQuantity",
"display" : "Observation.component.valueQuantity",
"equivalence" : "equivalent",
"comment" : "Represent administered amount/average quantity as component(s). Each component SHALL carry component.code (what is quantified) and valueQuantity with UCUM units where possible."
}
]
},
{
"code" : "drugUse.substanceType",
"display" : "A.2.6.1.3.3 Substance type",
"target" : [
{
"code" : "Observation.component.valueCodeableConcept",
"display" : "Observation.component.valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "Record the substance type as a component (component.code identifies 'substance'; valueCodeableConcept contains the substance code, e.g., ICD-10/SNOMED CT)."
}
]
},
{
"code" : "drugUse.routeOfAdministration",
"display" : "A.2.6.1.3.4 Route of administration",
"target" : [
{
"code" : "Observation.component.valueCodeableConcept",
"display" : "Observation.component.valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "Route(s) of administration as component(s) (repeatable). component.code identifies 'route'; valueCodeableConcept holds the route code."
}
]
},
{
"code" : "drugUse.comment",
"display" : "A.2.6.1.3.5 Comment",
"target" : [
{
"code" : "Observation.note",
"display" : "Observation.note",
"equivalence" : "equivalent"
}
]
}
]
},
{
"source" : "https://hl7.cz/fhir/ps/StructureDefinition/LogSocialHistoryCzEn",
"target" : "https://hl7.cz/fhir/ps/StructureDefinition/cz-observation-otherAddictions-ps",
"element" : [
{
"code" : "otherAddictions",
"display" : "A.2.6.1.4 Other addictions",
"target" : [
{
"code" : "Observation.valueCodeableConcept",
"display" : "Observation.valueCodeableConcept",
"equivalence" : "equivalent",
"comment" : "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)."
}
]
}
]
}
]
}