New Zealand HPI Implementation Guide
1.5.0 - Release

New Zealand HPI Implementation Guide, published by Te Whatu Ora. This guide is not an authorized publication; it is the continuous build for version 1.5.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7NZ/hpi/ and changes regularly. See the Directory of published versions

Resource Profile: HpiPractitioner - Mappings

Active as of 2024-12-17

Mappings for the HPIPractitioner resource profile.

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

HpiPractitioner
PractitionerPRD (as one example)
   identifierPRD-7 (or XCN.1)
      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 (HPI)PRD-7 (or XCN.1)
      useN/A
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (dormant)PRD-7 (or XCN.1)
      useN/A
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (RA)PRD-7 (or XCN.1)
      useN/A
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      assignerCX.4 / (CX.4,CX.9,CX.10)
   nameXCN Components
      useXPN.7, but often indicated by which field contains the name
      familyXPN.1/FN.1
      givenXPN.2 + XPN.3
      prefixXPN.5
   genderSTF-5
   birthDateSTF-6
   qualificationCER?
   communicationPID-15, NK1-20, LAN-2
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this

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

HpiPractitioner
PractitionerEntity. Role, or Act, Role
   textAct.text?
   containedN/A
   extension
   extension (death-date)
      idn/a
      extensionn/a
      extension (date)
         idn/a
         urlN/A
         value[x]N/A
      urlN/A
   extension (educational-qualification)
      idn/a
      extensionn/a
      extension (fullname)
         idn/a
         urlN/A
         value[x]N/A
      extension (shortname)
         idn/a
         urlN/A
         value[x]N/A
      extension (year)
         idn/a
         urlN/A
         value[x]N/A
      extension (institution)
         idn/a
         urlN/A
         value[x]N/A
      extension (city)
         idn/a
         urlN/A
         value[x]N/A
      extension (country)
         idn/a
         urlN/A
         value[x]N/A
      urlN/A
   modifierExtensionN/A
   identifier./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
   identifier (HPI)./id
      idn/a
      extensionn/a
      useRole.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)
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (dormant)./id
      idn/a
      extensionn/a
      useRole.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)
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (RA)./id
      idn/a
      extensionn/a
      useRole.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)
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   name./name
      idn/a
      extensionn/a
      useunique(./use)
      family./part[partType = FAM]
      given./part[partType = GIV]
      prefix./part[partType = PFX]
   gender./administrativeGender
   birthDate./birthTime
   qualification.playingEntity.playingRole[classCode=QUAL].code
      extension
      extension (additional-authorisation)
      extension (condition-on-practice)
      extension (registration-initial-date)
      extension (registration-status-code)
      extension (scope-of-practice)
         idn/a
         extensionn/a
         extension (code)
            idn/a
            urlN/A
            value[x]N/A
            value[x] (valueCodeableConcept)N/A
         extension (period)
            idn/a
            urlN/A
            value[x]N/A
         urlN/A
      modifierExtensionN/A
      identifier.playingEntity.playingRole[classCode=QUAL].id
      code.playingEntity.playingRole[classCode=QUAL].code
      period.playingEntity.playingRole[classCode=QUAL].effectiveTime
      issuer.playingEntity.playingRole[classCode=QUAL].scoper
   communication./languageCommunication
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data

Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)

HpiPractitioner
PractitionerProvider
   identifier./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   identifier (HPI)./Identifiers
      system./IdentifierType
      value./Value
      assigner./IdentifierIssuingAuthority
   identifier (dormant)./Identifiers
      system./IdentifierType
      value./Value
      assigner./IdentifierIssuingAuthority
   identifier (RA)./Identifiers
      system./IdentifierType
      value./Value
      assigner./IdentifierIssuingAuthority
   name./PreferredName (GivenNames, FamilyName, TitleCode)
      use./NamePurpose
      family./FamilyName
      given./GivenNames
      prefix./TitleCode
   gender./GenderCode
   birthDate(not represented in ServD)
   qualification./Qualifications
      code./Qualifications.Value
      period./Qualifications.StartDate and ./Qualifications.EndDate
   communication./Languages.LanguageSpokenCode

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

HpiPractitioner
Practitioner
   identifierFiveWs.identifier
   identifier (HPI)FiveWs.identifier
   identifier (dormant)FiveWs.identifier
   identifier (RA)FiveWs.identifier