Magentus Practice Management FHIR Implementation Guide - Local Development build (v1.2.39) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• Examples
• JSON

Resource Profile: GSOrganization - Mappings

Draft as of 2025-06-12

Mappings for the gs-organization resource profile.

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

GSOrganization
Organization	(also see master files messages)
identifier	CX / EI (occasionally, more often EI maps to a resource id or a URL)
identifier (hpio)	CX / EI (occasionally, more often EI maps to a resource id or a URL)
identifier (abn)	CX / EI (occasionally, more often EI maps to a resource id or a URL)
identifier (nataAccreditation)	CX / EI (occasionally, more often EI maps to a resource id or a URL)
use	N/A
type	CX.5
coding	C*E.1-8, C*E.10-22
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	CX.7 + CX.8
assigner	CX.4 / (CX.4,CX.9,CX.10)
identifier (acn)	CX / EI (occasionally, more often EI maps to a resource id or a URL)
identifier (localOrganizationIdentifier)	CX / EI (occasionally, more often EI maps to a resource id or a URL)
active	No equivalent in HL7 v2
type	No equivalent in v2
name	XON.1
telecom	ORC-22?
telecom (phone)	ORC-22?
system	XTN.3
value	XTN.1 (or XTN.12)
use	XTN.2 - but often indicated by field
rank	n/a
period	N/A
telecom (fax)	ORC-22?
system	XTN.3
value	XTN.1 (or XTN.12)
use	XTN.2 - but often indicated by field
rank	n/a
period	N/A
telecom (email)	ORC-22?
system	XTN.3
value	XTN.1 (or XTN.12)
use	XTN.2 - but often indicated by field
rank	n/a
period	N/A
telecom (website)	ORC-22?
system	XTN.3
value	XTN.1 (or XTN.12)
use	XTN.2 - but often indicated by field
rank	n/a
period	N/A
address	XAD
address (physical)	XAD
extension
extension (identifier)
value[x]	CX / EI (occasionally, more often EI maps to a resource id or a URL)
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
country	XAD.6
period	XAD.12 / XAD.13 + XAD.14
partOf	No equivalent in HL7 v2
contact
name	PID-5, PID-9
telecom	PID-13, PID-14
address	PID-11

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

GSOrganization
Organization	Entity. Role, or Act, Organization(classCode=ORG, determinerCode=INST)
text	Act.text?
contained	N/A
extension	N/A
modifierExtension	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]
identifier (hpio)	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]
identifier (abn)	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]
identifier (nataAccreditation)	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]
id	n/a
extension	n/a
use	Role.code or implied by context
type	Role.code or implied by context
id	n/a
extension	n/a
coding	union(., ./translation)
text	./originalText[mediaType/code="text/plain"]/data
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
identifier (acn)	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]
identifier (localOrganizationIdentifier)	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]
active	.status
type	.code
name	.name
alias	.name
telecom	.telecom
telecom (phone)	.telecom
id	n/a
extension	n/a
system	./scheme
value	./url
use	unique(./use)
rank	n/a
period	./usablePeriod[type="IVL<TS>"]
telecom (fax)	.telecom
id	n/a
extension	n/a
system	./scheme
value	./url
use	unique(./use)
rank	n/a
period	./usablePeriod[type="IVL<TS>"]
telecom (email)	.telecom
id	n/a
extension	n/a
system	./scheme
value	./url
use	unique(./use)
rank	n/a
period	./usablePeriod[type="IVL<TS>"]
telecom (website)	.telecom
id	n/a
extension	n/a
system	./scheme
value	./url
use	unique(./use)
rank	n/a
period	./usablePeriod[type="IVL<TS>"]
address	n/a, AD
address (physical)	n/a, AD
id	n/a
extension
extension (identifier)
id	n/a
extension	n/a
url	N/A
value[x]	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]
use	unique(./use)
type	unique(./use)
text	./formatted
line	AD.part[parttype = AL]
city	AD.part[parttype = CTY]
district	AD.part[parttype = CNT | CPA]
state	AD.part[parttype = STA]
postalCode	AD.part[parttype = ZIP]
country	AD.part[parttype = CNT]
period	./usablePeriod[type="IVL<TS>"]
partOf	.playedBy[classCode=Part].scoper
contact	.contactParty
id	n/a
extension	n/a
modifierExtension	N/A
purpose	./type
name	./name
telecom	./telecom
address	./addr
endpoint	n/a

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

GSOrganization
Organization	Organization
identifier	Identifier
identifier (hpio)	Identifier
identifier (abn)	Identifier
identifier (nataAccreditation)	Identifier
system	./IdentifierType
value	./Value
period	./StartDate and ./EndDate
assigner	./IdentifierIssuingAuthority
identifier (acn)	Identifier
identifier (localOrganizationIdentifier)	Identifier
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	./ContactPoints
telecom (phone)	./ContactPoints
system	./ContactPointType
value	./Value
use	./ContactPointPurpose
period	./StartDate and ./EndDate
telecom (fax)	./ContactPoints
system	./ContactPointType
value	./Value
use	./ContactPointPurpose
period	./StartDate and ./EndDate
telecom (email)	./ContactPoints
system	./ContactPointType
value	./Value
use	./ContactPointPurpose
period	./StartDate and ./EndDate
telecom (website)	./ContactPoints
system	./ContactPointType
value	./Value
use	./ContactPointPurpose
period	./StartDate and ./EndDate
address	Address
address (physical)	Address
extension
extension (identifier)
value[x]	Identifier
use	./AddressPurpose
line	./StreetAddress (newline delimitted)
city	./Jurisdiction
state	./Region
postalCode	./PostalIdentificationCode
country	./Country
period	./StartDate and ./EndDate
partOf	n/a

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

GSOrganization
Organization
active	FiveWs.status
type	FiveWs.class