Practitioner

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 Practitioner provides the API documentation for searching for and fetching a Provider (Practitioner). 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.

The Practitioner Resource in the Provider Directory IG is based upon the candidate STU 3.0 version.

Minimum Requirements

Clients

Servers

By default, servers will only return active records.

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 Practitioner must have:

  1. A name
  2. An identifier (NPI preferred). Anyone providing care may request an NPI.


Formal Summary of the Mandatory Requirements

  1. At least one (non-local) identifier in Practitioner.identifier (NPI, taxID, etc)
    • NPI preferred
    • Tax id is allowed
    • Local id is allowed in addition to 'authoritative' identifier
  2. A Practitioner.name


Practitioner Resource Example
Location Resource Example

Quick Start

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

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

Support: Mandatory

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

Response Class:

  • (Status 200): successful operation
  • (Status 400): invalid parameter
  • (Status 401): unauthorized request

Example:

[GET https://fhir-open-api-dstu2.smarthealthit.org/Practitioner?identifier=http://hl7.org/fhir/sid/us-npi%7C1497860456]


GET [base]/Practitioner?family=[string]&given=[string]

Support: Mandatory

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

Response Class

  • (Status 200): successful operation
  • (Status 400): invalid parameter
  • (Status 401): unauthorized request

Example:

[GET https://fhir-open-api-dstu2.smarthealthit.org/Practitioner?family=Smith&given=John]

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.