RIVO-Noord Zorgviewer Implementation Guide
1.8.0 - CI build Netherlands flag

RIVO-Noord Zorgviewer Implementation Guide, published by RIVO-NN HL7NL. This guide is not an authorized publication; it is the continuous build for version 1.8.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/RIVO-Noord/zorgviewer-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Patient - Mappings

Active as of 2024-11-19

Mappings for the Patient resource profile.

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

Patient
PatientNL-CM:0.1.1

Patient

   identifierNL-CM:0.1.7

PatientIdentificationNumber

   nameNL-CM:0.1.6

NameInformation

   telecomNL-CM:0.1.5

ContactInformation

   genderNL-CM:0.1.9

Gender. Use FHIR Core ConceptMap for HCIM mapping: http://nictiz.nl/fhir/ConceptMap/GeslachtCodelijst-to-AdministrativeGender

   birthDateNL-CM:0.1.10

DateOfBirth

   deceased[x]NL-CM:0.1.32, NL-CM:0.1.33

DeathIndicator

,

DateOfDeath

   addressNL-CM:0.1.4

AddressInformation

   multipleBirth[x]NL-CM:0.1.31

MultipleBirthIndicator

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

Patient
Patient
   maritalStatusNL-CM:7.9.2

MaritalStatus

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

Patient
Patient
   contactNL-CM:3.1.1

Contact

      relationship (relationship)NL-CM:3.1.3

Relationship

      relationship (role)NL-CM:3.1.2

Role

      nameNL-CM:3.1.4

NameInformation

      telecomNL-CM:3.1.6

ContactInformation

      addressNL-CM:3.1.5

AddressInformation

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

Patient
Patient
   generalPractitionerNL-CM:17.2.1

HealthcareProvider

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

Patient
Patient
   generalPractitionerNL-CM:17.1.1

HealthProfessional

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

Patient
Patient
   extension (nationality)NL-CM:7.6.3

Nationality

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

Patient
PatientNL-CM:1.1.2

PayerPerson

   nameNL-CM:1.1.5

PayerName

      textNL-CM:1.1.5

PayerName

   telecomNL-CM:1.1.12

ContactInformation

   addressNL-CM:1.1.17

AddressInformation

   contact
      name
         textNL-CM:1.1.5

PayerName

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

ContactInformation

   contact
      telecomNL-CM:20.6.1

ContactInformation

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

Patient
Patient
   communicationNL-CM:7.12.1

LanguageProficiency

      extension (languageProficiency)NL-CM:7.12.6, NL-CM:7.12.7, NL-CM:7.12.8

LanguageControlListening

,

LanguageControlSpeaking

,

LanguageControlReading

      extension (comment)NL-CM:7.12.5

Comment

      languageNL-CM:7.12.3

CommunicationLanguage

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

LegalStatus

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

PatientAsInformationSource::Patient

,

PatientAsAuthor::Patient

,

Patient

   identifierNL-CM:0.0.6

IdentificationNumber

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

Patient
Patient
   maritalStatusNL-CM:7.13.7

FamilySituation

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

LifeStance

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

Patient
PatientNL-CM:0.1.1

Patient

   identifierNL-CM:0.1.7

PatientIdentificationNumber

   nameNL-CM:0.1.6

NameInformation

   telecomNL-CM:0.1.5

ContactInformation

   genderNL-CM:0.1.9

Gender. Use FHIR Core ConceptMap for HCIM mapping: http://nictiz.nl/fhir/ConceptMap/GeslachtCodelijst-to-AdministrativeGender

   birthDateNL-CM:0.1.10

DateOfBirth

   deceased[x]NL-CM:0.1.32, NL-CM:0.1.33

DeathIndicator

,

DateOfDeath

   addressNL-CM:0.1.4

AddressInformation

   multipleBirth[x]NL-CM:0.1.31

MultipleBirthIndicator

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

Patient
Patient
   maritalStatusNL-CM:7.9.2

MaritalStatus

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

Patient
Patient
   contactNL-CM:3.1.1

Contact

      relationship (relationship)NL-CM:3.1.3

Relationship

      relationship (role)NL-CM:3.1.2

Role

      nameNL-CM:3.1.4

NameInformation

      telecomNL-CM:3.1.6

TelephoneEmail::ContactInformation

      addressNL-CM:3.1.5

AddressInformation

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

Patient
Patient
   generalPractitionerNL-CM:17.2.1

HealthcareProvider

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

Patient
Patient
   generalPractitionerNL-CM:17.1.1

HealthProfessional

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

Patient
Patient
   extension (nationality)NL-CM:7.6.3

Nationality

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

Patient
PatientNL-CM:1.1.2

PayerPerson

   nameNL-CM:1.1.5

PayerName

      textNL-CM:1.1.5

PayerName

   telecomNL-CM:1.1.12

TelephoneEmail::ContactInformation

   addressNL-CM:1.1.17

Address

   contact
      name
         textNL-CM:1.1.5

PayerName

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

Patient
Patient
   maritalStatusNL-CM:7.13.7

FamilySituation

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

Patient
PatientNL-CM:0.1.1

Patient

   identifierNL-CM:0.1.7

PatientIdentificationNumber

   nameNL-CM:0.1.6

NameInformation

   telecomNL-CM:0.1.5

ContactInformation

   genderNL-CM:0.1.9

Gender. Use FHIR Core ConceptMap for HCIM mapping: http://nictiz.nl/fhir/ConceptMap/GeslachtCodelijst-to-AdministrativeGender

   birthDateNL-CM:0.1.10

DateOfBirth

   deceased[x]NL-CM:0.1.32, NL-CM:0.1.33

DeathIndicator

,

DateOfDeath

   addressNL-CM:0.1.4

AddressInformation

   multipleBirth[x]NL-CM:0.1.31

MultipleBirthIndicator

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

Patient
Patient
   maritalStatusNL-CM:7.9.2

MaritalStatus

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

Patient
Patient
   contactNL-CM:3.1.1

Contact

      relationship (relationship)NL-CM:3.1.3

Relationship

      relationship (role)NL-CM:3.1.2

Role

      nameNL-CM:3.1.4

NameInformation

      telecomNL-CM:3.1.6

TelephoneEmail::ContactInformation

      addressNL-CM:3.1.5

AddressInformation

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

Patient
Patient
   generalPractitionerNL-CM:17.2.1

HealthcareProvider

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

Patient
Patient
   generalPractitionerNL-CM:17.1.1

HealthProfessional

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

Patient
Patient
   extension (nationality)NL-CM:7.6.3

Nationality

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

Patient
PatientNL-CM:1.1.2

PayerPerson

   nameNL-CM:1.1.5

PayerName

      textNL-CM:1.1.5

PayerName

   telecomNL-CM:1.1.12

TelephoneEmail::ContactInformation

   addressNL-CM:1.1.17

AddressInformation

   contact
      name
         textNL-CM:1.1.5

PayerName

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

Patient
Patient
   maritalStatusNL-CM:7.13.7

FamilySituation

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