FHIR IG analytics| Package | hl7.fhir.cz.ps |
| Resource Type | ConceptMap |
| Id | ConceptMap-socialHistory2FHIR-cz-ps.json |
| FHIR Version | R4 |
| Source | https://build.fhir.org/ig/HL7-cz/ps/ConceptMap-socialHistory2FHIR-cz-ps.html |
| URL | https://hl7.cz/fhir/ps/ConceptMap/socialHistory2FHIR-cz-ps |
| Version | 0.0.1 |
| Status | draft |
| Date | 2026-01-05T15:11:51+00:00 |
| Name | SocialHistory2FHIRCzPs |
| Title | ConceptMap: Social History to FHIR Patient Summary (CZ) |
| Realm | cz |
| Authority | hl7 |
| Description | PS Social History Model to this guide mapping |
No resources found
| StructureDefinition | |
| LogSocialHistoryCzEn | A.2.6 Social History |
| cz-composition-ps | Composition (CZ PS) |
| cz-observation-alcoholUse-ps | Observation – Alcohol Use (CZ PS) |
| cz-observation-drugUse-ps | Observation – Drug Use (CZ PS) |
| cz-observation-otherAddictions-ps | Observation – Other Addictions (CZ PS) |
| cz-observation-tobaccoUse-ps | Observation – Tobacco Use (CZ PS) |
Note: links and images are rebased to the (stated) source
Generated Narrative: ConceptMap socialHistory2FHIR-cz-ps
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). |
FHIR
FHIRsmith{
"resourceType": "ConceptMap",
"id": "socialHistory2FHIR-cz-ps",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"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": "2026-01-05T15:11:51+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)."
}
]
}
]
}
]
}