病人資訊-Patient TWNHIBASE - Mappings - 臺灣健保署基礎實作指引 v0.0.1

臺灣健保署基礎實作指引
0.0.1 - ci-build

臺灣健保署基礎實作指引, published by 衛生福利部中央健康保險署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/TWNHIFHIR/base/ and changes regularly. See the Directory of published versions

Resource Profile: PatientTWNHIBASE - Mappings

Draft as of 2025-11-13

Mappings for the Patient-twnhibase resource profile.

Mappings to Structures in this Implementation Guide

Name	Mapping to TWNHIBASE Patient
Patient	BaseModel.patient
id
meta
implicitRules
language
text
contained
Slices for extension
extension:age
extension:nationality
modifierExtension
Slices for identifier
identifier:idCardNumber
id
extension
use
type
id
extension
coding
id
extension
system
version
code
id
Slices for extension
extension:identifier-suffix
value
display
userSelected
text
system
value	BaseModel.patient.patId BaseModel.patient.idCard
period
assigner
identifier:passportNumber
id
extension
use
type
id
extension
coding
id
extension
system
version
code
display
userSelected
text
system
value	BaseModel.patient.patId BaseModel.patient.idCard
period
assigner
identifier:residentNumber
id
extension
use
type
id
extension
coding
id
extension
system
version
code
display
userSelected
text
system
value	BaseModel.patient.patId BaseModel.patient.idCard
period
assigner
identifier:medicalRecord
id
extension
use
type
id
extension
coding
id
extension
system
version
code
display
userSelected
text
system
value	BaseModel.patient.patId BaseModel.patient.idCard
period
assigner
active
Slices for name
name:official
name:usual
id
extension
use
text	BaseModel.patient.name
family
given
prefix
suffix
period
name:temp
name:anonymous
telecom
id
extension
system
value
use
rank
period
gender	BaseModel.patient.gender
birthDate	BaseModel.patient.birthday
deceased[x]
address
maritalStatus
multipleBirth[x]
photo
contact
id
extension
modifierExtension
relationship
name
id
extension
use
text
family
given
prefix
suffix
period
telecom
id
extension
system
value
use
rank
period
address
gender
organization
period
communication
id
extension
modifierExtension
language
preferred
generalPractitioner
managingOrganization
link
id
extension
modifierExtension
other
type
Documentation for this format

Mappings to other Structures

No Mappings Found

Other Mappings

