NGS IG - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

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

Resource Profile: OrganizationTWNGS - Mappings

Draft as of 2025-01-13

Mappings for the Organization-twngs resource profile.

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

OrganizationTWNGS
Organization	(also see master files messages)
identifier	CX / EI (occasionally, more often EI maps to a resource id or a URL), XON.10 / XON.3
use	N/A
type	CE/CNE/CWE, CX.5
coding	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
system	CX.4 / EI-2-4
value	CX.1 / EI.1
period	DR, CX.7 + CX.8
assigner	CX.4 / (CX.4,CX.9,CX.10)
active	No equivalent in HL7 v2
type	CE/CNE/CWE, No equivalent in v2
coding	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
name	XON.1
telecom	XTN, ORC-22?
system	XTN.3
value	XTN.1 (or XTN.12)
use	XTN.2 - but often indicated by field
rank	n/a
period	DR, N/A
address	XAD, ORC-23?
use	XAD.7
type	XAD.18
text	XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
line	XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
city	XAD.3
district	XAD.9
state	XAD.4
postalCode	XAD.5
extension
extension (PostalCode)
value[x]	CE/CNE/CWE
coding	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
coding (PostalCode3)	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
coding (PostalCode5)	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
coding (PostalCode6)	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
country	XAD.6
period	DR, XAD.12 / XAD.13 + XAD.14
partOf	No equivalent in HL7 v2
contact
purpose	CE/CNE/CWE
coding	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
name	XPN, PID-5, PID-9
telecom	XTN, PID-13, PID-14
address	XAD, PID-11
use	XAD.7
type	XAD.18
text	XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
line	XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
city	XAD.3
district	XAD.9
state	XAD.4
postalCode	XAD.5
extension
extension (PostalCode)
value[x]	CE/CNE/CWE
coding	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
coding (PostalCode3)	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
coding (PostalCode5)	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
coding (PostalCode6)	CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*E.1-8, C*E.10-22
system	C*E.3
version	C*E.7
code	C*E.1
display	C*E.2 - but note this is not well followed
userSelected	Sometimes implied by being first
text	C*E.9. But note many systems use C*E.2 for this
country	XAD.6
period	DR, XAD.12 / XAD.13 + XAD.14

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

