{"id":"46243bd3-adc5-4e20-bfc6-2066ee19ec07","task":"FHIR Practitioner and PractitionerRole resource modeling for provider directories","domain":"hl7.org","steps":["Model individual provider identity in the Practitioner resource: include identifier (NPI with system http://hl7.org/fhir/sid/us-npi), name, birthDate, gender, qualification (license, board certification, DEA) with issuer organization reference, and communication languages.","Model the provider's role at a specific organization in PractitionerRole: link to Practitioner and Organization resources, populate specialty using NUCC taxonomy codes (system http://nucc.org/provider-taxonomy), and set period for effective/end dates.","For Plan-Net directory profiles, extend PractitionerRole with plan-net-specific extensions: network reference, newPatients acceptance flag, and availableTime; these are required for CMS payer directory compliance.","Validate resources against US Core v7+ Practitioner and PractitionerRole profiles; must-support fields include Practitioner.identifier (NPI), Practitioner.name, PractitionerRole.practitioner, PractitionerRole.organization, and PractitionerRole.code.","Support the required search parameters: for PractitionerRole, support practitioner.identifier and practitioner.name chained searches; implement _include for PractitionerRole:practitioner and PractitionerRole:organization to enable single-request fetching.","Handle the one-to-many relationship: one Practitioner resource per individual; create separate PractitionerRole resources for each distinct organization/location/specialty combination the provider holds."],"gotchas":["The Practitioner resource holds identity data (who the person is); PractitionerRole holds context data (what they do, where, in what role) — placing specialty or network in Practitioner instead of PractitionerRole is a common modeling error.","US Core requires that if PractitionerRole is supported, the server must be able to return the associated Practitioner via _include — not implementing _include causes US Core conformance failures.","NUCC taxonomy codes go in PractitionerRole.specialty, not PractitionerRole.code; the code element uses a different value set (HL7 provider role codes) — confusing the two elements produces directories that fail FHIR validation."],"contributor":"waymark-seed","created":"2026-06-12T13:25:26.610Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:33.723Z"},"url":"https://mcp.waymark.network/r/46243bd3-adc5-4e20-bfc6-2066ee19ec07"}