> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectivehealth.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Practitioner

> The FHIR Practitioner resource as produced by Connective Health

[FHIR R4 Practitioner](https://www.hl7.org/fhir/R4/practitioner.html) ·
[US Core Practitioner](https://hl7.org/fhir/us/core/STU9/StructureDefinition-us-core-practitioner.html)

<Info>
  `Practitioner` represents a provider in all three FHIR outputs, but its role differs. In
  [Bulk Medication History](/fhir/bulk-medication-history-bundle) it is always the **prescriber** of a medication and
  is a standalone resource. In the [Patient Everything](/fhir/patient-everything-bundle) and
  [Patient Summary](/fhir/patient-summary-bundle) bundles it represents any provider associated with a clinical
  record -- and is **contained** rather than standalone. The **Stable ID** and **Fields** sections below cover both,
  with a column per output.
</Info>

# Stable ID

| Output                       | Recipe                                                                                                                                                                                                             |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Patient Everything / Summary | No `id` is assigned. `Practitioner` is contained inside the [PractitionerRole](/fhir/resources/practitioner-role) that references it, which is in turn contained inside the clinical resource naming the provider. |
| Bulk Med History             | Fixed to the pattern `prescriber-{medicationUniqueId}`, tied to the specific medication record rather than to the prescriber's real-world identity.                                                                |

<Warning>
  Neither `id` scheme deduplicates by the provider's real-world identity. In the bundles, the same provider appears
  as a separate contained `Practitioner` under every resource they are associated with -- use the NPI in
  `identifier` to correlate them. In Bulk Med History, the same prescriber appears as a **separate**
  `Practitioner` resource for every medication they prescribed within a file.
</Warning>

# Fields

| Field              | Patient Everything / Summary | Bulk Med History | Notes                                                                                                                                                                                                                                                                                                                                              |
| ------------------ | ---------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `meta.profile`     | 1..1                         | 1..1             | Always set to the US Core Practitioner profile URL.                                                                                                                                                                                                                                                                                                |
| `identifier` (NPI) | 0..1                         | 0..1             | Populated using the [NPI](http://hl7.org/fhir/sid/us-npi) system when the provider's NPI is present in the source.                                                                                                                                                                                                                                 |
| `identifier` (DEA) | 0..0                         | 0..1             | Bulk Med History only, using the [US DEA Number](http://terminology.hl7.org/NamingSystem/USDEANumber) system, when the prescriber's DEA number is present. Not populated in the bundles.                                                                                                                                                           |
| `name`             | 1..1                         | 1..1             | A single name entry. In the bundles, this uses the provider's family name and **only the first** given name -- additional given names in the source are not published. In Bulk Med History, it is built from the source prescriber's prefix, first name, last name, and suffix, but the source prescriber middle name is **not currently mapped**. |

<Note>
  In the bundles, a `Practitioner` is only produced when the provider has at least an NPI or a name; `telecom`,
  `address`, and `qualification` are not populated -- contact details appear on the surrounding
  [PractitionerRole](/fhir/resources/practitioner-role) instead. In Bulk Med History, a `Practitioner` is always
  produced for the prescriber.
</Note>