OrganizationTWNGS
Organization	Entity. Role, or Act, Organization(classCode=ORG, determinerCode=INST)
meta	n/a, N/A
implicitRules	n/a
language	n/a
text	n/a, N/A, Act.text?
contained	Entity. Role, or Act, N/A
extension	n/a, N/A
modifierExtension	n/a, N/A
identifier	n/a, II - The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT], .scopes[Role](classCode=IDENT)
id	n/a
extension	n/a, N/A
use	n/a, Role.code or implied by context
type	n/a, CD, Role.code or implied by context
id	n/a
extension	n/a, N/A
coding	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
text	n/a, ./originalText[mediaType/code="text/plain"]/data
system	n/a, II.root or Role.id.root
value	n/a, II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
period	n/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], Role.effectiveTime or implied by context
assigner	n/a, The target of a resource reference is a RIM entry point (Act, Role, or Entity), II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
active	n/a, .status
type	n/a, CD, .code
id	n/a
extension	n/a, N/A
coding	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
text	n/a, ./originalText[mediaType/code="text/plain"]/data
name	n/a, .name
alias	n/a, .name
telecom	n/a, TEL, .telecom
id	n/a
extension	n/a, N/A
system	n/a, ./scheme
value	n/a, ./url
use	n/a, unique(./use)
rank	n/a
period	n/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], ./usablePeriod[type="IVL<TS>"]
address	n/a, AD, .address
id	n/a
extension	n/a, N/A
extension (room)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (floor)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (number)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (alley)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (lane)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (section)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (neighborhood)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (village)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
use	n/a, unique(./use)
type	n/a, unique(./use)
text	n/a, ./formatted
line	n/a, AD.part[parttype = AL]
city	n/a, AD.part[parttype = CTY]
district	n/a, AD.part[parttype = CNT | CPA]
state	n/a, AD.part[parttype = STA]
postalCode	n/a, AD.part[parttype = ZIP]
id	n/a
extension	n/a, N/A
extension (PostalCode)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A, CD
id	n/a
extension	n/a, N/A
coding	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
coding (PostalCode3)	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
coding (PostalCode5)	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
coding (PostalCode6)	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
text	n/a, ./originalText[mediaType/code="text/plain"]/data
country	n/a, AD.part[parttype = CNT]
period	n/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], ./usablePeriod[type="IVL<TS>"]
partOf	n/a, The target of a resource reference is a RIM entry point (Act, Role, or Entity), .playedBy[classCode=Part].scoper
contact	n/a, .contactParty
id	n/a
extension	n/a, N/A
modifierExtension	n/a, N/A
purpose	n/a, CD, ./type
id	n/a
extension	n/a, N/A
coding	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
text	n/a, ./originalText[mediaType/code="text/plain"]/data
name	n/a, EN (actually, PN), ./name
telecom	n/a, TEL, ./telecom
address	n/a, AD, ./addr
id	n/a
extension	n/a, N/A
extension (room)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (floor)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (number)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (alley)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (lane)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (section)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (neighborhood)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
extension (village)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A
use	n/a, unique(./use)
type	n/a, unique(./use)
text	n/a, ./formatted
line	n/a, AD.part[parttype = AL]
city	n/a, AD.part[parttype = CTY]
district	n/a, AD.part[parttype = CNT | CPA]
state	n/a, AD.part[parttype = STA]
postalCode	n/a, AD.part[parttype = ZIP]
id	n/a
extension	n/a, N/A
extension (PostalCode)	n/a, N/A
id	n/a
url	N/A
value[x]	n/a, N/A, CD
id	n/a
extension	n/a, N/A
coding	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
coding (PostalCode3)	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
coding (PostalCode5)	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
coding (PostalCode6)	n/a, CV, union(., ./translation)
id	n/a
extension	n/a, N/A
system	n/a, ./codeSystem
version	n/a, ./codeSystemVersion
code	n/a, ./code
display	n/a, CV.displayName
userSelected	n/a, CD.codingRationale
text	n/a, ./originalText[mediaType/code="text/plain"]/data
country	n/a, AD.part[parttype = CNT]
period	n/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], ./usablePeriod[type="IVL<TS>"]
endpoint	n/a, The target of a resource reference is a RIM entry point (Act, Role, or Entity)

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

OrganizationTWNGS
Organization	Organization
identifier	Identifier, ./Identifiers
system	./IdentifierType
value	./Value
period	./StartDate and ./EndDate
assigner	./IdentifierIssuingAuthority
active	./Status (however this concept in ServD more covers why the organization is active or not, could be delisted, deregistered, not operational yet) this could alternatively be derived from ./StartDate and ./EndDate and given a context date.
type	n/a
name	.PreferredName/Name
telecom	ContactPoint, ./ContactPoints
system	./ContactPointType
value	./Value
use	./ContactPointPurpose
period	./StartDate and ./EndDate
address	Address, ./PrimaryAddress and ./OtherAddresses
use	./AddressPurpose
line	./StreetAddress (newline delimitted)
city	./Jurisdiction
state	./Region
postalCode	./PostalIdentificationCode
country	./Country
period	./StartDate and ./EndDate
partOf	n/a
contact
name	ProviderName
telecom	ContactPoint
address	Address
use	./AddressPurpose
line	./StreetAddress (newline delimitted)
city	./Jurisdiction
state	./Region
postalCode	./PostalIdentificationCode
country	./Country
period	./StartDate and ./EndDate

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

OrganizationTWNGS
Organization
identifier	FiveWs.identifier
active	FiveWs.status
type	FiveWs.class