From c1b3222b5b63711e6ed15371fa86421512b1a513 Mon Sep 17 00:00:00 2001 From: NitishRastogiNHS Date: Wed, 12 Nov 2025 10:15:26 +0000 Subject: [PATCH] [RAA-644]-[]-[Referral request versionID added to referral worklist]-[NR] --- .../responses/FilteredByClinician.json | 10 +++++++++- .../responses/FilteredByService.json | 6 +++++- .../responses/FilteredBySpecialty.json | 10 +++++++++- .../responses/ReferralsForReview.json | 10 +++++++++- .../stu3/schemas/eRS-FetchWorklist-List.yaml | 2 ++ .../schemas/endpoints/a008-retrieve-worklist.yaml | 4 +--- ...ension-WorklistItem-ReferralRequestVersion.yaml | 14 ++++++++++++++ 7 files changed, 49 insertions(+), 7 deletions(-) create mode 100644 specification/components/stu3/schemas/extensions/worklists/Extension-WorklistItem-ReferralRequestVersion.yaml diff --git a/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByClinician.json b/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByClinician.json index d3360b941..6d2e37ca9 100644 --- a/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByClinician.json +++ b/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByClinician.json @@ -126,6 +126,10 @@ }, "display": "Excellent Cardiology Business Service 12" } + }, + { + "url": "referralRequestVersion", + "valueInteger": 9 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -211,6 +215,10 @@ } ] } + }, + { + "url": "referralRequestVersion", + "valueInteger": 12 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -221,4 +229,4 @@ } } ] -} +} \ No newline at end of file diff --git a/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByService.json b/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByService.json index 0ec24b311..14bf2ed84 100644 --- a/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByService.json +++ b/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredByService.json @@ -130,6 +130,10 @@ }, "display": "Another Excellent Cardiology Business Service 13" } + }, + { + "url": "referralRequestVersion", + "valueInteger": 12 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -140,4 +144,4 @@ } } ] -} +} \ No newline at end of file diff --git a/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredBySpecialty.json b/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredBySpecialty.json index d3140a75a..bfb660a17 100644 --- a/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredBySpecialty.json +++ b/sandbox/src/mocks/stu3/retrieveWorklist/responses/FilteredBySpecialty.json @@ -121,6 +121,10 @@ } ] } + }, + { + "url": "referralRequestVersion", + "valueInteger": 9 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -216,6 +220,10 @@ }, "display": "Excellent Cardiology Business Service 12" } + }, + { + "url": "referralRequestVersion", + "valueInteger": 9 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -226,4 +234,4 @@ } } ] -} +} \ No newline at end of file diff --git a/sandbox/src/mocks/stu3/retrieveWorklist/responses/ReferralsForReview.json b/sandbox/src/mocks/stu3/retrieveWorklist/responses/ReferralsForReview.json index 19c81950b..dbe01b246 100644 --- a/sandbox/src/mocks/stu3/retrieveWorklist/responses/ReferralsForReview.json +++ b/sandbox/src/mocks/stu3/retrieveWorklist/responses/ReferralsForReview.json @@ -131,6 +131,10 @@ }, "display": "Excellent Cardiology Business Service 12" } + }, + { + "url": "referralRequestVersion", + "valueInteger": 7 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -230,6 +234,10 @@ }, "display": "Another Excellent Cardiology Business Service 13" } + }, + { + "url": "referralRequestVersion", + "valueInteger": 12 } ], "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" @@ -240,4 +248,4 @@ } } ] -} +} \ No newline at end of file diff --git a/specification/components/stu3/schemas/eRS-FetchWorklist-List.yaml b/specification/components/stu3/schemas/eRS-FetchWorklist-List.yaml index 82f8588d7..9b985ea89 100644 --- a/specification/components/stu3/schemas/eRS-FetchWorklist-List.yaml +++ b/specification/components/stu3/schemas/eRS-FetchWorklist-List.yaml @@ -174,6 +174,7 @@ properties: | `appointmentStart` | `0..1` | | | `allocatedClinician` | `0..1` | | | `service` | `1..1` | | + | `referralRequestVersion` | `1..1` | | items: anyOf: - title: priority @@ -396,6 +397,7 @@ properties: type: string example: '#Practitioner-021600556514' - $ref: './extensions/worklists/Extension-WorklistItem-Service.yaml' + - $ref: './extensions/worklists/Extension-WorklistItem-ReferralRequestVersion.yaml' - title: Extension-eRS-AppointmentSlotIssues-WorkListItem type: object required: diff --git a/specification/components/stu3/schemas/endpoints/a008-retrieve-worklist.yaml b/specification/components/stu3/schemas/endpoints/a008-retrieve-worklist.yaml index 81d3aa9b0..9f189602e 100644 --- a/specification/components/stu3/schemas/endpoints/a008-retrieve-worklist.yaml +++ b/specification/components/stu3/schemas/endpoints/a008-retrieve-worklist.yaml @@ -45,11 +45,9 @@ description: | ## Service Providing Organisations Service provider organisations can currently access the following referral related worklists: - - The 'Referrals for Review' worklist contains booked and RAS (triage) referrals that require review by the service provider organisation + - The 'Referrals for Review' worklist contains booked and RAS (triage) referrals that require review by the service provider organisation. The version of each referral in the worklist will also be returned. Note that the version can change due to admin/clinical changes as well as internal e-RS processes. - The 'Appointment Slot Issues' worklist contains referrals which have been 'deferred to provider' because of a lack of appointment availability (e.g. no appointment slots). The referrals need to be reviewed and if appropriate booked into a service at the service provider organisation. - - There are currently no referral related worklists available for referring organisations. ## Supported security patterns - Healthcare worker, user-restricted access diff --git a/specification/components/stu3/schemas/extensions/worklists/Extension-WorklistItem-ReferralRequestVersion.yaml b/specification/components/stu3/schemas/extensions/worklists/Extension-WorklistItem-ReferralRequestVersion.yaml new file mode 100644 index 000000000..f6f9dbae1 --- /dev/null +++ b/specification/components/stu3/schemas/extensions/worklists/Extension-WorklistItem-ReferralRequestVersion.yaml @@ -0,0 +1,14 @@ +title: referralRequestVersion +type: object +required: + - url + - valueInteger +properties: + url: + type: string + enum: + - referralRequestVersion + example: referralRequestVersion + valueInteger: + type: integer + example: 0