From 4cfbbddca0c33ad7cdcfb16bafba2156d3c561e9 Mon Sep 17 00:00:00 2001 From: Mikhail Kulakov Date: Mon, 9 Nov 2026 20:21:23 +0000 Subject: [PATCH] [HealthSamurai/smartbox#341] provider access: v1 roster is payer-maintained Groups Drop the "Group ingestion or an equivalent lookup feed" claim. The payer creates and updates its pdex-provider-group Groups through the FHIR API; Payerbox does not build or sync the roster. State the meta.profile requirement and the 422 on a mismatch. Co-Authored-By: Claude Opus 5.5 --- docs/interop-apis/provider-access.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/interop-apis/provider-access.md b/docs/interop-apis/provider-access.md index 42e5cbb..863c3e9 100644 --- a/docs/interop-apis/provider-access.md +++ b/docs/interop-apis/provider-access.md @@ -12,7 +12,7 @@ The [Da Vinci PDex Provider Access API](https://build.fhir.org/ig/HL7/davinci-ep - PDex Implementation Guide preconfigured. - `$provider-member-match` and `$davinci-data-export` operations available on the Interop bundle. -- Plugs into the payer's existing attribution roster — accepts `Group` ingestion or an equivalent lookup feed. +- Exports from the payer's attribution roster when the payer keeps one as `Group` resources in Payerbox. Payerbox does not build or sync the roster. - Member opt-out filtering applied before any Provider Access response. - Audit logging per provider request, scoped to the requesting provider. @@ -34,7 +34,7 @@ PDex keeps two patterns for delivering Provider Access data. For **CMS-0057-F co ### v1 — Payer-attributed Group export -The payer maintains an attribution roster mapping each in-network provider to the members the payer considers attributed to that provider, exposed as a `Group` resource per provider. The provider calls `$davinci-data-export` against that Group: +The payer maintains an attribution roster mapping each in-network provider to the members the payer considers attributed to that provider, as one `Group` per provider. The payer creates and updates these Groups through the FHIR API; Payerbox does not build or sync the roster. Each Group must carry the [`pdex-provider-group`](https://build.fhir.org/ig/HL7/davinci-epdx/StructureDefinition-pdex-provider-group.html) profile in `meta.profile`, otherwise the export is rejected with `422`. The provider calls `$davinci-data-export` against its Group: ``` POST /fhir/Group//$davinci-data-export