Error return when we tried to migrate from A020 to A039

e-Referral Service (e-RS)
1

Hi,

Yesterday we got the Formal release change communication email from NHSE, the following statement is related to migration guidance for A020 to A039.

There is also an associated migration guidance document published on the deprecation notices page: Migrating to the FHIR R4 upload attachment endpoint which explains how to migrate from the FHIR STU3 Upload file to document store (A020) endpoint to the new FHIR R4 Upload file to document store (A039) endpoint.

When our developer try to test the A039 in int env, “REC_FORBIDDEN” was returned.

Request details:

Request Details

curl --request post \
  --url https://int.api.service.nhs.uk/referrals/FHIR/R4/Binary \
  --header 'accept: application/fhir+json' \
  --header 'authorization: Bearer C7yOX4aAPcWgJn4aYTsRnVCGbAtf' \
  --header 'content-type: application/fhir+json' \
  --header 'nhsd-end-user-organisation-ods: RYY' \
  --header 'nhsd-ers-business-function: SERVICE_PROVIDER_CLINICIAN' \
  --header 'nhsd-ers-file-mime-type: application/pdf' \
  --header 'nhsd-ers-file-name: Test-Document.pdf' \
  --header 'nhsd-ers-file-size: 16494' \
  --header 'x-correlation-id: 11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA' \
  --data '\Downloads\ers documents\Test-Document.pdf'

Response:

{
“resourceType”: “OperationOutcome”,
“meta”: {
“lastUpdated”: “2026-09-14T14:48:31.728Z”,
“profile”: [
“OperationOutcome - FHIR v4.0.1”
]
},
“issue”: [
{
“severity”: “error”,
“code”: “forbidden”,
“diagnostics”: “The ASID (200000002453) does not have the interaction (urn:nhs:names:services:ers:CREATE_BINARY_R4_V001) required to call this endpoint.”,
“details”: {
“coding”: [
{
“system”: “https://fhir.nhs.uk/CodeSystem/http-error-codes”,
“code”: “REC_FORBIDDEN”
}
]
}
}
]
}

2

Hi @Jerry_Ng

Looks like we need to update your ASID to have the latest interaction on - I will make a request for this to be resolved - I will reply on here when it is complete.

3

Hi @tony.marsh1 same issue as 403 (Forbidden) REC_FORBIDDEN on A039 endpoint INT will the same resolution apply?

4

@Jerry_Ng ASID has been updated

@gareth.perkins Sent you an email for further info :slight_smile: