RIVO Noord Zorgviewer MVP2 Implementation Guide
0.2.1 - CI build Netherlands flag

RIVO Noord Zorgviewer MVP2 Implementation Guide - Local Development build (v0.2.1). See the Directory of published versions

Resource Profile: Patient - Mappings

Draft as of 2023-03-22

Mappings for the Patient resource profile.

Mappings for HCIM Patient-v2.0.1(2015EN) (https://zibs.nl/wiki/Patient-v2.0.1(2015EN))

Patient
PatientNL-CM:0.1.1
   identifierNL-CM:0.1.7
   nameNL-CM:0.1.6
   telecomNL-CM:0.1.5
   genderNL-CM:0.1.9
   birthDateNL-CM:0.1.10
   deceased[x]NL-CM:0.1.32, NL-CM:0.1.33
   addressNL-CM:0.1.4
   multipleBirth[x]NL-CM:0.1.31

Mappings for HCIM MaritalStatus-v1.2.1(2015EN) (https://zibs.nl/wiki/MaritalStatus-v1.2.1(2015EN))

Patient
Patient
   maritalStatusNL-CM:7.9.2

Mappings for HCIM ContactPerson-v1.2(2015EN) (https://zibs.nl/wiki/ContactPerson-v1.2(2015EN))

Patient
Patient
   contactNL-CM:3.1.1
      relationship (relationship)NL-CM:3.1.3
      relationship (role)NL-CM:3.1.2
      nameNL-CM:3.1.4
      telecomNL-CM:3.1.6
      addressNL-CM:3.1.5

Mappings for HCIM HealthcareProvider-v1.2(2015EN) (https://zibs.nl/wiki/HealthcareProvider-v1.2(2015EN))

Patient
Patient
   generalPractitionerNL-CM:17.2.1

Mappings for HCIM HealthProfessional-v1.2.1(2015EN) (https://zibs.nl/wiki/HealthProfessional-v1.2.1(2015EN))

Patient
Patient
   generalPractitionerNL-CM:17.1.1

Mappings for HCIM Nationality-v2.0(2015EN) (https://zibs.nl/wiki/Nationality-v2.0(2015EN))

Patient
Patient
   extension (nationality)NL-CM:7.6.3

Mappings for HCIM Payer-v1.2(2015EN) (https://zibs.nl/wiki/Payer-v1.2(2015EN))

Patient
PatientNL-CM:1.1.2
   nameNL-CM:1.1.5
      textNL-CM:1.1.5
   telecomNL-CM:1.1.12
   addressNL-CM:1.1.17
   contact
      name
         textNL-CM:1.1.5

Mappings for HCIM Patient-v3.0(2016EN) (https://zibs.nl/wiki/Patient-v3.0(2016EN))

Patient
PatientNL-CM:0.1.1
   identifierNL-CM:0.1.7
   nameNL-CM:0.1.6
   telecomNL-CM:0.1.5
   genderNL-CM:0.1.9
   birthDateNL-CM:0.1.10
   deceased[x]NL-CM:0.1.32, NL-CM:0.1.33
   addressNL-CM:0.1.4
   multipleBirth[x]NL-CM:0.1.31

Mappings for HCIM MaritalStatus-v3.0(2016EN) (https://zibs.nl/wiki/MaritalStatus-v3.0(2016EN))

Patient
Patient
   maritalStatusNL-CM:7.9.2

Mappings for HCIM ContactPerson-v3.0(2016EN) (https://zibs.nl/wiki/ContactPerson-v3.0(2016EN))

Patient
Patient
   contactNL-CM:3.1.1
      relationship (relationship)NL-CM:3.1.3
      relationship (role)NL-CM:3.1.2
      nameNL-CM:3.1.4
      telecomNL-CM:3.1.6
      addressNL-CM:3.1.5

Mappings for HCIM HealthcareProvider-v3.0(2016EN) (https://zibs.nl/wiki/HealthcareProvider-v3.0(2016EN))

Patient
Patient
   generalPractitionerNL-CM:17.2.1

Mappings for HCIM HealthProfessional-v3.0(2016EN) (https://zibs.nl/wiki/HealthProfessional-v3.0(2016EN))

Patient
Patient
   generalPractitionerNL-CM:17.1.1

Mappings for HCIM Nationality-v3.0(2016EN) (https://zibs.nl/wiki/Nationality-v3.0(2016EN))

Patient
Patient
   extension (nationality)NL-CM:7.6.3

Mappings for HCIM Payer-v3.0(2016EN) (https://zibs.nl/wiki/Payer-v3.0(2016EN))

Patient
PatientNL-CM:1.1.2
   nameNL-CM:1.1.5
      textNL-CM:1.1.5
   telecomNL-CM:1.1.12
   addressNL-CM:1.1.17
   contact
      name
         textNL-CM:1.1.5

Mappings for HCIM Patient-v3.1(2017EN) (https://zibs.nl/wiki/Patient-v3.1(2017EN))

Patient
PatientNL-CM:0.1.1
   identifierNL-CM:0.1.7
   nameNL-CM:0.1.6
   telecomNL-CM:0.1.5
   genderNL-CM:0.1.9
   birthDateNL-CM:0.1.10
   deceased[x]NL-CM:0.1.32, NL-CM:0.1.33
   addressNL-CM:0.1.4
   multipleBirth[x]NL-CM:0.1.31

Mappings for HCIM MaritalStatus-v3.0(2017EN) (https://zibs.nl/wiki/MaritalStatus-v3.0(2017EN))

Patient
Patient
   maritalStatusNL-CM:7.9.2

Mappings for HCIM ContactPerson-v3.1(2017EN) (https://zibs.nl/wiki/ContactPerson-v3.1(2017EN))

Patient
Patient
   contactNL-CM:3.1.1
      relationship (relationship)NL-CM:3.1.3
      relationship (role)NL-CM:3.1.2
      nameNL-CM:3.1.4
      telecomNL-CM:3.1.6
      addressNL-CM:3.1.5

Mappings for HCIM HealthcareProvider-v3.1.1(2017EN) (https://zibs.nl/wiki/HealthcareProvider-v3.1.1(2017EN))

Patient
Patient
   generalPractitionerNL-CM:17.2.1

Mappings for HCIM HealthProfessional-v3.2(2017EN) (https://zibs.nl/wiki/HealthProfessional-v3.2(2017EN))

Patient
Patient
   generalPractitionerNL-CM:17.1.1

Mappings for HCIM Nationality-v3.0(2017EN) (https://zibs.nl/wiki/Nationality-v3.0(2017EN))

Patient
Patient
   extension (nationality)NL-CM:7.6.3

Mappings for HCIM Payer-v3.1(2017EN) (https://zibs.nl/wiki/Payer-v3.1(2017EN))

Patient
PatientNL-CM:1.1.2
   nameNL-CM:1.1.5
      textNL-CM:1.1.5
   telecomNL-CM:1.1.12
   addressNL-CM:1.1.17
   contact
      name
         textNL-CM:1.1.5

Mappings for HCIM ContactInformation-v1.0(2017EN) (https://zibs.nl/wiki/ContactInformation-v1.0(2017EN))

ContactInformation has become an independent information model as of release 2017 of the HCIMs.

Patient
Patient
   telecomNL-CM:20.6.1
   contact
      telecomNL-CM:20.6.1

Mappings for HCIM LanguageProficiency-v3.1(2017EN) (https://zibs.nl/wiki/LanguageProficiency-v3.1(2017EN))

Patient
Patient
   communicationNL-CM:7.12.1
      extension (languageProficiency)NL-CM:7.12.6, NL-CM:7.12.7, NL-CM:7.12.8
      extension (comment)NL-CM:7.12.5
      languageNL-CM:7.12.3

Mappings for HCIM FreedomRestrictingMeasures-v3.1(2017EN) (https://zibs.nl/wiki/FreedomRestrictingMeasures-v3.1(2017EN))

Concerns only LegalStatus concept. This will become an independent information model as of release 2018 of the HCIMs.

Patient
Patient
   extension (legalStatus)NL-CM:14.3.2

Mappings for HCIM BasicElements-v1.0(2017EN) (https://zibs.nl/wiki/BasicElements-v1.0(2017EN))

Patient
PatientNL-CM:0.0.3, NL-CM:0.0.8, NL-CM:0.0.12
   identifierNL-CM:0.0.6

Mappings for HCIM FamilySituation-v1.0(2015EN) (https://zibs.nl/wiki/FamilySituation-v1.0(2015EN))

Patient
Patient
   maritalStatusNL-CM:7.13.7

Mappings for HCIM FamilySituation-v3.0(2016EN) (https://zibs.nl/wiki/FamilySituation-v3.0(2016EN))

Patient
Patient
   maritalStatusNL-CM:7.13.7

Mappings for HCIM FamilySituation-v3.0(2017EN) (https://zibs.nl/wiki/FamilySituation-v3.0(2017EN))

Patient
Patient
   maritalStatusNL-CM:7.13.7

Mappings for HCIM LifeStance-v3.1(2017EN) (https://zibs.nl/wiki/LifeStance-v3.1(2017EN))

Patient
Patient
   extension
   extension (preferredPharmacy)
   extension (nationality)
   extension (legalStatus)
   extension (lifeStance)
      value[x] (valueCodeableConcept)NL-CM:7.5.2

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

Patient
PatientEntity. Role, or Act, Patient[classCode=PAT]
   textAct.text?
   containedN/A
   extension
   extension (preferredPharmacy)n/a, N/A
   extension (nationality)
      idn/a
      extensionn/a
      extension (code)
         idn/a
         extensionn/a
         urlN/A
         valueCodeableConcept (valueCodeableConcept)N/A
      extension (period)
         idn/a
         extensionn/a
         urlN/A
         valuePeriod (valuePeriod)N/A
      urlN/A
   extension (legalStatus)
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
      value[x] (valueCodeableConcept)N/A
         idn/a
         extensionn/a
         codingunion(., ./translation)
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
         text./originalText[mediaType/code="text/plain"]/data
   extension (lifeStance)n/a, N/A
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
      value[x] (valueCodeableConcept)N/A
         idn/a
         extensionn/a
         codingunion(., ./translation)
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
         text./originalText[mediaType/code="text/plain"]/data
   modifierExtensionN/A
   identifierid
   identifier (BSN)id
      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
   activestatusCode
   namen/a, EN (actually, PN)
      idn/a
      extension
      extension (humannameAssemblyOrder)
         idn/a
         extensionn/a
         urlN/A
         valueCode (valueCode)N/A
      useunique(./use)
      text./formatted
      family./part[partType = FAM]
         extension
         extension (humannameOwnPrefix)ENXP where Qualifiers = (VV, R)
            idn/a
            extensionn/a
            urlN/A
            valueString (valueString)N/A
         extension (humannameOwnName)ENXP where Qualifiers = (BR)
            idn/a
            extensionn/a
            urlN/A
            valueString (valueString)N/A
         extension (humannamePartnerPrefix)ENXP where Qualifiers = (VV, SP)
            idn/a
            extensionn/a
            urlN/A
            valueString (valueString)N/A
         extension (humannamePartnerName)ENXP where Qualifiers = (SP)
            idn/a
            extensionn/a
            urlN/A
            valueString (valueString)N/A
      given./part[partType = GIV]
         extension
         extension (iso21090EnQualifier)ENXP.qualifier
            idn/a
            extensionn/a
            urlN/A
            valueCode (valueCode)N/A
      prefix./part[partType = PFX]
      suffix./part[partType = SFX]
      period./usablePeriod[type="IVL<TS>"]
   telecomn/a, TEL
   genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      extension
      extension (GeslachtCodelijst)
         idn/a
         extensionn/a
         urlN/A
         value[x]N/A
         value[x] (valueCodeableConcept)N/A
   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
   maritalStatusplayer[classCode=PSN]/maritalStatusCode
   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
      relationship (relationship)code
      relationship (role)code
      namen/a, EN (actually, PN)
         idn/a
         extension
         extension (humannameAssemblyOrder)
            idn/a
            extensionn/a
            urlN/A
            valueCode (valueCode)N/A
         useunique(./use)
         text./formatted
         family./part[partType = FAM]
            extension
            extension (humannameOwnPrefix)ENXP where Qualifiers = (VV, R)
               idn/a
               extensionn/a
               urlN/A
               valueString (valueString)N/A
            extension (humannameOwnName)ENXP where Qualifiers = (BR)
               idn/a
               extensionn/a
               urlN/A
               valueString (valueString)N/A
            extension (humannamePartnerPrefix)ENXP where Qualifiers = (VV, SP)
               idn/a
               extensionn/a
               urlN/A
               valueString (valueString)N/A
            extension (humannamePartnerName)ENXP where Qualifiers = (SP)
               idn/a
               extensionn/a
               urlN/A
               valueString (valueString)N/A
         given./part[partType = GIV]
            extension
            extension (iso21090EnQualifier)ENXP.qualifier
               idn/a
               extensionn/a
               urlN/A
               valueCode (valueCode)N/A
         prefix./part[partType = PFX]
         suffix./part[partType = SFX]
         period./usablePeriod[type="IVL<TS>"]
      telecomn/a, TEL
      addressn/a, AD
      genderplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/administrativeGender
      organizationscoper
      periodeffectiveTime
   animalplayer[classCode=ANM]
      idn/a
      extensionn/a
      modifierExtensionN/A
      speciescode
      breedplayedRole[classCode=GEN]/scoper[classCode=ANM, determinerCode=KIND]/code
      genderStatusgenderStatusCode
   communicationLanguageCommunication
      idn/a
      extension
      extension (languageProficiency)
         idn/a
         extension
         extension (type)
            idn/a
            extensionn/a
            urlN/A
            value[x]N/A
            value[x] (valueCoding)N/A
         extension (level)
            idn/a
            extensionn/a
            urlN/A
            value[x]N/A
            value[x] (valueCoding)N/A
         urlN/A
      modifierExtensionN/A
      languageplayer[classCode=PSN|ANM and determinerCode=INSTANCE]/languageCommunication/code
      preferredpreferenceInd
   generalPractitionersubjectOf.CareEvent.performer.AssignedEntity
      idn/a
      extension (practitionerRole)n/a, N/A
      referenceN/A
      identifier.identifier
      displayN/A
   managingOrganizationscoper
   linkoutboundLink
      idn/a
      extensionn/a
      modifierExtensionN/A
      otherid
      typetypeCode

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

Patient
PatientClinicalDocument.recordTarget.patientRole
   identifier.id
   identifier (BSN).id
   activen/a
   gender.patient.administrativeGenderCode
   birthDate.patient.birthTime
   deceased[x]n/a
   maritalStatus.patient.maritalStatusCode
   multipleBirth[x]n/a
   photon/a
   contactn/a
      relationshipn/a
      relationship (relationship)n/a
      relationship (role)n/a
      gendern/a
      organizationn/a
      periodn/a
   animaln/a
      speciesn/a
      breedn/a
      genderStatusn/a
   communicationpatient.languageCommunication
      language.languageCode
      preferred.preferenceInd
   generalPractitionern/a
   managingOrganization.providerOrganization
   linkn/a
      othern/a
      typen/a

Mappings for W5 Mapping (http://hl7.org/fhir/w5)

Patient
Patientadministrative.individual
   identifierid
   identifier (BSN)id
   activestatus

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

Patient
Patient
   extension
   extension (preferredPharmacy)
   extension (nationality)
   extension (legalStatus)
      value[x]
      value[x] (valueCodeableConcept)
         codingC*E.1-8, C*E.10-22
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
         textC*E.9. But note many systems use C*E.2 for this
   extension (lifeStance)
      value[x]
      value[x] (valueCodeableConcept)
         codingC*E.1-8, C*E.10-22
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
         textC*E.9. But note many systems use C*E.2 for this
   identifierPID-3
   identifier (BSN)PID-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)
   nameXPN
      useXPN.7, but often indicated by which field contains the name
      textimplied by XPN.11
      familyXPN.1/FN.1
         extension (humannameOwnPrefix)FN.2
         extension (humannameOwnName)FN.3
         extension (humannamePartnerPrefix)FN.4
         extension (humannamePartnerName)FN.5
      givenXPN.2 + XPN.3
      prefixXPN.5
      suffixXPN/4
      periodXPN.13 + XPN.14
   telecomXTN
   genderPID-8
   birthDatePID-7
   deceased[x]PID-30 (bool) and PID-29 (datetime)
   addressXAD
   maritalStatusPID-16
   multipleBirth[x]PID-24 (bool), PID-25 (integer)
   photoOBX-5 - needs a profile
   contact
      relationshipNK1-7, NK1-3
      relationship (relationship)NK1-7, NK1-3
      relationship (role)NK1-7, NK1-3
      nameXPN
         useXPN.7, but often indicated by which field contains the name
         textimplied by XPN.11
         familyXPN.1/FN.1
            extension (humannameOwnPrefix)FN.2
            extension (humannameOwnName)FN.3
            extension (humannamePartnerPrefix)FN.4
            extension (humannamePartnerName)FN.5
         givenXPN.2 + XPN.3
         prefixXPN.5
         suffixXPN/4
         periodXPN.13 + XPN.14
      telecomXTN
      addressXAD
      genderNK1-15
      organizationNK1-13, NK1-30, NK1-31, NK1-32, NK1-41
   animal
      speciesPID-35
      breedPID-37
      genderStatusN/A
   communication
      languagePID-15, LAN-2
      preferredPID-15
   generalPractitionerPD1-4
   link
      otherPID-3, MRG-1

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

Patient
Patient
   birthDate21112-8