[RAA-3163] Updates for version ID in A&G worklist

Author: nicolebalmer1-nhs

sandbox/src/mocks/stu3/retrieveAdviceAndGuidanceWorklist/responses/AdviceAndGuidanceRequests.json

@@ -91,6 +91,10 @@
                   }
                 ]
               }
+            },
+            {
+              "url": "communicationRequestVersion",
+              "valueInteger": 10
             }
           ],
           "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1"
@@ -183,6 +187,10 @@
                   }
                 ]
               }
+            },
+            {
+              "url": "communicationRequestVersion",
+              "valueInteger": 10
             }
           ],
           "url": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1"

specification/components/stu3/schemas/eRS-FetchWorklist-List.yaml

@@ -598,6 +598,7 @@ properties:
                       | `referrer`                     | `1..1`      |                                            |
                       | `service`                      | `1..1`      |                                            |
                       | `clinicType`                   | `0..1`      |                                            |
+                      | `communicationRequestVersion`  | `0..1`      |                                            |
                     items:
                       anyOf:
                         - $ref: './extensions/worklists/Extension-WorklistItem-Priority.yaml'
@@ -693,6 +694,20 @@ properties:
                         - $ref: './extensions/worklists/Extension-WorklistItem-Referrer.yaml'
                         - $ref: './extensions/worklists/Extension-WorklistItem-Service.yaml'
                         - $ref: './extensions/worklists/Extension-WorklistItem-ClinicType.yaml'
+                        - title: communicationRequestVersion
+                          type: object
+                          required:
+                            - url
+                            - valueInteger
+                          properties:
+                            url:
+                              type: string
+                              enum:
+                                - communicationRequestVersion
+                              example: 'communicationRequestVersion'
+                            valueInteger:
+                              type: integer
+                              example: 0
               - title: Extension-eRS-RejectedTriageResponse-WorkListItem
                 type: object
                 required:

specification/components/stu3/schemas/endpoints/a023-retrieve-a&g-worklist.yaml

@@ -8,7 +8,8 @@ description: |
   or to undertake an action, in order to avoid delays to patient care.
   
   Service provider organisations can retrieve the contents of their 'Advice and guidance requests' worklist using 
-  this endpoint. This worklist contains advice and guidance requests the provider has received and which need actioning.
+  this endpoint. This worklist contains advice and guidance requests the provider has received and which need actioning. The version of each advice 
+  request 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.
 
   There are currently no advice and guidance related worklists available for referring organisations.