{
  "resourceType": "StructureDefinition",
  "id": "practitionerRole-ca-core",
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 2
    }
  ],
  "url": "http://fhir.infoway-inforoute.ca/cacore/StructureDefinition/practitionerRole-ca-core",
  "version": "1.1.0",
  "name": "PractitionerRoleCACore",
  "title": "PractitionerRole (CA-Core)",
  "status": "active",
  "experimental": false,
  "date": "2025-03-04",
  "publisher": "Canada Health Infoway",
  "contact": [
    {
      "name": "National Standards Release Centre",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.infoway-inforoute.ca"
        },
        {
          "system": "email",
          "value": "standards@infoway-inforoute.ca"
        }
      ]
    }
  ],
  "description": "This profile applies constraints to the PractitionerRole resource for CA Core+ to support assignment of providers to roles, specialties, and organizations in the pan-Canadian context.",
  "jurisdiction": [
    {
      "coding": [
        {
          "code": "CA",
          "system": "urn:iso:std:iso:3166"
        }
      ]
    }
  ],
  "copyright": "Copyright © 2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).",
  "fhirVersion": "4.0.1",
  "mapping": [
    {
      "identity": "CACDI",
      "name": "Canadian Core Data for Interoperability (CACDI)"
    }
  ],
  "kind": "resource",
  "abstract": false,
  "type": "PractitionerRole",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/PractitionerRole",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "PractitionerRole",
        "path": "PractitionerRole",
        "constraint": [
          {
            "key": "ca-core-practrole-1",
            "human": "At least one of practitioner, organization, specialty or code SHALL be present.",
            "source": "http://fhir.infoway-inforoute.ca/cacore/StructureDefinition/practitionerRole-ca-core",
            "severity": "error",
            "expression": "practitioner.exists() or organization.exists() or code.exists() or specialty.exists()",
            "xpath": "f:practitioner or f:organization or f:code or f:specialty"
          }
        ]
      },
      {
        "id": "PractitionerRole.identifier",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/obligation",
            "extension": [
              {
                "url": "code",
                "valueCode": "MAY:populate-if-known"
              },
              {
                "url": "actor",
                "valueCanonical": "http://fhir.infoway-inforoute.ca/ca-core/ActorDefinition/producer"
              }
            ]
          },
          {
            "extension": [
              {
                "url": "code",
                "valueCode": "SHALL:no-error"
              },
              {
                "url": "actor",
                "valueCanonical": "http://fhir.infoway-inforoute.ca/ca-core/ActorDefinition/consumer"
              }
            ],
            "url": "http://hl7.org/fhir/StructureDefinition/obligation"
          }
        ],
        "path": "PractitionerRole.identifier"
      },
      {
        "id": "PractitionerRole.identifier.value",
        "path": "PractitionerRole.identifier.value",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Organization Affiliation Employee Identifier"
          }
        ]
      },
      {
        "id": "PractitionerRole.identifier.period.start",
        "path": "PractitionerRole.identifier.period.start",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Organization Affiliation Effective Date"
          }
        ]
      },
      {
        "id": "PractitionerRole.identifier.period.end",
        "path": "PractitionerRole.identifier.period.end",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Organization Affiliation Expiry Date"
          }
        ]
      },
      {
        "id": "PractitionerRole.period.start",
        "path": "PractitionerRole.period.start",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider-as-Affiliate Type Effective Date (Recommended)"
          }
        ]
      },
      {
        "id": "PractitionerRole.period.end",
        "path": "PractitionerRole.period.end",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider-as-Affiliate Type Expiry Date (Recommended)"
          }
        ]
      },
      {
        "id": "PractitionerRole.practitioner",
        "path": "PractitionerRole.practitioner",
        "comment": "pCHDCF modelling for care team concepts (including provider/practitionerRole/organization linking) is still underway. The requirements to support a linkage to provider details on practitionerRole for various use cases is still undefined. Reviewers are encouraged to provide feedback on the potential impact of applying a 'no-error' obligation on this element for clients. The profile will continue to evolve as care team details undergo data modelling in the pCHDCF.",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://fhir.infoway-inforoute.ca/cacore/StructureDefinition/practitioner-ca-core",
              "http://hl7.org/fhir/StructureDefinition/Practitioner"
            ]
          }
        ]
      },
      {
        "id": "PractitionerRole.organization",
        "path": "PractitionerRole.organization",
        "comment": "pCHDCF modelling for care team concepts (including provider/practitionerRole/organization linking) is still underway. The requirements to support a linkage to organization details on practitionerRole for various use cases is still undefined. For this reason, application of obligations and further constraints towards this element are not currently expressed in this profile. Reviewers are encouraged to provide feedback on the potential impact of applying a 'no-error' obligation on this element for clients. The profile will continue to evolve as care team details undergo data modelling in the pCHDCF.",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://fhir.infoway-inforoute.ca/cacore/StructureDefinition/organization-ca-core",
              "http://hl7.org/fhir/StructureDefinition/Organization"
            ]
          }
        ]
      },
      {
        "id": "PractitionerRole.code",
        "path": "PractitionerRole.code",
        "comment": "pCHDCF modelling for care team concepts is still underway. The requirements to support specialty and expertise details on practitionerRole for various use cases are still undefined.  Reviewers are encouraged to provide feedback on the potential impact of applying a 'no-error' obligation on this element for clients. The profile will continue to evolve as care team details undergo data modelling in the pCHDCF.",
        "binding": {
          "strength": "preferred",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/healthcareproviderrolecode",
          "extension": [
            {
              "url": "http://hl7.org/fhir/tools/StructureDefinition/additional-binding",
              "extension": [
                {
                  "url": "purpose",
                  "valueCode": "candidate"
                },
                {
                  "url": "valueSet",
                  "valueCanonical": "https://fhir.infoway-inforoute.ca/ValueSet/healthcareproviderroletype"
                },
                {
                  "url": "documentation",
                  "valueMarkdown": "A role type that is used to categorize an entity that delivers health care"
                }
              ]
            }
          ]
        },
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Role"
          },
          {
            "identity": "CACDI",
            "map": "Health Care Provider Type Code"
          }
        ]
      },
      {
        "id": "PractitionerRole.specialty",
        "path": "PractitionerRole.specialty",
        "comment": "pCHDCF modelling for care team concepts is still underway. The requirements to support specialty and expertise details on practitionerRole for various use cases are still undefined. Reviewers are encouraged to provide feedback on the potential impact of applying a 'no-error' obligation on this element for clients. The profile will continue to evolve as care team details undergo data modelling in the pCHDCF.",
        "binding": {
          "strength": "preferred",
          "valueSet": "https://fhir.infoway-inforoute.ca/ValueSet/healthcareproviderspecialtycode"
        }
      },
      {
        "id": "PractitionerRole.telecom",
        "path": "PractitionerRole.telecom",
        "comment": "Although the provider phone number and provider email concepts are expressed in the pCHDCF materials, their current definition does not distinctly identify the resource target(s) where it has to be applied (e.g., Practitioner vs PractitionerRole). Reviewers are encouraged to provide feedback on the potential impact of applying a 'no-error' obligation on this element for clients."
      },
      {
        "id": "PractitionerRole.telecom.value",
        "path": "PractitionerRole.telecom.value",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Value"
          }
        ]
      },
      {
        "id": "PractitionerRole.telecom.use",
        "path": "PractitionerRole.telecom.use",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Type Code"
          },
          {
            "identity": "CACDI",
            "map": "Health Care Provider Affiliation Contact Mechanism Purpose Code"
          }
        ]
      },
      {
        "id": "PractitionerRole.telecom.rank",
        "path": "PractitionerRole.telecom.rank",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Rank"
          }
        ]
      },
      {
        "id": "PractitionerRole.telecom.period.start",
        "path": "PractitionerRole.telecom.period.start",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Effective Date"
          }
        ]
      },
      {
        "id": "PractitionerRole.telecom.period.end",
        "path": "PractitionerRole.telecom.period.end",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Expiry Date"
          }
        ]
      }
    ]
  }
}