{
  "resourceType": "StructureDefinition",
  "id": "profile-practitioner-registry",
  "url": "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-practitioner-registry",
  "version": "1.0.2",
  "name": "PractitionerProfileRegistry",
  "title": "Practitioner Profile (Provider Registry)",
  "status": "draft",
  "date": "2026-01-09",
  "publisher": "HL7 Canada - FHIR Implementation Work Group",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "https://infocentral.infoway-inforoute.ca/en/collaboration/wg/fhir-implementations"
        }
      ]
    }
  ],
  "description": "Proposed constraints and extensions on the Practitioner Resource for use by Provider Registry systems",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "CA"
        }
      ]
    }
  ],
  "fhirVersion": "4.0.1",
  "mapping": [
    {
      "identity": "v2",
      "uri": "http://hl7.org/v2",
      "name": "HL7 v2 Mapping"
    },
    {
      "identity": "rim",
      "uri": "http://hl7.org/v3",
      "name": "RIM Mapping"
    },
    {
      "identity": "servd",
      "uri": "http://www.omg.org/spec/ServD/1.0/",
      "name": "ServD"
    },
    {
      "identity": "w5",
      "uri": "http://hl7.org/fhir/fivews",
      "name": "FiveWs Pattern Mapping"
    }
  ],
  "kind": "resource",
  "abstract": false,
  "type": "Practitioner",
  "baseDefinition": "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-practitioner",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "Practitioner",
        "path": "Practitioner",
        "short": "Practitioner Profile",
        "definition": "The Practitioner Profile is based upon the CA Baseline FHIR Practitioner Profile for general use"
      },
      {
        "id": "Practitioner.extension",
        "path": "Practitioner.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "rules": "open"
        }
      },
      {
        "id": "Practitioner.extension:deceased",
        "path": "Practitioner.extension",
        "sliceName": "deceased",
        "short": "Indicates if the individual is deceased or not.",
        "definition": "The fact that a practitioner is deceased influences the clinical process. Also, in human communication and relation management it is necessary to know whether the person is alive.",
        "comment": "Implementers should recognize that the determination of whether this should be considered a modifierExtension is ongoing. Since Modifier Extensions should have extreme caution in their application and are further nuanced by the use cases in the implementing registry systems, this extension has been shifted back to a regular extension to align to use in existing implementations. Implementers who are considering using this extension in their guidance are required to review the [FHIR Guidance on Modifier Extensions])(https://www.hl7.org/fhir/R4/extensibility.html#modifierExtension) before including this extension in their profile. Implementers should also be aware of the Practitioner.deceased[x] R5 concept and that the CA Baseline is monitoring changes in the element to determine if the approach to this extension requires a shift.",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/ca/baseline/StructureDefinition/ext-deceased"
            ]
          }
        ]
      },
      {
        "id": "Practitioner.identifier",
        "path": "Practitioner.identifier",
        "min": 1,
        "type": [
          {
            "code": "Identifier",
            "profile": [
              "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-identifier"
            ]
          }
        ]
      },
      {
        "id": "Practitioner.name",
        "path": "Practitioner.name",
        "min": 1
      },
      {
        "id": "Practitioner.address.extension",
        "path": "Practitioner.address.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "rules": "open"
        }
      },
      {
        "id": "Practitioner.address.extension:preferred",
        "path": "Practitioner.address.extension",
        "sliceName": "preferred",
        "short": "HL7 Preferred Address Flag extension",
        "definition": "Flag denoting whether parent address item is preferred",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/StructureDefinition/iso21090-preferred"
            ]
          }
        ]
      },
      {
        "id": "Practitioner.qualification",
        "path": "Practitioner.qualification",
        "comment": "Slicing has been maintained to demonstrate that there are some registries supporting hybridized registry/eReferral use cases that require a separate set of codes. Until practices are more standardized regarding these two code systems, implementers are cautioned that these code systems and value sets still may change. Implementers are encouraged to provide feedback on the value sets and code systems they are expecting to utilize."
      },
      {
        "id": "Practitioner.qualification.code.coding",
        "path": "Practitioner.qualification.code.coding",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "system"
            }
          ],
          "rules": "open"
        }
      },
      {
        "id": "Practitioner.qualification.code.coding.system",
        "path": "Practitioner.qualification.code.coding.system",
        "min": 1
      },
      {
        "id": "Practitioner.qualification.code.coding.code",
        "path": "Practitioner.qualification.code.coding.code",
        "min": 1
      },
      {
        "id": "Practitioner.qualification.code.coding:Registry",
        "path": "Practitioner.qualification.code.coding",
        "sliceName": "Registry"
      },
      {
        "id": "Practitioner.qualification.code.coding:Registry.system",
        "path": "Practitioner.qualification.code.coding.system",
        "short": "QualifiedRoleType",
        "definition": "A code system for the degree or educational rank that the credential specifies. May also apply to an Expertise type.",
        "min": 1,
        "patternUri": "https://fhir.infoway-inforoute.ca/CodeSystem/scpqual"
      },
      {
        "id": "Practitioner.qualification.code.coding:eReferral",
        "path": "Practitioner.qualification.code.coding",
        "sliceName": "eReferral",
        "comment": "Some registries may be used to support electronic referral use cases. A separate code system for practitioner qualification codes has been identified as in use by at least one Canadian registry supporting the hybridized use case."
      },
      {
        "id": "Practitioner.qualification.code.coding:eReferral.system",
        "path": "Practitioner.qualification.code.coding.system",
        "short": "HealthcareProviderRoleType",
        "definition": "A role type that is used to categorize an entity that delivers health care in an expected and professional manner to an entity in need of health care services.",
        "min": 1,
        "patternUri": "https://fhir.infoway-inforoute.ca/CodeSystem/scptype"
      }
    ]
  }
}