From 2ad4b2a8138985e71f8ab5861420f9cbbb00a3b9 Mon Sep 17 00:00:00 2001
From: Derek Dreyer <56388818+d-dreyer@users.noreply.github.com>
Date: Fri, 8 May 2026 15:48:39 +0100
Subject: [PATCH 1/3] NBRS-4661 - Updated App 8 Flag Links
Add a link to the Simplifier Example for Additional Patient Information.
Corrected the link on the Payload data page for Flag to render as a clickable URL.
---
.../BaRS-Applications/Applications/BaRS-APP8/Payloads.page.md | 2 +-
.../Applications/BaRS-APP8/Referral-Payload.page.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Payloads.page.md b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Payloads.page.md
index 8aebc38f..b639bcd4 100644
--- a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Payloads.page.md
+++ b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Payloads.page.md
@@ -49,7 +49,7 @@ The Task is used to direct the next action(s) required by the Sender making the
### Flag Resource
The Flag resource is used to communicate prospective warnings of potential issues when providing care to the patient. The population of the Flag Resource is optional as not all subjects will have relevant issues.
-BaRS Senders **should** populate Flag resources and **should** make adequate provision in their solution to support key flags in BaRS Application workflows, for example, Additional Patient Information. When populating this resource, Senders **must** include both *flag.category* and *flag.code* values using the specific [BaRS CodeSystems](https://simplifier.net/nhsbookingandreferrals/~resources?category=CodeSystem&sortBy=DisplayName).
+BaRS Senders **should** populate Flag resources and **should** make adequate provision in their solution to support key flags in BaRS Application workflows, for example, [Additional Patient Information](https://simplifier.net/NHSBookingandReferrals/01dcdcbb-93c0-4418-a5f5-d8b2573d4866). When populating this resource, Senders **must** include both *flag.category* and *flag.code* values using the specific [BaRS CodeSystems](https://simplifier.net/nhsbookingandreferrals/~resources?category=CodeSystem&sortBy=DisplayName).
When a BARS Receiver processes information in a Flag resource;
diff --git a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
index 62c486f8..dbe614a4 100644
--- a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
+++ b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
@@ -481,7 +481,7 @@ This payload is used to transmit all the necessary information that is required
| Data Item | Implementation Guidance | Necessity | Profile Cardinality | Example Value(s) |
|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|---------------------|-----------------------------------------------------|
-| Flag | The Flag resource is used to risks and special patient requirements e.g. transport requirements, accessibility requirements, and reasonable adjustments. It can also be used to carry information about safeguarding concerns.
https://simplifier.net/hl7fhirukcorer4/ukcore-flag | | 0..* | |
+| Flag | The Flag resource is used to risks and special patient requirements e.g. transport requirements, accessibility requirements, and reasonable adjustments. It can also be used to carry information about safeguarding concerns.
'https://simplifier.net/hl7fhirukcorer4/ukcore-flag' | | 0..* | |
| Flag.id | This MUST only be populated with an id generated by the Receiver in the synchronous HTTP response. | MUST | 0..1 | 77be46e3-7f01-4afe-b37d-7a301db6df63 |
| Flag.meta | https://www.hl7.org/fhir/resource.html#Meta | | 1..1 | |
| Flag.meta.profile | This MUST be populated. Follow UK Core guidance for populating this element | MUST | 1..1 | http://hl7.org/fhir/StructureDefinition/Flag |
From fba6af30fcfbe618bbfba069b7eb10e2389ce660 Mon Sep 17 00:00:00 2001
From: Derek Dreyer <56388818+d-dreyer@users.noreply.github.com>
Date: Fri, 8 May 2026 15:56:19 +0100
Subject: [PATCH 2/3] NBRS-4663 - Update Patient Identifier Coding Guidance
Updated the app 8 guidance for Patient Identifier Coding to remove incorrect status information.
---
.../Applications/BaRS-APP8/Referral-Payload.page.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
index dbe614a4..edaeeb73 100644
--- a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
+++ b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
@@ -244,8 +244,8 @@ This payload is used to transmit all the necessary information that is required
| Patient.identifier.extension.valueCodeableConcept | | MUST | 0..1 | |
| Patient.identifier.extension.valueCodeableConcept.coding | | MUST | 0..* | |
| Patient.identifier.extension.valueCodeableConcept.coding.system | This SHOULD be populated. Where used this MUST be populated with CodeSystem - 'https://fhir.hl7.org.uk/CodeSystem/UKCore-NHSNumberVerificationStatus' - FIXED VALUE | MUST | 0..1 | https://fhir.hl7.org.uk/CodeSystem/UKCore-NHSNumberVerificationStatus |
-| Patient.identifier.extension.valueCodeableConcept.coding.code | This SHOULD be populated. Where used this MUST be 'number-present-and-verified' or 'number-present-but-not-traced', else no NHS number MUST be sent. No other statuses are permitted. | MUST | 0..1 | number-present-and-verified |
-| Patient.identifier.extension.valueCodeableConcept.coding.display | This SHOULD be populated. Where used this MUST be populated with 'Number present and verified' or 'Number present but not traced'. No other statuses are permitted. | MUST | 0..1 | Number present and verified |
+| Patient.identifier.extension.valueCodeableConcept.coding.code | This SHOULD be populated. Where used this MUST be 'number-present-and-verified' else no NHS number MUST be sent. No other statuses are permitted. | MUST | 0..1 | number-present-and-verified |
+| Patient.identifier.extension.valueCodeableConcept.coding.display | This SHOULD be populated. Where used this MUST be populated with 'Number present and verified'. No other statuses are permitted. | MUST | 0..1 | Number present and verified |
| Patient.name | | SHOULD | 0..* | |
| Patient.name.use | Follow UK Core guidance for populating this element | SHOULD | 0..1 | official |
| Patient.name.text | Follow UK Core guidance for populating this element | SHOULD | 0..1 | Mrs Julie Jones |
From 9396063860619765fd6a3cdd5d71f029ac5d5cbf Mon Sep 17 00:00:00 2001
From: Derek Dreyer <56388818+d-dreyer@users.noreply.github.com>
Date: Fri, 8 May 2026 16:23:41 +0100
Subject: [PATCH 3/3] NBRS-4647 - Remove App8 Pharmacy References
Removed references to pharmacy from the referral payload for app 8
---
.../Applications/BaRS-APP8/Referral-Payload.page.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
index edaeeb73..5c28aea3 100644
--- a/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
+++ b/guides/Live-ImplementationGuide-BaRS/Home/Applications/BaRS-Applications/Applications/BaRS-APP8/Referral-Payload.page.md
@@ -133,7 +133,7 @@ This payload is used to transmit all the necessary information that is required
| ServiceRequest.subject.reference | This MUST be populated. Follow BaRS profile guidance for populating this element | MUST | 0..1 | urn:uuid:9589fb37-87a2-48d8-968f-b371429208a8 |
| ServiceRequest.encounter | | MUST | 0..1 | |
| ServiceRequest.encounter.reference | This MUST be populated with a Reference to the Encounter resource | MUST | 0..1 | urn:uuid:8c63d621-4d86-4f57-8699-e8e22d49935d |
-| ServiceRequest.occurencePeriod | Timeframe within which pharmacy must manage the referral (Urgency) | MAY | 0..1 | |
+| ServiceRequest.occurencePeriod | Timeframe within which the referral must be managed (Urgency) | MAY | 0..1 | |
| ServiceRequest.occurrencePeriod.start | This SHOULD be populated. The start of the period MUST be ‘now’. | SHOULD | 0..1 | 2023-03-08T12:01:08.4677672+00:00 |
| ServiceRequest.occurrencePeriod.end | This SHOULD be populated with the time by which the next service provision SHOULD have started (this aligns with the disposition timeframe from Pathways) | SHOULD | 0..1 | 2023-03-08T12:01:08.4677672+00:00 |
| ServiceRequest.authoredOn | This MUST be populated with the date time the request transitioned to being actionable. In case it's 'blank' the date time SHOULD fall back to the submission time/system time of the SENDING system. | MUST | 1..1 | 2023-03-08T12:01:08.4677672+00:00 |
@@ -340,10 +340,10 @@ This payload is used to transmit all the necessary information that is required
| Task.meta.lastUpdated | All resources MUST include 'lastUpdated' value, under meta section which must be the same timestamp for each resource when created from new, but must be a later timestamp on updates, if the content of a particular resource contains updated info for subsequent updates. Otherwise, maintain the timestamp originally sent. | MUST | 1..1 | 2023-03-08T12:01:08.4677672+00:00 |
| Task.status | This MUST be populated with 'requested' - Fixed Value | MUST | 1..1 | requested |
| Task.intent | This MUST be populated with 'order' - Fixed Value | MUST | 1..1 | order |
-| Task.code | This MUST be populated with the action (by the specific Pharmacy Service (Referral Type)) the Sender is requesting of the Receiver. If multiple actions (which are to occur within different timeframes) are to be requested these would be represented in independent Task resources. | MUST | 0..1 | |
+| Task.code | This MUST be populated with the action the Sender is requesting of the Receiver. If multiple actions (which are to occur within different timeframes) are to be requested these would be represented in independent Task resources. | MUST | 0..1 | |
| Task.code.coding.system | This MUST be populated with CodeSystem - http://snomed.info/sct | MUST | 0..1 | http://snomed.info/sct |
-| Task.code.coding.code | This MUST be populated with the Code (SNOMED) of action by the Pharmacy Service | MUST | 0..1 | 792891000000102 |
-| Task.code.coding.display | This MUST be populated with the human readable Display (SNOMED) of action by the Pharmacy Service | MUST | 0..1 | Inbound referral |
+| Task.code.coding.code | This MUST be populated with the Code (SNOMED) of action | MUST | 0..1 | 792891000000102 |
+| Task.code.coding.display | This MUST be populated with the human readable Display (SNOMED) of action | MUST | 0..1 | Inbound referral |
| Task.description | This SHOULD be populated with a human readable summary of the intended instruction of the Task, combining the key elements e.g. Task.code and Task.restriction.period | SHOULD | 0..1 | Provide healthcare service options to patient/client for selection' |
| Task.encounter | | SHOULD | 0..1 | |
| Task.encounter.reference | This MUST be populated with a reference to the senders Encounter | SHOULD | 0..1 | urn:uuid:b83d13e2-8c2e-422c-88ac-63b8e86a4413 |