CHMED Implementation Guide
3.0.0-ci-build - ci-build Switzerland flag

CHMED Implementation Guide, published by IG eMediplan. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ci-build built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/ahdis/chmed/ and changes regularly. See the Directory of published versions

Resource Profile: CHMEDPatientCard - Mappings

Active as of 2024-04-24

Mappings for the chmed-card-patient resource profile.

Mappings for eMediplan (https://emediplan.ch/wp-content/uploads/2023/09/20230815_eMediplan_ChMed23A_1.0-AND-eMediplan_ChMed23A_Posology_1.0.pdf)

CHMEDPatientCard
PatientPatient
   extension (exts)Extension, exts -> Extension
   identifierids -> PatientId
      typePatientId.type (1: Insurance card number, 2: Local PID)
      systemPatientId.sId
      valuePatientId.val
   identifier (LocalPid)PatientId.type = 1: Insurance card number
   identifier (insuranceCardNumber)PatientId.type = 2: Local PID
   name
      familylName
      givenfName
   telecom (email)emails
   telecom (phone)phones
   gendergender (1: Male, 2: Female, 3: Other)
   birthDatebdt
   address
      linestreet
      citycity
      postalCodezip
   communication (languageOfCorrespondence)lng

Mappings for RIM Mapping (http://hl7.org/v3)

CHMEDPatientCard
PatientEntity. Role, or Act, Patient[classCode=PAT]
   textAct.text?
   containedN/A
   modifierExtensionN/A
   identifierid
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (LocalPid)id
   identifier (insuranceCardNumber)n/a, II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT]
   activestatusCode
   namen/a, EN (actually, PN)
      idn/a
      extensionn/a
      useunique(./use)
      text./formatted
      family./part[partType = FAM]
      given./part[partType = GIV]
      prefix./part[partType = PFX]
         extension (salutationandtitle)ENXP.qualifier
      suffix./part[partType = SFX]
      period./usablePeriod[type="IVL<TS>"]
   telecomtelecom
   telecom (email)n/a, TEL
   telecom (phone)n/a, TEL
   telecom (internet)n/a, TEL
   genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
   birthDateplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/birthTime
   deceased[x]player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/deceasedTime
   addressn/a, AD
      idn/a
      extensionn/a
      useunique(./use)
      typeunique(./use)
      text./formatted
      lineAD.part[parttype = AL]
         extension
         extension (addressLine1)
            idn/a
            urlN/A
            value[x]N/A
            value[x] (valueCode)N/A
         extension (addressLine2)
            idn/a
            urlN/A
            value[x]N/A
            value[x] (valueCode)N/A
         extension (street)
            idn/a
            urlN/A
            value[x]N/A
            value[x] (valueCode)N/A
         extension (streetName)ADXP[partType=STR]
         extension (houseNumber)ADXP[partType=BNR]
         extension (unitID)ADXP[partType=UNID]
         extension (postOfficeBoxText)
            idn/a
            urlN/A
            value[x]N/A
            value[x] (valueCode)N/A
         extension (postOfficeBoxNumber)ADXP[partType=POB]
      cityAD.part[parttype = CTY]
      districtAD.part[parttype = CNT | CPA]
      stateAD.part[parttype = STA]
      postalCodeAD.part[parttype = ZIP]
      countryAD.part[parttype = CNT]
         extension (countrycode)SC.code
      period./usablePeriod[type="IVL<TS>"]
   maritalStatusplayer[classCode=PSN]/maritalStatusCode
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   multipleBirth[x]player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthInd, player[classCode=PSN|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber
   photoplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/desc
   contactplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
      idn/a
      extensionn/a
      modifierExtensionN/A
      relationshipcode
      namename
      telecomtelecom
      addressaddr
      genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      organizationscoper
      periodeffectiveTime
   contact (contact)player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
      idn/a
      extensionn/a
      modifierExtensionN/A
      relationshipcode
      namename
      addressn/a, AD
      genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      organizationscoper
      periodeffectiveTime
   contact (nameOfFather)player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
      idn/a
      extensionn/a
      modifierExtensionN/A
      relationshipcode
      namename
      telecomtelecom
      addressaddr
      genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      organizationscoper
      periodeffectiveTime
   contact (nameOfMother)player[classCode=PSN|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]
      idn/a
      extensionn/a
      modifierExtensionN/A
      relationshipcode
      namename
      telecomtelecom
      addressaddr
      genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      organizationscoper
      periodeffectiveTime
   communicationLanguageCommunication
      idn/a
      extensionn/a
      modifierExtensionN/A
      languageplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code
      preferredpreferenceInd
   communication (languageOfCorrespondence)LanguageCommunication
      idn/a
      extensionn/a
      modifierExtensionN/A
      languageplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code
      preferredpreferenceInd
   generalPractitionersubjectOf.CareEvent.performer.AssignedEntity
   managingOrganizationscoper
   linkoutboundLink
      idn/a
      extensionn/a
      modifierExtensionN/A
      otherid
      typetypeCode

Mappings for CDA (R2) (http://hl7.org/v3/cda)

CHMEDPatientCard
PatientClinicalDocument.recordTarget.patientRole
   identifier.id
   identifier (LocalPid).id
   activen/a
   telecom.telecom
   gender.patient.administrativeGenderCode
   birthDate.patient.birthTime
   deceased[x]n/a
   maritalStatus.patient.maritalStatusCode
   multipleBirth[x]n/a
   photon/a
   contactn/a
      relationshipn/a
      namen/a
      telecomn/a
      addressn/a
      gendern/a
      organizationn/a
      periodn/a
   contact (contact)n/a
      relationshipn/a
      namen/a
      gendern/a
      organizationn/a
      periodn/a
   contact (nameOfFather)n/a
      relationshipn/a
      namen/a
      telecomn/a
      addressn/a
      gendern/a
      organizationn/a
      periodn/a
   contact (nameOfMother)n/a
      relationshipn/a
      namen/a
      telecomn/a
      addressn/a
      gendern/a
      organizationn/a
      periodn/a
   communicationpatient.languageCommunication
      language.languageCode
      preferred.preferenceInd
   communication (languageOfCorrespondence)patient.languageCommunication
      language.languageCode
      preferred.preferenceInd
   generalPractitionern/a
   managingOrganization.providerOrganization
   linkn/a
      othern/a
      typen/a

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

CHMEDPatientCard
Patient
   identifierFiveWs.identifier
   identifier (LocalPid)FiveWs.identifier
   activeFiveWs.status

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

CHMEDPatientCard
Patient
   identifierPID-3
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (LocalPid)PID-3
   identifier (insuranceCardNumber)CX / EI (occasionally, more often EI maps to a resource id or a URL)
   nameXPN
      useXPN.7, but often indicated by which field contains the name
      textimplied by XPN.11
      familyXPN.1/FN.1
      givenXPN.2 + XPN.3
      prefixXPN.5
      suffixXPN/4
      periodXPN.13 + XPN.14
   telecomPID-13, PID-14, PID-40, -> as of HL7 v2.7 PID-40 (leave PID-13 and PID-14 empty)
   telecom (email)XTN
   telecom (phone)XTN
   telecom (internet)XTN
   genderPID-8
   birthDatePID-7
   deceased[x]PID-30 (bool) and PID-29 (datetime)
   addressXAD
      useXAD.7
      typeXAD.18
      textXAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
      lineXAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
      cityXAD.3
      districtXAD.9
      stateXAD.4
      postalCodeXAD.5
      countryXAD.6
      periodXAD.12 / XAD.13 + XAD.14
   maritalStatusPID-16
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   multipleBirth[x]PID-24 (bool), PID-25 (integer)
   photoOBX-5 - needs a profile
   contact
      relationshipNK1-7, NK1-3
      nameNK1-2
      telecomNK1-5, NK1-6, NK1-40
      addressNK1-4
      genderNK1-15
      organizationNK1-13, NK1-30, NK1-31, NK1-32, NK1-41
   contact (contact)
      relationshipNK1-7, NK1-3
      nameNK1-2
      addressXAD
      genderNK1-15
      organizationNK1-13, NK1-30, NK1-31, NK1-32, NK1-41
   contact (nameOfFather)
      relationshipNK1-7, NK1-3
      nameNK1-2
      telecomNK1-5, NK1-6, NK1-40
      addressNK1-4
      genderNK1-15
      organizationNK1-13, NK1-30, NK1-31, NK1-32, NK1-41
   contact (nameOfMother)
      relationshipNK1-7, NK1-3
      nameNK1-2
      telecomNK1-5, NK1-6, NK1-40
      addressNK1-4
      genderNK1-15
      organizationNK1-13, NK1-30, NK1-31, NK1-32, NK1-41
   communication
      languagePID-15, LAN-2
      preferredPID-15
   communication (languageOfCorrespondence)
      languagePID-15, LAN-2
      preferredPID-15
   generalPractitionerPD1-4
   link
      otherPID-3, MRG-1

Mappings for LOINC code for the element (http://loinc.org)

CHMEDPatientCard
Patient
   birthDate21112-8

Mappings for eCH-Standards (http://www.ech.ch/)

CHMEDPatientCard
Patient
   extension (placeOfBirth)eCH-0011: 3.3.3.2 placeOfBirth BFS-322, BFS-323, BFS 324
   extension (placeOfOrigin)eCH-0011: 3.3.10 placeOfOrigin, BFS-42
   extension (citizenship)eCH-0011: 3.3.6 nationalityData
   extension (religion)eCH-0011: 3.3.4.1 religion, BFS-711
   nameeCH-0011: 3.3.2 nameData
      familyeCH-0010: lastName
         extension (ech11name)eCH-0011: officialName, originalName, allianceName, nameOnForeignPassport, aliasName, otherName, declaredForeignName
      giveneCH-0010: firstName equivalent to callName of eCH-0011
         extension (ech11firstname)eCH-0011: officialFirstName, callName, allianceName, firstNameOnForeignPassport, declaredForeignFirstName1
      prefixeCH-0010: mrMrs, title
   telecomeCH-0046: Contact
   telecom (email)eCH-0046: 4.3 email
   telecom (phone)eCH-0046: 4.4 phone
   telecom (internet)eCH-0046: 4.5 internet
   gendereCH-0011: 3.3.3 sex. sexType, BFS-33, see ConceptMap http://fhir.ch/ig/ch-core/ConceptMap/sex-ech11-to-fhir
   birthDateeCH-0011: 3.3.3 birthData, BFS-31
   deceased[x]eCH-0011: 3.3.7 deathData, deathPeriod, dateFrom, BFS-361
   addresseCH-0010: 5.5 addressInformation
      line
         extension (addressLine1)eCH-0010: 5.12 addressLine1
         extension (addressLine2)eCH-0010: 5.12 addressLine2
         extension (street)eCH-0010: 5.13 street
         extension (streetName)eCH-0010: 5.13 streetName
         extension (houseNumber)eCH-0010: 5.14 houseNumber
         extension (unitID)eCH-0010: 5.15 dwellingNumber
         extension (postOfficeBoxText)eCH-0010: 5.17 postOfficeBoxText
         extension (postOfficeBoxNumber)eCH-0010: 5.16 postOfficeBoxNumber
      cityeCH-0010: 5.23 town
      districteCH-0010: 5.22 locality
      stateeCH-0010: 5.22 locality
      postalCodeeCH-0010: 5.18 swissZipCode, 5.19 swissZipCodeAddOn, 5.20 swissZipCodeId, 5.21 foreignZipCode
      countryeCH-0010: 5.24 country
   maritalStatuseCH-0011: 3.3.5 maritalData, BFS-341, see ConceptMap http://fhir.ch/ig/ch-core/ConceptMap/maritalstatus-ech11-to-fhir
      extension (maritalDataSeparation)eCH-0011: 3.3.5.5 separation - Trennung BFS-343
   contact
   contact (contact)eCH-0011: 3.3.8 contactData, BFS-61
      addresseCH-0010: 5.5 addressInformation
   contact (nameOfFather)eCH-0021: 4.1.4.1 nameOfFather
   contact (nameOfMother)eCH-0021: 4.1.4.2 nameOfMother
   communication (languageOfCorrespondence)eCH-0011: 3.3.9 languageOfCorrespondance: de, fr, it, rm = Rhaeto-Romance, en, other languages ISO 639-1