profiles / StructureDefinition

OMOP-Convertible Practitioner → provider

Practitioner provider edge mapspec

FHIR Practitioner that can be converted to OMOP `provider`. Requires at least one identifier (used as NPI / provider_source_value) and at least one name (used as provider_name). Practitioner has no `code` element, so there is no domain ValueSet binding; specialty is enriched separately via PractitionerRole → provider.

Path Card Type Binding / Fixed Comment
Practitioner.identifier 1..* MS At least one identifier required. NPI (system http://hl7.org/fhir/sid/us-npi) is preferred for provider.npi.
Practitioner.name 1..* MS At least one name. First entry becomes provider.provider_name.
Practitioner.gender MS fhir/administrative-gender required
Practitioner.birthDate MS Year portion becomes provider.year_of_birth.
Raw JSON
{
  "resourceType": "StructureDefinition",
  "id": "omop-practitioner-provider",
  "url": "https://fhir2omop.health-samurai.io/StructureDefinition/omop-practitioner-provider",
  "version": "0.1.0",
  "name": "OmopPractitionerProvider",
  "title": "OMOP-Convertible Practitioner → provider",
  "status": "draft",
  "experimental": true,
  "description": "FHIR Practitioner that can be converted to OMOP `provider`. Requires at least one identifier (used as NPI / provider_source_value) and at least one name (used as provider_name). Practitioner has no `code` element, so there is no domain ValueSet binding; specialty is enriched separately via PractitionerRole → provider.",
  "fhirVersion": "4.0.1",
  "kind": "resource",
  "abstract": false,
  "type": "Practitioner",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Practitioner",
  "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": "Practitioner__provider"
    }
  ],
  "differential": {
    "element": [
      {
        "id": "Practitioner.identifier",
        "path": "Practitioner.identifier",
        "min": 1,
        "mustSupport": true,
        "comment": "At least one identifier required. NPI (system http://hl7.org/fhir/sid/us-npi) is preferred for provider.npi."
      },
      {
        "id": "Practitioner.name",
        "path": "Practitioner.name",
        "min": 1,
        "mustSupport": true,
        "comment": "At least one name. First entry becomes provider.provider_name."
      },
      {
        "id": "Practitioner.gender",
        "path": "Practitioner.gender",
        "mustSupport": true,
        "binding": {
          "strength": "required",
          "valueSet": "http://hl7.org/fhir/ValueSet/administrative-gender",
          "description": "Maps to provider.gender_concept_id."
        }
      },
      {
        "id": "Practitioner.birthDate",
        "path": "Practitioner.birthDate",
        "mustSupport": true,
        "comment": "Year portion becomes provider.year_of_birth."
      }
    ]
  },
  "targetTable": "provider",
  "edgeKey": "Practitioner__provider"
}