{
  "resourceType": "StructureDefinition",
  "id": "profile-practitionerrole-registry",
  "url": "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-practitionerrole-registry",
  "version": "1.1.2",
  "name": "PractitionerRoleProfileRegistry",
  "title": "PractitionerRole 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 PractitionerRole 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": "PractitionerRole",
  "baseDefinition": "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-practitionerrole",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "PractitionerRole",
        "path": "PractitionerRole",
        "short": "PractitionerRole Registry Profile",
        "definition": "The PractitionerRoleRegistry Profile is based upon the CA Baseline FHIR PractitionerRole profile for general use"
      },
      {
        "id": "PractitionerRole.extension",
        "path": "PractitionerRole.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "rules": "open"
        }
      },
      {
        "id": "PractitionerRole.extension:status",
        "path": "PractitionerRole.extension",
        "sliceName": "status",
        "short": "Role status extension",
        "definition": "Represents the defined possible states of the Role, as defined by the HL7v3 Role class state machine.",
        "comment": "The roleStatus extension has been flagged for further implementer feedback regarding whether it should be considered a modifier extension.",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/ca/baseline/StructureDefinition/ext-rolestatus"
            ]
          }
        ]
      },
      {
        "id": "PractitionerRole.extension:statusReason",
        "path": "PractitionerRole.extension",
        "sliceName": "statusReason",
        "short": "Role status reason extension",
        "definition": "Represents the textual description for the possible states of the Role, as defined by the HL7v3 Role class state machine.",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/ca/baseline/StructureDefinition/ext-statusreason"
            ]
          }
        ]
      },
      {
        "id": "PractitionerRole.identifier",
        "path": "PractitionerRole.identifier",
        "comment": "This element is considered SHOULD support and it is recommended to have an identifier associated with PractitionerRole to assist in searches, not every implementation (especially legacy implementations that combined both concepts of practitioner & practitionerRole) will include an identifier practioner role.",
        "type": [
          {
            "code": "Identifier",
            "profile": [
              "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-identifier"
            ]
          }
        ]
      },
      {
        "id": "PractitionerRole.practitioner",
        "path": "PractitionerRole.practitioner",
        "short": "Practitioner that is able to provide the defined services for the organization.",
        "min": 1,
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/ca/baseline/StructureDefinition/profile-practitioner"
            ]
          }
        ]
      },
      {
        "id": "PractitionerRole.code",
        "path": "PractitionerRole.code",
        "short": "HealthcareProviderRoleType",
        "comment": "The binding strength of this element is [Preferred](https://www.hl7.org/fhir/terminologies.html#strength), meaning that codes are encouraged to draw from the HealthcareProviderRoleType code system for interoperability purposes but are not required to do so to be considered conformant.",
        "binding": {
          "strength": "preferred",
          "description": "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. Examples: Registered Nurse, Chiropractor, Physician, Custodial Care Clinic.",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/healthcareproviderroletype"
        }
      },
      {
        "id": "PractitionerRole.specialty",
        "path": "PractitionerRole.specialty",
        "short": "PractitionerSpecialty",
        "comment": "The binding strength of this element is [Preferred](https://www.hl7.org/fhir/terminologies.html#strength), meaning that codes are encouraged to draw from the PractitionerSpecialty code system for interoperability purposes but are not required to do so to be considered conformant.",
        "binding": {
          "strength": "preferred",
          "description": "Defines the clinical, medical, surgical or other healthcare-related service specialty of a practitioner who interacts, treats or provides such services to or for a patient.",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/practitionerspecialty"
        }
      },
      {
        "id": "PractitionerRole.telecom.system",
        "path": "PractitionerRole.telecom.system",
        "min": 1
      },
      {
        "id": "PractitionerRole.telecom.value",
        "path": "PractitionerRole.telecom.value",
        "min": 1
      }
    ]
  }
}