{
  "resourceType": "StructureDefinition",
  "id": "practitioner-ca-core",
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 2
    }
  ],
  "url": "http://fhir.infoway-inforoute.ca/cacore/StructureDefinition/practitioner-ca-core",
  "version": "1.1.0",
  "name": "PractitionerCACore",
  "title": "Practitioner (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 Patient resource for CA Core+ to support identity, demographics, and administrative data 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": "Practitioner",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Practitioner",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "Practitioner.identifier",
        "path": "Practitioner.identifier",
        "comment": "pCHDCF modelling for care team concepts (including provider identifiers) is still underway. The requirements to support certain types of identifiers (e.g., province/territory registration identifiers) across all use cases and decisions on whether the identifier requirements should apply to both Practitioner and PractitionerRole  are still undefined. Furthermore, the ways that these identifiers will be differentiated for conformance testing purposes is still undefined (see comment on identifier.type). For this reason, slice modelling and application of obligations towards certain identifiers is not currently expressed in this profile. The profile will continue to evolve as care team details undergo data modelling in the pCHDCF.",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Identifier Information"
          }
        ]
      },
      {
        "id": "Practitioner.identifier.type",
        "path": "Practitioner.identifier.type",
        "comment": "The value in identifier.type is typically used to differentiate between identifiers that serve distinct purposes (e.g., Medical License Number, Regional Registry ID, Health Plan Identifier). Profiles typically use the identifier.type to differentiate between expectations that are expressed for some identifier types but not others. However, current implementations of practitioner identifiers in Canada use the identifier.type of 'Provider Number' (coded as 'PRN') to convey a number of different types of identifiers (e.g., registration number, license numbers, and billing numbers). Should there be expectations in the future for this profile to differentiate between these identifiers, current typing practices may need to change and/or further details may need to be used (e.g., identifier.system) to differentiate between concepts like registration number, license number, and billing number.",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Party Non-Health Identifier Type"
          }
        ]
      },
      {
        "id": "Practitioner.identifier.system",
        "path": "Practitioner.identifier.system",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Party Non-Health Identifier System"
          }
        ]
      },
      {
        "id": "Practitioner.identifier.value",
        "path": "Practitioner.identifier.value",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Licence Number"
          },
          {
            "identity": "CACDI",
            "map": "Party Non-Health Identifier"
          }
        ]
      },
      {
        "id": "Practitioner.identifier.period.start",
        "path": "Practitioner.identifier.period.start",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Licence Effective Date"
          },
          {
            "identity": "CACDI",
            "map": "Party Non-Health Identifier Effective Date"
          }
        ]
      },
      {
        "id": "Practitioner.identifier.period.end",
        "path": "Practitioner.identifier.period.end",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Licence Expiry Date"
          },
          {
            "identity": "CACDI",
            "map": "Party Non-Health Identifier Expiry Date"
          }
        ]
      },
      {
        "id": "Practitioner.name",
        "path": "Practitioner.name",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Name Information"
          }
        ]
      },
      {
        "id": "Practitioner.name.use",
        "path": "Practitioner.name.use",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Name Type"
          }
        ]
      },
      {
        "id": "Practitioner.name.text",
        "path": "Practitioner.name.text",
        "definition": "Text representation of the full name. Due to the cultural variance around the world a consuming system may not know how to present the name correctly; moreover not all the parts of the name go in given or family. Creators are therefore strongly encouraged to provide through this element a presented version of the name. Future versions of this guide may require this element"
      },
      {
        "id": "Practitioner.telecom",
        "path": "Practitioner.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). The mappings and obligations for these details have been removed from the profile to avoid unintentional placement of these requirements until further pCHDCF data modelling for care team details is complete. Reviewers are encouraged to provide feedback on the potential impact of applying a 'no-error' obligation on this element for clients.",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Telecom Information"
          }
        ]
      },
      {
        "id": "Practitioner.telecom.value",
        "path": "Practitioner.telecom.value",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Value"
          }
        ]
      },
      {
        "id": "Practitioner.telecom.use",
        "path": "Practitioner.telecom.use",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Type Code"
          }
        ]
      },
      {
        "id": "Practitioner.telecom.rank",
        "path": "Practitioner.telecom.rank",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Rank"
          }
        ]
      },
      {
        "id": "Practitioner.telecom.period.start",
        "path": "Practitioner.telecom.period.start",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Effective Date"
          }
        ]
      },
      {
        "id": "Practitioner.telecom.period.end",
        "path": "Practitioner.telecom.period.end",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Contact Mechanism Expiry Date"
          }
        ]
      },
      {
        "id": "Practitioner.address",
        "path": "Practitioner.address",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Health Care Provider Address"
          }
        ]
      },
      {
        "id": "Practitioner.address.extension:preferred",
        "path": "Practitioner.address.extension",
        "sliceName": "preferred",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://hl7.org/fhir/StructureDefinition/iso21090-preferred"
            ]
          }
        ]
      },
      {
        "id": "Practitioner.address.type",
        "path": "Practitioner.address.type",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Address Type Code"
          }
        ]
      },
      {
        "id": "Practitioner.address.line",
        "path": "Practitioner.address.line",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Street Number"
          },
          {
            "identity": "CACDI",
            "map": "Street Number Suffix"
          },
          {
            "identity": "CACDI",
            "map": "Street Name"
          },
          {
            "identity": "CACDI",
            "map": "Street Type Code"
          },
          {
            "identity": "CACDI",
            "map": "Street Direction Code"
          },
          {
            "identity": "CACDI",
            "map": "Suite Type Code"
          },
          {
            "identity": "CACDI",
            "map": "Suite Number"
          },
          {
            "identity": "CACDI",
            "map": "Address 2"
          },
          {
            "identity": "CACDI",
            "map": "Address Additional Information Text"
          }
        ]
      },
      {
        "id": "Practitioner.address.state",
        "path": "Practitioner.address.state",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Province or Territory Code"
          },
          {
            "identity": "CACDI",
            "map": "Province or Territory English Name"
          },
          {
            "identity": "CACDI",
            "map": "Province or Territory French Name"
          }
        ]
      },
      {
        "id": "Practitioner.address.postalCode",
        "path": "Practitioner.address.postalCode",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Non-Canadian Postal Code Value"
          },
          {
            "identity": "CACDI",
            "map": "Canadian Postal Code Value"
          }
        ]
      },
      {
        "id": "Practitioner.address.country",
        "path": "Practitioner.address.country",
        "mapping": [
          {
            "identity": "CACDI",
            "map": "Country Code"
          },
          {
            "identity": "CACDI",
            "map": "Country English Name"
          },
          {
            "identity": "CACDI",
            "map": "Country French Name"
          }
        ]
      },
      {
        "id": "Practitioner.qualification.code",
        "path": "Practitioner.qualification.code",
        "binding": {
          "strength": "example",
          "valueSet": "http://terminology.hl7.org/ValueSet/v2-2.7-0360"
        }
      },
      {
        "id": "Practitioner.communication",
        "path": "Practitioner.communication",
        "binding": {
          "strength": "preferred",
          "valueSet": "http://hl7.org/fhir/ValueSet/languages"
        }
      }
    ]
  }
}