From 74d10e3d35d12616049fb9659d7447c1f6708c40 Mon Sep 17 00:00:00 2001 From: Mikhail Kulakov Date: Tue, 30 Jun 2026 20:46:42 +0100 Subject: [PATCH 1/5] docs(releases): add June 2026 (2606) release notes Add a 2606 section and restructure the page to track releases newest-first: Helm umbrella chart; Interop UDAP auth + payertopayer export; MPF pipeline optimizations + public Aidbox example; PAS 2.1.0 (default) with idempotent $submit and root-Claim semantics; CRD decision-service error passthrough; backend client-secret auth; redesigned admin app-review card. Co-Authored-By: Claude Opus 4.8 --- docs/releases.md | 56 ++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 49 insertions(+), 7 deletions(-) diff --git a/docs/releases.md b/docs/releases.md index 622b00d..8871df4 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -1,19 +1,61 @@ --- -description: Notable changes across Payerbox — the Interop APIs, the Prior Auth (ePA) APIs, and the FHIR App Portal. +description: "Notable changes across Payerbox: the Interop APIs, the Prior Auth (ePA) APIs, and the FHIR App Portal." --- # Releases -This page tracks notable changes across Payerbox — the Interop APIs, the Prior Auth (ePA) APIs, and the FHIR App Portal. +This page tracks notable changes across Payerbox: the Interop APIs, the Prior Auth (ePA) APIs, and the FHIR App Portal. Releases are listed newest first. The apps run on an Aidbox FHIR server; each component heading links to its image on Docker Hub. -This is the **May 2026** release (tag `2605`); the apps run on an Aidbox FHIR server. Each component heading below links to its image on Docker Hub. +## June 2026 (`2606`) -## Interop APIs [`2605`](https://hub.docker.com/r/healthsamurai/interop) +This release adds the `payerbox` umbrella Helm chart, which deploys the full Payerbox stack (the portals, Interop APIs, Prior Auth, and Aidbox) to Kubernetes in one release. See [Deploy](run-payerbox/deploy.md). + +### Interop APIs [`2606`](https://hub.docker.com/r/healthsamurai/interop) + +**Payer-to-Payer** + +- `$bulk-member-match` authenticates the calling payer via UDAP (B2B). See [Authentication](api-reference/authentication.md). +- [`$davinci-data-export`](api-reference/operations/davinci-data-export.md) adds the `payertopayer` export type for Payer-to-Payer exchange. + +**Provider Directory** + +- The CMS Medicare Plan Finder (MPF) provider-directory pipeline is optimized: directory scope filtering now runs server-side in the `$export` query, export output is gzip-compressed, and files are published through presigned URLs so the storage buckets stay private. See the [MPF Pipeline](run-payerbox/provider-directory-pipeline.md); a runnable reference implementation is now public in the [Aidbox examples](https://github.com/Aidbox/examples/tree/main/aidbox-features/medicare-plan-finder). + +### Prior Auth (ePA) APIs [`2606`](https://hub.docker.com/r/healthsamurai/prior-auth) + +**Implementation Guide versions** + +- PAS is upgraded to Da Vinci STU `2.1.0`, now the default. STU `2.0.1` remains selectable via the `PAS_IG_VERSION` setting. See [PAS](prior-auth/pas.md). +- CRD and DTR are upgraded to `2.1.0`. See [CRD](prior-auth/crd.md) and [DTR](prior-auth/dtr/README.md). + +**PAS** + +- [`Claim/$submit`](api-reference/operations/claim-submit.md) adds a ClaimResponse reference extension on the submitted Claim, linking it to the resulting ClaimResponse. +- `Claim/$submit` is idempotent on `Claim.identifier` (the X12 278 trace number): resubmitting the same identifier without a `replaces` reference is treated as a retry and returns the existing ClaimResponse. +- Under PAS 2.1.0, a prior authorization's ClaimResponse stays on the original (root) Claim and update Claims carry none; `Claim/$submit` and `Claim/$inquire` follow a `replaces` chain back to the root and return its ClaimResponse. + +**CRD** + +- When the CRD decision service returns an error, Payerbox relays its HTTP status and surfaces the original error in the returned `OperationOutcome`. See [CRD](prior-auth/crd.md). + +### FHIR App Portal [`2606`](https://hub.docker.com/r/healthsamurai/fhir-app-portal) + +**Developer Portal** + +- Backend (bulk data) services can now authenticate with a client secret as well as a JWKS URI. See [Authentication](api-reference/authentication.md). + +**Admin Portal** + +- Redesigned the app review card in the admin interface. + +## May 2026 (`2605`) + +### Interop APIs [`2605`](https://hub.docker.com/r/healthsamurai/interop) **Provider Access** - Added the [`$provider-member-match`](api-reference/operations/provider-member-match.md) operation: asynchronous demographic matching with treatment attestation and opt-out consent checks. See [Provider Access](interop-apis/provider-access.md). -- Added the [`$davinci-data-export`](api-reference/operations/davinci-data-export.md) operation: an asynchronous FHIR Bulk Data export over a member `Group`, used by both Provider Access and Payer-to-Payer. +- Added the [`$davinci-data-export`](api-reference/operations/davinci-data-export.md) operation: an asynchronous FHIR Bulk Data export over a member `Group`, used by Provider Access. **Payer-to-Payer** @@ -23,7 +65,7 @@ This is the **May 2026** release (tag `2605`); the apps run on an Aidbox FHIR se - Added a CMS Medicare Plan Finder (MPF) provider-directory export (opt-in per deployment): builds the MPF provider feed and publishes a public index URL per Medicare Advantage contract and reporting year, designed to run on a daily schedule. -## Prior Auth (ePA) APIs [`2605`](https://hub.docker.com/r/healthsamurai/prior-auth) +### Prior Auth (ePA) APIs [`2605`](https://hub.docker.com/r/healthsamurai/prior-auth) **CDS Hooks** @@ -46,7 +88,7 @@ This is the **May 2026** release (tag `2605`); the apps run on an Aidbox FHIR se - Added asynchronous result delivery: completed decisions are delivered to the EHR as a PAS Response Bundle via a topic-based FHIR Subscription. - When additional documentation is submitted via `$submit-attachment`, the prior authorization is re-queued for review (ClaimResponse disposition "Pending Review"). -## FHIR App Portal [`2605`](https://hub.docker.com/r/healthsamurai/fhir-app-portal) +### FHIR App Portal [`2605`](https://hub.docker.com/r/healthsamurai/fhir-app-portal) **Developer Portal** From 4d5c76072fcf0c9f1b9bdd6209337ee92d737c27 Mon Sep 17 00:00:00 2001 From: Mikhail Kulakov Date: Wed, 1 Jul 2026 18:18:38 +0100 Subject: [PATCH 2/5] docs(releases): apply review edits to 2606 notes - MPF: drop presigned-URL/private-bucket detail - PAS: PAS_IG_VERSION is an env var, not a setting - $submit idempotency: drop X12 jargon, state the no-duplicate guarantee plainly - PAS 2.1.0 ClaimResponse: simpler single-CR-on-original phrasing - Dev Portal: frame as registering a client-credentials service (not auth) Co-Authored-By: Claude Opus 4.8 --- docs/releases.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/releases.md b/docs/releases.md index 8871df4..62ab770 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -19,20 +19,20 @@ This release adds the `payerbox` umbrella Helm chart, which deploys the full Pay **Provider Directory** -- The CMS Medicare Plan Finder (MPF) provider-directory pipeline is optimized: directory scope filtering now runs server-side in the `$export` query, export output is gzip-compressed, and files are published through presigned URLs so the storage buckets stay private. See the [MPF Pipeline](run-payerbox/provider-directory-pipeline.md); a runnable reference implementation is now public in the [Aidbox examples](https://github.com/Aidbox/examples/tree/main/aidbox-features/medicare-plan-finder). +- The CMS Medicare Plan Finder (MPF) provider-directory pipeline is optimized: directory scope filtering now runs server-side in the `$export` query, and export output is gzip-compressed. See the [MPF Pipeline](run-payerbox/provider-directory-pipeline.md); a runnable reference implementation is now public in the [Aidbox examples](https://github.com/Aidbox/examples/tree/main/aidbox-features/medicare-plan-finder). ### Prior Auth (ePA) APIs [`2606`](https://hub.docker.com/r/healthsamurai/prior-auth) **Implementation Guide versions** -- PAS is upgraded to Da Vinci STU `2.1.0`, now the default. STU `2.0.1` remains selectable via the `PAS_IG_VERSION` setting. See [PAS](prior-auth/pas.md). +- PAS is upgraded to Da Vinci STU `2.1.0`, now the default. STU `2.0.1` remains selectable via the `PAS_IG_VERSION` environment variable. See [PAS](prior-auth/pas.md). - CRD and DTR are upgraded to `2.1.0`. See [CRD](prior-auth/crd.md) and [DTR](prior-auth/dtr/README.md). **PAS** - [`Claim/$submit`](api-reference/operations/claim-submit.md) adds a ClaimResponse reference extension on the submitted Claim, linking it to the resulting ClaimResponse. -- `Claim/$submit` is idempotent on `Claim.identifier` (the X12 278 trace number): resubmitting the same identifier without a `replaces` reference is treated as a retry and returns the existing ClaimResponse. -- Under PAS 2.1.0, a prior authorization's ClaimResponse stays on the original (root) Claim and update Claims carry none; `Claim/$submit` and `Claim/$inquire` follow a `replaces` chain back to the root and return its ClaimResponse. +- `Claim/$submit` is idempotent on `Claim.identifier`: resubmitting a Claim whose identifier already exists returns the existing ClaimResponse and does not create a duplicate prior authorization. +- Under PAS 2.1.0, an updated prior authorization keeps a single ClaimResponse on the original Claim; `Claim/$submit` and `Claim/$inquire` return it for any Claim in the update chain. **CRD** @@ -42,7 +42,7 @@ This release adds the `payerbox` umbrella Helm chart, which deploys the full Pay **Developer Portal** -- Backend (bulk data) services can now authenticate with a client secret as well as a JWKS URI. See [Authentication](api-reference/authentication.md). +- The Developer Portal can now register a backend (bulk data) service that uses a client secret (client-credentials), in addition to a JWKS URI. See [Developer Portal](fhir-app-portal/developer-portal.md). **Admin Portal** From 3812e3e67e239a00d73fbbb372eba89eab8e77f6 Mon Sep 17 00:00:00 2001 From: Mikhail Kulakov Date: Wed, 1 Jul 2026 18:34:56 +0100 Subject: [PATCH 3/5] docs(releases): link $bulk-member-match to its operation page Consistent with the adjacent $davinci-data-export link and the 2605 entry. Co-Authored-By: Claude Opus 4.8 --- docs/releases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/releases.md b/docs/releases.md index 62ab770..c7ecfe7 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -14,7 +14,7 @@ This release adds the `payerbox` umbrella Helm chart, which deploys the full Pay **Payer-to-Payer** -- `$bulk-member-match` authenticates the calling payer via UDAP (B2B). See [Authentication](api-reference/authentication.md). +- [`$bulk-member-match`](api-reference/operations/bulk-member-match.md) authenticates the calling payer via UDAP (B2B). See [Authentication](api-reference/authentication.md). - [`$davinci-data-export`](api-reference/operations/davinci-data-export.md) adds the `payertopayer` export type for Payer-to-Payer exchange. **Provider Directory** From 6a2c06881ff9fe04572f787ed9098963215dccf9 Mon Sep 17 00:00:00 2001 From: Mikhail Kulakov Date: Wed, 1 Jul 2026 18:35:46 +0100 Subject: [PATCH 4/5] docs(releases): link $inquire on first mention (link consistency) Co-Authored-By: Claude Opus 4.8 --- docs/releases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/releases.md b/docs/releases.md index c7ecfe7..fd1045c 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -32,7 +32,7 @@ This release adds the `payerbox` umbrella Helm chart, which deploys the full Pay - [`Claim/$submit`](api-reference/operations/claim-submit.md) adds a ClaimResponse reference extension on the submitted Claim, linking it to the resulting ClaimResponse. - `Claim/$submit` is idempotent on `Claim.identifier`: resubmitting a Claim whose identifier already exists returns the existing ClaimResponse and does not create a duplicate prior authorization. -- Under PAS 2.1.0, an updated prior authorization keeps a single ClaimResponse on the original Claim; `Claim/$submit` and `Claim/$inquire` return it for any Claim in the update chain. +- Under PAS 2.1.0, an updated prior authorization keeps a single ClaimResponse on the original Claim; `Claim/$submit` and [`Claim/$inquire`](api-reference/operations/claim-inquire.md) return it for any Claim in the update chain. **CRD** From 43b0bfa464de7a5a42af6b883db3a3c39bfa4712 Mon Sep 17 00:00:00 2001 From: Mikhail Kulakov Date: Wed, 1 Jul 2026 18:42:50 +0100 Subject: [PATCH 5/5] docs(releases): fold IG version bumps into CRD/DTR/PAS; apply house style - Version upgrades moved into their CRD/DTR/PAS sections (matches 2605 layout) - Rewrite 2606 prose per aidbox-docs no-slop rules: active voice, no vague 'is optimized', drop redundant section restatement, tighten Helm lead Co-Authored-By: Claude Opus 4.8 --- docs/releases.md | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/releases.md b/docs/releases.md index fd1045c..59d2570 100644 --- a/docs/releases.md +++ b/docs/releases.md @@ -8,7 +8,7 @@ This page tracks notable changes across Payerbox: the Interop APIs, the Prior Au ## June 2026 (`2606`) -This release adds the `payerbox` umbrella Helm chart, which deploys the full Payerbox stack (the portals, Interop APIs, Prior Auth, and Aidbox) to Kubernetes in one release. See [Deploy](run-payerbox/deploy.md). +A new `payerbox` umbrella Helm chart deploys the full stack (portals, Interop APIs, Prior Auth, and Aidbox) to Kubernetes. See [Deploy](run-payerbox/deploy.md). ### Interop APIs [`2606`](https://hub.docker.com/r/healthsamurai/interop) @@ -19,34 +19,35 @@ This release adds the `payerbox` umbrella Helm chart, which deploys the full Pay **Provider Directory** -- The CMS Medicare Plan Finder (MPF) provider-directory pipeline is optimized: directory scope filtering now runs server-side in the `$export` query, and export output is gzip-compressed. See the [MPF Pipeline](run-payerbox/provider-directory-pipeline.md); a runnable reference implementation is now public in the [Aidbox examples](https://github.com/Aidbox/examples/tree/main/aidbox-features/medicare-plan-finder). +- The CMS Medicare Plan Finder (MPF) provider-directory pipeline now runs its scope filters inside the `$export` query and gzip-compresses the export output. A runnable reference implementation is public in the [Aidbox examples](https://github.com/Aidbox/examples/tree/main/aidbox-features/medicare-plan-finder). See the [MPF Pipeline](run-payerbox/provider-directory-pipeline.md). ### Prior Auth (ePA) APIs [`2606`](https://hub.docker.com/r/healthsamurai/prior-auth) -**Implementation Guide versions** +**CRD** + +- Upgraded to Da Vinci CRD 2.1.0. See [CRD](prior-auth/crd.md). +- When the decision service returns an error, Payerbox relays its HTTP status and surfaces the original error in the returned `OperationOutcome`. + +**DTR** -- PAS is upgraded to Da Vinci STU `2.1.0`, now the default. STU `2.0.1` remains selectable via the `PAS_IG_VERSION` environment variable. See [PAS](prior-auth/pas.md). -- CRD and DTR are upgraded to `2.1.0`. See [CRD](prior-auth/crd.md) and [DTR](prior-auth/dtr/README.md). +- Upgraded to Da Vinci DTR 2.1.0. See [DTR](prior-auth/dtr/README.md). **PAS** +- Upgraded to Da Vinci PAS STU 2.1.0, now the default. STU 2.0.1 remains selectable via the `PAS_IG_VERSION` environment variable. See [PAS](prior-auth/pas.md). - [`Claim/$submit`](api-reference/operations/claim-submit.md) adds a ClaimResponse reference extension on the submitted Claim, linking it to the resulting ClaimResponse. - `Claim/$submit` is idempotent on `Claim.identifier`: resubmitting a Claim whose identifier already exists returns the existing ClaimResponse and does not create a duplicate prior authorization. - Under PAS 2.1.0, an updated prior authorization keeps a single ClaimResponse on the original Claim; `Claim/$submit` and [`Claim/$inquire`](api-reference/operations/claim-inquire.md) return it for any Claim in the update chain. -**CRD** - -- When the CRD decision service returns an error, Payerbox relays its HTTP status and surfaces the original error in the returned `OperationOutcome`. See [CRD](prior-auth/crd.md). - ### FHIR App Portal [`2606`](https://hub.docker.com/r/healthsamurai/fhir-app-portal) **Developer Portal** -- The Developer Portal can now register a backend (bulk data) service that uses a client secret (client-credentials), in addition to a JWKS URI. See [Developer Portal](fhir-app-portal/developer-portal.md). +- Register a backend (bulk data) service with a client secret (client-credentials), in addition to a JWKS URI. See [Developer Portal](fhir-app-portal/developer-portal.md). **Admin Portal** -- Redesigned the app review card in the admin interface. +- Redesigned the app review card. ## May 2026 (`2605`)