Primary care data acquisition API, published by Health New Zealand. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/tewhatuora/fhir-primary-care-acquisition/ and changes regularly. See the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• Examples
• XML
• JSON
• TTL

Resource Profile: PrimaryCareEncounter - Mappings

Draft as of 2024-12-06

Mappings for the PrimaryCareEncounter resource profile.

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

PrimaryCareEncounter
Encounter	Event
identifier	Event.identifier
identifier (HealthRecordKey)	Event.identifier
status	Event.status
type	Event.code
serviceType	Event.code
subject	Event.subject
participant	Event.performer
type	Event.performer.function
individual	Event.performer.actor
period	Event.occurrence[x]
reasonCode	Event.reasonCode
diagnosis
condition	Event.reasonReference
location
location	Event.location
partOf	Event.partOf

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

PrimaryCareEncounter
Encounter	Entity. Role, or Act, Encounter[@moodCode='EVN']
text	Act.text?
identifier	.id
identifier (HealthRecordKey)	.id
id	n/a
extension	n/a
use	Role.code or implied by context
type	Role.code or implied by context
system	II.root or Role.id.root
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
period	Role.effectiveTime or implied by context
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
status	.statusCode
class	.inboundRelationship[typeCode=SUBJ].source[classCode=LIST].code
type	.code
serviceType	n/a
priority	.priorityCode
subject	.participation[typeCode=SBJ]/role[classCode=PAT]
id	n/a
extension	n/a
reference	N/A
type	N/A
identifier	.identifier
display	N/A
participant	.participation[typeCode=PFM]
id	n/a
extension	n/a
modifierExtension	N/A
type	.functionCode
period	.time
individual	.role
period	.effectiveTime (low & high)
reasonCode	.reasonCode
diagnosis	.outboundRelationship[typeCode=RSON]
id	n/a
extension	n/a
modifierExtension	N/A
condition	.outboundRelationship[typeCode=RSON].target
use	n/a
rank	.outboundRelationship[typeCode=RSON].priority
location	.participation[typeCode=LOC]
id	n/a
extension	n/a
modifierExtension	N/A
location	.role
status	.role.statusCode
period	.time
partOf	.inboundRelationship[typeCode=COMP].source[classCode=COMP, moodCode=EVN]

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

PrimaryCareEncounter
Encounter
identifier	FiveWs.identifier
identifier (HealthRecordKey)	FiveWs.identifier
status	FiveWs.status
class	FiveWs.class
type	FiveWs.class
priority	FiveWs.grade
subject	FiveWs.subject[x], FiveWs.subject
participant
individual	FiveWs.who
period	FiveWs.done[x]
reasonCode	FiveWs.why[x]
diagnosis
condition	FiveWs.why[x]
location
location	FiveWs.where[x]

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

PrimaryCareEncounter
Encounter
identifier	PV1-19
identifier (HealthRecordKey)	PV1-19
use	N/A
type	CX.5
system	CX.4 / EI-2-4
value	CX.1 / EI.1
period	CX.7 + CX.8
assigner	CX.4 / (CX.4,CX.9,CX.10)
status	No clear equivalent in HL7 v2; active/finished could be inferred from PV1-44, PV1-45, PV2-24; inactive could be inferred from PV2-16
class	PV1-2
type	PV1-4 / PV1-18
serviceType	PV1-10
priority	PV2-25
subject	PID-3
participant	ROL
type	ROL-3 (or maybe PRT-4)
period	ROL-5, ROL-6 (or maybe PRT-5)
individual	ROL-4
period	PV1-44, PV1-45
reasonCode	EVN-4 / PV2-3 (note: PV2-3 is nominally constrained to inpatient admissions; HL7 v2 makes no vocabulary suggestions for PV2-3; would not expect PV2 segment or PV2-3 to be in use in all implementations )
diagnosis
condition	Resources that would commonly referenced at Encounter.indication would be Condition and/or Procedure. These most closely align with DG1/PRB and PR1 respectively.
location
location	PV1-3 / PV1-6 / PV1-11 / PV1-42 / PV1-43