Name	RIM Mapping	CDA (R2)	FiveWs Pattern Mapping	HL7 v2 Mapping	LOINC code for the element
Patient	Patient[classCode=PAT]	ClinicalDocument.recordTarget.patientRole
id
meta
implicitRules
language
text	Act.text?
contained	N/A
Slices for extension
extension:age
extension:nationality
modifierExtension	N/A
Slices for identifier	id	.id	FiveWs.identifier	PID-3
identifier:idCardNumber	id	.id	FiveWs.identifier	PID-3
id	n/a
extension	n/a
use	Role.code or implied by context			N/A
type	Role.code or implied by context			CX.5
id	n/a
extension	n/a
coding	union(. ./translation)			CE.1-8 CE.10-22
id	n/a
extension	n/a
system	./codeSystem			C*E.3
version	./codeSystemVersion			C*E.7
code	./code			C*E.1
id
Slices for extension
extension:identifier-suffix
value
display	CV.displayName			C*E.2 - but note this is not well followed
userSelected	CD.codingRationale			Sometimes implied by being first
text	./originalText[mediaType/code="text/plain"]/data			CE.9. But note many systems use CE.2 for this
system	II.root or Role.id.root			CX.4 / EI-2-4
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)			CX.1 / EI.1
period	Role.effectiveTime or implied by context			CX.7 + CX.8
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper			CX.4 / (CX.4 CX.9 CX.10)
identifier:passportNumber	id	.id	FiveWs.identifier	PID-3
id	n/a
extension	n/a
use	Role.code or implied by context			N/A
type	Role.code or implied by context			CX.5
id	n/a
extension	n/a
coding	union(. ./translation)			CE.1-8 CE.10-22
id	n/a
extension	n/a
system	./codeSystem			C*E.3
version	./codeSystemVersion			C*E.7
code	./code			C*E.1
display	CV.displayName			C*E.2 - but note this is not well followed
userSelected	CD.codingRationale			Sometimes implied by being first
text	./originalText[mediaType/code="text/plain"]/data			CE.9. But note many systems use CE.2 for this
system	II.root or Role.id.root			CX.4 / EI-2-4
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)			CX.1 / EI.1
period	Role.effectiveTime or implied by context			CX.7 + CX.8
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper			CX.4 / (CX.4 CX.9 CX.10)
identifier:residentNumber	id	.id	FiveWs.identifier	PID-3
id	n/a
extension	n/a
use	Role.code or implied by context			N/A
type	Role.code or implied by context			CX.5
id	n/a
extension	n/a
coding	union(. ./translation)			CE.1-8 CE.10-22
id	n/a
extension	n/a
system	./codeSystem			C*E.3
version	./codeSystemVersion			C*E.7
code	./code			C*E.1
display	CV.displayName			C*E.2 - but note this is not well followed
userSelected	CD.codingRationale			Sometimes implied by being first
text	./originalText[mediaType/code="text/plain"]/data			CE.9. But note many systems use CE.2 for this
system	II.root or Role.id.root			CX.4 / EI-2-4
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)			CX.1 / EI.1
period	Role.effectiveTime or implied by context			CX.7 + CX.8
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper			CX.4 / (CX.4 CX.9 CX.10)
identifier:medicalRecord	id	.id	FiveWs.identifier	PID-3
id	n/a
extension	n/a
use	Role.code or implied by context			N/A
type	Role.code or implied by context			CX.5
id	n/a
extension	n/a
coding	union(. ./translation)			CE.1-8 CE.10-22
id	n/a
extension	n/a
system	./codeSystem			C*E.3
version	./codeSystemVersion			C*E.7
code	./code			C*E.1
display	CV.displayName			C*E.2 - but note this is not well followed
userSelected	CD.codingRationale			Sometimes implied by being first
text	./originalText[mediaType/code="text/plain"]/data			CE.9. But note many systems use CE.2 for this
system	II.root or Role.id.root			CX.4 / EI-2-4
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)			CX.1 / EI.1
period	Role.effectiveTime or implied by context			CX.7 + CX.8
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper			CX.4 / (CX.4 CX.9 CX.10)
active	statusCode	n/a	FiveWs.status
Slices for name	name	.patient.name		PID-5 PID-9
name:official	name	.patient.name		PID-5 PID-9
name:usual	name	.patient.name		PID-5 PID-9
id	n/a
extension	n/a
use	unique(./use)			XPN.7 but often indicated by which field contains the name
text	./formatted			implied by XPN.11
family	./part[partType = FAM]			XPN.1/FN.1
given	./part[partType = GIV]			XPN.2 + XPN.3
prefix	./part[partType = PFX]			XPN.5
suffix	./part[partType = SFX]			XPN/4
period	./usablePeriod[type="IVL<TS>"]			XPN.13 + XPN.14
name:temp	name	.patient.name		PID-5 PID-9
name:anonymous	name	.patient.name		PID-5 PID-9
telecom	telecom	.telecom		PID-13 PID-14 PID-40
id	n/a
extension	n/a
system	./scheme			XTN.3
value	./url			XTN.1 (or XTN.12)
use	unique(./use)			XTN.2 - but often indicated by field
rank	n/a			n/a
period	./usablePeriod[type="IVL<TS>"]			N/A
gender	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender	.patient.administrativeGenderCode		PID-8
birthDate	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/birthTime	.patient.birthTime		PID-7	21112-8
deceased[x]	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedInd player[classCode=PSN\|ANM and determinerCode=INSTANCE]/deceasedTime	n/a		PID-30 (bool) and PID-29 (datetime)
address	AD			XAD
maritalStatus	CD			CE/CNE/CWE
multipleBirth[x]	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthInd player[classCode=PSN\|ANM and determinerCode=INSTANCE]/multipleBirthOrderNumber	n/a		PID-24 (bool) PID-25 (integer)
photo	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/desc	n/a		OBX-5 - needs a profile
contact	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/scopedRole[classCode=CON]	n/a
id	n/a
extension	n/a
modifierExtension	N/A
relationship	CD			CE/CNE/CWE
name	name	n/a		NK1-2
id	n/a
extension	n/a
use	unique(./use)			XPN.7 but often indicated by which field contains the name
text	./formatted			implied by XPN.11
family	./part[partType = FAM]			XPN.1/FN.1
given	./part[partType = GIV]			XPN.2 + XPN.3
prefix	./part[partType = PFX]			XPN.5
suffix	./part[partType = SFX]			XPN/4
period	./usablePeriod[type="IVL<TS>"]			XPN.13 + XPN.14
telecom	telecom	n/a		NK1-5 NK1-6 NK1-40
id	n/a
extension	n/a
system	./scheme			XTN.3
value	./url			XTN.1 (or XTN.12)
use	unique(./use)			XTN.2 - but often indicated by field
rank	n/a			n/a
period	./usablePeriod[type="IVL<TS>"]			N/A
address	AD			XAD
gender	player[classCode=PSN\|ANM and determinerCode=INSTANCE]/administrativeGender	n/a		NK1-15
organization	scoper	n/a		NK1-13 NK1-30 NK1-31 NK1-32 NK1-41
period	effectiveTime	n/a
communication	LanguageCommunication	patient.languageCommunication
id	n/a
extension	n/a
modifierExtension	N/A
language	CD			CE/CNE/CWE
preferred	preferenceInd	.preferenceInd		PID-15
generalPractitioner	subjectOf.CareEvent.performer.AssignedEntity	n/a		PD1-4
managingOrganization	scoper	.providerOrganization
link	outboundLink	n/a
id	n/a
extension	n/a
modifierExtension	N/A
other	id	n/a		PID-3 MRG-1
type	typeCode	n/a
Documentation for this format

IG © 2025+ 衛生福利部中央健康保險署. Package tw.gov.mohw.nhi.base#0.0.1 based on FHIR 4.0.1. Generated 2025-11-13
Links: Table of Contents | QA Report | Version History