Agent

A person who is performing some designated role on behalf of (or under the authority of) an organisation.

The relative url is /agents

Content

<Agent xmlns="...">
  <id mand type="id">Master Resource Id, always first in all resources</id>
  <version opt type="id">version identifier</id>
  <status mand type="code">active|retired. See status below</status>
  <created opt type="datetime">date created, always present except on create</created>
  <updated opt type="datetime">date updated, present if resource updated</updated>
  <identifiers type="list">  <!-- Zero+ -->
    <identifier type="HumanId"/>Human identifiers for Agent</identifier>
  </identifiers>
  <person text type="Resource(Person)">The person who is the agent</person> 
  <organization text type="Resource(Person)">The represented Organization</organization> 
  <code opt type="Concept">The type of representation</period>
  <period opt type="Interval(HumanDate)">Time of representation</period>
  <location opt type="Location">Location of Agent</location>
  <extensions> See Extensions </extensions>
  <text type="Narrative">Text summary of agent, fall back for human interpretation</id>
</Agent>

Concept Bindings:

• code is bound to the concept domain "AgentCodes"

Notes:

• The Agent identifiers identify this specific person in this specific role (not anyone doing this role)
• The code may come from HL7 or snomed or whatever.
• The person and organisation references are optional, so can be replaced by simple text

Resource Status

Agent records may only be in one of two statuses: active and retired. A normal record is active - it is in use. The status retired is used when a record is created in error. Once the error is discovered, it can either be retired or deleted. Note that the record is active even if the period has expired.

© 2011