A020 - Upload before or after referral creation

[adam.oldfield]

Hi @hayward,

@hayward

I am just wondering if the upload-first work-flow is supported?

No, I’m afraid not.

In the case of Maintain referral letter (A012, FHIR STU3) this is clarified in the Overview:

Whilst a document can be uploaded via Upload file to document store (A020) without a NHSD-eRS-Referral-ID , only documents that have a NHSD-eRS-Referral-ID can be associated using this end point. An attempt to associate a document without a NHSD-eRS-Referral-ID will return an error response of 422 - INAPPROPRIATE_VALUE .

To give a little context, one of the key reasons the Referral-ID is required at the point of upload (A020) is to allow us to control access to the file before it is formally linked to a request. This access control ensures that only users/organisations with a legitimate relationship with the request can download the file. A file uploaded without a Referral-ID cannot be retrieved until it is formally linked (see below).

The specification of a Referral-ID on upload also provides a fail-safe against inadvertently linking a file to the wrong request.

The only endpoint that allows the linking of a file uploaded without a Referral-ID is Create advice and guidance request (A044, FHIR STU3). This is unavoidable as the request creation and the linking happens in one transaction.

Regards,

Adam.