Skip to content

Provider Directory: plan provider number in providers and facilities - #146

Draft
Nesmeshnoy wants to merge 3 commits into
mainfrom
data-integration/payer-provider-id
Draft

Nesmeshnoy wants to merge 3 commits into
mainfrom
data-integration/payer-provider-id

Conversation

@Nesmeshnoy

@Nesmeshnoy Nesmeshnoy commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

What

  • Two optional columns in providers and facilities: payer_provider_id and payer_provider_id_system.
  • FHIR placement: PractitionerRole.identifier for practitioners, because the number can differ per location; Organization.identifier for facilities. The system comes from payer_provider_id_system, the type is PRN (Provider number) from v2-0203. The NPI stays where it is.
  • The row key includes the number when it is sent, so facilities that share an NPI but carry different plan numbers become separate Organizations and Locations.
  • A note that the number is visible in the public directory.
  • One plan provider number per row. A plan that needs to publish several can get numbered identifier columns later, as in Patient Demographics (identifier_<n>_value, _system, _type), without changing payer_provider_id.

Plans that do not send the columns see no change.

Why

Utilization-management vendors and UM platforms can identify a provider by the plan's own number rather than by NPI. One NPI can match several provider records (a hospital NPI shared by several sites), so a prior authorization request that carries only the NPI cannot be matched to one record. Today the contract has no column for that number.

Basis

  • Plan-Net STU 1.2.0: PractitionerRole.identifier is defined as business identifiers specific to a role or location; Practitioner.identifier and Organization.identifier slicing is open; identifier.type is bound (extensible) to the R4 IdentifierType value set, where PRN is the only provider-number code.
  • 42 CFR 422.120(b)(1) requires names, addresses, phone numbers and specialties; it neither requires nor rules out other identifiers.

Before merge

  • The loader does not read these columns yet. Merge together with loader support or after it.

🤖 Generated with Claude Code

…acilities

Adds optional payer_provider_id and payer_provider_id_system columns to the
providers and facilities datasets. The number goes on PractitionerRole
(providers) and Organization (facilities) as a second identifier next to the
NPI, with type PRN from v2-0203. Facilities that share an NPI but carry
different plan numbers become separate rows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Nesmeshnoy and others added 2 commits November 9, 2026 13:31
State that a plan sends one number per row and, when it numbers providers
in more than one way, gives each numbering its own system URI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant