Organization

From HL7 Argonaut Project Wiki
Jump to: navigation, search

Back to Argonaut Implementation Guide

Approved Argonaut design has been formalized and moved

Official Argonaut IG

Introduction

The Argonaut Organization IG provides the API documentation for searching for and fetching a Organization resource. Several FHIR extensions to the Organization resource have been introduced to support the need to supply endpoint information for exchanging data. This content profile is the minimum bar, local implementations may add requirements.

The requirements for the Argonaut Provider Directory data model were drawn from IHE Healthcare Provider Directory and the ONC Provider Directory Workshop.

Minimum Requirements

Clients

Servers

Mandatory Data Elements

The following data-elements are mandatory (i.e data MUST be present). These are presented below in simple human-readable explanations along with sample data to demonstrate the requirements.

Each Organization must have:

  1. A name
  2. An identifier
  3. A status of the organization
  4. A list of contact information
  5. Endpoint information [EH is this mandatory]

Formal Summary of the Mandatory Requirements

  1. At least one identifier in Organization.identifier (NPI, taxID, etc)
    • NPI preferred
    • Tax id is allowed
    • Local id is allowed in addition to 'authoritative' identifier
  2. A Organization.active
  3. A Organization.name (FHIR tracker 9625 to allow for multiple names approved by HL7 PA working group for version STU3)
  4. A Organization.telecom
  5. A Organization.address

Additional Requirements

  1. A server SHALL support the_include parameter when retrieving a Organization resource.


Future recommended elements:

  1. A Organization.type
    • The Organization.type must come from value set?
Organization Resource Example

Quick Start

Below is a quick overview of the required search and read operations.

GET [base]/Organization?identifier=[system]|[code]

Support: Mandatory

Implementation Notes: Search based on Organization identifier (how to search by token).

Response Class:

  • (Status 200): successful operation
  • (Status 400): invalid parameter
  • (Status 401/4xx): unauthorized request
  • (Status 403): insufficient scope

Example:

[GET http://fhir2.healthintersections.com.au/open/Organization?identifier=urn:ietf:rfc:3986%7C2.16.840.1.113883.19.5]


GET [base]/Organization?name=[string]

Support: Mandatory

Implementation Notes: name - Search based on text name (how to search by string). May also support:

  • address-city
  • address-state
  • address-postalcode

Response Class

  • (Status 200): successful operation
  • (Status 400): invalid parameter
  • (Status 401/4xx): unauthorized request
  • (Status 403): insufficient scope

Example:

[GET https://fhir-open-api-dstu2.smarthealthit.org/Organization?name=Health]


GET [base]/Organization?address=[string]

Support: Mandatory

Implementation Notes: address - Search based on text address (how to search by string).

SHOULD support:

  • address-city
  • address-state
  • address-postalcode

Response Class

  • (Status 200): successful operation
  • (Status 400): invalid parameter
  • (Status 401/4xx): unauthorized request
  • (Status 403): insufficient scope

Example:

[GET https://fhir-open-api-dstu2.smarthealthit.org/Organization?address=Arbor]
[GET https://fhir-open-api-dstu2.smarthealthit.org/Organization?address-postalcode=48104]

Open Issues

The following issues have been identified:

Resources

Formalized testing with test scripts and objective results reporting is available through the participation of AEGIS and MITRE (Crucible). The testscript provided can be used to test servers: [todo]

References


Back to Argonaut Implementation Guide

Copyright © Health Level Seven International ® ALL RIGHTS RESERVED. The reproduction of this material in any form is strictly forbidden without the written permission of the publisher.