This page is part of the FHIR Specification (v0.01: Historical Archive Draft). The current version which supercedes this version is 4.0.1. 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.