Skip to content

Aligned spec for Consultation Medium with Aggreagtor code behaviour, …#164

Open
edwardbowyer-nhs wants to merge 2 commits into
masterfrom
apm-000-WPP-10569-aling-spec-consultation-medium
Open

Aligned spec for Consultation Medium with Aggreagtor code behaviour, …#164
edwardbowyer-nhs wants to merge 2 commits into
masterfrom
apm-000-WPP-10569-aling-spec-consultation-medium

Conversation

@edwardbowyer-nhs

@edwardbowyer-nhs edwardbowyer-nhs commented Jun 22, 2026

Copy link
Copy Markdown

Summary

Associated Aggregator code change details WPP-10569 and PR 433

Updated the Producer and Consumer spec to align to agreed behaviour with SCS team.

Removing the redundant VIRTUAL valueCode, VIRTUAL" will be accepted from PEPs but treated as invalid for downstream purposes, it will be filtered out by the Aggregator and not included in the response to the App. Only valid Consultation Mediums will cause the object to be present in response rather than passing empty strings for invalid values.
Only the following values will be passed through to the App: FACE_TO_FACE, VIDEO_CONSULTATION, TELEPHONE

Reviews Required

  • Dev
  • Test
  • Tech Author
  • Product Owner

Review Checklist

ℹ️ This section is to be filled in by the reviewer.

  • I have reviewed the changes in this PR and they fill all or part of the acceptance criteria of the ticket, and the code is in a mergeable state.
  • If there were infrastructure, operational, or build changes, I have made sure there is sufficient evidence that the changes will work.
  • I have ensured the changelog has been updated by the submitter, if necessary.

@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital APM JIRA Project. Here's a handy link to the ticket:

APM-000

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Producer and Consumer OpenAPI specifications to align with agreed Aggregator behaviour for Consultation Medium handling, deprecating/removing VIRTUAL and only passing through recognised values to downstream consumers (NHS App).

Changes:

  • Removed VIRTUAL from the Consultation Medium enum values in both Producer and Consumer specs.
  • Updated schema descriptions to reflect that only recognised consultation mediums are included/passed through.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
specification/patient-care-aggregator-api-producer-api-standards.yaml Removes VIRTUAL from Consultation Medium enum and updates related description text in the Producer API Standard schema.
specification/patient-care-aggregator-api-consumer-api.yaml Removes VIRTUAL from Consultation Medium enum and updates descriptions to indicate the object is only present for recognised values.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Pending Cancellation
- Confirmed Attendance
- description: "Consultation medium - whether the appointment is face-to-face, on the telephone or via an online video consultation (required). VIRTUAL is now deprecated and only remains in the API spec for backwards compatibility reasons."
- description: "Consultation medium - whether the appointment is face-to-face, on the telephone or via an online video consultation (required). VIRTUAL is now deprecated, it will be filtered and removed from responses, along with any other values not listed."
Comment on lines 420 to 424
description: The consultation medium itself.
enum:
- "FACE_TO_FACE"
- "VIRTUAL"
- "VIDEO_CONSULTATION"
- "TELEPHONE"
Comment thread specification/patient-care-aggregator-api-consumer-api.yaml Outdated
Comment on lines 773 to 777
type: string
enum:
- FACE_TO_FACE
- VIRTUAL
- VIDEO_CONSULTATION
- TELEPHONE
@github-actions

Copy link
Copy Markdown

This branch is work on a ticket in the NHS Digital APM JIRA Project. Here's a handy link to the ticket:

APM-000

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.

2 participants