This page is part of the FHIR Specification (v0.01: Historical Archive Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

Agent

A person who represents an organisation, and is authorised to perform actions on it's behalf.

The relative url is /agents

Content

<Agent xmlns="http://www.hl7.org/fhir">
  <id> mand id Master Resource Id, always first in all resources</id>
  <person> mand (Person) The person who is the agent</person>
  <organization> mand (Organization) The represented organization</organization>
  <role> mand One+ CodeableConcept A role the agent has</role>
  <period> opt Interval(date) The period for which this agency applies</period>
  <identifier> Zero+ HumanId A Human identifier for the person as this agent</identifier>
  <address> Zero+ Address An address that applies for the person as this agent</address>
  <contact> Zero+ Contact A contact that applies for the person as this agent</contact>
  <extensions> opt See Extensions   See Extensions </extensions>
  <text> mand Narrative Text summary of the agent, for human interpretation</text>
</Agent>

Schema for Agent and an example (or formatted for browser)

Terminology Bindings

• Agent.role is bound to the concept domain AgentRole: "The role a person plays representing an organization"

Notes:

• Any person can represent the same organisation in multiple different ways. This may be represented as a single agent resource with multiple role codes, or multiple agent resources. Which is correct depends on whether the combined roles share other attributes, such as identifiers and time periods.
• The person and organization references are mandatory, so must be a full resource reference by identifier

Searching Criteria

The following simple search/filter parameters are defined for person:

person	The identity of a person
organization	The identity of an organization
id	search id in any agent identifiers

The standard search parameters also apply (see Searching).

Formal Definitions

The formal definitions for the elements above. Also available as an XML file.

Agent
Definition	A person who represents an organisation, and is authorised to perform actions on it's behalf
Control	Mandatory, 1..1
Requirements	Need to track doctors, staff, locums etc for both healthcare providers, funders, etc.
RIM Mapping	Role
v2 Mapping	PRD (as one example)
Agent.id
Definition	Master Resource Id, always first in all resources
Control	Mandatory, 1..1
Type	id
RIM Mapping	.id(scope=OBJ)
Agent.person
Definition	The person who acts as the agent
Control	Mandatory, 1..1
Type	Resource(Person)
Must Understand	true
Requirements	Need to be able to track the person who represents the organisation separately
v2 Mapping	PRD-2
Agent.organization
Definition	The organisation that is being represented
Control	Mandatory, 1..1
Type	Resource(Organization)
Must Understand	true
Requirements	Need to be able to track the represented organisation separately
v2 Mapping	PRD-10 (-> 14)
Agent.role
Definition	The way in which the person represents the organisation - what role do they have?
Control	Mandatory, 1..*
Type	CodeableConcept from AgentRole
Must Understand	true
Requirements	Need to know what authority the agent has - what can they do?
Comments	A person may have more than one role. At least one role is required - why have an agent who isn't actually an agent?
v2 Mapping	PRD-1
Agent.period
Definition	The time period during which the agent was/is authorised to represent the organisation.
Control	Optional, 0..1
Type	Interval(date)
Requirements	Agencies are often for a limited period of time, and can be revoked. Even after the agencies is revoked, the fact that it existed must still be recorded
v2 Mapping	PRD-8/9
Agent.identifier
Definition	An identifier that applies to this person in this role
Control	0..*
Type	HumanId
Must Understand	true
Requirements	Often, specific identifies are assigned for the agent
Comments	The identifier changes when a new/different person steps into the same role
v2 Mapping	PRD-7
Agent.address
Definition	A postal address for this person playing this role
Control	0..*
Type	Address
Comments	i.e. the address is not their personal address. For many agents, this is the same as their work address
v2 Mapping	PRD-3
To Do	What about place? (PRD-4)
Agent.contact
Definition	A contact detail address for this person playing this role
Control	0..*
Type	Contact
Comments	i.e. the contact is not their personal contact. For many agents, this is the same as their work contacts. Note that a person may choose to use a personal mobile phone (for instance) for their contact in a given role - in this case, the contact detail will be repeated in the agent resource
v2 Mapping	PRD-5
Agent.extensions
Definition	See Extensions
Control	Optional, 0..1
Agent.text
Definition	Text summary of the agent, for human interpretation
Control	Mandatory, 1..1
Type	Narrative

---

This is an old version of FHIR retained for archive purposes. Do not use for anything else
Implementers are welcome to experiment with the content defined here, but should note that the contents are subject to change without prior notice.
© HL7.org 2011 - 2012. FHIR v0.01 generated on Mon, May 14, 2012 09:48+1000.