profiles / StructureDefinition

OMOP-Convertible PractitionerRole → provider

PractitionerRole provider edge mapspec

PractitionerRole that enriches an existing OMOP `provider` row (created from the referenced Practitioner). Does not create a new provider row — instead it contributes specialty_concept_id, specialty_source_value, and care_site_id. Requires a resolvable practitioner reference and at least one specialty coding.

Path Card Type Binding / Fixed Comment
PractitionerRole.practitioner 1..1 MS Reference Resolves to the existing provider row enriched by this PractitionerRole.
PractitionerRole.specialty 1..* MS At least one specialty CodeableConcept. First coding maps to provider.specialty_concept_id (SNOMED or NUCC).
PractitionerRole.specialty.coding 1..* MS
PractitionerRole.organization MS Optional. Becomes provider.care_site_id.
Raw JSON
{
  "resourceType": "StructureDefinition",
  "id": "omop-practitionerrole-provider",
  "url": "https://fhir2omop.health-samurai.io/StructureDefinition/omop-practitionerrole-provider",
  "version": "0.1.0",
  "name": "OmopPractitionerRoleProvider",
  "title": "OMOP-Convertible PractitionerRole → provider",
  "status": "draft",
  "experimental": true,
  "description": "PractitionerRole that enriches an existing OMOP `provider` row (created from the referenced Practitioner). Does not create a new provider row — instead it contributes specialty_concept_id, specialty_source_value, and care_site_id. Requires a resolvable practitioner reference and at least one specialty coding.",
  "fhirVersion": "4.0.1",
  "kind": "resource",
  "abstract": false,
  "type": "PractitionerRole",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/PractitionerRole",
  "derivation": "constraint",
  "extension": [
    {
      "url": "https://fhir2omop.health-samurai.io/StructureDefinition/omop-target-table",
      "valueString": "provider"
    },
    {
      "url": "https://fhir2omop.health-samurai.io/StructureDefinition/omop-edge",
      "valueString": "PractitionerRole__provider"
    }
  ],
  "differential": {
    "element": [
      {
        "id": "PractitionerRole.practitioner",
        "path": "PractitionerRole.practitioner",
        "min": 1,
        "max": "1",
        "mustSupport": true,
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/StructureDefinition/Practitioner"
            ]
          }
        ],
        "comment": "Resolves to the existing provider row enriched by this PractitionerRole."
      },
      {
        "id": "PractitionerRole.specialty",
        "path": "PractitionerRole.specialty",
        "min": 1,
        "mustSupport": true,
        "comment": "At least one specialty CodeableConcept. First coding maps to provider.specialty_concept_id (SNOMED or NUCC)."
      },
      {
        "id": "PractitionerRole.specialty.coding",
        "path": "PractitionerRole.specialty.coding",
        "min": 1,
        "mustSupport": true
      },
      {
        "id": "PractitionerRole.organization",
        "path": "PractitionerRole.organization",
        "mustSupport": true,
        "comment": "Optional. Becomes provider.care_site_id."
      }
    ]
  },
  "targetTable": "provider",
  "edgeKey": "PractitionerRole__provider"
}